v0.4.2

What's Changed

• Record v0.4.1 release verification by @DyrtyJax in #65
• docs: add visual proof and dogfood story by @DyrtyJax in #66
• chore: record Community Tools submission by @DyrtyJax in #67
• release: publish 0.4.2 through PyPI OIDC by @DyrtyJax in #68

Full Changelog: v0.4.1...v0.4.2

v0.4.1

emBEADings v0.4.1

A privacy, packaging, and public-repository hardening release for the v0.4 technical preview.

Upgrade

python -m pip install --upgrade \
  "https://github.com/DyrtyJax/embeadings/releases/download/v0.4.1/embeadings-0.4.1-py3-none-any.whl"
embead --version
embead doctor

What changed

• POSIX cache/state roots and run directories are now owner-only (0700).
• Derived vectors, locks, reports, and checkpoints are owner-only (0600) through atomic writes.
• The source archive contains only runtime source, schemas, and required package metadata, shrinking
  from repository-scale packaging to about 84 KB.
• Release verification now fresh-installs both wheel and source archive.
• Tagged releases validate the full suite and publish GitHub build-provenance attestations.
• GitHub Actions and build tooling are pinned to reviewed revisions.
• The README now leads with the coordination problem, a 60-second install, representative output,
  evidence boundaries, and honest fit/non-fit guidance.
• Privacy-aware bug/evaluation forms, current security guidance, and documentation/research indexes
  make external evaluation safer.
• Linear requests now report the actual emBEADings package version.

Verification

• 269 tests passed locally and across the protected Linux, macOS, Windows, Python 3.11/3.14 matrix.
• Published wheel and source archive have SHA-256 receipts in SHA256SUMS.
• Both artifacts were built and installed during CI before publication.
• Release artifacts are covered by GitHub build-provenance attestations.

Boundaries

This remains a technical preview. Semantic matches are advisory, the four-worktree release gate
covers one repository layout, the Ruff corpus is a scale surrogate rather than native-Beads recall
evidence, and the agent plugin remains a local developer preview.

See CHANGELOG.md and
PR #64.

v0.4.0

emBEADings v0.4.0

The first public technical preview of a local, read-only coordination review CLI for Beads and
Linear.

What shipped

• One-command bounded triage for semantic overlap, completed-work echoes, and typed relationships.
• Code-surface collision review grounded in explicit task pointers and genuine local Git worktrees.
• Deterministic, versioned JSON and Markdown artifacts with privacy-safe evidence receipts.
• Read-only Beads and Linear adapters, incremental checkpoints, and a local Codex/Claude plugin
  foundation.

Install and verify

python -m pip install \
  "https://github.com/DyrtyJax/embeadings/releases/download/v0.4.0/embeadings-0.4.0-py3-none-any.whl"
embead --version
embead doctor

Release evidence

• The release gate used four genuine concurrent implementation worktrees.
• It surfaced all three known exact-file conflicts and one useful shared-module coordination lead.
• Dogfooding stopped the gate twice and exposed two real association/scope defects before release.
• Repeated output was byte-identical and tracker/worktree fingerprints were unchanged.
• The suite contains 256 tests and CI covers Linux, macOS, Windows, Python 3.11, and Python 3.14.

Read the aggregate release-gate report.

Privacy boundary

Issue text is embedded locally with a pinned model. The first semantic command may download model
artifacts, but issue text is not uploaded. emBEADings does not mutate tracker records. Reports,
vectors, and run state live outside the analyzed repository by default.

Known limits

• Semantic similarity is advisory evidence, not a duplicate or lifecycle verdict.
• The four-worktree gate covered one repository layout and is not a universal recall claim.
• The 8,143-issue Ruff experiment is a scale surrogate, not native-Beads validation.
• The agent plugin remains a local development preview.
• Distribution is currently through GitHub Releases rather than PyPI.

Release assets include the wheel, source archive, and SHA256SUMS. See the
changelog and
full commit history.