From 0d08e6c86f71b03455608f0f135923de3421cc57 Mon Sep 17 00:00:00 2001 From: ares <285551516+New1Direction@users.noreply.github.com> Date: Sat, 6 Jun 2026 07:11:48 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20honest=20framing=20=E2=80=94=20tamper-e?= =?UTF-8?q?vident/verifiable,=20not=20'deterministic/reversible=20like=20G?= =?UTF-8?q?it'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- CONTRIBUTING.md | 2 +- Cargo.toml | 4 ++-- README.md | 2 +- ROADMAP.md | 2 +- spec/korg-ledger-v1/js/package.json | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bea3359..459b197 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # Contributing to Korg -Thank you for your interest in contributing to **Korg — the first deterministic cognitive runtime**. +Thank you for your interest in contributing to **Korg — a tamper-evident, verifiable ledger for AI agent cognition**. --- diff --git a/Cargo.toml b/Cargo.toml index 96b4513..758864d 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -32,12 +32,12 @@ axum = { version = "0.7", features = ["macros"] } name = "korg" version = "0.1.0" edition = "2021" -description = "The first deterministic cognitive runtime. Every AI agent decision is logged, causally ordered, and reversible — like Git, but for cognition." +description = "A tamper-evident, verifiable ledger for AI agent cognition: every decision is recorded in a hash-chained, causally-ordered journal that anyone can independently verify — no blockchain, no trust in the tool that produced it." license = "MIT OR Apache-2.0" repository = "https://github.com/New1Direction/korg" homepage = "https://github.com/New1Direction/korg" documentation = "https://github.com/New1Direction/korg#readme" -keywords = ["ai", "agents", "runtime", "deterministic", "autonomous"] +keywords = ["ai", "agents", "verifiable", "tamper-evident", "ledger"] categories = ["command-line-utilities", "development-tools", "asynchronous"] readme = "README.md" exclude = [ diff --git a/README.md b/README.md index 88d361f..f06f55f 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # korg **A causally-ordered, rewindable event-ledger for autonomous AI agents.** -*Every decision your AI agent makes is logged, structured, and reversible — like Git, but for cognition.* +*Every step your AI agent takes, recorded in a hash-chained ledger you can independently verify — tamper-evident, zero trust, no blockchain.* [![License: MIT OR Apache-2.0](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT) [![Rust 2021](https://img.shields.io/badge/rust-2021-93450a.svg?style=flat-square)](https://www.rust-lang.org) diff --git a/ROADMAP.md b/ROADMAP.md index de7f97c..5dee563 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -1,6 +1,6 @@ # Roadmap -> **Current release:** [v0.1.0](https://github.com/New1Direction/korg/releases/tag/v0.1.0) — The first deterministic cognitive runtime. +> **Current release:** [v0.1.0](https://github.com/New1Direction/korg/releases/tag/v0.1.0) — a tamper-evident, verifiable ledger for AI agent cognition. --- diff --git a/spec/korg-ledger-v1/js/package.json b/spec/korg-ledger-v1/js/package.json index 62889fe..d52e92e 100644 --- a/spec/korg-ledger-v1/js/package.json +++ b/spec/korg-ledger-v1/js/package.json @@ -34,7 +34,7 @@ "license": "MIT OR Apache-2.0", "repository": { "type": "git", - "url": "https://github.com/New1Direction/korg", + "url": "git+https://github.com/New1Direction/korg.git", "directory": "spec/korg-ledger-v1/js" }, "homepage": "https://github.com/New1Direction/korg/tree/main/spec/korg-ledger-v1"