kandev/docs/plans/task-create-prompt-chips/task-02-create-integration.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
02-create-integration	Integrate task creation	done	2	01-reference-editor	plan.md	REQ-UI-PROMPT-ALIAS-002	AC-UI-PROMPT-ALIAS-002.1 AC-UI-PROMPT-ALIAS-002.2 AC-UI-PROMPT-ALIAS-002.3 AC-UI-PROMPT-ALIAS-002.4 AC-UI-PROMPT-ALIAS-002.5 AC-UI-PROMPT-ALIAS-002.6 AC-UI-PROMPT-ALIAS-002.7	../../specs/ui/system-design/prompt-alias-rendering.md

Task 02: Integrate task creation

Summary

Enable reference chips only for new tasks, including canvas presets. Preserve shared form services and prove the complete desktop and phone interactions.

In scope

• Explicit create-only mode through dialog/form props and the unchanged public form handle.
• Attachments, enhancement, voice/plugin insertion, drafts, launch preview, and retry.
• Desktop/phone E2E migration and public documentation for the changed creation interaction.

Out of scope

• Changes to New Agent or task-edit insertion behavior, backend expansion, or canvas launch defaults.

Acceptance

• General and canvas creation serialize aliases through the existing task payload.
• Desktop/phone tests prove UI-01 to UI-03, including interaction and measured geometry.
• Shared form tests and New Agent regressions pass with unchanged non-create semantics.

ASCII UI preview

Historical preview from the completed implementation. The compact-chip follow-up now proposes one enclosing border and revised sizing; it owns new geometry verification.

UI-01/02 excerpt from the full preview, criteria .1 through .7:

Desktop                         Phone
Goal [@prompt] [x]               Goal
[Attach] [Enhance]               [@prompt] [x]
Options                         [Attach] [Enhance]
[Cancel] [Start task]            ... scrolling form ...
                                [Cancel] [Start task]
                                Tap chip -> preview drawer

UI-03 keeps the same draft after creation failure. Missing prompts stay ordinary text. Measure drawer containment, internal scrolling, footer access, and touch hit areas. Capture and inspect screenshots against the full previews.

Verification

Run from the repository root, sequentially. The mobile chips spec is a new deliverable. Inventory task-description-input consumers before edits, and add exact commands for every additional changed test before marking this work order done.

(cd apps/web && pnpm exec vitest run components/task-create-dialog-selectors.test.tsx components/task-create-dialog-form-body.test.tsx components/task-create-dialog.test.tsx components/task/new-session-form-prompt.test.tsx components/canvas/canvas-task-create-launcher.test.tsx)
(cd apps/web && pnpm run typecheck)
(cd apps/web && pnpm run lint)
(cd apps/web && pnpm run i18n:check)
(cd apps/web && pnpm run i18n:ratchet)
make -C apps/backend build
make -C apps/backend e2e-plugin-package
(cd apps/web && pnpm run build:e2e)
(cd apps/web && pnpm e2e:raw --project=chromium --retries=0 tests/task/task-create-prompt-autocomplete.spec.ts tests/task/task-create-prompt-autocomplete-qa.spec.ts tests/canvas/plugin-canvas.spec.ts tests/session/new-session-dialog.spec.ts)
(cd apps/web && pnpm e2e:raw --project=mobile-chrome --retries=0 tests/task/mobile-task-create-prompt-chips.spec.ts tests/canvas/mobile-plugin-canvas.spec.ts tests/session/mobile-new-session-dialog.spec.ts)
node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs
python3 scripts/lint-spec-files.test.py
python3 scripts/lint-spec-files.py --all
git diff --check

Files likely touched

• apps/web/components/task-create-dialog.tsx, task-create-dialog-form-body.tsx, and prop types/builders.
• apps/web/components/task-create-dialog-selectors.tsx and its tests.
• apps/web/hooks/use-task-create-prompt-mention.ts or the create-only replacement adapter.
• apps/web/e2e/pages/kanban-page.ts and the named E2E specs.
• docs/public/developer-tools.md, docs/public/canvases.md.
• This package's results and companion-plan links, without replacing historical results.

Dependencies

Task 01. Run its tests again if integration changes its implementation.

Risks

The editor ref must expose synchronous text during plugin insert-then-submit. Preserve open-cycle draft identity and do not treat editor blur as dialog dismissal. Avoid contenteditable HTML comparisons as proof of persisted description text.

Parallelism

sequential

Inputs

• Requirement, requirement 002.
• Design.
• Shared form tests, canvas E2E, and mobile-prompt-mention-composer.spec.ts viewport helpers.

Results

Implemented create-only editor integration, preserved textarea behavior for session and edit flows, migrated affected description assertions, added public documentation, and added the phone prompt-chip workflow.

Verification on 2026-09-12:

• cd apps/web && pnpm exec vitest run components/task-create-dialog-selectors.test.tsx components/task-create-dialog-form-body.test.tsx components/task-create-dialog.test.tsx components/task/new-session-form-prompt.test.tsx components/canvas/canvas-task-create-launcher.test.tsx: 5 files and 57 tests passed.
• cd apps/web && pnpm run typecheck: passed.
• cd apps/web && pnpm run lint: passed with zero warnings.
• cd apps/web && pnpm run i18n:check: passed, with 7,994 referenced keys and all five catalogs complete.
• cd apps/web && pnpm run i18n:ratchet: passed; 1 added and 10 modified files clean, guard allowlist intact.
• make -C apps/backend build: passed.
• make -C apps/backend e2e-plugin-package: passed.
• cd apps/web && pnpm run build:e2e: passed.
• cd apps/web && pnpm e2e:raw --project=chromium --retries=0 tests/task/task-create-prompt-autocomplete.spec.ts tests/task/task-create-prompt-autocomplete-qa.spec.ts tests/canvas/plugin-canvas.spec.ts tests/session/new-session-dialog.spec.ts: 26 tests passed.
• cd apps/web && pnpm e2e:raw --project=mobile-chrome --retries=0 tests/task/mobile-task-create-prompt-chips.spec.ts tests/canvas/mobile-plugin-canvas.spec.ts tests/session/mobile-new-session-dialog.spec.ts: 7 tests passed.
• cd apps/web && pnpm e2e:raw --project=chromium --retries=0 tests/task/enhance-prompt.spec.ts tests/plugins/composer-actions.spec.ts: 12 tests passed.
• cd apps/web && pnpm e2e:raw --project=mobile-chrome --retries=0 tests/task/mobile-task-create-escape.spec.ts tests/plugins/mobile-composer-actions.spec.ts: 5 tests passed.
• cd apps/web && pnpm run e2e:sleep-ratchet: passed; no added sleeps.
• node --test scripts/validate-public-docs.test.mjs: 62 tests passed.
• node scripts/validate-public-docs.mjs: 46 published pages validated.
• python3 scripts/lint-spec-files.test.py: 36 tests passed.
• python3 scripts/lint-spec-files.py --all: passed.
• git diff --check: passed.