docs: honest framing — tamper-evident/verifiable, not 'deterministic/reversible like Git'#6
Merged
Merged
Conversation
…reversible like Git' The published korg crate description + README/ROADMAP/CONTRIBUTING taglines claimed 'the first deterministic cognitive runtime ... reversible — like Git, but for cognition.' But the codebase itself stripped 'revert theater' (f04ccfe), and LLM agents aren't deterministic — so the headline overclaimed. Realign the positioning to what the project actually is, and to the live site's own framing (tamper-evident, verifiable, zero trust, no blockchain). Surgical: ONLY the headline tagline + crate keywords. The accurate technical uses of 'deterministic' (JCS canonicalization, projection folds, journal replay, git-read-tree rollback, HLC ordering, the test fixture) are left untouched — those genuinely are deterministic. Also: normalize the @korgg/ledger-verify package.json repository.url (git+https, silences the npm publish warning). Docs/metadata only; cargo verify-project OK.
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
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.
Realigns the project's headline positioning to what it actually is — and to the live site's own framing (tamper-evident, verifiable, zero trust, no blockchain).
Why
The published
korgcrate description and the README / ROADMAP / CONTRIBUTING taglines all claimed "the first deterministic cognitive runtime … reversible — like Git, but for cognition." But:So the headline overclaimed against the project's own honest direction.
What changed (surgical — tagline only)
Cargo.tomldescriptionCargo.tomlkeywordsdeterministic→verifiable,tamper-evidentREADME.mdsubtitleROADMAP.md/CONTRIBUTING.mdDeliberately left untouched: the accurate technical uses of "deterministic" — JCS canonicalization, projection folds, journal replay, git-read-tree rollback, HLC ordering, the embedding test fixture. Those genuinely are deterministic; only the cognition-level headline was the overclaim.
Also normalizes the
@korgg/ledger-verifypackage.jsonrepository.url (silences the npm publish warning).Docs/metadata only;
cargo verify-projectOK. Left unmerged for your review — it's brand copy, your call. (crates.io'skorg@0.1.0page only updates on the next republish.)