Skip to content

docs(evaluator): add E2 descent proof consumer brief - #1854

Merged
briansrls merged 4 commits into
mainfrom
docs/e2-descent-proof-consumer-brief
May 6, 2026
Merged

briansrls merged 4 commits into
mainfrom
docs/e2-descent-proof-consumer-brief

Conversation

@briansrls

Copy link
Copy Markdown
Contributor

Summary

  • add the pre-authored E2 descent proof consumer worker brief
  • gate dispatch on the substrate descent_execution_proof authority landing
  • keep evaluator scope to proof-token consumption and fail-closed residual handling

Validation

  • git diff --cached --check before commit

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: codex / codex-default
  • Commit: ea203dca · Trigger: schedule
  • Comparison: origin/main @ 24463de8 ... review/pr-1854-ea203dca @ ea203dca
  • Thinking: 23s wall

Verdict: APPROVE

Diff is a narrowly scoped documentation brief, and I don’t see a concrete conflict with the pinned rubric docs. The brief consistently preserves single-authority and fail-closed discipline by keeping termination-proof production in substrate, forbidding evaluator-local inference, and requiring typed residual handling instead of fabricated execution. No testing-discipline violation is introduced by the brief itself.

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: openai-pro / gpt-5-5-pro
  • Commit: ba32bd1b · Trigger: manual
  • Comparison: main @ 21773f15 ... docs/e2-descent-proof-consumer-brief @ 9fcbfe0e
  • Conversation: View conversation

1. Story of the diff

This PR adds a single pre-authored worker brief for the future E2 evaluator consumer of descent execution proofs. The brief intentionally does not implement the evaluator change yet: it gates dispatch on a substrate-owned descent_execution_proof(...) -> Result<DescentExecutionProof, DescentResidual> authority or an explicitly ratified equivalent (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:3-21). The intended future mechanism is narrow: eval_loop may execute LoopBound::Descent only when it receives a certified proof token, otherwise it must keep failing closed with typed residual context (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:50-66). The load-bearing discipline is in the STOP bars: no evaluator-local proof inference, no reinterpretation as cardinality, no second evidence mirror, and no string matching of residuals (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:72-82).

2. Invariant categories

  1. LAYER MODEL (substrate vs implementation).

Compliant — the brief treats the evaluator as an implementation-side consumer and keeps proof production/substrate authority out of scope: “proof producer, evidence lattice, cluster coverage, and per-call evidence broadening remain Substrate-owned” (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:45-46), with explicit hard bars against widening LoopBound or changing substrate carriers (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:72-79).

  1. INVARIANTS.md + modeling-discipline.md.

Compliant — single-authority and facts-flow-forward are handled by requiring the evaluator to call the substrate-owned proof query rather than infer proof facts locally (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:52-53), and fail-closed behavior is preserved for missing/unknown/incomplete/non-strict evidence (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:58-61). The brief also explicitly forbids fabricating execution semantics from proof existence alone (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:64-66).

  1. CODING.md.

N/A — this diff adds no Rust implementation, APIs, helpers, methods, error types, or module structure to assess against coding conventions.

  1. TESTING.md.

Compliant — no tests are required in this PR because it is a worker brief only, but the brief correctly requires the future implementation PR to include focused evaluator tests for certified execution, fail-closed residuals, replacement scope, stack restoration, and no local proof-inference path (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:84-101).

  1. LOCKED DESIGN DECISIONS.

N/A — the diff does not alter a locked design surface; it references current substrate/evaluator state as authority and explicitly stops future work from changing parser, lowerer, substrate carriers, runner behavior, or LoopBound shape in this consumer slice (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:72-80).

  1. TRACKED vs UNTRACKED DEBT.

Compliant — the pre-authored brief is a tracked scaffold: it documents its status and dispatch gate (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:3-21), bounds the allowed work through hard bars and non-goals (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:68-82, docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:103-110), and names the update trigger if the substrate authority lands under a different name (docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md:112-118).

3. Verdict

APPROVE. The PR is a clean documentation/brief addition that preserves substrate authority, fail-closed evaluator behavior, and a bounded future implementation contract. I do not see a diff-line-supported finding against the changed file.

@briansrls briansrls left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Review metadata

  • Provider / model: codex / unknown
  • Commit: ba32bd1b · Trigger: schedule
  • Thinking: 106s wall

BLOCKING (1)

Root Cause

  • docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md stale authority names from an earlier R3/E5 plan were copied into the new brief → replace them with the live authority chain before this worker brief lands.

Non-blocking — Strengths

  • docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md The implementation bars correctly keep the evaluator as a proof consumer and preserve fail-closed descent residual behavior instead of adding local termination inference.

