AncestryLLM 0.2.0

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 a verified WAL generation are accepted only after
process-owned copy, full checkpoint, and backup consolidation. A matching SHM
is verified when present but is not required because SQLite reconstructs it
inside owned staging. Busy, malformed, replaced, symbolic-link, or non-regular
sidecars, rollback journals, and SHM files without a WAL fail closed. A stable
backup remains the recommended input.

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.