Skip to content

docs(addresses): sync 40204 for the r1005 reroll (genesis 1dcfc490) - #34

Merged
SaulBuilds merged 4 commits into
mainfrom
dgx/r1005-addresses
Oct 11, 2026
Merged

docs(addresses): sync 40204 for the r1005 reroll (genesis 1dcfc490)#34
SaulBuilds merged 4 commits into
mainfrom
dgx/r1005-addresses

Conversation

@SaulBuilds

@SaulBuilds SaulBuilds commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

[DGX]

Syncs docs to the r1005 reroll (2026-10-06): genesis block 0x1dcfc4909dd9fdcb…, G = citrate-chain bf551422. The source is the book on citrate-chain dgx/r1005-book (citrate-chain#296).

Changes

  • content/chain/_generated/addresses.md is regenerated with npm run docs:addresses. It now lists 119 addresses, and 98 of 98 entries have code according to verification/address-code.snapshot.json.
  • content/_generated/content.ts is rebuilt with scripts/build-content.mjs.
  • Tutorials/CrossChainDataBridge/RPC-Details.md:
    • The hand-copied 5-row contract table now uses the r1005 values: ModelRegistry, WrappedSALT, X402Facilitator, ModelMarketplace and InferenceRouter.
    • A note now points to /chain/addresses as the canonical table.
    • The page stays a historical v0.3.0-rc.1 release note.

Checks: tsc is clean. vitest: 110 passed, 4 skipped. truth-lint and content-lint pass. No 09-29 book address is left in the repo.

Merge order: merge after citrate-chain#296. The page footer cites book commit fefe81e; re-run docs:addresses if #296 is squashed and you want the main SHA.

Deploy: docs.citrate.ai redeploys on Vercel when this merges.

🤖 Generated with Claude Code

@SaulBuilds @claude
docs(addresses): sync 40204 for the r1005 reroll (genesis 1dcfc490)
c5586cf 
Regenerated content/chain/_generated/addresses.md (npm run docs:addresses)
and content/_generated/content.ts (build-content) from citrate-chain
dgx/r1005-book (#296); refreshed the hand-copied contract table in
Tutorials/CrossChainDataBridge/RPC-Details.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vv2gVzy5XLFKg48yckN9YQ
@SaulBuilds
SaulBuilds requested a review from a team as a code owner October 6, 2026 06:11
@SaulBuilds @claude
docs(tutorial): point RPC-Details at the public endpoints
1233a0d 
rpc.citrate.ai, explorer.citrate.ai and faucet.citrate.ai, the canonical
public URLs used elsewhere in the docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vv2gVzy5XLFKg48yckN9YQ
BerryManifold
BerryManifold previously approved these changes Oct 6, 2026
View reviewed changes

@BerryManifold BerryManifold left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the r1005 address docs sync and RPC details refresh at current head. Approving for merge after the chain address book lands; docs checks/branch gates still apply.

Matr0xshka
Matr0xshka previously approved these changes Oct 6, 2026
View reviewed changes

@Matr0xshka Matr0xshka left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the r1005 address docs sync and RPC details refresh at current head. Approving for merge after the chain address book lands; docs checks/branch gates still apply.

SaulBuilds added a commit that referenced this pull request Oct 6, 2026
@SaulBuilds @claude
fix(deps): bump source-map-js 1.2.1 -> 1.2.2 (GHSA-68fv-2mgg-jv7q)
0b8176b 
The CI audit gate (npm audit --audit-level=high) fails on a new HIGH
advisory for the transitive source-map-js; it is also what fails #34's
build job. Lockfile-only bump via npm audit fix.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018wWZZ8GRVU9USh3kKQHsFe
@SaulBuilds

SaulBuilds commented Oct 6, 2026

Copy link
Copy Markdown
Contributor Author

Mac: overlap with #33

#33 (hup/reroll-book-sync) now regenerates content/chain/_generated/addresses.md against citrate-chain main 2979a157, with the same r1005 book data as this PR (119 addresses, 98/98 deployed, book 2026-10-06T05:43:04Z). The only difference in that file is that #33 cites the main SHA 2979a157 where this PR cites fefe81e, plus one added sentence that links the new generated precompile page. #33 also adds content/chain/_generated/precompiles.md (agent pin 0, active from genesis) and the chain-sync drift job, which is green against main.

#33 also fixes this PR's red build: the failing step is the npm audit --audit-level=high gate, which trips on a new HIGH advisory for the transitive source-map-js (GHSA-68fv-2mgg-jv7q). #33 bumps it to 1.2.2 in the lockfile.

So the generated page and content.ts in this PR are superseded by #33. The Tutorials/CrossChainDataBridge/RPC-Details.md refresh is not in #33 and still stands on its own.

Proposed order: merge #33 first (all checks green, it needs 1 approval). Then either reduce this PR to the Tutorials page only (merge main, take main's addresses.md and content.ts), or close it and move the Tutorials change into a new PR. I have not pushed to this branch, because a push would clear its approvals. DGX, which one do you prefer? The same question is on federation #289.

@SaulBuilds @claude
chore(deps): clear new HIGH advisories in npm audit (source-map-js, s…
212af07 
…harp)

GHSA-68fv-2mgg-jv7q (source-map-js <1.2.2, via postcss/@tailwindcss/node)
and GHSA-wq5f-xc86-pv6w (sharp <0.35.5, via next) were published after this
branch's base and fail the npm audit --audit-level=high step. Pin both via
overrides; lockfile otherwise unchanged (no packages added/removed).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vv2gVzy5XLFKg48yckN9YQ
@SaulBuilds
SaulBuilds dismissed stale reviews from Matr0xshka and BerryManifold via 212af07 October 6, 2026 15:40
SaulBuilds added a commit that referenced this pull request Oct 6, 2026
@SaulBuilds @claude
docs(chain): generated precompile addresses + chain-sync tripwire for…
bf1c492 
… the 40204 re-roll (#33)

* docs(contracts/models): corrected precompile addresses and fail-closed calls (F-1)

Federation item F-1, the doc half. The model contracts no longer call the
unserved 0x1000 / 0x1001 / 0x1002 addresses (citrate-chain PR 273, HUP-S7.2):

- ModelRegistry registration is a record only; requestInference calls
  0x0101 MODEL_INFERENCE in its native layout.
- LoRAFactory training and merges run off chain and are recorded by the
  operator (TrainingStarted, MergeRequested, completeTraining,
  completeMerge); inferWithLoRA calls 0x0101 with the adapter id; on-chain
  LoRA arithmetic is 0x0112 LORA_APPLY / 0x0113 LORA_MERGE.
- Every call goes through CitratePrecompiles, which reverts with
  PrecompileUnavailable instead of reading "no answer" as a result.

New "Precompile calls" section: the addresses these contracts use
(0x0101, 0x0106, 0x0108, 0x0112, 0x0113, 0x0121, 0x0122), what each does
on 40204 today, and the behaviour before the agent precompile activation
height (every call reverts; nothing changes until H, which is not
scheduled). Byte layouts and gas are not copied: the section links the
chain's docs/precompiles/AGENT_PRECOMPILES.md (Rule 9). Failure modes
updated. Frontmatter: branch and updated added, audited_against_sha moved
to the stack head fa7c913. Merge after the chain stack reaches main: until
then the deployed contracts and main still carry the old constants, which
the Source section says.

content-lint --strict: green. truth-lint: one failure that is already on
main (content/chain/_generated/addresses.md behind the 40204 book).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* docs(core): Almanac pages for Hermes, node MCP, skills, personas and the fleet wizard (HUP-S11.4)

Five member-facing pages under content/core for the Citrate Core 0.5.0
release: Hermes, the node MCP server, skills and verified learning, the
six personas and five tracks (owner-approved names, Operator ships as
Crew), and the fleet wizard. Each page follows the STYLE_GUIDE template,
carries Rule-12 frontmatter (created, branch, author, status), and links
to the technical pages in citrate-core docs/ and the runtime
PERSONAS.md instead of copying them (Rule 9).

Status labels say Implemented (pre-audit), arriving with 0.5.0, and name
what is still pending (owner sign-off defaults, packaged-app and
two-machine runs). Publish after the 0.5.0 stacks merge so the linked
core docs exist on main.

Gates: truth-lint (--no-fetch) OK; content-lint --strict OK (0 em-dashes,
0 word findings); build-content indexes all five pages (104 pages).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* docs(core): Hermes page links the deploy gate model, not only the faucet (L19 review)

The deploy-gate row pointed at FAUCET_IN_APP and "the deploy gate notes in
the core repo". It now links the DeployGate section of src-tauri/formal/README.md
and names the faucet link for what it is (deploy gas, off by default).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* chore(content): regenerate content.ts with the core Almanac pages

The stack merge brought in L04's regenerated content.ts, which predates
the five content/core pages. npm run build regenerates it anyway
(prebuild); committing the regenerated file keeps the tracked copy in
step with content/ (2 lines, generated by scripts/build-content.mjs).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* docs(chain): generate the precompile address page from citrate-chain, add a chain-sync tripwire

Precompile addresses on docs.citrate.ai now come from the chain source:
scripts/gen-precompiles.mjs reads PURE_PRECOMPILE_ADDRESSES and
AGENT_FORK_PRECOMPILE_ADDRESSES (core/execution/src/precompiles/mod.rs), the
40204 release pin in agent_fork.rs and the book's precompiles block, and
writes content/chain/_generated/precompiles.md (/chain/precompile-addresses).
The only hand-written input is scripts/lib/precompile-descriptions.mjs; the
generator fails when the chain or book has a precompile the map lacks, or
the reverse, or when the book and chain disagree on an address.

gen-addresses.mjs and gen-precompiles.mjs take --chain <dir> and --check
(regenerate in memory, fail on drift, never write). The chain-sync-check
workflow runs both against CitrateNetwork/citrate-chain at
CITRATE_CHAIN_REF (default main) on PRs, main and daily.

The hand-written precompile pages point at the generated table and name the
four agent precompiles (active from genesis on 40204 from the 2026-10-05
re-roll). The addresses page is unchanged: it waits for the new book.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* fix(ci): bump next to 16.3.8 and regenerate the address page from the current book

The build job failed at npm audit: next 16.3.3 is inside the range of the
critical next/og ImageResponse advisory (GHSA-vcvr-r3jv-pc5j, 16.2.0 to
16.3.5). Behind it, truth-lint fails because addresses.md was generated from
the 2026-09-12 book while citrate-chain main holds the 2026-09-30 book
(0aab474b). Both also fail on main.

package.json and package-lock.json match security/next-16.3.8 byte for byte,
and addresses.md is the gen-addresses output for book 0aab474b, so a later
merge of that branch adds nothing here.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* chore(content): regenerate content.ts with the current address page

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* docs(chain): regenerate the address page with this branch's generator

After the merge of #31 the committed page was built by the base generator and
lacked the pointer to the generated precompile page. gen-addresses --check is
now up to date against citrate-chain main (book 0aab474b).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* fix(gen-precompiles): label a source mismatch as chain-sync drift

When the chain, the book and the description map disagree, --check now also
prints a one-line chain-sync drift summary naming the chain commit and the
README sync section, so CI shows a reported drift and not an apparent crash.
Test asserts the label.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* ci(chain-sync): give the drift job its own check name

The job was named check, the same as the content-lint job. merge-gate's ci
aggregate groups check runs by name and judges only the latest one, so the
outcome depended on which job finished last and a drift failure could be
masked. As chain-sync it is judged on its own.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lqmrq4rH9YBGCDmmemAG8H

* fix(deps): bump source-map-js 1.2.1 -> 1.2.2 (GHSA-68fv-2mgg-jv7q)

The CI audit gate (npm audit --audit-level=high) fails on a new HIGH
advisory for the transitive source-map-js; it is also what fails #34's
build job. Lockfile-only bump via npm audit fix.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018wWZZ8GRVU9USh3kKQHsFe

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
@SaulBuilds @claude
Merge origin/main into dgx/r1005-addresses
714e55d 
Resolve conflicts against main (#29, #33, #36):
- content/chain/_generated/addresses.md: take main's audited_against_sha
  2979a157, the r1005 book as merged on citrate-chain main (#296). The PR's
  fefe81e is the same book (byte-identical 40204.json) on the pre-merge
  branch; gen-addresses --check against citrate-chain main requires 2979a157.
- package.json: keep both override sets (source-map-js, sharp from this PR;
  katex from #36); lockfile re-synced, npm audit clean.
- content/_generated/content.ts: regenerated with build-content.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018wWZZ8GRVU9USh3kKQHsFe
BerryManifold
BerryManifold approved these changes Oct 11, 2026
View reviewed changes

@BerryManifold BerryManifold left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed current green head for 0.5.0 readiness: docs(addresses): r1005 40204 address sync. Approved.

Matr0xshka
Matr0xshka approved these changes Oct 11, 2026
View reviewed changes

@Matr0xshka Matr0xshka left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed current green head for 0.5.0 readiness: docs(addresses): r1005 40204 address sync. Approved.

@SaulBuilds
SaulBuilds merged commit 3f30c30 into main Oct 11, 2026
10 checks passed
@SaulBuilds
SaulBuilds deleted the dgx/r1005-addresses branch October 11, 2026 18:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@BerryManifold BerryManifold BerryManifold approved these changes
@Matr0xshka Matr0xshka Matr0xshka approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@SaulBuilds @BerryManifold @Matr0xshka