google-deepmind / google-deepmind/formal-conjectures

Formal Conjectures: Review, Verification, and Preservation Loop

Open
#4,394 11 comments 0 reactions 0 assignees View on GitHub
Dominant language
Lean
Stars
1.3k
Forks
485
Avg merge
1d 20h
Merged PRs (30d)
327

Description

One `conjectures` toolkit for contribution review, exact-target proof verification and retained evidence. Contributors use their existing agents. FC owns deterministic operations; maintainers retain mathematical and merge decisions.

## Delivery map — 11 September 2026

**9 active FC infrastructure PRs: 3 foundations, 4 consolidated deliveries and 2 independent CI improvements.** Mathematical corrections and superseded prototypes are separate. No additional umbrella issue or replacement PR is needed.

| PR | Delivery | Required predecessors | Current disposition |
| --- | --- | --- | --- |
| #4899 | Review foundation and contracts | None | Open for review |
| #5375 | Shared metadata and one native `conjectures.json` | None | Open; final review follow-up CI passed, upstream deployment awaits acceptance |
| #5337 | Native proof-workspace exporter | Generator #7 | Draft; fork qualification passed, accepted repin pending |
| #5386 | CLI **and Actions preparation** | #4899, #5375 | Active draft; absorbs #5356 |
| #5387 | Exact proof workspaces and verification | #5386, #5337, Comparator #87 | Active draft |
| #5388 | Evidence publication **and problem-page display** | #5386 | Active draft; absorbs #5389 |
| #4828 | Status **and proof-link metadata consumers** | #5375 | Active draft; absorbs #4749 |
| #5468 | Targeted problem-only PR validation | Maintainer acceptance of PR/queue coverage split | Draft; hosted targeted path qualified |
| #5461 | Reuse queue-built websites, retain Lean/cache refresh | #5435 | Draft; real queue-to-main qualification remains |

```mermaid
flowchart LR
R["#4899 Review"] --> C["#5386 CLI + Actions"]
M["#5375 Metadata"] --> C
M --> S["#4828 Status + links"]
C --> E["#5388 Publish + display evidence"]
C --> P["#5387 Proof verification"]
G["Generator #7"] --> X["#5337 Exporter"] --> P
V["Comparator #87"] --> P
```

Review evidence can ship without proof verification. #5387 supplies proof records to #5388 when qualified. CI changes are a separate lane; their overlapping workflow changes must be reconciled as they land. #5435 and #5460 are merged. The cache prerequisite for #5461 is satisfied; its real queue-to-main acceptance remains outstanding.

## PR and branch policy

- **Open draft:** active implementation with dependencies or qualification remaining.
- **Open and ready for review:** focused diff, prerequisites available and relevant checks passed.
- **Closed:** merged, superseded, consolidated or abandoned. Closure is not a waiting room.

#5356 → #5386, #5389 → #5388 and #4749 → #4828 are now consolidated. Keep the three absorbed PRs closed and continue on the retained PRs. Their old branches/commits remain history; do not develop separate deliveries there.

Cross-fork drafts still target upstream `main`, so inherited prerequisite changes can appear in their diffs. PR bodies identify dependencies and available parent comparisons. After predecessors merge, replay only the delivery's own changes onto current upstream `main`, verify the commit list and diff, rerun affected checks, then request review on the same PR. Draft status does not waive those requirements.

Use `codex/fc-toolkit-integration` for combined testing. Focused fork branches are `codex/fc-toolkit-cli`, `codex/fc-toolkit-proof-cli`, `codex/fc-toolkit-evidence-cli` and `erdos-status-from-json`. No upstream merge or automation activation without maintainer acceptance.

## Acceptance ownership

| Tracker | Owns | Close only when |
| --- | --- | --- |
| #5152 / #5375 | Native metadata and catalog deployment | Shared-consumer semantics and publication are accepted |
| #5376 | Review, proof, publication and package acceptance | Both contribution journeys pass on the supported release revision |
| #5377 | Configured feeds, site applicability and reader handoff | A reader can identify the exact statement, evidence and next action |

#5388 implements publication and display together; the two acceptance issues are different user journeys, not requests for more PRs. Keep detailed qualification checklists in these trackers, not duplicated roadmap status appendices.

## Qualification — 11 September 2026

[RC3 qualification record](https://github.com/williamjblair/formal-conjectures/blob/e4dd405fc6803eb744922b3e527917e2cbd619d1/toolkit/qualification/rc3-final.md) retains exact revisions, runs and failures.

- Review preparation/completion, independent build, immutable publication, designated posting, cancellation/retry and historical inspection passed on the fork. No paid model calls.
- Fresh macOS initialization and Linux verification passed. Real controls distinguish accepted proofs, rejected submissions and unevaluated infrastructure failures. All ten exporter fixtures and 100/100 FC100 exports passed.
- William approved the five-case pilot packet qualitatively. Two original coverage gaps remain; no per-case scores or broad accuracy claim.
- Open Formal Workflows #2 is merged; its current deployment uses the shared reader. No replacement migration PR is needed.
- [RC3 is published](https://github.com/williamjblair/formal-conjectures/releases/tag/toolkit-v0.2.0rc3): clean macOS/Linux package and live fork browsing checks passed; published download commands, checksums, upgrade and uninstall passed. Final fork deployment, fresh desktop/mobile browser checks, CLI browsing and website-only snapshot reuse passed at `eee8f2ec`. The catalog and stylesheet match the qualified files byte-for-byte. Production default browsing and reader handoff still require upstream #5375/#5388 acceptance and deployment.

## Release gates

1. **Review:** clean install → exact PR/local snapshot → independent build and sources → existing-agent report → retained findings and coverage. William approved the retained five-case pilot packet qualitatively on 11 September; no per-case scores were supplied. Preserve its two coverage gaps and do not claim broad accuracy.
2. **Publication:** inspect → immutable archive → designated serialized publisher → receipt. Exercise competing/stale/cancelled requests and failures. A later head/base makes prior evidence historical.
3. **Proof:** macOS initialization → explicitly public committed workspace when using GitHub → qualified Linux verification → distinct success, rejection and infrastructure error. Retain exact tool/executor pins and sandbox controls.
4. **Reader handoff:** deployed catalog and configured feeds show statements, sources, evidence producer, applicability, maintainer status and next action.
5. **Release:** matching wheel/sdist/checksums, clean macOS/Linux installation, supported configurations and documentation all match the qualified commit. Upstream acceptance remains separate from fork delivery.

## Preserved decisions and history

The older #4884 account interpreted terminal axiom text as rejection. The [retained typed record](https://github.com/williamjblair/open-formal-workflows/blob/main/pilot/comparator-outcome.json) instead records an invocation error and unevaluated policy. Logs are diagnostics, not verification verdicts. Historical reports and failed model invocations remain preserved.

Mathematical corrections and proof-locator changes remain independent. #4951 is superseded by #5337; close it after the replacement lands. #5158 covers metadata/evidence design; #4930 covers downstream LeanEval intake and package policy; export success is not catalog admission. #4881's status interpretation belongs to #4828 and exact verification/evidence to #5387/#5388. #4876 covers guidance, #4825 queue maintenance and #4819 anonymous-declaration policy. Do not manufacture identities or reopen completed historical issues.

Runs are local by default; publication is explicit. No paid model calls are part of this qualification. Agents own authentication and model choice. Lean/Lake own dependency pins; the generator, Comparator, LeanEval and Palomar retain their roles. Autonomous proving/fixing, general MCP, daemons, new registries/services and Modal/Vela adapters remain deferred. Harbor export is an experimental follow-up on `codex/fc-toolkit-evals`, requiring a real qualified trial; it does not block the core CLI.

Contributor guide

Open the contributing guide

Research direction

There is no single file or test for this umbrella issue; start by reading toolkit/qualification/rc3-final.md and the retained PR bodies (#4899, #5375, #5386, #5387, #5388, #4828, #5468 and #5461), then use codex/fc-toolkit-integration for combined testing. Completion depends on predecessor replay, affected checks, maintainer acceptance and the release gates passing.

Written by the indexing model from the issue text.

Assessment

Tech stack
git, github-actions
Domain
ci-cd, release, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
10/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.