docs: refresh docs to match the now-shipped reality (real swarm, Gold Seal, honest pipeline, live model)#17
Merged
Merged
Conversation
… Seal, honest pipeline, live model) Audited the tracked product docs against what is actually on `main` and applied surgical, honest fixes. Already-accurate docs (korg-registry, korg-embeddings, korg-auth, korg-bridge, korg-seal) were left untouched. README.md: - Status section rewritten: honest shipped/planned split; 300+ tests (was a stale "175"); swarm listed as a real 5-persona swarm; surfaced the Gold Seal, honest pipeline, live-model and in-browser verifiers. - BERT/Candle made honest (optional `candle` feature; deterministic fallback). - Comparison gained Gold Seal + honest-attestation rows; added the live-model swarm example + in-browser verifier links; removed stale "ARCHITECTURE coming soon". ARCHITECTURE.md: 4-persona -> 5-persona (added the distinct `Persona::Evaluator`); new "Verifiable Flight-Recorder Capabilities" section (ledger@v1, Gold Seal, honest run-once, provider model) with a clearly-marked Planned list. ROADMAP.md: removed micro-healing from future work (it is already shipped). Crate/adapter READMEs + docs/: removed invented perf/size numbers (GIT_ISOLATION "<50ms", POSITIONING "200-line"); de-stale'd brittle exact test counts (korg-core, korg-setup) or corrected them to the real counts (recall-mcp); documented `response_format` + `DeterministicProvider` (korg-llm); clarified legacy flat-ledger vs the recommended verifiable per-session capture (claude-code); honest "no bundled SPA/WASM frontend" (korg-server); corrected stale placeholder/stub claims that no longer match the code (korg-tui). Each edit was audited against the source and re-checked by an adversarial honesty critic; spot-verified that all numbers are counted, not invented.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Audited the tracked product docs against what's actually on
mainand applied surgical, honest fixes. Already-accurate docs (korg-registry, korg-embeddings, korg-auth, korg-bridge, korg-seal) were left untouched.Run as an audit → honest-update → adversarial-critic pipeline against a strict shipped-reality brief, then spot-verified the riskiest edits against source. The agents removed overclaims (invented numbers, stale placeholder claims) as much as they fixed stale ones — fitting for a trust product.
README.md
candlefeature; deterministic fallback otherwise).ARCHITECTURE.md
Persona::Evaluator).run-once, provider model) with a clearly-marked Planned list.Other docs
GIT_ISOLATION"<50ms";POSITIONING"200-line").response_format+DeterministicProvider(korg-llm).Test plan