@veewo/claw-core 0.2.2 → 0.2.4

package/dist/src/resources/knowledge-writer/knowledge-format.md

@@ -1,47 +1,47 @@
-# Canonical knowledge evolution format
-
-Use this format for every new Truth or ADR document and every existing owner written by the current writer pass. Inspect the selected owner before writing and repair nonconforming structure in the same edit. Do not mass-rewrite untouched documents.
-
-## Document metadata
-
-Document kind is inferred from its canonical path: documents under `adr/` are ADRs; other documents under the Truth root are Truth documents. Do not add a document-kind field.
-
-Truth documents default to `current`. ADR documents default to `accepted`. When a different document state must be explicit, place a renderer-hidden generic comment immediately after the title:
-
-```markdown
-# ADR: Replaced decision
-
-<!-- document-state: superseded -->
-```
-
-Allowed document states are:
-
-- Truth: `current` or `historical`
-- ADR: `accepted`, `superseded`, or `historical`
-
-An ordinary leading `## Status` or `## 状态` section may also supply the document state. Do not emit tool-specific metadata names.
-
-## Current and evolution sections
-
-Use renderer-hidden, machine-stable ASCII comments before natural-language headings:
-
-```markdown
-<!-- state: current -->
-## Current behavior
-
-Current canonical content.
-
-<!-- state: history -->
-## Evolution history
-
-<!-- dated: 2026-07-20 -->
-### Replaced the earlier route
-
-The prior behavior and why it matters for rollback or repeated work.
-```
-
-For ADRs, the ordinary Context, Decision, Alternatives, and Consequences sections inherit the document state. Mark only retained decision evolution with `<!-- state: history -->`.
-
-Each `<!-- dated: YYYY-MM-DD -->` comment starts one complete evolution unit at the level-three heading that follows it. The unit extends to the next dated comment or the next level-two heading. The date is a stable checkpoint label and search signal, not a time-to-live value. Multiple checkpoints may use the same date. Their canonical evolution order is document order.
-
-Do not append an evolution unit for routine progress or every successful turn. Add one only when the former fact or decision remains useful for rollback, compatibility, feature repetition, incident reasoning, or understanding a meaningful transition.
+# Canonical knowledge evolution format
+
+Use this format for every new Truth or ADR document and every existing owner written by the current writer pass. Inspect the selected owner before writing and repair nonconforming structure in the same edit. Do not mass-rewrite untouched documents.
+
+## Document metadata
+
+Document kind is inferred from its canonical path: documents under `adr/` are ADRs; other documents under the Truth root are Truth documents. Do not add a document-kind field.
+
+Truth documents default to `current`. ADR documents default to `accepted`. When a different document state must be explicit, place a renderer-hidden generic comment immediately after the title:
+
+```markdown
+# ADR: Replaced decision
+
+<!-- document-state: superseded -->
+```
+
+Allowed document states are:
+
+- Truth: `current` or `historical`
+- ADR: `accepted`, `superseded`, or `historical`
+
+An ordinary leading `## Status` or `## 状态` section may also supply the document state. Do not emit tool-specific metadata names.
+
+## Current and evolution sections
+
+Use renderer-hidden, machine-stable ASCII comments before natural-language headings:
+
+```markdown
+<!-- state: current -->
+## Current behavior
+
+Current canonical content.
+
+<!-- state: history -->
+## Evolution history
+
+<!-- dated: 2026-07-20 -->
+### Replaced the earlier route
+
+The prior behavior and why it matters for rollback or repeated work.
+```
+
+For ADRs, the ordinary Context, Decision, Alternatives, and Consequences sections inherit the document state. Mark only retained decision evolution with `<!-- state: history -->`.
+
+Each `<!-- dated: YYYY-MM-DD -->` comment starts one complete evolution unit at the level-three heading that follows it. The unit extends to the next dated comment or the next level-two heading. The date is a stable checkpoint label and search signal, not a time-to-live value. Multiple checkpoints may use the same date. Their canonical evolution order is document order.
+
+Do not append an evolution unit for routine progress or every successful turn. Add one only when the former fact or decision remains useful for rollback, compatibility, feature repetition, incident reasoning, or understanding a meaningful transition.

