Skip to content

docs: honest framing — tamper-evident/verifiable, not 'deterministic/reversible like Git'#6

Merged
New1Direction merged 1 commit into
mainfrom
docs/honest-framing
Jun 6, 2026
Merged

docs: honest framing — tamper-evident/verifiable, not 'deterministic/reversible like Git'#6
New1Direction merged 1 commit into
mainfrom
docs/honest-framing

Conversation

@New1Direction

Copy link
Copy Markdown
Owner

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 korg crate description and the README / ROADMAP / CONTRIBUTING taglines all claimed "the first deterministic cognitive runtime … reversible — like Git, but for cognition." But:

  • the codebase stripped "revert theater" in f04ccfe ("honest dashboard — strip fabricated telemetry, git history & revert theater"), and
  • LLM agents are not deterministic.

So the headline overclaimed against the project's own honest direction.

What changed (surgical — tagline only)

Spot Before → After
Cargo.toml description "first deterministic cognitive runtime … reversible like Git" → "a tamper-evident, verifiable ledger for AI agent cognition … anyone can independently verify — no blockchain, no trust in the tool that produced it"
Cargo.toml keywords deterministicverifiable, tamper-evident
README.md subtitle "reversible — like Git, but for cognition" → "recorded in a hash-chained ledger you can independently verify — tamper-evident, zero trust"
ROADMAP.md / CONTRIBUTING.md same tagline realigned

Deliberately 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-verify package.json repository.url (silences the npm publish warning).

Docs/metadata only; cargo verify-project OK. Left unmerged for your review — it's brand copy, your call. (crates.io's korg@0.1.0 page only updates on the next republish.)

…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.
@New1Direction New1Direction merged commit 782a256 into main Jun 6, 2026
2 checks passed
@New1Direction New1Direction deleted the docs/honest-framing branch June 6, 2026 14:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant