Skip to content

feat: add schema-2 campaigns and FODB benchmark evidence - #40

Merged
ternaus merged 18 commits into
mainfrom
codex/schema2-greenfield
Aug 11, 2026
Merged

feat: add schema-2 campaigns and FODB benchmark evidence#40
ternaus merged 18 commits into
mainfrom
codex/schema2-greenfield

Conversation

@ternaus

@ternaus ternaus commented Aug 11, 2026

Copy link
Copy Markdown
Owner

Scope

This draft contains the full 18-commit schema2-greenfield series against main, plus the final publication cleanup.

  • replace the historical runner with schema-2 packages, plans, immutable bundles, canonical publication, and remote resume
  • add FODB native/mixed packaging, fixed follow-up plans, environment freezing, GCP lifecycle support, and corresponding tests
  • publish the FODB evidence layer with worker scaling, protocol decisions, and a narrow compatibility audit
  • remove the obsolete cross-cell recommendation, minimax, and Pillow-migration outputs
  • align the README, experiment design, and claim guidance with the fixed-eight-worker preprint; update the citation title and authors

Validation

  • .venv/bin/pytest -q — 160 passed
  • Ruff and formatting on changed Python files
  • mypy on imread_benchmark
  • pre-commit on all changed files

The arXiv source archive was prepared and compiled separately from a clean extracted tree; it is intentionally local and ignored by the repository.

ternaus added 18 commits July 30, 2026 08:13
Introduce immutable dataset packages, deterministic experiment plans, support audits, isolated run bundles, resumable GCP execution, and canonical publication artifacts. Add FODB and controlled resolution-quality workloads, RAM preflight, frozen environments, and provenance validation. Remove historical runners, result matrices, plotting tools, and generated benchmark figures.
Close the file descriptor returned by tempfile.mkstemp before invoking gcloud. Long resume campaigns otherwise exhaust the VM open-file limit while restoring committed bundles.
Raise the bootstrap descriptor limit and prefer the GCloud CLI inside the mounted Snap. This avoids transient DBus scope failures during high-churn GCS checkpoint restore.
Record execution zone as provenance while comparing matching machine and CPU identities across capacity retries. Legacy zone-bound bundles remain valid and publication output retains their exact zones and platform IDs.
Allow committed GCS artifact layouts to be rebuilt locally and validated without rerunning a benchmark.
Filter the exact 3,000-run benchmark matrix, enforce claim-specific protocols, and generate auditable workload, decision, worker-transfer, coverage, version, and figure assets.\n\nAdd focused tests for common-support accounting, provenance, and deterministic ranking helpers.
Shortlist decoders within 10% of local loader leaders before applying the targeted 277-file robustness audit. Generate the practical recommendation table, coverage receipt, and full platform-workload decision surface.
Report malformed empty-DHT recovery separately from four-component normalized-RGB handling while retaining the combined recommendation gate.
Extend only cells whose initial worker sweep peaked at eight. Test workers=12 first and reserve workers=16 for a second boundary-selected stage.
Merge the frozen workers=12 cells with the original FODB matrix, treat location as provenance, and emit the boundary-selected candidates for a possible workers=16 stage.
Generate audited decoder and worker recommendations per platform-workload cell, report staged worker peaks, and derive workload bundle coverage from the validated evidence.
Keep speed evidence, worker curves, and the narrow compatibility audit while dropping the obsolete recommendation and Pillow-migration outputs.

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Sorry, we are unable to review this pull request

The GitHub API does not allow us to fetch diffs exceeding 20000 lines

@ternaus ternaus changed the title refactor(fodb): remove recommendation artifacts feat: add schema-2 campaigns and FODB benchmark evidence Aug 11, 2026
@ternaus
ternaus marked this pull request as ready for review August 11, 2026 10:36

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Sorry, we are unable to review this pull request

The GitHub API does not allow us to fetch diffs exceeding 20000 lines

@ternaus
ternaus merged commit eb3b2e9 into main Aug 11, 2026
7 checks passed
@ternaus
ternaus deleted the codex/schema2-greenfield branch August 11, 2026 10:36

@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: 47ca8102f5

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

def run_worker(run_spec_path: str | Path, artifact_root: str | Path) -> Path:
spec = load_run_spec(run_spec_path)
configuration = spec.identity.configuration
environment, platform_descriptor = _load_provenance(spec)

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 Verify the worker interpreter against its descriptor

When --worker-python points to a different environment than --environment-descriptor—including when the CLI default is accidentally retained—this only validates the supplied descriptor against the run identity; decoding still uses packages from the current interpreter, and the bundle persists the supplied descriptor unchanged. The resulting valid, publishable bundle can therefore claim package versions and native backends that were not used. Before measuring, compare the running interpreter and installed distributions with the descriptor, or obtain the interpreter directly from the provisioned environment.

Useful? React with 👍 / 👎.


def _load_selected_items(spec: RunSpec) -> tuple[ResidentItem, ...]:
configuration = spec.identity.configuration
package = open_dataset_package(spec.package_descriptor)

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 Reuse the materialization verification marker in run workers

For a package produced by dataset materialize, every isolated benchmark run opens it without trust_ready=True, so open_dataset_package rehashes and audits the entire archive and read_workload_items rehashes every selected blob. With the documented FODB limit of up to 2 GiB and hundreds of run specs, this adds repeated terabytes of unnecessary I/O and counts against each worker timeout, despite materialization having already written .READY.json and per-workload verification markers. Use the verified-marker path here as the support-audit worker already does.

Useful? React with 👍 / 👎.

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