package/dist/src/resources/knowledge-writer/non-claw-fallback.md

@@ -1,53 +1,53 @@
-# Knowledge writer fallback
-
-Act as the knowledge-base steward for the project. Leave the relevant Truth and ADR corpus accurate, coherent, and easy for future agents to trust.
-
-## Input and evidence boundary
-
-Read every supplied material completely. Interpret evidence from its content and semantics rather than requiring a particular filename, field, record shape, or serialization format. Extract executed conclusions, verified findings, retrospective lessons, key decisions, and other explicit outcomes wherever they appear. Do not repeat implementation or test verification or modify supplied materials.
-
-When task status is present, it helps interpret completed, pending, and blocked scope, but a task list is not an execution log. Infer execution results, verified findings, planning outcomes, and durable decisions from conclusion-bearing content; never turn task titles, descriptions, requirements, or intentions into completed results merely because they appear in an input.
-
-## Evidence freshness
-
-Trusted means the evidence was verified at the revision or worktree state it describes; it does not make an older report permanently authoritative for current behavior.
-
-- Before writing current behavior from a supplied conclusion, read the relevant implementation anchors and inspect later or overlapping working-tree changes. This is a freshness check, not repeated implementation verification; do not rerun tests merely to reconfirm the report.
-- When current implementation supersedes the report, current implementation owns current-state Truth and the report may only support historical or version-bound evidence.
-- If chronology or authority cannot be resolved safely, omit the affected canonical write and retain the freshness conflict as the reason.
-
-## Fixed deposition sequence
-
-Process the eligible evidence without a route choice:
-
-1. Maintain Truth for stable behavior, architecture facts, constraints, pitfalls, code anchors, and verification rules.
-2. Then maintain ADRs for durable decisions, context, rationale, alternatives, tradeoffs, ownership, and consequences, using the same evidence and resulting Truth state.
-3. Finally review Truth and ADR together for ownership and consistency.
-
-Use `knowledge-format.md` for every new document and every existing owner written by this pass. Inspect each selected owner before writing and repair nonconforming structure in the same edit; leave untouched documents unmigrated. Dated identifies an evolution checkpoint, not age or time-to-live.
-
-It is valid for either pass to make no edit when the eligible evidence contains no new or changed durable knowledge. Temporary progress, speculation, conversational narration, unchanged facts, and unfinished-task claims do not belong in canonical knowledge.
-
-## Stewardship and ownership
-
-Use `claw search` to discover existing owners, then open every plausible candidate before judging it. Use exhaustive text search for distinguishing identifiers when top-k recall could hide another current claim. Update the document that already owns the topic; create a new document only for a genuinely new durable topic after filename and title collision checks.
-
-Maintain one current owner for each material fact or decision. A broad or neighboring document is still a competing owner when it restates an unqualified current rule. Reconcile overlaps by extending the canonical owner and narrowing other current claims to references, historical evidence, or non-overlapping scope. Preserve unrelated user edits and repository conventions.
-
-Truth and ADR are one knowledge system: after both ordered passes, review the related documents together and resolve contradictions between current-state Truth, decision ownership, and consequences. Do not report completion while a material current claim remains inconsistent or ownerless.
-
-## Writing and verification
-
-- Follow the repository's language and document shape.
-- Preserve exact identifiers, config keys, commands, and error text.
-- Use project-relative paths in canonical documents.
-- Ground every fact, path, owner, and alternative in supplied or inspected evidence.
-- Label historical and superseded evidence explicitly; never silently promote it to current behavior.
-- Add dated evolution only for former facts or decisions that remain useful for rollback, compatibility, feature repetition, incident reasoning, or understanding a meaningful transition.
-- Repair every written Truth or ADR owner to the canonical format in `knowledge-format.md`; do not defer a discovered format mismatch.
-- Repair mojibake and preserve valid Markdown encoding.
-- Re-run focused and exhaustive searches after writing; every plausible hit must be the selected owner, an explicit reference, historical or version-bound evidence, or a narrowed non-overlapping claim.
-
-## Return
-
-Return a brief completion note with changed paths or the evidence-backed no-edit reasons. Response format is not part of the contract.
+# Knowledge writer fallback
+
+Act as the knowledge-base steward for the project. Leave the relevant Truth and ADR corpus accurate, coherent, and easy for future agents to trust.
+
+## Input and evidence boundary
+
+Read every supplied material completely. Interpret evidence from its content and semantics rather than requiring a particular filename, field, record shape, or serialization format. Extract executed conclusions, verified findings, retrospective lessons, key decisions, and other explicit outcomes wherever they appear. Do not repeat implementation or test verification or modify supplied materials.
+
+When task status is present, it helps interpret completed, pending, and blocked scope, but a task list is not an execution log. Infer execution results, verified findings, planning outcomes, and durable decisions from conclusion-bearing content; never turn task titles, descriptions, requirements, or intentions into completed results merely because they appear in an input.
+
+## Evidence freshness
+
+Trusted means the evidence was verified at the revision or worktree state it describes; it does not make an older report permanently authoritative for current behavior.
+
+- Before writing current behavior from a supplied conclusion, read the relevant implementation anchors and inspect later or overlapping working-tree changes. This is a freshness check, not repeated implementation verification; do not rerun tests merely to reconfirm the report.
+- When current implementation supersedes the report, current implementation owns current-state Truth and the report may only support historical or version-bound evidence.
+- If chronology or authority cannot be resolved safely, omit the affected canonical write and retain the freshness conflict as the reason.
+
+## Fixed deposition sequence
+
+Process the eligible evidence without a route choice:
+
+1. Maintain Truth for stable behavior, architecture facts, constraints, pitfalls, code anchors, and verification rules.
+2. Then maintain ADRs for durable decisions, context, rationale, alternatives, tradeoffs, ownership, and consequences, using the same evidence and resulting Truth state.
+3. Finally review Truth and ADR together for ownership and consistency.
+
+Use `knowledge-format.md` for every new document and every existing owner written by this pass. Inspect each selected owner before writing and repair nonconforming structure in the same edit; leave untouched documents unmigrated. Dated identifies an evolution checkpoint, not age or time-to-live.
+
+It is valid for either pass to make no edit when the eligible evidence contains no new or changed durable knowledge. Temporary progress, speculation, conversational narration, unchanged facts, and unfinished-task claims do not belong in canonical knowledge.
+
+## Stewardship and ownership
+
+Use `claw search` to discover existing owners, then open every plausible candidate before judging it. Use exhaustive text search for distinguishing identifiers when top-k recall could hide another current claim. Update the document that already owns the topic; create a new document only for a genuinely new durable topic after filename and title collision checks.
+
+Maintain one current owner for each material fact or decision. A broad or neighboring document is still a competing owner when it restates an unqualified current rule. Reconcile overlaps by extending the canonical owner and narrowing other current claims to references, historical evidence, or non-overlapping scope. Preserve unrelated user edits and repository conventions.
+
+Truth and ADR are one knowledge system: after both ordered passes, review the related documents together and resolve contradictions between current-state Truth, decision ownership, and consequences. Do not report completion while a material current claim remains inconsistent or ownerless.
+
+## Writing and verification
+
+- Follow the repository's language and document shape.
+- Preserve exact identifiers, config keys, commands, and error text.
+- Use project-relative paths in canonical documents.
+- Ground every fact, path, owner, and alternative in supplied or inspected evidence.
+- Label historical and superseded evidence explicitly; never silently promote it to current behavior.
+- Add dated evolution only for former facts or decisions that remain useful for rollback, compatibility, feature repetition, incident reasoning, or understanding a meaningful transition.
+- Repair every written Truth or ADR owner to the canonical format in `knowledge-format.md`; do not defer a discovered format mismatch.
+- Repair mojibake and preserve valid Markdown encoding.
+- Re-run focused and exhaustive searches after writing; every plausible hit must be the selected owner, an explicit reference, historical or version-bound evidence, or a narrowed non-overlapping claim.
+
+## Return
+
+Return a brief completion note with changed paths or the evidence-backed no-edit reasons. Response format is not part of the contract.

