Skip to content

Establish Ricci evidence contract spine, artifact schema, validator and CI gates#855

Merged
neuron7xLab merged 1 commit into
mainfrom
codex/address-go.work.sum-conflicts
Jun 2, 2026
Merged

Establish Ricci evidence contract spine, artifact schema, validator and CI gates#855
neuron7xLab merged 1 commit into
mainfrom
codex/address-go.work.sum-conflicts

Conversation

@neuron7xLab
Copy link
Copy Markdown
Owner

@neuron7xLab neuron7xLab commented May 31, 2026

Motivation

  • Formalize a verification-first evidence spine for the active research line ricci_microstructure_v1 so artifacts, falsifiers, promotion rules, and claim tiers are explicit and reviewable.
  • Prevent speculative or marketing language from being used as implicit claims.
  • Keep this PR scoped to the Ricci evidence spine only; workflow hardening and Rust accelerator gating are intentionally deferred to follow-up PRs.

Description

  • Rewrite top-level README.md into a strict Claim Contract.
  • Add FORBIDDEN_CLAIMS.md to ban forbidden status language and prescribe safe claim wording.
  • Add research_lines/ricci_microstructure_v1/contract.yaml for the sprint-focused evidence contract and required falsifiers/invariants.
  • Introduce a canonical artifact JSON Schema at schemas/research/ricci_microstructure_artifact.schema.json.
  • Add an example artifact under artifacts/runs/ricci_microstructure_v1/example_artifact.json.
  • Add tools/research/validate_ricci_artifact_schema.py and tests in tests/research_lines/test_ricci_artifact_schema.py.
  • Harden REPRODUCIBILITY_CAPSULE/COMMANDS.sh by removing fail-open masking.
  • Add a diff-bound commit acceptor for this evidence spine.

Testing

  • PR Gate: success, including repo-policy, secrets-supply-chain, python-quality, python-fast-shard (1..4), python-fast-tests, and python-heavy-tests.
  • Commit Acceptor Gate: success.
  • Readiness Gate: success.
  • Physics Invariants / Physics Kernel / Reality / UX / Latency / Schemathesis / L2 / Edge-Case gates: success.

Boundary

This PR does not promote the research line to deployable, validated alpha, or production status. It establishes a bounded artifact-first evidence spine.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

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: 5ba0d41462

ℹ️ 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".

run: python -m pip install --no-cache-dir jsonschema==4.25.1

- name: Validate canonical Ricci artifact
run: python tools/research/validate_ricci_artifact_schema.py
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Validate every changed Ricci artifact in CI

The workflow triggers on any change under artifacts/runs/ricci_microstructure_v1/**, but this command is invoked without --artifact, so the validator only checks DEFAULT_ARTIFACT (example_artifact.json) and ignores the actual files that caused the workflow to run. I verified that adding an invalid artifacts/runs/ricci_microstructure_v1/bad.json still exits 0 here, which means a PR can merge malformed evidence artifacts despite the README saying the schema gate is the repository-level enforcement point for inference artifacts.

Useful? React with 👍 / 👎.

"score": {"type": "number", "minimum": -1.0, "maximum": 1.0},
"uncertainty": {"type": "number", "minimum": 0.0},
"decision": {"type": "string", "enum": ["NO_TRADE", "OBSERVE", "REJECT"]},
"claim_tier": {"type": "string", "enum": ["HYPOTHESIS", "INSTRUMENTED", "MEASURED_SINGLE", "MEASURED_MULTI", "LIMITED_EMPIRICAL", "REJECTED", "BLOCKED_COST_MODEL"]},
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Block dirty artifacts from measured tiers

The schema currently accepts claim_tier: "MEASURED_SINGLE" or "MEASURED_MULTI" regardless of git_dirty, so an artifact from a dirty worktree can still pass validation as measured evidence. That contradicts the new promotion invariant in FORBIDDEN_CLAIMS.md that dirty git state must be disclosed but cannot support a signoff tier, and it lets the new CI validator promote exactly the class of artifacts the contract says to block.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Verification checkpoint for PR #855.

Status: NOT MERGE-READY.

Validated green on head 2fe962466610cda27a62c1942c9fbb37e733f84c:

  • Ricci Artifact Schema Gate: success
  • Rust Accel Gate: success
  • Commit Acceptor Gate: success
  • Physics Kernel Gate: success
  • Readiness Gate: success
  • Physics Invariants: success
  • Invariant Count Sync: success
  • Reality Validators Gate: success
  • Physics-2026 Gate: success
  • PR Gate heavy lane: python-heavy-tests / Run heavy invariant gate: success

Only remaining blocker:

  • PR Gate / secrets-supply-chain / Detect-secrets using baseline: failure

Likely cause: checksum/lockfile entropy from go.work.sum being scanned as secret-like material. This is not a valid reason to bypass the security gate, but it is a valid reason to harden the gate policy.

Required fix before merge:

--exclude-files '^(INVENTORY\.json|\.github/detect-secrets\.baseline|go\.work\.sum|figures/disha_ba_correlation/repro_capsule/.*)$'

Apply this in .github/workflows/pr-gate.yml under the Detect-secrets using baseline step, then rerun failed PR Gate jobs. Merge only after the same head or updated head is fully green.

No merge while security gate is red. That is the contract, not decoration.

@neuron7xLab neuron7xLab enabled auto-merge (squash) June 1, 2026 14:07
Rebuild PR #855 as a bounded evidence-contract slice on top of current main.

Preserves the Ricci claim firewall, canonical artifact schema, validator, tests, reproducibility hardening, and diff-bound commit acceptor without promoting deployable or production status.
@neuron7xLab neuron7xLab force-pushed the codex/address-go.work.sum-conflicts branch from 280018b to bb1cf96 Compare June 2, 2026 03:23
@neuron7xLab neuron7xLab merged commit 9968872 into main Jun 2, 2026
39 checks passed
@neuron7xLab neuron7xLab deleted the codex/address-go.work.sum-conflicts branch June 2, 2026 05:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant