@siming-org/core 0.6.5 → 0.7.0

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 import { readFileSync } from "fs";
-import { z as z20 } from "zod";
+import { z as z21 } from "zod";
 
 // src/store/client.ts
 import { MongoClient } from "mongodb";
@@ -62,9 +62,9 @@ function createRepo(collection, options = {}) {
       const doc = await collection.findOne({ [nameField]: name });
       return doc ? toEntity(doc) : null;
     },
-    async create(data) {
+    async create(data, session) {
       const now = /* @__PURE__ */ new Date();
-      const result = await collection.insertOne({ ...data, createdAt: now, updatedAt: now });
+      const result = await collection.insertOne({ ...data, createdAt: now, updatedAt: now }, ...session ? [{ session }] : []);
       return { ...data, createdAt: now, updatedAt: now, id: result.insertedId.toString() };
     },
     async update(id, patch) {
@@ -129,6 +129,9 @@ var BIZ_CODE_MESSAGES = {
   CHECK_NOT_FOUND: "\u5B8C\u6210\u5224\u5B9A\u6761\u76EE\u4E0D\u5B58\u5728\uFF08id \u5931\u6548\u6216\u5DF2\u88AB\u8986\u76D6\uFF0C\u91CD\u65B0 task context \u67E5\u770B\u6761\u76EE\uFF09",
   NODE_RECORD_NOT_WRITABLE: "\u8282\u70B9\u8BB0\u5F55\u4E0D\u53EF\u5199\uFF08\u8282\u70B9\u672A\u6FC0\u6D3B/\u5DF2\u8DF3\u8FC7\u2014\u2014\u6D41\u7A0B\u672A\u63A8\u8FDB\u5230\u8BE5\u8282\u70B9\uFF09",
   TASK_TERMINATED: "\u4EFB\u52A1\u5DF2\u5B8C\u7ED3\uFF08completed/cancelled\uFF09\uFF0C\u7981\u6B62\u5199\u5165",
+  // T202609130009：终态重开域（不复用 TASK_TERMINATED——调用方语义相反，同码不同义污染按码判定）
+  TASK_NOT_TERMINATED: "\u4EFB\u52A1\u975E\u7EC8\u6001\uFF08active/paused\uFF09\uFF0C\u65E0\u9700\u91CD\u5F00",
+  TASK_FINALIZE_CONFIRMATION_REQUIRED: "\u4EFB\u52A1\u4F4D\u4E8E\u6700\u540E\u8282\u70B9\uFF1A\u786E\u8BA4\u5168\u90E8\u4EA7\u51FA\u5B8C\u6574\u540E\uFF0C\u643A\u5E26\u6536\u5C3E\u786E\u8BA4\uFF08finalize\uFF09\u91CD\u65B0\u63A8\u8FDB",
   // T202608240003：类型化任务节点路径（创建时剪枝 + 类型×轨道入口校验）
   TASK_PRUNE_GRAPH_INVALID: "\u526A\u679D\u540E DAG \u56FE\u4E0D\u5B8C\u6574\uFF08\u8282\u70B9\u6E05\u5355\u4E0E\u6A21\u677F\u7ED3\u6784\u4E0D\u517C\u5BB9\uFF0C\u89C1\u9519\u8BEF\u8BE6\u60C5\uFF09",
   TASK_SKIP_NODE_NOT_FOUND: "skip \u6E05\u5355\u542B\u6A21\u677F\u4E0D\u5B58\u5728\u7684\u8282\u70B9 id\uFF08\u89C1\u9519\u8BEF\u8BE6\u60C5\u7684\u5408\u6CD5\u8282\u70B9\u6E05\u5355\uFF09",
@@ -153,7 +156,12 @@ var BIZ_CODE_MESSAGES = {
   NODE_LIBRARY_COMPOSITION_NOT_FOUND: "\u7EC4\u5408\u5B9A\u4E49\u4E0D\u5B58\u5728\uFF08\u591A\u5E93\u540C\u540D\u7EC4\u5408\u9700\u663E\u5F0F\u6307\u5B9A\u6765\u6E90\u5E93\uFF09",
   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"
+  FLOW_MANIFEST_INVALID: "\u8282\u70B9\u5E93 manifest \u683C\u5F0F\u6216\u7248\u672C\u4E0D\u652F\u6301",
+  // T202609150002：问题池域（message 由路由层按状态差异化——已转任务携带关联任务标识 / 已取消提示废弃）
+  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",
+  ISSUE_BATCH_LIMIT_EXCEEDED: "\u5355\u6B21\u8F6C\u4EFB\u52A1\u89C4\u6A21\u8D85\u9650\uFF08\u7EC4 \u226410\u3001\u6BCF\u7EC4 \u226450\u3001\u53BB\u91CD\u95EE\u9898\u603B\u91CF \u226450\uFF09\uFF0C\u8BF7\u62C6\u5206\u4E3A\u591A\u6B21\u8F6C\u51FA"
 };
 var AppError = class extends Error {
 };
@@ -1113,7 +1121,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"]);
+var HistoryActionSchema = z4.enum(["entered", "advanced", "paused", "resumed", "approved", "rejected", "completed", "cancelled", "reopened"]);
 var HistoryEntrySchema = z4.object({
   nodeId: z4.string(),
   action: HistoryActionSchema,
@@ -1234,10 +1242,21 @@ async function advanceTask(deps, taskId, input) {
   );
   if (!nextEdge) {
     if (checkTermination(task.dagInstance.nodes, task.dagInstance.edges, task.dagInstance.nodeStates, completedState, currentNode.id, task.track)) {
+      if (!input?.finalize) {
+        throw new BadRequestError(
+          `Task is at its final node ('${currentNode.id}'). Confirm all outputs are complete, then advance with finalize=true to complete the task.`,
+          void 0,
+          {
+            bizCode: "TASK_FINALIZE_CONFIRMATION_REQUIRED",
+            message: `\u5F53\u524D\u8282\u70B9\u300C${currentNode.label ?? currentNode.id}\u300D\u4E3A\u4EFB\u52A1\u6700\u540E\u8282\u70B9\uFF1A\u786E\u8BA4\u5168\u90E8\u4EA7\u51FA\u5B8C\u6574\u540E\uFF0C\u643A\u5E26\u6536\u5C3E\u786E\u8BA4\u91CD\u65B0\u63A8\u8FDB\uFF08CLI: siming task advance <id> --finalize\uFF1BMCP: finalize=true\uFF1BWeb: \u6536\u5C3E\u786E\u8BA4\u6309\u94AE\uFF09\u3002`
+          }
+        );
+      }
       const patch2 = {
         status: "completed",
         ...summaryPatch,
-        history: [...task.history, mkHistory(currentNode.id, "completed", noteDetails)],
+        // finalize 守卫（上方）已保证此处 input.finalize 恒为 true——completed 条目恒记 finalized:true
+        history: [...task.history, mkHistory(currentNode.id, "completed", { ...noteDetails, finalized: true })],
         dagInstance: {
           ...task.dagInstance,
           nodeStates: {
@@ -1458,6 +1477,105 @@ async function cancelTask(deps, taskId, reason) {
     expectedCurrentNode: task.currentNode
   });
 }
+async function reopenTask(deps, taskId, input, operator) {
+  const task = await deps.getTask(taskId);
+  if (!task) throw new NotFoundError("task", taskId);
+  if (input.reason.trim() === "") {
+    throw new BadRequestError("reopen reason must not be blank", "reason");
+  }
+  if (task.status !== "completed" && task.status !== "cancelled") {
+    throw new BadRequestError(
+      `Cannot reopen: task status is '${task.status}'. Only completed/cancelled tasks can be reopened.`,
+      void 0,
+      { bizCode: "TASK_NOT_TERMINATED", message: `\u4EFB\u52A1\u975E\u7EC8\u6001\uFF08\u5F53\u524D ${task.status}\uFF09\uFF0C\u65E0\u9700\u91CD\u5F00` }
+    );
+  }
+  const reasonDetails = {
+    reason: input.reason,
+    ...operator !== void 0 ? { operator } : {},
+    fromStatus: task.status
+  };
+  let patch;
+  let toStatus;
+  let restoredPausedAt;
+  if (task.status === "completed") {
+    const last = task.history[task.history.length - 1];
+    if (!last || last.action !== "completed" || last.nodeId !== task.currentNode) {
+      throw new Error(
+        `invariant violation: last history entry is not completed@'${task.currentNode}' \u2014 task ${taskId}`
+      );
+    }
+    toStatus = "active";
+    restoredPausedAt = null;
+    const existingState = task.dagInstance.nodeStates[task.currentNode];
+    patch = {
+      status: "active",
+      history: [...task.history, mkHistory(task.currentNode, "reopened", { ...reasonDetails, toStatus, restoredPausedAt })],
+      dagInstance: {
+        ...task.dagInstance,
+        nodeStates: {
+          ...task.dagInstance.nodeStates,
+          [task.currentNode]: {
+            status: "active",
+            enteredAt: existingState?.enteredAt ?? /* @__PURE__ */ new Date(),
+            completedAt: null
+          }
+        }
+      }
+    };
+  } else {
+    const pre = derivePreTerminalState(task.history);
+    toStatus = pre.status;
+    restoredPausedAt = pre.pausedAt;
+    patch = {
+      status: pre.status,
+      pausedAt: pre.pausedAt,
+      history: [...task.history, mkHistory(task.currentNode, "reopened", { ...reasonDetails, toStatus, restoredPausedAt })]
+    };
+  }
+  const updated = await deps.updateTask(taskId, patch, {
+    expectedStatus: task.status,
+    expectedCurrentNode: task.currentNode
+  });
+  return { task: updated, restored: { fromStatus: task.status, toStatus, pausedAt: restoredPausedAt } };
+}
+function derivePreTerminalState(history) {
+  let cancelIdx = -1;
+  for (let i = history.length - 1; i >= 0; i--) {
+    if (history[i]?.action === "cancelled") {
+      cancelIdx = i;
+      break;
+    }
+  }
+  if (cancelIdx === -1) {
+    throw new Error("invariant violation: derivePreTerminalState requires a cancelled history entry");
+  }
+  for (let i = cancelIdx - 1; i >= 0; i--) {
+    const entry = history[i];
+    if (!entry) break;
+    const details = entry.details;
+    switch (entry.action) {
+      case "paused":
+        return "pausePoint" in details ? { status: "paused", pausedAt: entry.nodeId } : { status: "paused", pausedAt: null };
+      case "rejected":
+      case "cancelled":
+        continue;
+      // rejected 不改状态锚点（继续向前）；更早取消周期防御性跳过
+      case "reopened":
+        return {
+          status: details.toStatus === "paused" ? "paused" : "active",
+          pausedAt: details.restoredPausedAt ?? null
+        };
+      case "resumed":
+      case "advanced":
+      case "entered":
+      case "approved":
+      case "completed":
+        return { status: "active", pausedAt: null };
+    }
+  }
+  throw new Error("invariant violation: no pre-terminal state anchor found before cancelled entry");
+}
 function findNextEdge(edges, nodes, fromNodeId, track) {
   const outEdges = edges.filter((e) => e.from === fromNodeId);
   const matchSet = trackMatchSet(track);
@@ -1831,7 +1949,7 @@ function createTaskRepo(db) {
       }
       return toEntity(result);
     },
-    async createTask(input, template, resolvedProjectId) {
+    async createTask(input, template, resolvedProjectId, session) {
       if (!input.track) {
         throw new BadRequestError(`track is required`);
       }
@@ -1849,13 +1967,14 @@ function createTaskRepo(db) {
         throw new BadRequestError("DagTemplate has no id");
       }
       let taskId = null;
-      let seq = await base._collection.countDocuments({
-        taskId: { $regex: `^T${getDatePrefix()}` }
-      });
+      let seq = await base._collection.countDocuments(
+        { taskId: { $regex: `^T${getDatePrefix()}` } },
+        ...session ? [{ session }] : []
+      );
       for (let attempt = 0; attempt < 3; attempt++) {
         seq++;
         taskId = generateTaskId(seq);
-        const exists = await base._collection.findOne({ taskId }, { projection: { _id: 1 } });
+        const exists = await base._collection.findOne({ taskId }, { projection: { _id: 1 }, ...session ? { session } : {} });
         if (!exists) break;
         taskId = null;
       }
@@ -1888,7 +2007,7 @@ function createTaskRepo(db) {
       if (!result.success) {
         throw new ValidationError("Task validation failed", result.error.issues);
       }
-      return base.create(result.data);
+      return base.create(result.data, session);
     }
   };
 }
@@ -1927,6 +2046,386 @@ function deepCopyEdge(edge) {
   };
 }
 
+// src/task/entry-id.ts
+var ENTRY_ID_LENGTH = 6;
+var BASE36_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
+function generateEntryId(existing) {
+  const taken = new Set(existing);
+  for (let attempt = 0; attempt < 32; attempt++) {
+    let id = "";
+    for (let i = 0; i < ENTRY_ID_LENGTH; i++) {
+      id += BASE36_ALPHABET[Math.floor(Math.random() * BASE36_ALPHABET.length)];
+    }
+    if (!taken.has(id)) return id;
+  }
+  throw new Error(`entry id generation failed after 32 attempts (existing: ${existing.length})`);
+}
+
+// src/schemas/issue.ts
+import { z as z5 } from "zod";
+var ISSUE_STATUSES = ["pending", "partial", "converted", "cancelled"];
+var IssueStatusSchema = z5.enum(ISSUE_STATUSES);
+var ISSUE_ACTIVE_STATUSES = ["pending", "partial"];
+var ISSUE_SOURCES = ["mcp", "cli", "web"];
+var IssueSourceSchema = z5.enum(ISSUE_SOURCES);
+var TaskLinkSchema = z5.object({
+  /** 关联任务业务 id（T 前缀；任务仅可取消不可删除，引用恒有效） */
+  taskId: z5.string().min(1),
+  /** 该次转出声明（历史事实，展示用；请求级声明——同一问题同次转出全组一致） */
+  mode: z5.enum(["all", "partial"]),
+  linkedAt: z5.date()
+});
+var ISSUE_CONVERT_MODES = ["all", "partial"];
+var IssueConvertModeSchema = z5.enum(ISSUE_CONVERT_MODES);
+var IssueHistoryEntrySchema = z5.object({
+  id: z5.string().regex(ENTRY_ID_REGEX),
+  action: z5.enum(["created", "status-change", "link-added", "link-terminated"]),
+  from: IssueStatusSchema.optional(),
+  to: IssueStatusSchema.optional(),
+  taskId: z5.string().min(1).optional(),
+  reason: z5.string().max(500).optional(),
+  at: z5.date()
+});
+var IssueSchema = z5.object({
+  id: z5.string().optional(),
+  /** 业务 id：I + YYYYMMDD + 4 位序号（taskId 同构，可读可排序） */
+  issueId: z5.string(),
+  title: z5.string().min(1).max(200),
+  description: z5.string().max(1e4).optional(),
+  source: IssueSourceSchema,
+  projectId: z5.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex"),
+  status: IssueStatusSchema.default("pending"),
+  taskLinks: z5.array(TaskLinkSchema).default([]),
+  history: z5.array(IssueHistoryEntrySchema).default([]),
+  createdAt: z5.date().optional(),
+  updatedAt: z5.date().optional()
+});
+var IssueCreateSchema = z5.object({
+  title: z5.string().min(1).max(200),
+  description: z5.string().max(1e4).optional()
+});
+var IssueUpdateSchema = z5.object({
+  title: z5.string().min(1).max(200).optional(),
+  description: z5.string().max(1e4).optional()
+});
+var IssueProgressSchema = z5.object({
+  done: z5.number().int().min(0),
+  cancelled: z5.number().int().min(0),
+  total: z5.number().int().min(0)
+});
+
+// src/store/repos/issue.repo.ts
+var CONVERT_MODE_LABELS = { all: "\u5168\u90E8\u8F6C\u51FA", partial: "\u90E8\u5206\u8F6C\u51FA" };
+var formatReasonDateTime = (d) => {
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+};
+function createIssueRepo(db) {
+  const base = createRepo(db.collection("issues"));
+  const tasks = db.collection("tasks");
+  return {
+    ...base,
+    async createIssue(data, source, projectId) {
+      const now = /* @__PURE__ */ new Date();
+      let issueId = null;
+      let seq = await base._collection.countDocuments({
+        issueId: { $regex: `^I${getDatePrefix2()}` }
+      });
+      for (let attempt = 0; attempt < 3; attempt++) {
+        seq++;
+        issueId = `I${getDatePrefix2()}${seq.toString().padStart(4, "0")}`;
+        const exists = await base._collection.findOne({ issueId }, { projection: { _id: 1 } });
+        if (!exists) break;
+        issueId = null;
+      }
+      if (!issueId) {
+        throw new ConflictError("issue", "issueId generation failed after 3 retries");
+      }
+      const issue = {
+        issueId,
+        title: data.title,
+        ...data.description !== void 0 ? { description: data.description } : {},
+        source,
+        projectId,
+        status: "pending",
+        taskLinks: [],
+        history: [{ id: generateEntryId([]), action: "created", at: now }]
+      };
+      const result = IssueSchema.safeParse(issue);
+      if (!result.success) {
+        throw new BadRequestError(`Issue validation failed: ${result.error.issues[0]?.message ?? ""}`);
+      }
+      return base.create(result.data);
+    },
+    async getByIssueId(issueId) {
+      const doc = await base._collection.findOne({ issueId });
+      if (!doc) return null;
+      return toEntity(doc);
+    },
+    async updateIssue(issueId, patch) {
+      const sets = {};
+      if (patch.title !== void 0) sets.title = patch.title;
+      if (patch.description !== void 0) sets.description = patch.description;
+      const result = await base._collection.findOneAndUpdate(
+        { issueId },
+        { $set: { ...sets, updatedAt: /* @__PURE__ */ new Date() } },
+        { returnDocument: "after" }
+      );
+      if (!result) throw new NotFoundError("issue", issueId, { bizCode: "ISSUE_NOT_FOUND" });
+      return toEntity(result);
+    },
+    async cancelIssue(issueId, reason) {
+      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") {
+        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`
+        });
+      }
+      const now = /* @__PURE__ */ new Date();
+      const links = current.taskLinks ?? [];
+      const terminated = links.map((link) => ({
+        id: generateEntryId([]),
+        action: "link-terminated",
+        taskId: link.taskId,
+        reason: `\u539F\u58F0\u660E ${CONVERT_MODE_LABELS[link.mode]}\uFF08\u5173\u8054\u4E8E ${formatReasonDateTime(link.linkedAt)}\uFF09\uFF0C\u95EE\u9898\u53D6\u6D88\u540E\u7EC8\u6B62`,
+        at: now
+      }));
+      const result = await base._collection.findOneAndUpdate(
+        // 并发安全带：读后窗口内外部转出/取消 → 命中 0 行报终态冲突（终态以先到者为准）
+        { issueId, status: { $in: ISSUE_ACTIVE_STATUSES } },
+        {
+          $set: { status: "cancelled", taskLinks: [], updatedAt: now },
+          $push: {
+            history: {
+              $each: [
+                ...terminated,
+                {
+                  id: generateEntryId([]),
+                  action: "status-change",
+                  from: current.status,
+                  to: "cancelled",
+                  ...reason !== void 0 ? { reason } : {},
+                  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\uFF09\uFF0C\u8BF7\u5237\u65B0\u540E\u91CD\u8BD5"
+        });
+      }
+      return toEntity(result);
+    },
+    async listIssues(filter) {
+      const match = {};
+      if (filter?.projectId) match.projectId = filter.projectId;
+      if (filter?.status?.length) match.status = { $in: filter.status };
+      if (filter?.source) match.source = filter.source;
+      if (filter?.taskId) match["taskLinks.taskId"] = filter.taskId;
+      if (filter?.q) {
+        match.$or = [
+          { title: { $regex: escapeRegExpLiteral(filter.q), $options: "i" } },
+          { description: { $regex: escapeRegExpLiteral(filter.q), $options: "i" } }
+        ];
+      }
+      const page = filter?.page ?? 1;
+      const limit = filter?.limit ?? 20;
+      if (filter?.view === "open" && !filter?.status?.length) {
+        const activeMatch = { ...match, status: { $in: ISSUE_ACTIVE_STATUSES } };
+        const convertedMatch = { ...match, status: "converted", taskLinks: { $ne: [] } };
+        const [activeDocs, convertedDocs] = await Promise.all([
+          base._collection.find(activeMatch).toArray(),
+          base._collection.find(convertedMatch).toArray()
+        ]);
+        const convertedTaskIds = new Set(convertedDocs.flatMap((doc) => (doc.taskLinks ?? []).map((l) => l.taskId)));
+        const statusMap = /* @__PURE__ */ new Map();
+        if (convertedTaskIds.size > 0) {
+          const statusDocs = await tasks.find({ taskId: { $in: [...convertedTaskIds] } }, { projection: { taskId: 1, status: 1 } }).toArray();
+          for (const doc of statusDocs) statusMap.set(String(doc.taskId), String(doc.status));
+        }
+        const openConverted = convertedDocs.filter(
+          (doc) => doc.taskLinks.some((l) => {
+            const st = statusMap.get(l.taskId);
+            return st === "active" || st === "paused";
+          })
+        );
+        const merged = [...activeDocs, ...openConverted].sort((a, b) => {
+          const at = a.createdAt?.getTime() ?? 0;
+          const bt = b.createdAt?.getTime() ?? 0;
+          return bt - at;
+        });
+        const total2 = merged.length;
+        const slice = merged.slice((page - 1) * limit, page * limit);
+        return { items: await withProgressBatch(db, slice), total: total2 };
+      }
+      const sort = { createdAt: -1 };
+      const [docs, total] = await Promise.all([
+        base._collection.find(match).sort(sort).skip((page - 1) * limit).limit(limit).toArray(),
+        base._collection.countDocuments(match)
+      ]);
+      return { items: await withProgressBatch(db, docs), total };
+    },
+    async getIssueDetail(issueId) {
+      const issue = await this.getByIssueId(issueId);
+      if (!issue) return null;
+      const progress = await progressFor(db, issue.taskLinks);
+      const taskDocs = issue.taskLinks.length > 0 ? await tasks.find(
+        { taskId: { $in: issue.taskLinks.map((l) => l.taskId) } },
+        { projection: { taskId: 1, title: 1, currentNode: 1, status: 1, updatedAt: 1 } }
+      ).toArray() : [];
+      const byTaskId = new Map(taskDocs.map((doc) => [String(doc.taskId), doc]));
+      const taskViews = issue.taskLinks.map((link) => {
+        const doc = byTaskId.get(link.taskId);
+        return {
+          taskId: link.taskId,
+          title: String(doc?.title ?? `\uFF08\u4EFB\u52A1 ${link.taskId}\uFF09`),
+          currentNode: String(doc?.currentNode ?? "\u2014"),
+          status: String(doc?.status ?? "unknown"),
+          mode: link.mode,
+          linkedAt: link.linkedAt,
+          updatedAt: doc?.updatedAt ?? link.linkedAt
+        };
+      });
+      return { ...issue, progress, tasks: taskViews };
+    },
+    async listByTaskId(taskId) {
+      const docs = await base._collection.find({
+        $or: [{ "taskLinks.taskId": taskId }, { "history.taskId": taskId, "history.action": "link-terminated" }]
+      }).toArray();
+      const issues = docs.map((doc) => toEntity(doc));
+      const progressed = await withProgressBatch(db, docs);
+      const progressById = new Map(progressed.map((item) => [item.issueId, item.progress]));
+      return issues.map((issue) => ({
+        issueId: issue.issueId,
+        title: issue.title,
+        status: issue.status,
+        source: issue.source,
+        progress: progressById.get(issue.issueId) ?? { done: 0, cancelled: 0, total: 0 },
+        // 终止判定：当前 taskLinks 不含该 taskId（已取消的关联——历史终止条目命中）
+        terminated: !issue.taskLinks.some((l) => l.taskId === taskId),
+        updatedAt: issue.updatedAt ?? /* @__PURE__ */ new Date(0)
+      }));
+    },
+    async linkTaskForConvert(session, issueId, taskId, mode) {
+      const now = /* @__PURE__ */ new Date();
+      const result = await base._collection.findOneAndUpdate(
+        // 条件更新双保险：外部并发转出/取消（终态）→ 命中 0 行，事务中止整组回滚
+        { issueId, status: { $in: ISSUE_ACTIVE_STATUSES } },
+        {
+          $push: {
+            taskLinks: { taskId, mode, linkedAt: now },
+            history: {
+              id: generateEntryId([]),
+              action: "link-added",
+              taskId,
+              reason: `\u8F6C\u51FA\u58F0\u660E ${CONVERT_MODE_LABELS[mode]}`,
+              at: now
+            }
+          },
+          $set: { updatedAt: now }
+        },
+        { returnDocument: "after", session }
+      );
+      if (!result) {
+        const exists = await base._collection.findOne({ issueId }, { projection: { status: 1 }, session });
+        if (!exists) {
+          throw new NotFoundError("issue", issueId, { bizCode: "ISSUE_NOT_FOUND" });
+        }
+        throw new ConflictError("issue", issueId, {
+          bizCode: "ISSUE_INVALID_TRANSITION",
+          message: `\u95EE\u9898\u5DF2\u88AB\u5E76\u53D1\u5904\u7406\uFF08status: ${String(exists.status)}\uFF09\uFF0C\u672C\u7EC4\u8F6C\u51FA\u56DE\u6EDA`
+        });
+      }
+    },
+    async finalizeConvertStatuses(issues, outcomes, declarations) {
+      const changes = [];
+      for (const issue of issues) {
+        const touching = outcomes.filter((o) => o.issueIds.includes(issue.issueId));
+        const successGroups = touching.filter((o) => o.ok);
+        if (successGroups.length === 0) continue;
+        const anyFailed = touching.some((o) => !o.ok);
+        const declaration = declarations.get(issue.issueId) ?? "partial";
+        const to = anyFailed || declaration !== "all" ? "partial" : "converted";
+        if (issue.status === to && !anyFailed) continue;
+        const now = /* @__PURE__ */ new Date();
+        const successTaskIds = successGroups.map((o) => o.taskId).filter((t) => t !== void 0);
+        const result = await base._collection.findOneAndUpdate(
+          // 并发安全带：推导前被外部取消/转出 → 命中 0 行跳过（终态以先到者为准；ISSUE_ACTIVE_STATUSES 单一真相源）
+          { issueId: issue.issueId, status: { $in: ISSUE_ACTIVE_STATUSES } },
+          {
+            $set: { status: to, updatedAt: now },
+            $push: {
+              history: {
+                id: generateEntryId(issue.history.map((h) => h.id)),
+                action: "status-change",
+                from: issue.status,
+                to,
+                reason: to === "converted" ? `\u8F6C\u51FA\u5B8C\u6210\uFF08\u5173\u8054\u4EFB\u52A1 ${successTaskIds.join("\u3001") || "\u2014"}\uFF09` : anyFailed ? `\u90E8\u5206\u8F6C\u51FA\uFF08\u5B58\u5728\u5931\u8D25\u7EC4\u9057\u7559\uFF0C\u6210\u529F\u4EFB\u52A1 ${successTaskIds.join("\u3001") || "\u2014"}\uFF09` : `\u90E8\u5206\u8F6C\u51FA\uFF08\u58F0\u660E partial\uFF0C\u5173\u8054\u4EFB\u52A1 ${successTaskIds.join("\u3001") || "\u2014"}\uFF09`,
+                at: now
+              }
+            }
+          },
+          { returnDocument: "after" }
+        );
+        if (result) {
+          changes.push({ issueId: issue.issueId, from: issue.status, to });
+        }
+      }
+      return changes;
+    }
+  };
+}
+async function withProgressBatch(db, docs) {
+  const taskIds = /* @__PURE__ */ new Set();
+  for (const doc of docs) {
+    for (const link of doc.taskLinks ?? []) taskIds.add(link.taskId);
+  }
+  const statusMap = /* @__PURE__ */ new Map();
+  if (taskIds.size > 0) {
+    const statusDocs = await db.collection("tasks").find({ taskId: { $in: [...taskIds] } }, { projection: { taskId: 1, status: 1 } }).toArray();
+    for (const doc of statusDocs) statusMap.set(String(doc.taskId), String(doc.status));
+  }
+  return docs.map((doc) => {
+    const issue = toEntity(doc);
+    let done = 0;
+    let cancelled = 0;
+    for (const link of issue.taskLinks) {
+      const st = statusMap.get(link.taskId);
+      if (st === "completed") done++;
+      else if (st === "cancelled") cancelled++;
+    }
+    return { ...issue, progress: { done, cancelled, total: issue.taskLinks.length } };
+  });
+}
+async function progressFor(db, links) {
+  const statusMap = /* @__PURE__ */ new Map();
+  if (links.length > 0) {
+    const statusDocs = await db.collection("tasks").find({ taskId: { $in: links.map((l) => l.taskId) } }, { projection: { taskId: 1, status: 1 } }).toArray();
+    for (const doc of statusDocs) statusMap.set(String(doc.taskId), String(doc.status));
+  }
+  let done = 0;
+  let cancelled = 0;
+  for (const link of links) {
+    const st = statusMap.get(link.taskId);
+    if (st === "completed") done++;
+    else if (st === "cancelled") cancelled++;
+  }
+  return { done, cancelled, total: links.length };
+}
+function getDatePrefix2() {
+  const d = /* @__PURE__ */ new Date();
+  return d.getFullYear().toString() + (d.getMonth() + 1).toString().padStart(2, "0") + d.getDate().toString().padStart(2, "0");
+}
+
 // src/store/repos/project.repo.ts
 import { ObjectId as ObjectId2 } from "mongodb";
 var DEFAULT_PROJECT_KEY = "default";
@@ -2054,6 +2553,8 @@ var REFERENCE_CHECKS = {
   task_status: [{ collection: "tasks", query: (v) => ({ status: v }) }],
   node_status: [{ collection: "tasks", query: (v) => ({ "dagInstance.nodeStates.status": v }) }],
   skill_category: [{ collection: "skills", query: (v) => ({ category: v }) }],
+  // T202609150002：问题状态被 issues.status 引用（四值全 builtin 禁删，检测为未来扩值留防线）
+  issue_status: [{ collection: "issues", query: (v) => ({ status: v }) }],
   scope: void 0,
   // T202608260002：agent 功能类型被 agents.function 引用（reviewer/executor 为 builtin 禁删；
   // 检测映射为未来非 builtin 扩值留防线）
@@ -2276,7 +2777,7 @@ function createNodeLibraryRepo(db) {
 
 // src/store/repos/auth.repo.ts
 import { ObjectId as ObjectId3 } from "mongodb";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var AUTH_COLLECTIONS = {
   accounts: "auth_accounts",
   tokens: "auth_tokens",
@@ -2370,14 +2871,14 @@ function createAuthTokenRepo(db) {
     }
   };
 }
-var AuthSessionSchema = z5.object({
-  id: z5.string().optional(),
-  sessionId: z5.string().min(1),
+var AuthSessionSchema = z6.object({
+  id: z6.string().optional(),
+  sessionId: z6.string().min(1),
   /** 管理员账号 id（会话 = 管理员身份） */
-  accountId: z5.string().min(1),
-  expiresAt: z5.date(),
-  createdAt: z5.date().optional(),
-  updatedAt: z5.date().optional()
+  accountId: z6.string().min(1),
+  expiresAt: z6.date(),
+  createdAt: z6.date().optional(),
+  updatedAt: z6.date().optional()
 });
 function createAuthSessionRepo(db) {
   const base = createRepo(db.collection(AUTH_COLLECTIONS.sessions));
@@ -2456,21 +2957,21 @@ function generateSessionId() {
 }
 
 // src/schemas/agent.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 
 // src/schemas/model-alias.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 var SIMING_CODE_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
-var ModelAliasShapeSchema = z6.object({
-  id: z6.string().optional(),
+var ModelAliasShapeSchema = z7.object({
+  id: z7.string().optional(),
   /** siming code：创建后不可变（PUT 显式拒绝 MODEL_CODE_IMMUTABLE，非静默剥离） */
-  code: z6.string().regex(SIMING_CODE_REGEX, "code \u5FC5\u987B\u4E3A kebab-case\uFF08\u5982 primary\u3001fast-model\uFF09"),
+  code: z7.string().regex(SIMING_CODE_REGEX, "code \u5FC5\u987B\u4E3A kebab-case\uFF08\u5982 primary\u3001fast-model\uFF09"),
   /** 展示名（如「主力模型」） */
-  name: z6.string().min(1, "\u5C55\u793A\u540D\u4E0D\u80FD\u4E3A\u7A7A"),
+  name: z7.string().min(1, "\u5C55\u793A\u540D\u4E0D\u80FD\u4E3A\u7A7A"),
   /** 真实模型标识（如 zhipuai/glm-5.3；改此处 = 引用方全局替换生效） */
-  realModel: z6.string().min(1, "\u771F\u5B9E\u6A21\u578B\u6807\u8BC6\u4E0D\u80FD\u4E3A\u7A7A"),
-  createdAt: z6.date().optional(),
-  updatedAt: z6.date().optional()
+  realModel: z7.string().min(1, "\u771F\u5B9E\u6A21\u578B\u6807\u8BC6\u4E0D\u80FD\u4E3A\u7A7A"),
+  createdAt: z7.date().optional(),
+  updatedAt: z7.date().optional()
 });
 var ModelAliasSchema = ModelAliasShapeSchema;
 var ModelAliasCreateSchema = ModelAliasShapeSchema.omit({
@@ -2478,18 +2979,18 @@ var ModelAliasCreateSchema = ModelAliasShapeSchema.omit({
   createdAt: true,
   updatedAt: true
 });
-var ModelAliasUpdateSchema = z6.object({
-  code: z6.string().regex(SIMING_CODE_REGEX).optional(),
-  name: z6.string().min(1).optional(),
-  realModel: z6.string().min(1).optional()
+var ModelAliasUpdateSchema = z7.object({
+  code: z7.string().regex(SIMING_CODE_REGEX).optional(),
+  name: z7.string().min(1).optional(),
+  realModel: z7.string().min(1).optional()
 });
 var ModelAliasWithRefCountSchema = ModelAliasShapeSchema.extend({
-  refCount: z6.number().int().min(0)
+  refCount: z7.number().int().min(0)
 });
 
 // src/schemas/agent.ts
-var AgentScopeSchema = z7.enum(["global", "project"]);
-var AgentFunctionSchema = z7.enum(["reviewer", "executor"]);
+var AgentScopeSchema = z8.enum(["global", "project"]);
+var AgentFunctionSchema = z8.enum(["reviewer", "executor"]);
 var AgentScopeRefine = (val, ctx) => {
   if (val.scope === "project" && !val.projectId) {
     ctx.addIssue({
@@ -2499,17 +3000,17 @@ var AgentScopeRefine = (val, ctx) => {
     });
   }
 };
-var AgentShapeSchema = z7.object({
-  id: z7.string().optional(),
-  name: z7.string(),
-  description: z7.string(),
-  systemPrompt: z7.string(),
-  boundSkills: z7.array(z7.string()).default([]),
-  model: z7.string(),
+var AgentShapeSchema = z8.object({
+  id: z8.string().optional(),
+  name: z8.string(),
+  description: z8.string(),
+  systemPrompt: z8.string(),
+  boundSkills: z8.array(z8.string()).default([]),
+  model: z8.string(),
   /** 资产版本（N015 F13）：install/export 版本对比依据；default 仅读侧兜底（createRepo 不做读侧解析，存量回填走 M6 迁移） */
-  version: z7.string().default("1.0.0"),
-  tools: z7.array(z7.string()).default([]),
-  permissions: z7.array(z7.string()).default([]),
+  version: z8.string().default("1.0.0"),
+  tools: z8.array(z8.string()).default([]),
+  permissions: z8.array(z8.string()).default([]),
   /** 引用文档集合（可选——存量单文件资产无此字段，行为与升级前一致） */
   references: createReferencesSchema(AGENT_MAIN_DOC).optional(),
   /** 作用域：global=跨项目复用（默认，仅作存量迁移读侧兜底）/ project=项目专用（N012 D3） */
@@ -2517,15 +3018,15 @@ var AgentShapeSchema = z7.object({
   /** 功能类型（T202608260002）：default 仅创建侧归一——toEntity 直转不经 Zod parse，读侧归一在 repo 层 + 回填走 M12 */
   "function": AgentFunctionSchema.default("executor"),
   /** 仅 scope=project 时必填且为合法 ObjectId hex（superRefine 保证） */
-  projectId: z7.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
+  projectId: z8.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
   /**
    * T202608290001 资产启停（可选——存量无此字段 = 启用，零迁移）。
    * 全局判断规则：enabled === false 即停用，true/缺失均启用。
    * 唯一写入口是专用启停端点（POST /:name/enabled）——Create/Update/Copy 均不含此字段。
    */
-  enabled: z7.boolean().optional(),
-  createdAt: z7.date().optional(),
-  updatedAt: z7.date().optional()
+  enabled: z8.boolean().optional(),
+  createdAt: z8.date().optional(),
+  updatedAt: z8.date().optional()
 });
 var agentAggregateLimitRefine = (val, ctx) => {
   const totalChars = (val.systemPrompt?.length ?? 0) + sumReferenceContentChars(val.references);
@@ -2543,28 +3044,28 @@ var AgentCreateSchema = AgentShapeSchema.omit({
   createdAt: true,
   updatedAt: true,
   enabled: true
-}).extend({ scope: AgentScopeSchema }).extend({ model: z7.string().regex(SIMING_CODE_REGEX, "model \u5FC5\u987B\u662F siming code\uFF08kebab-case\uFF09") }).extend({ "function": AgentFunctionSchema.default("executor") }).superRefine(AgentScopeRefine).superRefine(agentAggregateLimitRefine);
+}).extend({ scope: AgentScopeSchema }).extend({ model: z8.string().regex(SIMING_CODE_REGEX, "model \u5FC5\u987B\u662F siming code\uFF08kebab-case\uFF09") }).extend({ "function": AgentFunctionSchema.default("executor") }).superRefine(AgentScopeRefine).superRefine(agentAggregateLimitRefine);
 var AgentUpdateSchema = AgentShapeSchema.omit({
   id: true,
   createdAt: true,
   updatedAt: true,
   enabled: true
 }).extend({
-  boundSkills: z7.array(z7.string()).optional(),
+  boundSkills: z8.array(z8.string()).optional(),
   // N015：version 放行（export apply 版本递增随 PUT 携带）；optional 剥离实体层 default 避免 partial 空 body 注入
-  version: z7.string().optional(),
-  tools: z7.array(z7.string()).optional(),
-  permissions: z7.array(z7.string()).optional(),
+  version: z8.string().optional(),
+  tools: z8.array(z8.string()).optional(),
+  permissions: z8.array(z8.string()).optional(),
   scope: AgentScopeSchema.optional(),
   // N013：model 收紧为 siming code 格式（存在性校验在 handler 层；undefined = 不更新该字段）
-  model: z7.string().regex(SIMING_CODE_REGEX, "model \u5FC5\u987B\u662F siming code\uFF08kebab-case\uFF09").optional(),
+  model: z8.string().regex(SIMING_CODE_REGEX, "model \u5FC5\u987B\u662F siming code\uFF08kebab-case\uFF09").optional(),
   // T202608260002：optional 剥离实体层 default——否则 PUT 空 body 会注入 executor 覆盖 reviewer
   "function": AgentFunctionSchema.optional()
 }).partial().superRefine(AgentScopeRefine).superRefine(agentAggregateLimitRefine);
-var AgentCopySchema = z7.object({
-  newName: z7.string(),
+var AgentCopySchema = z8.object({
+  newName: z8.string(),
   newScope: AgentScopeSchema,
-  targetProjectId: z7.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
+  targetProjectId: z8.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
 }).superRefine((val, ctx) => {
   if (val.newScope === "project" && !val.targetProjectId) {
     ctx.addIssue({
@@ -2576,7 +3077,7 @@ var AgentCopySchema = z7.object({
 });
 
 // src/schemas/export-bundle.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var EXPORT_FORMAT_VERSION = "1.0";
 var TemplatePayloadSchema = DagTemplateSchema.omit({
   id: true,
@@ -2586,8 +3087,8 @@ var TemplatePayloadSchema = DagTemplateSchema.omit({
   updatedAt: true,
   code: true
 }).extend({
-  version: z8.string(),
-  isDefault: z8.boolean()
+  version: z9.string(),
+  isDefault: z9.boolean()
 });
 var SkillPayloadSchema = SkillShapeSchema.omit({
   id: true,
@@ -2596,7 +3097,7 @@ var SkillPayloadSchema = SkillShapeSchema.omit({
   createdAt: true,
   updatedAt: true
 }).extend({
-  version: z8.string(),
+  version: z9.string(),
   scope: SkillScopeSchema,
   references: createReferencesSchema(SKILL_MAIN_DOC)
 });
@@ -2607,12 +3108,12 @@ var AgentPayloadSchema = AgentShapeSchema.omit({
   createdAt: true,
   updatedAt: true
 }).extend({
-  version: z8.string(),
+  version: z9.string(),
   scope: AgentScopeSchema,
   references: createReferencesSchema(AGENT_MAIN_DOC),
-  boundSkills: z8.array(z8.string()),
-  tools: z8.array(z8.string()),
-  permissions: z8.array(z8.string()),
+  boundSkills: z9.array(z9.string()),
+  tools: z9.array(z9.string()),
+  permissions: z9.array(z9.string()),
   "function": AgentFunctionSchema
 });
 var ModelAliasPayloadSchema = ModelAliasSchema.omit({
@@ -2620,307 +3121,316 @@ var ModelAliasPayloadSchema = ModelAliasSchema.omit({
   createdAt: true,
   updatedAt: true
 });
-var ExportBundleSchema = z8.object({
-  exportFormatVersion: z8.literal(EXPORT_FORMAT_VERSION, {
+var ExportBundleSchema = z9.object({
+  exportFormatVersion: z9.literal(EXPORT_FORMAT_VERSION, {
     error: `\u5BFC\u51FA\u683C\u5F0F\u7248\u672C\u4E0D\u652F\u6301\uFF0C\u5F53\u524D\u652F\u6301 ${EXPORT_FORMAT_VERSION}`
   }),
-  exportedAt: z8.string(),
+  exportedAt: z9.string(),
   /** 源环境悬空提示（§2.2：悬空 skill/agent.model 不阻断导出）。导出响应恒携带；导入入参可缺省——导入侧提示由 plan 生成，不消费本字段 */
-  warnings: z8.array(z8.string()).optional(),
+  warnings: z9.array(z9.string()).optional(),
   template: TemplatePayloadSchema,
-  dependencies: z8.object({
-    skills: z8.array(SkillPayloadSchema),
-    agents: z8.array(AgentPayloadSchema),
-    modelAliases: z8.array(ModelAliasPayloadSchema)
+  dependencies: z9.object({
+    skills: z9.array(SkillPayloadSchema),
+    agents: z9.array(AgentPayloadSchema),
+    modelAliases: z9.array(ModelAliasPayloadSchema)
   })
 });
-var ImportPlanRequestSchema = z8.object({
-  targetProjectId: z8.string().regex(OBJECT_ID_HEX, "targetProjectId must be a valid ObjectId hex"),
+var ImportPlanRequestSchema = z9.object({
+  targetProjectId: z9.string().regex(OBJECT_ID_HEX, "targetProjectId must be a valid ObjectId hex"),
   bundle: ExportBundleSchema
 });
-var ImportDecisionSchema = z8.discriminatedUnion("kind", [
-  z8.object({
-    kind: z8.literal("skill"),
-    name: z8.string(),
+var ImportDecisionSchema = z9.discriminatedUnion("kind", [
+  z9.object({
+    kind: z9.literal("skill"),
+    name: z9.string(),
     scope: SkillScopeSchema,
-    action: z8.enum(["overwrite", "skip"])
+    action: z9.enum(["overwrite", "skip"])
   }),
-  z8.object({
-    kind: z8.literal("agent"),
-    name: z8.string(),
+  z9.object({
+    kind: z9.literal("agent"),
+    name: z9.string(),
     scope: AgentScopeSchema,
-    action: z8.enum(["overwrite", "skip"])
+    action: z9.enum(["overwrite", "skip"])
   }),
-  z8.object({
-    kind: z8.literal("modelAlias"),
-    name: z8.string(),
-    action: z8.enum(["overwrite", "skip"])
+  z9.object({
+    kind: z9.literal("modelAlias"),
+    name: z9.string(),
+    action: z9.enum(["overwrite", "skip"])
   })
 ]);
 var ImportApplyRequestSchema = ImportPlanRequestSchema.extend({
   /** 未列出的冲突项缺省 skip（保守默认：未决策不覆盖） */
-  decisions: z8.array(ImportDecisionSchema).default([])
+  decisions: z9.array(ImportDecisionSchema).default([])
 });
-var DependencyStatusSchema = z8.enum(["create", "identical", "conflict"]);
-var DependencyCheckSchema = z8.object({
-  kind: z8.enum(["skill", "agent", "modelAlias"]),
-  name: z8.string(),
+var DependencyStatusSchema = z9.enum(["create", "identical", "conflict"]);
+var DependencyCheckSchema = z9.object({
+  kind: z9.enum(["skill", "agent", "modelAlias"]),
+  name: z9.string(),
   /** skill/agent 携带；modelAlias 无 */
-  scope: z8.enum(["global", "project"]).optional(),
+  scope: z9.enum(["global", "project"]).optional(),
   status: DependencyStatusSchema,
   /** status ≠ create 时目标环境现值版本（modelAlias 无 version 概念不填） */
-  currentVersion: z8.string().optional(),
-  importVersion: z8.string().optional(),
+  currentVersion: z9.string().optional(),
+  importVersion: z9.string().optional(),
   /** status = conflict 时差异字段名清单（如 "content, references"） */
-  changeSummary: z8.string().optional(),
+  changeSummary: z9.string().optional(),
   /** 影响范围（PRD F13）：global 资产影响所有项目 / project 资产仅影响所属项目 */
-  impact: z8.enum(["global", "project"])
+  impact: z9.enum(["global", "project"])
 });
-var ImportPlanResponseSchema = z8.object({
-  template: z8.object({
-    name: z8.string(),
-    willOverwrite: z8.boolean(),
-    currentVersion: z8.string().optional(),
-    importVersion: z8.string(),
-    isDefaultRequested: z8.boolean(),
+var ImportPlanResponseSchema = z9.object({
+  template: z9.object({
+    name: z9.string(),
+    willOverwrite: z9.boolean(),
+    currentVersion: z9.string().optional(),
+    importVersion: z9.string(),
+    isDefaultRequested: z9.boolean(),
     /** isDefault 降级后的最终生效值（F17：项目已有默认 → false） */
-    isDefaultEffect: z8.boolean(),
-    downgradeReason: z8.string().optional()
+    isDefaultEffect: z9.boolean(),
+    downgradeReason: z9.string().optional()
   }),
-  dependencies: z8.array(DependencyCheckSchema),
+  dependencies: z9.array(DependencyCheckSchema),
   /**
    * K10①：模板节点直接技能引用完整性逐项核对（node × skill 粒度）——
    * ok = 在 bundle 依赖 ∪ 目标环境可见集；missing = 双侧皆无（绑定悬空，non-blocking warning）
    */
-  directSkillChecks: z8.array(
-    z8.object({
-      node: z8.string(),
-      skill: z8.string(),
-      status: z8.enum(["ok", "missing"])
+  directSkillChecks: z9.array(
+    z9.object({
+      node: z9.string(),
+      skill: z9.string(),
+      status: z9.enum(["ok", "missing"])
     })
   ),
   /** 非阻断提示（源环境悬空绑定、agent.model 引用缺失、sourcePreset 来源缺失等） */
-  warnings: z8.array(z8.string())
+  warnings: z9.array(z9.string())
 });
-var DependencyActionSchema = z8.enum(["created", "updated", "skipped", "identical", "failed"]);
-var ImportApplyResponseSchema = z8.object({
-  template: z8.object({
-    id: z8.string(),
-    name: z8.string(),
-    action: z8.enum(["created", "updated"]),
-    isDefaultEffect: z8.boolean()
+var DependencyActionSchema = z9.enum(["created", "updated", "skipped", "identical", "failed"]);
+var ImportApplyResponseSchema = z9.object({
+  template: z9.object({
+    id: z9.string(),
+    name: z9.string(),
+    action: z9.enum(["created", "updated"]),
+    isDefaultEffect: z9.boolean()
   }),
-  dependencies: z8.array(
-    z8.object({
-      kind: z8.enum(["skill", "agent", "modelAlias"]),
-      name: z8.string(),
-      scope: z8.enum(["global", "project"]).optional(),
+  dependencies: z9.array(
+    z9.object({
+      kind: z9.enum(["skill", "agent", "modelAlias"]),
+      name: z9.string(),
+      scope: z9.enum(["global", "project"]).optional(),
       action: DependencyActionSchema,
       /** action = failed 时的错误说明 */
-      message: z8.string().optional()
+      message: z9.string().optional()
     })
   ),
   /** K10②：apply 时刻目标环境缺失来源而被剥除 sourcePreset 的节点 id 清单（降级自建导入） */
-  sourceStripped: z8.array(z8.string())
+  sourceStripped: z9.array(z9.string())
 });
 function decisionKey(kind, scope, name) {
   return `${kind}:${scope ?? ""}:${name}`;
 }
 
 // src/schemas/advance.ts
-import { z as z9 } from "zod";
-var AdvanceRequestSchema = z9.object({
-  note: z9.string().optional(),
+import { z as z10 } from "zod";
+var AdvanceRequestSchema = z10.object({
+  note: z10.string().optional(),
   /** min(1).max(2000) 与 record summary 端点对齐（同一 $set 目标，两入口校验强度一致） */
-  summary: z9.string().min(1).max(2e3).optional()
+  summary: z10.string().min(1).max(2e3).optional(),
+  /**
+   * T202609130009 收尾确认（可选）：终节点推进默认被拒
+   * （TASK_FINALIZE_CONFIRMATION_REQUIRED），携带 finalize=true 才完成收尾终态化；
+   * 中间节点传递无副作用（守卫不在其路径，宽容语义）。
+   */
+  finalize: z10.boolean().optional()
 });
-var ApproveRequestSchema = z9.object({
-  decision: z9.enum(["approved", "rejected"]),
-  comment: z9.string().optional()
+var ApproveRequestSchema = z10.object({
+  decision: z10.enum(["approved", "rejected"]),
+  comment: z10.string().optional()
 });
-var TaskPublicSchema = z9.object({
-  taskId: z9.string(),
-  title: z9.string(),
+var TaskPublicSchema = z10.object({
+  taskId: z10.string(),
+  title: z10.string(),
   // T202608240003：任务类型标签（缺省 = 裸任务/旧任务；模板 PRD 调研变体判定消费）
-  type: z9.enum(TASK_TYPES).optional(),
-  currentNode: z9.string(),
-  currentPhase: z9.string(),
-  status: z9.string(),
-  pausedAt: z9.string().nullable(),
-  track: z9.string()
+  type: z10.enum(TASK_TYPES).optional(),
+  currentNode: z10.string(),
+  currentPhase: z10.string(),
+  status: z10.string(),
+  pausedAt: z10.string().nullable(),
+  track: z10.string()
 });
-var NodeInfoSchema = z9.object({
-  nodeId: z9.string(),
-  label: z9.string(),
-  track: z9.string(),
-  prompt: z9.string(),
-  skills: z9.array(z9.string()),
-  agents: z9.array(z9.string()),
-  upcomingPause: z9.string().nullable()
+var NodeInfoSchema = z10.object({
+  nodeId: z10.string(),
+  label: z10.string(),
+  track: z10.string(),
+  prompt: z10.string(),
+  skills: z10.array(z10.string()),
+  agents: z10.array(z10.string()),
+  upcomingPause: z10.string().nullable()
 });
-var AdvanceResponseSchema = z9.discriminatedUnion("status", [
-  z9.object({
-    status: z9.literal("advanced"),
+var AdvanceResponseSchema = z10.discriminatedUnion("status", [
+  z10.object({
+    status: z10.literal("advanced"),
     task: TaskPublicSchema,
     nextNode: NodeInfoSchema
   }),
-  z9.object({
-    status: z9.literal("paused"),
+  z10.object({
+    status: z10.literal("paused"),
     task: TaskPublicSchema,
     pausePoint: EdgePausePointSchema,
-    guidance: z9.string()
+    guidance: z10.string()
   }),
-  z9.object({
-    status: z9.literal("completed"),
+  z10.object({
+    status: z10.literal("completed"),
     task: TaskPublicSchema
   })
 ]);
-var ApproveResponseSchema = z9.discriminatedUnion("status", [
-  z9.object({
-    status: z9.literal("advanced"),
+var ApproveResponseSchema = z10.discriminatedUnion("status", [
+  z10.object({
+    status: z10.literal("advanced"),
     task: TaskPublicSchema,
     nextNode: NodeInfoSchema
   }),
-  z9.object({
-    status: z9.literal("rejected"),
+  z10.object({
+    status: z10.literal("rejected"),
     task: TaskPublicSchema,
-    guidance: z9.string()
+    guidance: z10.string()
   }),
   // 「completed」分支当前引擎不可达（approve 从 paused 流转必有下一节点，技术方案 §2.2
   // 已删 paused→completed 直达路径）——按方案 §2.1 契约保留作前向兼容预留
-  z9.object({
-    status: z9.literal("completed"),
+  z10.object({
+    status: z10.literal("completed"),
     task: TaskPublicSchema
   })
 ]);
-var PauseRequestSchema = z9.object({
-  reason: z9.string().optional()
+var PauseRequestSchema = z10.object({
+  reason: z10.string().optional()
+});
+var ResumeRequestSchema = z10.object({
+  decision: z10.string().optional()
 });
-var ResumeRequestSchema = z9.object({
-  decision: z9.string().optional()
+var CancelRequestSchema = z10.object({
+  reason: z10.string().min(1).max(500).optional()
 });
-var CancelRequestSchema = z9.object({
-  reason: z9.string().min(1).max(500).optional()
+var ReopenRequestSchema = z10.object({
+  reason: z10.string().min(1).max(500)
 });
 
 // src/schemas/task-doc.ts
-import { z as z10 } from "zod";
-var TaskContextSchema = z10.object({
-  task: z10.object({
-    taskId: z10.string(),
-    title: z10.string(),
+import { z as z11 } from "zod";
+var TaskContextSchema = z11.object({
+  task: z11.object({
+    taskId: z11.string(),
+    title: z11.string(),
     // T202608240003：与 TaskPublicSchema 同步（toTaskPublic 运行时已产出，schema 声明漂移会导致 typed 消费方 strip 掉 type）
-    type: z10.enum(TASK_TYPES).optional(),
-    currentNode: z10.string(),
-    currentPhase: z10.string(),
-    status: z10.string(),
-    pausedAt: z10.string().nullable(),
-    track: z10.string()
+    type: z11.enum(TASK_TYPES).optional(),
+    currentNode: z11.string(),
+    currentPhase: z11.string(),
+    status: z11.string(),
+    pausedAt: z11.string().nullable(),
+    track: z11.string()
   }),
-  currentNode: z10.object({
-    nodeId: z10.string(),
-    label: z10.string(),
-    phase: z10.string(),
-    track: z10.string(),
+  currentNode: z11.object({
+    nodeId: z11.string(),
+    label: z11.string(),
+    phase: z11.string(),
+    track: z11.string(),
     /** renderPrompt 渲染后（AI 推进任务的直接输入） */
-    prompt: z10.string(),
-    skills: z10.array(z10.string()),
-    agents: z10.array(z10.string()),
+    prompt: z11.string(),
+    skills: z11.array(z11.string()),
+    agents: z11.array(z11.string()),
     /** 完成当前节点后出边上的暂停点描述（经 findNextEdge 按轨选边） */
-    upcomingPause: z10.string().nullable()
+    upcomingPause: z11.string().nullable()
   }).nullable(),
-  pausedAtEdge: z10.object({
-    from: z10.string(),
-    to: z10.string(),
+  pausedAtEdge: z11.object({
+    from: z11.string(),
+    to: z11.string(),
     pausePoint: EdgePausePointBaseSchema
   }).nullable(),
   /** 全节点实时状态清单 */
-  nodes: z10.array(z10.object({
-    nodeId: z10.string(),
-    label: z10.string(),
-    status: z10.string(),
-    enteredAt: z10.date().nullable(),
-    completedAt: z10.date().nullable()
+  nodes: z11.array(z11.object({
+    nodeId: z11.string(),
+    label: z11.string(),
+    status: z11.string(),
+    enteredAt: z11.date().nullable(),
+    completedAt: z11.date().nullable()
   })),
   /** N020 D1：任务级结构化文档（未写时 null） */
   taskDoc: TaskDocContentSchema.nullable(),
   /** N020 D1：节点执行记录（仅含已写记录的 nodeId） */
-  nodeRecords: z10.record(z10.string(), NodeRecordSchema),
+  nodeRecords: z11.record(z11.string(), NodeRecordSchema),
   /** N020 D1：跨节点累积素材（架构信息收集条目） */
-  archNotes: z10.array(ArchNoteSchema)
+  archNotes: z11.array(ArchNoteSchema)
 });
-var TaskSummarySchema = z10.object({
-  taskId: z10.string(),
-  title: z10.string(),
+var TaskSummarySchema = z11.object({
+  taskId: z11.string(),
+  title: z11.string(),
   // T202608240003：任务类型标签（缺省 = 裸任务/旧任务）
-  type: z10.enum(TASK_TYPES).optional(),
-  projectId: z10.string(),
-  dagTemplateId: z10.string(),
-  currentNode: z10.string(),
-  currentPhase: z10.string(),
-  status: z10.string(),
-  pausedAt: z10.string().nullable(),
-  track: z10.string(),
-  progress: z10.object({
-    completed: z10.number(),
-    total: z10.number()
+  type: z11.enum(TASK_TYPES).optional(),
+  projectId: z11.string(),
+  dagTemplateId: z11.string(),
+  currentNode: z11.string(),
+  currentPhase: z11.string(),
+  status: z11.string(),
+  pausedAt: z11.string().nullable(),
+  track: z11.string(),
+  progress: z11.object({
+    completed: z11.number(),
+    total: z11.number()
   }),
-  createdAt: z10.date().optional(),
-  updatedAt: z10.date().optional()
+  createdAt: z11.date().optional(),
+  updatedAt: z11.date().optional()
 });
 
 // src/schemas/write-ack.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 var WRITE_ACK_ENTRY_KINDS = ["check", "artifact", "decision", "confirmation", "archnote"];
-var WriteAckEntryKindSchema = z11.enum(WRITE_ACK_ENTRY_KINDS);
-var EchoItemSchema = z11.object({
-  path: z11.string(),
-  excerpt: z11.string()
+var WriteAckEntryKindSchema = z12.enum(WRITE_ACK_ENTRY_KINDS);
+var EchoItemSchema = z12.object({
+  path: z12.string(),
+  excerpt: z12.string()
 });
-var TaskProgressSchema = z11.object({
-  completed: z11.number().int(),
-  total: z11.number().int()
+var TaskProgressSchema = z12.object({
+  completed: z12.number().int(),
+  total: z12.number().int()
 });
 var TaskProgressPublicSchema = TaskPublicSchema.extend({
-  projectId: z11.string(),
+  projectId: z12.string(),
   progress: TaskProgressSchema
 });
-var WriteAckSchema = z11.object({
-  taskId: z11.string(),
+var WriteAckSchema = z12.object({
+  taskId: z12.string(),
   /** 本次写入触及的字段点路径（如 doc.what / nodeRecords.PRD.checks） */
-  updated: z11.array(z11.string()),
+  updated: z12.array(z12.string()),
   /** 新建条目标识（$push 五类对象条目；无新条目的端点缺省） */
-  entry: z11.object({
-    id: z11.string(),
+  entry: z12.object({
+    id: z12.string(),
     kind: WriteAckEntryKindSchema
   }).optional(),
   /** 写入内容回显（触及字段逐条；无值可回显的端点可缺省） */
-  echo: z11.array(EchoItemSchema).optional(),
-  updatedAt: z11.date(),
+  echo: z12.array(EchoItemSchema).optional(),
+  updatedAt: z12.date(),
   task: TaskProgressPublicSchema
 });
-var TaskBatchEntrySchema = z11.object({
-  index: z11.number().int().min(0),
-  id: z11.string().optional(),
+var TaskBatchEntrySchema = z12.object({
+  index: z12.number().int().min(0),
+  id: z12.string().optional(),
   kind: WriteAckEntryKindSchema.optional()
 });
-var TaskBatchFailureSchema = z11.object({
-  index: z11.number().int().min(0),
-  message: z11.string(),
-  hint: z11.string().optional()
+var TaskBatchFailureSchema = z12.object({
+  index: z12.number().int().min(0),
+  message: z12.string(),
+  hint: z12.string().optional()
 });
-var TaskBatchAckSchema = z11.object({
-  taskId: z11.string(),
+var TaskBatchAckSchema = z12.object({
+  taskId: z12.string(),
   /** 成功落库条目数（部分失败语义：成功条目保留不回滚） */
-  applied: z11.number().int().min(0),
+  applied: z12.number().int().min(0),
   /** 本次写入触及的字段点路径 */
-  updated: z11.array(z11.string()),
-  entries: z11.array(TaskBatchEntrySchema),
-  failures: z11.array(TaskBatchFailureSchema),
-  updatedAt: z11.date(),
+  updated: z12.array(z12.string()),
+  entries: z12.array(TaskBatchEntrySchema),
+  failures: z12.array(TaskBatchFailureSchema),
+  updatedAt: z12.date(),
   task: TaskProgressPublicSchema
 });
-var CreateTaskResponseSchema = z11.object({
+var CreateTaskResponseSchema = z12.object({
   task: TaskProgressPublicSchema,
   firstNode: NodeInfoSchema
 });
@@ -2936,34 +3446,34 @@ function excerpt(value, max = 120) {
   return `${chars.slice(0, max - 1).join("")}\u2026`;
 }
 var CONTEXT_VIEWS = ["basic", "full"];
-var ContextViewSchema = z11.enum(CONTEXT_VIEWS);
+var ContextViewSchema = z12.enum(CONTEXT_VIEWS);
 
 // src/schemas/project.ts
-import { z as z12 } from "zod";
-var ProjectStatusSchema = z12.enum(["active", "archived"]);
-var ProjectSchema = z12.object({
-  id: z12.string().optional(),
-  key: z12.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09"),
-  name: z12.string().min(1).max(50),
-  description: z12.string().max(500).optional(),
+import { z as z13 } from "zod";
+var ProjectStatusSchema = z13.enum(["active", "archived"]);
+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"),
-  createdAt: z12.date().optional(),
-  updatedAt: z12.date().optional()
+  createdAt: z13.date().optional(),
+  updatedAt: z13.date().optional()
 });
-var ProjectCreateSchema = z12.object({
-  key: z12.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09").optional(),
-  name: z12.string().min(1).max(50),
-  description: z12.string().max(500).optional()
+var ProjectCreateSchema = z13.object({
+  key: z13.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09").optional(),
+  name: z13.string().min(1).max(50),
+  description: z13.string().max(500).optional()
 });
-var ProjectUpdateSchema = z12.object({
-  name: z12.string().min(1).max(50).optional(),
-  description: z12.string().max(500).optional(),
+var ProjectUpdateSchema = z13.object({
+  name: z13.string().min(1).max(50).optional(),
+  description: z13.string().max(500).optional(),
   status: ProjectStatusSchema.optional()
 });
 
 // src/schemas/enum-registry.ts
-import { z as z13 } from "zod";
-var EnumRegistryCategorySchema = z13.enum([
+import { z as z14 } from "zod";
+var EnumRegistryCategorySchema = z14.enum([
   "dag_phase",
   "dag_track",
   "pause_type",
@@ -2971,106 +3481,107 @@ var EnumRegistryCategorySchema = z13.enum([
   "node_status",
   "skill_category",
   "scope",
-  "agent_function"
+  "agent_function",
+  "issue_status"
 ]);
-var EnumEntrySchema = z13.object({
+var EnumEntrySchema = z14.object({
   /** 领域层存库的原始枚举值（不可臆造；builtin 值 engine/DB 强依赖；kebab 约束与 skill name 对齐，保证 DELETE /entries/:value 可寻址） */
-  value: z13.string().regex(/^[a-z0-9][a-z0-9_-]*$/, "value \u4EC5\u652F\u6301\u5C0F\u5199\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF/\u8FDE\u5B57\u7B26\uFF08kebab-case\uFF09"),
+  value: z14.string().regex(/^[a-z0-9][a-z0-9_-]*$/, "value \u4EC5\u652F\u6301\u5C0F\u5199\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF/\u8FDE\u5B57\u7B26\uFF08kebab-case\uFF09"),
   /** 展示文案（消费端下拉直接取用） */
-  label: z13.string().min(1, "label \u4E0D\u80FD\u4E3A\u7A7A"),
+  label: z14.string().min(1, "label \u4E0D\u80FD\u4E3A\u7A7A"),
   /** 可选语义色 token（如 --success / --warning），消费端映射到 UI */
-  color: z13.string().optional(),
+  color: z14.string().optional(),
   /** 下拉排序（升序） */
-  order: z13.number().int().default(0),
+  order: z14.number().int().default(0),
   /** 内置值：禁删 + label/color 可改但 value 不可改（D8）；seed 时标记 */
-  builtin: z13.boolean().default(false),
+  builtin: z14.boolean().default(false),
   /** 启停：false = 下拉禁用展示（历史数据仍可读，新选择不可用） */
-  active: z13.boolean().default(true)
+  active: z14.boolean().default(true)
 });
-var EnumRegistrySchema = z13.object({
-  id: z13.string().optional(),
+var EnumRegistrySchema = z14.object({
+  id: z14.string().optional(),
   category: EnumRegistryCategorySchema,
-  entries: z13.array(EnumEntrySchema).default([]),
-  updatedAt: z13.date().optional()
+  entries: z14.array(EnumEntrySchema).default([]),
+  updatedAt: z14.date().optional()
 });
-var EnumRegistryUpdateSchema = z13.object({
-  entries: z13.array(EnumEntrySchema)
+var EnumRegistryUpdateSchema = z14.object({
+  entries: z14.array(EnumEntrySchema)
 });
 
 // src/schemas/asset-enabled.ts
-import { z as z14 } from "zod";
-var AssetSetEnabledSchema = z14.object({
-  enabled: z14.boolean()
+import { z as z15 } from "zod";
+var AssetSetEnabledSchema = z15.object({
+  enabled: z15.boolean()
 });
 
 // src/schemas/auth.ts
-import { z as z15 } from "zod";
-var AuthTokenTypeSchema = z15.enum(["admin", "project"]);
-var AuthAccountSchema = z15.object({
-  id: z15.string().optional(),
-  username: z15.string().min(3, "\u8D26\u53F7\u81F3\u5C11 3 \u4E2A\u5B57\u7B26").max(50).regex(/^[a-zA-Z0-9_-]+$/, "\u8D26\u53F7\u4EC5\u5141\u8BB8\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u4E0E\u8FDE\u5B57\u7B26"),
+import { z as z16 } from "zod";
+var AuthTokenTypeSchema = z16.enum(["admin", "project"]);
+var AuthAccountSchema = z16.object({
+  id: z16.string().optional(),
+  username: z16.string().min(3, "\u8D26\u53F7\u81F3\u5C11 3 \u4E2A\u5B57\u7B26").max(50).regex(/^[a-zA-Z0-9_-]+$/, "\u8D26\u53F7\u4EC5\u5141\u8BB8\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u4E0E\u8FDE\u5B57\u7B26"),
   /** 存储形态：scrypt$N$r$p$salt$hash（base64 段），明文仅存在于请求体 */
-  passwordHash: z15.string().min(1),
-  createdAt: z15.date().optional(),
-  updatedAt: z15.date().optional()
+  passwordHash: z16.string().min(1),
+  createdAt: z16.date().optional(),
+  updatedAt: z16.date().optional()
 });
-var AuthAccountCreateSchema = z15.object({
+var AuthAccountCreateSchema = z16.object({
   username: AuthAccountSchema.shape.username,
-  password: z15.string().min(8, "\u5BC6\u7801\u81F3\u5C11 8 \u4E2A\u5B57\u7B26").max(128)
+  password: z16.string().min(8, "\u5BC6\u7801\u81F3\u5C11 8 \u4E2A\u5B57\u7B26").max(128)
 });
-var PasswordChangeSchema = z15.object({
-  currentPassword: z15.string().min(1),
-  newPassword: z15.string().min(8, "\u5BC6\u7801\u81F3\u5C11 8 \u4E2A\u5B57\u7B26").max(128)
+var PasswordChangeSchema = z16.object({
+  currentPassword: z16.string().min(1),
+  newPassword: z16.string().min(8, "\u5BC6\u7801\u81F3\u5C11 8 \u4E2A\u5B57\u7B26").max(128)
 });
-var LoginSchema = z15.object({
-  username: z15.string().min(1),
-  password: z15.string().min(1)
+var LoginSchema = z16.object({
+  username: z16.string().min(1),
+  password: z16.string().min(1)
 });
-var AuthTokenSchema = z15.object({
-  id: z15.string().optional(),
+var AuthTokenSchema = z16.object({
+  id: z16.string().optional(),
   /** sha256(token 全串含前缀) hex——明文 Token 不入库 */
-  tokenHash: z15.string().regex(/^[a-f0-9]{64}$/),
+  tokenHash: z16.string().regex(/^[a-f0-9]{64}$/),
   type: AuthTokenTypeSchema,
   /** type=project 时必填且不可缺失（superRefine 保证）；指向 projects.id（24-hex） */
-  projectId: z15.string().regex(/^[a-f0-9]{24}$/, "projectId \u5FC5\u987B\u4E3A 24-hex ObjectId").optional(),
-  createdAt: z15.date().optional(),
-  updatedAt: z15.date().optional()
+  projectId: z16.string().regex(/^[a-f0-9]{24}$/, "projectId \u5FC5\u987B\u4E3A 24-hex ObjectId").optional(),
+  createdAt: z16.date().optional(),
+  updatedAt: z16.date().optional()
 }).superRefine((data, ctx) => {
   if (data.type === "project" && data.projectId === void 0) {
     ctx.addIssue({ code: "custom", path: ["projectId"], message: "\u9879\u76EE Token \u5FC5\u987B\u7ED1\u5B9A projectId" });
   }
 });
-var AuthTokenGenResponseSchema = z15.object({
-  token: z15.string().min(1),
+var AuthTokenGenResponseSchema = z16.object({
+  token: z16.string().min(1),
   type: AuthTokenTypeSchema,
-  projectId: z15.string().optional()
+  projectId: z16.string().optional()
 });
-var AuthTokenStatusSchema = z15.object({
+var AuthTokenStatusSchema = z16.object({
   type: AuthTokenTypeSchema,
-  projectId: z15.string().optional(),
-  hasToken: z15.boolean(),
-  createdAt: z15.date().nullable().optional()
+  projectId: z16.string().optional(),
+  hasToken: z16.boolean(),
+  createdAt: z16.date().nullable().optional()
 });
-var AuthWhoamiSchema = z15.object({
-  identity: z15.enum(["admin", "project", "none"]),
-  project: z15.object({
-    id: z15.string(),
-    key: z15.string(),
-    name: z15.string()
+var AuthWhoamiSchema = z16.object({
+  identity: z16.enum(["admin", "project", "none"]),
+  project: z16.object({
+    id: z16.string(),
+    key: z16.string(),
+    name: z16.string()
   }).nullable().optional(),
-  authEnabled: z15.boolean(),
-  server: z15.object({
-    url: z15.string()
+  authEnabled: z16.boolean(),
+  server: z16.object({
+    url: z16.string()
   })
 });
-var AuthStatusSchema = z15.object({
-  authEnabled: z15.boolean(),
+var AuthStatusSchema = z16.object({
+  authEnabled: z16.boolean(),
   /** 鉴权开启且无管理员账号 = 初始化引导窗口（PRD §3.2） */
-  needsSetup: z15.boolean()
+  needsSetup: z16.boolean()
 });
 
 // src/schemas/node-preset.ts
-import { z as z16 } from "zod";
+import { z as z17 } from "zod";
 var NODE_PRESET_CODE_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
 var NodePresetScopeRefine = (val, ctx) => {
   if (val.scope === "project" && !val.projectId) {
@@ -3081,7 +3592,7 @@ var NodePresetScopeRefine = (val, ctx) => {
     });
   }
 };
-var uniqueNamesSchema = z16.array(z16.string().min(1)).superRefine((names, ctx) => {
+var uniqueNamesSchema = z17.array(z17.string().min(1)).superRefine((names, ctx) => {
   const seen = /* @__PURE__ */ new Set();
   names.forEach((name, index) => {
     if (seen.has(name)) {
@@ -3090,30 +3601,30 @@ var uniqueNamesSchema = z16.array(z16.string().min(1)).superRefine((names, ctx)
     seen.add(name);
   });
 });
-var NodePresetShapeSchema = z16.object({
-  id: z16.string().optional(),
-  code: z16.string().regex(NODE_PRESET_CODE_PATTERN, "kebab-case only"),
-  label: z16.string().min(1),
+var NodePresetShapeSchema = z17.object({
+  id: z17.string().optional(),
+  code: z17.string().regex(NODE_PRESET_CODE_PATTERN, "kebab-case only"),
+  label: z17.string().min(1),
   /** 组装默认节点标识（模板图结构域；字符集同 NODE_ID_PATTERN——节点记录点路径拼接安全前提） */
-  nodeId: z16.string().regex(/^[A-Za-z0-9_-]+$/, "nodeId \u53EA\u5141\u8BB8\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF/\u8FDE\u5B57\u7B26"),
+  nodeId: z17.string().regex(/^[A-Za-z0-9_-]+$/, "nodeId \u53EA\u5141\u8BB8\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF/\u8FDE\u5B57\u7B26"),
   /** 运行时注册表判定（对齐 dag_phase/dag_track 放宽策略——Zod 只做类型级） */
-  phase: z16.string(),
-  track: z16.string(),
-  prompt: z16.string().min(1),
+  phase: z17.string(),
+  track: z17.string(),
+  prompt: z17.string().min(1),
   /** 绑定技能名单（by-name 引用；版本要求只存在于 npm 分发层 manifest，不侵入运行链路） */
   skills: uniqueNamesSchema,
   /** 节点执行时可调用的 Agent 名单（by-name 引用；正文仍由独立 Agent 资产承载） */
   agents: uniqueNamesSchema,
-  scope: z16.enum(["global", "project"]),
-  projectId: z16.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
-  description: z16.string().optional(),
-  version: z16.string(),
+  scope: z17.enum(["global", "project"]),
+  projectId: z17.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
+  description: z17.string().optional(),
+  version: z17.string(),
   /** 分发来源标注（flow install 落库时填充包名；手工创建无此字段——「来源可见可核查」信任模型） */
-  source: z16.object({ package: z16.string().min(1) }).optional(),
+  source: z17.object({ package: z17.string().min(1) }).optional(),
   /** 资产启停（可选——存量无此字段 = 启用；唯一写入口 POST /:code/enabled，不入 Create/Update/Copy） */
-  enabled: z16.boolean().optional(),
-  createdAt: z16.date().optional(),
-  updatedAt: z16.date().optional()
+  enabled: z17.boolean().optional(),
+  createdAt: z17.date().optional(),
+  updatedAt: z17.date().optional()
 });
 var NodePresetSchema = NodePresetShapeSchema.superRefine(NodePresetScopeRefine);
 var NodePresetCreateSchema = NodePresetShapeSchema.omit({
@@ -3124,7 +3635,7 @@ var NodePresetCreateSchema = NodePresetShapeSchema.omit({
 }).extend({
   skills: uniqueNamesSchema.default([]),
   agents: uniqueNamesSchema.default([]),
-  version: z16.string().default("1.0.0")
+  version: z17.string().default("1.0.0")
 }).superRefine(NodePresetScopeRefine);
 var NodePresetUpdateSchema = NodePresetShapeSchema.omit({
   id: true,
@@ -3132,12 +3643,12 @@ var NodePresetUpdateSchema = NodePresetShapeSchema.omit({
   updatedAt: true,
   enabled: true
 }).extend({
-  version: z16.string().optional()
+  version: z17.string().optional()
 }).partial().superRefine(NodePresetScopeRefine);
-var NodePresetCopySchema = z16.object({
-  newCode: z16.string().regex(NODE_PRESET_CODE_PATTERN, "kebab-case only"),
-  newScope: z16.enum(["global", "project"]),
-  targetProjectId: z16.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
+var NodePresetCopySchema = z17.object({
+  newCode: z17.string().regex(NODE_PRESET_CODE_PATTERN, "kebab-case only"),
+  newScope: z17.enum(["global", "project"]),
+  targetProjectId: z17.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
 }).superRefine((val, ctx) => {
   if (val.newScope === "project" && !val.targetProjectId) {
     ctx.addIssue({
@@ -3149,38 +3660,38 @@ var NodePresetCopySchema = z16.object({
 });
 
 // src/schemas/node-library.ts
-import { z as z17 } from "zod";
-var CompositionEdgeSchema = z17.object({
-  from: z17.string().min(1),
-  to: z17.string().min(1),
-  condition: z17.string().optional(),
+import { z as z18 } from "zod";
+var CompositionEdgeSchema = z18.object({
+  from: z18.string().min(1),
+  to: z18.string().min(1),
+  condition: z18.string().optional(),
   pausePoint: EdgePausePointSchema.optional()
 });
-var CompositionSchema = z17.object({
-  name: z17.string().min(1),
-  description: z17.string().optional(),
-  nodes: z17.array(z17.string().min(1)).min(1),
-  edges: z17.array(CompositionEdgeSchema)
+var CompositionSchema = z18.object({
+  name: z18.string().min(1),
+  description: z18.string().optional(),
+  nodes: z18.array(z18.string().min(1)).min(1),
+  edges: z18.array(CompositionEdgeSchema)
 });
-var NodeLibrarySchema = z17.object({
-  id: z17.string().optional(),
+var NodeLibrarySchema = z18.object({
+  id: z18.string().optional(),
   /** 库名 = npm 包名（同库重装按名 upsert 覆盖登记） */
-  name: z17.string().min(1),
-  version: z17.string(),
-  scope: z17.enum(["global", "project"]),
-  projectId: z17.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
+  name: z18.string().min(1),
+  version: z18.string(),
+  scope: z18.enum(["global", "project"]),
+  projectId: z18.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
   /** 已装节点 code 清单（flow compose 逐 code 解析 node_presets） */
-  nodes: z17.array(z17.string()),
-  compositions: z17.array(CompositionSchema),
-  installedAt: z17.date().optional()
+  nodes: z18.array(z18.string()),
+  compositions: z18.array(CompositionSchema),
+  installedAt: z18.date().optional()
 });
-var NodeLibraryUpsertSchema = z17.object({
-  name: z17.string().min(1),
-  version: z17.string(),
-  scope: z17.enum(["global", "project"]),
-  projectId: z17.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
-  nodes: z17.array(z17.string()),
-  compositions: z17.array(CompositionSchema)
+var NodeLibraryUpsertSchema = z18.object({
+  name: z18.string().min(1),
+  version: z18.string(),
+  scope: z18.enum(["global", "project"]),
+  projectId: z18.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
+  nodes: z18.array(z18.string()),
+  compositions: z18.array(CompositionSchema)
 }).superRefine((val, ctx) => {
   if (val.scope === "project" && !val.projectId) {
     ctx.addIssue({
@@ -3192,28 +3703,28 @@ var NodeLibraryUpsertSchema = z17.object({
 });
 
 // src/schemas/template-upgrade.ts
-import { z as z18 } from "zod";
-var UpgradeNodeStatusSchema = z18.enum([
+import { z as z19 } from "zod";
+var UpgradeNodeStatusSchema = z19.enum([
   "updatable",
   "local-modified",
   "up-to-date",
   "source-missing",
   "source-disabled"
 ]);
-var UpgradeActionSchema = z18.enum(["upgrade", "keep", "skip"]);
-var UpgradeDecisionSchema = z18.object({
-  nodeId: z18.string().min(1),
+var UpgradeActionSchema = z19.enum(["upgrade", "keep", "skip"]);
+var UpgradeDecisionSchema = z19.object({
+  nodeId: z19.string().min(1),
   action: UpgradeActionSchema,
-  expected: z18.object({ status: UpgradeNodeStatusSchema }).optional()
+  expected: z19.object({ status: UpgradeNodeStatusSchema }).optional()
 });
-var UpgradeApplyRequestSchema = z18.object({
-  decisions: z18.array(UpgradeDecisionSchema).min(1)
+var UpgradeApplyRequestSchema = z19.object({
+  decisions: z19.array(UpgradeDecisionSchema).min(1)
 });
 
 // src/config/server-config.ts
-import { z as z19 } from "zod";
-var SimingLogLevelSchema = z19.enum(["debug", "info", "warn", "error"]);
-var HttpOriginSchema = z19.string().transform((value, ctx) => {
+import { z as z20 } from "zod";
+var SimingLogLevelSchema = z20.enum(["debug", "info", "warn", "error"]);
+var HttpOriginSchema = z20.string().transform((value, ctx) => {
   let origin = null;
   try {
     const url = new URL(value);
@@ -3222,25 +3733,25 @@ var HttpOriginSchema = z19.string().transform((value, ctx) => {
   }
   if (origin === null) {
     ctx.addIssue({ code: "custom", message: "must be an http(s):// URL" });
-    return z19.NEVER;
+    return z20.NEVER;
   }
   return origin;
 });
-var SimingConfigSchema = z19.object({
-  mongoUri: z19.string().min(1).default("mongodb://localhost:27017"),
-  port: z19.coerce.number().int().min(1).max(65535).default(7777),
+var SimingConfigSchema = z20.object({
+  mongoUri: z20.string().min(1).default("mongodb://localhost:27017"),
+  port: z20.coerce.number().int().min(1).max(65535).default(7777),
   /**
    * N018 D8：默认仅绑定本机回环（安全默认）；远程/局域接入（F7）显式配置 host。
    * 超出 PRD V1 配置清单的新增项，依据见技术方案 §3.4「超范围扩展标注」。
    */
-  host: z19.string().min(1).default("127.0.0.1"),
+  host: z20.string().min(1).default("127.0.0.1"),
   logLevel: SimingLogLevelSchema.default("info"),
   /**
    * T202608310001：鉴权开关（F1）——从 F6 预留宽松形态收紧为类型化 schema。
    * 默认关闭 = 本地开发/存量行为零破坏；云主机部署显式开启（SIMING_AUTH_ENABLED=true）。
    */
-  auth: z19.object({
-    enabled: z19.boolean().default(false)
+  auth: z20.object({
+    enabled: z20.boolean().default(false)
   }).prefault({}),
   /**
    * T202609070001：服务对外可达基础地址（whoami 自报 server.url 用）——反代终止 TLS 后
@@ -3249,7 +3760,7 @@ var SimingConfigSchema = z19.object({
    * 消费侧来源/摘要逻辑对 undefined 的 optional 键不补「内置默认值」来源。
    */
   publicUrl: HttpOriginSchema.optional(),
-  cors: z19.unknown().optional()
+  cors: z20.unknown().optional()
 });
 var SIMING_CONFIG_KEYS = ["mongoUri", "port", "host", "logLevel", "auth", "publicUrl"];
 var SIMING_CONFIG_ENV_KEYS = {
@@ -3539,21 +4050,6 @@ function applyUpgradeDecisions(template, presetsByCode, decisions) {
   return { nodes, nextVersion: changed ? bumpPatch(template.version) : null, results };
 }
 
-// src/task/entry-id.ts
-var ENTRY_ID_LENGTH = 6;
-var BASE36_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
-function generateEntryId(existing) {
-  const taken = new Set(existing);
-  for (let attempt = 0; attempt < 32; attempt++) {
-    let id = "";
-    for (let i = 0; i < ENTRY_ID_LENGTH; i++) {
-      id += BASE36_ALPHABET[Math.floor(Math.random() * BASE36_ALPHABET.length)];
-    }
-    if (!taken.has(id)) return id;
-  }
-  throw new Error(`entry id generation failed after 32 attempts (existing: ${existing.length})`);
-}
-
 // src/template-transfer/payload.ts
 function toTemplatePayload(tpl) {
   const { id: _id, projectId: _projectId, enabled: _enabled, createdAt: _ca, updatedAt: _ua, code: _code, ...rest } = tpl;
@@ -3977,7 +4473,7 @@ function errorMessage(err) {
 }
 
 // src/index.ts
-var PackageJsonSchema = z20.object({ version: z20.string().min(1) });
+var PackageJsonSchema = z21.object({ version: z21.string().min(1) });
 var packageJsonParsed = PackageJsonSchema.safeParse(
   JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"))
 );
@@ -4057,11 +4553,23 @@ export {
   ForbiddenError,
   HistoryActionSchema,
   HistoryEntrySchema,
+  ISSUE_ACTIVE_STATUSES,
+  ISSUE_CONVERT_MODES,
+  ISSUE_SOURCES,
+  ISSUE_STATUSES,
   ImportApplyRequestSchema,
   ImportApplyResponseSchema,
   ImportDecisionSchema,
   ImportPlanRequestSchema,
   ImportPlanResponseSchema,
+  IssueConvertModeSchema,
+  IssueCreateSchema,
+  IssueHistoryEntrySchema,
+  IssueProgressSchema,
+  IssueSchema,
+  IssueSourceSchema,
+  IssueStatusSchema,
+  IssueUpdateSchema,
   LoginSchema,
   ModelAliasCreateSchema,
   ModelAliasPayloadSchema,
@@ -4094,6 +4602,7 @@ export {
   ProjectStatusSchema,
   ProjectUpdateSchema,
   REFERENCE_LIMITS,
+  ReopenRequestSchema,
   ResumeRequestSchema,
   ReviewSummarySchema,
   SIMING_CODE_REGEX,
@@ -4121,6 +4630,7 @@ export {
   TaskContextSchema,
   TaskCreateInputSchema,
   TaskDocContentSchema,
+  TaskLinkSchema,
   TaskPhaseSchema,
   TaskProgressPublicSchema,
   TaskProgressSchema,
@@ -4167,6 +4677,7 @@ export {
   createAuthTokenRepo,
   createDagTemplateRepo,
   createEnumRegistryRepo,
+  createIssueRepo,
   createModelAliasRepo,
   createMongoClient,
   createNodeLibraryRepo,
@@ -4177,6 +4688,7 @@ export {
   createSkillRepo,
   createTaskRepo,
   decisionKey,
+  derivePreTerminalState,
   diffTemplateContent,
   enabledNeFalse,
   escapeRegExpLiteral,
@@ -4199,6 +4711,7 @@ export {
   ping,
   pruneInstance,
   renderPrompt,
+  reopenTask,
   resumeTask,
   sumReferenceContentChars,
   taskProgress,