@cleocode/core 2026.3.57 → 2026.3.58

package/dist/tasks/archive.js

@@ -0,0 +1,90 @@
+/**
+ * Batch archive completed tasks.
+ * @task T4461
+ * @epic T4454
+ */
+import { getAccessor } from '../store/data-accessor.js';
+import { safeAppendLog } from '../store/data-safety-central.js';
+/**
+ * Archive completed (and optionally cancelled) tasks.
+ * Moves them from active task data to archive.
+ * @task T4461
+ */
+export async function archiveTasks(options = {}, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const includeCancelled = options.includeCancelled ?? true;
+    // Determine which tasks to archive using targeted queries
+    let candidates;
+    if (options.taskIds?.length) {
+        candidates = await acc.loadTasks(options.taskIds);
+    }
+    else {
+        const statuses = includeCancelled ? ['done', 'cancelled'] : ['done'];
+        const { tasks } = await acc.queryTasks({ status: statuses });
+        candidates = tasks;
+    }
+    // Apply date filter
+    if (options.before) {
+        const beforeDate = new Date(options.before).getTime();
+        candidates = candidates.filter((t) => {
+            const completedAt = t.completedAt ?? t.cancelledAt ?? t.updatedAt;
+            if (!completedAt)
+                return false;
+            return new Date(completedAt).getTime() < beforeDate;
+        });
+    }
+    // Check for tasks that can't be archived
+    const archived = [];
+    const skipped = [];
+    for (const task of candidates) {
+        // Skip tasks that aren't done/cancelled
+        if (task.status !== 'done' && task.status !== 'cancelled') {
+            skipped.push(task.id);
+            continue;
+        }
+        // Skip epics that have non-archived children
+        if (task.type === 'epic') {
+            const activeCount = await acc.countActiveChildren(task.id);
+            if (activeCount > 0) {
+                skipped.push(task.id);
+                continue;
+            }
+        }
+        archived.push(task.id);
+    }
+    // For total count, query active task count
+    const totalActive = await acc.countTasks();
+    if (options.dryRun) {
+        return {
+            archived,
+            skipped,
+            total: totalActive,
+            dryRun: true,
+        };
+    }
+    if (archived.length === 0) {
+        return { archived: [], skipped, total: totalActive };
+    }
+    // Archive each task using targeted writes
+    const now = new Date().toISOString();
+    const archivedSet = new Set(archived);
+    const tasksToArchive = candidates.filter((t) => archivedSet.has(t.id));
+    for (const t of tasksToArchive) {
+        await acc.archiveSingleTask(t.id, {
+            archivedAt: now,
+            archiveReason: t.status === 'cancelled' ? 'cancelled' : 'completed',
+        });
+    }
+    await safeAppendLog(acc, {
+        id: `log-${Math.floor(Date.now() / 1000)}-${(await import('node:crypto')).randomBytes(3).toString('hex')}`,
+        timestamp: new Date().toISOString(),
+        action: 'tasks_archived',
+        taskId: archived.join(','),
+        actor: 'system',
+        details: { count: archived.length, ids: archived },
+        before: null,
+        after: { count: archived.length, ids: archived },
+    }, cwd);
+    return { archived, skipped, total: totalActive };
+}
+//# sourceMappingURL=archive.js.map

package/dist/tasks/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/tasks/archive.ts"],"names":[],"mappings":"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"}

package/dist/tasks/atomicity.js