package/dist/src/session-bindings.d.ts

@@ -1,7 +1,8 @@
 import type { ProjectContext } from "./types.js";
+export declare const SESSION_BINDING_TTL_MS: number;
 export declare function sessionBindingRegistryPath(project: ProjectContext): string;
 export declare function bindSessionToPlan(project: ProjectContext, sessionKey: string | undefined, planPath: string): void;
 export declare function unbindSession(project: ProjectContext, sessionKey: string | undefined): void;
 /** Remove registry entries whose bound plan is no longer present under active tasks. */
-export declare function pruneStaleSessionBindings(project: ProjectContext): string[];
+export declare function pruneStaleSessionBindings(project: ProjectContext, nowMs?: number): string[];
 export declare function resolveSessionBoundPlan(project: ProjectContext, sessionKey: string | undefined): string | null;

package/dist/src/session-bindings.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { readJsonFile, withFileLock, writeJsonFile } from "./io.js";
 import { ensureInsideDir } from "./paths.js";
 const SESSION_SCOPE_BINDING_KEY = "$session";
+export const SESSION_BINDING_TTL_MS = 7 * 24 * 60 * 60 * 1000;
 export function sessionBindingRegistryPath(project) {
     return path.join(project.clawDir, "runtime", "session-bindings.json");
 }
