Skip to content

Commit 2a917db

Browse files
DealAppSeoclaude
andauthored
docs: drop the unshipped six-interface kernel and its two default packages (Sean approved) (#62)
The README, BUILDERS.md and CONTRIBUTING.md described a six-interface kernel (@hyperdag/protocol plus six default packages) that was designed in a May sprint and never shipped: the source sat on feat/modular-kernel-interfaces-2026-05-04, nothing was published to npm, and the "Known broken / not live" table listed things that did not exist. The two packages on main (packages/defaults/*) imported @hyperdag/interfaces, which is not in the repo, so they did not build from a clean clone; no other repository imports them. - README: says what is here (BUILDERS.md and the ERC-8004 team's contracts) and that nothing installs from it; drops the kernel section, the kernel API sample, the Known-broken table and the HAL parity row; the trust-model and threat-model tables name where each piece runs today (repid-engine, HyperDAG-core). - Receipts: one agent per row with the address that holds each token, re-read with ownerOf on Base Sepolia today (all 12 answer; 1 own address, 3 custodian, 8 deployer, as the 2026-10-05 check said). The old table put two agents per row. - BUILDERS.md, CONTRIBUTING.md, CLAUDE.md, the About proposal: no kernel. - Removed packages/defaults (hallucination-hal-local, identity-erc8004-viem), their dependabot entries, and check-map's read of the removed constants file; the registry addresses stay in BUILDERS.md and packages/contracts/README.md, and the existing map check still fails if BUILDERS stops saying we do not operate them. The May source is kept at the tag archive/modular-kernel-interfaces-2026-05-04. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
1 parent b8adc38 commit 2a917db

33 files changed

Lines changed: 44 additions & 2167 deletions

‎.github/dependabot.yml‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@ updates:
1010
directories:
1111
- "/"
1212
- "/packages/contracts"
13-
- "/packages/defaults/hallucination-hal-local"
14-
- "/packages/defaults/identity-erc8004-viem"
1513
schedule:
1614
interval: weekly
1715
day: monday

‎.github/workflows/ci.yml‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
# and until now that failed — so the most valuable check here is the boring one:
66
# `npm ci` from the committed lockfile has to work.
77
#
8-
# DESIGN RULE: no vacuous green. Four of five packages have no tests. A single
8+
# DESIGN RULE: no vacuous green. Not every directory has tests. A single
99
# green tick across the repo would claim coverage that does not exist, so the
1010
# `coverage-map` job prints the real per-package state and the contract tests
1111
# report their true tally rather than being hidden.
@@ -190,9 +190,8 @@ jobs:
190190
script=$(node -e "try{const s=require('./$manifest').scripts||{};process.stdout.write(s.test||'')}catch(e){}" 2>/dev/null)
191191
if [ -n "$script" ]; then
192192
has="\`$script\`"
193-
# A declared script proves nothing if its glob matches no file.
194-
# hallucination-hal-local declares `node --test tests/*.test.ts`
195-
# and ships only .mjs smoke files, so it greens over an empty set.
193+
# A declared script proves nothing if its glob matches no file
194+
# (a package once declared tests/*.test.ts and shipped only .mjs files).
196195
pattern=$(echo "$script" | grep -oE '[A-Za-z0-9_./*-]+\.(test|spec)\.[a-z]+' | head -1)
197196
if [ -n "$pattern" ]; then
198197
# shellcheck disable=SC2086

‎BUILDERS.md‎

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -21,17 +21,12 @@ publish X without touching this file.
2121
| Thing | State | How to check |
2222
|---|---|---|
2323
| **`@hyperdag/trustshell`** | **PUBLISHED — `1.8.0`** (measured 2026-10-23, with npm provenance; was 1.6.1 on 2026-10-14). The one package to install. | `npm view @hyperdag/trustshell version` |
24-
| `@hyperdag/protocol` | **NOT published** (404) | `npm view @hyperdag/protocol version` |
25-
| `@hyperdag/identity-erc8004`, `@hyperdag/reputation-zkp` | **NOT published** (404) | same |
2624
| `IdentityRegistry` on Base Sepolia (84532) | **LIVE** — `0x8004A818BFB912233c491871b3d84c89A494BD9e` | any RPC client, or basescan |
2725
| `ReputationRegistry` on Base Sepolia (84532) | **LIVE** — `0x8004B663056A597Dffe9eCcC1965A193B7388713` | same |
28-
| The six-interface kernel (`IIdentity`, `IReputation`, `IValidation`, `IPayment`, `ILinkage`, `IHallucination`) | source is on a feature branch, **not on `main`** | `git log origin/main -- packages/interfaces` |
2926

3027
| **The check: `POST /api/v1/classify`** | **LIVE**, public, keyless (measured 2026-10-04). See §1a. | the `curl` in §1a |
3128

32-
**So: `npm i @hyperdag/trustshell`. Not `@hyperdag/protocol`.** The README used to carry an
33-
npm badge for `@hyperdag/protocol`, a package that does not exist; it misled one of our own
34-
agents on 2026-09-08 and was removed on 2026-10-04.
29+
**So: `npm i @hyperdag/trustshell`.** Its CLI, MCP server and SDK are one package, and nothing installs from this repository.
3530

3631
**Published 1.8.0, measured 2026-10-23.** New in 1.8.0, Inspect: `trustshell check <run-url> --claims-file <file>` reads GitHub's own record of a GitHub Actions run and marks each sentence an agent wrote about it supported, contradicted or not checked. It exits 0 when every claim is supported, 1 when one is contradicted, and 3 when something was not checked; not checked never exits 0. Its only network call is to api.github.com. `trustshell verify`
3732
exits 0 on PASS or FLAG, 1 on VETO, and 2 when HAL did not decide (NOT_CHECKED, never a pass).
@@ -119,8 +114,8 @@ when the two disagree.
119114

120115
**The contract: what is agreed**
121116

122-
- **This repository**: the ERC-8004 spec, the interface designs and this file. No running
123-
code depends on it.
117+
- **This repository**: the ERC-8004 spec and contracts, and this file. No running code
118+
depends on it.
124119
- **The ERC-8004 registries on Base Sepolia (chain 84532)**: the ERC-8004 team's
125120
deployments ([erc-8004/erc-8004-contracts](https://github.com/erc-8004/erc-8004-contracts)).
126121
We use them; we do not operate them. Their addresses are in §1.
@@ -186,7 +181,6 @@ Until you have done that you do not know it is wired.
186181
| ERC-8004 reputation read paths (`getSummary`, `readFeedback`, `readAllFeedback`) | stable — defined by the ERC-8004 spec (`packages/contracts/ERC8004SPEC.md`), not ours to change. `getRepID` is a TrustShell SDK method that reads the engine, not a registry function. |
187182
| RepID **range** (10 floor, 10,000 cap) and the five tier names | stable |
188183
| RepID **tier thresholds** and the scoring weights behind them | **will move.** Tuning is deliberate and not published. Do not hardcode a threshold; read the tier. |
189-
| The six-interface kernel | pre-release, on a branch. Design against `@hyperdag/trustshell` instead. |
190184
| ZK proof shape | the live proof is a narrow range check (`repid > threshold`). Binding a proof to the full RepID derivation is roadmap, not shipped. Do not describe it as shipped. |
191185

192186
**Two things you will not find here, deliberately:** the RepID scoring formula

‎CLAUDE.md‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,12 @@ and are not the entry point: `@hyperdag/proof-verifier` (0.2.0, bundled inside t
6767
`@hyperdag/trustshell-mcp` (1.0.0 from 2026-07-08, older than the `trustshell-mcp` bin that
6868
ships inside trustshell itself). See `BUILDERS.md`.
6969

70+
**2026-10-24 (Sean):** the six-interface kernel and its two default packages
71+
(`packages/defaults/*`) were removed from `main`. They never shipped, nothing imported them,
72+
and `@hyperdag/protocol` was never published. The May source is kept at the tag
73+
`archive/modular-kernel-interfaces-2026-05-04`. Do not describe a kernel, `@hyperdag/protocol`
74+
or `createHDP` as part of this repository.
75+
7076
State FINDINGS, not inventories. *"A production key was committed and must be
7177
rotated"* is actionable; the key, the project id, the row counts and the service names
7278
are an incident. A published secret cannot be withdrawn, and a secret in git history
@@ -113,8 +119,8 @@ complete pasteable block at a time and say what a correct result looks like.
113119

114120
## What is actually here
115121

116-
An Nx monorepo, three packages: `packages/contracts` (Solidity + ABIs + the ERC-8004
117-
spec), `packages/circuits`, `packages/defaults`. Registries are live on Base Sepolia
122+
An Nx monorepo, two packages: `packages/contracts` (Solidity + ABIs + the ERC-8004
123+
spec) and `packages/circuits`. Registries are live on Base Sepolia
118124
(chain ID 84532) per the README — read `README.md` for the addresses rather than
119125
copying them into new files.
120126

‎CONTRIBUTING.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**Maintainer: Sean Goodwin.** GitHub faces are a **commit counter**, not credit — see [AUTHORS.md](AUTHORS.md).
44

5-
The stranger-facing product is [`@hyperdag/trustshell`](https://github.com/DealAppSeo/trustshell), not this repo. This repo is the interface kernel. `@hyperdag/protocol` is **not on npm**. Do not send “become a maintainer” mail; open a PR.
5+
The stranger-facing product is [`@hyperdag/trustshell`](https://github.com/DealAppSeo/trustshell), not this repo. This repo is the builder's map (`BUILDERS.md`) and the ERC-8004 team's contracts we build on; nothing installs from it. Do not send “become a maintainer” mail; open a PR.
66

77
## What to send here vs elsewhere
88

0 commit comments

Comments
 (0)