kandev/docs/plans/task-create-prompt-chips/task-02-create-integration.md

---
id: 02-create-integration
title: Integrate task creation
status: done
wave: 2
depends_on:
  - 01-reference-editor
plan: plan.md
requirements:
  - REQ-UI-PROMPT-ALIAS-002
acceptance_criteria:
  - 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
system_design:
  - ../../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](../compact-task-prompt-chips/plan.md) now proposes
one enclosing border and revised sizing; it owns new geometry verification.

UI-01/02 excerpt from the [full preview](plan.md#ascii-ui-preview), criteria `.1` through `.7`:

```text
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.

```bash
(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](../../specs/ui/requirements/prompt-alias-rendering.md), requirement 002.
- [Design](../../specs/ui/system-design/prompt-alias-rendering.md#task-creation-editor).
- 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.