feat(api): resolve analysis-run identity via loopback lookup CLI

[seonghobae]

Why

GAP-003A / issue #166 still required operators to write raw HTTP/1.1 after idempotency-lookup GET. Operators cannot jump from a 202 receipt or retry child key to a durable run_id from a client without scanning collection pages. Stdout stays metric-free. tepp.scientific_acceptance.v1 never appears.

Live slices that this PR does not duplicate:

• feat(analysis): bind validation runs to scientific acceptance evidence #356 analysis_engine scientific-acceptance library
• feat(api): carry scientific acceptance only on terminal results #358 tepp_api terminal-wire DTO
• feat(api): serve scientific acceptance only on loopback status GET #359 GET loopback status by id
• feat(api): record scientific acceptance via loopback lifecycle POST #360 POST running/terminal lifecycle
• feat(api): cancel accepted and running analysis runs on loopback #361 cancel HTTP
• feat(api): drive scientific acceptance via loopback CLI #362 scientific-acceptance loopback CLI
• feat(api): enumerate analysis runs via loopback collection GET #368 collection GET
• feat(api): enumerate analysis runs via loopback collection CLI #371 collection CLI list
• feat(api): cancel analysis runs via loopback CLI #378 cancel CLI
• feat(api): create analysis runs via loopback CLI #385 create CLI
• feat(api): inspect analysis-run status via loopback CLI #392 status CLI
• feat(api): POST retry from published tepp-retry CLI #394 retry CLI
• feat(api): inspect stored analysis-run requests via loopback CLI #395 stored-request CLI
• feat(api): POST running and terminal from published tepp-lifecycle CLI #397 lifecycle CLI
• feat(api): GET retry parent from published tepp-retry-parent CLI #400 retry-parent CLI
• feat(api): resolve analysis-run identity by idempotency key on loopback #380 lookup GET (this PR is a client of that listener, stacked on ed21a10579d69faf4182ef6c07004fd622983a1e)
• feat(api): inspect stored analysis-run create fields on loopback #377 stored-request GET
• feat(api): retry failed and cancelled analysis runs on loopback #369 retry HTTP
• feat(persistence): persist idempotent analysis runs #287 GAP-003B persistence/Compose
• feat(network): replace union-find stand-in with Leiden consensus #351 Leiden

What

GAP-003A lookup CLI stacked on #380 / protected main 1bc02f580cf48e1d39da239f0e818453437c31c3:

• tepp-analysis-runs lookup client of GET /v1/analysis-runs/by-idempotency/{idempotency_key}
• key travels in the path; no idempotency-key header
• metric-free run_id/run_state/idempotency_key stdout
• tepp.scientific_acceptance.v1 never prints
• another consumer cannot resolve the first consumer's key
• empty stdin required; nonempty body fails closed
• loopback-only; unpublished consumers, credential flags, --run-id, collection pagination flags, and unknown verbs fail closed
• ADR 0038 on the lookup lineage (distinct from retry-parent GET ADR 0038 on another stack)

Not an ADR 0014 scientific claim. Not persistence.

Verification

• cargo clippy -p tepp_api --all-targets -- -D warnings
• cargo test -p tepp_api --lib analysis_run_idempotency_lookup_cli
• cargo test -p tepp_api --test analysis_run_idempotency_lookup_cli_contract
• RUSTDOCFLAGS='-D warnings' cargo doc -p tepp_api --no-deps
• python3 scripts/validate_documentation.py
• python3 scripts/check_docstrings.py

Exact head: a3410d42d82c09dd3eb7978a54e6c46513179695

Do not merge without two independent APPROVE reviews on this exact head and current Checks. Author COMMENTED is not independent APPROVE.

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[seonghobae]

Hour-25 exact-head: a3410d42d82c09dd3eb7978a54e6c46513179695. GAP-003A lookup CLI tepp-analysis-runs lookup stacked on #380. Metric-free run_id/run_state/idempotency_key; tepp.scientific_acceptance.v1 never appears. Devin/CodeRabbit/author COMMENTED is not independent APPROVE. Ruleset 18156473 needs two independent APPROVE reviews. No self-approve.

[seonghobae]

Exact-head COMMENT on a3410d4 (draft). Unique occupied: tepp-analysis-runs lookup for GET /v1/analysis-runs/by-idempotency/{idempotency_key} (ADR 0038) stacked on lookup HTTP #380 / ADR 0037. Dual-identity analysis-run lookup is occupied; do not duplicate. Metric-free identity resolution. tepp.scientific_acceptance.v1 never appears. Do not un-quarantine unscoped stored-request-by-client-key. Do not un-draft. Zero reviews on this SHA before this COMMENT. Never self-approve. Persistence remains GAP-003B. Do not weaken fail-closed. No Buyer language.