Skip to content

docs(validator): close remaining operator-truth gaps - #158

Merged
wallscaler merged 4 commits into
mainfrom
codex/validator-doc-pin-fix-20260828
Aug 28, 2026
Merged

docs(validator): close remaining operator-truth gaps#158
wallscaler merged 4 commits into
mainfrom
codex/validator-doc-pin-fix-20260828

Conversation

@wallscaler

@wallscaler wallscaler commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Outcome targets

  1. Operators see the shipped default policy pin: validated_supply_v1.
  2. confidential_primary_v1 is described as an explicit validation pin, not a Finney SN39 broadcast profile.
  3. Conflicting dated verifier records become NOT PROVEN, with broadcast blocked until a fresh live reproduction passes.
  4. The final operator-facing “shadow or authority” release gate becomes shadow-only.
  5. No recurring mode, scoring, allocation, publisher, wallet, chain, or CyberGym behavior changes.

What changed

  • Corrected the false “default is unpinned” statement and the adjacent “all signed shapes accepted” claim.
  • Named the exact Finney SN39 broadcast allowlist: validated_supply_v1 or validated_supply_v3.
  • Replaced a stale current-FAIL claim with NOT PROVEN. A prior FAIL and later AGREE describe different deployments, while no fresh live reproduction passed in this review.
  • Kept broadcast fail-closed on a fresh live reproduction.
  • Removed the last active documentation reference to an authority provenance gate.

Evidence

  • Head: e780ce9
  • Reviewed base: af234b3
  • Exact diff SHA-256: e3ddef41254168329f0b28a0d44794fa36ba3d522e728c1476c1f54e8415489b
  • scaffold/cli.py defaults require_policy to validated_supply_v1.
  • Finney SN39 preflight accepts only validated_supply_v1 or validated_supply_v3.
  • The live public weights endpoint timed out during this pass. This PR therefore makes no current convergence claim.
  • git diff --check: passed.
  • Claude Fable final exact-diff review: no P0, P1, or P2 findings.
  • Local focused collection is blocked by the known host scalecodec and cyscale namespace conflict. GitHub Linux CI is the test gate.

Merge gate

Merge only if required GitHub tests pass, the reviewed head remains unchanged, and no P0, P1, or P2 review finding appears.

Supersession

This preserves the valid facts from PR #145 without restoring deleted MINER_VALIDATOR.md, reintroducing authority guidance, or weakening the broadcast block.

The operator guide said the validator accepted every signed vector shape by default, but the shipped CLI pins validated_supply_v1. Correct the guidance so confidential-primary operators know they must opt into that policy explicitly.
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Aug 28, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-08-28T22:52:43.785648Z b923b66 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@cursor

cursor Bot commented Aug 28, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_1b59a9db-a7d3-455c-9baf-2b418f98db1c)

@cursor
cursor Bot requested a review from ai-hpc August 28, 2026 22:52

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b923b66a27

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/VIOLET_EXTERNAL_SCORES.md Outdated
Comment on lines +93 to +94
# CLI flag or env. The default pins validated_supply_v1, which rejects a plain
# confidential_primary or v3 vector. Set this explicitly to accept confidential_primary.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Remove the contradictory unpinned-validator guidance

Update the paragraph immediately below this example as part of the default-pin correction. It still says that validators which do not set the pin accept all signed shapes, but scaffold/cli.py supplies validated_supply_v1 by default and rejects an empty policy, so omitting the option actually rejects plain confidential-primary and v3 vectors as these new lines state. This contradiction can lead operators to omit the explicit confidential_primary_v1 opt-in and have their vectors rejected.

Useful? React with 👍 / 👎.

Date the last reproduced verifier mismatch, require a fresh live reproduction before broadcast, remove the last operator-facing authority-gate reference, and state the exact confidential-primary policy and Finney broadcast boundary.
@cursor

cursor Bot commented Aug 28, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_4a2d7621-2ec3-495c-bb9a-2dc62ac8c97c)

@wallscaler wallscaler changed the title docs(validator): state the default policy pin docs(validator): close remaining operator-truth gaps Aug 28, 2026
The earlier FAIL and later AGREE records describe different deployments, and the live endpoint did not answer this review. Report NOT PROVEN and keep broadcast gated on a fresh reproduction.
@cursor

cursor Bot commented Aug 28, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_2d21d10a-f9b4-4559-ba80-d4dee8ed798b)

Avoid implying that a mismatch is presently observed while the live agreement status remains NOT PROVEN.
@cursor

cursor Bot commented Aug 28, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_d7efe15b-0a0e-4e32-88fc-e0811d404b89)

@wallscaler
wallscaler merged commit 8e1815b into main Aug 28, 2026
7 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