@@ -0,0 +1,83 @@
+export const ATOMICITY_CRITERIA = [
+    'single-file-scope',
+    'single-cognitive-concern',
+    'clear-acceptance-criteria',
+    'no-context-switching',
+    'no-hidden-decisions',
+    'programmatic-validation-possible',
+];
+const ACTION_VERBS = /\b(add|create|update|fix|refactor)\b/gi;
+const ACCEPTANCE_KEYWORDS = /\b(must|should|acceptance|criteria|verify|test|passes when|done when)\b/i;
+const DOMAIN_KEYWORDS = [
+    'frontend',
+    'backend',
+    'database',
+    'api',
+    'ui',
+    'cli',
+    'mcp',
+    'test',
+    'docs',
+];
+const HIDDEN_DECISION_KEYWORDS = /\b(decide|choose|pick|tbd|todo|unclear|figure out|determine)\b/i;
+const VALIDATION_KEYWORDS = /\b(test|spec|assert|verify|check|validate|returns|output)\b/i;
+function countFileExtensions(text) {
+    const matches = text.match(/\.(ts|js|json)\b/g);
+    return matches ? matches.length : 0;
+}
+function countActionVerbs(text) {
+    const matches = text.match(ACTION_VERBS);
+    return matches ? new Set(matches.map((v) => v.toLowerCase())).size : 0;
+}
+function countDomainKeywords(text) {
+    const lower = text.toLowerCase();
+    let count = 0;
+    for (const kw of DOMAIN_KEYWORDS) {
+        if (lower.includes(kw))
+            count++;
+    }
+    return count;
+}
+/**
+ * Check task atomicity using 6-point heuristic test.
+ * Default threshold: 4 (passing requires >= 4/6 criteria met).
+ */
+export function checkAtomicity(task, threshold = 4) {
+    const description = task.description ?? '';
+    const title = task.title ?? '';
+    const combined = `${title} ${description}`;
+    const violations = [];
+    // single-file-scope: description < 500 chars OR <= 3 file-extension mentions
+    if (description.length >= 500 && countFileExtensions(description) > 3) {
+        violations.push('single-file-scope');
+    }
+    // single-cognitive-concern: title doesn't have " and "/" & "/" + " and <= 1 action verb
+    const hasConjunction = /\band\b|\s&\s|\s\+\s/i.test(title);
+    const actionVerbCount = countActionVerbs(title);
+    if (hasConjunction || actionVerbCount > 1) {
+        violations.push('single-cognitive-concern');
+    }
+    // clear-acceptance-criteria: description contains acceptance-related keywords
+    if (!ACCEPTANCE_KEYWORDS.test(description)) {
+        violations.push('clear-acceptance-criteria');
+    }
+    // no-context-switching: <= 2 distinct domain keywords in title + description
+    if (countDomainKeywords(combined) > 2) {
+        violations.push('no-context-switching');
+    }
+    // no-hidden-decisions: description doesn't contain decision/uncertainty keywords
+    if (HIDDEN_DECISION_KEYWORDS.test(description)) {
+        violations.push('no-hidden-decisions');
+    }
+    // programmatic-validation-possible: description contains validation keywords
+    if (!VALIDATION_KEYWORDS.test(description)) {
+        violations.push('programmatic-validation-possible');
+    }
+    const score = ATOMICITY_CRITERIA.length - violations.length;
+    return {
+        score,
+        passed: score >= threshold,
+        violations,
+    };
+}
+//# sourceMappingURL=atomicity.js.map

package/dist/tasks/atomicity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomicity.js","sourceRoot":"","sources":["../../src/tasks/atomicity.ts"],"names":[],"mappings":"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"}

package/dist/tasks/cancel-ops.js

@@ -0,0 +1,83 @@
+/**
+ * Task cancellation operations.
+ * Ported from lib/tasks/cancel-ops.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+/**
+ * Check if a task can be cancelled.
+ */
+export function canCancel(task) {
+    if (task.status === 'done') {
+        return { allowed: false, reason: 'Cannot cancel a completed task' };
+    }
+    if (task.status === 'cancelled') {
+        return { allowed: false, reason: 'Task is already cancelled' };
+    }
+    return { allowed: true };
+}
+/**
+ * Cancel a task in the tasks array (returns updated array).
+ * Does NOT handle children - use deletion-strategy for that.
+ */
+export function cancelTask(taskId, tasks, reason) {
+    const task = tasks.find((t) => t.id === taskId);
+    if (!task) {
+        return {
+            tasks,
+            result: {
+                success: false,
+                taskId,
+                error: { code: 'E_NOT_FOUND', message: `Task ${taskId} not found` },
+            },
+        };
+    }
+    const check = canCancel(task);
+    if (!check.allowed) {
+        return {
+            tasks,
+            result: {
+                success: false,
+                taskId,
+                error: { code: 'E_CANNOT_CANCEL', message: check.reason },
+            },
+        };
+    }
+    const timestamp = new Date().toISOString();
+    const updatedTasks = tasks.map((t) => {
+        if (t.id === taskId) {
+            return {
+                ...t,
+                status: 'cancelled',
+                cancelledAt: timestamp,
+                cancellationReason: reason ?? undefined,
+                updatedAt: timestamp,
+            };
+        }
+        return t;
+    });
+    return {
+        tasks: updatedTasks,
+        result: {
+            success: true,
+            taskId,
+            reason,
+            cancelledAt: timestamp,
+        },
+    };
+}
+/**
+ * Batch cancel multiple tasks.
+ */
+export function cancelMultiple(taskIds, tasks, reason) {
+    const results = [];
+    let currentTasks = [...tasks];
+    for (const id of taskIds) {
+        const { tasks: updated, result } = cancelTask(id, currentTasks, reason);
+        currentTasks = updated;
+        results.push(result);
+    }
+    return { tasks: currentTasks, results };
+}
+//# sourceMappingURL=cancel-ops.js.map

