feat(api): GET retry parent from published tepp-retry-parent CLI

[seonghobae]

Why

GAP-003A / issue #166 still has no published CLI that GETs /parent from the typed naruon/LineageWeave retry-parent exchange onto spawned tepp-loopback TCP. ADR 0038 / #384 owns retry-parent GET. ADR 0044 / #396 owns consumer-parity exchanges. Operators still had to embed the library or invent HTTP. Retry CLI (#394) lives on a diverged stack that lacks retry-parent GET.

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
• 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 loopback CLI
• feat(api): enumerate analysis runs via loopback collection GET #368 collection GET
• feat(api): retry failed and cancelled analysis runs on loopback #369 retry HTTP
• feat(analysis): execute scientific acceptance on loopback lifecycle #370 loopback engine
• feat(api): enumerate analysis runs via loopback collection CLI #371 collection CLI
• feat(api): cancel analysis runs from LineageWeave and Naruon compatibility #373 cancel consumer-parity
• feat(analysis): serve scientific acceptance execute from tepp-loopback #375 execute loopback binary
• feat(api): inspect stored analysis-run create fields on loopback #377 stored-request GET
• feat(api): cancel analysis runs via loopback CLI #378 cancel CLI
• feat(api): inspect analysis-run retry children on loopback #379 retry children
• feat(api): resolve analysis-run identity by idempotency key on loopback #380 idempotency lookup
• feat(analysis): mint execute exchanges for naruon and LineageWeave #381 execute consumer exchange
• feat(analysis): send execute exchanges over tepp-loopback TCP #382 execute TCP
• feat(api): poll analysis-run status from LineageWeave on loopback #383 status consumer-parity
• feat(api): inspect analysis-run retry parent on loopback #384 retry parent GET
• feat(api): create analysis runs via loopback CLI #385 create CLI
• feat(analysis): bind two-group OLS invariance to an analysis-run profile #386 two-group OLS invariance profile
• feat(api): inspect stored analysis-run requests from LineageWeave and Naruon #387 stored-request consumer-parity
• feat(api): record analysis-run lifecycle from LineageWeave and Naruon compatibility #388 lifecycle consumer-parity
• feat(analysis): bind irregular event-time log-rate to an analysis-run profile #389 irregular event-time
• feat(analysis): POST execute from published tepp-execute CLI #390 execute CLI
• feat(api): enumerate analysis runs from LineageWeave and Naruon #391 collection consumer-parity
• feat(api): inspect analysis-run status via loopback CLI #392 status CLI
• feat(api): retry analysis runs from LineageWeave and Naruon compatibility #393 retry consumer-parity
• 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): inspect analysis-run retry parent from LineageWeave and Naruon #396 retry-parent consumer-parity (this PR stacks on that head 02eee9f07f58dd6dee5396c36cfcd0a0b228d199)
• feat(api): POST running and terminal from published tepp-lifecycle CLI #397 lifecycle CLI
• feat(api): inspect analysis-run retry children from LineageWeave and Naruon #399 retry-children consumer-parity
• feat(persistence): persist idempotent analysis runs #287 GAP-003B persistence/Compose
• feat(network): replace union-find stand-in with Leiden consensus #351 Leiden
• feat(longitudinal): consolidate lagged correlation and discreteDRIFTstd #310 discreteDRIFTstd

What

Unique GAP-003A retry-parent CLI slice stacked on #396 over protected main 1bc02f580cf48e1d39da239f0e818453437c31c3:

• published tepp-retry-parent parent mints naruon_analysis_run_retry_parent_exchange or lineageweave_analysis_run_retry_parent_exchange and renders through loopback_http1_from_retry_parent_exchange
• --origin stays the published HTTPS origin; only --host is the loopback bind address printed by tepp-loopback
• empty stdin is required; nonempty GET bodies fail closed
• success stdout is a metric-free 200 OK inspect ("parent": null when the run was never retried)
• public bind hosts, localhost, unpublished consumers, credential-shaped flags, metric keys, and http:// origins fail closed
• does not add GET to NaruonLiveService beyond the Naruon-only compatibility inspect already owned by ADR 0044; LineageWeave remains refused there
• ADR 0046

Not an ADR 0014 scientific claim. Not retry-parent GET. Not retry-parent consumer-parity. Not retry CLI. Not retry HTTP. Persistence remains GAP-003B.

Verification

• cargo clippy -p tepp_api --all-targets -- -D warnings
• cargo test -p tepp_api --test analysis_run_retry_parent_cli_contract
• cargo test -p tepp_api --lib
• cargo doc -p tepp_api --no-deps
• python3 scripts/validate_documentation.py
• python3 scripts/check_docstrings.py

Stacking

Base is feat/analysis-run-retry-parent-consumer-parity-gap-003a (#396). Merge #396 first or retarget onto main after #396 lands. No force-push.

[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]

Exact-head COMMENT on caceebb (draft). Unique occupied: tepp-retry-parent parent minting GET /v1/analysis-runs/{run_id}/parent (ADR 0046). Stdout is metric-free ("parent": null when never retried). tepp.scientific_acceptance.v1 never appears. Supports naruon and LineageWeave typed exchanges. Do not add GET to NaruonLiveService beyond the Naruon-only compatibility inspect already owned by ADR 0044. 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. No PII in LineageWeave.