@co0ontty/wand 4.106.0 → 4.106.1

package/dist/storage/tasks-repository.js

@@ -1,4 +1,5 @@
 import crypto from "node:crypto";
+import { normalizeProjectCwd } from "../workspace-binding.js";
 import { assertTaskHierarchy } from "../task-hierarchy.js";
 import { TASK_RETENTION_ARCHIVE_VERSION } from "../task-retention.js";
 import { firstLayoutTabId } from "../layout-tree.js";
@@ -6,7 +7,7 @@ import { nowIso } from "../password-manager.js";
 import { isSessionProvider } from "../session-provider.js";
 import { isSystemAiCall } from "../system-ai-call.js";
 import { isThinkingEffort } from "../structured-provider-common.js";
-import { DEFAULT_ITERATION_NAME, DEFAULT_WAND_TASK_PRIORITY, isTaskExecutionSubject, normalizeWandTaskAgentMode } from "../task-types.js";
+import { DEFAULT_ITERATION_NAME, DEFAULT_WAND_TASK_PRIORITY, isTaskExecutionSubject, isWandTaskStatus, normalizeWandTaskAgentMode, taskAiVerified, taskHumanAccepted } from "../task-types.js";
 import { GLOBAL_WORKSPACE_ID } from "../types.js";
 import { safeJsonParse, mapWandMilestoneRow, mapIterationPromptRow } from "./mappers.js";
 import { parseWandTaskAgent } from "./mappers.js";
