@siming-org/core 0.7.4 → 0.8.1

package/dist/index.d.ts

@@ -459,6 +459,38 @@ declare const SourcePresetSchema: z.ZodObject<{
     agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type SourcePreset = z.infer<typeof SourcePresetSchema>;
+/**
+ * 工具类检查项声明：type=CLI 检查函数注册表键（kebab-case，运行时校验——注册表在 CLI 侧，
+ * server 不感知检查语义，不同版本 CLI 的 type 集不同，前向兼容）。
+ * params 仅限检查项内部常量（如超时秒数、正则片段）；项目差异参数（repoPath/baseBranch 等）
+ * 一律经运行时解析链（task/项目配置），禁止来自资产 params。
+ */
+declare const ToolCheckSchema: z.ZodObject<{
+    type: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+}, z.core.$strip>;
+type ToolCheck = z.infer<typeof ToolCheckSchema>;
+/**
+ * AI 自检项声明：id 节点内唯一（推进前自检留痕按 refId=id 匹配——CheckItem.refId），
+ * item=自检要求原文（与节点 prompt 产出检查节同源对应）。
+ */
+declare const AiCheckSchema: z.ZodObject<{
+    id: z.ZodString;
+    item: z.ZodString;
+}, z.core.$strip>;
+type AiCheck = z.infer<typeof AiCheckSchema>;
+/** TOOL_CHECKS_MAX = 资产层声明上限（防配置面失控；运行时逐项执行有超时兜底） */
+declare const NODE_CHECKS_MAX = 20;
+/**
+ * 函数级校验：节点内 aiCheck id 唯一性（assertUniqueNodeIds 先例——模板级 schema 禁挂 refine，
+ * Zod4 partial 派生陷阱；导入/组装路由调用）。
+ */
+declare function assertUniqueAiCheckIds(nodes: ReadonlyArray<{
+    id: string;
+    aiChecks?: ReadonlyArray<{
+        id: string;
+    }> | undefined;
+}>): void;
 declare const DagNodeSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
@@ -473,6 +505,14 @@ declare const DagNodeSchema: z.ZodObject<{
         contentHash: z.ZodString;
         agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>>;
+    aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        item: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type DagNode = z.infer<typeof DagNodeSchema>;
 /** 暂停点类型——固定枚举，引擎仅处理这两种语义（human_approval 落 paused / checkpoint 仅记录不停留） */
@@ -562,6 +602,14 @@ declare const DagTemplateSchema: z.ZodObject<{
             contentHash: z.ZodString;
             agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
+        toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
     edges: z.ZodArray<z.ZodObject<{
         from: z.ZodString;
@@ -607,6 +655,14 @@ declare const DagTemplateCreateSchema: z.ZodObject<{
             contentHash: z.ZodString;
             agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
+        toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
     edges: z.ZodArray<z.ZodObject<{
         from: z.ZodString;
@@ -653,6 +709,14 @@ declare const DagTemplateUpdateSchema: z.ZodObject<{
             contentHash: z.ZodString;
             agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
+        toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
         from: z.ZodString;
@@ -759,11 +823,21 @@ declare const TASK_TYPES: readonly ["feature", "bugfix", "ui-tweak", "research"]
 type TaskType = (typeof TASK_TYPES)[number];
 /** 条目短 id 格式：服务端生成 6 位 base36（条目定位/翻转用，同 record 内查重） */
 declare const ENTRY_ID_REGEX: RegExp;
-/** 完成判定清单条目（item = 判定项原文，passed = 逐项 ✅/❌ 状态） */
+/**
+ * 完成判定清单条目（item = 判定项原文，passed = 逐项 ✅/❌ 状态）。
+ * T202609230001：source/refId——自检留痕校验通道：aiChecks.id 声明项须存在
+ * refId==id 且 passed===true（或 item 含不适用+理由）的留痕；source 区分自报（self，
+ * 缺省）与工具写入（tool，本版不写，保留通道）。
+ */
 declare const CheckItemSchema: z.ZodObject<{
     id: z.ZodString;
     item: z.ZodString;
     passed: z.ZodBoolean;
+    source: z.ZodOptional<z.ZodEnum<{
+        self: "self";
+        tool: "tool";
+    }>>;
+    refId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type CheckItem = z.infer<typeof CheckItemSchema>;
 /** 产物类型静态枚举（决策 5：API 契约字段，非用户自定义分类） */
@@ -813,9 +887,23 @@ declare const ReviewSummarySchema: z.ZodObject<{
     critical: z.ZodNumber;
 }, z.core.$strip>;
 type ReviewSummary = z.infer<typeof ReviewSummarySchema>;
+/**
+ * 测试报告结构化留痕（B1 判定数据）：command=执行命令、四计数。
+ * skipped>0 时须持 decisions topic=skip-authorized 授权留痕（D9 词表）。
+ */
+declare const TestReportSchema: z.ZodObject<{
+    command: z.ZodString;
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    skipped: z.ZodNumber;
+}, z.core.$strip>;
+type TestReport = z.infer<typeof TestReportSchema>;
 /**
  * 节点执行记录（nodeId → record）。无 completedAt——完成时间单权威在
  * dagInstance.nodeStates（决策 11：状态属性归状态机，双存必然漂移）。
+ * T202609230001：结构化判定字段（B 档门禁数据落点，点路径 $set 小步写）——
+ * baseBranch（ALIGN/A2/A3/B3 链）、verifiedCommit（B5/B7）、fixesApplied（B4 条件门禁）、
+ * testReport（B1）、deferredIssues（B8）、evidenceFiles（B9）。
  */
 declare const NodeRecordSchema: z.ZodObject<{
     summary: z.ZodOptional<z.ZodString>;
@@ -823,6 +911,11 @@ declare const NodeRecordSchema: z.ZodObject<{
         id: z.ZodString;
         item: z.ZodString;
         passed: z.ZodBoolean;
+        source: z.ZodOptional<z.ZodEnum<{
+            self: "self";
+            tool: "tool";
+        }>>;
+        refId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -856,6 +949,17 @@ declare const NodeRecordSchema: z.ZodObject<{
         rounds: z.ZodNumber;
         critical: z.ZodNumber;
     }, z.core.$strip>>;
+    baseBranch: z.ZodOptional<z.ZodString>;
+    verifiedCommit: z.ZodOptional<z.ZodString>;
+    fixesApplied: z.ZodOptional<z.ZodNumber>;
+    testReport: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        skipped: z.ZodNumber;
+    }, z.core.$strip>>;
+    deferredIssues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    evidenceFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type NodeRecord = z.infer<typeof NodeRecordSchema>;
 /** 任务级文档：需求 What/Why + 验收标准 + 非目标 + 轨道识别结论 */
@@ -899,6 +1003,14 @@ declare const DagInstanceNodeSchema: z.ZodObject<{
     prompt: z.ZodString;
     skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
     agents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>>;
+    aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        item: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type DagInstanceNode = z.infer<typeof DagInstanceNodeSchema>;
 declare const DagInstanceSchema: z.ZodObject<{
@@ -912,6 +1024,14 @@ declare const DagInstanceSchema: z.ZodObject<{
         prompt: z.ZodString;
         skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
         agents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
     edges: z.ZodArray<z.ZodObject<{
         from: z.ZodString;
@@ -950,6 +1070,7 @@ declare const HistoryActionSchema: z.ZodEnum<{
     rejected: "rejected";
     cancelled: "cancelled";
     reopened: "reopened";
+    checks_rejected: "checks_rejected";
 }>;
 declare const HistoryEntrySchema: z.ZodObject<{
     nodeId: z.ZodString;
@@ -963,6 +1084,7 @@ declare const HistoryEntrySchema: z.ZodObject<{
         rejected: "rejected";
         cancelled: "cancelled";
         reopened: "reopened";
+        checks_rejected: "checks_rejected";
     }>;
     timestamp: z.ZodDefault<z.ZodDate>;
     details: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -999,6 +1121,14 @@ declare const TaskSchema: z.ZodObject<{
             prompt: z.ZodString;
             skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
             agents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            }, z.core.$strip>>>;
+            aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                item: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
         edges: z.ZodArray<z.ZodObject<{
             from: z.ZodString;
@@ -1038,6 +1168,11 @@ declare const TaskSchema: z.ZodObject<{
             id: z.ZodString;
             item: z.ZodString;
             passed: z.ZodBoolean;
+            source: z.ZodOptional<z.ZodEnum<{
+                self: "self";
+                tool: "tool";
+            }>>;
+            refId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -1071,6 +1206,17 @@ declare const TaskSchema: z.ZodObject<{
             rounds: z.ZodNumber;
             critical: z.ZodNumber;
         }, z.core.$strip>>;
+        baseBranch: z.ZodOptional<z.ZodString>;
+        verifiedCommit: z.ZodOptional<z.ZodString>;
+        fixesApplied: z.ZodOptional<z.ZodNumber>;
+        testReport: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            skipped: z.ZodNumber;
+        }, z.core.$strip>>;
+        deferredIssues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        evidenceFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
     archNotes: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -1089,6 +1235,7 @@ declare const TaskSchema: z.ZodObject<{
             rejected: "rejected";
             cancelled: "cancelled";
             reopened: "reopened";
+            checks_rejected: "checks_rejected";
         }>;
         timestamp: z.ZodDefault<z.ZodDate>;
         details: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1134,6 +1281,7 @@ declare const TaskContextSchema: z.ZodObject<{
             "ui-tweak": "ui-tweak";
             research: "research";
         }>>;
+        projectId: z.ZodString;
         currentNode: z.ZodString;
         currentPhase: z.ZodString;
         status: z.ZodString;
@@ -1149,6 +1297,14 @@ declare const TaskContextSchema: z.ZodObject<{
         skills: z.ZodArray<z.ZodString>;
         agents: z.ZodArray<z.ZodString>;
         upcomingPause: z.ZodNullable<z.ZodString>;
+        toolChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
     pausedAtEdge: z.ZodNullable<z.ZodObject<{
         from: z.ZodString;
@@ -1169,6 +1325,10 @@ declare const TaskContextSchema: z.ZodObject<{
         enteredAt: z.ZodNullable<z.ZodDate>;
         completedAt: z.ZodNullable<z.ZodDate>;
     }, z.core.$strip>>;
+    edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>>>;
     taskDoc: z.ZodNullable<z.ZodObject<{
         what: z.ZodString;
         why: z.ZodString;
@@ -1182,6 +1342,11 @@ declare const TaskContextSchema: z.ZodObject<{
             id: z.ZodString;
             item: z.ZodString;
             passed: z.ZodBoolean;
+            source: z.ZodOptional<z.ZodEnum<{
+                self: "self";
+                tool: "tool";
+            }>>;
+            refId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -1215,6 +1380,17 @@ declare const TaskContextSchema: z.ZodObject<{
             rounds: z.ZodNumber;
             critical: z.ZodNumber;
         }, z.core.$strip>>;
+        baseBranch: z.ZodOptional<z.ZodString>;
+        verifiedCommit: z.ZodOptional<z.ZodString>;
+        fixesApplied: z.ZodOptional<z.ZodNumber>;
+        testReport: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            skipped: z.ZodNumber;
+        }, z.core.$strip>>;
+        deferredIssues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        evidenceFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     archNotes: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -1294,24 +1470,26 @@ type TaskRepo = Repo<Task> & {
 declare function createTaskRepo(db: Db): TaskRepo;
 
 /**
- * Issue 相关 Schemas（T202609150002 问题池）
- * 小问题轻量跟进：入池 → 整理（合并/拆分）→ 转任务（多对多）。
+ * Issue 相关 Schemas（T202609150002 问题池；T202609200001 直接标记完成 + 审批原话）
+ * 小问题轻量跟进：入池 → 整理（合并/拆分）→ 转任务（多对多）或直接标记完成。
  *
- * 状态语义（PRD 3.2 四态，终态禁止回转）：
- * - pending 待整理 / partial 部分转任务（存在未覆盖遗留）/ converted 已转任务 / cancelled 已取消
+ * 状态语义（PRD 3.2 四态基础上 T202609200001 增 done，终态禁止回转）：
+ * - pending 待整理 / partial 部分转任务（存在未覆盖遗留）/ converted 已转任务 / cancelled 已取消 / done 已直接标记完成
+ * - done：无需转任务、在某个任务/改动中顺带解决时的人工收尾终态（taskLinks 保留——已建立关联时进度可读）
  * - 任务后续演进（完成/取消）不触碰问题状态，进度是读时聚合（taskLinks × tasks.status）
  *
  * 关联模型（D1）：单一真相源在 Issue 侧（taskLinks 嵌入数组），Task 零改动；
  * 多对多，同项目内组合；取消问题时 taskLinks 终止条目拷入 history（D8 结构化追溯）。
  */
-/** 池内状态（终态 = converted / cancelled，状态机保护见 issue.repo） */
-declare const ISSUE_STATUSES: readonly ["pending", "partial", "converted", "cancelled"];
+/** 池内状态（终态 = converted / cancelled / done，状态机保护见 issue.repo） */
+declare const ISSUE_STATUSES: readonly ["pending", "partial", "converted", "cancelled", "done"];
 type IssueStatus = (typeof ISSUE_STATUSES)[number];
 declare const IssueStatusSchema: z.ZodEnum<{
     pending: "pending";
     cancelled: "cancelled";
     partial: "partial";
     converted: "converted";
+    done: "done";
 }>;
 /** 可参与转出/取消的非终态集合（事务内条件更新的并发安全带） */
 declare const ISSUE_ACTIVE_STATUSES: readonly ["pending", "partial"];
@@ -1360,12 +1538,14 @@ declare const IssueHistoryEntrySchema: z.ZodObject<{
         cancelled: "cancelled";
         partial: "partial";
         converted: "converted";
+        done: "done";
     }>>;
     to: z.ZodOptional<z.ZodEnum<{
         pending: "pending";
         cancelled: "cancelled";
         partial: "partial";
         converted: "converted";
+        done: "done";
     }>>;
     taskId: z.ZodOptional<z.ZodString>;
     reason: z.ZodOptional<z.ZodString>;
@@ -1388,7 +1568,9 @@ declare const IssueSchema: z.ZodObject<{
         cancelled: "cancelled";
         partial: "partial";
         converted: "converted";
+        done: "done";
     }>>;
+    approved: z.ZodOptional<z.ZodString>;
     taskLinks: z.ZodDefault<z.ZodArray<z.ZodObject<{
         taskId: z.ZodString;
         mode: z.ZodEnum<{
@@ -1410,12 +1592,14 @@ declare const IssueSchema: z.ZodObject<{
             cancelled: "cancelled";
             partial: "partial";
             converted: "converted";
+            done: "done";
         }>>;
         to: z.ZodOptional<z.ZodEnum<{
             pending: "pending";
             cancelled: "cancelled";
             partial: "partial";
             converted: "converted";
+            done: "done";
         }>>;
         taskId: z.ZodOptional<z.ZodString>;
         reason: z.ZodOptional<z.ZodString>;
@@ -1428,10 +1612,13 @@ type Issue = z.infer<typeof IssueSchema>;
 /**
  * 录入输入：source/projectId 由服务端按通道/项目解析注入，不入客户端 schema
  * （source 是统计信息非权限依据；projectId 缺省按 key=default 解析）。
+ * approved（T202609200001）：人类审批原话逐字（1-500 字）；AI 通道（mcp/cli）强制在 server 路由层
+ * （source 感知），schema 保持通道中立——Web 录入无此字段。
  */
 declare const IssueCreateSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
+    approved: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type IssueCreate = z.infer<typeof IssueCreateSchema>;
 /** 编辑输入（独立 object 不派生——Zod4 UpdateSchema 范式；任意状态可编辑，终态无副作用） */
@@ -1473,8 +1660,8 @@ type TaskIssueView = {
 };
 
 /**
- * Issue 仓储（T202609150002）
- * 状态机保护在此层：终态（converted/cancelled）禁止 cancel/convert 关联写入——
+ * Issue 仓储（T202609150002；T202609200001 直接标记完成 done）
+ * 状态机保护在此层：终态（converted/cancelled/done）禁止 cancel/convert/markDone 写入——
  * 条件更新双保险（filter 携带 status ∈ {pending, partial}，命中 0 行即并发终态）。
  * 进度计算两步批查（D2：不用 $lookup——Zod parse 单源 + 一次 $in 往返 + 内存映射）。
  */
@@ -1511,6 +1698,8 @@ type IssueRepo = Repo<Issue> & {
     getByIssueId(issueId: string): Promise<Issue | null>;
     updateIssue(issueId: string, patch: IssueUpdate): Promise<Issue>;
     cancelIssue(issueId: string, reason?: string): Promise<Issue>;
+    /** 直接标记完成（T202609200001）：终态三值互斥；taskLinks 保留（D3），note 落 history reason */
+    markDone(issueId: string, note?: string): Promise<Issue>;
     /** 列表（进度聚合 + view=open 过滤；两支合并 createdAt 降序统一切片） */
     listIssues(filter?: IssueListFilter): Promise<{
         items: IssueWithProgress[];
@@ -1546,6 +1735,22 @@ declare const ProjectStatusSchema: z.ZodEnum<{
     active: "active";
     archived: "archived";
 }>;
+/**
+ * T202609230001：项目级 VCS 配置（门禁参数解析链第 2 级——任务级结构化字段优先）。
+ * 全部可选：缺省形态=分支模型开启+repoPath 走 cwd 解析（本地单机即用，零迁移）。
+ */
+declare const VcsConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    baseBranch: z.ZodOptional<z.ZodString>;
+    repoPath: z.ZodOptional<z.ZodString>;
+    branchPattern: z.ZodOptional<z.ZodString>;
+    worktreeMode: z.ZodOptional<z.ZodBoolean>;
+    archiveToBase: z.ZodOptional<z.ZodBoolean>;
+    docPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type VcsConfig = z.infer<typeof VcsConfigSchema>;
+/** docPaths 缺省清单（B7 豁免：文档库/设计文档/临时目录/根级 markdown） */
+declare const DEFAULT_VCS_DOC_PATHS: readonly ["ProjectHub/", "docs/", "temp/", "*.md"];
 declare const ProjectSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     key: z.ZodString;
@@ -1555,6 +1760,15 @@ declare const ProjectSchema: z.ZodObject<{
         active: "active";
         archived: "archived";
     }>>;
+    vcs: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        baseBranch: z.ZodOptional<z.ZodString>;
+        repoPath: z.ZodOptional<z.ZodString>;
+        branchPattern: z.ZodOptional<z.ZodString>;
+        worktreeMode: z.ZodOptional<z.ZodBoolean>;
+        archiveToBase: z.ZodOptional<z.ZodBoolean>;
+        docPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
     createdAt: z.ZodOptional<z.ZodDate>;
     updatedAt: z.ZodOptional<z.ZodDate>;
 }, z.core.$strip>;
@@ -1572,6 +1786,7 @@ declare const ProjectCreateSchema: z.ZodObject<{
 type ProjectCreate = z.infer<typeof ProjectCreateSchema>;
 /**
  * 更新输入：不含 key（key 是锚点字段，创建后不可变，F6 精神）。
+ * vcs 经 exactOptionalPropertyTypes 逐字段构造（PATCH 透传，嵌套对象整体替换）。
  */
 declare const ProjectUpdateSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
@@ -1580,6 +1795,15 @@ declare const ProjectUpdateSchema: z.ZodObject<{
         active: "active";
         archived: "archived";
     }>>;
+    vcs: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        baseBranch: z.ZodOptional<z.ZodString>;
+        repoPath: z.ZodOptional<z.ZodString>;
+        branchPattern: z.ZodOptional<z.ZodString>;
+        worktreeMode: z.ZodOptional<z.ZodBoolean>;
+        archiveToBase: z.ZodOptional<z.ZodBoolean>;
+        docPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type ProjectUpdate = z.infer<typeof ProjectUpdateSchema>;
 
@@ -1811,6 +2035,14 @@ declare const NodePresetShapeSchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodObject<{
         package: z.ZodString;
     }, z.core.$strip>>;
+    toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>>;
+    aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        item: z.ZodString;
+    }, z.core.$strip>>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     createdAt: z.ZodOptional<z.ZodDate>;
     updatedAt: z.ZodOptional<z.ZodDate>;
@@ -1835,6 +2067,14 @@ declare const NodePresetSchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodObject<{
         package: z.ZodString;
     }, z.core.$strip>>;
+    toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>>;
+    aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        item: z.ZodString;
+    }, z.core.$strip>>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     createdAt: z.ZodOptional<z.ZodDate>;
     updatedAt: z.ZodOptional<z.ZodDate>;
@@ -1856,10 +2096,18 @@ declare const NodePresetCreateSchema: z.ZodObject<{
     phase: z.ZodString;
     label: z.ZodString;
     prompt: z.ZodString;
-    nodeId: z.ZodString;
+    toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>>;
+    aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        item: z.ZodString;
+    }, z.core.$strip>>>;
     source: z.ZodOptional<z.ZodObject<{
         package: z.ZodString;
     }, z.core.$strip>>;
+    nodeId: z.ZodString;
     skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
     agents: z.ZodDefault<z.ZodArray<z.ZodString>>;
     version: z.ZodDefault<z.ZodString>;
@@ -1884,10 +2132,18 @@ declare const NodePresetUpdateSchema: z.ZodObject<{
     phase: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
     prompt: z.ZodOptional<z.ZodString>;
-    nodeId: z.ZodOptional<z.ZodString>;
+    toolChecks: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>>>;
+    aiChecks: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        item: z.ZodString;
+    }, z.core.$strip>>>>;
     source: z.ZodOptional<z.ZodOptional<z.ZodObject<{
         package: z.ZodString;
     }, z.core.$strip>>>;
+    nodeId: z.ZodOptional<z.ZodString>;
     version: z.ZodOptional<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 type NodePresetUpdate = z.infer<typeof NodePresetUpdateSchema>;
@@ -2496,6 +2752,14 @@ declare const TemplatePayloadSchema: z.ZodObject<{
             contentHash: z.ZodString;
             agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
+        toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
     edges: z.ZodArray<z.ZodObject<{
         from: z.ZodString;
@@ -2596,6 +2860,14 @@ declare const ExportBundleSchema: z.ZodObject<{
                 contentHash: z.ZodString;
                 agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
+            toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            }, z.core.$strip>>>;
+            aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                item: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
         edges: z.ZodArray<z.ZodObject<{
             from: z.ZodString;
@@ -2686,6 +2958,14 @@ declare const ImportPlanRequestSchema: z.ZodObject<{
                     contentHash: z.ZodString;
                     agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 }, z.core.$strip>>;
+                toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+                }, z.core.$strip>>>;
+                aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    item: z.ZodString;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>;
             edges: z.ZodArray<z.ZodObject<{
                 from: z.ZodString;
@@ -2809,6 +3089,14 @@ declare const ImportApplyRequestSchema: z.ZodObject<{
                     contentHash: z.ZodString;
                     agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 }, z.core.$strip>>;
+                toolChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+                }, z.core.$strip>>>;
+                aiChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    item: z.ZodString;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>;
             edges: z.ZodArray<z.ZodObject<{
                 from: z.ZodString;
@@ -2984,11 +3272,11 @@ declare const ImportPlanResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ImportPlanResponse = z.infer<typeof ImportPlanResponseSchema>;
 declare const DependencyActionSchema: z.ZodEnum<{
+    failed: "failed";
     skipped: "skipped";
     created: "created";
     identical: "identical";
     updated: "updated";
-    failed: "failed";
 }>;
 type DependencyAction = z.infer<typeof DependencyActionSchema>;
 declare const ImportApplyResponseSchema: z.ZodObject<{
@@ -3013,11 +3301,11 @@ declare const ImportApplyResponseSchema: z.ZodObject<{
             project: "project";
         }>>;
         action: z.ZodEnum<{
+            failed: "failed";
             skipped: "skipped";
             created: "created";
             identical: "identical";
             updated: "updated";
-            failed: "failed";
         }>;
         message: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
@@ -3063,6 +3351,7 @@ declare const TaskPublicSchema: z.ZodObject<{
         "ui-tweak": "ui-tweak";
         research: "research";
     }>>;
+    projectId: z.ZodString;
     currentNode: z.ZodString;
     currentPhase: z.ZodString;
     status: z.ZodString;
@@ -3079,6 +3368,14 @@ declare const NodeInfoSchema: z.ZodObject<{
     skills: z.ZodArray<z.ZodString>;
     agents: z.ZodArray<z.ZodString>;
     upcomingPause: z.ZodNullable<z.ZodString>;
+    toolChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>>;
+    aiChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        item: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type NodeInfo = z.infer<typeof NodeInfoSchema>;
 /** N017 D7：删 gate_failed 分支（union 收窄为 advanced / paused / completed）；paused 分支 pausePoint 类型改 EdgePausePoint */
@@ -3093,6 +3390,7 @@ declare const AdvanceResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "ui-tweak": "ui-tweak";
             research: "research";
         }>>;
+        projectId: z.ZodString;
         currentNode: z.ZodString;
         currentPhase: z.ZodString;
         status: z.ZodString;
@@ -3107,6 +3405,14 @@ declare const AdvanceResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         skills: z.ZodArray<z.ZodString>;
         agents: z.ZodArray<z.ZodString>;
         upcomingPause: z.ZodNullable<z.ZodString>;
+        toolChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     status: z.ZodLiteral<"paused">;
@@ -3119,6 +3425,7 @@ declare const AdvanceResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "ui-tweak": "ui-tweak";
             research: "research";
         }>>;
+        projectId: z.ZodString;
         currentNode: z.ZodString;
         currentPhase: z.ZodString;
         status: z.ZodString;
@@ -3145,6 +3452,7 @@ declare const AdvanceResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "ui-tweak": "ui-tweak";
             research: "research";
         }>>;
+        projectId: z.ZodString;
         currentNode: z.ZodString;
         currentPhase: z.ZodString;
         status: z.ZodString;
@@ -3164,6 +3472,7 @@ declare const ApproveResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "ui-tweak": "ui-tweak";
             research: "research";
         }>>;
+        projectId: z.ZodString;
         currentNode: z.ZodString;
         currentPhase: z.ZodString;
         status: z.ZodString;
@@ -3178,6 +3487,14 @@ declare const ApproveResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         skills: z.ZodArray<z.ZodString>;
         agents: z.ZodArray<z.ZodString>;
         upcomingPause: z.ZodNullable<z.ZodString>;
+        toolChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     status: z.ZodLiteral<"rejected">;
@@ -3190,6 +3507,7 @@ declare const ApproveResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "ui-tweak": "ui-tweak";
             research: "research";
         }>>;
+        projectId: z.ZodString;
         currentNode: z.ZodString;
         currentPhase: z.ZodString;
         status: z.ZodString;
@@ -3208,6 +3526,7 @@ declare const ApproveResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "ui-tweak": "ui-tweak";
             research: "research";
         }>>;
+        projectId: z.ZodString;
         currentNode: z.ZodString;
         currentPhase: z.ZodString;
         status: z.ZodString;
@@ -3429,6 +3748,14 @@ declare const CreateTaskResponseSchema: z.ZodObject<{
         skills: z.ZodArray<z.ZodString>;
         agents: z.ZodArray<z.ZodString>;
         upcomingPause: z.ZodNullable<z.ZodString>;
+        toolChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>>;
+        aiChecks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 type CreateTaskResponse = z.infer<typeof CreateTaskResponseSchema>;
@@ -3791,6 +4118,9 @@ interface UpgradePlanItem {
             added: string[];
             removed: string[];
         } | null;
+        /** T202609230001：门禁声明差异可见性（plan 展示用；不参与 contentHash——见 D「hash 残余」声明） */
+        toolChecks: 'changed' | null;
+        aiChecks: 'changed' | null;
     };
 }
 interface UpgradePlanResult {
@@ -4084,4 +4414,4 @@ declare function applyImport(deps: TemplateTransferDeps, targetProjectId: string
 declare const VERSION: string;
 declare function ping(): string;
 
-export { AGENT_MAIN_DOC, ARTIFACT_TYPES, AUTH_COLLECTIONS, type AdvanceDeps, type AdvanceInput, type AdvanceRequest, AdvanceRequestSchema, type AdvanceResponse, AdvanceResponseSchema, type Agent, type AgentCopy, AgentCopySchema, type AgentCreate, AgentCreateSchema, type AgentFunction, AgentFunctionSchema, type AgentPayload, AgentPayloadSchema, type AgentRepo, AgentSchema, type AgentScope, AgentScopeSchema, AgentShapeSchema, type AgentUpdate, AgentUpdateSchema, AppError, type AppErrorOptions, type ApproveRequest, ApproveRequestSchema, type ApproveResponse, ApproveResponseSchema, type ArchNote, ArchNoteSchema, type Artifact, ArtifactSchema, type ArtifactType, type AssetListOpts, type AssetSetEnabled, AssetSetEnabledSchema, type AuthAccount, type AuthAccountCreate, AuthAccountCreateSchema, AuthAccountSchema, type AuthSession, type AuthStatus, AuthStatusSchema, type AuthToken, type AuthTokenGenResponse, AuthTokenGenResponseSchema, type AuthTokenKind, AuthTokenSchema, type AuthTokenStatus, AuthTokenStatusSchema, type AuthTokenType, AuthTokenTypeSchema, type AuthWhoami, AuthWhoamiSchema, BIZ_CODE_MESSAGES, BadRequestError, type BizCode, CONTEXT_VIEWS, type CancelRequest, CancelRequestSchema, type CheckItem, CheckItemSchema, type Composition, type CompositionEdge, CompositionEdgeSchema, CompositionSchema, type Confirmation, ConfirmationSchema, ConflictError, type ContextView, ContextViewSchema, type ConvertGroupOutcome, type CreateTaskResponse, CreateTaskResponseSchema, DAG_PHASES, DAG_TRACKS, DEFAULT_PROJECT_KEY, type DagEdge, DagEdgeSchema, type DagInstance, type DagInstanceNode, DagInstanceNodeSchema, DagInstanceSchema, type DagNode, DagNodePhaseSchema, DagNodeSchema, DagNodeTrackSchema, type DagTemplate, type DagTemplateCopy, DagTemplateCopySchema, type DagTemplateCreate, DagTemplateCreateSchema, type DagTemplateRepo, DagTemplateSchema, type DagTemplateUpdate, DagTemplateUpdateSchema, type Decision, DecisionSchema, type DependencyAction, DependencyActionSchema, type DependencyCheck, DependencyCheckSchema, type DependencyStatus, DependencyStatusSchema, ENTRY_ID_REGEX, EXPORT_FORMAT_VERSION, type EchoItem, EchoItemSchema, type EdgePausePoint, EdgePausePointBaseSchema, EdgePausePointSchema, type EnumEntry, EnumEntrySchema, type EnumRegistry, type EnumRegistryCategory, EnumRegistryCategorySchema, type EnumRegistryRepo, EnumRegistrySchema, type EnumRegistryUpdate, EnumRegistryUpdateSchema, type ExportBundle, ExportBundleSchema, ForbiddenError, HistoryActionSchema, type HistoryEntry, HistoryEntrySchema, ISSUE_ACTIVE_STATUSES, ISSUE_CONVERT_MODES, ISSUE_SOURCES, ISSUE_STATUSES, type ImportApplyRequest, ImportApplyRequestSchema, type ImportApplyResponse, ImportApplyResponseSchema, type ImportDecision, ImportDecisionSchema, type ImportPlanRequest, ImportPlanRequestSchema, type ImportPlanResponse, ImportPlanResponseSchema, type Issue, type IssueConvertMode, IssueConvertModeSchema, type IssueCreate, IssueCreateSchema, type IssueHistoryEntry, IssueHistoryEntrySchema, type IssueListFilter, type IssueProgress, IssueProgressSchema, type IssueRepo, IssueSchema, type IssueSource, IssueSourceSchema, type IssueStatus, type IssueStatusChange, IssueStatusSchema, type IssueTaskSnapshot, type IssueUpdate, IssueUpdateSchema, type IssueWithProgress, type LoginInput, LoginSchema, type ModelAlias, type ModelAliasCreate, ModelAliasCreateSchema, type ModelAliasPayload, ModelAliasPayloadSchema, type ModelAliasRepo, ModelAliasSchema, ModelAliasShapeSchema, type ModelAliasUpdate, ModelAliasUpdateSchema, type ModelAliasWithRefCount, ModelAliasWithRefCountSchema, NODE_ID_PATTERN, NODE_PRESET_CODE_PATTERN, NODE_STATUSES, type NodeContentFields, type NodeInfo, NodeInfoSchema, type NodeLibrary, type NodeLibraryRepo, NodeLibrarySchema, type NodeLibraryUpsert, NodeLibraryUpsertSchema, type NodePreset, type NodePresetCopy, NodePresetCopySchema, type NodePresetCreate, NodePresetCreateSchema, type NodePresetListFilter, type NodePresetRepo, NodePresetSchema, NodePresetShapeSchema, type NodePresetUpdate, NodePresetUpdateSchema, type NodeRecord, NodeRecordSchema, type NodeState, NodeStateSchema, NodeStatusSchema, NotFoundError, OBJECT_ID_HEX, type OmitId, PAUSE_POINT_TYPES, type PasswordChange, PasswordChangeSchema, PausePointTypeSchema, type PauseRequest, PauseRequestSchema, type Project, type ProjectCreate, ProjectCreateSchema, type ProjectRepo, ProjectSchema, type ProjectStatus, ProjectStatusSchema, type ProjectUpdate, ProjectUpdateSchema, type PruneResult, REFERENCE_LIMITS, type ReferenceDoc, type ReopenInput, type ReopenRequest, ReopenRequestSchema, type ReopenResponse, type Repo, type ResumeRequest, ResumeRequestSchema, type ReviewSummary, ReviewSummarySchema, SIMING_CODE_REGEX, SIMING_CONFIG_ENV_KEYS, SIMING_CONFIG_KEYS, SKILL_MAIN_DOC, type SimingClient, type SimingConfig, type SimingConfigKey, SimingConfigSchema, SimingLogLevelSchema, type Skill, type SkillCopy, SkillCopySchema, type SkillCreate, SkillCreateSchema, type SkillPayload, SkillPayloadSchema, type SkillRepo, SkillSchema, type SkillScope, SkillScopeSchema, SkillShapeSchema, type SkillUpdate, SkillUpdateSchema, type SourcePreset, SourcePresetSchema, TASK_PHASES, TASK_STATUSES, TASK_TYPES, TEMPLATE_CODE_MAX_LENGTH, TEMPLATE_CODE_REGEX, type Task, type TaskBatchAck, TaskBatchAckSchema, type TaskBatchEntry, TaskBatchEntrySchema, type TaskBatchFailure, TaskBatchFailureSchema, type TaskContext, TaskContextSchema, type TaskCreateInput, TaskCreateInputSchema, type TaskDocContent, TaskDocContentSchema, type TaskIssueView, type TaskLink, TaskLinkSchema, type TaskPatch, TaskPhaseSchema, type TaskProgress, type TaskProgressPublic, TaskProgressPublicSchema, TaskProgressSchema, type TaskPublic, TaskPublicSchema, type TaskRepo, TaskSchema, TaskStatusSchema, type TaskSummary, TaskSummarySchema, type TaskType, type TemplateCandidate, TemplateCandidateSchema, TemplateCodeFieldSchema, type TemplateContentChanges, type TemplateContentDiff, type TemplateContentSource, type TemplatePayload, TemplatePayloadSchema, type TemplateTransferDeps, UnauthorizedError, type UpgradeAction, UpgradeActionSchema, type UpgradeApplyOutcome, type UpgradeApplyRequest, UpgradeApplyRequestSchema, type UpgradeApplyResultItem, type UpgradeDecision, type UpgradeDecisionInput, UpgradeDecisionSchema, type UpgradeNodeStatus, UpgradeNodeStatusSchema, type UpgradePlanItem, type UpgradePlanResult, VERSION, ValidationError, WRITE_ACK_ENTRY_KINDS, type WithId, type WriteAck, type WriteAckEntryKind, WriteAckEntryKindSchema, WriteAckSchema, advanceTask, applyImport, applyUpgradeDecisions, approveTask, assertBoundSkillsCompatible, assertModelAliasExists, assertReferenceAggregateLimit, assertReferencesDeletable, assertUniqueNodeIds, buildImportPlan, buildTemplateCode, buildUpgradePlan, bumpPatch, bumpPatchOrPassthrough, cancelTask, canonicalizeReferencePath, checkTermination, composeExportBundle, computeNodeContentHash, computeUpgradeStatus, createAgentRepo, createAuthAccountRepo, createAuthSessionRepo, createAuthTokenRepo, createDagTemplateRepo, createEnumRegistryRepo, createIssueRepo, createModelAliasRepo, createMongoClient, createNodeLibraryRepo, createNodePresetRepo, createProjectRepo, createReferencesSchema, createRepo, createSkillRepo, createTaskRepo, decisionKey, derivePreTerminalState, diffTemplateContent, enabledNeFalse, escapeRegExpLiteral, excerpt, findDuplicateNodeIds, findNextEdge, findTemplateByName, generateEntryId, generateProjectKey, generateSessionId, generateToken, hasProjectDefault, hashPassword, hashToken, isLegalTemplateCode, mkHistory, normalizeNameToTemplateCode, parseAuthEnabledEnvValue, pauseTask, ping, pruneInstance, renderPrompt, reopenTask, resumeTask, sumReferenceContentChars, taskProgress, toNodeInfo, toTaskPublic, tokenTypeFromValue, trackMatchSet, verifyPassword, withTransaction };
+export { AGENT_MAIN_DOC, ARTIFACT_TYPES, AUTH_COLLECTIONS, type AdvanceDeps, type AdvanceInput, type AdvanceRequest, AdvanceRequestSchema, type AdvanceResponse, AdvanceResponseSchema, type Agent, type AgentCopy, AgentCopySchema, type AgentCreate, AgentCreateSchema, type AgentFunction, AgentFunctionSchema, type AgentPayload, AgentPayloadSchema, type AgentRepo, AgentSchema, type AgentScope, AgentScopeSchema, AgentShapeSchema, type AgentUpdate, AgentUpdateSchema, type AiCheck, AiCheckSchema, AppError, type AppErrorOptions, type ApproveRequest, ApproveRequestSchema, type ApproveResponse, ApproveResponseSchema, type ArchNote, ArchNoteSchema, type Artifact, ArtifactSchema, type ArtifactType, type AssetListOpts, type AssetSetEnabled, AssetSetEnabledSchema, type AuthAccount, type AuthAccountCreate, AuthAccountCreateSchema, AuthAccountSchema, type AuthSession, type AuthStatus, AuthStatusSchema, type AuthToken, type AuthTokenGenResponse, AuthTokenGenResponseSchema, type AuthTokenKind, AuthTokenSchema, type AuthTokenStatus, AuthTokenStatusSchema, type AuthTokenType, AuthTokenTypeSchema, type AuthWhoami, AuthWhoamiSchema, BIZ_CODE_MESSAGES, BadRequestError, type BizCode, CONTEXT_VIEWS, type CancelRequest, CancelRequestSchema, type CheckItem, CheckItemSchema, type Composition, type CompositionEdge, CompositionEdgeSchema, CompositionSchema, type Confirmation, ConfirmationSchema, ConflictError, type ContextView, ContextViewSchema, type ConvertGroupOutcome, type CreateTaskResponse, CreateTaskResponseSchema, DAG_PHASES, DAG_TRACKS, DEFAULT_PROJECT_KEY, DEFAULT_VCS_DOC_PATHS, type DagEdge, DagEdgeSchema, type DagInstance, type DagInstanceNode, DagInstanceNodeSchema, DagInstanceSchema, type DagNode, DagNodePhaseSchema, DagNodeSchema, DagNodeTrackSchema, type DagTemplate, type DagTemplateCopy, DagTemplateCopySchema, type DagTemplateCreate, DagTemplateCreateSchema, type DagTemplateRepo, DagTemplateSchema, type DagTemplateUpdate, DagTemplateUpdateSchema, type Decision, DecisionSchema, type DependencyAction, DependencyActionSchema, type DependencyCheck, DependencyCheckSchema, type DependencyStatus, DependencyStatusSchema, ENTRY_ID_REGEX, EXPORT_FORMAT_VERSION, type EchoItem, EchoItemSchema, type EdgePausePoint, EdgePausePointBaseSchema, EdgePausePointSchema, type EnumEntry, EnumEntrySchema, type EnumRegistry, type EnumRegistryCategory, EnumRegistryCategorySchema, type EnumRegistryRepo, EnumRegistrySchema, type EnumRegistryUpdate, EnumRegistryUpdateSchema, type ExportBundle, ExportBundleSchema, ForbiddenError, HistoryActionSchema, type HistoryEntry, HistoryEntrySchema, ISSUE_ACTIVE_STATUSES, ISSUE_CONVERT_MODES, ISSUE_SOURCES, ISSUE_STATUSES, type ImportApplyRequest, ImportApplyRequestSchema, type ImportApplyResponse, ImportApplyResponseSchema, type ImportDecision, ImportDecisionSchema, type ImportPlanRequest, ImportPlanRequestSchema, type ImportPlanResponse, ImportPlanResponseSchema, type Issue, type IssueConvertMode, IssueConvertModeSchema, type IssueCreate, IssueCreateSchema, type IssueHistoryEntry, IssueHistoryEntrySchema, type IssueListFilter, type IssueProgress, IssueProgressSchema, type IssueRepo, IssueSchema, type IssueSource, IssueSourceSchema, type IssueStatus, type IssueStatusChange, IssueStatusSchema, type IssueTaskSnapshot, type IssueUpdate, IssueUpdateSchema, type IssueWithProgress, type LoginInput, LoginSchema, type ModelAlias, type ModelAliasCreate, ModelAliasCreateSchema, type ModelAliasPayload, ModelAliasPayloadSchema, type ModelAliasRepo, ModelAliasSchema, ModelAliasShapeSchema, type ModelAliasUpdate, ModelAliasUpdateSchema, type ModelAliasWithRefCount, ModelAliasWithRefCountSchema, NODE_CHECKS_MAX, NODE_ID_PATTERN, NODE_PRESET_CODE_PATTERN, NODE_STATUSES, type NodeContentFields, type NodeInfo, NodeInfoSchema, type NodeLibrary, type NodeLibraryRepo, NodeLibrarySchema, type NodeLibraryUpsert, NodeLibraryUpsertSchema, type NodePreset, type NodePresetCopy, NodePresetCopySchema, type NodePresetCreate, NodePresetCreateSchema, type NodePresetListFilter, type NodePresetRepo, NodePresetSchema, NodePresetShapeSchema, type NodePresetUpdate, NodePresetUpdateSchema, type NodeRecord, NodeRecordSchema, type NodeState, NodeStateSchema, NodeStatusSchema, NotFoundError, OBJECT_ID_HEX, type OmitId, PAUSE_POINT_TYPES, type PasswordChange, PasswordChangeSchema, PausePointTypeSchema, type PauseRequest, PauseRequestSchema, type Project, type ProjectCreate, ProjectCreateSchema, type ProjectRepo, ProjectSchema, type ProjectStatus, ProjectStatusSchema, type ProjectUpdate, ProjectUpdateSchema, type PruneResult, REFERENCE_LIMITS, type ReferenceDoc, type ReopenInput, type ReopenRequest, ReopenRequestSchema, type ReopenResponse, type Repo, type ResumeRequest, ResumeRequestSchema, type ReviewSummary, ReviewSummarySchema, SIMING_CODE_REGEX, SIMING_CONFIG_ENV_KEYS, SIMING_CONFIG_KEYS, SKILL_MAIN_DOC, type SimingClient, type SimingConfig, type SimingConfigKey, SimingConfigSchema, SimingLogLevelSchema, type Skill, type SkillCopy, SkillCopySchema, type SkillCreate, SkillCreateSchema, type SkillPayload, SkillPayloadSchema, type SkillRepo, SkillSchema, type SkillScope, SkillScopeSchema, SkillShapeSchema, type SkillUpdate, SkillUpdateSchema, type SourcePreset, SourcePresetSchema, TASK_PHASES, TASK_STATUSES, TASK_TYPES, TEMPLATE_CODE_MAX_LENGTH, TEMPLATE_CODE_REGEX, type Task, type TaskBatchAck, TaskBatchAckSchema, type TaskBatchEntry, TaskBatchEntrySchema, type TaskBatchFailure, TaskBatchFailureSchema, type TaskContext, TaskContextSchema, type TaskCreateInput, TaskCreateInputSchema, type TaskDocContent, TaskDocContentSchema, type TaskIssueView, type TaskLink, TaskLinkSchema, type TaskPatch, TaskPhaseSchema, type TaskProgress, type TaskProgressPublic, TaskProgressPublicSchema, TaskProgressSchema, type TaskPublic, TaskPublicSchema, type TaskRepo, TaskSchema, TaskStatusSchema, type TaskSummary, TaskSummarySchema, type TaskType, type TemplateCandidate, TemplateCandidateSchema, TemplateCodeFieldSchema, type TemplateContentChanges, type TemplateContentDiff, type TemplateContentSource, type TemplatePayload, TemplatePayloadSchema, type TemplateTransferDeps, type TestReport, TestReportSchema, type ToolCheck, ToolCheckSchema, UnauthorizedError, type UpgradeAction, UpgradeActionSchema, type UpgradeApplyOutcome, type UpgradeApplyRequest, UpgradeApplyRequestSchema, type UpgradeApplyResultItem, type UpgradeDecision, type UpgradeDecisionInput, UpgradeDecisionSchema, type UpgradeNodeStatus, UpgradeNodeStatusSchema, type UpgradePlanItem, type UpgradePlanResult, VERSION, ValidationError, type VcsConfig, VcsConfigSchema, WRITE_ACK_ENTRY_KINDS, type WithId, type WriteAck, type WriteAckEntryKind, WriteAckEntryKindSchema, WriteAckSchema, advanceTask, applyImport, applyUpgradeDecisions, approveTask, assertBoundSkillsCompatible, assertModelAliasExists, assertReferenceAggregateLimit, assertReferencesDeletable, assertUniqueAiCheckIds, assertUniqueNodeIds, buildImportPlan, buildTemplateCode, buildUpgradePlan, bumpPatch, bumpPatchOrPassthrough, cancelTask, canonicalizeReferencePath, checkTermination, composeExportBundle, computeNodeContentHash, computeUpgradeStatus, createAgentRepo, createAuthAccountRepo, createAuthSessionRepo, createAuthTokenRepo, createDagTemplateRepo, createEnumRegistryRepo, createIssueRepo, createModelAliasRepo, createMongoClient, createNodeLibraryRepo, createNodePresetRepo, createProjectRepo, createReferencesSchema, createRepo, createSkillRepo, createTaskRepo, decisionKey, derivePreTerminalState, diffTemplateContent, enabledNeFalse, escapeRegExpLiteral, excerpt, findDuplicateNodeIds, findNextEdge, findTemplateByName, generateEntryId, generateProjectKey, generateSessionId, generateToken, hasProjectDefault, hashPassword, hashToken, isLegalTemplateCode, mkHistory, normalizeNameToTemplateCode, parseAuthEnabledEnvValue, pauseTask, ping, pruneInstance, renderPrompt, reopenTask, resumeTask, sumReferenceContentChars, taskProgress, toNodeInfo, toTaskPublic, tokenTypeFromValue, trackMatchSet, verifyPassword, withTransaction };

package/dist/index.js

@@ -157,7 +157,8 @@ var BIZ_CODE_MESSAGES = {
   UPGRADE_DECISION_REQUIRED: "\u672C\u5730\u5DF2\u4FEE\u6539\u7684\u8282\u70B9\u5FC5\u987B\u663E\u5F0F\u51B3\u7B56\uFF08upgrade/keep/skip\uFF09",
   UPGRADE_STALE: "\u6A21\u677F\u72B6\u6001\u4E0E\u5347\u7EA7\u8BA1\u5212\u4E0D\u7B26\uFF08\u8BA1\u5212\u540E\u6A21\u677F\u5DF2\u88AB\u7F16\u8F91\uFF09\uFF0C\u8BF7\u91CD\u65B0\u83B7\u53D6\u5347\u7EA7\u8BA1\u5212",
   FLOW_MANIFEST_INVALID: "\u8282\u70B9\u5E93 manifest \u683C\u5F0F\u6216\u7248\u672C\u4E0D\u652F\u6301",
-  // T202609150002：问题池域（message 由路由层按状态差异化——已转任务携带关联任务标识 / 已取消提示废弃）
+  // T202609150002：问题池域（终态含 done 自身，T202609200001；message 由路由层按状态差异化——
+  // 已转任务携带关联任务标识 / 已取消提示废弃 / done 提示不可再次终态）
   ISSUE_NOT_FOUND: "\u95EE\u9898\u4E0D\u5B58\u5728",
   ISSUE_INVALID_TRANSITION: "\u95EE\u9898\u5DF2\u662F\u7EC8\u6001\uFF0C\u7981\u6B62\u8BE5\u64CD\u4F5C\uFF08\u7EC8\u6001\u65E0\u56DE\u8F6C\uFF09",
   ISSUE_PROJECT_MISMATCH: "\u95EE\u9898\u4E0E\u76EE\u6807\u9879\u76EE\u5F52\u5C5E\u4E0D\u4E00\u81F4\uFF0C\u7981\u6B62\u8DE8\u9879\u76EE\u7EC4\u5408\u8F6C\u51FA",
@@ -731,6 +732,26 @@ var SourcePresetSchema = z3.object({
   /** Agent 名称独立基线；不改变既有 contentHash 算法，存量缺键按空清单比较 */
   agents: capabilityNamesSchema.optional()
 });
+var ToolCheckSchema = z3.object({
+  type: z3.string().min(1).max(50).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "toolCheck.type \u5FC5\u987B\u4E3A kebab-case \u6CE8\u518C\u8868\u952E"),
+  params: z3.record(z3.string(), z3.union([z3.string(), z3.number(), z3.boolean()])).optional()
+});
+var AiCheckSchema = z3.object({
+  id: z3.string().min(2).max(30).regex(/^[a-z0-9-]+$/, "aiCheck.id \u53EA\u5141\u8BB8\u5C0F\u5199\u5B57\u6BCD/\u6570\u5B57/\u8FDE\u5B57\u7B26"),
+  item: z3.string().min(1).max(200)
+});
+var NODE_CHECKS_MAX = 20;
+function assertUniqueAiCheckIds(nodes) {
+  for (const node of nodes) {
+    const seen = /* @__PURE__ */ new Set();
+    for (const check of node.aiChecks ?? []) {
+      if (seen.has(check.id)) {
+        throw new Error(`\u8282\u70B9 ${node.id} \u7684 aiCheck id \u91CD\u590D\uFF1A${check.id}\uFF08\u8282\u70B9\u5185\u987B\u552F\u4E00\uFF0CrefId \u5339\u914D\u4F9D\u8D56\uFF09`);
+      }
+      seen.add(check.id);
+    }
+  }
+}
 var DagNodeSchema = z3.object({
   id: z3.string().regex(NODE_ID_PATTERN, "node id \u53EA\u5141\u8BB8\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF/\u8FDE\u5B57\u7B26\uFF08\u70B9\u8DEF\u5F84\u62FC\u63A5\u5B89\u5168\u524D\u63D0\uFF09"),
   label: z3.string(),
@@ -740,7 +761,11 @@ var DagNodeSchema = z3.object({
   skills: capabilityNamesSchema.default([]),
   /** 存量模板允许缺键；新组装和任务实例化路径写入完整数组 */
   agents: capabilityNamesSchema.optional(),
-  sourcePreset: SourcePresetSchema.optional()
+  sourcePreset: SourcePresetSchema.optional(),
+  /** T202609230001：工具类门禁声明（可选——存量模板/任务零迁移，读侧 ?? [] 归一） */
+  toolChecks: z3.array(ToolCheckSchema).max(NODE_CHECKS_MAX).optional(),
+  /** T202609230001：AI 自检项声明（同上，值拷贝进任务实例随资料包分发） */
+  aiChecks: z3.array(AiCheckSchema).max(NODE_CHECKS_MAX).optional()
 });
 var PausePointTypeSchema = z3.enum(["human_approval", "checkpoint"]);
 var PAUSE_POINT_TYPES = ["human_approval", "checkpoint"];
@@ -1045,7 +1070,9 @@ var ENTRY_ID_REGEX = /^[a-z0-9]{6}$/;
 var CheckItemSchema = z4.object({
   id: z4.string().regex(ENTRY_ID_REGEX),
   item: z4.string().min(1),
-  passed: z4.boolean()
+  passed: z4.boolean(),
+  source: z4.enum(["self", "tool"]).optional(),
+  refId: z4.string().min(2).max(30).optional()
 });
 var ARTIFACT_TYPES = ["prd", "tech", "code", "test", "doc", "other"];
 var ArtifactSchema = z4.object({
@@ -1070,13 +1097,25 @@ var ReviewSummarySchema = z4.object({
   rounds: z4.number().int().min(1),
   critical: z4.number().int().min(0)
 });
+var TestReportSchema = z4.object({
+  command: z4.string().min(1).max(200),
+  passed: z4.number().int().min(0),
+  failed: z4.number().int().min(0),
+  skipped: z4.number().int().min(0)
+});
 var NodeRecordSchema = z4.object({
   summary: z4.string().optional(),
   checks: z4.array(CheckItemSchema).default([]),
   artifacts: z4.array(ArtifactSchema).default([]),
   confirmations: z4.array(ConfirmationSchema).default([]),
   decisions: z4.array(DecisionSchema).default([]),
-  review: ReviewSummarySchema.optional()
+  review: ReviewSummarySchema.optional(),
+  baseBranch: z4.string().min(1).max(50).optional(),
+  verifiedCommit: z4.string().min(7).max(40).optional(),
+  fixesApplied: z4.number().int().min(0).optional(),
+  testReport: TestReportSchema.optional(),
+  deferredIssues: z4.array(z4.string()).max(20).optional(),
+  evidenceFiles: z4.array(z4.string()).max(50).optional()
 });
 var TaskDocContentSchema = z4.object({
   what: z4.string().min(1),
@@ -1105,7 +1144,10 @@ var DagInstanceNodeSchema = z4.object({
   track: z4.string(),
   prompt: z4.string(),
   skills: z4.array(z4.string()).default([]),
-  agents: z4.array(z4.string()).default([])
+  agents: z4.array(z4.string()).default([]),
+  // T202609230001：门禁配置快照（创建时值拷贝——模板升版不回溯在途任务，行为可预期）
+  toolChecks: z4.array(ToolCheckSchema).optional(),
+  aiChecks: z4.array(AiCheckSchema).optional()
 });
 var DagInstanceSchema = z4.object({
   templateId: z4.string(),
@@ -1121,7 +1163,7 @@ var DagInstanceSchema = z4.object({
   prunedNodes: z4.array(z4.string()),
   nodeStates: z4.record(z4.string(), NodeStateSchema)
 });
-var HistoryActionSchema = z4.enum(["entered", "advanced", "paused", "resumed", "approved", "rejected", "completed", "cancelled", "reopened"]);
+var HistoryActionSchema = z4.enum(["entered", "advanced", "paused", "resumed", "approved", "rejected", "completed", "cancelled", "reopened", "checks_rejected"]);
 var HistoryEntrySchema = z4.object({
   nodeId: z4.string(),
   action: HistoryActionSchema,
@@ -1628,6 +1670,8 @@ function toTaskPublic(task) {
     title: task.title,
     // T202608240003：type 进 context/advance 公共投影（模板 PRD 调研变体判定依赖 context 可见）
     ...task.type !== void 0 ? { type: task.type } : {},
+    // T202609230001：projectId 进公共投影（advance 门禁读项目 vcs 配置；实体层恒有值——N012 去哨兵）
+    projectId: task.projectId,
     currentNode: task.currentNode,
     currentPhase: task.currentPhase,
     status: task.status,
@@ -1649,7 +1693,10 @@ function toNodeInfo(node, task) {
     prompt: renderPrompt(node.prompt, task),
     skills: node.skills,
     agents: node.agents ?? [],
-    upcomingPause: nextEdge?.pausePoint?.description ?? null
+    upcomingPause: nextEdge?.pausePoint?.description ?? null,
+    // T202609230001：门禁项注入（?? [] 归一——存量节点缺字段时响应恒为数组）
+    toolChecks: node.toolChecks ?? [],
+    aiChecks: node.aiChecks ?? []
   };
 }
 function mkHistory(nodeId, action, details) {
@@ -2034,7 +2081,10 @@ function deepCopyNode(node) {
     track: node.track,
     prompt: node.prompt,
     skills: [...node.skills],
-    agents: [...node.agents ?? []]
+    agents: [...node.agents ?? []],
+    // T202609230001：门禁配置快照（显式枚举拷贝——不同步即丢，浅拷贝数组与 skills 同范式）
+    ...node.toolChecks ? { toolChecks: node.toolChecks.map((c) => c.params ? { ...c, params: { ...c.params } } : { ...c }) } : {},
+    ...node.aiChecks ? { aiChecks: node.aiChecks.map((c) => ({ ...c })) } : {}
   };
 }
 function deepCopyEdge(edge) {
@@ -2063,7 +2113,7 @@ function generateEntryId(existing) {
 
 // src/schemas/issue.ts
 import { z as z5 } from "zod";
-var ISSUE_STATUSES = ["pending", "partial", "converted", "cancelled"];
+var ISSUE_STATUSES = ["pending", "partial", "converted", "cancelled", "done"];
 var IssueStatusSchema = z5.enum(ISSUE_STATUSES);
 var ISSUE_ACTIVE_STATUSES = ["pending", "partial"];
 var ISSUE_SOURCES = ["mcp", "cli", "web"];
@@ -2095,6 +2145,8 @@ var IssueSchema = z5.object({
   source: IssueSourceSchema,
   projectId: z5.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex"),
   status: IssueStatusSchema.default("pending"),
+  /** 人类审批原话（T202609200001：AI 通道 mcp/cli 录入必须携带用户批准时的原文逐字，供事后审计；Web 豁免——人工录入天然即批准） */
+  approved: z5.string().min(1).max(500).optional(),
   taskLinks: z5.array(TaskLinkSchema).default([]),
   history: z5.array(IssueHistoryEntrySchema).default([]),
   createdAt: z5.date().optional(),
@@ -2102,7 +2154,8 @@ var IssueSchema = z5.object({
 });
 var IssueCreateSchema = z5.object({
   title: z5.string().min(1).max(200),
-  description: z5.string().max(1e4).optional()
+  description: z5.string().max(1e4).optional(),
+  approved: z5.string().min(1).max(500).optional()
 });
 var IssueUpdateSchema = z5.object({
   title: z5.string().min(1).max(200).optional(),
@@ -2145,6 +2198,8 @@ function createIssueRepo(db) {
         issueId,
         title: data.title,
         ...data.description !== void 0 ? { description: data.description } : {},
+        // 审批原话（T202609200001）：AI 通道强制已在 server 路由层校验，repo 仅透传落库
+        ...data.approved !== void 0 ? { approved: data.approved } : {},
         source,
         projectId,
         status: "pending",
@@ -2179,7 +2234,7 @@ function createIssueRepo(db) {
       if (!current) {
         throw new NotFoundError("issue", issueId, { bizCode: "ISSUE_NOT_FOUND" });
       }
-      if (current.status === "converted" || current.status === "cancelled") {
+      if (current.status === "converted" || current.status === "cancelled" || current.status === "done") {
         throw new ConflictError("issue", issueId, {
           bizCode: "ISSUE_INVALID_TRANSITION",
           message: `\u95EE\u9898\u5DF2\u662F\u7EC8\u6001\uFF08${String(current.status)}\uFF09\uFF0C\u7981\u6B62\u53D6\u6D88`
@@ -2220,7 +2275,45 @@ function createIssueRepo(db) {
       if (!result) {
         throw new ConflictError("issue", issueId, {
           bizCode: "ISSUE_INVALID_TRANSITION",
-          message: "\u95EE\u9898\u5DF2\u88AB\u5E76\u53D1\u5904\u7406\uFF08\u8F6C\u51FA/\u53D6\u6D88\uFF09\uFF0C\u8BF7\u5237\u65B0\u540E\u91CD\u8BD5"
+          message: "\u95EE\u9898\u5DF2\u88AB\u5E76\u53D1\u5904\u7406\uFF08\u8F6C\u51FA/\u53D6\u6D88/\u5B8C\u6210\uFF09\uFF0C\u8BF7\u5237\u65B0\u540E\u91CD\u8BD5"
+        });
+      }
+      return toEntity(result);
+    },
+    async markDone(issueId, note) {
+      const current = await base._collection.findOne({ issueId });
+      if (!current) {
+        throw new NotFoundError("issue", issueId, { bizCode: "ISSUE_NOT_FOUND" });
+      }
+      if (current.status === "converted" || current.status === "cancelled" || current.status === "done") {
+        throw new ConflictError("issue", issueId, {
+          bizCode: "ISSUE_INVALID_TRANSITION",
+          message: `\u95EE\u9898\u5DF2\u662F\u7EC8\u6001\uFF08${String(current.status)}\uFF09\uFF0C\u7981\u6B62\u6807\u8BB0\u5B8C\u6210`
+        });
+      }
+      const now = /* @__PURE__ */ new Date();
+      const result = await base._collection.findOneAndUpdate(
+        // 并发安全带：读后窗口内外部转出/取消/完成 → 命中 0 行报终态冲突（终态以先到者为准）
+        { issueId, status: { $in: ISSUE_ACTIVE_STATUSES } },
+        {
+          $set: { status: "done", updatedAt: now },
+          $push: {
+            history: {
+              id: generateEntryId([]),
+              action: "status-change",
+              from: current.status,
+              to: "done",
+              ...note !== void 0 ? { reason: note } : {},
+              at: now
+            }
+          }
+        },
+        { returnDocument: "after" }
+      );
+      if (!result) {
+        throw new ConflictError("issue", issueId, {
+          bizCode: "ISSUE_INVALID_TRANSITION",
+          message: "\u95EE\u9898\u5DF2\u88AB\u5E76\u53D1\u5904\u7406\uFF08\u8F6C\u51FA/\u53D6\u6D88/\u5B8C\u6210\uFF09\uFF0C\u8BF7\u5237\u65B0\u540E\u91CD\u8BD5"
         });
       }
       return toEntity(result);
@@ -3250,6 +3343,8 @@ var TaskPublicSchema = z10.object({
   title: z10.string(),
   // T202608240003：任务类型标签（缺省 = 裸任务/旧任务；模板 PRD 调研变体判定消费）
   type: z10.enum(TASK_TYPES).optional(),
+  /** T202609230001：归属项目（CLI advance 门禁经 context 直取 projectId 读项目 vcs 配置，免额外实体查询） */
+  projectId: z10.string(),
   currentNode: z10.string(),
   currentPhase: z10.string(),
   status: z10.string(),
@@ -3263,7 +3358,13 @@ var NodeInfoSchema = z10.object({
   prompt: z10.string(),
   skills: z10.array(z10.string()),
   agents: z10.array(z10.string()),
-  upcomingPause: z10.string().nullable()
+  upcomingPause: z10.string().nullable(),
+  /**
+   * T202609230001：门禁项随资料包注入（四响应单源 toNodeInfo）——响应恒为数组（?? [] 归一），
+   * 每节点注入即红线自动重申（对抗长上下文漂移）；AI 据此先自检后推进。
+   */
+  toolChecks: z10.array(ToolCheckSchema).default([]),
+  aiChecks: z10.array(AiCheckSchema).default([])
 });
 var AdvanceResponseSchema = z10.discriminatedUnion("status", [
   z10.object({
@@ -3321,6 +3422,8 @@ var TaskContextSchema = z11.object({
     title: z11.string(),
     // T202608240003：与 TaskPublicSchema 同步（toTaskPublic 运行时已产出，schema 声明漂移会导致 typed 消费方 strip 掉 type）
     type: z11.enum(TASK_TYPES).optional(),
+    // T202609230001：与 TaskPublicSchema 同步（advance 门禁读项目 vcs 配置依赖）
+    projectId: z11.string(),
     currentNode: z11.string(),
     currentPhase: z11.string(),
     status: z11.string(),
@@ -3337,7 +3440,13 @@ var TaskContextSchema = z11.object({
     skills: z11.array(z11.string()),
     agents: z11.array(z11.string()),
     /** 完成当前节点后出边上的暂停点描述（经 findNextEdge 按轨选边） */
-    upcomingPause: z11.string().nullable()
+    upcomingPause: z11.string().nullable(),
+    /**
+     * T202609230001：门禁项注入（与 NodeInfoSchema 同步的内联镜像——CLI 侧
+     * TaskContext['currentNode'] 类型取门禁项供 advance 前置校验消费）。
+     */
+    toolChecks: z11.array(ToolCheckSchema).default([]),
+    aiChecks: z11.array(AiCheckSchema).default([])
   }).nullable(),
   pausedAtEdge: z11.object({
     from: z11.string(),
@@ -3352,6 +3461,12 @@ var TaskContextSchema = z11.object({
     enteredAt: z11.date().nullable(),
     completedAt: z11.date().nullable()
   })),
+  /**
+   * T202609230001：实例有向边表（B6 前序闭包判定数据源——「前序」按 DAG 拓扑而非列表序，
+   * 后继 pending 节点不算前序）。旧 server 不携带 → 客户端 ?? [] 兜底（闭包为空 = 不拦截，
+   * 老组合形态本就无门禁，不构成静默放行新增面）。
+   */
+  edges: z11.array(z11.object({ from: z11.string(), to: z11.string() })).default([]),
   /** N020 D1：任务级结构化文档（未写时 null） */
   taskDoc: TaskDocContentSchema.nullable(),
   /** N020 D1：节点执行记录（仅含已写记录的 nodeId） */
@@ -3451,12 +3566,30 @@ var ContextViewSchema = z12.enum(CONTEXT_VIEWS);
 // src/schemas/project.ts
 import { z as z13 } from "zod";
 var ProjectStatusSchema = z13.enum(["active", "archived"]);
+var VcsConfigSchema = z13.object({
+  /** false=项目级豁免：全部 git 类检查 N/A（纯文档/无分支模型项目不误拦） */
+  enabled: z13.boolean().optional(),
+  /** 基础分支（参数解析链第 2 级；第 1 级=nodeRecords[ALIGN].baseBranch） */
+  baseBranch: z13.string().min(1).max(50).optional(),
+  /** 仓库绝对路径（MCP 宿主 cwd 未必是任务仓库时由管理台配置；缺省=cwd 探测） */
+  repoPath: z13.string().min(1).optional(),
+  /** 任务分支前缀模式（A1 判定用） */
+  branchPattern: z13.string().min(1).max(50).optional(),
+  /** true=worktree 并行模式（A6 停留子项 N/A——主工作区停留基础分支由主会话承载） */
+  worktreeMode: z13.boolean().optional(),
+  /** false=项目声明无分支归档流程（A5 N/A；表达「有分支模型但无归档流程」粒度） */
+  archiveToBase: z13.boolean().optional(),
+  /** B7 版本一致判定的豁免路径清单（文档/临时产物） */
+  docPaths: z13.array(z13.string().min(1)).max(50).optional()
+});
+var DEFAULT_VCS_DOC_PATHS = ["ProjectHub/", "docs/", "temp/", "*.md"];
 var ProjectSchema = z13.object({
   id: z13.string().optional(),
   key: z13.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09"),
   name: z13.string().min(1).max(50),
   description: z13.string().max(500).optional(),
   status: ProjectStatusSchema.default("active"),
+  vcs: VcsConfigSchema.optional(),
   createdAt: z13.date().optional(),
   updatedAt: z13.date().optional()
 });
@@ -3468,7 +3601,8 @@ var ProjectCreateSchema = z13.object({
 var ProjectUpdateSchema = z13.object({
   name: z13.string().min(1).max(50).optional(),
   description: z13.string().max(500).optional(),
-  status: ProjectStatusSchema.optional()
+  status: ProjectStatusSchema.optional(),
+  vcs: VcsConfigSchema.optional()
 });
 
 // src/schemas/enum-registry.ts
@@ -3621,6 +3755,12 @@ var NodePresetShapeSchema = z17.object({
   version: z17.string(),
   /** 分发来源标注（flow install 落库时填充包名；手工创建无此字段——「来源可见可核查」信任模型） */
   source: z17.object({ package: z17.string().min(1) }).optional(),
+  /**
+   * T202609230001：门禁声明（与 DagNodeSchema 同形）。此层不同步则 flow install 写入
+   * 资产时 Zod strip 未知键——字段在资产入库时静默丢弃（分发链中段 F1 同步点）。
+   */
+  toolChecks: z17.array(ToolCheckSchema).max(NODE_CHECKS_MAX).optional(),
+  aiChecks: z17.array(AiCheckSchema).max(NODE_CHECKS_MAX).optional(),
   /** 资产启停（可选——存量无此字段 = 启用；唯一写入口 POST /:code/enabled，不入 Create/Update/Copy） */
   enabled: z17.boolean().optional(),
   createdAt: z17.date().optional(),
@@ -3859,8 +3999,13 @@ var EMPTY_DIFF = {
   phase: null,
   track: null,
   skills: null,
-  agents: null
+  agents: null,
+  toolChecks: null,
+  aiChecks: null
 };
+function sameChecks(left, right) {
+  return JSON.stringify(left ?? []) === JSON.stringify(right ?? []);
+}
 function diffNames(beforeNames, afterNames) {
   const before = new Set(beforeNames);
   const after = new Set(afterNames);
@@ -3878,7 +4023,9 @@ function diffNodeAgainstPreset(node, preset) {
     phase: node.phase === preset.phase ? null : "changed",
     track: node.track === preset.track ? null : "changed",
     skills: diffNames(node.skills, preset.skills),
-    agents: diffNames(node.agents ?? [], preset.agents ?? [])
+    agents: diffNames(node.agents ?? [], preset.agents ?? []),
+    toolChecks: sameChecks(node.toolChecks, preset.toolChecks) ? null : "changed",
+    aiChecks: sameChecks(node.aiChecks, preset.aiChecks) ? null : "changed"
   };
 }
 function computeUpgradeStatus(node, latest) {
@@ -3943,6 +4090,9 @@ function applyUpgradeDecisions(template, presetsByCode, decisions) {
     ...node,
     skills: [...node.skills],
     agents: [...node.agents ?? []],
+    // T202609230001：门禁声明数组重建（同 skills 范式——keep 分支保留本地值时亦不共享引用）
+    ...node.toolChecks ? { toolChecks: node.toolChecks.map((c) => c.params ? { ...c, params: { ...c.params } } : { ...c }) } : {},
+    ...node.aiChecks ? { aiChecks: node.aiChecks.map((c) => ({ ...c })) } : {},
     ...node.sourcePreset ? {
       sourcePreset: {
         ...node.sourcePreset,
@@ -4018,6 +4168,8 @@ function applyUpgradeDecisions(template, presetsByCode, decisions) {
       working.prompt = latest.prompt;
       working.skills = [...latest.skills];
       working.agents = [...latest.agents ?? []];
+      working.toolChecks = latest.toolChecks?.map((c) => c.params ? { ...c, params: { ...c.params } } : { ...c });
+      working.aiChecks = latest.aiChecks?.map((c) => ({ ...c }));
       working.sourcePreset = {
         code: source.code,
         version: latest.version,
@@ -4302,6 +4454,7 @@ async function applyImport(deps, targetProjectId, bundle, decisions) {
     throw new ValidationError("\u6A21\u677F\u5185\u5BB9\u6821\u9A8C\u5931\u8D25\uFF08\u5BFC\u5165\u6587\u4EF6\u5B57\u6BB5\u975E\u6CD5\uFF09", parsed.error.issues);
   }
   assertUniqueNodeIds(nodesForWrite);
+  assertUniqueAiCheckIds(nodesForWrite);
   const contentFields = {
     name: tplPayload.name,
     description: tplPayload.description,
@@ -4497,6 +4650,7 @@ export {
   AgentScopeSchema,
   AgentShapeSchema,
   AgentUpdateSchema,
+  AiCheckSchema,
   AppError,
   ApproveRequestSchema,
   ApproveResponseSchema,
@@ -4525,6 +4679,7 @@ export {
   DAG_PHASES,
   DAG_TRACKS,
   DEFAULT_PROJECT_KEY,
+  DEFAULT_VCS_DOC_PATHS,
   DagEdgeSchema,
   DagInstanceNodeSchema,
   DagInstanceSchema,
@@ -4576,6 +4731,7 @@ export {
   ModelAliasShapeSchema,
   ModelAliasUpdateSchema,
   ModelAliasWithRefCountSchema,
+  NODE_CHECKS_MAX,
   NODE_ID_PATTERN,
   NODE_PRESET_CODE_PATTERN,
   NODE_STATUSES,
@@ -4640,6 +4796,8 @@ export {
   TemplateCandidateSchema,
   TemplateCodeFieldSchema,
   TemplatePayloadSchema,
+  TestReportSchema,
+  ToolCheckSchema,
   UnauthorizedError,
   UpgradeActionSchema,
   UpgradeApplyRequestSchema,
@@ -4647,6 +4805,7 @@ export {
   UpgradeNodeStatusSchema,
   VERSION,
   ValidationError,
+  VcsConfigSchema,
   WRITE_ACK_ENTRY_KINDS,
   WriteAckEntryKindSchema,
   WriteAckSchema,
@@ -4658,6 +4817,7 @@ export {
   assertModelAliasExists,
   assertReferenceAggregateLimit,
   assertReferencesDeletable,
+  assertUniqueAiCheckIds,
   assertUniqueNodeIds,
   buildImportPlan,
   buildTemplateCode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siming-org/core",
-  "version": "0.7.4",
+  "version": "0.8.1",
   "license": "MIT",
   "author": "Wuchao",
   "engines": {