in reviewhumanPR #344Transport
SharpeShooter: add bounded research workflow and duplicate-delivery test
This adds a focused external-provider integration in which Nanda Town requests a bounded structured research task rather than using a generic quote trigger.
Author
@sidsanghvi
github profile →- Status
- In review
- Opened on
- Nov 11
- Branch
- codex/hw8-sharpeshooter-research
Description
The pitch.
## Summary This adds a focused external-provider integration in which Nanda Town requests a bounded structured research task rather than using a generic quote trigger. Town sends a versioned idea and two prespecified strategy candidates through Track's existing HTTP mailbox; an external adapter invokes a separately pinned SharpeShooter release and returns a correlated reviewed result. Task content cannot grant approval, choose identities or the reviewer, confirm OOS work, set budget, control runtime or datasets, provide review content, or dictate the verdict. SharpeShooter is not vendored and is not a Nanda Town dependency. ## Integration - Adds static `sharpeshooter-research-clean` and `sharpeshooter-research-duplicate-delivery` profiles, strict `research_request` / `research_result` records, a closed research contract selector, a bundled requester, and a separately versioned evaluator. - Makes fault targeting, completion checks, bundle replay, and report rendering research-aware while preserving the buyer/seller lifecycle and historical quote evaluator `0.5.0`. - Adds an external adapter with fixed argv, a narrow environment, bounded I/O, process-group cleanup, strict result validation, and a durable fail-closed journal. - Adds deterministic healthy, duplicate-delivery, correlation, subprocess, journal, redaction, and historical-compatibility coverage; updates one generated schema, packaged research skills, README, and the [reproduction guide](https://github.com/sidsanghvi/nandatown/blob/codex/hw8-sharpeshooter-research/docs/sharpeshooter-research.md). ```text Town requester -> Track mailbox / lease / duplicate fault -> external adapter + durable journal -> pinned sharpeshooter-task CLI -> Scout -> operator policy -> Builder IS/OOS -> independent Skeptic -> reviewed result -> Town requester checks -> evaluator -> verified bundle ``` Duplicate delivery is replay-only: one Town logical request launches one workflow. A matching completed journal replays the identical response; a matching `started` state, changed content under the same identity, malformed state, or unsafe path fails closed without relaunching. ## Reproduce The public pinned consumer path—including software-release hashes, installed-wheel validation, healthy and duplicate fixture runs, explicit `nandatown verify` / `nandatown replay`, and read-only evidence downloads/hash verification—is in the [SharpeShooter research Track guide](https://github.com/sidsanghvi/nandatown/blob/codex/hw8-sharpeshooter-research/docs/sharpeshooter-research.md). Inputs are frozen at Nanda implementation head `195b60bbf3b3a166ba76e349ddff9fc34f537ab9` and SharpeShooter implementation head `2af22d9e02752cdbf2f44d40ad0cab42e55e00cc`. Package versions are Nanda Town `0.2.0` and SharpeShooter `0.1.0`. The exact SharpeShooter software input is the immutable [release `hw8-ingress-42ff7b384e92`](https://github.com/sidsanghvi/sharpeshooter-hw8-reproduction/releases/tag/hw8-ingress-42ff7b384e92). The four sanitized summaries are in the immutable [evidence release `hw8-evidence-2936191`](https://github.com/sidsanghvi/sharpeshooter-hw8-reproduction/releases/tag/hw8-evidence-2936191); they are not raw runtime artifacts. ```bash python -m pytest -q \ tests/test_sharpeshooter_adapter.py \ tests/test_sharpeshooter_research_flow.py \ tests/test_evaluator_replay_rules.py \ tests/test_schema_sync.py \ tests/test_historical_replay_docs.py nandatown schemas --out schemas python -m pytest -q tests/test_schema_sync.py git diff --exit-code -- schemas python -m build python scripts/check_distributions.py dist git diff --check ``` The [adapter tests](https://github.com/sidsanghvi/nandatown/blob/codex/hw8-sharpeshooter-research/tests/test_sharpeshooter_adapter.py) and [research flow tests](https://github.com/sidsanghvi/nandatown/blob/codex/hw8-sharpeshooter-research/tests/test_sharpeshooter_research_flow.py) cover the fast deterministic path and relevant failure boundaries. ## Resu …
Try it
Open PR on GitHubView diffCheckout locally
git fetch origin pull/344/head:pr-344
git checkout pr-344