Skip to content
github-actions[bot] edited this page Jul 29, 2026 · 3 revisions

AncestryLLM 0.2.0

AncestryLLM 0.2.0 is the first public, SemVer-governed release of the privacy-first ancestry command-line tool.

Highlights

  • One-shot ancestry commands and an interactive prompt-toolkit/Rich console.
  • Loss-minimizing GEDCOM merge, subtree, quality, incremental update, and rebase workflows.
  • Immutable RootsMagic inspection and deterministic, schema-adaptive GEDCOM export with privacy-safe living-data filtering and atomic GEDCOM/report publication.
  • Explicit modular LLM providers with consent, timeouts, stable coded errors, and a network-free provider=none mode.
  • An encrypted SQLCipher research workspace, OS-keyring secret storage, diagnostics, and encrypted backups.

Verified release guarantees

Publication is gated on the attached release-evidence.md. A verified gate means the exact release commit passed the documented test, static-analysis, security, reproducibility, and clean-install checks. The wheel and source distribution must have identical hashes to the approved readiness build before publication proceeds.

The release workflow verifies installation on Ubuntu, macOS, and Windows with Python 3.12, 3.13, and 3.14. For an index-backed release, it also verifies that the PyPI and TestPyPI files match the attached distribution hashes. If an index is unavailable and the release is published on GitHub only, the GitHub Release body will state that limitation explicitly and no index-verification claim applies.

Interoperability limitations

RootsMagic, Ancestry, Geni, and MyHeritage import interoperability is unverified for 0.2.0 unless a corresponding row in the attached evidence is explicitly marked verified with dated fictional-data evidence. This release does not make a positive compatibility claim for an unverified vendor. Automated destination tests verify standards-based GEDCOM formatting only. RootsMagic databases with active WAL, SHM, or journal sidecars are rejected fail closed; export from a stable backup instead.

Installation

Install the isolated CLI application with:

pipx install ancestryllm==0.2.0

If the release body identifies a GitHub-only publication because PyPI was unavailable, download the attached wheel and install that exact file instead:

pipx install ./ancestryllm-0.2.0-py3-none-any.whl

Then verify the installed public version:

ancestry --version
python -m ancestryllm --version

Both commands return ancestry 0.2.0.

Release assets and verification

The GitHub Release contains the wheel, source distribution, full SHA256SUMS, CycloneDX SBOM, security-finding dispositions, interoperability record, readiness evidence, and final release evidence. GitHub build provenance binds the assets to the release workflow and commit. An index-backed publication also includes PyPI Trusted Publishing attestations for the Python distributions.

Verify all downloaded GitHub assets from the directory containing them:

shasum -a 256 -c SHA256SUMS

SHA256SUMS intentionally omits only itself.

Upgrade and correction policy

Published artifacts and v0.2.0 are immutable. If a defect requires a correction, the project will publish a new patch version rather than replacing this tag or version.

Clone this wiki locally