package/dist/tasks/cancel-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-ops.js","sourceRoot":"","sources":["../../src/tasks/cancel-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,MAAc,EACd,KAAa,EACb,MAAe;IAEf,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,KAAK;YACL,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,MAAM;gBACN,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,MAAM,YAAY,EAAE;aACpE;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK;YACL,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,MAAM;gBACN,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,MAAO,EAAE;aAC3D;SACF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnC,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO;gBACL,GAAG,CAAC;gBACJ,MAAM,EAAE,WAAoB;gBAC5B,WAAW,EAAE,SAAS;gBACtB,kBAAkB,EAAE,MAAM,IAAI,SAAS;gBACvC,SAAS,EAAE,SAAS;aACrB,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE;YACN,OAAO,EAAE,IAAI;YACb,MAAM;YACN,MAAM;YACN,WAAW,EAAE,SAAS;SACvB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAiB,EACjB,KAAa,EACb,MAAe;IAEf,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE9B,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACxE,YAAY,GAAG,OAAO,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/tasks/complete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/tasks/complete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAoB,MAAM,qBAAqB,CAAC;AAK3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;CACvD;AAkFD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA8M7B"}
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/tasks/complete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAoB,MAAM,qBAAqB,CAAC;AAM3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;CACvD;AA0FD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA2M7B"}

package/dist/tasks/complete.js

