@veewo/claw-core 0.1.67 → 0.1.69

package/dist/src/switch-task.js

@@ -1,15 +1,19 @@
-import { ensureTaskMeta, resolveProjectContext, resolveTaskContext, saveTaskMeta } from "./context.js";
+import fs from "node:fs";
+import path from "node:path";
+import { ensureTaskContext, resolveProjectContext, resolveTaskContext } from "./context.js";
+import { readJsonFile } from "./io.js";
 export function switchTask(input) {
     const project = resolveProjectContext(input.cwd);
     const source = resolveTaskContext(project, input.fromTask);
-    const target = ensureTaskMeta(project, input.toTask);
+    const target = ensureTaskContext(project, input.toTask);
     const now = new Date().toISOString();
+    const sourcePlan = readJsonFile(source.activePlanPath);
     const sourceSnapshot = {
         projectId: project.projectId,
         task: source.taskName,
-        status: source.meta.status,
-        updatedAt: source.meta.updatedAt,
-        activePlan: source.meta.activePlan,
+        status: sourcePlan.status === "end.completed" ? "completed" : sourcePlan.status.startsWith("end.") ? "paused" : "active",
+        updatedAt: sourcePlan.completedAt,
+        activePlan: source.activePlan,
         planPath: source.activePlanPath,
     };
     const leaveState = {
@@ -22,38 +26,11 @@ export function switchTask(input) {
         continueNeeded: input.reason !== "completed" && input.reason !== "abandoned",
         sourceSnapshot,
     };
-    const inheritedFrom = {
-        projectId: project.projectId,
-        task: source.taskName,
-        mode: input.mode ?? "prev_task",
-        linkedAt: now,
-        historyLimit: input.historyLimit ?? 5,
-        sourceSnapshot,
-        reason: leaveState.reason,
-        sourceStatus: source.meta.status ?? "active",
-        sourceUpdatedAt: source.meta.updatedAt,
-        sourceLeaveStateUpdatedAt: leaveState.updatedAt ?? leaveState.leftAt,
-        sourceLeaveState: leaveState,
-    };
-    source.meta.leaveState = leaveState;
-    source.meta.updatedAt = now;
-    target.meta.prevTask = source.taskName;
-    target.meta.previousTask = {
-        projectId: project.projectId,
-        task: source.taskName,
-        linkedAt: now,
-        reason: leaveState.reason,
-        leaveStateAt: leaveState.leftAt,
-    };
-    target.meta.inheritedFrom = inheritedFrom;
-    target.meta.updatedAt = now;
-    saveTaskMeta(source);
-    saveTaskMeta(target);
     return {
         fromTask: source.taskName,
         toTask: target.taskName,
-        sourceMetaPath: source.metaPath,
-        targetMetaPath: target.metaPath,
+        sourcePlanPath: source.activePlanPath,
+        ...(fs.existsSync(path.join(target.taskDir, "plan.json")) ? { targetPlanPath: path.join(target.taskDir, "plan.json") } : {}),
         leaveState,
     };
 }

package/dist/src/switch-task.js.map

@@ -1 +1 @@
-{"version":3,"file":"switch-task.js","sourceRoot":"","sources":["../../src/switch-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGvG,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,cAAc,GAAuB;QACzC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS;QAChC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;QAClC,QAAQ,EAAE,MAAM,CAAC,cAAc;KAChC,CAAC;IAEF,MAAM,UAAU,GAAe;QAC7B,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,aAAa;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;QAC5E,cAAc;KACf,CAAC;IAEF,MAAM,aAAa,GAAkB;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,WAAW;QAC/B,QAAQ,EAAE,GAAG;QACb,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;QACrC,cAAc;QACd,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ;QAC5C,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS;QACtC,yBAAyB,EAAE,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,MAAM;QACpE,gBAAgB,EAAE,UAAU;KAC7B,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACpC,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,QAAQ,EAAE,GAAG;QACb,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,YAAY,EAAE,UAAU,CAAC,MAAM;KAChC,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IAE5B,YAAY,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,CAAC,MAAM,CAAC,CAAC;IAErB,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,cAAc,EAAE,MAAM,CAAC,QAAQ;QAC/B,cAAc,EAAE,MAAM,CAAC,QAAQ;QAC/B,UAAU;KACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"switch-task.js","sourceRoot":"","sources":["../../src/switch-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,YAAY,CAAe,MAAM,CAAC,cAAc,CAAC,CAAC;IAErE,MAAM,cAAc,GAAuB;QACzC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACxH,SAAS,EAAE,UAAU,CAAC,WAAW;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,cAAc;KAChC,CAAC;IAEF,MAAM,UAAU,GAAe;QAC7B,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,aAAa;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;QAC5E,cAAc;KACf,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5H,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/task-layout-migration.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectContext } from "./types.js";
+export type TaskLayoutMigrationResult = {
+    changed: boolean;
+    fixedPaths: string[];
+};
+export declare function migrateLegacyTaskLayout(project: ProjectContext): TaskLayoutMigrationResult;
+export declare function taskLayoutMigrationMarkerPath(clawDir: string): string;
+export declare function markTaskLayoutMigrationComplete(clawDir: string): string;

package/dist/src/task-layout-migration.js

@@ -0,0 +1,210 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ClawError } from "./errors.js";
+import { readJsonFile, writeJsonFile } from "./io.js";
+import { ensureInsideDir, normalizePlanFile } from "./paths.js";
+import { bindSessionToPlan, resolveSessionBoundPlan, unbindSession } from "./session-bindings.js";
+export function migrateLegacyTaskLayout(project) {
+    const markerPath = taskLayoutMigrationMarkerPath(project.clawDir);
+    if (fs.existsSync(markerPath)) {
+        return { changed: false, fixedPaths: [] };
+    }
+    const taskDirs = fs.existsSync(project.tasksDir)
+        ? fs.readdirSync(project.tasksDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => path.join(project.tasksDir, entry.name))
+        : [];
+    const moves = taskDirs.flatMap((taskDir) => collectLegacyPlanMoves(taskDir));
+    validateMoves(moves);
+    const fixedPaths = new Set();
+    const bindingCandidates = new Map();
+    for (const taskDir of taskDirs) {
+        const metaPath = path.join(taskDir, "meta.json");
+        const legacyMeta = readLegacyMeta(metaPath);
+        const taskMoves = moves.filter((move) => path.dirname(move.targetPath) === taskDir);
+        const planFileMap = new Map(taskMoves.map((move) => [move.sourcePlanFile, move.targetPlanFile]));
+        rewriteTaskPlanReferences(taskDir, taskMoves, planFileMap, fixedPaths, project);
+        for (const move of taskMoves) {
+            fs.renameSync(move.sourcePath, move.targetPath);
+            fixedPaths.add(toProjectRelativePath(project, move.sourcePath));
+            fixedPaths.add(toProjectRelativePath(project, move.targetPath));
+        }
+        removeEmptyLegacyPlanDirectories(path.join(taskDir, "plans"));
+        if (legacyMeta) {
+            collectBindingCandidate(taskDir, legacyMeta, planFileMap, bindingCandidates);
+            fs.unlinkSync(metaPath);
+            fixedPaths.add(toProjectRelativePath(project, metaPath));
+        }
+    }
+    applyBindingCandidates(project, bindingCandidates, fixedPaths);
+    markTaskLayoutMigrationComplete(project.clawDir);
+    fixedPaths.add(toProjectRelativePath(project, markerPath));
+    return { changed: fixedPaths.size > 0, fixedPaths: [...fixedPaths] };
+}
+export function taskLayoutMigrationMarkerPath(clawDir) {
+    return path.join(clawDir, "runtime", "task-layout-v2.complete");
+}
+export function markTaskLayoutMigrationComplete(clawDir) {
+    const markerPath = taskLayoutMigrationMarkerPath(clawDir);
+    fs.mkdirSync(path.dirname(markerPath), { recursive: true });
+    fs.writeFileSync(markerPath, "", "utf-8");
+    return markerPath;
+}
+function collectLegacyPlanMoves(taskDir) {
+    const plansDir = path.join(taskDir, "plans");
+    if (!fs.existsSync(plansDir)) {
+        return [];
+    }
+    return fs.readdirSync(plansDir, { recursive: true, withFileTypes: true })
+        .filter((entry) => entry.isFile())
+        .map((entry) => {
+        const sourcePath = path.join(entry.parentPath, entry.name);
+        if (path.extname(entry.name).toLowerCase() !== ".json") {
+            throw new ClawError("PROJECT_CONFIG_INVALID", `Legacy plans directory contains a non-JSON file: ${sourcePath}`, {
+                path: sourcePath,
+            });
+        }
+        const sourcePlanFile = path.relative(taskDir, sourcePath).replace(/\\/g, "/");
+        const targetPlanFile = normalizePlanFile(path.basename(sourcePath));
+        return {
+            sourcePath,
+            targetPath: path.join(taskDir, targetPlanFile),
+            sourcePlanFile,
+            targetPlanFile,
+        };
+    });
+}
+function validateMoves(moves) {
+    const targets = new Set();
+    for (const move of moves) {
+        const normalizedTarget = path.resolve(move.targetPath).toLowerCase();
+        if (targets.has(normalizedTarget) || fs.existsSync(move.targetPath)) {
+            throw new ClawError("PLAN_ALREADY_EXISTS", `Cannot flatten legacy subplan because "${move.targetPlanFile}" already exists.`, {
+                sourcePath: move.sourcePath,
+                targetPath: move.targetPath,
+            });
+        }
+        targets.add(normalizedTarget);
+    }
+}
+function rewriteTaskPlanReferences(taskDir, moves, planFileMap, fixedPaths, project) {
+    const planPaths = [
+        ...fs.readdirSync(taskDir, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && path.extname(entry.name).toLowerCase() === ".json" && entry.name !== "meta.json")
+            .map((entry) => path.join(taskDir, entry.name)),
+        ...moves.map((move) => move.sourcePath),
+    ];
+    for (const planPath of planPaths) {
+        let plan;
+        try {
+            plan = readJsonFile(planPath);
+        }
+        catch {
+            continue;
+        }
+        let changed = false;
+        const mappedParent = mapLegacyPlanFile(plan.parentPlan, planFileMap);
+        if (mappedParent && mappedParent !== plan.parentPlan) {
+            plan.parentPlan = mappedParent;
+            changed = true;
+        }
+        for (const task of Array.isArray(plan.tasks) ? plan.tasks : []) {
+            if (!task.execution) {
+                continue;
+            }
+            const mappedSubplan = mapLegacyPlanFile(task.execution.subplan, planFileMap);
+            const mappedPlanPath = mapLegacyPlanFile(task.execution.planPath, planFileMap);
+            if (mappedSubplan && mappedSubplan !== task.execution.subplan) {
+                task.execution.subplan = mappedSubplan;
+                changed = true;
+            }
+            if (mappedPlanPath && mappedPlanPath !== task.execution.planPath) {
+                task.execution.planPath = mappedPlanPath;
+                changed = true;
+            }
+        }
+        if (changed) {
+            writeJsonFile(planPath, plan);
+            fixedPaths.add(toProjectRelativePath(project, planPath));
+        }
+    }
+}
+function mapLegacyPlanFile(value, planFileMap) {
+    if (!value) {
+        return value;
+    }
+    return planFileMap.get(value.replace(/\\/g, "/")) ?? value;
+}
+function collectBindingCandidate(taskDir, meta, planFileMap, candidates) {
+    const sessionKey = typeof meta.ownerSessionKey === "string" ? meta.ownerSessionKey.trim() : "";
+    if (!sessionKey) {
+        return;
+    }
+    const legacyActivePlan = typeof meta.activePlan === "string" ? meta.activePlan.replace(/\\/g, "/") : "plan.json";
+    const planFile = planFileMap.get(legacyActivePlan) ?? normalizePlanFile(legacyActivePlan);
+    const planPath = ensureInsideDir(taskDir, planFile);
+    if (!planPath || !isOpenPlan(planPath)) {
+        return;
+    }
+    const updatedAt = typeof meta.updatedAt === "string" ? meta.updatedAt : "";
+    const current = candidates.get(sessionKey);
+    if (!current || updatedAt > current.updatedAt) {
+        candidates.set(sessionKey, { sessionKey, planPath, updatedAt });
+    }
+}
+function applyBindingCandidates(project, candidates, fixedPaths) {
+    for (const candidate of candidates.values()) {
+        const existingPlanPath = resolveSessionBoundPlan(project, candidate.sessionKey);
+        if (existingPlanPath && isOpenPlan(existingPlanPath)) {
+            continue;
+        }
+        if (existingPlanPath) {
+            unbindSession(project, candidate.sessionKey);
+        }
+        bindSessionToPlan(project, candidate.sessionKey, candidate.planPath);
+        fixedPaths.add(".claw/runtime/session-bindings.json");
+    }
+}
+function isOpenPlan(planPath) {
+    if (!fs.existsSync(planPath)) {
+        return false;
+    }
+    try {
+        const plan = readJsonFile(planPath);
+        return typeof plan.status === "string" && !plan.status.startsWith("end.");
+    }
+    catch {
+        return false;
+    }
+}
+function readLegacyMeta(metaPath) {
+    if (!fs.existsSync(metaPath)) {
+        return undefined;
+    }
+    try {
+        return readJsonFile(metaPath);
+    }
+    catch (error) {
+        throw new ClawError("PROJECT_CONFIG_INVALID", `Failed to parse legacy task metadata: ${metaPath}`, {
+            path: metaPath,
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function removeEmptyLegacyPlanDirectories(plansDir) {
+    if (!fs.existsSync(plansDir)) {
+        return;
+    }
+    for (const entry of fs.readdirSync(plansDir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            removeEmptyLegacyPlanDirectories(path.join(plansDir, entry.name));
+        }
+    }
+    if (fs.readdirSync(plansDir).length === 0) {
+        fs.rmdirSync(plansDir);
+    }
+}
+function toProjectRelativePath(project, absolutePath) {
+    return path.relative(project.projectRoot, absolutePath).replace(/\\/g, "/");
+}
+//# sourceMappingURL=task-layout-migration.js.map

package/dist/src/task-layout-migration.js.map

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

package/dist/src/task-retention.d.ts

@@ -1,2 +1,3 @@
 import type { ProjectContext, TaskRetentionResult } from "./types.js";
-export declare function enforceTaskRetention(project: ProjectContext, currentTaskName?: string): TaskRetentionResult;
+export declare const COMPLETED_TASK_ARCHIVE_DELAY_MS: number;
+export declare function enforceTaskRetention(project: ProjectContext, currentTaskName?: string, nowMs?: number): TaskRetentionResult;

package/dist/src/task-retention.js

@@ -1,13 +1,14 @@
 import fs from "node:fs";
 import path from "node:path";
 import { readJsonFile } from "./io.js";
-export function enforceTaskRetention(project, currentTaskName) {
+export const COMPLETED_TASK_ARCHIVE_DELAY_MS = 60 * 60 * 1000;
+export function enforceTaskRetention(project, currentTaskName, nowMs = Date.now()) {
     const maxTasksToKeep = project.projectConfig?.maxTasksToKeep ?? 99;
     const archiveTasksRoot = path.join(project.clawDir, "archive", "tasks");
     const prunedArchivedTasks = [];
     let archivedCurrentTask;
     for (const taskName of listActiveTaskNames(project)) {
-        const archivedTask = archiveTaskDirectory(project, taskName, archiveTasksRoot);
+        const archivedTask = archiveTaskDirectory(project, taskName, archiveTasksRoot, nowMs);
         if (archivedTask && taskName === currentTaskName) {
             archivedCurrentTask = archivedTask;
         }
@@ -16,7 +17,7 @@ export function enforceTaskRetention(project, currentTaskName) {
     if (archivedTasks.length > maxTasksToKeep) {
         const overflow = archivedTasks.length - maxTasksToKeep;
         const toPrune = archivedTasks
-            .sort(compareArchivedTasksByUpdatedAt)
+            .sort(compareArchivedTasksByCompletedAt)
             .slice(0, overflow);
         for (const archivedTask of toPrune) {
             removeDirectoryTreeSync(archivedTask.archivedTaskDir);
@@ -30,35 +31,59 @@ export function enforceTaskRetention(project, currentTaskName) {
         prunedArchivedTasks,
     };
 }
-function archiveTaskDirectory(project, taskName, archiveTasksRoot) {
+function archiveTaskDirectory(project, taskName, archiveTasksRoot, nowMs) {
     const sourceTaskDir = path.join(project.tasksDir, taskName);
     if (!fs.existsSync(sourceTaskDir) || !fs.statSync(sourceTaskDir).isDirectory()) {
         return undefined;
     }
-    const metaPath = path.join(sourceTaskDir, "meta.json");
-    if (!fs.existsSync(metaPath)) {
+    const rootPlanPath = path.join(sourceTaskDir, "plan.json");
+    const legacyMetaPath = path.join(sourceTaskDir, "meta.json");
+    const legacyMeta = fs.existsSync(legacyMetaPath) ? readJsonFile(legacyMetaPath) : undefined;
+    const activePlanPath = fs.existsSync(rootPlanPath)
+        ? rootPlanPath
+        : typeof legacyMeta?.activePlan === "string"
+            ? path.join(sourceTaskDir, legacyMeta.activePlan)
+            : undefined;
+    if (!activePlanPath || !fs.existsSync(activePlanPath)) {
         return undefined;
     }
-    const meta = readJsonFile(metaPath);
-    const activePlanPath = typeof meta.activePlan === "string" ? path.join(sourceTaskDir, meta.activePlan) : undefined;
-    const planStatus = activePlanPath && fs.existsSync(activePlanPath)
-        ? readJsonFile(activePlanPath).status
-        : undefined;
-    if (meta.status !== "completed" && planStatus !== "end.completed") {
+    const completedAt = readJsonFile(activePlanPath).completedAt;
+    const completedAtMs = typeof completedAt === "string" ? Date.parse(completedAt) : Number.NaN;
+    if (!Number.isFinite(completedAtMs) || nowMs - completedAtMs < COMPLETED_TASK_ARCHIVE_DELAY_MS) {
         return undefined;
     }
     fs.mkdirSync(archiveTasksRoot, { recursive: true });
     const archivedTaskDir = uniqueArchiveTaskDir(archiveTasksRoot, taskName);
-    fs.renameSync(sourceTaskDir, archivedTaskDir);
-    const archivedPlanPath = typeof meta.activePlan === "string" ? path.join(archivedTaskDir, meta.activePlan) : undefined;
+    renameDirectoryWithRetry(sourceTaskDir, archivedTaskDir);
+    const archivedPlanPath = activePlanPath
+        ? path.join(archivedTaskDir, path.relative(sourceTaskDir, activePlanPath))
+        : undefined;
     return {
         taskName,
         sourceTaskDir,
         archivedTaskDir,
         ...(archivedPlanPath ? { archivedPlanPath } : {}),
-        ...(meta.updatedAt ? { updatedAt: meta.updatedAt } : {}),
+        ...(completedAt ? { completedAt } : {}),
     };
 }
+function renameDirectoryWithRetry(sourceDir, targetDir) {
+    const retryDelaysMs = [0, 50, 150, 300];
+    for (let attempt = 0; attempt < retryDelaysMs.length; attempt += 1) {
+        try {
+            fs.renameSync(sourceDir, targetDir);
+            return;
+        }
+        catch (error) {
+            const code = error.code;
+            const retryable = code === "EPERM" || code === "EBUSY" || code === "EACCES";
+            if (!retryable || attempt === retryDelaysMs.length - 1) {
+                throw error;
+            }
+            const delayMs = retryDelaysMs[attempt + 1];
+            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, delayMs);
+        }
+    }
+}
 function listActiveTaskNames(project) {
     if (!fs.existsSync(project.tasksDir)) {
         return [];
@@ -78,16 +103,24 @@ function listArchivedTasks(archiveTasksRoot) {
             continue;
         }
         const archivedTaskDir = path.join(archiveTasksRoot, child.name);
-        const metaPath = path.join(archivedTaskDir, "meta.json");
-        let updatedAt;
+        const rootPlanPath = path.join(archivedTaskDir, "plan.json");
+        let completedAt;
         let taskName = child.name;
         let archivedPlanPath;
-        if (fs.existsSync(metaPath)) {
-            const meta = readJsonFile(metaPath);
-            updatedAt = meta.updatedAt;
-            taskName = typeof meta.name === "string" && meta.name.trim() ? meta.name : child.name;
-            if (typeof meta.activePlan === "string" && meta.activePlan.trim()) {
-                archivedPlanPath = path.join(archivedTaskDir, meta.activePlan);
+        if (fs.existsSync(rootPlanPath)) {
+            const plan = readJsonFile(rootPlanPath);
+            completedAt = plan.completedAt;
+            archivedPlanPath = rootPlanPath;
+        }
+        else {
+            const metaPath = path.join(archivedTaskDir, "meta.json");
+            if (fs.existsSync(metaPath)) {
+                const meta = readJsonFile(metaPath);
+                completedAt = meta.updatedAt;
+                taskName = typeof meta.name === "string" && meta.name.trim() ? meta.name : child.name;
+                if (typeof meta.activePlan === "string" && meta.activePlan.trim()) {
+                    archivedPlanPath = path.join(archivedTaskDir, meta.activePlan);
+                }
             }
         }
         entries.push({
@@ -95,14 +128,14 @@ function listArchivedTasks(archiveTasksRoot) {
             sourceTaskDir: "",
             archivedTaskDir,
             ...(archivedPlanPath ? { archivedPlanPath } : {}),
-            ...(updatedAt ? { updatedAt } : {}),
+            ...(completedAt ? { completedAt } : {}),
         });
     }
     return entries;
 }
-function compareArchivedTasksByUpdatedAt(left, right) {
-    const leftTime = left.updatedAt ? Date.parse(left.updatedAt) : Number.NEGATIVE_INFINITY;
-    const rightTime = right.updatedAt ? Date.parse(right.updatedAt) : Number.NEGATIVE_INFINITY;
+function compareArchivedTasksByCompletedAt(left, right) {
+    const leftTime = left.completedAt ? Date.parse(left.completedAt) : Number.NEGATIVE_INFINITY;
+    const rightTime = right.completedAt ? Date.parse(right.completedAt) : Number.NEGATIVE_INFINITY;
     if (leftTime !== rightTime) {
         return leftTime - rightTime;
     }

package/dist/src/task-retention.js.map

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

package/dist/src/types.d.ts

@@ -87,6 +87,7 @@ export type PlanDocument = {
     templateId?: string;
     configOverride?: TemplateConfigOverride;
     status: PlanStatus;
+    completedAt?: string;
     goal: {
         text: string;
     };
@@ -371,10 +372,10 @@ export type TaskContext = {
     project: ProjectContext;
     taskName: string;
     taskDir: string;
-    metaPath: string;
-    meta: TaskMeta;
     activePlan: string;
     activePlanPath: string;
+    legacyMetaPath?: string;
+    legacyMeta?: TaskMeta;
 };
 export type ResolvedContext = {
     project: ProjectContext;
@@ -401,7 +402,6 @@ export type PlanWriteInput = {
 export type PlanWriteResult = {
     taskName: string;
     taskDir: string;
-    metaPath: string;
     planPath: string;
     planFile: string;
     planStatus: PlanStatus;
@@ -433,9 +433,12 @@ export type PlanEditInput = {
     taskStatus?: PlanTaskStatus;
     taskChoiceId?: string;
     appendTasks?: PlanTask[];
+    completeLifecycleBridge?: boolean;
+    commandSource?: "plan.edit" | "plan.start" | "plan.done";
     reviewer?: PlanReviewer;
     workflowDefinitions?: string;
     host?: string;
+    ownerSessionKey?: string;
 };
 export type PlanEditResult = {
     taskName: string;
@@ -449,6 +452,7 @@ export type PlanEditResult = {
     planReview?: PlanReviewResult;
     completionHooks?: PlanCompletionHooks;
     workflowGuidance: WorkflowGuidance;
+    plan: PlanDocument;
     planView: PlanViewModel;
 };
 export type PlanShowInput = {
@@ -475,8 +479,8 @@ export type SwitchTaskInput = {
 export type SwitchTaskResult = {
     fromTask: string;
     toTask: string;
-    sourceMetaPath: string;
-    targetMetaPath: string;
+    sourcePlanPath: string;
+    targetPlanPath?: string;
     leaveState: LeaveState;
 };
 export type MemoryScope = "project" | "task";
@@ -524,6 +528,12 @@ export type MemorySearchResult = {
     scope: MemoryScope;
     storePath: string;
     results: MemorySearchResultEntry[];
+    telemetry: {
+        route: "task_fts" | "lexical_fast_path" | "hybrid";
+        queryEmbedding: "skipped" | "cache_hit" | "generated";
+        embeddingRuntime?: "mock" | "persistent_daemon" | "one_shot" | "remote";
+        durationMs: number;
+    };
 };
 export type MemoryGetInput = {
     cwd: string;
@@ -574,7 +584,7 @@ export type ArchivedTaskRecord = {
     sourceTaskDir: string;
     archivedTaskDir: string;
     archivedPlanPath?: string;
-    updatedAt?: string;
+    completedAt?: string;
 };
 export type TaskRetentionResult = {
     enabled: boolean;

package/dist/src/workflow-guidance.config.json

@@ -3,6 +3,10 @@
     "withGoal": "Using claw-kit, update plan, follow returned workflowGuidance，finish your goal：{{planGoal}}",
     "withoutGoal": "Using claw-kit, update plan, follow returned workflowGuidance，finish your goal."
   },
+  "planCreateRecall": {
+    "nextstep": "Run one project recall query.",
+    "recommendedCommand": "claw search --query \"<topic>\""
+  },
   "delegates": {
     "truthWriter": {
       "name": "truth-writer",
@@ -24,7 +28,7 @@
       "fork_context": false,
       "waitForCompletion": false,
       "preferReuseSameTypeInThread": true,
-      "inputContract": "updated completed plan.json containing retrospective and durable keyDecisions; decision extraction and canonical target routing belong to the ADR writer",
+      "inputContract": "updated active root plan.json path after retrospective and durable keyDecisions are persisted; plan done retains this path for at least one hour so the ADR writer can continue asynchronously; decision extraction and canonical target routing belong to the ADR writer",
       "outputContract": "optional telemetry only",
       "closePolicy": "keep_open_for_reuse"
     }
@@ -131,9 +135,9 @@
       "nextsteps": [
         "1. Clear thread progress with `update_plan`.",
         "2. Read the returned `truth-writer` entry's `dispatch`. For `when_reusable_truth_confirmed`, the main agent must evaluate reusable truth and dispatch only after confirmation.",
-        "3. First write both `retrospective` and `keyDecisions` back into the plan, then execute the `adr-writer` contract with `dispatch: required` using that updated completed `plan.json`."
+        "3. First write both `retrospective` and `keyDecisions` back into the plan, then execute the `adr-writer` contract with `dispatch: required` using that updated active root `plan.json` path. Do not wait for the writer before running `claw plan done`; delayed archive keeps the path readable for at least one hour."
       ],
-      "notes": "Truth dispatch requires the main agent's reusable-value confirmation; ADR dispatch is required for root-plan closeout. Honor every field in a dispatched delegate contract.",
+      "notes": "Truth dispatch requires the main agent's reusable-value confirmation; ADR dispatch is required but remains asynchronous for root-plan closeout. Root `claw plan done` records completedAt and keeps the plan path readable for at least one hour. Honor every field in a dispatched delegate contract.",
       "recommendedCommands": [
         "{{editBase}} --patch <completed-plan.json>",
         "{{doneBase}} --summary \"<retrospective summary>\""
@@ -297,7 +301,7 @@
       ],
       "notes": "Use the seeded planning task to refine the request and append executable tasks before execution begins.",
       "recommendedCommands": [
-        "{{editBase}} --plan-status process.active"
+        "{{startBase}} --patch <plan-patch.json> --append-tasks <tasks.json>"
       ]
     },
     "process.discussing.noGoalMode": {

package/dist/src/workflow-guidance.d.ts

@@ -8,7 +8,7 @@ export declare function buildPlanWorkflowGuidance(params: {
     taskName: string;
     planFile: string;
     plan: PlanDocument;
-    commandSource?: "plan.create" | "subplan.create" | "plan.edit" | "plan.done";
+    commandSource?: "plan.create" | "subplan.create" | "plan.edit" | "plan.start" | "plan.done";
     projectRoot?: string;
     projectConfig?: ProjectConfig | null;
     previousStatus?: PlanStatus;