feat(api): wait for analysis-run terminal status via loopback CLI

[seonghobae]

Why

GAP-003A / issue #166 still required operators to write a poll loop after status GET. Operators cannot wait for succeeded or failed without guessing when to re-GET. Accepted/running/failed stdout stays metric-free. tepp.scientific_acceptance.v1 appears only on succeeded scientific_acceptance_v1.

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 (this PR is a client of that listener)
• 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 (this PR stacks on 38ec074d12dff758ef66ed73d828f6d8a557726e)
• 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 via loopback lookup CLI #401 lookup CLI
• feat(api): GET retry children from published tepp-retry-lineage CLI #403 retry-lineage CLI
• 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 wait CLI stacked on #392 over status consumer-parity #383 / GET-by-id #359 / protected main 1bc02f580cf48e1d39da239f0e818453437c31c3:

• tepp-analysis-runs wait polls GET /v1/analysis-runs/{run_id} until succeeded or failed
• --timeout-ms default 1000 (max 60000); 0 polls once and fails closed on accepted/running
• --poll-interval-ms default 10 (max 1000); interval longer than a nonzero timeout fails closed
• stdout reuses status CLI gates
• loopback-only; unpublished consumers, credential flags, nonempty stdin, and unknown verbs fail closed
• ADR 0030 on the GET-status lineage (distinct from scientific-acceptance CLI ADR 0030)

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_wait_cli
• cargo test -p tepp_api --test analysis_run_wait_cli_contract
• RUSTDOCFLAGS='-D warnings' cargo doc -p tepp_api --no-deps
• python3 scripts/validate_documentation.py
• python3 scripts/check_docstrings.py

Exact head: 04ea4c9431d23994c7649eae4ed69ba34a91bded

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-26 exact-head: 04ea4c9431d23994c7649eae4ed69ba34a91bded. GAP-003A wait CLI tepp-analysis-runs wait stacked on #392. Polls GET-by-id until succeeded/failed; timeout 0 fails closed on accepted/running. Metric-free accepted/running/failed; tepp.scientific_acceptance.v1 only on succeeded scientific_acceptance_v1. Devin/CodeRabbit/author COMMENTED is not independent APPROVE. Ruleset 18156473 needs two independent APPROVE reviews. No self-approve.