Skip to content

docs: reconcile stale deployed-vs-verifier status + fix dead link - #145

Closed
ai-hpc wants to merge 2 commits into
mainfrom
ai-hpc/docs-drift-fix
Closed

docs: reconcile stale deployed-vs-verifier status + fix dead link#145
ai-hpc wants to merge 2 commits into
mainfrom
ai-hpc/docs-drift-fix

Conversation

@ai-hpc

@ai-hpc ai-hpc commented Aug 24, 2026

Copy link
Copy Markdown
Member

Doc-vs-code drift audit of the compute lane surfaced two doc-accuracy issues in this repo (docs only, no code change).

D1 (HIGH) — contradictory deployed vector vs verifier status

The same question has three different answers across the official docs:

  • VALIDATOR.md:33 (this repo) → hard FAIL, plus an operator directive to stay in non-writing preview "until the supported release converges"
  • cathedral-compute/docs/EVIDENCE_LANE.md:48 → "Not converged" (as of 2026-08-01)
  • cathedral-compute/BUILD_STATUS.md:22AGREE (2026-08-07) (the designated current-state doc; notes the 2026-07-28 redeploy converged production)

The live SN39 surface is currently unreachable (Cloudflare 522), so the current truth can't be adjudicated here. This change removes the flat stale FAIL/blocker verdict and makes VALIDATOR.md defer to a live re-derivation (the status moves with each deploy), while keeping the safety caution (confirm the live vector reproduces against the pinned verifier before broadcasting; stay in preview until it does).

D2 (MED) — dead reference

MINER_VALIDATOR.md:6 linked deploy/MECHANISM_ROUTER_CONTRACT.md, which does not exist in this repo (it's in the cathedral monorepo). Repointed to the in-repo deeper-contract doc, BOUNDARY.md.

Docs only — no reward/attestation/weight code touched. Flagging for review since D1 changes operator-facing guidance; please confirm the live converged state before merge.

🤖 Generated with Claude Code

ai-hpc and others added 2 commits August 25, 2026 01:30
…M_ROUTER link

Doc-vs-code drift audit (docs only; no code change):

- VALIDATOR.md Status table asserted a hard `FAIL` for "deployed vector vs
  independent verifier" and told operators to stay in non-writing preview
  "until the supported release converges." That verdict is stale and
  contradicts sibling docs: the 2026-07-28 redeploy converged production and
  cathedral-compute BUILD_STATUS.md reported AGREE (2026-08-07), while
  cathedral-compute EVIDENCE_LANE.md still says "not converged" — one question,
  three answers. Reconcile VALIDATOR.md to defer to a LIVE re-derivation (this
  status moves with each deploy) while keeping the safety caution: confirm the
  live vector reproduces against the pinned verifier before broadcasting.

- MINER_VALIDATOR.md linked deploy/MECHANISM_ROUTER_CONTRACT.md, which does not
  exist in this repo (it lives in the cathedral monorepo). Point it at the
  in-repo deeper-contract doc, BOUNDARY.md.

For wallscaler review; not self-merged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…_supply_v1)

VIOLET_EXTERNAL_SCORES.md's example said the require-policy default is "unpinned
(accepts legacy, v3, and confidential_primary)". The actual default is
validated_supply_v1 (scaffold/cli.py:59), which REJECTS a plain
confidential_primary/v3 vector (validator_thin.py:3470-3494). Fix the comment.

Doc-vs-code drift audit; docs only. For wallscaler review.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@wallscaler

Copy link
Copy Markdown
Contributor

Closing as superseded by PR #157 and PR #158.

Current main now:

  • removes MINER_VALIDATOR.md instead of repairing and reviving its false active model;
  • establishes thin/shadow relay as the only recurring operator-selectable SN39 runtime;
  • reports live deployed-vector agreement as NOT PROVEN because dated FAIL and AGREE records describe different deployments;
  • requires a fresh live reproduction before broadcast;
  • correctly documents validated_supply_v1 as the default pin and states that confidential_primary_v1 is not an accepted Finney SN39 broadcast pin.

No code from this PR is being merged.

@wallscaler wallscaler closed this Aug 28, 2026
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