@@ -26,8 +27,22 @@ export function unbindSession(project, sessionKey) {
     });
 }
 /** Remove registry entries whose bound plan is no longer present under active tasks. */
-export function pruneStaleSessionBindings(project) {
+export function pruneStaleSessionBindings(project, nowMs = Date.now()) {
     const removed = [];
+    const registryPath = sessionBindingRegistryPath(project);
+    if (fs.existsSync(registryPath)) {
+        try {
+            if (nowMs - fs.statSync(registryPath).mtimeMs >= SESSION_BINDING_TTL_MS) {
+                const registry = readRegistry(project);
+                removed.push(...Object.keys(registry.bindings));
+                fs.unlinkSync(registryPath);
+                return removed;
+            }
+        }
+        catch {
+            return removed;
+        }
+    }
     updateRegistry(project, (registry) => {
         for (const [key, relativePath] of Object.entries(registry.bindings)) {
             const normalizedRelative = typeof relativePath === "string" ? relativePath.replace(/\\/g, "/") : "";
@@ -58,6 +73,12 @@ export function resolveSessionBoundPlan(project, sessionKey) {
         unbindSession(project, normalizedKey);
         return null;
     }
+    try {
+        fs.utimesSync(sessionBindingRegistryPath(project), new Date(), new Date());
+    }
+    catch {
+        // Binding freshness is advisory; resolution remains valid.
+    }
     return planPath;
 }
 function bindingKey(project, sessionKey) {

package/dist/src/session-bindings.js.map

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

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

@@ -0,0 +1,13 @@
+import type { ProjectContext } from "./types.js";
+export type TaskLifecycleMaintenanceResult = {
+    archivedTasks: number;
+    prunedArchivedTasks: number;
+    expiredTaskDirectoriesRemoved: number;
+    emptyDatedDirectoriesRemoved: number;
+};
+/**
+ * Coordinates the task lifecycle without merging the policies themselves:
+ * archive eligibility, archive retention, and inactivity TTL are evaluated in
+ * that order so archived work gets a recovery window before final deletion.
+ */
+export declare function runTaskLifecycleMaintenance(project: ProjectContext, now: Date): TaskLifecycleMaintenanceResult;

package/dist/src/task-lifecycle.js

@@ -0,0 +1,142 @@
+import fs from "node:fs";
+import path from "node:path";
+import { readJsonFile } from "./io.js";
+import { listTaskDirectories } from "./context.js";
+import { enforceTaskRetention } from "./task-retention.js";
+const WORKFLOW_TASK_TTL_MS = 30 * 24 * 60 * 60 * 1000;
+/**
+ * Coordinates the task lifecycle without merging the policies themselves:
+ * archive eligibility, archive retention, and inactivity TTL are evaluated in
+ * that order so archived work gets a recovery window before final deletion.
+ */
+export function runTaskLifecycleMaintenance(project, now) {
+    const cutoffDate = previousLocalDate(now);
+    const archivedDatedTasks = archiveDatedTaskDirectoriesBefore(project, cutoffDate);
+    const archivedLegacyTasks = archiveLegacyTaskDirectoriesBefore(project, cutoffDate);
+    const retention = enforceTaskRetention(project, undefined, now.getTime(), {
+        includeDatedTasks: false,
+        includeLegacyTasks: false,
+    });
+    const expiredTaskDirectoriesRemoved = pruneExpiredTaskDirectories(project, now.getTime());
+    const emptyDatedDirectoriesRemoved = removeEmptyDatedTaskDirectories(project);
+    return {
+        archivedTasks: archivedDatedTasks + archivedLegacyTasks + retention.archivedTasks.length,
+        prunedArchivedTasks: retention.prunedArchivedTasks.length,
+        expiredTaskDirectoriesRemoved,
+        emptyDatedDirectoriesRemoved,
+    };
+}
+function pruneExpiredTaskDirectories(project, nowMs) {
+    let removed = 0;
+    for (const root of [project.tasksDir, path.join(project.clawDir, "archive", "tasks")]) {
+        for (const task of listTaskDirectories({ tasksDir: root })) {
+            const updatedAt = readPlanUpdatedAt(path.join(task.taskDir, "plan.json"));
+            if (updatedAt === null || nowMs - updatedAt < WORKFLOW_TASK_TTL_MS)
+                continue;
+            try {
+                fs.rmSync(task.taskDir, { recursive: true, force: true });
+                removed += 1;
+            }
+            catch {
+                // A locked or concurrently updated task is retried by the next pass.
+            }
+        }
+    }
+    return removed;
+}
+function removeEmptyDatedTaskDirectories(project) {
+    return [project.tasksDir, path.join(project.clawDir, "archive", "tasks")]
+        .reduce((removed, root) => removed + removeEmptyDatedDirectories(root), 0);
+}
+function removeEmptyDatedDirectories(root) {
+    if (!fs.existsSync(root))
+        return 0;
+    let removed = 0;
+    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+        if (!entry.isDirectory() || !/^\d{4}-\d{2}-\d{2}$/.test(entry.name))
+            continue;
+        const directory = path.join(root, entry.name);
+        if (fs.readdirSync(directory).length > 0)
+            continue;
+        fs.rmdirSync(directory);
+        removed += 1;
+    }
+    return removed;
+}
+function archiveDatedTaskDirectoriesBefore(project, cutoffDate) {
+    if (!fs.existsSync(project.tasksDir))
+        return 0;
+    const archiveRoot = path.join(project.clawDir, "archive", "tasks");
+    let archivedTaskCount = 0;
+    for (const entry of fs.readdirSync(project.tasksDir, { withFileTypes: true })) {
+        if (!entry.isDirectory() || !/^\d{4}-\d{2}-\d{2}$/.test(entry.name) || entry.name >= cutoffDate)
+            continue;
+        const sourceDateDir = path.join(project.tasksDir, entry.name);
+        const taskCount = fs.readdirSync(sourceDateDir, { withFileTypes: true }).filter((child) => child.isDirectory()).length;
+        moveDateDirectory(sourceDateDir, path.join(archiveRoot, entry.name));
+        archivedTaskCount += taskCount;
+    }
+    return archivedTaskCount;
+}
+function moveDateDirectory(sourceDateDir, targetDateDir) {
+    fs.mkdirSync(path.dirname(targetDateDir), { recursive: true });
+    if (!fs.existsSync(targetDateDir)) {
+        fs.renameSync(sourceDateDir, targetDateDir);
+        return;
+    }
+    for (const child of fs.readdirSync(sourceDateDir, { withFileTypes: true })) {
+        const source = path.join(sourceDateDir, child.name);
+        let target = path.join(targetDateDir, child.name);
+        let suffix = 1;
+        while (fs.existsSync(target)) {
+            target = path.join(targetDateDir, `${child.name}--${suffix}`);
+            suffix += 1;
+        }
+        fs.renameSync(source, target);
+    }
+    fs.rmdirSync(sourceDateDir);
+}
+function archiveLegacyTaskDirectoriesBefore(project, cutoffDate) {
+    const archiveRoot = path.join(project.clawDir, "archive", "tasks");
+    let archivedTaskCount = 0;
+    for (const task of listTaskDirectories(project)) {
+        if (/^\d{4}-\d{2}-\d{2}[\\/]/.test(task.relativePath))
+            continue;
+        const updatedAt = readPlanUpdatedAt(path.join(task.taskDir, "plan.json"));
+        if (!updatedAt || localDate(new Date(updatedAt)) >= cutoffDate)
+            continue;
+        moveDirectoryWithCollision(task.taskDir, path.join(archiveRoot, task.relativePath));
+        archivedTaskCount += 1;
+    }
+    return archivedTaskCount;
+}
+function readPlanUpdatedAt(planPath) {
+    if (!fs.existsSync(planPath))
+        return null;
+    try {
+        const plan = readJsonFile(planPath);
+        const timestamp = typeof plan.updatedAt === "string" ? Date.parse(plan.updatedAt) : Number.NaN;
+        return Number.isFinite(timestamp) ? timestamp : fs.statSync(planPath).mtimeMs;
+    }
+    catch {
+        return fs.statSync(planPath).mtimeMs;
+    }
+}
+function moveDirectoryWithCollision(sourceDir, targetDir) {
+    fs.mkdirSync(path.dirname(targetDir), { recursive: true });
+    let target = targetDir;
+    let suffix = 1;
+    while (fs.existsSync(target)) {
+        target = `${targetDir}--${suffix}`;
+        suffix += 1;
+    }
+    fs.renameSync(sourceDir, target);
+}
+function localDate(now) {
+    return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
+}
+function previousLocalDate(now) {
+    const previous = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
+    return localDate(previous);
+}
+//# sourceMappingURL=task-lifecycle.js.map

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

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

package/dist/src/templates/plans/default.js

@@ -1,6 +1,6 @@
 export const defaultPlanTemplate = {
     id: "default",
-    version: "0.2.2",
+    version: "0.2.4",
     status: "process.discussing",
     goal: {
         text: "",

package/dist/src/types.d.ts

@@ -148,7 +148,7 @@ export type WorkflowGuidanceGoalTool = {
     reason: string;
 };
 export type WorkflowGuidance = {
-    stage: "requirements" | "review" | "discussion" | "execution" | "done" | "deposition" | "paused";
+    stage: "requirements" | "review" | "discussion" | "execution" | "done" | "deposition" | "paused" | "left";
     summary: string;
     nextsteps: string[];
     nextTask?: {
@@ -251,6 +251,16 @@ export type PlanViewModel = {
         refreshOn: Array<"plan.write" | "plan.edit" | "plan.done">;
     };
 };
+export type SimplePlanView = {
+    status: PlanStatus;
+    goal: {
+        text: string;
+    };
+    tasks: Array<{
+        title: string;
+    }>;
+    rules: string[];
+};
 export type PlanReviewInput = {
     planContent: PlanDocument;
     isSubPlan: boolean;
@@ -393,6 +403,7 @@ export type PlanWriteInput = {
     content?: PlanDocument;
     parentTaskId?: number;
     parentPlanFile?: string;
+    deferParentMutation?: boolean;
     reviewer?: PlanReviewer;
     workflowDefinitions?: string;
     host?: string;
@@ -421,6 +432,11 @@ export type SubplanWriteInput = {
     templateFile?: string;
     ownerSessionKey?: string;
     host?: string;
+    /**
+     * Creates the child plan without writing the parent linkage. Session focus
+     * coordination uses this to journal parent linkage and focus as one commit.
+     */
+    deferParentMutation?: boolean;
 };
 export type PlanEditInput = {
     cwd: string;
@@ -442,6 +458,7 @@ export type PlanEditInput = {
     workflowDefinitions?: string;
     host?: string;
     ownerSessionKey?: string;
+    deferSubplanClosure?: boolean;
     operations?: PlanMutationOperation[];
 };
 export type PlanMutationOperation = {
@@ -530,6 +547,7 @@ export type PlanShowResult = {
     archived?: true;
     plan: PlanDocument;
     planView: PlanViewModel;
+    simplePlanView: SimplePlanView;
 };
 export type SwitchTaskInput = {
     cwd: string;