@@ -0,0 +1,224 @@
+/**
+ * Task completion logic.
+ * @task T4461
+ * @epic T4454
+ */
+// safeAppendLog replaced by tx.appendLog inside transaction (T023)
+import { ExitCode } from '@cleocode/contracts';
+import { getRawConfigValue } from '../config.js';
+import { CleoError } from '../errors.js';
+import { requireActiveSession } from '../sessions/session-enforcement.js';
+import { getAccessor } from '../store/data-accessor.js';
+import { createAcceptanceEnforcement } from './enforcement.js';
+const DEFAULT_VERIFICATION_REQUIRED_GATES = [
+    'implemented',
+    'testsPassed',
+    'qaPassed',
+    'securityPassed',
+    'documented',
+];
+const VERIFICATION_GATES = new Set([
+    'implemented',
+    'testsPassed',
+    'qaPassed',
+    'cleanupDone',
+    'securityPassed',
+    'documented',
+]);
+function isVerificationGate(value) {
+    return VERIFICATION_GATES.has(value);
+}
+async function loadCompletionEnforcement(cwd) {
+    const modeRaw = await getRawConfigValue('enforcement.acceptance.mode', cwd);
+    const prioritiesRaw = await getRawConfigValue('enforcement.acceptance.requiredForPriorities', cwd);
+    const verificationEnabledRaw = await getRawConfigValue('verification.enabled', cwd);
+    const verificationRequiredGatesRaw = await getRawConfigValue('verification.requiredGates', cwd);
+    const verificationMaxRoundsRaw = await getRawConfigValue('verification.maxRounds', cwd);
+    const lifecycleModeRaw = await getRawConfigValue('lifecycle.mode', cwd);
+    const acceptanceMode = modeRaw === 'off' || modeRaw === 'warn' || modeRaw === 'block' ? modeRaw : 'warn';
+    const acceptanceRequiredForPriorities = Array.isArray(prioritiesRaw)
+        ? prioritiesRaw.filter((p) => typeof p === 'string')
+        : ['critical', 'high'];
+    const verificationEnabled = verificationEnabledRaw === true;
+    const verificationRequiredGates = Array.isArray(verificationRequiredGatesRaw)
+        ? verificationRequiredGatesRaw
+            .filter((g) => typeof g === 'string')
+            .filter(isVerificationGate)
+        : DEFAULT_VERIFICATION_REQUIRED_GATES;
+    const verificationMaxRounds = typeof verificationMaxRoundsRaw === 'number' && Number.isInteger(verificationMaxRoundsRaw)
+        ? verificationMaxRoundsRaw
+        : 5;
+    const lifecycleMode = lifecycleModeRaw === 'strict' ||
+        lifecycleModeRaw === 'warn' ||
+        lifecycleModeRaw === 'advisory' ||
+        lifecycleModeRaw === 'none' ||
+        lifecycleModeRaw === 'off'
+        ? lifecycleModeRaw
+        : 'off';
+    return {
+        acceptanceMode,
+        acceptanceRequiredForPriorities,
+        verificationEnabled,
+        verificationRequiredGates,
+        verificationMaxRounds,
+        lifecycleMode,
+    };
+}
+/**
+ * Complete a task by ID.
+ * Handles dependency checking and optional auto-completion of epics.
+ * @task T4461
+ */
+export async function completeTask(options, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const task = await acc.loadSingleTask(options.taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task not found: ${options.taskId}`, {
+            fix: `Use 'cleo find "${options.taskId}"' to search`,
+        });
+    }
+    await requireActiveSession('tasks.complete', cwd);
+    const enforcement = await loadCompletionEnforcement(cwd);
+    // Already done
+    if (task.status === 'done') {
+        throw new CleoError(ExitCode.TASK_COMPLETED, `Task ${options.taskId} is already completed`);
+    }
+    // Check if task has incomplete dependencies
+    if (task.depends?.length) {
+        const deps = await acc.loadTasks(task.depends);
+        const incompleteDeps = deps
+            .filter((d) => d.status !== 'done' && d.status !== 'cancelled')
+            .map((d) => d.id);
+        if (incompleteDeps.length > 0) {
+            throw new CleoError(ExitCode.DEPENDENCY_ERROR, `Task ${options.taskId} has incomplete dependencies: ${incompleteDeps.join(', ')}`, {
+                fix: `Complete dependencies first: ${incompleteDeps.map((d) => `cleo complete ${d}`).join(', ')}`,
+            });
+        }
+    }
+    const acceptanceEnforcement = await createAcceptanceEnforcement(cwd);
+    const completionValidation = acceptanceEnforcement.validateCompletion(task);
+    if (!completionValidation.valid) {
+        throw new CleoError(completionValidation.exitCode ?? ExitCode.VALIDATION_ERROR, completionValidation.error, { fix: completionValidation.fix });
+    }
+    if (enforcement.verificationEnabled && task.type !== 'epic') {
+        if (!task.verification) {
+            throw new CleoError(ExitCode.VERIFICATION_INIT_FAILED, `Task ${options.taskId} is missing verification metadata`, {
+                fix: `Initialize verification for ${options.taskId} before completion`,
+            });
+        }
+        if (task.verification.round > enforcement.verificationMaxRounds) {
+            throw new CleoError(ExitCode.MAX_ROUNDS_EXCEEDED, `Task ${options.taskId} exceeded verification max rounds (${enforcement.verificationMaxRounds})`, {
+                fix: `Review failure log and resolve blockers before retrying completion`,
+            });
+        }
+        const missingRequiredGates = enforcement.verificationRequiredGates.filter((gate) => task.verification?.gates?.[gate] !== true);
+        if (missingRequiredGates.length > 0 || task.verification.passed !== true) {
+            const exitCode = enforcement.lifecycleMode === 'strict'
+                ? ExitCode.LIFECYCLE_GATE_FAILED
+                : ExitCode.GATE_DEPENDENCY;
+            throw new CleoError(exitCode, `Task ${options.taskId} failed verification gates: ${missingRequiredGates.join(', ') || 'verification.passed=false'}`, {
+                fix: `Set required verification gates before completion: ${enforcement.verificationRequiredGates.join(', ')}`,
+            });
+        }
+    }
+    // Check if task has incomplete children
+    const children = await acc.getChildren(options.taskId);
+    const incompleteChildren = children.filter((c) => c.status !== 'done' && c.status !== 'cancelled');
+    if (incompleteChildren.length > 0 && task.type === 'epic') {
+        if (!task.noAutoComplete) {
+            throw new CleoError(ExitCode.HAS_CHILDREN, `Epic ${options.taskId} has ${incompleteChildren.length} incomplete children: ${incompleteChildren.map((c) => c.id).join(', ')}`, {
+                fix: `Complete children first or use 'cleo update ${options.taskId} --no-auto-complete'`,
+            });
+        }
+    }
+    const now = new Date().toISOString();
+    const before = { ...task };
+    // Update task
+    task.status = 'done';
+    task.completedAt = now;
+    task.updatedAt = now;
+    if (options.notes) {
+        const timestampedNote = `${new Date()
+            .toISOString()
+            .replace('T', ' ')
+            .replace(/\.\d+Z$/, ' UTC')}: ${options.notes}`;
+        if (!task.notes)
+            task.notes = [];
+        task.notes.push(timestampedNote);
+    }
+    if (options.changeset) {
+        if (!task.notes)
+            task.notes = [];
+        task.notes.push(`Changeset: ${options.changeset}`);
+    }
+    // Check if parent epic should auto-complete
+    const autoCompleted = [];
+    const autoCompletedTasks = [];
+    if (task.parentId) {
+        const parent = await acc.loadSingleTask(task.parentId);
+        if (parent && parent.type === 'epic' && !parent.noAutoComplete) {
+            const siblings = await acc.getChildren(parent.id);
+            // The current task is not yet 'done' in DB, so check by ID
+            const allDone = siblings.every((c) => c.id === task.id || c.status === 'done' || c.status === 'cancelled');
+            if (allDone) {
+                parent.status = 'done';
+                parent.completedAt = now;
+                parent.updatedAt = now;
+                autoCompleted.push(parent.id);
+                autoCompletedTasks.push(parent);
+            }
+        }
+    }
+    // Wrap writes in a transaction for TOCTOU safety (T023)
+    await acc.transaction(async (tx) => {
+        await tx.upsertSingleTask(task);
+        for (const parentTask of autoCompletedTasks) {
+            await tx.upsertSingleTask(parentTask);
+        }
+        await tx.appendLog({
+            id: `log-${Math.floor(Date.now() / 1000)}-${(await import('node:crypto')).randomBytes(3).toString('hex')}`,
+            timestamp: new Date().toISOString(),
+            action: 'task_completed',
+            taskId: options.taskId,
+            actor: 'system',
+            details: { title: task.title, previousStatus: before.status },
+            before: null,
+            after: { title: task.title, previousStatus: before.status },
+        });
+    });
+    // Compute newly unblocked tasks: dependents whose deps are now all satisfied
+    const dependents = await acc.getDependents(options.taskId);
+    const unblockedTasks = [];
+    for (const dep of dependents) {
+        if (dep.status === 'done' || dep.status === 'cancelled')
+            continue;
+        if (dep.depends?.length) {
+            const depDeps = await acc.loadTasks(dep.depends);
+            const stillUnresolved = depDeps.filter((d) => d.id !== options.taskId && d.status !== 'done' && d.status !== 'cancelled');
+            if (stillUnresolved.length === 0) {
+                unblockedTasks.push({ id: dep.id, title: dep.title });
+            }
+        }
+        else {
+            unblockedTasks.push({ id: dep.id, title: dep.title });
+        }
+    }
+    // Regenerate .cleo/memory-bridge.md (best-effort, T5240)
+    import('../memory/memory-bridge.js')
+        .then(({ refreshMemoryBridge }) => refreshMemoryBridge(cwd ?? process.cwd()))
+        .catch(() => {
+        /* Memory bridge refresh is best-effort */
+    });
+    // Auto-extract memory from task completion (best-effort, T-audit)
+    import('../memory/auto-extract.js')
+        .then(({ extractTaskCompletionMemory }) => extractTaskCompletionMemory(cwd ?? process.cwd(), task))
+        .catch(() => {
+        /* Memory extraction is best-effort */
+    });
+    return {
+        task,
+        ...(autoCompleted.length > 0 && { autoCompleted }),
+        ...(unblockedTasks.length > 0 && { unblockedTasks }),
+    };
+}
+//# sourceMappingURL=complete.js.map

package/dist/tasks/complete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../src/tasks/complete.ts"],"names":[],"mappings":"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"}

package/dist/tasks/crossref-extract.js

@@ -0,0 +1,73 @@
+/**
+ * Cross-reference extraction - extract task IDs from text content.
+ * Ported from lib/tasks/crossref-extract.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+const VALID_RELATES_TYPES = [
+    'relates-to',
+    'spawned-from',
+    'deferred-to',
+    'supersedes',
+    'duplicates',
+];
+/**
+ * Extract task IDs from text content.
+ * Scans for patterns like T1234, T001, T42 (T followed by 3+ digits).
+ */
+export function extractTaskRefs(text, excludeId) {
+    if (!text)
+        return [];
+    const pattern = /T\d{3,}/g;
+    const matches = text.match(pattern);
+    if (!matches)
+        return [];
+    const unique = [...new Set(matches)];
+    if (excludeId) {
+        return unique.filter((id) => id !== excludeId).sort();
+    }
+    return unique.sort();
+}
+/**
+ * Create relates entries from extracted task IDs.
+ */
+export function createRelatesEntries(refs, relType = 'relates-to', reason) {
+    if (!refs.length)
+        return [];
+    // Validate type, fallback to 'relates-to'
+    const validType = VALID_RELATES_TYPES.includes(relType) ? relType : 'relates-to';
+    return refs.map((taskId) => {
+        const entry = { taskId, type: validType };
+        if (reason)
+            entry.reason = reason;
+        return entry;
+    });
+}
+/**
+ * Merge new relates entries with existing ones.
+ * Existing entries take precedence (dedup by taskId).
+ */
+export function mergeRelatesArrays(existing, newEntries) {
+    const existingIds = new Set(existing.map((e) => e.taskId));
+    const filtered = newEntries.filter((e) => !existingIds.has(e.taskId));
+    return [...existing, ...filtered];
+}
+/**
+ * Validate that referenced task IDs exist.
+ * Returns array of invalid (non-existent) task IDs.
+ */
+export function validateRelatesRefs(relates, validTaskIds) {
+    if (!relates.length)
+        return [];
+    const validSet = new Set(validTaskIds);
+    return relates.map((r) => r.taskId).filter((id) => !validSet.has(id));
+}
+/**
+ * Convenience: extract task refs from text and create relates entries.
+ */
+export function extractAndCreateRelates(text, excludeId, relType = 'relates-to', reason) {
+    const refs = extractTaskRefs(text, excludeId);
+    return createRelatesEntries(refs, relType, reason);
+}
+//# sourceMappingURL=crossref-extract.js.map

package/dist/tasks/crossref-extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossref-extract.js","sourceRoot":"","sources":["../../src/tasks/crossref-extract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,mBAAmB,GAAkB;IACzC,YAAY;IACZ,cAAc;IACd,aAAa;IACb,YAAY;IACZ,YAAY;CACb,CAAC;AASF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,SAAkB;IAC9D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,OAAO,GAAG,UAAU,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAErC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAc,EACd,UAAuB,YAAY,EACnC,MAAe;IAEf,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAE5B,0CAA0C;IAC1C,MAAM,SAAS,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;IAEjF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,MAAM,KAAK,GAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACxD,IAAI,MAAM;YAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAwB,EACxB,UAA0B;IAE1B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuB,EAAE,YAAsB;IACjF,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,SAAkB,EAClB,UAAuB,YAAY,EACnC,MAAe;IAEf,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9C,OAAO,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC"}