Files
kandev/docs/plans/task-autopilot/task-01-persist-task-contract.md
T
2026-08-23 17:34:52 +00:00

73 lines
2.7 KiB
Markdown

---
id: "01-persist-task-contract"
title: "Persist the autopilot task contract"
status: done
wave: 1
depends_on: []
plan: "plan.md"
spec: "../../specs/tasks/requirements/autopilot-mode.md"
---
# Task 01: Persist the Autopilot Task Contract
## Acceptance
- Existing and newly created tasks round-trip a non-null `autopilot` boolean, with
omission and migrated rows resolving to false.
- HTTP and `create_task_kandev` creation accept the same optional field, do not
inherit it from a parent, and reject incompatible agent runtime profiles before
persistence.
- The MCP schema uses the exact short description: "Start this task in autopilot
mode. Default: false. The value is fixed at creation and is not inherited by
subtasks. The agent does not ask the user directly; it asks its direct parent only
for critical decisions." At runtime, a root autopilot task has no question
capability, while an autopilot child has only the direct-parent question tool.
- Update/edit APIs cannot mutate the property, and task read/list/boot payloads
expose it consistently to clients.
## Verification
```bash
cd apps/backend && go test ./internal/task/models ./internal/task/dto ./internal/task/repository/sqlite ./internal/task/handlers ./internal/mcp/server ./internal/mcp/handlers
```
## Files likely touched
- `apps/backend/internal/task/models/models.go`
- `apps/backend/internal/task/dto/dto.go`
- `apps/backend/internal/task/dto/requests.go`
- `apps/backend/internal/task/repository/sqlite/base_schema.go`
- `apps/backend/internal/task/repository/sqlite/base_migrations.go`
- `apps/backend/internal/task/repository/sqlite/task.go`
- `apps/backend/internal/task/handlers/task_http_handlers.go`
- `apps/backend/internal/mcp/server/server.go`
- `apps/backend/internal/mcp/handlers/handlers.go`
- Related model, repository, handler, and tool-schema tests
## Dependencies
None.
## Parallelism
This establishes the shared persisted/API contract. Runtime and UI work start only
after its field name, default, and compatibility behavior are fixed.
## Inputs
- Spec sections `Creation API`, `Persistence and restart`, and `Permissions and boundaries`.
- Existing task schema migrations, `TaskDTO` conversion, HTTP create handler, and
MCP `registerCreateTaskTool`/`handleCreateTask` paths.
## Output contract
Report the migration number and SQL, Go/JSON field names, compatibility default,
profile-validation boundary, exact creation/read paths changed, tests run, and any
runtime profile type that remains unsupported.
## Results
Done. Added the immutable SQLite-backed field with migration/default, HTTP and MCP
create propagation, DTO/WS/boot read paths, exact MCP parameter text, and tests for
round trips, omitted values, nested creation, and update immutability.