From 6cb62b02605ff520ff937f70cfa310d6a27bd8a1 Mon Sep 17 00:00:00 2001 From: Joshua Date: Sat, 26 Sep 2026 12:44:45 -0400 Subject: [PATCH] Correct deleteDefinition doc: retirement clears future open instances Replace the over-broad "everything is preserved" with the precise hybrid contract (NQ-262-2). Comment-only change. Co-Authored-By: Claude Opus 5.5 --- admin/src/api/definitions.ts | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/admin/src/api/definitions.ts b/admin/src/api/definitions.ts index 7c6405f..838a43d 100644 --- a/admin/src/api/definitions.ts +++ b/admin/src/api/definitions.ts @@ -158,7 +158,11 @@ export interface DefinitionDeleteResult { /** * Delete a task if it has no completion history; otherwise the API retires - * (deactivates) it and everything is preserved. + * (deactivates) it. Retirement preserves the definition row, schedule rule, + * assignees, windows and ALL durable completion history. Like any + * deactivation it regenerates, so future UNCOMPLETED instances are cleared + * (rolling, regenerable rows) and not recreated while inactive; durable + * history lives only in the append-only `completion_events`. */ export async function deleteDefinition(id: number): Promise { return readJson(