@siming-org/core 0.3.0 → 0.4.0

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 import { readFileSync } from "fs";
-import { z as z11 } from "zod";
+import { z as z15 } from "zod";
 
 // src/store/client.ts
 import { MongoClient } from "mongodb";
@@ -88,6 +88,12 @@ function createRepo(collection, options = {}) {
     }
   };
 }
+function escapeRegExpLiteral(input) {
+  return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function enabledNeFalse() {
+  return { enabled: { $ne: false } };
+}
 
 // src/errors.ts
 var BIZ_CODE_MESSAGES = {
@@ -108,6 +114,8 @@ var BIZ_CODE_MESSAGES = {
   ENUM_ENTRY_IN_USE: "\u679A\u4E3E\u503C\u88AB\u8D44\u6E90\u5F15\u7528\uFF0C\u7981\u6B62\u5220\u9664",
   ENUM_VALUE_CONFLICT: "\u679A\u4E3E\u503C\u5DF2\u5B58\u5728",
   NAME_SCOPE_CONFLICT: "\u8BE5\u4F5C\u7528\u57DF\u5185\u5DF2\u5B58\u5728\u540C\u540D\u8D44\u6E90\uFF08\u5168\u5C40\u8D44\u6E90\u4E0E\u9879\u76EE\u8D44\u6E90\u4E0D\u53EF\u540C\u540D\uFF09",
+  // T202608270002：主文档引用的引用文档删除保护（message 由路由层附加具体 path 清单）
+  REFERENCE_IN_USE: "\u4E3B\u6587\u6863\u4ECD\u5F15\u7528\u5F85\u5220\u9664\u7684\u5F15\u7528\u6587\u6863\uFF0C\u8BF7\u5148\u79FB\u9664\u4E3B\u6587\u6863\u4E2D\u7684\u5F15\u7528\u518D\u5220\u9664",
   TASK_DOC_NOT_SET: "\u4EFB\u52A1\u672A\u5173\u8054\u4EFB\u52A1\u6587\u4EF6",
   TASK_DOC_NOT_FOUND: "\u4EFB\u52A1\u6587\u4EF6\u4E0D\u5B58\u5728",
   TASK_DOC_SECTION_NOT_FOUND: "\u4EFB\u52A1\u6587\u4EF6\u4E2D\u672A\u627E\u5230\u5339\u914D\u6BB5\u843D",
@@ -121,7 +129,9 @@ var BIZ_CODE_MESSAGES = {
   // 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",
-  TASK_TYPE_TRACK_MISMATCH: "\u4EFB\u52A1\u7C7B\u578B\u4E0E\u8F68\u9053\u7EC4\u5408\u975E\u6CD5\uFF08research \u8F68\u9053\u4E3A\u8C03\u7814\u7C7B\u578B\u4E13\u7528\u503C\uFF1BUI \u5FAE\u8C03\u4EC5\u9002\u7528 ui \u8F68\u9053\uFF09"
+  TASK_TYPE_TRACK_MISMATCH: "\u4EFB\u52A1\u7C7B\u578B\u4E0E\u8F68\u9053\u7EC4\u5408\u975E\u6CD5\uFF08research \u8F68\u9053\u4E3A\u8C03\u7814\u7C7B\u578B\u4E13\u7528\u503C\uFF1BUI \u5FAE\u8C03\u4EC5\u9002\u7528 ui \u8F68\u9053\uFF09",
+  // T202608290001：停用模板创建任务守卫（资产启停——停用对创建通道同样不可见）
+  TEMPLATE_DISABLED: "\u6A21\u677F\u5DF2\u505C\u7528\uFF0C\u7981\u6B62\u7528\u4E8E\u521B\u5EFA\u4EFB\u52A1\uFF08Web \u7BA1\u7406\u53F0\u53EF\u91CD\u65B0\u542F\u7528\uFF09"
 };
 var AppError = class extends Error {
 };
@@ -201,6 +211,11 @@ var ValidationError = class extends AppError {
 // src/store/repos/skill.repo.ts
 function createSkillRepo(db) {
   const base = createRepo(db.collection("skills"), { nameField: "name" });
+  const listQuery = (cond, opts) => ({
+    ...cond,
+    ...opts?.includeDisabled ? {} : enabledNeFalse(),
+    ...opts?.q ? { name: { $regex: escapeRegExpLiteral(opts.q), $options: "i" } } : {}
+  });
   return {
     ...base,
     async createSkill(data) {
@@ -218,26 +233,34 @@ function createSkillRepo(db) {
       return base.delete(skill.id);
     },
     async updateByNameScoped(name, scope, projectId, patch) {
-      const skill = await this.getByNameScoped(name, scope, projectId);
+      const skill = await this.getByNameScoped(name, scope, projectId, { includeDisabled: true });
       if (!skill || !skill.id) return null;
       return base.update(skill.id, patch);
     },
     async deleteByNameScoped(name, scope, projectId) {
-      const skill = await this.getByNameScoped(name, scope, projectId);
+      const skill = await this.getByNameScoped(name, scope, projectId, { includeDisabled: true });
       if (!skill || !skill.id) return false;
       return base.delete(skill.id);
     },
-    async getByNameScoped(name, scope, projectId) {
+    async getByNameScoped(name, scope, projectId, opts) {
       const doc = await base._collection.findOne(
-        scope === "project" ? { name, scope: "project", projectId } : { name, scope: "global" }
+        listQuery(
+          scope === "project" ? { name, scope: "project", projectId } : { name, scope: "global" },
+          opts
+        )
       );
       return doc ? toEntity(doc) : null;
     },
-    async listSkillsByScope(projectId) {
-      return base.list({ $or: [{ scope: "global" }, { scope: "project", projectId }] });
+    async listSkillsByScope(projectId, opts) {
+      return base.list(listQuery({ $or: [{ scope: "global" }, { scope: "project", projectId }] }, opts));
     },
-    async listSkillsByScopeFilter(scope, projectId) {
-      return base.list(scope === "project" ? { scope: "project", projectId } : { scope: "global" });
+    async listSkillsByScopeFilter(scope, projectId, opts) {
+      return base.list(
+        listQuery(scope === "project" ? { scope: "project", projectId } : { scope: "global" }, opts)
+      );
+    },
+    async listSkills(opts) {
+      return base.list(listQuery({}, opts));
     },
     async listSkillsByNames(names, scope, projectId) {
       if (names.length === 0) return /* @__PURE__ */ new Map();
@@ -261,7 +284,7 @@ function createSkillRepo(db) {
         throw new ConflictError("skill", `name already exists: ${newName}`);
       }
       await assertNameScopeAvailable(base._collection, newName, target.scope, target.projectId);
-      const { id: _sourceId, createdAt: _ca, updatedAt: _ua, projectId: _sourceProjectId, scope: _sourceScope, ...rest } = sourceEntity;
+      const { id: _sourceId, createdAt: _ca, updatedAt: _ua, projectId: _sourceProjectId, scope: _sourceScope, enabled: _sourceEnabled, ...rest } = sourceEntity;
       const copy = {
         ...JSON.parse(JSON.stringify(rest)),
         name: newName,
@@ -285,7 +308,31 @@ async function assertNameScopeAvailable(collection, name, scope, projectId) {
 
 // src/store/repos/agent.repo.ts
 function createAgentRepo(db) {
-  const base = createRepo(db.collection("agents"), { nameField: "name" });
+  const raw = createRepo(db.collection("agents"), { nameField: "name" });
+  const normalizeFunction = (agent) => ({ ...agent, "function": agent["function"] ?? "executor" });
+  const base = {
+    ...raw,
+    async list(filter = void 0) {
+      return (await raw.list(filter)).map(normalizeFunction);
+    },
+    async getById(id) {
+      const agent = await raw.getById(id);
+      return agent ? normalizeFunction(agent) : null;
+    },
+    async getByName(name) {
+      const agent = await raw.getByName(name);
+      return agent ? normalizeFunction(agent) : null;
+    },
+    async update(id, patch) {
+      const agent = await raw.update(id, patch);
+      return agent ? normalizeFunction(agent) : null;
+    }
+  };
+  const listQuery = (cond, opts) => ({
+    ...cond,
+    ...opts?.includeDisabled ? {} : enabledNeFalse(),
+    ...opts?.q ? { name: { $regex: escapeRegExpLiteral(opts.q), $options: "i" } } : {}
+  });
   return {
     ...base,
     async createAgent(data) {
@@ -303,26 +350,34 @@ function createAgentRepo(db) {
       return base.delete(agent.id);
     },
     async updateByNameScoped(name, scope, projectId, patch) {
-      const agent = await this.getByNameScoped(name, scope, projectId);
+      const agent = await this.getByNameScoped(name, scope, projectId, { includeDisabled: true });
       if (!agent || !agent.id) return null;
       return base.update(agent.id, patch);
     },
     async deleteByNameScoped(name, scope, projectId) {
-      const agent = await this.getByNameScoped(name, scope, projectId);
+      const agent = await this.getByNameScoped(name, scope, projectId, { includeDisabled: true });
       if (!agent || !agent.id) return false;
       return base.delete(agent.id);
     },
-    async getByNameScoped(name, scope, projectId) {
+    async getByNameScoped(name, scope, projectId, opts) {
       const doc = await base._collection.findOne(
-        scope === "project" ? { name, scope: "project", projectId } : { name, scope: "global" }
+        listQuery(
+          scope === "project" ? { name, scope: "project", projectId } : { name, scope: "global" },
+          opts
+        )
       );
-      return doc ? toEntity(doc) : null;
+      return doc ? normalizeFunction(toEntity(doc)) : null;
     },
-    async listAgentsByScope(projectId) {
-      return base.list({ $or: [{ scope: "global" }, { scope: "project", projectId }] });
+    async listAgentsByScope(projectId, opts) {
+      return base.list(listQuery({ $or: [{ scope: "global" }, { scope: "project", projectId }] }, opts));
     },
-    async listAgentsByScopeFilter(scope, projectId) {
-      return base.list(scope === "project" ? { scope: "project", projectId } : { scope: "global" });
+    async listAgentsByScopeFilter(scope, projectId, opts) {
+      return base.list(
+        listQuery(scope === "project" ? { scope: "project", projectId } : { scope: "global" }, opts)
+      );
+    },
+    async listAgents(opts) {
+      return base.list(listQuery({}, opts));
     },
     async copyAgent(sourceName, source, target, newName, skillRepo) {
       const src = await base._collection.findOne(
@@ -331,7 +386,7 @@ function createAgentRepo(db) {
       if (!src) {
         throw new ConflictError("agent", `copy source not found: ${sourceName}`);
       }
-      const sourceEntity = toEntity(src);
+      const sourceEntity = normalizeFunction(toEntity(src));
       const sameScopeDup = await base._collection.findOne(
         target.scope === "project" ? { name: newName, scope: "project", projectId: target.projectId } : { name: newName, scope: "global" },
         { projection: { _id: 1 } }
@@ -341,7 +396,7 @@ function createAgentRepo(db) {
       }
       await assertNameScopeAvailable2(base._collection, newName, target.scope, target.projectId);
       await assertBoundSkillsCompatible(skillRepo, target.scope, target.projectId, src.boundSkills ?? []);
-      const { id: _sourceId, createdAt: _ca, updatedAt: _ua, projectId: _sourceProjectId, scope: _sourceScope, ...rest } = sourceEntity;
+      const { id: _sourceId, createdAt: _ca, updatedAt: _ua, projectId: _sourceProjectId, scope: _sourceScope, enabled: _sourceEnabled, ...rest } = sourceEntity;
       const copy = {
         ...JSON.parse(JSON.stringify(rest)),
         name: newName,
@@ -392,6 +447,7 @@ function createDagTemplateRepo(db) {
       const query = {};
       if (filter?.projectId) query.projectId = filter.projectId;
       if (filter?.name) query.name = filter.name;
+      if (!filter?.includeDisabled) Object.assign(query, enabledNeFalse());
       return base.list(query);
     },
     async copyDagTemplate(sourceId, targetProjectId, newName) {
@@ -406,7 +462,7 @@ function createDagTemplateRepo(db) {
       if (dup) {
         throw new ConflictError("dagTemplate", `name conflict in target project: ${newName}`);
       }
-      const { id: _sourceId, createdAt: _ca, updatedAt: _ua, ...rest } = source;
+      const { id: _sourceId, createdAt: _ca, updatedAt: _ua, enabled: _sourceEnabled, ...rest } = source;
       const copy = {
         ...rest,
         name: newName,
@@ -420,11 +476,122 @@ function createDagTemplateRepo(db) {
 }
 
 // src/schemas/task.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 
 // src/schemas/skill.ts
+import { z as z2 } from "zod";
+
+// src/schemas/reference.ts
 import { z } from "zod";
-var SkillScopeSchema = z.enum(["global", "project"]);
+var REFERENCE_LIMITS = {
+  /** 单资产引用文档数量上限 */
+  maxCount: 20,
+  /** 单引用文档内容字符数上限 */
+  maxContentChars: 1e6,
+  /** 聚合护栏：主文档正文 + Σ引用文档内容的字符总量上限 */
+  maxTotalChars: 3e6
+};
+var SKILL_MAIN_DOC = "SKILL.md";
+var AGENT_MAIN_DOC = "agent.md";
+var ReferenceDocBaseSchema = z.object({
+  /** 相对资产根的相对路径（正斜杠分隔；禁止绝对路径 / .. 回溯 / 反斜杠 / 空段 / 主文档名冲突） */
+  path: z.string().min(1),
+  /** 文档全文（空文档合法） */
+  content: z.string().max(REFERENCE_LIMITS.maxContentChars)
+});
+function canonicalizeReferencePath(path) {
+  return path.split("/").filter((segment) => segment !== ".").join("/").toLowerCase();
+}
+function sumReferenceContentChars(references) {
+  return (references ?? []).reduce((total, doc) => total + doc.content.length, 0);
+}
+function createReferencesSchema(mainDocName) {
+  const elementSchema = ReferenceDocBaseSchema.superRefine((val, ctx) => {
+    const path = val.path;
+    let reason = null;
+    if (path.startsWith("/")) {
+      reason = "\u7981\u6B62\u7EDD\u5BF9\u8DEF\u5F84";
+    } else if (path.includes("\\")) {
+      reason = "\u7981\u6B62\u53CD\u659C\u6760\u8DEF\u5F84\u5206\u9694\u7B26\uFF08\u987B\u4F7F\u7528\u6B63\u659C\u6760 /\uFF09";
+    } else {
+      const rawSegments = path.split("/");
+      if (rawSegments.some((segment) => segment === "")) {
+        reason = "\u7981\u6B62\u7A7A\u8DEF\u5F84\u6BB5\uFF08\u8FDE\u7EED\u6216\u5C3E\u968F\u659C\u6760\uFF09";
+      } else if (rawSegments.includes("..")) {
+        reason = "\u7981\u6B62\u8D8A\u754C\u56DE\u6EAF\uFF08.. \u8DEF\u5F84\u6BB5\uFF09";
+      } else if (canonicalizeReferencePath(path).length === 0) {
+        reason = '\u8DEF\u5F84\u4E0D\u80FD\u53EA\u7531 "." \u7EC4\u6210';
+      } else if (canonicalizeReferencePath(path) === canonicalizeReferencePath(mainDocName)) {
+        reason = `\u4E0E\u4E3B\u6587\u6863\u6587\u4EF6\u540D ${mainDocName} \u51B2\u7A81`;
+      }
+    }
+    if (reason !== null) {
+      ctx.addIssue({ code: "custom", path: ["path"], message: `${reason}\uFF1A${path}` });
+    }
+  });
+  return z.array(elementSchema).max(REFERENCE_LIMITS.maxCount).superRefine((docs, ctx) => {
+    const seen = /* @__PURE__ */ new Map();
+    docs.forEach((doc, index) => {
+      const canonical = canonicalizeReferencePath(doc.path);
+      const firstIndex = seen.get(canonical);
+      if (firstIndex !== void 0) {
+        ctx.addIssue({
+          code: "custom",
+          path: [index],
+          message: `\u5F15\u7528\u6587\u6863\u8DEF\u5F84\u91CD\u590D\uFF08\u4E0E\u7B2C ${firstIndex + 1} \u6761\u89C4\u8303\u5316\u540E\u76F8\u540C\uFF09\uFF1A${doc.path}`
+        });
+        return;
+      }
+      seen.set(canonical, index);
+    });
+    const entries = docs.map((doc, index) => ({ canonical: canonicalizeReferencePath(doc.path), index }));
+    for (const a of entries) {
+      for (const b of entries) {
+        if (a.index >= b.index) continue;
+        if (isDirectoryPrefix(a.canonical, b.canonical) || isDirectoryPrefix(b.canonical, a.canonical)) {
+          ctx.addIssue({
+            code: "custom",
+            path: [b.index],
+            message: `\u5F15\u7528\u6587\u6863\u8DEF\u5F84\u4E92\u4E3A\u76EE\u5F55\u524D\u7F00\uFF08\u843D\u76D8\u65F6\u6587\u4EF6\u4E0E\u76EE\u5F55\u51B2\u7A81\uFF09\uFF1A${docs[a.index]?.path ?? "?"} \u4E0E ${docs[b.index]?.path ?? "?"}`
+          });
+        }
+      }
+    }
+  });
+}
+function isDirectoryPrefix(prefixCanonical, candidateCanonical) {
+  if (prefixCanonical.length >= candidateCanonical.length) return false;
+  if (!candidateCanonical.startsWith(prefixCanonical)) return false;
+  return candidateCanonical.charAt(prefixCanonical.length) === "/";
+}
+function assertReferencesDeletable(params) {
+  const { resource, name, existingReferences, nextReferences, nextMainBody, currentMainBody } = params;
+  if (nextReferences === void 0) return;
+  const nextPaths = new Set(nextReferences.map((doc) => doc.path));
+  const deletedPaths = (existingReferences ?? []).map((doc) => doc.path).filter((path) => !nextPaths.has(path));
+  if (deletedPaths.length === 0) return;
+  const mainBody = nextMainBody ?? currentMainBody;
+  const violating = deletedPaths.filter((path) => mainBody.includes(path));
+  if (violating.length === 0) return;
+  throw new ConflictError(resource, name, {
+    bizCode: "REFERENCE_IN_USE",
+    message: `${BIZ_CODE_MESSAGES.REFERENCE_IN_USE}\uFF08${resource} ${name}\uFF09\uFF1A${violating.join("\u3001")}`
+  });
+}
+function assertReferenceAggregateLimit(params) {
+  const { effectiveMainBody, nextReferences } = params;
+  if (nextReferences === void 0) return;
+  const totalChars = effectiveMainBody.length + sumReferenceContentChars(nextReferences);
+  if (totalChars > REFERENCE_LIMITS.maxTotalChars) {
+    throw new ValidationError(
+      `\u4E3B\u6587\u6863\u4E0E\u5F15\u7528\u6587\u6863\u5185\u5BB9\u603B\u91CF ${String(totalChars)} \u5B57\u7B26\u8D85\u51FA\u805A\u5408\u4E0A\u9650 ${String(REFERENCE_LIMITS.maxTotalChars)}\uFF08\u542B\u5E93\u5185\u73B0\u6709\u4E3B\u6587\u6863\u6B63\u6587\u5408\u5E76\u8BA1\u7B97\uFF09`,
+      [{ path: ["references"], message: `\u603B\u91CF ${String(totalChars)} \u8D85\u51FA\u4E0A\u9650 ${String(REFERENCE_LIMITS.maxTotalChars)}` }]
+    );
+  }
+}
+
+// src/schemas/skill.ts
+var SkillScopeSchema = z2.enum(["global", "project"]);
 var OBJECT_ID_HEX = /^[a-f0-9]{24}$/;
 var SkillScopeRefine = (val, ctx) => {
   if (val.scope === "project" && !val.projectId) {
@@ -435,38 +602,59 @@ var SkillScopeRefine = (val, ctx) => {
     });
   }
 };
-var SkillShapeSchema = z.object({
-  id: z.string().optional(),
-  name: z.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "kebab-case only"),
-  description: z.string(),
-  content: z.string(),
-  category: z.string(),
-  version: z.string().default("1.0.0"),
+var SkillShapeSchema = z2.object({
+  id: z2.string().optional(),
+  name: z2.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "kebab-case only"),
+  description: z2.string(),
+  content: z2.string(),
+  category: z2.string(),
+  version: z2.string().default("1.0.0"),
+  /** 引用文档集合（可选——存量单文件资产无此字段，行为与升级前一致） */
+  references: createReferencesSchema(SKILL_MAIN_DOC).optional(),
   /** 作用域：global=跨项目复用（默认，仅作存量迁移读侧兜底）/ project=项目专用（N012 D3） */
   scope: SkillScopeSchema.default("global"),
   /** 仅 scope=project 时必填且为合法 ObjectId hex（superRefine 保证） */
-  projectId: z.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
-  createdAt: z.date().optional(),
-  updatedAt: z.date().optional()
+  projectId: z2.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
+  /**
+   * T202608290001 资产启停（可选——存量无此字段 = 启用，零迁移）。
+   * 全局判断规则：enabled === false 即停用，true/缺失均启用。
+   * 唯一写入口是专用启停端点（POST /:name/enabled）——Create/Update/Copy 均不含此字段
+   * （规避 Zod4 .partial() default 注入 + 启停不触发版本提升）。
+   */
+  enabled: z2.boolean().optional(),
+  createdAt: z2.date().optional(),
+  updatedAt: z2.date().optional()
 });
-var SkillSchema = SkillShapeSchema.superRefine(SkillScopeRefine);
+var skillAggregateLimitRefine = (val, ctx) => {
+  const totalChars = (val.content?.length ?? 0) + sumReferenceContentChars(val.references);
+  if (totalChars > REFERENCE_LIMITS.maxTotalChars) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["references"],
+      message: `\u4E3B\u6587\u6863\u4E0E\u5F15\u7528\u6587\u6863\u5185\u5BB9\u603B\u91CF ${totalChars} \u5B57\u7B26\u8D85\u51FA\u805A\u5408\u4E0A\u9650 ${REFERENCE_LIMITS.maxTotalChars}`
+    });
+  }
+};
+var SkillSchema = SkillShapeSchema.superRefine(SkillScopeRefine).superRefine(skillAggregateLimitRefine);
 var SkillCreateSchema = SkillShapeSchema.omit({
   id: true,
   createdAt: true,
-  updatedAt: true
-}).extend({ scope: SkillScopeSchema }).superRefine(SkillScopeRefine);
+  updatedAt: true,
+  enabled: true
+}).extend({ scope: SkillScopeSchema }).superRefine(SkillScopeRefine).superRefine(skillAggregateLimitRefine);
 var SkillUpdateSchema = SkillShapeSchema.omit({
   id: true,
   createdAt: true,
-  updatedAt: true
+  updatedAt: true,
+  enabled: true
 }).extend({
-  version: z.string().optional(),
+  version: z2.string().optional(),
   scope: SkillScopeSchema.optional()
-}).partial().superRefine(SkillScopeRefine);
-var SkillCopySchema = z.object({
-  newName: z.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "kebab-case only"),
+}).partial().superRefine(SkillScopeRefine).superRefine(skillAggregateLimitRefine);
+var SkillCopySchema = z2.object({
+  newName: z2.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "kebab-case only"),
   newScope: SkillScopeSchema,
-  targetProjectId: z.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
+  targetProjectId: z2.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
 }).superRefine((val, ctx) => {
   if (val.newScope === "project" && !val.targetProjectId) {
     ctx.addIssue({
@@ -478,26 +666,26 @@ var SkillCopySchema = z.object({
 });
 
 // src/schemas/dag-template.ts
-import { z as z2 } from "zod";
-var DagNodePhaseSchema = z2.string();
-var DagNodeTrackSchema = z2.string();
+import { z as z3 } from "zod";
+var DagNodePhaseSchema = z3.string();
+var DagNodeTrackSchema = z3.string();
 var DAG_PHASES = ["entry", "track", "test", "exit"];
 var DAG_TRACKS = ["backend", "ui", "all"];
 var NODE_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
-var DagNodeSchema = z2.object({
-  id: z2.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: z2.string(),
+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(),
   phase: DagNodePhaseSchema,
   track: DagNodeTrackSchema,
-  prompt: z2.string(),
-  skills: z2.array(z2.string()).default([])
+  prompt: z3.string(),
+  skills: z3.array(z3.string()).default([])
 });
-var PausePointTypeSchema = z2.enum(["human_approval", "checkpoint"]);
+var PausePointTypeSchema = z3.enum(["human_approval", "checkpoint"]);
 var PAUSE_POINT_TYPES = ["human_approval", "checkpoint"];
-var EdgePausePointBaseSchema = z2.object({
+var EdgePausePointBaseSchema = z3.object({
   type: PausePointTypeSchema,
-  description: z2.string(),
-  autoResume: z2.boolean().default(false)
+  description: z3.string(),
+  autoResume: z3.boolean().default(false)
 });
 var EdgePausePointSchema = EdgePausePointBaseSchema.superRefine((pp, ctx) => {
   if (pp.type === "human_approval" && pp.autoResume) {
@@ -513,152 +701,160 @@ var EdgePausePointSchema = EdgePausePointBaseSchema.superRefine((pp, ctx) => {
     });
   }
 });
-var DagEdgeSchema = z2.object({
-  from: z2.string(),
-  to: z2.string(),
-  condition: z2.string().optional(),
+var DagEdgeSchema = z3.object({
+  from: z3.string(),
+  to: z3.string(),
+  condition: z3.string().optional(),
   /** N017 D1：边暂停点（可选）。human_approval=人工审批门（advance 落 paused 等 approve）；checkpoint=检查点（仅记录直接流转） */
   pausePoint: EdgePausePointSchema.optional()
 });
-var DagTemplateSchema = z2.object({
-  id: z2.string().optional(),
-  name: z2.string(),
+var DagTemplateSchema = z3.object({
+  id: z3.string().optional(),
+  name: z3.string(),
   /** 归属项目 id（N012：实体层去哨兵 default，由路由层解析写入——校验项目存在且 active 后落库） */
-  projectId: z2.string(),
-  description: z2.string(),
-  nodes: z2.array(DagNodeSchema),
-  edges: z2.array(DagEdgeSchema),
+  projectId: z3.string(),
+  description: z3.string(),
+  nodes: z3.array(DagNodeSchema),
+  edges: z3.array(DagEdgeSchema),
   /** UI 布局坐标（nodeId → {x,y}）。UI 关注点，advance 引擎零感知；旧模板无此字段 → 前端 dagre 兜底布局（N008 D2） */
-  layout: z2.record(z2.string(), z2.object({ x: z2.number(), y: z2.number() })).optional(),
-  isDefault: z2.boolean().default(false),
-  version: z2.string().default("1.0.0"),
-  createdAt: z2.date().optional(),
-  updatedAt: z2.date().optional()
+  layout: z3.record(z3.string(), z3.object({ x: z3.number(), y: z3.number() })).optional(),
+  isDefault: z3.boolean().default(false),
+  version: z3.string().default("1.0.0"),
+  /**
+   * T202608290001 资产启停（可选——存量无此字段 = 启用，零迁移）。
+   * 全局判断规则：enabled === false 即停用，true/缺失均启用。
+   * 唯一写入口是专用启停端点（POST /:id/enabled）——Create/Update/Copy 均不含此字段；
+   * 停用模板对 CLI/MCP 列举与任务创建入口不可见（Web 管理台始终可见可重启）。
+   */
+  enabled: z3.boolean().optional(),
+  createdAt: z3.date().optional(),
+  updatedAt: z3.date().optional()
 });
 var DagTemplateCreateSchema = DagTemplateSchema.omit({
   id: true,
   createdAt: true,
-  updatedAt: true
+  updatedAt: true,
+  enabled: true
 });
 var DagTemplateUpdateSchema = DagTemplateCreateSchema.extend({
-  isDefault: z2.boolean().optional(),
-  version: z2.string().optional()
+  isDefault: z3.boolean().optional(),
+  version: z3.string().optional()
 }).partial();
-var DagTemplateCopySchema = z2.object({
-  newName: z2.string().min(1),
-  targetProjectId: z2.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex")
+var DagTemplateCopySchema = z3.object({
+  newName: z3.string().min(1),
+  targetProjectId: z3.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex")
 });
 
 // src/schemas/task.ts
 var TASK_TYPES = ["feature", "bugfix", "ui-tweak", "research"];
 var ENTRY_ID_REGEX = /^[a-z0-9]{6}$/;
-var CheckItemSchema = z3.object({
-  id: z3.string().regex(ENTRY_ID_REGEX),
-  item: z3.string().min(1),
-  passed: z3.boolean()
+var CheckItemSchema = z4.object({
+  id: z4.string().regex(ENTRY_ID_REGEX),
+  item: z4.string().min(1),
+  passed: z4.boolean()
 });
 var ARTIFACT_TYPES = ["prd", "tech", "code", "test", "doc", "other"];
-var ArtifactSchema = z3.object({
-  id: z3.string().regex(ENTRY_ID_REGEX),
-  type: z3.enum(ARTIFACT_TYPES),
-  path: z3.string().min(1),
-  note: z3.string().optional(),
-  content: z3.string().max(2e5).optional()
+var ArtifactSchema = z4.object({
+  id: z4.string().regex(ENTRY_ID_REGEX),
+  type: z4.enum(ARTIFACT_TYPES),
+  path: z4.string().min(1),
+  note: z4.string().optional(),
+  content: z4.string().max(2e5).optional()
 });
-var ConfirmationSchema = z3.object({
-  id: z3.string().regex(ENTRY_ID_REGEX),
-  quote: z3.string().min(1).max(2e3),
-  at: z3.date()
+var ConfirmationSchema = z4.object({
+  id: z4.string().regex(ENTRY_ID_REGEX),
+  quote: z4.string().min(1).max(2e3),
+  at: z4.date()
 });
-var DecisionSchema = z3.object({
-  id: z3.string().regex(ENTRY_ID_REGEX),
-  topic: z3.string().min(1),
-  decision: z3.string().min(1)
+var DecisionSchema = z4.object({
+  id: z4.string().regex(ENTRY_ID_REGEX),
+  topic: z4.string().min(1),
+  decision: z4.string().min(1)
 });
-var ReviewSummarySchema = z3.object({
-  verdict: z3.enum(["pass", "fail"]),
-  rounds: z3.number().int().min(1),
-  critical: z3.number().int().min(0)
+var ReviewSummarySchema = z4.object({
+  verdict: z4.enum(["pass", "fail"]),
+  rounds: z4.number().int().min(1),
+  critical: z4.number().int().min(0)
 });
-var NodeRecordSchema = z3.object({
-  summary: z3.string().optional(),
-  checks: z3.array(CheckItemSchema).default([]),
-  artifacts: z3.array(ArtifactSchema).default([]),
-  confirmations: z3.array(ConfirmationSchema).default([]),
-  decisions: z3.array(DecisionSchema).default([]),
+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()
 });
-var TaskDocContentSchema = z3.object({
-  what: z3.string().min(1),
-  why: z3.string().min(1),
-  acceptance: z3.array(z3.string()).default([]),
-  nonGoals: z3.array(z3.string()).default([]),
-  trackNote: z3.string().optional()
+var TaskDocContentSchema = z4.object({
+  what: z4.string().min(1),
+  why: z4.string().min(1),
+  acceptance: z4.array(z4.string()).default([]),
+  nonGoals: z4.array(z4.string()).default([]),
+  trackNote: z4.string().optional()
 });
-var ArchNoteSchema = z3.object({
-  id: z3.string().regex(ENTRY_ID_REGEX),
-  text: z3.string().min(1).max(2e3),
-  at: z3.date()
+var ArchNoteSchema = z4.object({
+  id: z4.string().regex(ENTRY_ID_REGEX),
+  text: z4.string().min(1).max(2e3),
+  at: z4.date()
 });
-var NodeStatusSchema = z3.string();
+var NodeStatusSchema = z4.string();
 var NODE_STATUSES = ["pending", "active", "completed", "skipped"];
-var NodeStateSchema = z3.object({
+var NodeStateSchema = z4.object({
   status: NodeStatusSchema,
-  enteredAt: z3.date().nullable().default(null),
-  completedAt: z3.date().nullable().default(null)
+  enteredAt: z4.date().nullable().default(null),
+  completedAt: z4.date().nullable().default(null)
 });
-var DagInstanceSchema = z3.object({
-  templateId: z3.string(),
-  templateVersion: z3.string(),
-  nodes: z3.array(z3.object({
-    id: z3.string(),
-    label: z3.string(),
+var DagInstanceSchema = z4.object({
+  templateId: z4.string(),
+  templateVersion: z4.string(),
+  nodes: z4.array(z4.object({
+    id: z4.string(),
+    label: z4.string(),
     // N016 F9：枚举放宽（注册表权威）
-    phase: z3.string(),
-    track: z3.string(),
-    prompt: z3.string(),
-    skills: z3.array(z3.string()).default([])
+    phase: z4.string(),
+    track: z4.string(),
+    prompt: z4.string(),
+    skills: z4.array(z4.string()).default([])
   })),
   // N017 D1：暂停点内联到边（human_approval=审批门 / checkpoint=检查点），顶层数组删除
-  edges: z3.array(z3.object({
-    from: z3.string(),
-    to: z3.string(),
-    condition: z3.string().optional(),
+  edges: z4.array(z4.object({
+    from: z4.string(),
+    to: z4.string(),
+    condition: z4.string().optional(),
     pausePoint: EdgePausePointBaseSchema.optional()
   })),
-  prunedNodes: z3.array(z3.string()),
-  nodeStates: z3.record(z3.string(), NodeStateSchema)
+  prunedNodes: z4.array(z4.string()),
+  nodeStates: z4.record(z4.string(), NodeStateSchema)
 });
-var HistoryActionSchema = z3.enum(["entered", "advanced", "paused", "resumed", "approved", "rejected", "completed", "cancelled"]);
-var HistoryEntrySchema = z3.object({
-  nodeId: z3.string(),
+var HistoryActionSchema = z4.enum(["entered", "advanced", "paused", "resumed", "approved", "rejected", "completed", "cancelled"]);
+var HistoryEntrySchema = z4.object({
+  nodeId: z4.string(),
   action: HistoryActionSchema,
-  timestamp: z3.date().default(() => /* @__PURE__ */ new Date()),
-  details: z3.record(z3.string(), z3.unknown()).default({})
+  timestamp: z4.date().default(() => /* @__PURE__ */ new Date()),
+  details: z4.record(z4.string(), z4.unknown()).default({})
 });
-var TaskStatusSchema = z3.string();
-var TaskPhaseSchema = z3.string();
+var TaskStatusSchema = z4.string();
+var TaskPhaseSchema = z4.string();
 var TASK_STATUSES = ["active", "paused", "completed", "cancelled"];
 var TASK_PHASES = ["entry", "track", "test", "exit"];
-var TaskSchema = z3.object({
-  id: z3.string().optional(),
-  taskId: z3.string(),
-  title: z3.string(),
+var TaskSchema = z4.object({
+  id: z4.string().optional(),
+  taskId: z4.string(),
+  title: z4.string(),
   /**
    * 任务类型标签（T202608240003）：创建时确定、此后不可变（PATCH 白名单不含 type）。
    * 入参与落库同源 enum——持久层防脏值，模板 PRD 调研变体判定依赖精确值。
    */
-  type: z3.enum(TASK_TYPES).optional(),
+  type: z4.enum(TASK_TYPES).optional(),
   /** 归属项目 id（N012：实体层去哨兵 default，由 repo 显式写入——路由层解析：显式携带校验一致性 / 缺省继承模板 projectId） */
-  projectId: z3.string(),
-  dagTemplateId: z3.string(),
+  projectId: z4.string(),
+  dagTemplateId: z4.string(),
   dagInstance: DagInstanceSchema,
-  currentNode: z3.string(),
+  currentNode: z4.string(),
   currentPhase: TaskPhaseSchema,
   status: TaskStatusSchema,
   /** 暂停位置：from 节点 id（暂停点暂停，approve 经 findNextEdge 重推导边）/ null（手动暂停） */
-  pausedAt: z3.string().nullable().default(null),
-  track: z3.string(),
+  pausedAt: z4.string().nullable().default(null),
+  track: z4.string(),
   /**
    * N020 D1：任务级结构化文档（未写时字段缺省——语义即「未写」，不做 null 占位）。
    * 写入口：PATCH /api/tasks/:id/doc（字段级 $set + acceptance/nonGoals 条目 $push）。
@@ -669,27 +865,27 @@ var TaskSchema = z3.object({
    * MongoDB 自动创建中间对象，故单条目字段可能先于容器整体存在——读侧对
    * record 内数组字段按 `?? []` 容错（toEntity 不跑 parse 补 default）。
    */
-  nodeRecords: z3.record(z3.string(), NodeRecordSchema).default({}),
+  nodeRecords: z4.record(z4.string(), NodeRecordSchema).default({}),
   /** N020 D1：跨节点累积素材（架构信息收集条目，服务端生成 id/at） */
-  archNotes: z3.array(ArchNoteSchema).default([]),
-  history: z3.array(HistoryEntrySchema).default([]),
-  createdAt: z3.date().optional(),
-  updatedAt: z3.date().optional()
+  archNotes: z4.array(ArchNoteSchema).default([]),
+  history: z4.array(HistoryEntrySchema).default([]),
+  createdAt: z4.date().optional(),
+  updatedAt: z4.date().optional()
 });
-var TaskCreateInputSchema = z3.object({
-  title: z3.string(),
-  track: z3.string(),
-  dagTemplateId: z3.string(),
+var TaskCreateInputSchema = z4.object({
+  title: z4.string(),
+  track: z4.string(),
+  dagTemplateId: z4.string(),
   /**
    * T202608240003 创建时剪枝：显式剔除的节点 id（在轨道自动剔除之外）。
    * 清单来源约束 = task-create skill 的类型×轨道映射矩阵（skip 只允许来自映射，禁止自由发挥）；
    * 剪枝算法与图校验见 core/task/prune.ts。
    */
-  skipNodes: z3.array(z3.string().regex(NODE_ID_PATTERN, "skipNodes \u6761\u76EE\u987B\u4E3A\u5408\u6CD5\u8282\u70B9 id")).optional(),
+  skipNodes: z4.array(z4.string().regex(NODE_ID_PATTERN, "skipNodes \u6761\u76EE\u987B\u4E3A\u5408\u6CD5\u8282\u70B9 id")).optional(),
   /** 任务类型标签（见 TASK_TYPES；与 track 的合法组合由 server 入口校验） */
-  type: z3.enum(TASK_TYPES).optional(),
+  type: z4.enum(TASK_TYPES).optional(),
   /** 归属项目：可选（缺省 → 继承模板 projectId，D2；显式携带且 ≠ 模板 → 409 TEMPLATE_PROJECT_MISMATCH） */
-  projectId: z3.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
+  projectId: z4.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
 });
 
 // src/task/track-match.ts
@@ -948,6 +1144,26 @@ async function resumeTask(deps, taskId, decision) {
     expectedCurrentNode: task.currentNode
   });
 }
+async function cancelTask(deps, taskId, reason) {
+  const task = await deps.getTask(taskId);
+  if (!task) throw new NotFoundError("task", taskId);
+  if (task.status !== "active" && task.status !== "paused") {
+    throw new BadRequestError(
+      `Cannot cancel: task status is '${task.status}' (terminal). Only active/paused tasks can be cancelled.`,
+      void 0,
+      { bizCode: "TASK_TERMINATED", message: `\u4EFB\u52A1\u5DF2\u5B8C\u7ED3\uFF08completed/cancelled\uFF09\uFF0C\u7981\u6B62\u53D6\u6D88\uFF08\u5F53\u524D status: ${task.status}\uFF09` }
+    );
+  }
+  const patch = {
+    status: "cancelled",
+    pausedAt: null,
+    history: [...task.history, mkHistory(task.currentNode, "cancelled", reason ? { reason } : {})]
+  };
+  return deps.updateTask(taskId, patch, {
+    expectedStatus: task.status,
+    expectedCurrentNode: task.currentNode
+  });
+}
 function findNextEdge(edges, nodes, fromNodeId, track) {
   const outEdges = edges.filter((e) => e.from === fromNodeId);
   const matchSet = trackMatchSet(track);
@@ -1172,6 +1388,7 @@ function createTaskRepo(db) {
       if (filter?.status) match.status = filter.status;
       if (filter?.track) match.track = filter.track;
       if (filter?.projectId) match.projectId = filter.projectId;
+      if (filter?.q) match.title = { $regex: escapeRegExpLiteral(filter.q), $options: "i" };
       const page = filter?.page ?? 1;
       const limit = filter?.limit ?? 20;
       const skip = (page - 1) * limit;
@@ -1535,7 +1752,10 @@ 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 }) },
-  scope: void 0
+  scope: void 0,
+  // T202608260002：agent 功能类型被 agents.function 引用（reviewer/executor 为 builtin 禁删；
+  // 检测映射为未来非 builtin 扩值留防线）
+  agent_function: { collection: "agents", query: (v) => ({ "function": v }) }
 };
 function createEnumRegistryRepo(db) {
   const base = createRepo(db.collection("enum_registry"), { nameField: "category" });
@@ -1637,21 +1857,21 @@ function createEnumRegistryRepo(db) {
 }
 
 // src/schemas/agent.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // src/schemas/model-alias.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 var SIMING_CODE_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
-var ModelAliasShapeSchema = z4.object({
-  id: z4.string().optional(),
+var ModelAliasShapeSchema = z5.object({
+  id: z5.string().optional(),
   /** siming code：创建后不可变（PUT 显式拒绝 MODEL_CODE_IMMUTABLE，非静默剥离） */
-  code: z4.string().regex(SIMING_CODE_REGEX, "code \u5FC5\u987B\u4E3A kebab-case\uFF08\u5982 primary\u3001fast-model\uFF09"),
+  code: z5.string().regex(SIMING_CODE_REGEX, "code \u5FC5\u987B\u4E3A kebab-case\uFF08\u5982 primary\u3001fast-model\uFF09"),
   /** 展示名（如「主力模型」） */
-  name: z4.string().min(1, "\u5C55\u793A\u540D\u4E0D\u80FD\u4E3A\u7A7A"),
+  name: z5.string().min(1, "\u5C55\u793A\u540D\u4E0D\u80FD\u4E3A\u7A7A"),
   /** 真实模型标识（如 zhipuai/glm-5.3；改此处 = 引用方全局替换生效） */
-  realModel: z4.string().min(1, "\u771F\u5B9E\u6A21\u578B\u6807\u8BC6\u4E0D\u80FD\u4E3A\u7A7A"),
-  createdAt: z4.date().optional(),
-  updatedAt: z4.date().optional()
+  realModel: z5.string().min(1, "\u771F\u5B9E\u6A21\u578B\u6807\u8BC6\u4E0D\u80FD\u4E3A\u7A7A"),
+  createdAt: z5.date().optional(),
+  updatedAt: z5.date().optional()
 });
 var ModelAliasSchema = ModelAliasShapeSchema;
 var ModelAliasCreateSchema = ModelAliasShapeSchema.omit({
@@ -1659,17 +1879,18 @@ var ModelAliasCreateSchema = ModelAliasShapeSchema.omit({
   createdAt: true,
   updatedAt: true
 });
-var ModelAliasUpdateSchema = z4.object({
-  code: z4.string().regex(SIMING_CODE_REGEX).optional(),
-  name: z4.string().min(1).optional(),
-  realModel: z4.string().min(1).optional()
+var ModelAliasUpdateSchema = z5.object({
+  code: z5.string().regex(SIMING_CODE_REGEX).optional(),
+  name: z5.string().min(1).optional(),
+  realModel: z5.string().min(1).optional()
 });
 var ModelAliasWithRefCountSchema = ModelAliasShapeSchema.extend({
-  refCount: z4.number().int().min(0)
+  refCount: z5.number().int().min(0)
 });
 
 // src/schemas/agent.ts
-var AgentScopeSchema = z5.enum(["global", "project"]);
+var AgentScopeSchema = z6.enum(["global", "project"]);
+var AgentFunctionSchema = z6.enum(["reviewer", "executor"]);
 var AgentScopeRefine = (val, ctx) => {
   if (val.scope === "project" && !val.projectId) {
     ctx.addIssue({
@@ -1679,48 +1900,72 @@ var AgentScopeRefine = (val, ctx) => {
     });
   }
 };
-var AgentShapeSchema = z5.object({
-  id: z5.string().optional(),
-  name: z5.string(),
-  description: z5.string(),
-  systemPrompt: z5.string(),
-  boundSkills: z5.array(z5.string()).default([]),
-  model: z5.string(),
+var AgentShapeSchema = z6.object({
+  id: z6.string().optional(),
+  name: z6.string(),
+  description: z6.string(),
+  systemPrompt: z6.string(),
+  boundSkills: z6.array(z6.string()).default([]),
+  model: z6.string(),
   /** 资产版本（N015 F13）：install/export 版本对比依据；default 仅读侧兜底（createRepo 不做读侧解析，存量回填走 M6 迁移） */
-  version: z5.string().default("1.0.0"),
-  tools: z5.array(z5.string()).default([]),
-  permissions: z5.array(z5.string()).default([]),
+  version: z6.string().default("1.0.0"),
+  tools: z6.array(z6.string()).default([]),
+  permissions: z6.array(z6.string()).default([]),
+  /** 引用文档集合（可选——存量单文件资产无此字段，行为与升级前一致） */
+  references: createReferencesSchema(AGENT_MAIN_DOC).optional(),
   /** 作用域：global=跨项目复用（默认，仅作存量迁移读侧兜底）/ project=项目专用（N012 D3） */
   scope: AgentScopeSchema.default("global"),
+  /** 功能类型（T202608260002）：default 仅创建侧归一——toEntity 直转不经 Zod parse，读侧归一在 repo 层 + 回填走 M12 */
+  "function": AgentFunctionSchema.default("executor"),
   /** 仅 scope=project 时必填且为合法 ObjectId hex（superRefine 保证） */
-  projectId: z5.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
-  createdAt: z5.date().optional(),
-  updatedAt: z5.date().optional()
+  projectId: z6.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional(),
+  /**
+   * T202608290001 资产启停（可选——存量无此字段 = 启用，零迁移）。
+   * 全局判断规则：enabled === false 即停用，true/缺失均启用。
+   * 唯一写入口是专用启停端点（POST /:name/enabled）——Create/Update/Copy 均不含此字段。
+   */
+  enabled: z6.boolean().optional(),
+  createdAt: z6.date().optional(),
+  updatedAt: z6.date().optional()
 });
-var AgentSchema = AgentShapeSchema.superRefine(AgentScopeRefine);
+var agentAggregateLimitRefine = (val, ctx) => {
+  const totalChars = (val.systemPrompt?.length ?? 0) + sumReferenceContentChars(val.references);
+  if (totalChars > REFERENCE_LIMITS.maxTotalChars) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["references"],
+      message: `\u4E3B\u6587\u6863\u4E0E\u5F15\u7528\u6587\u6863\u5185\u5BB9\u603B\u91CF ${totalChars} \u5B57\u7B26\u8D85\u51FA\u805A\u5408\u4E0A\u9650 ${REFERENCE_LIMITS.maxTotalChars}`
+    });
+  }
+};
+var AgentSchema = AgentShapeSchema.superRefine(AgentScopeRefine).superRefine(agentAggregateLimitRefine);
 var AgentCreateSchema = AgentShapeSchema.omit({
   id: true,
   createdAt: true,
-  updatedAt: true
-}).extend({ scope: AgentScopeSchema }).extend({ model: z5.string().regex(SIMING_CODE_REGEX, "model \u5FC5\u987B\u662F siming code\uFF08kebab-case\uFF09") }).superRefine(AgentScopeRefine);
+  updatedAt: true,
+  enabled: true
+}).extend({ scope: AgentScopeSchema }).extend({ model: z6.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
+  updatedAt: true,
+  enabled: true
 }).extend({
-  boundSkills: z5.array(z5.string()).optional(),
+  boundSkills: z6.array(z6.string()).optional(),
   // N015：version 放行（export apply 版本递增随 PUT 携带）；optional 剥离实体层 default 避免 partial 空 body 注入
-  version: z5.string().optional(),
-  tools: z5.array(z5.string()).optional(),
-  permissions: z5.array(z5.string()).optional(),
+  version: z6.string().optional(),
+  tools: z6.array(z6.string()).optional(),
+  permissions: z6.array(z6.string()).optional(),
   scope: AgentScopeSchema.optional(),
   // N013：model 收紧为 siming code 格式（存在性校验在 handler 层；undefined = 不更新该字段）
-  model: z5.string().regex(SIMING_CODE_REGEX, "model \u5FC5\u987B\u662F siming code\uFF08kebab-case\uFF09").optional()
-}).partial().superRefine(AgentScopeRefine);
-var AgentCopySchema = z5.object({
-  newName: z5.string(),
+  model: z6.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 = z6.object({
+  newName: z6.string(),
   newScope: AgentScopeSchema,
-  targetProjectId: z5.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
+  targetProjectId: z6.string().regex(OBJECT_ID_HEX, "projectId must be a valid ObjectId hex").optional()
 }).superRefine((val, ctx) => {
   if (val.newScope === "project" && !val.targetProjectId) {
     ctx.addIssue({
@@ -1731,219 +1976,415 @@ var AgentCopySchema = z5.object({
   }
 });
 
+// src/schemas/export-bundle.ts
+import { z as z7 } from "zod";
+var EXPORT_FORMAT_VERSION = "1.0";
+var TemplatePayloadSchema = DagTemplateSchema.omit({
+  id: true,
+  projectId: true,
+  enabled: true,
+  createdAt: true,
+  updatedAt: true
+}).extend({
+  version: z7.string(),
+  isDefault: z7.boolean()
+});
+var SkillPayloadSchema = SkillShapeSchema.omit({
+  id: true,
+  projectId: true,
+  enabled: true,
+  createdAt: true,
+  updatedAt: true
+}).extend({
+  version: z7.string(),
+  scope: SkillScopeSchema,
+  references: createReferencesSchema(SKILL_MAIN_DOC)
+});
+var AgentPayloadSchema = AgentShapeSchema.omit({
+  id: true,
+  projectId: true,
+  enabled: true,
+  createdAt: true,
+  updatedAt: true
+}).extend({
+  version: z7.string(),
+  scope: AgentScopeSchema,
+  references: createReferencesSchema(AGENT_MAIN_DOC),
+  boundSkills: z7.array(z7.string()),
+  tools: z7.array(z7.string()),
+  permissions: z7.array(z7.string()),
+  "function": AgentFunctionSchema
+});
+var ModelAliasPayloadSchema = ModelAliasSchema.omit({
+  id: true,
+  createdAt: true,
+  updatedAt: true
+});
+var ExportBundleSchema = z7.object({
+  exportFormatVersion: z7.literal(EXPORT_FORMAT_VERSION, {
+    error: `\u5BFC\u51FA\u683C\u5F0F\u7248\u672C\u4E0D\u652F\u6301\uFF0C\u5F53\u524D\u652F\u6301 ${EXPORT_FORMAT_VERSION}`
+  }),
+  exportedAt: z7.string(),
+  /** 源环境悬空提示（§2.2：悬空 skill/agent.model 不阻断导出）。导出响应恒携带；导入入参可缺省——导入侧提示由 plan 生成，不消费本字段 */
+  warnings: z7.array(z7.string()).optional(),
+  template: TemplatePayloadSchema,
+  dependencies: z7.object({
+    skills: z7.array(SkillPayloadSchema),
+    agents: z7.array(AgentPayloadSchema),
+    modelAliases: z7.array(ModelAliasPayloadSchema)
+  })
+});
+var ImportPlanRequestSchema = z7.object({
+  targetProjectId: z7.string().regex(OBJECT_ID_HEX, "targetProjectId must be a valid ObjectId hex"),
+  bundle: ExportBundleSchema
+});
+var ImportDecisionSchema = z7.discriminatedUnion("kind", [
+  z7.object({
+    kind: z7.literal("skill"),
+    name: z7.string(),
+    scope: SkillScopeSchema,
+    action: z7.enum(["overwrite", "skip"])
+  }),
+  z7.object({
+    kind: z7.literal("agent"),
+    name: z7.string(),
+    scope: AgentScopeSchema,
+    action: z7.enum(["overwrite", "skip"])
+  }),
+  z7.object({
+    kind: z7.literal("modelAlias"),
+    name: z7.string(),
+    action: z7.enum(["overwrite", "skip"])
+  })
+]);
+var ImportApplyRequestSchema = ImportPlanRequestSchema.extend({
+  /** 未列出的冲突项缺省 skip（保守默认：未决策不覆盖） */
+  decisions: z7.array(ImportDecisionSchema).default([])
+});
+var DependencyStatusSchema = z7.enum(["create", "identical", "conflict"]);
+var DependencyCheckSchema = z7.object({
+  kind: z7.enum(["skill", "agent", "modelAlias"]),
+  name: z7.string(),
+  /** skill/agent 携带；modelAlias 无 */
+  scope: z7.enum(["global", "project"]).optional(),
+  status: DependencyStatusSchema,
+  /** status ≠ create 时目标环境现值版本（modelAlias 无 version 概念不填） */
+  currentVersion: z7.string().optional(),
+  importVersion: z7.string().optional(),
+  /** status = conflict 时差异字段名清单（如 "content, references"） */
+  changeSummary: z7.string().optional(),
+  /** 影响范围（PRD F13）：global 资产影响所有项目 / project 资产仅影响所属项目 */
+  impact: z7.enum(["global", "project"])
+});
+var ImportPlanResponseSchema = z7.object({
+  template: z7.object({
+    name: z7.string(),
+    willOverwrite: z7.boolean(),
+    currentVersion: z7.string().optional(),
+    importVersion: z7.string(),
+    isDefaultRequested: z7.boolean(),
+    /** isDefault 降级后的最终生效值（F17：项目已有默认 → false） */
+    isDefaultEffect: z7.boolean(),
+    downgradeReason: z7.string().optional()
+  }),
+  dependencies: z7.array(DependencyCheckSchema),
+  /** 非阻断提示（源环境悬空绑定、agent.model 引用缺失等） */
+  warnings: z7.array(z7.string())
+});
+var DependencyActionSchema = z7.enum(["created", "updated", "skipped", "identical", "failed"]);
+var ImportApplyResponseSchema = z7.object({
+  template: z7.object({
+    id: z7.string(),
+    name: z7.string(),
+    action: z7.enum(["created", "updated"]),
+    isDefaultEffect: z7.boolean()
+  }),
+  dependencies: z7.array(
+    z7.object({
+      kind: z7.enum(["skill", "agent", "modelAlias"]),
+      name: z7.string(),
+      scope: z7.enum(["global", "project"]).optional(),
+      action: DependencyActionSchema,
+      /** action = failed 时的错误说明 */
+      message: z7.string().optional()
+    })
+  )
+});
+function decisionKey(kind, scope, name) {
+  return `${kind}:${scope ?? ""}:${name}`;
+}
+
 // src/schemas/advance.ts
-import { z as z6 } from "zod";
-var AdvanceRequestSchema = z6.object({
-  note: z6.string().optional(),
+import { z as z8 } from "zod";
+var AdvanceRequestSchema = z8.object({
+  note: z8.string().optional(),
   /** min(1).max(2000) 与 record summary 端点对齐（同一 $set 目标，两入口校验强度一致） */
-  summary: z6.string().min(1).max(2e3).optional()
+  summary: z8.string().min(1).max(2e3).optional()
 });
-var ApproveRequestSchema = z6.object({
-  decision: z6.enum(["approved", "rejected"]),
-  comment: z6.string().optional()
+var ApproveRequestSchema = z8.object({
+  decision: z8.enum(["approved", "rejected"]),
+  comment: z8.string().optional()
 });
-var TaskPublicSchema = z6.object({
-  taskId: z6.string(),
-  title: z6.string(),
+var TaskPublicSchema = z8.object({
+  taskId: z8.string(),
+  title: z8.string(),
   // T202608240003：任务类型标签（缺省 = 裸任务/旧任务；模板 PRD 调研变体判定消费）
-  type: z6.enum(TASK_TYPES).optional(),
-  currentNode: z6.string(),
-  currentPhase: z6.string(),
-  status: z6.string(),
-  pausedAt: z6.string().nullable(),
-  track: z6.string()
+  type: z8.enum(TASK_TYPES).optional(),
+  currentNode: z8.string(),
+  currentPhase: z8.string(),
+  status: z8.string(),
+  pausedAt: z8.string().nullable(),
+  track: z8.string()
 });
-var NodeInfoSchema = z6.object({
-  nodeId: z6.string(),
-  label: z6.string(),
-  track: z6.string(),
-  prompt: z6.string(),
-  skills: z6.array(z6.string()),
-  upcomingPause: z6.string().nullable()
+var NodeInfoSchema = z8.object({
+  nodeId: z8.string(),
+  label: z8.string(),
+  track: z8.string(),
+  prompt: z8.string(),
+  skills: z8.array(z8.string()),
+  upcomingPause: z8.string().nullable()
 });
-var AdvanceResponseSchema = z6.discriminatedUnion("status", [
-  z6.object({
-    status: z6.literal("advanced"),
+var AdvanceResponseSchema = z8.discriminatedUnion("status", [
+  z8.object({
+    status: z8.literal("advanced"),
     task: TaskPublicSchema,
     nextNode: NodeInfoSchema
   }),
-  z6.object({
-    status: z6.literal("paused"),
+  z8.object({
+    status: z8.literal("paused"),
     task: TaskPublicSchema,
     pausePoint: EdgePausePointSchema,
-    guidance: z6.string()
+    guidance: z8.string()
   }),
-  z6.object({
-    status: z6.literal("completed"),
+  z8.object({
+    status: z8.literal("completed"),
     task: TaskPublicSchema
   })
 ]);
-var ApproveResponseSchema = z6.discriminatedUnion("status", [
-  z6.object({
-    status: z6.literal("advanced"),
+var ApproveResponseSchema = z8.discriminatedUnion("status", [
+  z8.object({
+    status: z8.literal("advanced"),
     task: TaskPublicSchema,
     nextNode: NodeInfoSchema
   }),
-  z6.object({
-    status: z6.literal("rejected"),
+  z8.object({
+    status: z8.literal("rejected"),
     task: TaskPublicSchema,
-    guidance: z6.string()
+    guidance: z8.string()
   }),
   // 「completed」分支当前引擎不可达（approve 从 paused 流转必有下一节点，技术方案 §2.2
   // 已删 paused→completed 直达路径）——按方案 §2.1 契约保留作前向兼容预留
-  z6.object({
-    status: z6.literal("completed"),
+  z8.object({
+    status: z8.literal("completed"),
     task: TaskPublicSchema
   })
 ]);
-var PauseRequestSchema = z6.object({
-  reason: z6.string().optional()
+var PauseRequestSchema = z8.object({
+  reason: z8.string().optional()
 });
-var ResumeRequestSchema = z6.object({
-  decision: z6.string().optional()
+var ResumeRequestSchema = z8.object({
+  decision: z8.string().optional()
+});
+var CancelRequestSchema = z8.object({
+  reason: z8.string().min(1).max(500).optional()
 });
 
 // src/schemas/task-doc.ts
-import { z as z7 } from "zod";
-var TaskContextSchema = z7.object({
-  task: z7.object({
-    taskId: z7.string(),
-    title: z7.string(),
+import { z as z9 } from "zod";
+var TaskContextSchema = z9.object({
+  task: z9.object({
+    taskId: z9.string(),
+    title: z9.string(),
     // T202608240003：与 TaskPublicSchema 同步（toTaskPublic 运行时已产出，schema 声明漂移会导致 typed 消费方 strip 掉 type）
-    type: z7.enum(TASK_TYPES).optional(),
-    currentNode: z7.string(),
-    currentPhase: z7.string(),
-    status: z7.string(),
-    pausedAt: z7.string().nullable(),
-    track: z7.string()
+    type: z9.enum(TASK_TYPES).optional(),
+    currentNode: z9.string(),
+    currentPhase: z9.string(),
+    status: z9.string(),
+    pausedAt: z9.string().nullable(),
+    track: z9.string()
   }),
-  currentNode: z7.object({
-    nodeId: z7.string(),
-    label: z7.string(),
-    phase: z7.string(),
-    track: z7.string(),
+  currentNode: z9.object({
+    nodeId: z9.string(),
+    label: z9.string(),
+    phase: z9.string(),
+    track: z9.string(),
     /** renderPrompt 渲染后（AI 推进任务的直接输入） */
-    prompt: z7.string(),
-    skills: z7.array(z7.string()),
+    prompt: z9.string(),
+    skills: z9.array(z9.string()),
     /** 完成当前节点后出边上的暂停点描述（经 findNextEdge 按轨选边） */
-    upcomingPause: z7.string().nullable()
+    upcomingPause: z9.string().nullable()
   }).nullable(),
-  pausedAtEdge: z7.object({
-    from: z7.string(),
-    to: z7.string(),
+  pausedAtEdge: z9.object({
+    from: z9.string(),
+    to: z9.string(),
     pausePoint: EdgePausePointBaseSchema
   }).nullable(),
   /** 全节点实时状态清单 */
-  nodes: z7.array(z7.object({
-    nodeId: z7.string(),
-    label: z7.string(),
-    status: z7.string(),
-    enteredAt: z7.date().nullable(),
-    completedAt: z7.date().nullable()
+  nodes: z9.array(z9.object({
+    nodeId: z9.string(),
+    label: z9.string(),
+    status: z9.string(),
+    enteredAt: z9.date().nullable(),
+    completedAt: z9.date().nullable()
   })),
   /** N020 D1：任务级结构化文档（未写时 null） */
   taskDoc: TaskDocContentSchema.nullable(),
   /** N020 D1：节点执行记录（仅含已写记录的 nodeId） */
-  nodeRecords: z7.record(z7.string(), NodeRecordSchema),
+  nodeRecords: z9.record(z9.string(), NodeRecordSchema),
   /** N020 D1：跨节点累积素材（架构信息收集条目） */
-  archNotes: z7.array(ArchNoteSchema)
+  archNotes: z9.array(ArchNoteSchema)
 });
-var TaskSummarySchema = z7.object({
-  taskId: z7.string(),
-  title: z7.string(),
+var TaskSummarySchema = z9.object({
+  taskId: z9.string(),
+  title: z9.string(),
   // T202608240003：任务类型标签（缺省 = 裸任务/旧任务）
-  type: z7.enum(TASK_TYPES).optional(),
-  projectId: z7.string(),
-  dagTemplateId: z7.string(),
-  currentNode: z7.string(),
-  currentPhase: z7.string(),
-  status: z7.string(),
-  pausedAt: z7.string().nullable(),
-  track: z7.string(),
-  progress: z7.object({
-    completed: z7.number(),
-    total: z7.number()
+  type: z9.enum(TASK_TYPES).optional(),
+  projectId: z9.string(),
+  dagTemplateId: z9.string(),
+  currentNode: z9.string(),
+  currentPhase: z9.string(),
+  status: z9.string(),
+  pausedAt: z9.string().nullable(),
+  track: z9.string(),
+  progress: z9.object({
+    completed: z9.number(),
+    total: z9.number()
   }),
-  createdAt: z7.date().optional(),
-  updatedAt: z7.date().optional()
+  createdAt: z9.date().optional(),
+  updatedAt: z9.date().optional()
+});
+
+// src/schemas/write-ack.ts
+import { z as z10 } from "zod";
+var WRITE_ACK_ENTRY_KINDS = ["check", "artifact", "decision", "confirmation", "archnote"];
+var WriteAckEntryKindSchema = z10.enum(WRITE_ACK_ENTRY_KINDS);
+var EchoItemSchema = z10.object({
+  path: z10.string(),
+  excerpt: z10.string()
+});
+var TaskProgressSchema = z10.object({
+  completed: z10.number().int(),
+  total: z10.number().int()
+});
+var TaskProgressPublicSchema = TaskPublicSchema.extend({
+  projectId: z10.string(),
+  progress: TaskProgressSchema
+});
+var WriteAckSchema = z10.object({
+  taskId: z10.string(),
+  /** 本次写入触及的字段点路径（如 doc.what / nodeRecords.PRD.checks） */
+  updated: z10.array(z10.string()),
+  /** 新建条目标识（$push 五类对象条目；无新条目的端点缺省） */
+  entry: z10.object({
+    id: z10.string(),
+    kind: WriteAckEntryKindSchema
+  }).optional(),
+  /** 写入内容回显（触及字段逐条；无值可回显的端点可缺省） */
+  echo: z10.array(EchoItemSchema).optional(),
+  updatedAt: z10.date(),
+  task: TaskProgressPublicSchema
+});
+var CreateTaskResponseSchema = z10.object({
+  task: TaskProgressPublicSchema,
+  firstNode: NodeInfoSchema
 });
+function taskProgress(task) {
+  const states = Object.values(task.dagInstance.nodeStates);
+  const completed = states.filter((s) => s?.status === "completed").length;
+  const skipped = states.filter((s) => s?.status === "skipped").length;
+  return { completed, total: task.dagInstance.nodes.length - skipped };
+}
+function excerpt(value, max = 120) {
+  const chars = Array.from(value);
+  if (chars.length <= max) return value;
+  return `${chars.slice(0, max - 1).join("")}\u2026`;
+}
+var CONTEXT_VIEWS = ["basic", "full"];
+var ContextViewSchema = z10.enum(CONTEXT_VIEWS);
 
 // src/schemas/project.ts
-import { z as z8 } from "zod";
-var ProjectStatusSchema = z8.enum(["active", "archived"]);
-var ProjectSchema = z8.object({
-  id: z8.string().optional(),
-  key: z8.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09"),
-  name: z8.string().min(1).max(50),
-  description: z8.string().max(500).optional(),
+import { z as z11 } from "zod";
+var ProjectStatusSchema = z11.enum(["active", "archived"]);
+var ProjectSchema = z11.object({
+  id: z11.string().optional(),
+  key: z11.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09"),
+  name: z11.string().min(1).max(50),
+  description: z11.string().max(500).optional(),
   status: ProjectStatusSchema.default("active"),
-  createdAt: z8.date().optional(),
-  updatedAt: z8.date().optional()
+  createdAt: z11.date().optional(),
+  updatedAt: z11.date().optional()
 });
-var ProjectCreateSchema = z8.object({
-  key: z8.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09").optional(),
-  name: z8.string().min(1).max(50),
-  description: z8.string().max(500).optional()
+var ProjectCreateSchema = z11.object({
+  key: z11.string().regex(/^[a-z0-9][a-z0-9-]{1,30}$/, "key \u5FC5\u987B\u4E3A kebab-case\uFF082-31 \u5B57\u7B26\uFF09").optional(),
+  name: z11.string().min(1).max(50),
+  description: z11.string().max(500).optional()
 });
-var ProjectUpdateSchema = z8.object({
-  name: z8.string().min(1).max(50).optional(),
-  description: z8.string().max(500).optional(),
+var ProjectUpdateSchema = z11.object({
+  name: z11.string().min(1).max(50).optional(),
+  description: z11.string().max(500).optional(),
   status: ProjectStatusSchema.optional()
 });
 
 // src/schemas/enum-registry.ts
-import { z as z9 } from "zod";
-var EnumRegistryCategorySchema = z9.enum([
+import { z as z12 } from "zod";
+var EnumRegistryCategorySchema = z12.enum([
   "dag_phase",
   "dag_track",
   "pause_type",
   "task_status",
   "node_status",
   "skill_category",
-  "scope"
+  "scope",
+  "agent_function"
 ]);
-var EnumEntrySchema = z9.object({
+var EnumEntrySchema = z12.object({
   /** 领域层存库的原始枚举值（不可臆造；builtin 值 engine/DB 强依赖；kebab 约束与 skill name 对齐，保证 DELETE /entries/:value 可寻址） */
-  value: z9.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: z12.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: z9.string().min(1, "label \u4E0D\u80FD\u4E3A\u7A7A"),
+  label: z12.string().min(1, "label \u4E0D\u80FD\u4E3A\u7A7A"),
   /** 可选语义色 token（如 --success / --warning），消费端映射到 UI */
-  color: z9.string().optional(),
+  color: z12.string().optional(),
   /** 下拉排序（升序） */
-  order: z9.number().int().default(0),
+  order: z12.number().int().default(0),
   /** 内置值：禁删 + label/color 可改但 value 不可改（D8）；seed 时标记 */
-  builtin: z9.boolean().default(false),
+  builtin: z12.boolean().default(false),
   /** 启停：false = 下拉禁用展示（历史数据仍可读，新选择不可用） */
-  active: z9.boolean().default(true)
+  active: z12.boolean().default(true)
 });
-var EnumRegistrySchema = z9.object({
-  id: z9.string().optional(),
+var EnumRegistrySchema = z12.object({
+  id: z12.string().optional(),
   category: EnumRegistryCategorySchema,
-  entries: z9.array(EnumEntrySchema).default([]),
-  updatedAt: z9.date().optional()
+  entries: z12.array(EnumEntrySchema).default([]),
+  updatedAt: z12.date().optional()
 });
-var EnumRegistryUpdateSchema = z9.object({
-  entries: z9.array(EnumEntrySchema)
+var EnumRegistryUpdateSchema = z12.object({
+  entries: z12.array(EnumEntrySchema)
+});
+
+// src/schemas/asset-enabled.ts
+import { z as z13 } from "zod";
+var AssetSetEnabledSchema = z13.object({
+  enabled: z13.boolean()
 });
 
 // src/config/server-config.ts
-import { z as z10 } from "zod";
-var SimingLogLevelSchema = z10.enum(["debug", "info", "warn", "error"]);
-var SimingConfigSchema = z10.object({
-  mongoUri: z10.string().min(1).default("mongodb://localhost:27017"),
-  port: z10.coerce.number().int().min(1).max(65535).default(7777),
+import { z as z14 } from "zod";
+var SimingLogLevelSchema = z14.enum(["debug", "info", "warn", "error"]);
+var SimingConfigSchema = z14.object({
+  mongoUri: z14.string().min(1).default("mongodb://localhost:27017"),
+  port: z14.coerce.number().int().min(1).max(65535).default(7777),
   /**
    * N018 D8：默认仅绑定本机回环（安全默认）；远程/局域接入（F7）显式配置 host。
    * 超出 PRD V1 配置清单的新增项，依据见技术方案 §3.4「超范围扩展标注」。
    */
-  host: z10.string().min(1).default("127.0.0.1"),
+  host: z14.string().min(1).default("127.0.0.1"),
   logLevel: SimingLogLevelSchema.default("info"),
   /**
    * F6 预留字段（V2 远程部署）：宽松形态——出现即接受、形状不校验、运行时不读取。
    * 严格满足 PRD「配置中出现预留字段时不报错」；V2 落地时收紧为类型化 schema。
    */
-  auth: z10.unknown().optional(),
-  cors: z10.unknown().optional()
+  auth: z14.unknown().optional(),
+  cors: z14.unknown().optional()
 });
 var SIMING_CONFIG_KEYS = ["mongoUri", "port", "host", "logLevel"];
 var SIMING_CONFIG_ENV_KEYS = {
@@ -1953,6 +2394,19 @@ var SIMING_CONFIG_ENV_KEYS = {
   logLevel: "SIMING_LOG_LEVEL"
 };
 
+// src/version-bump.ts
+function tryBumpPatch(version) {
+  const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
+  if (!m || m[1] === void 0 || m[2] === void 0 || m[3] === void 0) return null;
+  return `${m[1]}.${m[2]}.${String(Number(m[3]) + 1)}`;
+}
+function bumpPatch(version) {
+  return tryBumpPatch(version) ?? "1.0.1";
+}
+function bumpPatchOrPassthrough(version) {
+  return tryBumpPatch(version) ?? version;
+}
+
 // src/task/entry-id.ts
 var ENTRY_ID_LENGTH = 6;
 var BASE36_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
@@ -1968,8 +2422,397 @@ function generateEntryId(existing) {
   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, ...rest } = tpl;
+  return { ...rest };
+}
+function toSkillPayload(skill) {
+  const { id: _id, projectId: _projectId, enabled: _enabled, createdAt: _ca, updatedAt: _ua, references, ...rest } = skill;
+  return { ...rest, references: references ?? [] };
+}
+function toAgentPayload(agent) {
+  const { id: _id, projectId: _projectId, enabled: _enabled, createdAt: _ca, updatedAt: _ua, references, ...rest } = agent;
+  return { ...rest, references: references ?? [] };
+}
+function toModelAliasPayload(alias) {
+  const { id: _id, createdAt: _ca, updatedAt: _ua, ...rest } = alias;
+  return { ...rest };
+}
+function diffReferences(payload, entity) {
+  const a = payload ?? [];
+  const b = entity ?? [];
+  return a.length === b.length && a.every((doc, i) => doc.path === b[i]?.path && doc.content === b[i]?.content);
+}
+function diffSkillPayload(payload, entity) {
+  const diffs = [];
+  if (entity.description !== payload.description) diffs.push("description");
+  if (entity.content !== payload.content) diffs.push("content");
+  if (entity.category !== payload.category) diffs.push("category");
+  if (entity.version !== payload.version) diffs.push("version");
+  if (!diffReferences(payload.references, entity.references)) diffs.push("references");
+  return diffs;
+}
+function diffAgentPayload(payload, entity) {
+  const diffs = [];
+  if (entity.description !== payload.description) diffs.push("description");
+  if (entity.systemPrompt !== payload.systemPrompt) diffs.push("systemPrompt");
+  if (entity.model !== payload.model) diffs.push("model");
+  if (entity.version !== payload.version) diffs.push("version");
+  if (entity.function !== payload.function) diffs.push("function");
+  const boundA = entity.boundSkills ?? [];
+  if (boundA.length !== payload.boundSkills.length || boundA.some((s, i) => s !== payload.boundSkills[i])) diffs.push("boundSkills");
+  const toolsA = entity.tools ?? [];
+  if (toolsA.length !== payload.tools.length || toolsA.some((t, i) => t !== payload.tools[i])) diffs.push("tools");
+  const permsA = entity.permissions ?? [];
+  if (permsA.length !== payload.permissions.length || permsA.some((p, i) => p !== payload.permissions[i])) diffs.push("permissions");
+  if (!diffReferences(payload.references, entity.references)) diffs.push("references");
+  return diffs;
+}
+function diffModelAliasPayload(payload, entity) {
+  const diffs = [];
+  if (entity.name !== payload.name) diffs.push("name");
+  if (entity.realModel !== payload.realModel) diffs.push("realModel");
+  return diffs;
+}
+
+// src/template-transfer/export-compose.ts
+async function composeExportBundle(deps, templateId) {
+  const tpl = await deps.templateRepo.getById(templateId);
+  if (!tpl) throw new NotFoundError("dag-template", templateId);
+  const warnings = [];
+  const directSkillNames = [...new Set(tpl.nodes.flatMap((node) => node.skills))];
+  const [globalAgents, projectAgents] = await Promise.all([
+    deps.agentRepo.listAgentsByScopeFilter("global", void 0, { includeDisabled: true }),
+    deps.agentRepo.listAgentsByScopeFilter("project", tpl.projectId, { includeDisabled: true })
+  ]);
+  const directSet = new Set(directSkillNames);
+  const agents = [...globalAgents, ...projectAgents].filter(
+    (agent) => (agent.boundSkills ?? []).some((name) => directSet.has(name))
+  );
+  const allSkillNames = [.../* @__PURE__ */ new Set([...directSkillNames, ...agents.flatMap((a) => a.boundSkills ?? [])])];
+  const skillMap = await deps.skillRepo.listSkillsByNames(allSkillNames, "project", tpl.projectId);
+  for (const name of allSkillNames) {
+    if (!skillMap.has(name)) {
+      warnings.push(`SKILL "${name}" \u5728\u6E90\u73AF\u5883\u4E2D\u4E0D\u5B58\u5728\uFF08\u7ED1\u5B9A\u60AC\u7A7A\uFF09\uFF0C\u672A\u5305\u542B\u5728\u5BFC\u51FA\u4F9D\u8D56\u4E2D`);
+    }
+  }
+  const modelCodes = [...new Set(agents.map((a) => a.model))];
+  const modelAliases = [];
+  for (const code of modelCodes) {
+    const alias = await deps.modelAliasRepo.getByCode(code);
+    if (alias) {
+      modelAliases.push(alias);
+    } else {
+      warnings.push(`\u6A21\u578B\u6620\u5C04 "${code}" \u5728\u6E90\u73AF\u5883\u4E2D\u4E0D\u5B58\u5728\uFF08agent.model \u60AC\u7A7A\uFF09\uFF0C\u672A\u5305\u542B\u5728\u5BFC\u51FA\u4F9D\u8D56\u4E2D`);
+    }
+  }
+  return {
+    exportFormatVersion: EXPORT_FORMAT_VERSION,
+    exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    warnings,
+    template: toTemplatePayload(tpl),
+    dependencies: {
+      skills: [...skillMap.values()].map(toSkillPayload),
+      agents: agents.map(toAgentPayload),
+      modelAliases: modelAliases.map(toModelAliasPayload)
+    }
+  };
+}
+
+// src/template-transfer/import-plan.ts
+function statusOf(diffs) {
+  if (diffs === null) return { status: "create" };
+  if (diffs.length === 0) return { status: "identical" };
+  return { status: "conflict", changeSummary: diffs.join(", ") };
+}
+async function hasProjectDefault(deps, targetProjectId) {
+  const hit = await deps.templateRepo._collection.findOne(
+    { projectId: targetProjectId, isDefault: true },
+    { projection: { _id: 1 } }
+  );
+  return hit !== null;
+}
+async function findTemplateByName(deps, targetProjectId, name) {
+  const rows = await deps.templateRepo.listDagTemplates({ projectId: targetProjectId, name, includeDisabled: true });
+  const row = rows[0];
+  return row && row.id ? { id: row.id, version: row.version } : null;
+}
+async function buildImportPlan(deps, targetProjectId, bundle) {
+  const warnings = [];
+  const existing = await findTemplateByName(deps, targetProjectId, bundle.template.name);
+  const projectHasDefault = await hasProjectDefault(deps, targetProjectId);
+  const isDefaultEffect = bundle.template.isDefault && !projectHasDefault;
+  const skillChecks = [];
+  for (const payload of bundle.dependencies.skills) {
+    const entity = await deps.skillRepo.getByNameScoped(
+      payload.name,
+      payload.scope,
+      payload.scope === "project" ? targetProjectId : void 0,
+      { includeDisabled: true }
+    );
+    const { status, changeSummary } = statusOf(entity ? diffSkillPayload(payload, entity) : null);
+    skillChecks.push({
+      kind: "skill",
+      name: payload.name,
+      scope: payload.scope,
+      status,
+      ...entity ? { currentVersion: entity.version } : {},
+      importVersion: payload.version,
+      ...changeSummary ? { changeSummary } : {},
+      impact: payload.scope
+    });
+  }
+  const agentChecks = [];
+  for (const payload of bundle.dependencies.agents) {
+    const entity = await deps.agentRepo.getByNameScoped(
+      payload.name,
+      payload.scope,
+      payload.scope === "project" ? targetProjectId : void 0,
+      { includeDisabled: true }
+    );
+    const { status, changeSummary } = statusOf(entity ? diffAgentPayload(payload, entity) : null);
+    agentChecks.push({
+      kind: "agent",
+      name: payload.name,
+      scope: payload.scope,
+      status,
+      ...entity ? { currentVersion: entity.version } : {},
+      importVersion: payload.version,
+      ...changeSummary ? { changeSummary } : {},
+      impact: payload.scope
+    });
+  }
+  const aliasChecks = [];
+  for (const payload of bundle.dependencies.modelAliases) {
+    const entity = await deps.modelAliasRepo.getByCode(payload.code);
+    const { status, changeSummary } = statusOf(entity ? diffModelAliasPayload(payload, entity) : null);
+    aliasChecks.push({
+      kind: "modelAlias",
+      name: payload.code,
+      status,
+      ...changeSummary ? { changeSummary } : {},
+      // 模型映射无 version 概念（内容即 name/realModel 二元组）
+      impact: "global"
+    });
+  }
+  const bundledCodes = new Set(bundle.dependencies.modelAliases.map((a) => a.code));
+  for (const agent of bundle.dependencies.agents) {
+    if (bundledCodes.has(agent.model)) continue;
+    const alias = await deps.modelAliasRepo.getByCode(agent.model);
+    if (!alias) {
+      warnings.push(`AGENT "${agent.name}" \u5F15\u7528\u7684\u6A21\u578B\u6620\u5C04 "${agent.model}" \u4E0D\u5728\u5BFC\u51FA\u5305\u4E2D\u4E14\u76EE\u6807\u73AF\u5883\u4E0D\u5B58\u5728\uFF0C\u5BFC\u5165\u540E\u8BE5\u5F15\u7528\u5C06\u60AC\u7A7A`);
+    }
+  }
+  const bundledSkillNames = new Set(bundle.dependencies.skills.map((s) => s.name));
+  for (const agent of bundle.dependencies.agents) {
+    for (const skillName of agent.boundSkills) {
+      if (bundledSkillNames.has(skillName)) continue;
+      const globalHit = await deps.skillRepo.getByNameScoped(skillName, "global", void 0, { includeDisabled: true });
+      const projectHit = agent.scope === "project" ? await deps.skillRepo.getByNameScoped(skillName, "project", targetProjectId, { includeDisabled: true }) : null;
+      if (!globalHit && !projectHit) {
+        warnings.push(`AGENT "${agent.name}" \u7ED1\u5B9A\u7684 SKILL "${skillName}" \u4E0D\u5728\u5BFC\u51FA\u5305\u4E2D\u4E14\u76EE\u6807\u73AF\u5883\u4E0D\u5B58\u5728\uFF0C\u5BFC\u5165\u540E\u8BE5\u7ED1\u5B9A\u5C06\u60AC\u7A7A`);
+      }
+    }
+  }
+  return {
+    template: {
+      name: bundle.template.name,
+      willOverwrite: existing !== null,
+      ...existing ? { currentVersion: existing.version } : {},
+      importVersion: bundle.template.version,
+      isDefaultRequested: bundle.template.isDefault,
+      isDefaultEffect,
+      ...bundle.template.isDefault && !isDefaultEffect ? { downgradeReason: "project_has_default" } : {}
+    },
+    dependencies: [...skillChecks, ...agentChecks, ...aliasChecks],
+    warnings
+  };
+}
+
+// src/template-transfer/import-apply.ts
+async function applyImport(deps, targetProjectId, bundle, decisions) {
+  const decisionMap = new Map(decisions.map((d) => [decisionKey(d.kind, "scope" in d ? d.scope : void 0, d.name), d.action]));
+  const existing = await findTemplateByName(deps, targetProjectId, bundle.template.name);
+  const projectHasDefault = await hasProjectDefault(deps, targetProjectId);
+  const isDefaultEffect = bundle.template.isDefault && !projectHasDefault;
+  const tplPayload = bundle.template;
+  const createInput = { ...tplPayload, projectId: targetProjectId, isDefault: isDefaultEffect };
+  const parsed = DagTemplateCreateSchema.safeParse(createInput);
+  if (!parsed.success) {
+    throw new ValidationError("\u6A21\u677F\u5185\u5BB9\u6821\u9A8C\u5931\u8D25\uFF08\u5BFC\u5165\u6587\u4EF6\u5B57\u6BB5\u975E\u6CD5\uFF09", parsed.error.issues);
+  }
+  const contentFields = {
+    name: tplPayload.name,
+    description: tplPayload.description,
+    nodes: tplPayload.nodes,
+    edges: tplPayload.edges,
+    version: tplPayload.version,
+    isDefault: isDefaultEffect,
+    layout: tplPayload.layout ?? {}
+  };
+  let templateResult;
+  if (existing) {
+    const updated = await deps.templateRepo.update(existing.id, contentFields);
+    if (!updated || !updated.id) throw new NotFoundError("dag-template", existing.id);
+    templateResult = { id: updated.id, name: updated.name, action: "updated", isDefaultEffect };
+  } else {
+    const raced = await findTemplateByName(deps, targetProjectId, tplPayload.name);
+    if (raced) {
+      throw new ConflictError("dag-template", `name conflict: ${tplPayload.name}`, {
+        bizCode: "TEMPLATE_NAME_CONFLICT",
+        message: BIZ_CODE_MESSAGES.TEMPLATE_NAME_CONFLICT
+      });
+    }
+    const created = await deps.templateRepo.createDagTemplate({ ...createInput, layout: tplPayload.layout ?? {} });
+    if (!created.id) throw new Error("\u6A21\u677F\u521B\u5EFA\u8FD4\u56DE\u5B9E\u4F53\u7F3A\u5931 id\uFF08\u4E0D\u53EF\u8FBE\u9632\u5FA1\u5206\u652F\uFF09");
+    templateResult = { id: created.id, name: created.name, action: "created", isDefaultEffect };
+  }
+  const results = [];
+  for (const payload of bundle.dependencies.skills) {
+    try {
+      const key = decisionKey("skill", payload.scope, payload.name);
+      const existingSkill = await deps.skillRepo.getByNameScoped(
+        payload.name,
+        payload.scope,
+        payload.scope === "project" ? targetProjectId : void 0,
+        { includeDisabled: true }
+      );
+      const diffs = existingSkill ? diffSkillPayload(payload, existingSkill) : null;
+      const status = diffs === null ? "create" : diffs.length === 0 ? "identical" : "conflict";
+      const action = decide(status, decisionMap.get(key));
+      if (action === "identical") {
+        results.push({ kind: "skill", name: payload.name, scope: payload.scope, action: "identical" });
+        continue;
+      }
+      if (action === "skipped") {
+        results.push({ kind: "skill", name: payload.name, scope: payload.scope, action: "skipped" });
+        continue;
+      }
+      const createData = { ...payload, ...payload.scope === "project" ? { projectId: targetProjectId } : {} };
+      const check = SkillCreateSchema.safeParse(createData);
+      if (!check.success) {
+        results.push({ kind: "skill", name: payload.name, scope: payload.scope, action: "failed", message: summarizeIssues(check.error.issues) });
+        continue;
+      }
+      if (existingSkill && existingSkill.id) {
+        await deps.skillRepo.updateByNameScoped(
+          payload.name,
+          payload.scope,
+          payload.scope === "project" ? targetProjectId : void 0,
+          {
+            description: payload.description,
+            content: payload.content,
+            category: payload.category,
+            version: payload.version,
+            references: payload.references
+          }
+        );
+        results.push({ kind: "skill", name: payload.name, scope: payload.scope, action: "updated" });
+      } else {
+        await deps.skillRepo.createSkill(check.data);
+        results.push({ kind: "skill", name: payload.name, scope: payload.scope, action: "created" });
+      }
+    } catch (err) {
+      results.push({ kind: "skill", name: payload.name, scope: payload.scope, action: "failed", message: errorMessage(err) });
+    }
+  }
+  for (const payload of bundle.dependencies.agents) {
+    try {
+      const key = decisionKey("agent", payload.scope, payload.name);
+      const existingAgent = await deps.agentRepo.getByNameScoped(
+        payload.name,
+        payload.scope,
+        payload.scope === "project" ? targetProjectId : void 0,
+        { includeDisabled: true }
+      );
+      const diffs = existingAgent ? diffAgentPayload(payload, existingAgent) : null;
+      const status = diffs === null ? "create" : diffs.length === 0 ? "identical" : "conflict";
+      const action = decide(status, decisionMap.get(key));
+      if (action === "identical" || action === "skipped") {
+        results.push({ kind: "agent", name: payload.name, scope: payload.scope, action });
+        continue;
+      }
+      const createData = { ...payload, ...payload.scope === "project" ? { projectId: targetProjectId } : {} };
+      const check = AgentCreateSchema.safeParse(createData);
+      if (!check.success) {
+        results.push({ kind: "agent", name: payload.name, scope: payload.scope, action: "failed", message: summarizeIssues(check.error.issues) });
+        continue;
+      }
+      await assertBoundSkillsCompatible(
+        deps.skillRepo,
+        payload.scope,
+        payload.scope === "project" ? targetProjectId : void 0,
+        payload.boundSkills
+      );
+      if (existingAgent && existingAgent.id) {
+        await deps.agentRepo.updateByNameScoped(
+          payload.name,
+          payload.scope,
+          payload.scope === "project" ? targetProjectId : void 0,
+          {
+            description: payload.description,
+            systemPrompt: payload.systemPrompt,
+            boundSkills: payload.boundSkills,
+            model: payload.model,
+            tools: payload.tools,
+            permissions: payload.permissions,
+            version: payload.version,
+            references: payload.references,
+            "function": payload.function
+          }
+        );
+        results.push({ kind: "agent", name: payload.name, scope: payload.scope, action: "updated" });
+      } else {
+        await deps.agentRepo.createAgent(check.data);
+        results.push({ kind: "agent", name: payload.name, scope: payload.scope, action: "created" });
+      }
+    } catch (err) {
+      results.push({ kind: "agent", name: payload.name, scope: payload.scope, action: "failed", message: errorMessage(err) });
+    }
+  }
+  for (const payload of bundle.dependencies.modelAliases) {
+    try {
+      const key = decisionKey("modelAlias", void 0, payload.code);
+      const existingAlias = await deps.modelAliasRepo.getByCode(payload.code);
+      const diffs = existingAlias ? diffModelAliasPayload(payload, existingAlias) : null;
+      const status = diffs === null ? "create" : diffs.length === 0 ? "identical" : "conflict";
+      const action = decide(status, decisionMap.get(key));
+      if (action === "identical" || action === "skipped") {
+        results.push({ kind: "modelAlias", name: payload.code, action });
+        continue;
+      }
+      if (existingAlias) {
+        await deps.modelAliasRepo.updateByCode(payload.code, { name: payload.name, realModel: payload.realModel });
+        results.push({ kind: "modelAlias", name: payload.code, action: "updated" });
+      } else {
+        const createData = { code: payload.code, name: payload.name, realModel: payload.realModel };
+        await deps.modelAliasRepo.createModelAlias(createData);
+        results.push({ kind: "modelAlias", name: payload.code, action: "created" });
+      }
+    } catch (err) {
+      results.push({ kind: "modelAlias", name: payload.code, action: "failed", message: errorMessage(err) });
+    }
+  }
+  return { template: templateResult, dependencies: results };
+}
+function decide(status, decision) {
+  if (status === "identical") return "identical";
+  if (status === "create") return "create";
+  return decision === "overwrite" ? "overwrite" : "skipped";
+}
+function summarizeIssues(issues) {
+  const parts = issues.map(
+    (issue) => `${issue.path.join(".")}: ${issue.message}`
+  );
+  return `\u6821\u9A8C\u5931\u8D25\uFF1A${parts.join("; ")}`;
+}
+function errorMessage(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+
 // src/index.ts
-var PackageJsonSchema = z11.object({ version: z11.string().min(1) });
+var PackageJsonSchema = z15.object({ version: z15.string().min(1) });
 var packageJsonParsed = PackageJsonSchema.safeParse(
   JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"))
 );
@@ -1981,24 +2824,33 @@ function ping() {
   return "pong";
 }
 export {
+  AGENT_MAIN_DOC,
   ARTIFACT_TYPES,
   AdvanceRequestSchema,
   AdvanceResponseSchema,
   AgentCopySchema,
   AgentCreateSchema,
+  AgentFunctionSchema,
+  AgentPayloadSchema,
   AgentSchema,
   AgentScopeSchema,
+  AgentShapeSchema,
   AgentUpdateSchema,
   AppError,
   ApproveRequestSchema,
   ApproveResponseSchema,
   ArchNoteSchema,
   ArtifactSchema,
+  AssetSetEnabledSchema,
   BIZ_CODE_MESSAGES,
   BadRequestError,
+  CONTEXT_VIEWS,
+  CancelRequestSchema,
   CheckItemSchema,
   ConfirmationSchema,
   ConflictError,
+  ContextViewSchema,
+  CreateTaskResponseSchema,
   DAG_PHASES,
   DAG_TRACKS,
   DEFAULT_PROJECT_KEY,
@@ -2012,16 +2864,28 @@ export {
   DagTemplateSchema,
   DagTemplateUpdateSchema,
   DecisionSchema,
+  DependencyActionSchema,
+  DependencyCheckSchema,
+  DependencyStatusSchema,
   ENTRY_ID_REGEX,
+  EXPORT_FORMAT_VERSION,
+  EchoItemSchema,
   EdgePausePointBaseSchema,
   EdgePausePointSchema,
   EnumEntrySchema,
   EnumRegistryCategorySchema,
   EnumRegistrySchema,
   EnumRegistryUpdateSchema,
+  ExportBundleSchema,
   HistoryActionSchema,
   HistoryEntrySchema,
+  ImportApplyRequestSchema,
+  ImportApplyResponseSchema,
+  ImportDecisionSchema,
+  ImportPlanRequestSchema,
+  ImportPlanResponseSchema,
   ModelAliasCreateSchema,
+  ModelAliasPayloadSchema,
   ModelAliasSchema,
   ModelAliasShapeSchema,
   ModelAliasUpdateSchema,
@@ -2041,17 +2905,21 @@ export {
   ProjectSchema,
   ProjectStatusSchema,
   ProjectUpdateSchema,
+  REFERENCE_LIMITS,
   ResumeRequestSchema,
   ReviewSummarySchema,
   SIMING_CODE_REGEX,
   SIMING_CONFIG_ENV_KEYS,
   SIMING_CONFIG_KEYS,
+  SKILL_MAIN_DOC,
   SimingConfigSchema,
   SimingLogLevelSchema,
   SkillCopySchema,
   SkillCreateSchema,
+  SkillPayloadSchema,
   SkillSchema,
   SkillScopeSchema,
+  SkillShapeSchema,
   SkillUpdateSchema,
   TASK_PHASES,
   TASK_STATUSES,
@@ -2060,35 +2928,59 @@ export {
   TaskCreateInputSchema,
   TaskDocContentSchema,
   TaskPhaseSchema,
+  TaskProgressPublicSchema,
+  TaskProgressSchema,
   TaskPublicSchema,
   TaskSchema,
   TaskStatusSchema,
   TaskSummarySchema,
+  TemplatePayloadSchema,
   VERSION,
   ValidationError,
+  WRITE_ACK_ENTRY_KINDS,
+  WriteAckEntryKindSchema,
+  WriteAckSchema,
   advanceTask,
+  applyImport,
   approveTask,
   assertBoundSkillsCompatible,
   assertModelAliasExists,
+  assertReferenceAggregateLimit,
+  assertReferencesDeletable,
+  buildImportPlan,
+  bumpPatch,
+  bumpPatchOrPassthrough,
+  cancelTask,
+  canonicalizeReferencePath,
   checkTermination,
+  composeExportBundle,
   createAgentRepo,
   createDagTemplateRepo,
   createEnumRegistryRepo,
   createModelAliasRepo,
   createMongoClient,
   createProjectRepo,
+  createReferencesSchema,
   createRepo,
   createSkillRepo,
   createTaskRepo,
+  decisionKey,
+  enabledNeFalse,
+  escapeRegExpLiteral,
+  excerpt,
   findNextEdge,
+  findTemplateByName,
   generateEntryId,
   generateProjectKey,
+  hasProjectDefault,
   mkHistory,
   pauseTask,
   ping,
   pruneInstance,
   renderPrompt,
   resumeTask,
+  sumReferenceContentChars,
+  taskProgress,
   toNodeInfo,
   toTaskPublic,
   trackMatchSet,