⚠️ One blocking source-authority issue needs correction before this brief can safely guide implementation.


## Source Authority

- [`r3-pr-e5-loopbound-descent-stop-packet.md`](r3-pr-e5-loopbound-descent-stop-packet.md)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

BLOCKING: The Source Authority section names missing docs (r3-pr-e5-loopbound-descent-stop-packet.md and ../r3-program-plan.md), so the worker would dispatch from unverifiable authorities rather than live R3 evaluator/readiness docs (INVARIANTS P1).

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: codex / codex-default
  • Commit: 9fcbfe0e · Trigger: schedule
  • Comparison: origin/main @ 21773f15 ... review/pr-1854-9fcbfe0e @ 9fcbfe0e
  • Thinking: 24s wall

Verdict: APPROVE

Diff is a single new worker brief in docs/briefs/r3-pr-e2-descent-proof-consumer-worker.md. It stays within documentation scope, preserves fail-closed/single-authority language, and I don’t see a concrete violation of the pinned INVARIANTS.md, docs/modeling-discipline.md, CODING.md, or TESTING.md lenses in the changed lines.

@briansrls

Copy link
Copy Markdown
Contributor Author

Addressed in current head 0e2b67b.

I verified the live authorities exist and updated the section from generic/stale naming to the current chain:

  • r3-pr-e5-loopbound-descent-stop-packet.md as the active E5 STOP receipt;
  • r3-pr-e5-loop-readiness-audit.md for cardinality-live / Descent-held state;
  • docs/r3-program-plan.md EVAL-2 + Q-EVAL-Descent-Termination-Contract for the descent_execution_proof(&Dag, ClusterId, PortId) -> Result<DescentExecutionProof, DescentResidual> resume contract and residual taxonomy.

The PR is now waiting only on the refreshed v3 check.

— sent from merry-gull-128

@briansrls
briansrls merged commit 3d0b28e into main May 6, 2026
4 checks passed
@briansrls
briansrls deleted the docs/e2-descent-proof-consumer-brief branch May 6, 2026 19:17
briansrls added a commit that referenced this pull request May 7, 2026
Consume the substrate descent_execution_proof carrier at LoopBound::Descent evaluation, threading the DescentExecutionProof through obligation discharge and preserving fail-closed LoopBoundDescentResidual mapping for gamma residuals.

Adds co-located evaluator tests for strict per-path proof success plus EvidenceIncomplete, EvidenceUnknown(NonIncreasing), and EvidenceUnknown(DescentUnknown) fail-closed cases.

Cross-cites: #2147 carrier introduction, #1799 prior STOP packet, #1854 consumer brief.
briansrls added a commit that referenced this pull request May 7, 2026
Consume the substrate descent_execution_proof carrier at LoopBound::Descent evaluation, threading the DescentExecutionProof through obligation discharge and preserving fail-closed LoopBoundDescentResidual mapping for gamma residuals.

Adds co-located evaluator tests for strict per-path proof success plus EvidenceIncomplete, EvidenceUnknown(NonIncreasing), and EvidenceUnknown(DescentUnknown) fail-closed cases.

Cross-cites: #2147 carrier introduction, #1799 prior STOP packet, #1854 consumer brief.
briansrls added a commit that referenced this pull request May 7, 2026
Consume the substrate descent_execution_proof carrier at LoopBound::Descent evaluation, threading the DescentExecutionProof through obligation discharge and preserving fail-closed LoopBoundDescentResidual mapping for gamma residuals.

Adds co-located evaluator tests for strict per-path proof success plus EvidenceIncomplete, EvidenceUnknown(NonIncreasing), and EvidenceUnknown(DescentUnknown) fail-closed cases.

Cross-cites: #2147 carrier introduction, #1799 prior STOP packet, #1854 consumer brief.
briansrls added a commit that referenced this pull request May 8, 2026
…scent_execution_proof) (#2190)

* Evaluator E2 descent proof consumer

Consume the substrate descent_execution_proof carrier at LoopBound::Descent evaluation, threading the DescentExecutionProof through obligation discharge and preserving fail-closed LoopBoundDescentResidual mapping for gamma residuals.

Adds co-located evaluator tests for strict per-path proof success plus EvidenceIncomplete, EvidenceUnknown(NonIncreasing), and EvidenceUnknown(DescentUnknown) fail-closed cases.

Cross-cites: #2147 carrier introduction, #1799 prior STOP packet, #1854 consumer brief.

* WIP: Evaluator E2 Descent termination contract consumer (post-Substrate desce

* Clarify descent proof hook live behavior
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