Release Health
Release health records the confidence gates used for each tagged release. The latest docs remain forward-looking, while this page keeps a compact audit trail for tests, docs, and operational readiness.
Current Gate
Run these checks before tagging a release:
| Gate | Command or evidence | Current expectation |
|---|---|---|
| Unit and integration tests | go test -count=1 ./... | Required for every release |
| Docs build | npm run docs:build | Required for every release |
| Patch hygiene | git diff --check | Required for every release |
| Ranking corpus | TestRepresentativeCorpusRankingGolden in ./internal/retrieval | Required before ranking changes |
| Badger restart durability | TestDB_BadgerRestartDurability in ./pkg/client | Required before storage or embedded-mode changes |
| API contract surface | gRPC, REST, and GraphQL server tests | Required before public API changes |
| Race and soak lane | go test -race -count=1 ./internal/federation ./internal/retrieval ./pkg/client and TestNamespace_ConcurrentWriteRetrieveSoak | Required in CI |
| Postgres integration | Docker-backed pgvector/pgvector:pg16 with go test -tags integration ./pkg/client | Required in CI |
| Release health artifact | .github/workflows/ci.yml release-health job | Required before publishing release recap rows |
The CI workflow now writes release-health/release-health.json and release-health/release-health-row.md from the actual test, build, durability, postgres integration, and docker job results. Use the generated Markdown row as the source for release recap updates so the table follows verified CI evidence rather than hand-maintained status text.
The v0.109–v0.122 recaps are unverified historical proposals, not passed releases. Implementation evidence is tracked in the work unit plan.
v0.123.0 local verification
The reliability and review work unit ships as v0.123.0 after v0.108.0. The local verification below is separate from CI-generated release summary rows and historical release claims.
| Gate | Result | Evidence |
|---|---|---|
| Go suite | Passed | go test -count=1 ./... |
| Static analysis | Passed | go vet ./... |
| Race checks | Passed | Ingest, retrieval, client, and server packages |
| Postgres | Passed | Live Docker-backed write/retrieve and two-handle advisory lease tests |
| Workflow integration | Passed | Authenticated HTTP acquisition, repeated candidate execution, approval retry, worker dry run/execution, durable summaries, empty recovery backlog |
| Authentication | Passed | Real gRPC anonymous/forged/read-only rejection and valid-token tests |
| SDK contracts | Passed | TypeScript mocked contracts/build; Python sync/async mocks; existing opt-in live SDK cases remain separately skipped |
| Admin/docs builds | Passed | npm run admin:build, npm run docs:build |
| Container | Passed | Native arm64 Docker build; Postgres backend metadata; doctor sample write/retrieve; worker CLI dry run |
| Browser | Passed | Correct fixture claim/evidence render, nullable-array regression, baseline reload persistence and deletion |
| Independent review | Reviewed | Sol re-review cleared verified correctness findings after fixes |
Release Summary
| Release | Unit and integration | Docs build | Ranking | Durability | API contract | Notes |
|---|---|---|---|---|---|---|
| v0.108.0 | Passed | Passed | Corpus coverage present | Race/soak and Docker-backed Postgres CI lanes added | Schema catalog, closure bundle, fixture catalog, and source quarantine tests added | Adds CI-backed release health, reliability verifiers, and dry-run-first source quarantine |
| v0.107.0 | Passed | Passed | Corpus coverage present | Acquisition retry receipt coverage added | Connector retry execution and receipt tests added | Adds retry receipts and idempotency keys for acquisition connector execution |
| v0.106.0 | Passed | Passed | Corpus coverage present | Provider connector normalization coverage added | CLI connector server and provider adapter tests added | Adds OpenAI, xAI, and Anthropic acquisition connector adapters |
| v0.105.0 | Passed | Passed | Corpus coverage present | Source-constrained acquisition execution coverage added | Go SDK, REST, TypeScript, and Python connector surfaces added | Adds dry-run-first search/crawler acquisition connector workflows |
| v0.104.0 | Passed | Passed | Corpus coverage present | Epistemics debugger coverage added | Admin belief API additive-envelope tests added | Adds source-trust timeline, contradiction path, and graph/source context visualizations |
| v0.103.0 | Passed | Passed | Admin ranking eval API and dashboard coverage added | Corpus coverage present | Admin ranking API and embedded asset tests added | Adds first-class ranking evaluation dashboard with baseline comparison |
| v0.102.0 | Passed | Passed | Corpus coverage present | KV receipt fixture coverage added | Public fixture verifier tests added | Publishes passing and failing KV refresh receipt fixtures for integrations |
| v0.101.0 | Passed | Passed | Corpus coverage present | Closure bundle manifest coverage added | CLI manifest tests added | Adds hashed manifests for published backup repair closure bundles |
| v0.100.0 | Passed | Passed | Corpus coverage present | Schema catalog drift covered | Public schema catalog test added | Publishes a docs schema index for dashboard and automation consumers |
| v0.99.0 | Passed | Passed | Corpus coverage present | KV receipt doctor lane coverage added | CLI doctor receipt check tests added | Adds derived KV refresh receipt verification to combined doctor reports |
| v0.98.0 | Passed | Passed | Corpus coverage present | Backup closure bundle docs covered | CLI docs regression test updated | Adds stable published-backup repair closure artifact bundle filenames |
| v0.97.0 | Passed | Passed | Corpus coverage present | Retry fatigue public schema drift covered | Public schema fixture parity test added | Publishes the retry fatigue preset JSON schema with the docs site |
| v0.96.0 | Passed | Passed | Corpus coverage present | KV receipt verifier coverage added | CLI KV refresh receipt verifier tests added | Adds verification for derived KV refresh receipts and optional reviewed value hashes |
| v0.95.0 | Passed | Passed | Corpus coverage present | Doctor backup receipt lane docs covered | CLI docs regression test added | Adds a published backup repair closure lane from doctor diagnosis through verified receipt closeout |
| v0.94.0 | Passed | Passed | Corpus coverage present | Retry fatigue preset fixture coverage added | SDK and REST preset schema fixture tests added | Adds a shared schema fixture for retry fatigue preset payload parity |
| v0.93.0 | Passed | Passed | Admin explain-rank compare coverage added | Corpus coverage present | Admin compare API and embedded asset tests added | Adds side-by-side explain-rank comparison to the Svelte debugger |
| v0.92.0 | Passed | Passed | Svelte admin shell coverage added | Corpus coverage present | Embedded admin asset tests added | Moves the admin metrics/debugger surface into an embedded Svelte app |
| v0.91.0 | Passed | Passed | Admin metrics dashboard coverage added | Corpus coverage present | Admin metrics API tests added | Adds health, ingest, retrieval, latency, and raw metrics panels to the admin dashboard |
| v0.90.0 | Passed | Passed | Bundle index verifier coverage added | Corpus coverage present | CLI bundle index verification tests added | Re-hashes verification bundle artifacts and checks JSON report status consistency |
| v0.89.0 | Passed | Passed | Admin debugger search coverage added | Corpus coverage present | Admin search API tests added | Adds graph-backed search before opening belief audits |
| v0.88.0 | Passed | Passed | Admin debugger and bundle index coverage added | Corpus coverage present | Admin API and CLI bundle index tests added | Mounts the admin dashboard/debugger and adds bundle index metadata |
| v0.87.0 | Passed | Passed | Ranking baseline verification bundle coverage added | Corpus coverage present | CLI bundle artifact tests added | Adds stable bundle output for manifest verification reports |
| v0.86.0 | Passed | Passed | Ranking baseline annotation workflow docs added | Corpus coverage present | Docs build coverage | Adds a GitHub Actions recipe for manifest verification annotations and artifacts |
| v0.85.0 | Passed | Passed | Ranking baseline failure annotation coverage added | Corpus coverage present | CLI annotation formatter tests added | Adds CI annotation output for ranking baseline manifest failures |
| v0.84.0 | Passed | Passed | Ranking baseline manifest Markdown coverage added | Corpus coverage present | CLI manifest summary tests added | Adds Markdown summaries for ranking baseline manifest verification |
| v0.83.0 | Passed | Passed | Corpus coverage present | KV derived refresh receipt coverage added | CLI KV refresh receipt tests added | Adds receipts for executed derived KV refreshes |
| v0.82.0 | Passed | Passed | Corpus coverage present | Published backup receipt doctor coverage added | CLI doctor receipt verify tests added | Adds published backup receipt verification to combined doctor reports |
| v0.81.0 | Passed | Passed | Corpus coverage present | Retry fatigue docs drift coverage added | SDK preset docs alignment test added | Adds a test that keeps retry fatigue cookbook presets aligned with SDK metadata |
| v0.80.0 | Passed | Passed | Ranking baseline manifest verification coverage added | Corpus coverage present | CLI ranking manifest verify tests added | Adds integrity verification for ranking baseline artifact manifests |
| v0.79.0 | Passed | Passed | Corpus coverage present | KV derived repair execution docs added | Docs build coverage | Adds a guarded stale derived KV refresh checklist from doctor hint to execute |
| v0.78.0 | Passed | Passed | Corpus coverage present | Published backup receipt verification coverage added | CLI publish receipt verify tests added | Adds post-repair verification for lifecycle index publish receipts |
| v0.77.0 | Passed | Passed | Corpus coverage present | Retry fatigue preset example coverage added | SDK and REST preset metadata tests added | Adds copyable REST and GraphQL examples to retry fatigue preset metadata |
| v0.76.0 | Passed | Passed | Ranking baseline manifest coverage added | Corpus coverage present | CLI ranking retention manifest tests added | Adds JSON artifact inventory output for ranking baseline retention |
| v0.75.0 | Passed | Passed | Corpus coverage present | KV derived repair hint coverage added | CLI doctor derived KV hint tests added | Adds dry-run repair command hints to derived KV freshness failures |
| v0.74.0 | Passed | Passed | Corpus coverage present | Published backup repair receipt coverage added | CLI publish receipt tests added | Adds optional JSON receipts for executed backup catalog publish repairs |
| v0.73.0 | Passed | Passed | Corpus coverage present | Retry fatigue preset discovery docs added | Docs build coverage | Adds a compact preset table for retry fatigue dashboards and handoffs |
| v0.72.0 | Passed | Passed | Corpus coverage present | Ranking retention cookbook docs added | Docs build coverage | Adds keep-count and CI artifact recipes for ranking baseline retention |
| v0.71.0 | Passed | Passed | Corpus coverage present | KV derived freshness coverage added | CLI doctor derived KV freshness tests added | Adds an opt-in doctor check for stale derived KV generated_at metadata |
| v0.70.0 | Passed | Passed | Corpus coverage present | Published backup repair guard docs added | Docs build coverage | Adds safety checks before executing published backup catalog replacement |
| v0.69.0 | Passed | Passed | Corpus coverage present | Retry fatigue preset coverage added | SDK, REST, and GraphQL preset tests added | Adds stable preset names for repeated retry fatigue owner and escalation lanes |
| v0.68.0 | Passed | Passed | Ranking baseline delete-script coverage added | Corpus coverage present | CLI ranking baseline retention tests added | Adds reviewable deletion-plan output for pruneable ranking baseline artifacts |
| v0.67.0 | Passed | Passed | Corpus coverage present | KV derivation recipe docs added | Docs build coverage | Adds naming, review, and promotion recipes for derived recent-node KV cache values |
| v0.66.0 | Passed | Passed | Corpus coverage present | Published backup repair hint coverage added | CLI drift and doctor hint tests added | Adds dry-run publish command hints to published backup drift reports |
| v0.65.0 | Passed | Passed | Corpus coverage present | Cookbook docs added | Docs build coverage | Adds retry fatigue owner and escalation-lane cookbook examples for handoff routing |
| v0.64.0 | Passed | Passed | Baseline retention coverage added | Corpus coverage present | CLI ranking baseline retention tests added | Adds read-only retained/current/pruneable reports for versioned ranking baselines |
| v0.63.0 | Passed | Passed | Corpus coverage present | KV derived value coverage added | CLI KV derived recent-node tests added | Adds dry-run-first recent-node session context derivation for KV cache repair |
| v0.62.0 | Passed | Passed | Corpus coverage present | Published backup drift doctor coverage added | CLI doctor published drift tests added | Adds opt-in local-vs-published backup catalog drift checks to combined doctor reports |
| v0.61.0 | Passed | Passed | Baseline policy coverage added | Corpus coverage present | CLI ranking baseline tests added | Adds versioned ranking baseline artifacts and previous-baseline resolution |
| v0.60.0 | Passed | Passed | Corpus coverage present | Retry fatigue filter coverage added | Go SDK, REST, and GraphQL fatigue filter tests added | Adds owner and escalation filters for retry fatigue handoffs |
| v0.59.0 | Passed | Passed | Corpus coverage present | KV refresh repair coverage added | CLI KV cache repair tests added | Adds dry-run-first reviewed KV hot-key refresh execution |
| v0.58.0 | Passed | Passed | Corpus coverage present | Retry fatigue owner grouping coverage added | Go SDK, REST, and GraphQL fatigue grouping tests added | Adds owner and escalation breakdowns to retry fatigue handoffs |
| v0.57.0 | Passed | Passed | Corpus coverage present | Published backup freshness doctor coverage added | CLI doctor published freshness tests added | Adds opt-in published backup catalog freshness to combined doctor reports |
| v0.56.0 | Passed | Passed | Historical diff coverage added | Corpus coverage present | CLI ranking eval diff test added | Adds release-to-release rank and top-score movement summaries for representative corpus ranking |
| v0.55.0 | Passed | Passed | Markdown recap coverage added | Corpus coverage present | CLI ranking eval Markdown test added | Adds compact Markdown release-review summaries for representative corpus ranking |
| v0.54.0 | Passed | Passed | Corpus coverage present | KV sampling coverage added | CLI doctor KV consistency tests added | Adds opt-in KV hot-key sampling and refresh candidate reporting |
| v0.53.0 | Passed | Passed | Corpus coverage present | Retry fatigue Markdown coverage added | Go SDK and REST Markdown export tests added | Adds Markdown incident handoff export for endpoint-level retry fatigue |
| v0.52.0 | Passed | Passed | Corpus coverage present | Publish freshness coverage added | CLI publish freshness tests added | Adds read-only freshness checks for published backup catalog metadata |
| v0.51.0 | Passed | Passed | Corpus coverage present | Retry fatigue coverage added | Go SDK, REST, and GraphQL retry fatigue tests added | Adds read-only endpoint-level fatigue summaries for failed review handoff retries |
| v0.50.0 | Passed | Passed | Corpus coverage present | Vector repair coverage added | CLI vector repair report tests added | Adds dry-run-first vector index repair execution for reviewed rebuild candidates |
| v0.49.0 | Passed | Passed | Corpus coverage present | Store consistency coverage added | CLI doctor store consistency tests added | Adds opt-in local doctor checks for fingerprint lookups and vector rebuild candidates |
| v0.48.0 | Passed | Passed | Ranking eval snapshot coverage added | Restart coverage present | CLI ranking eval snapshot test added | Adds JSON score-drift reports for the representative corpus |
| v0.47.0 | Passed | Passed | Corpus coverage present | Lifecycle index publish drift coverage added | CLI lifecycle index publish drift tests added | Adds dry-run comparison between local and published backup catalog metadata |
| v0.46.0 | Passed | Passed | Corpus coverage present | Review handoff retry backoff coverage added | Go SDK, REST, and GraphQL retry recommendation tests added | Adds read-only retry pacing recommendations from delivery receipt history |
| v0.45.0 | Passed | Passed | Corpus coverage present | Review handoff retry execution coverage added | Go SDK, REST, and GraphQL retry execution tests added | Adds explicit operator-triggered resend for unresolved failed handoff deliveries |
| v0.44.0 | Passed | Passed | Corpus coverage present | Review handoff retry candidate coverage added | Go SDK, REST, and GraphQL retry candidate tests added | Adds read-only retry candidates for unresolved failed handoff deliveries |
| v0.43.0 | Passed | Passed | Corpus coverage present | Review handoff delivery receipt coverage added | Go SDK, REST, and GraphQL receipt tests added | Adds append-only webhook delivery receipts with payload and response hashes |
| v0.42.0 | Passed | Passed | Corpus coverage present | Review handoff webhook execution coverage added | Go SDK, REST, and GraphQL execution tests added | Adds explicit synchronous webhook delivery with timeout and response capture |
| v0.41.0 | Passed | Passed | Corpus coverage present | Review handoff webhook plan coverage added | Go SDK, REST, and GraphQL webhook plan tests added | Adds signed dry-run webhook delivery plans for saved review handoffs |
| v0.40.0 | Passed | Passed | Corpus coverage present | Review handoff feed coverage added | Go SDK, REST, and GraphQL handoff feed tests added | Adds polling-friendly handoff feeds filtered by owner and escalation level |
| v0.39.0 | Passed | Passed | Corpus coverage present | Review escalation digest export coverage added | Go SDK, REST, and GraphQL digest snapshot tests added | Adds durable escalation digest snapshots for review handoffs |
| v0.38.0 | Passed | Passed | Corpus coverage present | Review escalation digest coverage added | Go SDK, REST, and GraphQL digest tests added | Adds grouped escalation summaries by owner, source, type, and escalation level |
| v0.37.0 | Passed | Passed | Corpus coverage present | Review escalation coverage added | Go SDK review queue escalation tests added | Adds escalation metadata for aged assigned/snoozed reviews and high-priority source anomalies |
| v0.36.0 | Passed | Passed | Corpus coverage present | Lifecycle index publish coverage added | CLI lifecycle index publish tests added | Adds dry-run-first backup catalog metadata publishing without backup contents |
| v0.35.0 | Passed | Passed | Corpus coverage present | Norn publish coverage added | CLI Norn publish tests added | Adds dry-run-first Norn manifest publishing with explicit HTTP execution |
| v0.34.0 | Passed | Passed | Corpus coverage present | Lifecycle index diff coverage added | CLI lifecycle index diff tests added | Adds bundle, retention decision, and artifact delta reporting between lifecycle manifest indexes |
| v0.33.0 | Passed | Passed | Corpus coverage present | Lifecycle index verification coverage added | CLI lifecycle index verify tests added | Adds artifact size and hash verification for lifecycle manifest indexes |
| v0.32.0 | Passed | Passed | Corpus coverage present | Lifecycle index coverage added | CLI lifecycle index tests added | Adds compact backup manifest indexes with artifact hashes |
| v0.31.0 | Passed | Passed | Corpus coverage present | Lifecycle delete-plan coverage added | CLI delete-plan tests added | Adds reviewable deletion-plan script output for pruneable backup lifecycle artifacts |
| v0.30.0 | Passed | Passed | Corpus coverage present | Lifecycle retention report coverage added | CLI retention report tests added | Adds dry-run retention reporting for backup lifecycle bundles |
| v0.29.0 | Passed | Passed | Corpus coverage present | Lifecycle verification coverage added | CLI lifecycle verification tests added | Adds lifecycle summary verification for backup artifact bundles |
| v0.28.0 | Passed | Passed | Corpus coverage present | Backup lifecycle runbook coverage added | Docs lifecycle script verified by docs build | Adds guarded full-chain backup lifecycle workflow |
| v0.27.0 | Passed | Passed | Corpus coverage present | Promotion receipt verification coverage added | CLI receipt verification tests added | Adds receipt-to-manifest verification for restore promotion artifacts |
| v0.26.0 | Passed | Passed | Corpus coverage present | Restore promotion receipt coverage added | CLI import receipt tests added | Adds promotion JSON receipts for snapshot imports |
| v0.25.0 | Passed | Passed | Corpus coverage present | Restore promotion checklist coverage added | CLI rehearsal report tests added | Adds rehearsal timestamp, target namespace, and recommended import command |
| v0.24.0 | Passed | Passed | Corpus coverage present | Restore rehearsal coverage added | CLI rehearsal tests added | Adds combined artifact verification and dry-run restore preflight |
| v0.23.0 | Passed | Passed | Corpus coverage present | Backup manifest verification coverage added | CLI verify tests added | Adds pre-restore checksum, size, and record-count verification |
| v0.22.0 | Passed | Passed | Corpus coverage present | Backup artifact manifest coverage added | CLI manifest tests added | Adds checksummed JSON sidecars for snapshot export artifacts |
| v0.21.0 | Passed | Passed | Corpus coverage present | Backup runbook documents restore preview and marker checks | Feature metadata docs updated | Adds scheduled backup runbook for launchd, systemd, doctor, and Norn pairing |
| v0.20.0 | Passed | Passed | Corpus coverage present | Snapshot diff preview coverage added | Client snapshot diff report tests added | Adds new, changed, and unchanged node counts for snapshot restore reports |
| v0.19.0 | Passed | Passed | Corpus coverage present | Snapshot marker coverage added | CLI backup marker test added | Adds export-side backup marker for doctor readiness |
| v0.18.0 | Passed | Passed | Corpus coverage present | Snapshot report coverage added | Client snapshot report tests added | Adds dry-run and import reports for snapshot restore counts |
| v0.17.0 | Passed | Passed | Corpus coverage present | Snapshot export/import coverage added | CLI and client snapshot tests added | Adds public snapshot backup/restore helpers and CLI dry-run validation |
| v0.16.0 | Passed | Passed | Corpus coverage present | Restart coverage present | CLI Norn drift tests added | Adds live Norn manifest drift reporting |
| v0.15.0 | Passed | Passed | Corpus coverage present | Restart coverage present | SDK, REST, and GraphQL review queue filter tests added | Adds review queue filters by type, source, status, and owner |
| v0.14.0 | Passed | Passed | Corpus coverage present | Restart coverage present | CLI Norn helper tests added | Adds local Norn registration helper |
| v0.13.0 | Passed | Passed | Corpus coverage present | Restart coverage present | REST and GraphQL source anomaly coverage added | Adds source trust anomaly review tasks |
| v0.12.0 | Passed | Passed | Corpus coverage present | Restart coverage present | REST and GraphQL review decision coverage added | Adds durable review workflow decisions |
| v0.11.2 | Passed | Passed | Corpus coverage present | Restart coverage present | Existing contract tests present | Adds this release health page and docs wiring |
| v0.11.1 | Passed | Passed | Representative corpus golden test added | Restart coverage present | Existing contract tests present | Hardened ranking candidate pool |
| v0.11.0 | Passed | Passed | Golden fixtures present | Restart coverage present | REST and GraphQL explain-rank coverage expanded | Added graph evidence to explain-rank |
| v0.10.0 | Passed | Passed | Golden fixtures present | Restart coverage present | Existing contract tests present | Added backup marker doctor check |
| v0.9.0 | Passed | Passed | Golden fixtures present | Restart coverage present | REST and GraphQL acquisition plan coverage added | Added acquisition planner |
| v0.8.0 | Passed | Passed | Golden fixtures present | Restart coverage present | REST and GraphQL explain-rank coverage added | Added explain-rank API |
| v0.7.0 | Passed | Passed | Golden fixtures present | Restart coverage present | REST and GraphQL review queue coverage added | Added claim review queue |
| v0.6.0 | Passed | Passed | Golden fixtures present | Restart coverage present | REST and GraphQL trust timeline coverage added | Added source trust timeline |
| v0.5.0 | Passed | Passed | Golden fixtures present | Restart coverage present | REST and GraphQL feedback event coverage added | Added feedback event log |
| v0.4.1 | Passed | Passed | Golden fixtures present | Restart coverage present | Existing contract tests present | Added doctor sample-write probe |
| v0.4.0 | Passed | Passed | Golden fixtures added | Badger restart test added | gRPC contract and REST failure-path tests added | Added introspection and first doctor slice |
Interpreting Status
Passed means the gate was run during the local release slice before the commit and tag. Present means the release contains an automated test that covers the area, even if the table points to the broad suite rather than a single command.
Race and soak checks are not yet mandatory because they are slower and more environment-sensitive. They remain a recommended gate for storage, federation, compaction, or concurrent retrieval changes.