SubagentStart endpoint + hook: dispatch record and handoff intake #428

New issue

Closed

opened 2026-08-18 18:31:37 +00:00 by jared · 1 comment

jared commented

2026-08-18 18:31:37 +00:00

Owner

#428 SubagentStart endpoint + hook: dispatch record and handoff intake

(open)

@jared created 2026-08-18 14:31

Parent

#425
Map: #425

What to build

A SubagentStart hook registered in the plugin hooks manifest with matcher
^os-sdlc:.*$ that posts agent identity (agent_id, agent_type, session_id) to
a new runner Thor command, which inserts a dispatch row against the
session's current implementation and returns the pending handoff for that
agent type; the hook relays it as additionalContext so the agent starts with
its intake. Handoffs are noun-only rows; direction lives on the dispatch
FKs. The per-state brief content-selection logic renders from handoff rows
instead of brief files. Hook stays webhook-thin: parse event, call endpoint,
relay output — no state logic. Run bin/refresh-plugins after plugin-source
edits.

Acceptance criteria

[ ] CLI-seam tests cover dispatch-row creation, handoff fetch by agent type,
and the no-current-implementation loud failure
[ ] a synthetic SubagentStart payload piped through the hook produces the
additionalContext output
[ ] non-os-sdlc agent types never match

Blocked by

#427

Origin

• Trigger: /to-tickets skill on #425 spec
• Improvised this session: none
• Chain: #425 (DESIGN — spec of #425) ← decomposed via /to-tickets user
approval 2026-08-18
• Root candidate: none (this is a decomposition task)

# #428 SubagentStart endpoint + hook: dispatch record and handoff intake (open) @jared created 2026-08-18 14:31 ## Parent #425 Map: #425 ## What to build A SubagentStart hook registered in the plugin hooks manifest with matcher ^os-sdlc:.*$ that posts agent identity (agent_id, agent_type, session_id) to a new runner Thor command, which inserts a dispatch row against the session's current implementation and returns the pending handoff for that agent type; the hook relays it as additionalContext so the agent starts with its intake. Handoffs are noun-only rows; direction lives on the dispatch FKs. The per-state brief content-selection logic renders from handoff rows instead of brief files. Hook stays webhook-thin: parse event, call endpoint, relay output — no state logic. Run bin/refresh-plugins after plugin-source edits. ## Acceptance criteria [ ] CLI-seam tests cover dispatch-row creation, handoff fetch by agent type, and the no-current-implementation loud failure [ ] a synthetic SubagentStart payload piped through the hook produces the additionalContext output [ ] non-os-sdlc agent types never match ## Blocked by #427 ## Origin • Trigger: /to-tickets skill on #425 spec • Improvised this session: none • Chain: #425 (DESIGN — spec of #425) ← decomposed via /to-tickets user approval 2026-08-18 • Root candidate: none (this is a decomposition task)

jared added the

plugin/os-sdlc

labels

2026-08-18 18:31:37 +00:00

jared referenced this issue

2026-08-18 18:31:43 +00:00

SubagentStop endpoint + hook: completion intake, post-agent steps, advancement #429

jared added the

ready-for-agent

label

2026-08-18 18:32:13 +00:00

jared referenced this issue

2026-08-18 18:44:58 +00:00

Assemble and close map #425: final cleanup sweep and verification #433

jared commented

2026-08-18 21:17:17 +00:00

Author

Owner

Resolution

Done: New runner Thor command subagent-start SESSION_ID AGENT_TYPE: requires an active implementation for the session (loud failure, exit 3, otherwise), inserts a round dispatch (implementation_id FK, dispatched_at stamped, received_handoff_id when a pending handoff exists) and returns the pending handoff by agent type as JSON. Handoffs are noun-only rows (agent_type, content); direction lives on dispatch FKs. SubagentStart hook registered in hooks.json with matcher ^os-sdlc:.*$ — webhook-thin: parse event, call endpoint, relay stdout as additionalContext (ADR-0128). Round-based intake serves content from handoff rows, not brief files; ticket-driven brief staging untouched. bin/refresh-plugins run.

Evidence: commit ea8cdfc; full runner suite 298 runs/631 assertions 0 failures; rubocop clean on all touched files; hook tested by piping synthetic SubagentStart JSON (additionalContext asserted) and matcher tested for non-os-sdlc agent types

Follow-ups: captured within map #425: handoff creation path and dispatch completion stamping are the next chain tickets (#429+); handoff consumed/delivered tracking deliberately deferred — no acceptance criterion requires it, revisit only if a later ticket surfaces double-delivery

## Resolution **Done:** New runner Thor command subagent-start SESSION_ID AGENT_TYPE: requires an active implementation for the session (loud failure, exit 3, otherwise), inserts a round dispatch (implementation_id FK, dispatched_at stamped, received_handoff_id when a pending handoff exists) and returns the pending handoff by agent type as JSON. Handoffs are noun-only rows (agent_type, content); direction lives on dispatch FKs. SubagentStart hook registered in hooks.json with matcher ^os-sdlc:.*$ — webhook-thin: parse event, call endpoint, relay stdout as additionalContext (ADR-0128). Round-based intake serves content from handoff rows, not brief files; ticket-driven brief staging untouched. bin/refresh-plugins run. **Evidence:** commit ea8cdfc; full runner suite 298 runs/631 assertions 0 failures; rubocop clean on all touched files; hook tested by piping synthetic SubagentStart JSON (additionalContext asserted) and matcher tested for non-os-sdlc agent types **Follow-ups:** captured within map #425: handoff creation path and dispatch completion stamping are the next chain tickets (#429+); handoff consumed/delivered tracking deliberately deferred — no acceptance criterion requires it, revisit only if a later ticket surfaces double-delivery

jared closed this issue

2026-08-18 21:17:18 +00:00

jared referenced this issue

2026-08-18 21:17:19 +00:00

Escape-hatch investigation skill for pipeline state divergence #432

jared referenced this issue

2026-08-18 21:50:59 +00:00

Redesign os-sdlc pipeline advancement around SubagentStart/SubagentStop hooks #425

jared referenced this issue from a commit

2026-08-19 15:10:23 +00:00

feat(os-sdlc): SubagentStart endpoint + webhook-thin hook with handoff intake (#428)