3.2 KiB
3.2 KiB
status, system, created, owners
| status | system | created | owners | |
|---|---|---|---|---|
| draft | tasks | 2026-08-07 |
|
External task ID idempotency boundaries Requirements
Overview
The external identity contract has explicit exclusions and records unresolved questions without silently expanding its guarantee.
Out of scope
Deferred write surfaces (designed, not built)
Neither has a named consumer today, and they are not equally cheap to enable. Each is additive.
| Surface | Cost to enable later |
|---|---|
WebSocket task.create |
Low. One request-struct field, one line in the service-call literal, and skip the launch and last-used recording on a found outcome. One file. Deferred because it is the UI's own path: nothing retries on the UI's behalf. |
| Plugin host | Meaningfully higher. plugin.pb.go and plugin_grpc.pb.go are generated and committed, so a proto edit requires regenerating them through the Makefile proto target (installs protoc-gen-go, needs network). It also needs a new SDK method — do not change the existing TaskReader.Create signature, which is source-breaking for shipped plugins — a mapper change, and a release in each separate plugin repo. |
Other non-goals
- Detecting whether an unsettled create is still alive. No lease, heartbeat, or owner token. This is the deliberate boundary of the feature.
- Repairing, resuming, adopting, or garbage-collecting unsettled tasks.
- Any timeout or expiry on an unsettled task.
- A tombstone for deleted identities. See Idempotency is scoped to the task's lifetime.
- An MCP lookup tool. MCP gets an idempotent create-if-absent, not a probe; no in-scope MCP flow needs to ask without being willing to create. Adding a read-only tool later is small and additive.
- Changing an external ID in place. Write-once; re-key via release + create.
- System-generated external IDs.
- Idempotency for anything other than task creation.
spawn_session_kandevis not covered. - Restructuring the create handlers so identity resolution precedes handler-level validation. The consequence — payload and server-state drift can fail a retry before dedupe — is documented, not engineered around.
- Retiring the existing integration dedupe tables.
- Replacing the office
runs.idempotency_keymechanism. - The office runtime
create_taskHTTP action. - Request-payload fingerprinting.
- Cross-workspace uniqueness or a global namespace.
- A UI surface for entering, displaying, or releasing external IDs.
- Bulk lookup or bulk release.
- Backfilling external IDs onto existing tasks.
Open questions
None. Every decision is settled; downstream steps implement as written and route back here if a change is needed.
Requirements
REQ-TASKS-EXTERNAL-ID-BOUNDARIES-001: External task ID idempotency boundaries
Intent: The external identity contract has explicit exclusions and records unresolved questions without silently expanding its guarantee.
Acceptance criteria
- AC-TASKS-EXTERNAL-ID-BOUNDARIES-001.1: When a caller relies on creation idempotency, the system shall apply only the guarantees listed in scope and shall not infer crash repair or liveness.