claw/docs/superpowers/plans/2026-04-19-g6-host-bridge-callback-semantics-plan.md

G6 Host-Bridge Callback Semantics Plan

Date: 2026-04-19 Status: Draft Upstream Spec: 2026-04-19-g6-host-bridge-callback-semantics-design.md

Plan Intent

This plan executes one bounded next slice:

G6 host-bridge callback semantics

Scope Guardrails

1. do not execute a G6 real sample
2. do not implement host-runtime directly
3. do not open G8
4. do not reopen G7
5. do not open G4 / G5

Workstreams

1. WS1 Freeze callback semantics scope
2. WS2 Define completion-state semantics
3. WS3 Publish one bounded callback-semantic result

Phase 0: Freeze the Boundary

Objective

Lock the plan to callback semantics only.

Tasks

1. freeze G6 as the only target
2. freeze transport/runtime implementation and real execution as out of scope

Acceptance Criteria

1. no broader host-runtime work begins under this plan

Phase 1: Define Completion-State Semantics

Objective

Turn callback completion into an explicit bounded semantic model.

Tasks

1. define ok
2. define partial
3. define blocked
4. define error

Acceptance Criteria

1. callback state logic is explicit and bounded

Phase 2: Publish the Bounded Result

Objective

Turn the callback-semantic model into one bounded next artifact.

Tasks

1. publish the semantic result
2. if needed, publish the next bounded follow-up plan

Acceptance Criteria

1. the next step remains narrower than direct host-runtime implementation