@@ -88,6 +89,8 @@ export class TaskRepository {
     mapWandTaskRow(row) {
         return {
             acceptance: safeJsonParse(String(row.acceptance_json ?? "null")),
+            verification: safeJsonParse(String(row.verification_json ?? "null")),
+            deliveryRevision: Number(row.delivery_revision) || 0,
             id: String(row.id),
             identifier: typeof row.identifier === "string" && row.identifier ? row.identifier : `TASK-${String(row.id).slice(0, 6)}`,
             workspaceId: typeof row.workspace_id === "string" ? row.workspace_id : null,
@@ -97,7 +100,7 @@ export class TaskRepository {
             titleSource: row.title_source === "auto" ? "auto" : "user",
             autoTitleSignature: typeof row.auto_title_signature === "string" && row.auto_title_signature ? row.auto_title_signature : null,
             description: String(row.description ?? ""),
-            status: row.status === "backlog" || row.status === "doing" || row.status === "done" || row.status === "archived" ? row.status : "todo",
+            status: isWandTaskStatus(row.status) ? row.status : "todo",
             priority: row.priority === "low" || row.priority === "medium" || row.priority === "high" || row.priority === "urgent" ? row.priority : "none",
             labels: (() => { const parsed = safeJsonParse(String(row.labels_json ?? "[]")); return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : []; })(),
             dueDate: typeof row.due_date === "string" ? row.due_date : null,
@@ -143,10 +146,13 @@ export class TaskRepository {
             .all();
         return new Map(rows.map(row => [row.task_id, Number(row.count) || 0]));
     }
+    isTaskReviewComment(id) {
+        return Boolean(this.db.prepare("SELECT 1 FROM wand_task_comment_dispatches WHERE comment_id = ? AND purpose = 'review' LIMIT 1").get(id));
+    }
     getWandTaskComment(id) {
         const row = this.db.prepare(`SELECT c.*, d.request_id, d.source_comment_id, d.employee_id, d.employee_name,
       d.instruction, d.task_version, d.state, d.session_id, d.error, d.execution_status, d.referenced_task_ids,
-      d.result_start_index, d.result_end_index, d.result_request_id, d.result_outcome, d.result_fingerprint, d.result_start_fingerprint FROM wand_task_comments c
+      d.result_start_index, d.result_end_index, d.result_request_id, d.result_outcome, d.result_fingerprint, d.result_start_fingerprint, d.purpose, d.review_revision FROM wand_task_comments c
       LEFT JOIN wand_task_comment_dispatches d ON d.comment_id = c.id WHERE c.id = ?`).get(id);
         return row ? this.mapWandTaskCommentRow(row) : null;
     }
@@ -158,7 +164,7 @@ export class TaskRepository {
         const placeholders = boundedIds.map(() => "?").join(", ");
         const rows = this.db.prepare(`SELECT c.*, d.request_id, d.source_comment_id, d.employee_id, d.employee_name,
       d.instruction, d.task_version, d.state, d.session_id, d.error, d.execution_status, d.referenced_task_ids,
-      d.result_start_index, d.result_end_index, d.result_request_id, d.result_outcome, d.result_fingerprint, d.result_start_fingerprint
+      d.result_start_index, d.result_end_index, d.result_request_id, d.result_outcome, d.result_fingerprint, d.result_start_fingerprint, d.purpose, d.review_revision
       FROM wand_task_comments c LEFT JOIN wand_task_comment_dispatches d ON d.comment_id = c.id
       WHERE c.task_id = ? AND c.id IN (${placeholders})`).all(taskId, ...boundedIds);
         const byId = new Map(rows.map(row => [row.id, this.mapWandTaskCommentRow(row)]));
@@ -167,6 +173,7 @@ export class TaskRepository {
     mapWandTaskCommentRow(row) {
         const referencedTaskIds = parseReferencedTaskIds(row.referenced_task_ids);
         return { id: row.id, taskId: row.task_id, authorName: row.author_name, body: row.body, createdAt: row.created_at,
+            purpose: row.purpose === "review" ? "review" : "execution", reviewRevision: row.review_revision == null ? null : Number(row.review_revision),
             ...(row.request_id ? { requestId: row.request_id, sourceCommentId: row.source_comment_id, instruction: row.instruction, taskVersion: row.task_version,
                 ...(referencedTaskIds.length ? { referencedTaskIds } : {}),
                 dispatch: row.employee_id ? { employeeId: row.employee_id, employeeName: row.employee_name,
@@ -190,8 +197,8 @@ export class TaskRepository {
             this.db.prepare(`INSERT INTO wand_task_comments(id, task_id, author_name, body, created_at) VALUES (?, ?, ?, ?, ?)`)
                 .run(id, input.taskId, "用户", input.body, nowIso());
             this.db.prepare(`INSERT INTO wand_task_comment_dispatches(comment_id, task_id, request_id, signature, source_comment_id,
-        employee_id, employee_name, instruction, task_version, state, referenced_task_ids, agent_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-                .run(id, input.taskId, input.requestId, input.signature, input.sourceCommentId, input.employeeId, input.employeeName, input.instruction, input.taskVersion, input.employeeId ? input.queued ? "queued" : "pending" : "accepted", JSON.stringify(input.referencedTaskIds ?? []), input.agent ? JSON.stringify(input.agent) : null);
+        employee_id, employee_name, instruction, task_version, state, referenced_task_ids, agent_json, purpose, review_revision) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(id, input.taskId, input.requestId, input.signature, input.sourceCommentId, input.employeeId, input.employeeName, input.instruction, input.taskVersion, input.employeeId ? input.queued ? "queued" : "pending" : "accepted", JSON.stringify(input.referencedTaskIds ?? []), input.agent ? JSON.stringify(input.agent) : null, input.purpose ?? "execution", input.reviewRevision ?? null);
             return this.getWandTaskComment(id);
         });
     }
@@ -456,8 +463,8 @@ export class TaskRepository {
       FROM wand_tasks WHERE identifier GLOB 'TASK-[0-9]*'`).get();
         try {
             this.db.prepare(`INSERT INTO wand_tasks (${WAND_TASK_FIELDS})
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-                .run(id, `TASK-${number.value + 1}`, input.workspaceId ?? null, input.workspaceTaskId ?? null, input.parentTaskId ?? null, input.title, input.titleSource ?? "user", null, input.description ?? "", status, input.priority ?? DEFAULT_WAND_TASK_PRIORITY, JSON.stringify(input.labels ?? []), input.dueDate ?? null, input.milestoneId ?? null, max.value + 1, input.agent ? JSON.stringify(input.agent) : null, input.executionSubject ? JSON.stringify(input.executionSubject) : null, archivedAt, createdAtValue, createdAtValue, input.acceptance ? JSON.stringify(input.acceptance) : null);
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(id, `TASK-${number.value + 1}`, input.workspaceId ?? null, input.workspaceTaskId ?? null, input.parentTaskId ?? null, input.title, input.titleSource ?? "user", null, input.description ?? "", status, input.priority ?? DEFAULT_WAND_TASK_PRIORITY, JSON.stringify(input.labels ?? []), input.dueDate ?? null, input.milestoneId ?? null, max.value + 1, input.agent ? JSON.stringify(input.agent) : null, input.executionSubject ? JSON.stringify(input.executionSubject) : null, archivedAt, createdAtValue, createdAtValue, input.acceptance ? JSON.stringify(input.acceptance) : null, null, 0);
         }
         catch (error) {
             if (input.workspaceTaskId && this.getWandTaskByWorkspaceTaskId(input.workspaceTaskId)) {
@@ -471,8 +478,12 @@ export class TaskRepository {
         }
         if (input.parentTaskId) {
             const parent = this.getWandTask(input.parentTaskId);
-            if (parent?.acceptance?.acceptedAt)
-                this.writeWandTask(parent, { acceptance: { ...parent.acceptance, acceptedAt: null } });
+            if (parent && (parent.verification || parent.acceptance?.acceptedAt))
+                this.writeWandTask(parent, {
+                    deliveryRevision: (parent.deliveryRevision ?? 0) + 1, verification: null,
+                    ...(parent.acceptance ? { acceptance: { ...parent.acceptance, acceptedAt: null, confirmedRevision: undefined } } : {}),
+                    ...(parent.status === "ready" || parent.status === "review" ? { status: "doing" } : {}),
+                }, true);
         }
         this.s.notifyTaskTitleChange();
         return this.getWandTask(id);
@@ -480,12 +491,20 @@ export class TaskRepository {
     createWandTask(input) {
         return this.s.transaction(() => {
             const linked = input.workspaceTaskId ? this.s.getWorkspaceTask(input.workspaceTaskId) : null;
-            const workspaceId = input.workspaceId === undefined && linked
+            let workspaceId = input.workspaceId === undefined && linked
                 ? linked.workspaceId === GLOBAL_WORKSPACE_ID ? null : linked.workspaceId
                 : input.workspaceId ?? null;
-            const workspace = workspaceId ? this.s.getWorkspace(workspaceId) : this.s.ensureGlobalWorkspace();
+            let workspace = workspaceId ? this.s.getWorkspace(workspaceId) : this.s.ensureGlobalWorkspace();
             if (!workspace)
                 throw new Error("任务所属工作区不存在。");
+            if (input.cwd && (!workspaceId || workspace.id === GLOBAL_WORKSPACE_ID)) {
+                const normalized = normalizeProjectCwd(input.cwd);
+                const match = this.s.listWorkspaces().find(w => w.id !== GLOBAL_WORKSPACE_ID && normalizeProjectCwd(w.cwd) === normalized);
+                if (match) {
+                    workspace = match;
+                    workspaceId = match.id;
+                }
+            }
             const milestoneId = this.s.taskMilestoneForWrite(input.milestoneId, workspaceId);
             if (input.workspaceTaskId) {
                 const container = this.s.getWorkspaceTask(input.workspaceTaskId);
@@ -498,23 +517,41 @@ export class TaskRepository {
             }
             const workspaceTaskId = input.workspaceTaskId ?? this.s.insertWorkspaceTask({
                 workspaceId: workspace.id, name: input.title,
-                status: input.status === "done" || input.status === "archived" ? "done" : "active",
+                status: input.status === "archived" ? "done" : "active",
                 milestoneId,
+                cwd: input.cwd ?? null,
             });
             return this.insertWandTask({ ...input, workspaceId, workspaceTaskId, milestoneId });
         });
     }
     /** Private canonical writer; callers own the transaction, never a reverse writer. */
-    writeWandTask(current, patch) {
-        const next = { ...current, ...patch, updatedAt: nowIso() };
+    writeWandTask(current, patch, workflow = false) {
+        const next = { ...current, ...patch, updatedAt: new Date(Math.max(Date.now(), (Date.parse(current.updatedAt) || 0) + 1)).toISOString() };
+        const deliveryChanged = patch.description !== undefined && patch.description !== current.description
+            || patch.parentTaskId !== undefined && patch.parentTaskId !== current.parentTaskId
+            || patch.workspaceId !== undefined && patch.workspaceId !== current.workspaceId
+            || patch.acceptance !== undefined && (patch.acceptance?.evidence !== current.acceptance?.evidence || patch.acceptance?.blocker !== current.acceptance?.blocker)
+            || patch.status !== undefined && ["backlog", "todo", "doing"].includes(patch.status) && patch.status !== current.status && ["ready", "review", "done", "archived"].includes(current.status);
+        if (!workflow && deliveryChanged) {
+            next.deliveryRevision = (current.deliveryRevision ?? 0) + 1;
+            next.verification = null;
+            if (next.acceptance)
+                next.acceptance = { ...next.acceptance, acceptedAt: null, confirmedRevision: undefined };
+            if (next.status === "ready" || next.status === "review")
+                next.status = "doing";
+        }
+        if (next.status === "ready" && !taskAiVerified(next))
+            throw new Error("待归档需要当前交付的 AI 验收记录，请走验收工作流。");
+        if (!workflow && next.status !== current.status && next.status === "archived" && !taskHumanAccepted(current))
+            throw new Error("请先经 AI 验收，再由人工确认并归档。");
+        if (!workflow && patch.acceptance?.acceptedAt && patch.acceptance.acceptedAt !== current.acceptance?.acceptedAt)
+            throw new Error("人工确认只能通过验收工作流写入。");
         assertTaskHierarchy(this.listWandTasks(), current.id, next.parentTaskId, next.workspaceId, current);
-        if (next.acceptance?.acceptedAt) {
-            if (patch.description !== undefined && patch.description !== current.description)
-                next.acceptance = { ...next.acceptance, acceptedAt: null };
-            else if (!next.acceptance.evidence.trim() || next.acceptance.blocker.trim())
-                throw new Error("验收通过需要交付证据，并先解除阻塞。");
-            else if (this.listWandTasks().some(child => child.parentTaskId === current.id && !child.acceptance?.acceptedAt))
-                throw new Error("仍有子任务未验收通过，不能通过主目标整体验收。");
+        if (taskHumanAccepted(next)) {
+            if (!next.acceptance.evidence.trim() || next.acceptance.blocker.trim())
+                throw new Error("人工确认需要交付证据，并先解除阻塞。");
+            if (this.listWandTaskChildren(current.id).some(child => !taskHumanAccepted(child)))
+                throw new Error("仍有子任务未由人工确认。");
         }
         // 归档时间只在进入归档时写一次；取消归档/重新打开时清空，恢复“未动多久”重新计时。
         if (next.status === "archived") {
@@ -544,15 +581,15 @@ export class TaskRepository {
                 throw new Error("任务所属工作区不存在。");
             next.workspaceTaskId = this.s.insertWorkspaceTask({
                 workspaceId: workspace.id, name: next.title, milestoneId: next.milestoneId,
-                status: next.status === "done" ? "done" : "active", createdAt: next.createdAt,
+                status: "active", createdAt: next.createdAt,
             });
         }
         this.db.prepare(`UPDATE wand_tasks SET workspace_id = ?, workspace_task_id = ?, parent_task_id = ?,
       title = ?, title_source = ?, auto_title_signature = ?, description = ?, status = ?, priority = ?,
       labels_json = ?, due_date = ?, milestone_id = ?, sort_order = ?, agent_json = ?, execution_subject_json = ?,
-      archived_at = ?, updated_at = ?, acceptance_json = ?
+      archived_at = ?, updated_at = ?, acceptance_json = ?, verification_json = ?, delivery_revision = ?
       WHERE id = ?`)
-            .run(next.workspaceId, next.workspaceTaskId, next.parentTaskId, next.title, next.titleSource, next.autoTitleSignature ?? null, next.description, next.status, next.priority, JSON.stringify(next.labels), next.dueDate, next.milestoneId ?? null, next.sortOrder, next.agent ? JSON.stringify(next.agent) : null, next.executionSubject ? JSON.stringify(next.executionSubject) : null, next.archivedAt, next.updatedAt, next.acceptance ? JSON.stringify(next.acceptance) : null, next.id);
+            .run(next.workspaceId, next.workspaceTaskId, next.parentTaskId, next.title, next.titleSource, next.autoTitleSignature ?? null, next.description, next.status, next.priority, JSON.stringify(next.labels), next.dueDate, next.milestoneId ?? null, next.sortOrder, next.agent ? JSON.stringify(next.agent) : null, next.executionSubject ? JSON.stringify(next.executionSubject) : null, next.archivedAt, next.updatedAt, next.acceptance ? JSON.stringify(next.acceptance) : null, next.verification ? JSON.stringify(next.verification) : null, next.deliveryRevision ?? 0, next.id);
         // Only a real transition may opt into the new policy. Editing/backfilling an old archive must not do so.
         if (next.status !== current.status) {
             this.db.prepare("UPDATE wand_tasks SET retention_archive_version = ? WHERE id = ?")
@@ -566,11 +603,18 @@ export class TaskRepository {
             this.db.prepare("UPDATE command_sessions SET workspace_id = ? WHERE workspace_task_id = ?")
                 .run(workspaceId, next.workspaceTaskId);
         }
-        if ((patch.acceptance !== undefined || patch.description !== undefined || patch.parentTaskId !== undefined) && next.parentTaskId) {
-            const parent = this.getWandTask(next.parentTaskId);
-            if (parent?.acceptance?.acceptedAt)
-                this.writeWandTask(parent, { acceptance: { ...parent.acceptance, acceptedAt: null } });
-        }
+        if (deliveryChanged || patch.parentTaskId !== undefined && patch.parentTaskId !== current.parentTaskId || patch.deliveryRevision !== undefined && patch.deliveryRevision !== current.deliveryRevision
+            || patch.verification !== undefined && !taskAiVerified(next)
+            || patch.acceptance !== undefined && taskHumanAccepted(current) && !taskHumanAccepted(next))
+            for (const parentId of new Set([current.parentTaskId, next.parentTaskId].filter((id) => Boolean(id)))) {
+                const parent = this.getWandTask(parentId);
+                if (parent && (parent.verification || parent.acceptance?.acceptedAt))
+                    this.writeWandTask(parent, {
+                        deliveryRevision: (parent.deliveryRevision ?? 0) + 1, verification: null,
+                        ...(parent.acceptance ? { acceptance: { ...parent.acceptance, acceptedAt: null, confirmedRevision: undefined } } : {}),
+                        ...(parent.status === "ready" || parent.status === "review" ? { status: "doing" } : {}),
+                    }, true);
+            }
         this.s.notifyTaskTitleChange();
         return next;
     }
@@ -582,6 +626,18 @@ export class TaskRepository {
             return this.writeWandTask(current, patch);
         });
     }
+    /** Explicit destructive project removal collects history, never claims delivery acceptance. */
+    archiveTaskForWorkspaceRemoval(id) {
+        return this.s.transaction(() => {
+            const current = this.getWandTask(id);
+            if (!current)
+                return null;
+            const task = this.writeWandTask(current, { status: "archived", workspaceTaskId: null }, true);
+            this.db.prepare("INSERT INTO wand_task_comments(id, task_id, author_name, body, created_at) VALUES (?, ?, ?, ?, ?)")
+                .run(crypto.randomUUID(), id, "项目移除", "项目被明确删除，仅收纳原任务与历史；这不是 AI 验收或人工接受交付。", task.updatedAt);
+            return task;
+        });
+    }
     /** Commit completion archives only the selected completed cards, atomically. */
     archiveCompletedWandTasks(ids) {
         return this.archiveWandTasks(ids, { completedOnly: true });
@@ -597,7 +653,9 @@ export class TaskRepository {
                 const task = this.getWandTask(id);
                 if (!task || task.status === "archived")
                     continue;
-                if (options.completedOnly && task.status !== "done")
+                if (options.completedOnly && !taskHumanAccepted(task))
+                    continue;
+                if (!taskHumanAccepted(task))
                     continue;
                 this.writeWandTask(task, { status: "archived" });
                 archived.push(id);
@@ -851,6 +909,8 @@ export class TaskRepository {
             const target = taskId ? this.s.getWorkspaceTask(taskId) : null;
             if (taskId && !target)
                 throw new Error("未找到目标任务。");
+            if (target?.archived)
+                throw new Error("目标已归档，请先恢复后再移入会话。");
             if (target && !this.s.getWorkspace(target.workspaceId))
                 throw new Error("目标工作区不存在。");
             const source = session.workspaceTaskId ? this.s.getWorkspaceTask(session.workspaceTaskId) : null;
@@ -862,16 +922,16 @@ export class TaskRepository {
                 this.s.saveWorkspaceTaskLayout(source.id, { ...source.layout, windows });
             }
             const targetCard = target ? this.getWandTaskByWorkspaceTaskId(target.id) : null;
-            if (target && !targetCard)
+            if (target && target.kind !== "section" && !targetCard)
                 throw new Error("未找到目标任务。");
             this.db.prepare("DELETE FROM wand_task_sessions WHERE session_id = ? AND (? IS NULL OR task_id != ?)")
                 .run(sessionId, targetCard?.id ?? null, targetCard?.id ?? null);
             this.db.prepare("UPDATE command_sessions SET workspace_task_id = ?, workspace_id = ? WHERE id = ?")
                 .run(target?.id ?? null, target?.workspaceId ?? session.workspaceId ?? null, sessionId);
-            if (target) {
+            if (targetCard) {
                 this.db.prepare("INSERT OR IGNORE INTO wand_task_sessions (task_id, session_id, bound_at) VALUES (?, ?, ?)")
                     .run(targetCard.id, sessionId, nowIso());
-                if (source?.id !== target.id)
+                if (source?.id !== target?.id)
                     this.recordTaskSession(this.s.getSessionSlim(sessionId));
             }
         });

package/dist/storage/workspaces-repository.d.ts

@@ -62,6 +62,13 @@ export declare class WorkspaceRepository {
         createdAt?: string;
     }): string;
     taskMilestoneForWrite(id: string | null | undefined, workspaceId: string | null): string;
+    /** A user-named session container; deliberately has no task-board card. */
+    createWorkspaceSection(input: {
+        workspaceId: string;
+        name: string;
+        cwd?: string;
+        sessionId?: string;
+    }): WorkspaceTask;
     createWorkspaceTask(input: {
         workspaceId: string;
         name: string;

package/dist/storage/workspaces-repository.js

@@ -242,6 +242,21 @@ export class WorkspaceRepository {
         return workspaceId && milestone.workspaceId && milestone.workspaceId !== workspaceId
             ? this.s.ensureDefaultWandMilestone().id : id;
     }
+    /** A user-named session container; deliberately has no task-board card. */
+    createWorkspaceSection(input) {
+        return this.s.transaction(() => {
+            if (!this.getWorkspace(input.workspaceId))
+                throw new Error("分区所属工作区不存在。");
+            const name = input.name.trim();
+            if (!name || name.length > 80)
+                throw new Error("请输入 1–80 字的分区名称。");
+            const id = this.insertWorkspaceTask({ ...input, name });
+            this.db.prepare("UPDATE workspace_tasks SET container_kind = 'section' WHERE id = ?").run(id);
+            if (input.sessionId)
+                this.s.moveSessionToWorkspaceTask(input.sessionId, id);
+            return this.getWorkspaceTask(id);
+        });
+    }
     createWorkspaceTask(input) {
         return this.s.transaction(() => {
             const workspace = this.getWorkspace(input.workspaceId);
@@ -263,8 +278,16 @@ export class WorkspaceRepository {
     updateWorkspaceTask(id, patch) {
         this.s.transaction(() => {
             const card = this.s.getWandTaskByWorkspaceTaskId(id);
-            if (!card)
-                throw new Error("未找到该任务。");
+            if (!card) {
+                const container = this.getWorkspaceTask(id);
+                if (container?.kind !== "section")
+                    throw new Error("未找到该任务。");
+                if (patch.name !== undefined)
+                    this.db.prepare("UPDATE workspace_tasks SET name = ? WHERE id = ?").run(patch.name, id);
+                if (patch.status !== undefined)
+                    this.db.prepare("UPDATE workspace_tasks SET status = ? WHERE id = ?").run(patch.status, id);
+                return;
+            }
             if (patch.worktree !== undefined) {
                 this.db.prepare("UPDATE workspace_tasks SET worktree_json = ? WHERE id = ?")
                     .run(patch.worktree ? JSON.stringify(patch.worktree) : null, id);
@@ -286,6 +309,9 @@ export class WorkspaceRepository {
     }
     archiveWorkspaceTask(id) {
         const card = this.s.getWandTaskByWorkspaceTaskId(id);
+        if (!card && this.getWorkspaceTask(id)?.kind === "section") {
+            throw new Error("分区不需要归档，请将会话移回工作区后删除空分区。");
+        }
         return card ? this.s.updateWandTask(card.id, { status: "archived" }) : null;
     }
     saveWorkspaceTaskLayout(id, layout, expectedRevision) {

package/dist/storage-cleanup.d.ts

@@ -1,5 +1,6 @@
 import { type TempKind } from "./managed-temp.js";
 import type { UploadRepository } from "./storage/uploads-repository.js";
+import type { PtyTmuxGcReport } from "./pty-tmux-backend.js";
 export declare const STORAGE_CLEANUP_RETENTION_DAYS = 7;
 export interface CleanupReport {
     applied: boolean;
@@ -11,7 +12,7 @@ export interface CleanupReport {
     allocatedBytes: number;
     skipped: number;
     issues: string[];
-    byKind: Partial<Record<TempKind | "upload" | "diagnostic-log" | "distribution-package" | "native-run" | "migration-snapshot", number>>;
+    byKind: Partial<Record<TempKind | "upload" | "diagnostic-log" | "distribution-package" | "native-run" | "migration-snapshot" | "pty-tmux", number>>;
 }
 /** pi-native 回收结果（与 PiTmuxHost.collectGarbage 的返回一致）。 */
 export interface PiNativeGcReport {
@@ -52,6 +53,10 @@ interface CleanupOptions {
         deleted: string[];
         freedBytes: number;
     };
+    /**
+     * 回收 pty-tmux 下废弃的会话记录与 /tmp 遗留的失效 socket。
+     */
+    collectPtyTmuxArtifacts?: () => PtyTmuxGcReport | null;
 }
 /** Runtime-only, explicit ownership. User history, downloads and rollback inputs are never candidates. */
 export declare class StorageCleanup {
@@ -81,5 +86,5 @@ export declare class StorageCleanup {
     private sweepDistributionArtifacts;
     private sweepTemporary;
 }
-export declare function createStorageCleanup(configDir: string, options?: Pick<CleanupOptions, "uploads" | "uploadsActive" | "onUploadRemoved" | "pruneDistributionArtifacts" | "collectNativeArtifacts" | "pruneMigrationSnapshots">): StorageCleanup;
+export declare function createStorageCleanup(configDir: string, options?: Pick<CleanupOptions, "uploads" | "uploadsActive" | "onUploadRemoved" | "pruneDistributionArtifacts" | "collectNativeArtifacts" | "pruneMigrationSnapshots" | "collectPtyTmuxArtifacts">): StorageCleanup;
 export {};

package/dist/storage-cleanup.js

@@ -268,6 +268,22 @@ export class StorageCleanup {
                 report.issues.push("Migration snapshot cleanup failed; snapshots preserved.");
             }
         }
+        if (this.options.collectPtyTmuxArtifacts) {
+            try {
+                const ptyReport = this.options.collectPtyTmuxArtifacts();
+                const removed = (ptyReport?.removedRecords ?? 0) + (ptyReport?.removedSockets ?? 0);
+                if (ptyReport && removed > 0) {
+                    report.removed += removed;
+                    report.logicalBytes += ptyReport.freedBytes;
+                    report.byKind["pty-tmux"] = removed;
+                    detail.push(`PTY tmux 产物 ${removed} 项（${(ptyReport.freedBytes / 1024 / 1024).toFixed(1)} MB）`
+                        + `：记录 ${ptyReport.removedRecords} 条 / socket ${ptyReport.removedSockets} 个`);
+                }
+            }
+            catch {
+                report.issues.push("PTY tmux artifact cleanup failed; artifacts preserved.");
+            }
+        }
         // 后台删除必须留痕迹：这些路径不是用户主动触发，没有日志就无法事后追溯删了什么。
         if (detail.length > 0)
             process.stdout.write(`[storage-cleanup] 已回收 ${detail.join("；")}\n`);

package/dist/storage-schema.js

@@ -259,6 +259,8 @@ const INIT_SQL = `
     agent_json TEXT,
     execution_subject_json TEXT,
     acceptance_json TEXT,
+    verification_json TEXT,
+    delivery_revision INTEGER NOT NULL DEFAULT 0,
     workspace_task_id TEXT,
     parent_task_id TEXT,
     title_source TEXT,

package/dist/storage.d.ts

@@ -10,6 +10,7 @@ import { ConversationOrganizationRepository } from "./storage/conversation-organ
 import { PreferencesRepository } from "./storage/preferences-repository.js";
 import { WorkspaceRepository } from "./storage/workspaces-repository.js";
 import { TaskRepository } from "./storage/tasks-repository.js";
+import { TaskWorkflowRepository } from "./storage/task-workflow-repository.js";
 import { SecretsRepository } from "./storage/secrets-repository.js";
 import { KnowledgeRepository } from "./storage/knowledge-repository.js";
 import { EmployeeRepository } from "./storage/employees-repository.js";
@@ -17,6 +18,7 @@ import { UserMemoryRepository } from "./storage/user-memory-repository.js";
 import { AiTeamRepository } from "./storage/ai-teams-repository.js";
 import { MissionRepository } from "./storage/missions-repository.js";
 import { SessionRepository } from "./storage/sessions-repository.js";
+import { SessionInputRepository } from "./storage/session-input-repository.js";
 import { UploadRepository } from "./storage/uploads-repository.js";
 import { FeedbackRepository } from "./storage/feedback-repository.js";
 export { parseWandTaskAgent };
@@ -26,7 +28,7 @@ export { ensureDatabaseFile } from "./storage-schema.js";
 type RepositoryMethods<T> = Pick<T, {
     [K in keyof T]: T[K] extends (...args: never[]) => unknown ? K : never;
 }[keyof T]>;
-export interface WandStorage extends RepositoryMethods<DingTalkRepository>, RepositoryMethods<ConversationRepository>, RepositoryMethods<ConversationOrganizationRepository>, RepositoryMethods<PreferencesRepository>, RepositoryMethods<WorkspaceRepository>, RepositoryMethods<TaskRepository>, RepositoryMethods<SecretsRepository>, RepositoryMethods<EmployeeRepository>, RepositoryMethods<KnowledgeRepository>, RepositoryMethods<UserMemoryRepository>, RepositoryMethods<AiTeamRepository>, RepositoryMethods<MissionRepository>, RepositoryMethods<SessionRepository>, RepositoryMethods<UploadRepository>, RepositoryMethods<FeedbackRepository> {
+export interface WandStorage extends RepositoryMethods<DingTalkRepository>, RepositoryMethods<ConversationRepository>, RepositoryMethods<ConversationOrganizationRepository>, RepositoryMethods<PreferencesRepository>, RepositoryMethods<WorkspaceRepository>, RepositoryMethods<TaskRepository>, RepositoryMethods<TaskWorkflowRepository>, RepositoryMethods<SecretsRepository>, RepositoryMethods<EmployeeRepository>, RepositoryMethods<KnowledgeRepository>, RepositoryMethods<UserMemoryRepository>, RepositoryMethods<AiTeamRepository>, RepositoryMethods<MissionRepository>, RepositoryMethods<SessionRepository>, RepositoryMethods<SessionInputRepository>, RepositoryMethods<UploadRepository>, RepositoryMethods<FeedbackRepository> {
 }
 export declare class WandStorage {
     readonly dingtalk: DingTalkRepository;
@@ -37,6 +39,7 @@ export declare class WandStorage {
     readonly preferences: PreferencesRepository;
     readonly workspaces: WorkspaceRepository;
     readonly tasks: TaskRepository;
+    readonly taskWorkflow: TaskWorkflowRepository;
     readonly secrets: SecretsRepository;
     readonly employees: EmployeeRepository;
     readonly knowledge: KnowledgeRepository;
@@ -44,6 +47,7 @@ export declare class WandStorage {
     readonly aiTeams: AiTeamRepository;
     readonly missions: MissionRepository;
     readonly sessions: SessionRepository;
+    readonly sessionInputs: SessionInputRepository;
     readonly uploads: UploadRepository;
     readonly feedback: FeedbackRepository;
     private readonly closeListeners;

package/dist/storage.js

@@ -13,6 +13,7 @@ import { ConversationOrganizationRepository } from "./storage/conversation-organ
 import { PreferencesRepository } from "./storage/preferences-repository.js";
 import { WorkspaceRepository } from "./storage/workspaces-repository.js";
 import { TaskRepository } from "./storage/tasks-repository.js";
+import { TaskWorkflowRepository } from "./storage/task-workflow-repository.js";
 import { SecretsRepository } from "./storage/secrets-repository.js";
 import { KnowledgeRepository } from "./storage/knowledge-repository.js";
 import { EmployeeRepository } from "./storage/employees-repository.js";
@@ -20,6 +21,7 @@ import { UserMemoryRepository } from "./storage/user-memory-repository.js";
 import { AiTeamRepository } from "./storage/ai-teams-repository.js";
 import { MissionRepository } from "./storage/missions-repository.js";
 import { SessionRepository } from "./storage/sessions-repository.js";
+import { SessionInputRepository } from "./storage/session-input-repository.js";
 import { UploadRepository } from "./storage/uploads-repository.js";
 import { FeedbackRepository } from "./storage/feedback-repository.js";
 export { parseWandTaskAgent };
@@ -33,6 +35,7 @@ export class WandStorage {
     preferences;
     workspaces;
     tasks;
+    taskWorkflow;
     secrets;
     employees;
     knowledge;
@@ -40,6 +43,7 @@ export class WandStorage {
     aiTeams;
     missions;
     sessions;
+    sessionInputs;
     uploads;
     feedback;
     closeListeners = new Set();
@@ -54,6 +58,10 @@ export class WandStorage {
         return `${this.projectionEpoch}:${own.revision}:${external.data_version}`;
     }
     onClose(listener) {
+        if (this.closed) {
+            listener();
+            return () => { };
+        }
         this.closeListeners.add(listener);
         return () => { this.closeListeners.delete(listener); };
     }
@@ -100,6 +108,7 @@ export class WandStorage {
         this.preferences = new PreferencesRepository(this.db, this);
         this.workspaces = new WorkspaceRepository(this.db, this);
         this.tasks = new TaskRepository(this.db, this);
+        this.taskWorkflow = new TaskWorkflowRepository(this.db, this);
         this.secrets = new SecretsRepository(this.db, this);
         this.employees = new EmployeeRepository(this.db, this);
         this.knowledge = new KnowledgeRepository(this.db, this);
@@ -107,6 +116,7 @@ export class WandStorage {
         this.aiTeams = new AiTeamRepository(this.db, this);
         this.missions = new MissionRepository(this.db, this);
         this.sessions = new SessionRepository(this.db, this);
+        this.sessionInputs = new SessionInputRepository(this.db, this);
         this.uploads = new UploadRepository(this.db, this);
         this.feedback = new FeedbackRepository(this.db, this);
         this.schedules = new ScheduledTaskRepository(this.db, action => this.transaction(action));
@@ -256,6 +266,7 @@ const REPOSITORY_FORWARDS = [
     ["preferences", PreferencesRepository],
     ["workspaces", WorkspaceRepository],
     ["tasks", TaskRepository],
+    ["taskWorkflow", TaskWorkflowRepository],
     ["secrets", SecretsRepository],
     ["employees", EmployeeRepository],
     ["knowledge", KnowledgeRepository],
@@ -263,6 +274,7 @@ const REPOSITORY_FORWARDS = [
     ["aiTeams", AiTeamRepository],
     ["missions", MissionRepository],
     ["sessions", SessionRepository],
+    ["sessionInputs", SessionInputRepository],
     ["uploads", UploadRepository],
     ["feedback", FeedbackRepository],
 ];

package/dist/structured-exec-host.d.ts

@@ -16,6 +16,7 @@ export interface StructuredSpawnRequest {
     stdinData?: string;
     /** Internal opt-in: a real Pi native TUI in an owned tmux pane. Never supplied by HTTP command text. */
     nativePi?: boolean;
+    nativeInputMessageId?: string;
     requestId?: string;
     /** Native launch cancellation before input has been accepted; not sent to daemon RPCs. */
     launchSignal?: AbortSignal;
@@ -70,8 +71,11 @@ export interface StructuredExecProcess {
 export interface StructuredExecHost {
     readonly persistent: boolean;
     readonly piNativeTui?: boolean;
+    offerPiInput?(runId: string, boundaryId: string, take: (identity: import("./pi-native-input.js").PiInputHandoff) => string | null): boolean;
+    resolvePiInput?(runId: string, handoff: import("./pi-native-input.js").PiInputHandoff): import("./pi-native-input.js").PiInputResolution;
     collectGarbage?(options: {
         liveSessionIds: ReadonlySet<string>;
+        activeSessionIds?: ReadonlySet<string>;
         retentionMs: number;
         now?: number;
     }): {

package/dist/structured-exec-pump.d.ts

@@ -31,6 +31,7 @@ export interface StructuredCliPumpOptions<S extends StructuredRunnerTurnState> {
     /** Pi opts in: stdout is captured to a private file; only file reads feed processLine. */
     stdoutFile?: PiOutputFileOptions;
     nativePi?: boolean;
+    nativeInputMessageId?: string;
     requestId?: string;
     /** Provider-owned streaming projection; defaults to the strict shared line framer. */
     createProtocolReader?(onLine: (line: string) => void): {