Skip to content

docs: the README sold a kernel that is not on npm and not on main - #12

Merged
DealAppSeo merged 1 commit into
mainfrom
fix/cc-2026-08-05-readme-honest
Aug 6, 2026
Merged

docs: the README sold a kernel that is not on npm and not on main#12
DealAppSeo merged 1 commit into
mainfrom
fix/cc-2026-08-05-readme-honest

Conversation

@DealAppSeo

Copy link
Copy Markdown
Owner

The front page of a public protocol repo opened with npm install @hyperdag/protocol, a createHDP example, a six-interface/six-default table, links to ARCHITECTURE.md and packages/protocol/README.md, and a row reading "V1 — Live today … Six-interface modular kernel · @hyperdag/protocol@0.1.0-alpha on npm."

Verified against the registry, not assumed

npm view @hyperdag/protocol            -> 404
npm view @hyperdag/identity-erc8004    -> 404
npm view @hyperdag/reputation-zkp      -> 404
npm view @hyperdag/validation-trinity  -> 404
npm view @hyperdag/payment-x402        -> 404
npm view @hyperdag/linkage-registry    -> 404
npm view @hyperdag/hallucination-hal   -> 404

Seven for seven. The kernel source is not on main either — it's on feat/modular-kernel-interfaces-2026-05-04 — and both linked docs 404 on disk. packages/protocol and packages/interfaces hold only untracked dist output with no rebuildable source.

So the first command a visiting developer runs fails, and the two links they'd follow to understand why are dead.

What was actually wrong

The underlying work is real — contracts live on Base Sepolia, HAL and x402 running, interface design settled. What was false was the packaging: present-tense claims of a shipped, installable artifact.

Rewritten to state what's true and route a visitor to something that works:

  • Quick start now installs @hyperdag/trustshell, which is published, with a real working call (verifyOutput) instead of an unrunnable createHDP example
  • createHDP retained, explicitly labelled a design target, not a shipped API
  • Six-defaults table gains a status column per row, and names the two packages that do exist here (hallucination-hal-local, identity-erc8004-viem) — neither of which is one of the six
  • Dead links removed; every remaining relative link now resolves on disk (verified)
  • The "Live today" row separates what is live (contracts, HAL, x402, all reachable via trustshell) from what is branch-only (the kernel)

No claim was softened that was true, and no work was hidden. The vision reads the same; only the tense changed.

Found by the same 12-agent audit as #10 and #11. Independent of both — touches only README.md.

🤖 Generated with Claude Code

The front page of a public protocol repo opened with `npm install
@hyperdag/protocol`, a `createHDP` example, a six-interface/six-default table,
links to ARCHITECTURE.md and packages/protocol/README.md, and a row reading
"V1 - Live today ... Six-interface modular kernel · @hyperdag/protocol@0.1.0-alpha
on npm."

Verified against the registry and the branch, not assumed:

  npm view @hyperdag/protocol            -> 404
  npm view @hyperdag/identity-erc8004    -> 404
  npm view @hyperdag/reputation-zkp      -> 404
  npm view @hyperdag/validation-trinity  -> 404
  npm view @hyperdag/payment-x402        -> 404
  npm view @hyperdag/linkage-registry    -> 404
  npm view @hyperdag/hallucination-hal   -> 404

Seven for seven. The kernel source is not on main either - it is on
feat/modular-kernel-interfaces-2026-05-04 - and both linked docs 404 on disk.
packages/protocol and packages/interfaces hold only untracked dist output with
no rebuildable source. So the first command a visiting developer runs fails, and
the two links they follow to understand why are dead.

The underlying work is real: the contracts are live on Base Sepolia, HAL and
x402 are running, and the interface design is settled. What was false was the
PACKAGING - present-tense claims of a shipped, installable artifact.

Rewritten to state what is true and to route a visitor to something that
actually works:
  - quick start now installs @hyperdag/trustshell, which IS published, with a
    real working call (verifyOutput) instead of an unrunnable createHDP example.
  - createHDP retained, explicitly labelled a design target, not a shipped API.
  - the six-defaults table gains a status column per row, and names the two
    packages that DO exist here (hallucination-hal-local, identity-erc8004-viem),
    neither of which is one of the six.
  - dead links to ARCHITECTURE.md and packages/protocol/README.md removed; every
    remaining relative link in the README now resolves on disk.
  - the "Live today" row separates what is live (contracts, HAL, x402, all
    reachable via trustshell) from what is branch-only (the kernel).

No claim was softened that was true, and no work was hidden. The vision reads
the same; only the tense changed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@DealAppSeo
DealAppSeo merged commit e147f46 into main Aug 6, 2026
3 checks passed
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