coord: add Podcaster handoff submission checklist (#363)
Operator-approved; all review threads resolved. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Juan Manuel Servera committed
Jun 10, 2026 at 21:55 UTC
6e6a3f2abf3b3fc4a077043e8ef29d685eed4c97
2 files changed
+7
-7
.squad/decisions/inbox/coord-submission-checklist-2026-06-10T10-27-49Z.md
+6
-6
@@ -1,14 +1,14 @@
1
### 2026-06-10T10:27:49.647+00:00: Tick / Checklist
2
**By:** squadscope (automated)
3
**What:**
4
-- Verify Podcaster HTTP API contract (request fields, response schema: job_id, status, errors)
5
-- Confirm authentication header name and allowed secret storage (PODCASTER_API_KEY usage)
4
+- Confirm and document the Podcaster HTTP API contract (request fields plus the response schema, e.g. the proposed Podcaster-side `job_id`, `status`, and `errors` fields) once Podcaster attaches it
5
+- Confirm the authentication header name and the canonical secret name used to store the Podcaster API key (Podcaster-side proposal: `PODCASTER_API_KEY`)
6
- Document accepted status values and retry semantics for non-2xx responses
7
-- Normalize publish manifest field names (freshness_status vs freshness, artifact_url vs url)
7
+- Confirm and document the canonical publish manifest field names (e.g. reconcile freshness status and artifact URL fields; proposed Podcaster-side names `freshness_status` vs `freshness`, `artifact_url` vs `url`)
8
- Provide example request/response JSON and canonical endpoint URL(s)
9
-- Confirm dry_run semantics and non-blocking handoff behavior
9
+- Confirm dry-run semantics and non-blocking handoff behavior
10
11
**Next steps:**
12
-1. Author or attach a concise API contract doc (podcaster-api.md) with request/response schemas and examples.
13
-2. Update pipeline docs to reference the API contract and required Actions secret names (PODCASTER_ENDPOINT, PODCASTER_API_KEY).
12
+1. Author or attach a concise API contract doc (e.g. `docs/integration-contract.md`) with request/response schemas and examples; treat the field names above as Podcaster-side proposals until the contract is attached.
13
+2. Update pipeline docs to reference the API contract and confirm/document the canonical Actions secret names (Podcaster-side proposal: `PODCASTER_ENDPOINT`, `PODCASTER_API_KEY`).
14
3. Add integration smoke test instructions and an operator checklist for manual runs.
.squad/decisions/inbox/tick-2026-06-10T10-27-49Z-initial.md
+1
-1
@@ -4,7 +4,7 @@
4
- Listed open PRs and inspected PR #314
5
- Ran full test suite on main (696 passed)
6
- Checked out PR #314 and ran its tests (9 passed)
7
-- Created podcaster submission checklist and opened PR #363
7
+- Created Podcaster submission checklist and opened PR #363
8
- Verified ralph loop activity via ralph_squadscope.log
9
10
**Next steps:**