@lemoncat7/dsh-partner 1.8.3 → 1.10.2

package/lib/tasks/domain.d.ts

@@ -4,11 +4,14 @@ export declare const TASK_PRIORITIES: readonly ["low", "normal", "high", "urgent
 export type TaskPriority = typeof TASK_PRIORITIES[number];
 export interface BoardTask {
     id: string;
+    requirementId?: string;
     title: string;
     description: string;
     status: TaskStatus;
     priority: TaskPriority;
     assigneeCompanionId?: string;
+    /** Explicit durable execution intent. Missing on legacy/planning-only tasks. */
+    autoRun?: boolean;
     reviewerCompanionId?: string;
     createdBy: 'user' | 'companion' | 'schedule';
     creatorCompanionId?: string;
@@ -21,6 +24,15 @@ export interface BoardTask {
     /** Internal execution notes for the reviewer; never included in user-facing result delivery. */
     reviewHandoff?: string;
     reviewSummary?: string;
+    /** Changes only when the actual work specification changes, not on status updates. */
+    workRevision?: number;
+    rejectionReason?: string;
+    rejectedAt?: number;
+    previousAttempt?: {
+        resultSummary?: string;
+        reviewSummary?: string;
+        reviewHandoff?: string;
+    };
     dueAt?: number;
     revision: number;
     createdAt: number;

package/lib/tasks/domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/tasks/domain.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,qEAAsE,CAAA;AAChG,MAAM,MAAM,UAAU,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAA;AACrD,eAAO,MAAM,eAAe,8CAA+C,CAAA;AAC3E,MAAM,MAAM,YAAY,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAA;AAEzD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,YAAY,CAAA;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AACD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAA;IACvK,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;CACX"}
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/tasks/domain.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,qEAAsE,CAAA;AAChG,MAAM,MAAM,UAAU,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAA;AACrD,eAAO,MAAM,eAAe,8CAA+C,CAAA;AAC3E,MAAM,MAAM,YAAY,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAA;AAEzD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,YAAY,CAAA;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AACD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAA;IACvK,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;CACX"}

package/lib/tasks/progress-notifier.d.ts

@@ -0,0 +1,4 @@
+import type { BoardTask } from './domain.js';
+/** Channel results and internal follow-ups have independent failure boundaries. */
+export declare function createTaskProgressNotifier(deliver: (task: BoardTask) => Promise<void>, followup: (task: BoardTask, previousStatus: BoardTask['status']) => Promise<void>, warn: (message: string) => void): (task: BoardTask, previousStatus: BoardTask['status']) => Promise<void>;
+//# sourceMappingURL=progress-notifier.d.ts.map

package/lib/tasks/progress-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-notifier.d.ts","sourceRoot":"","sources":["../../src/tasks/progress-notifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,mFAAmF;AACnF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,EAC3C,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACjF,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CASzE"}

package/lib/tasks/progress-notifier.js

@@ -0,0 +1,20 @@
+/** Channel results and internal follow-ups have independent failure boundaries. */
+export function createTaskProgressNotifier(deliver, followup, warn) {
+    return async (task, previousStatus) => {
+        // The result is already persisted. Do not delay it behind agent creation,
+        // model work, or a knowledge extraction triggered by an internal follow-up.
+        try {
+            await deliver(task);
+        }
+        catch (error) {
+            warn(`dsh-partner task result delivery failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        try {
+            await followup(task, previousStatus);
+        }
+        catch (error) {
+            warn(`dsh-partner task progress notification failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+}
+//# sourceMappingURL=progress-notifier.js.map

package/lib/tasks/progress-notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-notifier.js","sourceRoot":"","sources":["../../src/tasks/progress-notifier.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CACxC,OAA2C,EAC3C,QAAiF,EACjF,IAA+B;IAE/B,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE;QACpC,0EAA0E;QAC1E,4EAA4E;QAC5E,IAAI,CAAC;YAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAAC,CAAC;QAC3B,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAAC,CAAC;QAC5H,IAAI,CAAC;YAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;QAAC,CAAC;QAC5C,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,kDAAkD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAAC,CAAC;IACpI,CAAC,CAAA;AACH,CAAC"}

package/lib/tasks/removal.d.ts

@@ -0,0 +1,5 @@
+import type { PartnerState } from '../domain.js';
+/** Atomic removal. Missing prerequisites pause dependents instead of auto-unlocking. */
+export declare function removeTaskRecords(state: PartnerState, ids: ReadonlySet<string>): string[];
+export declare function touchTaskRequirement(state: PartnerState, requirementId?: string): void;
+//# sourceMappingURL=removal.d.ts.map

package/lib/tasks/removal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removal.d.ts","sourceRoot":"","sources":["../../src/tasks/removal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAsBzF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAMtF"}

package/lib/tasks/removal.js

@@ -0,0 +1,44 @@
+/** Atomic removal. Missing prerequisites pause dependents instead of auto-unlocking. */
+export function removeTaskRecords(state, ids) {
+    const affected = new Set(ids);
+    const requirementIds = new Set(state.tasks.filter(t => ids.has(t.id)).map(t => t.requirementId));
+    state.tasks = state.tasks.filter(t => !ids.has(t.id));
+    for (const task of state.tasks) {
+        if (!task.dependencyTaskIds.some(id => ids.has(id)))
+            continue;
+        task.dependencyTaskIds = task.dependencyTaskIds.filter(id => !ids.has(id));
+        if (task.status !== 'done') {
+            task.status = 'blocked';
+            task.autoRun = false;
+            task.resultSummary = '前置任务已取消或删除，请确认需求范围及依赖后再提交执行。';
+            affected.add(task.id);
+        }
+        task.revision++;
+        task.updatedAt = Date.now();
+        requirementIds.add(task.requirementId);
+    }
+    state.taskActivities = state.taskActivities.filter(item => !ids.has(item.taskId));
+    state.delegations = state.delegations.filter(item => !affected.has(item.taskId));
+    for (const item of state.requirements ?? []) {
+        if (!requirementIds.has(item.id) || item.status === 'done')
+            continue;
+        item.revision++;
+        item.updatedAt = Date.now();
+        item.status = 'planning';
+        delete item.nextAttemptAt;
+        delete item.lastError;
+    }
+    return [...affected];
+}
+export function touchTaskRequirement(state, requirementId) {
+    const item = state.requirements?.find(r => r.id === requirementId);
+    if (!item || item.status === 'done')
+        return;
+    item.revision++;
+    item.updatedAt = Date.now();
+    if (item.status === 'review')
+        item.status = 'active';
+    delete item.nextAttemptAt;
+    delete item.lastError;
+}
+//# sourceMappingURL=removal.js.map

package/lib/tasks/removal.js.map

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

package/lib/tasks/requirement-link.d.ts

@@ -0,0 +1,4 @@
+import type { BoardTask } from './domain.js';
+/** Dependency links describe execution order, not ownership. Never silently guess a requirement. */
+export declare function requireTaskRequirement(value: unknown, dependencyIds: readonly string[], tasks: readonly BoardTask[]): string;
+//# sourceMappingURL=requirement-link.d.ts.map

package/lib/tasks/requirement-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-link.d.ts","sourceRoot":"","sources":["../../src/tasks/requirement-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,oGAAoG;AACpG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAM5H"}

package/lib/tasks/requirement-link.js

@@ -0,0 +1,11 @@
+import { optionalText } from '../core/validation.js';
+/** Dependency links describe execution order, not ownership. Never silently guess a requirement. */
+export function requireTaskRequirement(value, dependencyIds, tasks) {
+    const id = optionalText(value, 'requirementId', 160);
+    if (id)
+        return id;
+    const dependencies = new Set(dependencyIds);
+    const candidates = [...new Set(tasks.filter(t => dependencies.has(t.id)).map(t => t.requirementId).filter(Boolean))];
+    throw new Error(`创建任务必须提供 requirementId，未创建任何任务或需求。先查询 partner_requirements list；续做同一目标请复用原需求，必要时 reopen 后追加，只有新的独立目标才 create 需求。dependencyTaskIds 不能替代 requirementId。${candidates.length ? `所选前置任务属于：${candidates.join('、')}；请核对归属，不要直接另建需求。` : ''}`);
+}
+//# sourceMappingURL=requirement-link.js.map

package/lib/tasks/requirement-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-link.js","sourceRoot":"","sources":["../../src/tasks/requirement-link.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,oGAAoG;AACpG,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,aAAgC,EAAE,KAA2B;IAClH,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,CAAC,CAAA;IACpD,IAAI,EAAE;QAAE,OAAO,EAAE,CAAA;IACjB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACpH,MAAM,IAAI,KAAK,CAAC,wJAAwJ,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACxP,CAAC"}

package/lib/tasks/service.d.ts

@@ -4,23 +4,27 @@ import type { TaskExecutionOutput } from './result.js';
 export declare class TaskBoardService {
     private readonly store;
     private notifier?;
+    private removalNotifier?;
     constructor(store: PartnerStore);
+    setRemovalNotifier(notifier: (ids: string[]) => void): void;
     setProgressNotifier(notifier: (task: BoardTask, previousStatus: BoardTask['status']) => Promise<void>): void;
     snapshot(): {
         tasks: BoardTask[];
         activities: TaskActivity[];
+        requirements: import("../client-api.js").RequirementView[];
     };
-    create(value: unknown, actor: TaskActor): Promise<BoardTask>;
+    create(value: unknown, actor: TaskActor, requireOwnership?: boolean): Promise<BoardTask>;
     update(taskId: string, value: unknown, actor: TaskActor): Promise<BoardTask>;
     comment(taskId: string, message: string, actor: TaskActor): Promise<void>;
     recordRecovery(taskId: string, message: string, retrying: boolean): Promise<void>;
     assertStartable(taskId: string): BoardTask;
-    completeExecution(taskId: string, result: string | TaskExecutionOutput, actor: TaskActor): Promise<BoardTask>;
-    recordReview(taskId: string, result: string, actor: TaskActor): Promise<BoardTask>;
+    completeExecution(taskId: string, result: string | TaskExecutionOutput, actor: TaskActor, workRevision?: number): Promise<BoardTask>;
+    recordReview(taskId: string, result: string, actor: TaskActor, expectedRevision?: number): Promise<BoardTask>;
     failExecution(taskId: string, error: string, actor: TaskActor): Promise<BoardTask>;
-    accept(taskId: string, actor: TaskActor): Promise<BoardTask>;
-    reject(taskId: string, reason: string, actor: TaskActor): Promise<BoardTask>;
+    accept(taskId: string, actor: TaskActor, expectedRevision?: number): Promise<BoardTask>;
+    reject(taskId: string, reason: string, actor: TaskActor, expectedRevision?: number): Promise<BoardTask>;
     remove(taskId: string): Promise<void>;
+    removeRequirement(id: string): Promise<void>;
     require(taskId: string): BoardTask;
     private assertCompanion;
     private assertDependencies;
@@ -36,4 +40,8 @@ export declare class TaskConflictError extends Error {
     readonly status = 409;
     constructor(current: BoardTask);
 }
+export declare class TaskNotFoundError extends Error {
+    readonly status = 404;
+    constructor(message?: string);
+}
 //# sourceMappingURL=service.d.ts.map

package/lib/tasks/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/tasks/service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAkC,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAKtD,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,CAAyE;gBAE7D,KAAK,EAAE,YAAY;IAEhD,mBAAmB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI5G,QAAQ,IAAI;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,EAAE,YAAY,EAAE,CAAA;KAAE;IAKxD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA8B5D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAwD5E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAWpC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA2B7G,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAgBlF,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBlF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAM5D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAkB5E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAMlC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,0BAA0B;YAMpB,cAAc;CAO7B;AAED,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AAE5F,qBAAa,iBAAkB,SAAQ,KAAK;IAE9B,QAAQ,CAAC,OAAO,EAAE,SAAS;IADvC,QAAQ,CAAC,MAAM,OAAM;gBACA,OAAO,EAAE,SAAS;CACxC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/tasks/service.ts"],"names":[],"mappings":"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"}

package/lib/tasks/service.js

@@ -1,35 +1,47 @@
 import { randomUUID } from 'node:crypto';
 import { appendBounded } from '../core/collections.js';
-import { oneOf, optionalText, record, requiredText, stringList } from '../core/validation.js';
+import { oneOf, optionalBoolean, optionalText, record, requiredText, stringList } from '../core/validation.js';
 import { TASK_PRIORITIES, TASK_STATUSES } from './domain.js';
+import { requirementDraft } from '../requirements/service.js';
+import { removeTaskRecords, touchTaskRequirement } from './removal.js';
+import { invalidateTaskWork, preserveTaskAttempt } from './context.js';
+import { requireTaskRequirement } from './requirement-link.js';
 const MAX_TASKS = 500;
 const MAX_ACTIVITIES = 2000;
 export class TaskBoardService {
     store;
     notifier;
+    removalNotifier;
     constructor(store) {
         this.store = store;
     }
+    setRemovalNotifier(notifier) { this.removalNotifier = notifier; }
     setProgressNotifier(notifier) {
         this.notifier = notifier;
     }
     snapshot() {
         const state = this.store.snapshot();
-        return { tasks: state.tasks, activities: state.taskActivities };
+        return { tasks: state.tasks, activities: state.taskActivities, requirements: state.requirements ?? [] };
     }
-    async create(value, actor) {
+    async create(value, actor, requireOwnership = false) {
         const input = record(value, 'task');
         const now = Date.now();
         const assigneeCompanionId = optionalText(input.assigneeCompanionId, 'assigneeCompanionId', 120);
+        const autoRun = optionalBoolean(input.autoRun, false);
+        if (autoRun && !assigneeCompanionId)
+            throw new Error('提交执行需要指定负责人');
         const requestedReviewerCompanionId = optionalText(input.reviewerCompanionId, 'reviewerCompanionId', 120);
         const reviewerCompanionId = requestedReviewerCompanionId ?? actor.companionId;
         this.assertCompanion(assigneeCompanionId);
         this.assertCompanion(reviewerCompanionId);
         const dependencyTaskIds = stringList(input.dependencyTaskIds, 'dependencyTaskIds', 20, 120);
+        if (requireOwnership)
+            requireTaskRequirement(input.requirementId, dependencyTaskIds, this.store.snapshot().tasks);
         this.assertDependencies(undefined, dependencyTaskIds);
         const task = {
             id: `task-${randomUUID()}`, title: requiredText(input.title, 'title', 200), description: typeof input.description === 'string' ? input.description.trim().slice(0, 8000) : '',
-            status: input.status === undefined ? 'backlog' : oneOf(input.status, TASK_STATUSES, 'status'),
+            status: input.status === undefined ? autoRun ? 'ready' : 'backlog' : oneOf(input.status, TASK_STATUSES, 'status'),
+            ...(autoRun ? { autoRun: true } : {}),
             priority: input.priority === undefined ? 'normal' : oneOf(input.priority, TASK_PRIORITIES, 'priority'),
             ...(assigneeCompanionId ? { assigneeCompanionId } : {}), createdBy: actor.kind,
             ...(reviewerCompanionId ? { reviewerCompanionId } : {}),
@@ -38,11 +50,33 @@ export class TaskBoardService {
             skillIds: stringList(input.skillIds, 'skillIds', 20, 120), dependencyTaskIds,
             ...(validTimestamp(input.dueAt) ? { dueAt: input.dueAt } : {}), revision: 1, createdAt: now, updatedAt: now,
         };
+        if (autoRun && task.status !== 'ready')
+            throw new Error('新提交的任务必须从待开始创建；收集箱请使用 autoRun=false，不能跳过执行和验收');
         if (started(task.status))
             this.assertDependenciesComplete(task, this.store.snapshot().tasks);
         await this.store.update(state => {
             if (state.tasks.length >= MAX_TASKS)
                 throw new Error(`Task board reached its ${MAX_TASKS} task limit; archive or delete completed tasks first`);
+            this.assertDependencies(undefined, dependencyTaskIds, state.tasks);
+            state.requirements ??= [];
+            const requirementId = optionalText(input.requirementId, 'requirementId', 160);
+            if (requirementId) {
+                const requirement = state.requirements.find(r => r.id === requirementId);
+                if (!requirement)
+                    throw new TaskNotFoundError('需求已删除或不存在');
+                if (requirement.status !== 'planning')
+                    throw new Error('请先将需求重新打开为规划状态，再增加任务');
+                task.requirementId = requirementId;
+            }
+            else {
+                if (state.requirements.length >= 500)
+                    throw new Error('需求数量已达上限');
+                const requirement = requirementDraft(task.title, task.description, task.creatorCompanionId, task.creatorSessionId);
+                requirement.status = 'active';
+                state.requirements.push(requirement);
+                task.requirementId = requirement.id;
+            }
+            touchTaskRequirement(state, task.requirementId);
             state.tasks.push(task);
             appendActivity(state.taskActivities, task.id, actor, 'created', `创建任务：${task.title}`, now);
         });
@@ -55,11 +89,14 @@ export class TaskBoardService {
         await this.store.update(state => {
             const task = state.tasks.find(item => item.id === taskId);
             if (!task)
-                throw new Error('Task does not exist');
+                throw new TaskNotFoundError();
+            if (state.requirements?.some(r => r.id === task.requirementId && r.status === 'done'))
+                throw new Error('已归档需求中的任务不能修改；同一目标续做请 reopen 原需求后追加新任务，不要重跑已验收任务');
             const expected = input.expectedRevision;
             if (!Number.isInteger(expected) || expected !== task.revision)
                 throw new TaskConflictError(task);
             previousStatus = task.status;
+            const previousSpec = JSON.stringify([task.title, task.description, task.assigneeCompanionId, task.skillIds, task.dependencyTaskIds]);
             if (input.title !== undefined)
                 task.title = requiredText(input.title, 'title', 200);
             if (input.description !== undefined)
@@ -68,6 +105,18 @@ export class TaskBoardService {
                 task.status = oneOf(input.status, TASK_STATUSES, 'status');
             if (input.priority !== undefined)
                 task.priority = oneOf(input.priority, TASK_PRIORITIES, 'priority');
+            if (input.autoRun !== undefined) {
+                task.autoRun = optionalBoolean(input.autoRun, false);
+                if (!task.autoRun)
+                    for (const item of state.delegations) {
+                        if (item.taskId !== task.id || item.status !== 'queued' || item.kind === 'review')
+                            continue;
+                        item.status = 'canceled';
+                        item.completedAt = Date.now();
+                        item.error = '任务已改为仅规划，取消尚未开始的执行';
+                        delete item.nextAttemptAt;
+                    }
+            }
             if ('assigneeCompanionId' in input) {
                 const assignee = optionalText(input.assigneeCompanionId, 'assigneeCompanionId', 120);
                 this.assertCompanion(assignee);
@@ -100,17 +149,24 @@ export class TaskBoardService {
                 else
                     delete task.dueAt;
             }
+            if (previousSpec !== JSON.stringify([task.title, task.description, task.assigneeCompanionId, task.skillIds, task.dependencyTaskIds])) {
+                invalidateTaskWork(state, task, '任务要求或分配已更新，旧执行/验收失效');
+            }
+            if (input.autoRun === true && !task.assigneeCompanionId)
+                throw new Error('提交执行需要指定负责人');
             if (task.status === 'done' && previousStatus !== 'done' && previousStatus !== 'review')
                 throw new Error('任务必须先进入待验收，才能标记为已完成');
             if (started(task.status))
                 this.assertDependenciesComplete(task, state.tasks);
             task.revision += 1;
             task.updatedAt = Date.now();
+            touchTaskRequirement(state, task.requirementId);
             if (task.status === 'done' && previousStatus !== 'done')
                 task.completedAt = task.updatedAt;
             if (task.status !== 'done')
                 delete task.completedAt;
             if (task.status === 'doing' && previousStatus !== 'doing') {
+                preserveTaskAttempt(task);
                 delete task.resultAbstract;
                 delete task.resultSummary;
                 delete task.reviewHandoff;
@@ -124,11 +180,19 @@ export class TaskBoardService {
         return output;
     }
     async comment(taskId, message, actor) {
+        let task;
         await this.store.update(state => {
-            if (!state.tasks.some(item => item.id === taskId))
-                throw new Error('Task does not exist');
+            const current = state.tasks.find(item => item.id === taskId);
+            if (!current)
+                throw new TaskNotFoundError();
             appendActivity(state.taskActivities, taskId, actor, 'commented', requiredText(message, 'message', 1200), Date.now());
+            current.revision++;
+            current.updatedAt = Date.now();
+            touchTaskRequirement(state, current.requirementId);
+            task = structuredClone(current);
         });
+        if (task.status === 'review')
+            await this.notifyProgress(task, 'review', true);
     }
     async recordRecovery(taskId, message, retrying) {
         await this.store.update(state => {
@@ -141,7 +205,7 @@ export class TaskBoardService {
         const state = this.store.snapshot();
         const task = state.tasks.find(item => item.id === taskId);
         if (!task)
-            throw new Error('Task does not exist');
+            throw new TaskNotFoundError();
         if (task.status === 'doing')
             throw new Error('任务已经在执行中');
         if (task.status === 'review')
@@ -151,15 +215,17 @@ export class TaskBoardService {
         this.assertDependenciesComplete(task, state.tasks);
         return task;
     }
-    async completeExecution(taskId, result, actor) {
+    async completeExecution(taskId, result, actor, workRevision) {
         let output;
         let previousStatus;
         await this.store.update(state => {
             const task = state.tasks.find(item => item.id === taskId);
             if (!task)
-                throw new Error('Task does not exist');
+                throw new TaskNotFoundError();
             if (task.status !== 'doing' && task.status !== 'review')
                 throw new Error('只有进行中或待验收的任务可以提交执行结果');
+            if (workRevision !== undefined && workRevision !== (task.workRevision ?? 1))
+                throw new TaskConflictError(task);
             previousStatus = task.status;
             if (!task.reviewerCompanionId && task.creatorCompanionId)
                 task.reviewerCompanionId = task.creatorCompanionId;
@@ -179,25 +245,29 @@ export class TaskBoardService {
                 task.status = 'review';
             task.revision += 1;
             task.updatedAt = Date.now();
+            touchTaskRequirement(state, task.requirementId);
             appendActivity(state.taskActivities, task.id, actor, 'result', movedToReview ? '执行结果已提交，等待验收' : '执行结果已补充到待验收任务', task.updatedAt);
             output = structuredClone(task);
         });
         await this.notifyProgress(output, previousStatus, true);
         return output;
     }
-    async recordReview(taskId, result, actor) {
+    async recordReview(taskId, result, actor, expectedRevision) {
         let output;
         await this.store.update(state => {
             const task = state.tasks.find(item => item.id === taskId);
             if (!task)
-                throw new Error('Task does not exist');
+                throw new TaskNotFoundError();
             if (task.status !== 'review')
                 throw new Error('只有待验收任务可以提交核验结果');
+            if (expectedRevision !== undefined && expectedRevision !== task.revision)
+                throw new TaskConflictError(task);
             if (task.reviewerCompanionId && actor.companionId !== task.reviewerCompanionId)
                 throw new Error('核验结果必须由任务指定的验收伙伴提交');
             task.reviewSummary = boundedText(result, 'reviewResult', 12_000);
             task.revision += 1;
             task.updatedAt = Date.now();
+            touchTaskRequirement(state, task.requirementId);
             appendActivity(state.taskActivities, task.id, actor, 'reviewed', '验收伙伴已提交核验结果', task.updatedAt);
             output = structuredClone(task);
         });
@@ -209,63 +279,73 @@ export class TaskBoardService {
         await this.store.update(state => {
             const task = state.tasks.find(item => item.id === taskId);
             if (!task)
-                throw new Error('Task does not exist');
+                throw new TaskNotFoundError();
             previousStatus = task.status;
+            if (task.status !== 'doing')
+                throw new Error('只有进行中的任务可以报告执行失败');
             task.resultSummary = `执行受阻：${boundedText(error, 'error', 4000)}`;
             delete task.resultAbstract;
             delete task.reviewHandoff;
             task.status = 'blocked';
             task.revision += 1;
             task.updatedAt = Date.now();
+            touchTaskRequirement(state, task.requirementId);
             appendActivity(state.taskActivities, task.id, actor, 'failed', task.resultSummary, task.updatedAt);
             output = structuredClone(task);
         });
         await this.notifyProgress(output, previousStatus);
         return output;
     }
-    async accept(taskId, actor) {
+    async accept(taskId, actor, expectedRevision) {
         const current = this.require(taskId);
         if (current.status !== 'review')
             throw new Error('只有待验收任务可以通过验收');
-        return this.update(taskId, { expectedRevision: current.revision, status: 'done' }, actor);
+        return this.update(taskId, { expectedRevision: expectedRevision ?? current.revision, status: 'done' }, actor);
     }
-    async reject(taskId, reason, actor) {
+    async reject(taskId, reason, actor, expectedRevision) {
         let output;
         await this.store.update(state => {
             const task = state.tasks.find(item => item.id === taskId);
             if (!task)
-                throw new Error('Task does not exist');
+                throw new TaskNotFoundError();
             if (task.status !== 'review')
                 throw new Error('只有待验收任务可以打回');
+            if (expectedRevision !== undefined && expectedRevision !== task.revision)
+                throw new TaskConflictError(task);
             const message = boundedText(reason, 'reason', 1200);
+            task.rejectionReason = message;
+            task.rejectedAt = Date.now();
+            invalidateTaskWork(state, task, '验收打回，旧执行/验收已失效');
             task.status = 'ready';
             delete task.reviewSummary;
             delete task.completedAt;
             task.revision += 1;
             task.updatedAt = Date.now();
+            touchTaskRequirement(state, task.requirementId);
             appendActivity(state.taskActivities, task.id, actor, 'reopened', `验收打回：${message}`, task.updatedAt);
             output = structuredClone(task);
         });
         return output;
     }
     async remove(taskId) {
+        let affected = [];
         await this.store.update(state => {
-            state.tasks = state.tasks.filter(item => item.id !== taskId);
-            for (const task of state.tasks) {
-                if (!task.dependencyTaskIds.includes(taskId))
-                    continue;
-                task.dependencyTaskIds = task.dependencyTaskIds.filter(id => id !== taskId);
-                task.revision += 1;
-                task.updatedAt = Date.now();
-            }
-            state.taskActivities = state.taskActivities.filter(item => item.taskId !== taskId);
-            state.delegations = state.delegations.filter(item => item.taskId !== taskId);
+            affected = removeTaskRecords(state, new Set([taskId]));
         });
+        this.removalNotifier?.(affected);
+    }
+    async removeRequirement(id) {
+        let affected = [];
+        await this.store.update(state => {
+            affected = removeTaskRecords(state, new Set(state.tasks.filter(t => t.requirementId === id).map(t => t.id)));
+            state.requirements = (state.requirements ?? []).filter(r => r.id !== id);
+        });
+        this.removalNotifier?.(affected);
     }
     require(taskId) {
         const task = this.store.snapshot().tasks.find(item => item.id === taskId);
         if (!task)
-            throw new Error('Task does not exist');
+            throw new TaskNotFoundError();
         return task;
     }
     assertCompanion(id) {
@@ -315,10 +395,14 @@ export class TaskConflictError extends Error {
     current;
     status = 409;
     constructor(current) {
-        super('Task changed; refresh it before updating');
+        super('任务状态已更新，请刷新后重试（Task changed）');
         this.current = current;
     }
 }
+export class TaskNotFoundError extends Error {
+    status = 404;
+    constructor(message = '任务已删除或不存在，无需继续处理') { super(message); }
+}
 function appendActivity(items, taskId, actor, kind, message, at) {
     appendBounded(items, {
         id: `activity-${randomUUID()}`, taskId, actor: actor.kind, ...('companionId' in actor && actor.companionId ? { actorCompanionId: actor.companionId } : {}), kind, message, at,