Skip to content

docs+ai-forge+merkle-dag: fix moved-spec links, complete CLAUDE.md layout, syntax-check all patterns, de-flake Case 13 - #197

Merged
dsmcewan merged 4 commits into
mainfrom
claude/review-cleanup-nuhys7
Sep 24, 2026
Merged

dsmcewan merged 4 commits into
mainfrom
claude/review-cleanup-nuhys7

Conversation

@dsmcewan

@dsmcewan dsmcewan commented Sep 24, 2026 •

Copy link
Copy Markdown
Owner

What changed

  • docs/history/specs/2026-06-29-ai-forge-phase-{a,b,c,c2}-design.md: the ROADMAP.md link was ../ROADMAP.md, left over from when these lived in docs/specs/ (moved in 0901c66). Now ../../ROADMAP.md. None of these files is hash-pinned.
  • CLAUDE.md: the Layout list now includes demo/ and workflows/; the Testing section no longer claims every package keeps tests under scripts/. No mythological names introduced.
  • ai-forge/package.json: the check script now runs node --check on patterns/multiagent.mjs, eval.mjs and serving.mjs, not just rag.mjs and telos.mjs.
  • merkle-dag/scripts/test-orchestrate.mjs: Case 13's wall-clock floor (parallel run faster than serial) flaked in CI (paraWall=540ms vs serialWall=515ms) because with 60 ms sleeps and limit 2 the parallel saving was smaller than spawn/signing jitter. Reproduced locally (1 of 5 runs under CPU load). sleepMs is now 400 so the saving dominates jitter: 10 of 10 loaded runs pass, smallest margin 271 ms. The assertion and the vPeak concurrency proof are unchanged.
  • Merged current main (verify-stage work from build-gate: per-node verify stage, rebased onto main (supersedes #192) #195) to satisfy the up-to-date requirement.

Verification

All 31 CI jobs and required CI pass on 2d34b62; the Claude review found no issues. Locally: every package npm test, verify-contracts 313/313, committed self-weave verification ok, portable paths 0 violations.

Left for a maintainer

  1. docs/clotho-phase-1-design.md:75 cites a deleted file inside a text_sha256-pinned section; fixing it means regenerating the oracles.
  2. repository-manifest.json omits several components and is dated 2026-07-19 (CHANGE-PROTOCOL governance change).
  3. connectors/meta-ads-mcp/server.mjs has no package.json, tests, or CI job (F14, issue security(meta-ads-mcp): ungoverned runtime with a bypassable spend cap #177).
  4. workflows/hestia.js uses a name absent from docs/mythological-vocabulary.md (F11); needs human approval.
  5. Three governed plan documents still say "Node ≥ 18"; docs/STATUS.md is dated 2026-07-19 and hash-pinned.

🤖 Generated with Claude Code

https://claude.ai/code/session_01U142aAXSzf4pUt89HSvXTH

…DE.md layout

- The four ai-forge phase design specs were moved from docs/specs/ to
  docs/history/specs/ in 0901c66 without updating their relative link
  to docs/ROADMAP.md.
- CLAUDE.md's Layout omitted demo/ and workflows/, both CI-tested
  executable areas, and its Testing section claimed every package keeps
  tests under scripts/ (ai-native-memory uses tests/, demo uses test/).

All package test suites, verify-contracts (313/313), the committed
self-weave verification, and check-portable-paths pass unchanged.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U142aAXSzf4pUt89HSvXTH
The check script ran node --check on patterns/rag.mjs and
patterns/telos.mjs but not on the three later pattern modules, even
though their tests were checked. Add each module ahead of its tests.

ai-forge npm test passes; verify-contracts 313/313, the committed
self-weave verification, and check-portable-paths are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U142aAXSzf4pUt89HSvXTH
@dsmcewan dsmcewan changed the title docs: fix moved-spec ROADMAP links; list demo/ and workflows/ in CLAUDE.md layout docs+ai-forge: fix moved-spec links, complete CLAUDE.md layout, syntax-check all patterns Sep 24, 2026
test-orchestrate.mjs Case 13 asserts the parallel run finishes before
the serial one. With N=3 nodes and concurrency limit 2, the parallel
run saves about one sleepMs; at 60 ms that saving was smaller than the
run-to-run jitter of spawn and signing overhead, so the assertion
flaked (CI: paraWall=540ms vs serialWall=515ms on node 22; locally 1
of 5 runs failed under full CPU load).

Raise sleepMs to 400 so the saving dominates the jitter (10 of 10
loaded runs pass, smallest margin 271 ms). The assertion itself and
the vPeak concurrency proof are unchanged; the header comment no
longer claims an 80% threshold the code never enforced.

merkle-dag and build-gate npm test, verify-contracts 313/313, and the
committed self-weave verification pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U142aAXSzf4pUt89HSvXTH
@dsmcewan
dsmcewan marked this pull request as ready for review September 24, 2026 15:42
@claude

claude Bot commented Sep 24, 2026

Copy link
Copy Markdown

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@dsmcewan dsmcewan changed the title docs+ai-forge: fix moved-spec links, complete CLAUDE.md layout, syntax-check all patterns docs+ai-forge+merkle-dag: fix moved-spec links, complete CLAUDE.md layout, syntax-check all patterns, de-flake Case 13 Sep 24, 2026
@dsmcewan
dsmcewan merged commit 222abbb into main Sep 24, 2026
32 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.

2 participants