kandev/docs/plans/task-create-launch-preview/task-01-resolve-launch-preview-data.md

id, title, status, wave, depends_on, plan, requirements, acceptance_criteria, system_design

id	title	status	wave	depends_on	plan	requirements	acceptance_criteria	system_design
01-resolve-launch-preview-data	Resolve launch preview data	done	1		plan.md	REQ-TASKS-TASK-CREATE-LAUNCH-PREVIEW-001 REQ-TASKS-TASK-CREATE-LAUNCH-PREVIEW-002	AC-TASKS-TASK-CREATE-LAUNCH-PREVIEW-001.2 AC-TASKS-TASK-CREATE-LAUNCH-PREVIEW-001.3 AC-TASKS-TASK-CREATE-LAUNCH-PREVIEW-001.4 AC-TASKS-TASK-CREATE-LAUNCH-PREVIEW-002.3 AC-TASKS-TASK-CREATE-LAUNCH-PREVIEW-002.4	../../specs/tasks/system-design/task-create-launch-preview.md

Task 01: Resolve Launch Preview Data

Summary

Create the shared launch-step and prompt-composition projection. Preserve prompt data when the dialog fetches steps for a different effective workflow, and keep the visible workflow's cached steps current through workflow-step events.

In scope

• Add pure action-sensitive launch destination and composed-preview helpers.
• Retain prompt in fetched task-create step data.
• Derive one launch-preview model for the effective workflow.
• Add unit tests for routing precedence, stale data, and prompt substitution.

Out of scope

• Rendered controls or localized copy.
• Backend routing or prompt changes.
• Browser E2E tests.

Acceptance

• The resolver matches the backend auto-start, configured-start, and positional fallback order.
• Fetched steps can contribute only when their workflow ID matches the effective workflow. A successful empty fetch is authoritative over the snapshot.
• Workflow-step create, update, and delete events keep loaded workflow snapshots current for the visible and non-visible workflows.
• Composition replaces only the first {{task_prompt}} and preserves all server-owned placeholders.

Verification

cd apps/web
pnpm test -- --run components/task-create-dialog-launch-preview.test.ts components/task-create-dialog-effects.test.ts components/task-create-dialog-prop-builders.test.ts
pnpm run typecheck

Files likely touched

• apps/web/components/task-create-dialog-launch-preview.ts
• apps/web/components/task-create-dialog-launch-preview.test.ts
• apps/web/components/task-create-dialog-types.ts
• apps/web/components/task-create-dialog-effects.ts
• apps/web/components/task-create-dialog-effects.test.ts
• apps/web/components/task-create-dialog-prop-builders.ts
• apps/web/components/task-create-dialog-prop-builders.test.ts
• apps/web/lib/ws/handlers/workflows.ts
• apps/web/lib/ws/handlers/workflows.test.ts

Dependencies

None.

Risks

• A copied routing rule can drift from ResolveAutoStartStep.
• Stale fetched steps can display another workflow's prompt without strict workflow filtering.

Parallelism

sequential

Inputs

• Requirement IDs and the launch-step projection section in the system design.
• workflow.Service.ResolveAutoStartStep and orchestrator.Service.buildWorkflowPromptWithTrustedContext.
• Existing task-create workflow default and fetch tests.

Results

• Added the pure launch-step resolver and prompt-composition helper with the backend's auto-start, configured-start, and positional fallback order.
• Preserved prompt and workflow identity in fetched task-create steps, then derived one effective-workflow launch-preview model in dialog prop assembly.
• Added unit coverage for routing precedence, stale workflow data, and server-owned prompt placeholders.
• cd apps/web && pnpm test -- --run components/task-create-dialog-launch-preview.test.ts components/task-create-dialog-effects.test.ts components/task-create-dialog-prop-builders.test.ts passed (40 tests).
• cd apps/web && pnpm run typecheck passed.
• Review fixup coverage passed: plan-mode routing, authoritative empty fetch, and workflow snapshot step-event synchronization. Disabled-tooltip focus coverage passed with the task-create component tests.