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.