[P2][TOOLING] Produce reproducible agent validation bundles

Open
#180 4 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@bozoslav is already working on this.

Since Nov 11, 2026.

Assessment

This issue has not been assessed yet.

Description

area: tooling help wanted priority: P2 type: testing

Problem and outcome

Give a reviewer one inspectable artifact connecting a proposed fix to build identity, reproducible steps and observed outcomes.

Verified starting point

crates/crabby_mcp/src/lib.rs already offers launch, read_logs, screenshot, run_ticks, watch and performance tools; src/control.rs records engine version and executable/cwd identity. There is no integrated evidence-bundle workflow in these sources.

Bounded scope

Build a thin client-side orchestration example/utility over existing tools. A versioned manifest records commit/build/features when supplied, scenario identity/seed, commands, assertion outcomes, logs, screenshots and hashes/paths of collected artifacts. Mark unavailable metrics and headless screenshots explicitly. Include a deliberate failure followed by a corrected successful run.

Acceptance criteria

  • One command creates a self-contained bundle for a small reference interaction.
  • Failed build, launch timeout and failed assertion produce useful bounded failure artifacts.
  • Secrets/control tokens are excluded and user paths can be redacted without destroying reproduction metadata.
  • Repeated run comparisons identify build/settings differences; visual evidence requires inspected images and does not assert universal pixel identity.

Prerequisites and coordination

Depends on #179. Rust-only implementation contributions are welcome; maintainer-owned guide/native interface follow-ups should be named and tracked when applicable. Preserve existing Rust, ABI, save and MCP contracts.

Non-goals

No new profiling subsystem: reuse existing reports and later #145/#153/#157 outputs. No automatic claim that screenshots prove correctness.

First contribution

Implement a thin orchestration example that records build identity, scenario result and logs; add optional screenshots/performance artifacts afterward.

Planning constraints

Preserve the integrated Game/Ctx API and existing Rust/C/C++/save/MCP compatibility. Internal modules are the default; justify any new crate, trait, dependency or indirection with a concrete use case and measured or testable benefit. No automatic full-subsystem replacement or mandatory plugin framework. This is planned work, not a claim of delivery or a release-date promise.

Implementation prerequisites

  • #179
Dominant language
Rust
Stars
4
Forks
0
Avg merge
45m
Merged PRs (30d)
199

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ponkoengine/ponko

All issues in ponkoengine/ponko

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.