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

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 diff

Checkout locally

git fetch origin pull/344/head:pr-344
git checkout pr-344