@dawipong/opcflow 0.6.0 → 0.8.0

package/dist/cli.mjs

@@ -735,6 +735,7 @@ __export(kind_exports, {
   expandPattern: () => expandPattern,
   getKindRegistry: () => getKindRegistry,
   inferKind: () => inferKind,
+  kindPathTemplate: () => kindPathTemplate,
   kindSpec: () => kindSpec,
   normalizeModule: () => normalizeModule
 });
@@ -766,6 +767,14 @@ function contractKinds(config) {
 function expandPattern(pattern, config) {
   return pattern.replace("{prd}", config.docs.prd).replace("{architecture}", config.docs.architecture).replace("{design}", config.docs.design).replace("{acceptance}", config.docs.acceptance);
 }
+function kindPathTemplate(config, kind, lang) {
+  const spec = getKindRegistry(config)[kind];
+  if (!spec?.coords || !spec.pathPatterns?.[0]) return null;
+  const prefix = expandPattern(spec.pathPatterns[0], config);
+  const ext = spec.ext ?? "md";
+  const segs = spec.coords.split("/").map((s) => lang === "zh" ? COORD_LABELS_ZH[s] ?? s : s);
+  return `${prefix}${segs.join("/")}.${ext}`;
+}
 function inferKind(relPath, config) {
   const p = relPath.replace(/\\/g, "/");
   const registry = getKindRegistry(config);
@@ -783,7 +792,7 @@ function normalizeModule(module, config) {
   if (!module) return null;
   return config.moduleMapping[module] ?? module;
 }
-var DEFAULT_KIND_REGISTRY, META_KINDS, PM_KINDS, KIND_TIERS;
+var DEFAULT_KIND_REGISTRY, META_KINDS, PM_KINDS, KIND_TIERS, COORD_LABELS_ZH;
 var init_kind = __esm({
   "core/kind.ts"() {
     "use strict";
@@ -805,7 +814,7 @@ var init_kind = __esm({
       "api-doc": { level: "module", approval: "human", parents: ["module-prd", "db-doc"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{architecture}/api/"], coords: "{module}", defaultEndpoint: "service" },
       "design-system": { level: "endpoint", approval: "human", parents: ["baseline"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{design}/systems/"], coords: "{endpoint}" },
       "design-prompt": { level: "page", approval: "none", parents: ["page-prd", "api-doc", "design-system"], drivesStale: false, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prompts/"], coords: "{endpoint}/{module}/{page}" },
-      prototype: { level: "page", approval: "thumbs", parents: ["design-prompt", "design-system"], drivesStale: true, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prototypes/"], coords: "{endpoint}/{module}/{page}" },
+      prototype: { level: "page", approval: "thumbs", parents: ["design-prompt", "design-system"], drivesStale: true, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prototypes/"], coords: "{endpoint}/{module}/{page}", ext: "html" },
       acceptance: { level: "page", approval: "human", parents: ["page-prd", "prototype"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{acceptance}/"], coords: "{endpoint}/{module}/{page}" },
       code: { level: "module", approval: "machine", parents: ["baseline", "api-doc", "prototype"], drivesStale: false, hashMode: "directory", retrieval: "semantic" },
       doc: { level: "module", approval: "none", parents: [], drivesStale: false, hashMode: "text-normalize", retrieval: "summary" }
@@ -824,6 +833,72 @@ var init_kind = __esm({
       ["prototype", "acceptance"],
       ["code"]
     ];
+    COORD_LABELS_ZH = { "{module}": "{\u6A21\u5757}", "{endpoint}": "{\u7AEF}", "{page}": "{\u9875\u9762}" };
+  }
+});
+
+// core/roles.ts
+function getRoleRegistry(config) {
+  const merged = {};
+  for (const [role, spec] of Object.entries(DEFAULT_ROLE_REGISTRY)) merged[role] = { ...spec };
+  for (const [role, kinds] of Object.entries(config.roleProduces ?? {})) {
+    merged[role] = { ...merged[role] ?? { produces: [] }, produces: kinds };
+  }
+  for (const [role, override] of Object.entries(config.roles ?? {})) {
+    merged[role] = { ...merged[role] ?? { produces: [] }, ...override };
+  }
+  return merged;
+}
+function ownerRoleOf(config, kind) {
+  for (const [role, spec] of Object.entries(getRoleRegistry(config))) {
+    if (spec.produces.includes(kind)) return role;
+  }
+  if (kind === "code") return "developer";
+  return null;
+}
+var DEFAULT_ROLE_REGISTRY;
+var init_roles = __esm({
+  "core/roles.ts"() {
+    "use strict";
+    init_kind();
+    DEFAULT_ROLE_REGISTRY = {
+      "product-manager": {
+        produces: ["project", "roles", "glossary", "flow", "module-prd", "page-prd"]
+      },
+      architect: {
+        produces: ["db-doc", "api-doc"],
+        requires: [{ desc: "PM \u4EA7\u51FA(\u6A21\u5757/\u9875\u9762 PRD)", kinds: PM_KINDS }],
+        dispatch: [
+          { at: "module", endpoint: "common", content: "\u8BBE\u8BA1 {module} \u6A21\u5757\u6570\u636E\u5E93" },
+          { at: "module", endpoint: "service", content: "\u8BBE\u8BA1 {module} \u6A21\u5757 API \u6587\u6863" }
+        ]
+      },
+      designer: {
+        produces: ["design-system", "design-prompt", "prototype"],
+        requires: [{ desc: "PM \u4EA7\u51FA(\u6A21\u5757/\u9875\u9762 PRD)", kinds: PM_KINDS }],
+        dispatch: [
+          { at: "endpoint", ifMissingKind: "design-system", produces: ["design-system"], content: "\u5EFA\u7ACB {endpoint} \u7AEF\u8BBE\u8BA1\u7CFB\u7EDF(\u8BE5\u7AEF\u9996\u4E2A\u9875\u9762\u8BBE\u8BA1\u524D\u7F6E)" },
+          { at: "page", produces: ["design-prompt", "prototype"], content: "\u8BBE\u8BA1 {endpoint}/{page} \u9875\u9762(\u63D0\u793A\u8BCD+\u539F\u578B)" }
+        ]
+      },
+      developer: {
+        produces: ["code"],
+        requires: [
+          { desc: "\u6570\u636E\u5E93\u6587\u6863", kinds: ["db-doc"] },
+          { desc: "API \u6587\u6863", kinds: ["api-doc"], when: { endpointNot: "service" } },
+          { desc: "designer {endpoint} \u8BBE\u8BA1\u7A3F", kinds: ["design-prompt", "prototype"], when: { endpointNot: "service" } }
+        ],
+        dispatch: [
+          { at: "module", endpoint: "service", content: "\u5B9E\u73B0 {module} \u6A21\u5757 service \u7AEF" },
+          { at: "page", content: "\u5B9E\u73B0 {endpoint}/{page} \u9875\u9762" }
+        ],
+        onQaFail: "rework"
+      },
+      qa: {
+        produces: ["acceptance"],
+        dispatch: [{ at: "page", type: "qa", content: "\u9A8C\u6536 {endpoint}/{page} \u9875\u9762" }]
+      }
+    };
   }
 });
 
@@ -964,31 +1039,22 @@ function levelFilter(level, task) {
   }
 }
 function producedKinds(ctx, task) {
-  const declared = ctx.config.roleProduces[task.role] ?? [];
-  if (task.role === "designer") {
-    return task.page ? declared.filter((k) => k !== "design-system") : ["design-system"];
-  }
-  return declared;
-}
-function existRequirements(task) {
-  const m = task.module;
-  switch (task.role) {
-    case "architect":
-    case "designer":
-      return [{ desc: "PM \u4EA7\u51FA(\u6A21\u5757/\u9875\u9762 PRD)", level: "exist", kinds: PM_KINDS, filter: { module: m } }];
-    case "developer": {
-      if (task.endpoint === "service") {
-        return [{ desc: "\u6570\u636E\u5E93\u6587\u6863", level: "exist", kinds: ["db-doc"], filter: { module: m } }];
-      }
-      return [
-        { desc: "\u6570\u636E\u5E93\u6587\u6863", level: "exist", kinds: ["db-doc"], filter: { module: m } },
-        { desc: "API \u6587\u6863", level: "exist", kinds: ["api-doc"], filter: { module: m } },
-        { desc: `designer ${task.endpoint} \u8BBE\u8BA1\u7A3F`, level: "exist", kinds: ["design-prompt", "prototype"], filter: { module: m, endpoint: task.endpoint } }
-      ];
-    }
-    default:
-      return [];
+  const spec = getRoleRegistry(ctx.config)[task.role];
+  if (!spec) return [];
+  const wantPage = !!task.page;
+  const rule = (spec.dispatch ?? []).find((d) => (wantPage ? d.at === "page" : d.at !== "page") && d.produces);
+  return rule?.produces ?? spec.produces;
+}
+function existRequirements(ctx, task) {
+  const spec = getRoleRegistry(ctx.config)[task.role];
+  const reqs = [];
+  for (const r of spec?.requires ?? []) {
+    if (r.when?.endpoint && task.endpoint !== r.when.endpoint) continue;
+    if (r.when?.endpointNot && task.endpoint === r.when.endpointNot) continue;
+    const filter = r.kinds.includes("design-prompt") || r.kinds.includes("prototype") ? { module: task.module, endpoint: task.endpoint } : { module: task.module };
+    reqs.push({ desc: r.desc.replaceAll("{endpoint}", task.endpoint ?? ""), level: "exist", kinds: r.kinds, filter });
   }
+  return reqs;
 }
 function approvedRequirements(ctx, task) {
   const registry = getKindRegistry(ctx.config);
@@ -1017,8 +1083,7 @@ function approvedRequirements(ctx, task) {
 }
 function claimRequirements(ctx, task) {
   if (task.type !== "build" && task.type !== "qa") return [];
-  if (task.role === "product-manager") return [];
-  return [...existRequirements(task), ...approvedRequirements(ctx, task)];
+  return [...existRequirements(ctx, task), ...approvedRequirements(ctx, task)];
 }
 function requirementSatisfied(ctx, req, matched) {
   if (req.level === "exist") return matched.length > 0;
@@ -1144,6 +1209,7 @@ var init_gates = __esm({
     init_derive();
     init_kind();
     init_lints();
+    init_roles();
   }
 });
 
@@ -1790,11 +1856,7 @@ var init_artifact_commands = __esm({
 import { existsSync as existsSync6 } from "node:fs";
 import { join as join7 } from "node:path";
 function ownerRole(ctx, kind) {
-  for (const [role, kinds] of Object.entries(ctx.config.roleProduces)) {
-    if (kinds.includes(kind)) return role;
-  }
-  if (kind === "code") return "developer";
-  return null;
+  return ownerRoleOf(ctx.config, kind);
 }
 function openReviewTargetKeys(ctx, artifactId) {
   const rows = ctx.db.prepare(
@@ -1938,15 +2000,20 @@ var init_sync_command = __esm({
     init_events();
     init_git();
     init_kind();
+    init_roles();
     init_artifact_commands();
   }
 });
 
 // core/commands/task.commands.ts
+function getRoleRegistryOwner(ctx, kind) {
+  return ownerRoleOf(ctx.config, kind) ?? "qa";
+}
 function createTask(ctx, p) {
   const type = p.type ?? "build";
   if (!VALID_TYPES.includes(type)) throw new Error(`\u65E0\u6548\u7684\u4EFB\u52A1\u7C7B\u578B: ${type},\u53EF\u9009\u503C: ${VALID_TYPES.join(", ")}`);
-  if (!VALID_ROLES.includes(p.role)) throw new Error(`\u65E0\u6548\u7684\u89D2\u8272: ${p.role},\u53EF\u9009\u503C: ${VALID_ROLES.join(", ")}`);
+  const validRoles = Object.keys(getRoleRegistry(ctx.config));
+  if (!validRoles.includes(p.role)) throw new Error(`\u65E0\u6548\u7684\u89D2\u8272: ${p.role},\u53EF\u9009\u503C: ${validRoles.join(", ")}`);
   const module = normalizeModule(p.module, ctx.config);
   const tx = ctx.db.transaction(() => {
     const result = ctx.db.prepare(
@@ -2041,11 +2108,12 @@ function updateTask(ctx, { id, status, operator, force = false }) {
   return { id, warnings };
 }
 function spawnFollowupQa(ctx, reworkTask) {
+  const qaRole = getRoleRegistryOwner(ctx, "acceptance");
   const tx = ctx.db.transaction(() => {
     const result = ctx.db.prepare(
       `INSERT INTO tasks (module, role, endpoint, page, type, status, assignee, creator, content)
-         VALUES (?, 'qa', ?, ?, 'qa', 'pending', 'qa', 'system', ?)`
-    ).run(reworkTask.module, reworkTask.endpoint, reworkTask.page, `[\u590D\u9A8C] rework #${reworkTask.id} \u5DF2\u5B8C\u6210,\u8BF7\u91CD\u65B0\u9A8C\u6536`);
+         VALUES (?, ?, ?, ?, 'qa', 'pending', ?, 'system', ?)`
+    ).run(reworkTask.module, qaRole, reworkTask.endpoint, reworkTask.page, qaRole, `[\u590D\u9A8C] rework #${reworkTask.id} \u5DF2\u5B8C\u6210,\u8BF7\u91CD\u65B0\u9A8C\u6536`);
     const qaId = result.lastInsertRowid;
     logEvent(ctx.db, {
       entityType: "task",
@@ -2205,7 +2273,7 @@ function getTaskDetail(ctx, id) {
   }
   return { task, events, outputs, staleness: taskStaleness(ctx.db, id) };
 }
-var VALID_STATUS, VALID_TYPES, VALID_ROLES;
+var VALID_STATUS, VALID_TYPES;
 var init_task_commands = __esm({
   "core/commands/task.commands.ts"() {
     "use strict";
@@ -2215,11 +2283,11 @@ var init_task_commands = __esm({
     init_git();
     init_gh();
     init_kind();
+    init_roles();
     init_artifact_commands();
     init_sync_command();
     VALID_STATUS = ["pending", "in_progress", "completed", "cancelled"];
     VALID_TYPES = ["build", "review", "qa", "hotfix", "baseline", "legacy", "rework"];
-    VALID_ROLES = ["product-manager", "architect", "designer", "developer", "qa"];
   }
 });
 
@@ -2742,7 +2810,8 @@ var init_scan_command = __esm({
 // core/commands/qa.command.ts
 function recordQaResult(ctx, p) {
   const task = getTaskRow(ctx, p.id);
-  if (task.role !== "qa") throw new Error(`\u4EFB\u52A1 #${p.id} \u4E0D\u662F qa \u4EFB\u52A1`);
+  const acceptanceRole = ownerRoleOf(ctx.config, "acceptance") ?? "qa";
+  if (task.role !== acceptanceRole) throw new Error(`\u4EFB\u52A1 #${p.id} \u4E0D\u662F ${acceptanceRole} \u4EFB\u52A1`);
   if (task.assignee !== p.operator) throw new Error(`\u53EA\u6709\u6267\u884C\u4EBA\u624D\u80FD\u8BB0\u5F55\u9A8C\u6536\u7ED3\u679C`);
   if (p.result === "fail" && !p.reason?.trim()) throw new Error(`\u9A8C\u6536\u4E0D\u901A\u8FC7\u5FC5\u987B\u9644\u539F\u56E0,\u5B83\u5C06\u6210\u4E3A rework \u4EFB\u52A1\u7684\u5185\u5BB9`);
   const eventName = p.result === "pass" ? "qa_passed" : "qa_failed";
@@ -2770,11 +2839,12 @@ function recordQaResult(ctx, p) {
     }
     return { reworkTaskId: null };
   }
+  const reworkRole = ownerRoleOf(ctx.config, "code") ?? "developer";
   const tx2 = ctx.db.transaction(() => {
     const result = ctx.db.prepare(
       `INSERT INTO tasks (module, role, endpoint, page, type, status, assignee, creator, content)
-         VALUES (?, 'developer', ?, ?, 'rework', 'pending', 'developer', 'system', ?)`
-    ).run(task.module, task.endpoint, task.page, `[\u8FD4\u5DE5] QA #${task.id} \u9A8C\u6536\u4E0D\u901A\u8FC7:${p.reason}`);
+         VALUES (?, ?, ?, ?, 'rework', 'pending', ?, 'system', ?)`
+    ).run(task.module, reworkRole, task.endpoint, task.page, reworkRole, `[\u8FD4\u5DE5] QA #${task.id} \u9A8C\u6536\u4E0D\u901A\u8FC7:${p.reason}`);
     const reworkId = result.lastInsertRowid;
     logEvent(ctx.db, {
       entityType: "task",
@@ -2794,6 +2864,7 @@ var init_qa_command = __esm({
   "core/commands/qa.command.ts"() {
     "use strict";
     init_events();
+    init_roles();
     init_artifact_commands();
     init_task_commands();
   }
@@ -3009,35 +3080,25 @@ function planModule(ctx, moduleRaw, creator = "product-manager") {
   }
   const pagePrds = byKind("page-prd").filter((a) => a.endpoint && a.page && existsSync10(join12(ctx.root, a.path)));
   const endpoints = [...new Set(pagePrds.map((a) => a.endpoint))];
-  const desired = [
-    { role: "architect", endpoint: "common", page: null, type: "build", assignee: "architect", content: `\u8BBE\u8BA1 ${module} \u6A21\u5757\u6570\u636E\u5E93` },
-    { role: "architect", endpoint: "service", page: null, type: "build", assignee: "architect", content: `\u8BBE\u8BA1 ${module} \u6A21\u5757 API \u6587\u6863` },
-    { role: "developer", endpoint: "service", page: null, type: "build", assignee: "developer", content: `\u5B9E\u73B0 ${module} \u6A21\u5757 service \u7AEF` }
-  ];
-  for (const endpoint of endpoints) {
-    const hasDesignSystem = artifacts.some((a) => a.kind === "design-system" && a.endpoint === endpoint);
-    if (!hasDesignSystem) {
-      desired.push({
-        role: "designer",
-        endpoint,
-        page: null,
-        type: "build",
-        assignee: "designer",
-        content: `\u5EFA\u7ACB ${endpoint} \u7AEF\u8BBE\u8BA1\u7CFB\u7EDF(\u8BE5\u7AEF\u9996\u4E2A\u9875\u9762\u8BBE\u8BA1\u524D\u7F6E)`
-      });
+  const registry = getRoleRegistry(ctx.config);
+  const interp = (tpl, v) => tpl.replaceAll("{module}", v.module).replaceAll("{endpoint}", v.endpoint ?? "").replaceAll("{page}", v.page ?? "");
+  const desired = [];
+  for (const role of ctx.config.pipeline) {
+    for (const d of registry[role]?.dispatch ?? []) {
+      if (d.at === "module") {
+        desired.push({ role, endpoint: d.endpoint ?? null, page: null, type: d.type ?? "build", assignee: role, content: interp(d.content, { module }) });
+      } else if (d.at === "endpoint") {
+        for (const endpoint of endpoints) {
+          if (d.ifMissingKind && artifacts.some((a) => a.kind === d.ifMissingKind && a.endpoint === endpoint)) continue;
+          desired.push({ role, endpoint, page: null, type: d.type ?? "build", assignee: role, content: interp(d.content, { module, endpoint }) });
+        }
+      } else {
+        for (const prd of pagePrds) {
+          desired.push({ role, endpoint: prd.endpoint, page: prd.page, type: d.type ?? "build", assignee: role, content: interp(d.content, { module, endpoint: prd.endpoint, page: prd.page }) });
+        }
+      }
     }
   }
-  for (const prd of pagePrds) {
-    desired.push(
-      { role: "designer", endpoint: prd.endpoint, page: prd.page, type: "build", assignee: "designer", content: `\u8BBE\u8BA1 ${prd.endpoint}/${prd.page} \u9875\u9762(\u63D0\u793A\u8BCD+\u539F\u578B)` },
-      { role: "developer", endpoint: prd.endpoint, page: prd.page, type: "build", assignee: "developer", content: `\u5B9E\u73B0 ${prd.endpoint}/${prd.page} \u9875\u9762` },
-      { role: "qa", endpoint: prd.endpoint, page: prd.page, type: "qa", assignee: "qa", content: `\u9A8C\u6536 ${prd.endpoint}/${prd.page} \u9875\u9762` }
-    );
-  }
-  const activeRoles = new Set(ctx.config.pipeline);
-  const filtered = desired.filter((d) => activeRoles.has(d.role));
-  desired.length = 0;
-  desired.push(...filtered);
   const exists = ctx.db.prepare(
     `SELECT COUNT(*) AS c FROM tasks
      WHERE module IS ? AND role = ? AND endpoint IS ? AND page IS ? AND type = ? AND status != 'cancelled'`
@@ -3082,6 +3143,7 @@ var init_plan_command = __esm({
     init_derive();
     init_events();
     init_kind();
+    init_roles();
     init_task_commands();
   }
 });
@@ -3132,7 +3194,7 @@ var init_install_hooks_command = __esm({
 });
 
 // core/commands/gen-agents.command.ts
-import { existsSync as existsSync12, mkdirSync as mkdirSync6, readFileSync as readFileSync6, readdirSync as readdirSync5, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync12, mkdirSync as mkdirSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "node:fs";
 import { dirname as dirname3, join as join14 } from "node:path";
 function expandPath(ctx, kind) {
   const spec = getKindRegistry(ctx.config)[kind];
@@ -3178,6 +3240,16 @@ function genAgents(ctx, templatesDir) {
     PATH_DESIGN_PROMPTS: expandPath(ctx, "design-prompt"),
     PATH_PROTOTYPES: expandPath(ctx, "prototype"),
     PATH_ACCEPTANCE: expandPath(ctx, "acceptance"),
+    // 路径投影:完整路径模板由 kind 注册表(前缀+coords 文法+ext)推导——
+    // 项目覆盖 coords 后重跑 gen-agents,agent 指示与 scan 解析自动同步(单一真相源)
+    TPL_FLOW: kindPathTemplate(ctx.config, "flow", lang) ?? "",
+    TPL_MODULE_PRD: kindPathTemplate(ctx.config, "module-prd", lang) ?? "",
+    TPL_PAGE_PRD: kindPathTemplate(ctx.config, "page-prd", lang) ?? "",
+    TPL_DB_DOC: kindPathTemplate(ctx.config, "db-doc", lang) ?? "",
+    TPL_DESIGN_SYSTEM: kindPathTemplate(ctx.config, "design-system", lang) ?? "",
+    TPL_DESIGN_PROMPT: kindPathTemplate(ctx.config, "design-prompt", lang) ?? "",
+    TPL_PROTOTYPE: kindPathTemplate(ctx.config, "prototype", lang) ?? "",
+    TPL_ACCEPTANCE: kindPathTemplate(ctx.config, "acceptance", lang) ?? "",
     ENDPOINTS: ctx.config.endpoints.join(" / "),
     PIPELINE: ctx.config.pipeline.join(" \u2192 "),
     CODE_ROOTS: ctx.config.endpoints.map((e) => `| ${e} | ${(ctx.config.codeRoots[e] ?? []).join(blocks.sep) || blocks.todo} |`).join("\n")
@@ -3191,13 +3263,19 @@ function genAgents(ctx, templatesDir) {
     return content;
   };
   const adapters = resolvePlatforms(ctx.config.platforms);
-  const pipeline = new Set(ctx.config.pipeline);
+  const registry = getRoleRegistry(ctx.config);
   const written = [];
-  for (const file of readdirSync5(dir)) {
-    if (!file.endsWith(".md")) continue;
-    const role = file.replace(/\.md$/, "");
-    if (!pipeline.has(role)) continue;
-    const tpl = parseTemplate(readFileSync6(join14(dir, file), "utf-8"));
+  const projectTplDir = join14(ctx.root, "docs/workbench/templates/agents", lang);
+  for (const role of [...new Set(ctx.config.pipeline)]) {
+    if (!registry[role]) {
+      throw new Error(`pipeline \u89D2\u8272 ${role} \u672A\u5728\u89D2\u8272\u6CE8\u518C\u8868\u4E2D\u5B9A\u4E49(\u5185\u7F6E\u6216 config.roles)`);
+    }
+    const candidates = [join14(projectTplDir, `${role}.md`), join14(dir, `${role}.md`)];
+    const file = candidates.find((f) => existsSync12(f));
+    if (!file) {
+      throw new Error(`\u89D2\u8272 ${role} \u7F3A\u5C11 agent \u6A21\u677F:\u81EA\u5B9A\u4E49\u89D2\u8272\u8BF7\u63D0\u4F9B docs/workbench/templates/agents/${lang}/${role}.md`);
+    }
+    const tpl = parseTemplate(readFileSync6(file, "utf-8"));
     for (const adapter of adapters) {
       const memory = adapter.memoryBlock(role, lang);
       const spec = {
@@ -3222,6 +3300,7 @@ var init_gen_agents_command = __esm({
     "use strict";
     init_config();
     init_kind();
+    init_roles();
     init_platforms();
     TRUST_PROTOCOL_ZH = `## \u4FE1\u4EFB\u534F\u8BAE(\u6700\u9AD8\u4F18\u5148\u7EA7)
 
@@ -3345,11 +3424,13 @@ function intakeIssues(ctx) {
       continue;
     }
     const isBug = issue.labels.some((l) => l.name.toLowerCase() === "bug");
+    const bugRole = ctx.config.intake?.bugRole ?? "developer";
+    const defaultRole = ctx.config.intake?.defaultRole ?? "product-manager";
     const id = createTask(ctx, {
-      role: isBug ? "developer" : "product-manager",
-      endpoint: isBug ? null : null,
+      role: isBug ? bugRole : defaultRole,
+      endpoint: null,
       type: isBug ? "hotfix" : "build",
-      assignee: isBug ? "developer" : "product-manager",
+      assignee: isBug ? bugRole : defaultRole,
       creator: "intake",
       content: `[gh#${issue.number}] ${issue.title}
 ${issue.url}`,
@@ -3533,6 +3614,7 @@ __export(core_exports, {
   CONFIG_FILENAME: () => CONFIG_FILENAME,
   CURRENT_SCHEMA_VERSION: () => CURRENT_SCHEMA_VERSION,
   DEFAULT_KIND_REGISTRY: () => DEFAULT_KIND_REGISTRY,
+  DEFAULT_ROLE_REGISTRY: () => DEFAULT_ROLE_REGISTRY,
   KIND_TIERS: () => KIND_TIERS,
   META_KINDS: () => META_KINDS,
   MIGRATIONS: () => MIGRATIONS,
@@ -3566,6 +3648,7 @@ __export(core_exports, {
   genAgents: () => genAgents,
   getAdapter: () => getAdapter,
   getKindRegistry: () => getKindRegistry,
+  getRoleRegistry: () => getRoleRegistry,
   getTaskDetail: () => getTaskDetail,
   getTaskRow: () => getTaskRow,
   gitHead: () => gitHead,
@@ -3578,6 +3661,7 @@ __export(core_exports, {
   initProject: () => initProject,
   installGitHooks: () => installGitHooks,
   intakeIssues: () => intakeIssues,
+  kindPathTemplate: () => kindPathTemplate,
   kindSpec: () => kindSpec,
   listArtifacts: () => listArtifacts,
   listEvents: () => listEvents,
@@ -3593,6 +3677,7 @@ __export(core_exports, {
   openWorkbench: () => openWorkbench,
   openWorkbenchAt: () => openWorkbenchAt,
   ownerRole: () => ownerRole,
+  ownerRoleOf: () => ownerRoleOf,
   planModule: () => planModule,
   prototypeEndorsed: () => prototypeEndorsed,
   recordNote: () => recordNote,
@@ -3630,6 +3715,7 @@ var init_core = __esm({
     init_hash();
     init_events();
     init_kind();
+    init_roles();
     init_platforms();
     init_derive();
     init_lints();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawipong/opcflow",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Spec-anchored, drift-enforced execution layer for AI coding agents — artifact DAG, trust gates, multi-role pipeline; generates agents/MCP/hooks for Claude Code, Codex, OpenCode & Cursor.",
   "license": "MIT",
   "author": "Dawi",

package/templates/agents/en/architect.md

@@ -29,7 +29,7 @@ tech selection (language / framework / ORM / build), directory structure per end
 | Artifact | Path |
 | --- | --- |
 | Database model definition | Per approved TECH.md conventions (path/tech set by the baseline) |
-| Database docs | {{PATH_DB_DOCS}}{module}.md |
+| Database docs | {{TPL_DB_DOC}} |
 | API contract docs | {{PATH_API_DOCS}}{endpoint}/{module}.md (cross-endpoint shared goes in common/) |
 | Technical baseline (changes go through review) | ARCHITECTURE.md / TECH.md |
 

package/templates/agents/en/designer.md

@@ -21,9 +21,9 @@ You are @designer. Each of your three artifacts travels a different trust channe
 
 | Artifact | Path | Trust channel |
 | --- | --- | --- |
-| Design system (one per endpoint) | {{PATH_DESIGN_SYSTEMS}}{endpoint}.md | **Human approval** (endpoint-level contract; one change makes every prototype for that endpoint stale) |
-| Page design prompt | {{PATH_DESIGN_PROMPTS}}{endpoint}/{module}/{page}.md | Register only (working draft, not submitted) |
-| HTML prototype | {{PATH_PROTOTYPES}}{endpoint}/{module}/{page}.html | **👍 = feedback + approval in one** (user releases after previewing in opcflow) |
+| Design system (one per endpoint) | {{TPL_DESIGN_SYSTEM}} | **Human approval** (endpoint-level contract; one change makes every prototype for that endpoint stale) |
+| Page design prompt | {{TPL_DESIGN_PROMPT}} | Register only (working draft, not submitted) |
+| HTML prototype | {{TPL_PROTOTYPE}} | **👍 = feedback + approval in one** (user releases after previewing in opcflow) |
 
 ## Workflow (page task)
 
@@ -37,7 +37,7 @@ You are @designer. Each of your three artifacts travels a different trust channe
 
 ## Endpoint Design-System Task (once per endpoint)
 
-Write to {{PATH_DESIGN_SYSTEMS}}{endpoint}.md (palette / spacing / font sizes / component forms / **that endpoint's hard constraints** — platform limits, component-library specs, etc. are all legislated here) → register → **submit for review**.
+Write to {{TPL_DESIGN_SYSTEM}} (palette / spacing / font sizes / component forms / **that endpoint's hard constraints** — platform limits, component-library specs, etc. are all legislated here) → register → **submit for review**.
 For endpoints that already have prototypes or production pages, **reverse-engineer** from the established facts (legislate, don't design from scratch); for a brand-new endpoint, propose an initial version from the approved baseline (the UI stack in TECH.md) and the project's positioning.
 
 ## Red Flags

package/templates/agents/en/developer.md

@@ -22,10 +22,10 @@ You are @developer. **Approved contract = implement directly, zero divergence**
 | Input | Path |
 | --- | --- |
 | Technical baseline (selection/directories/protocol conventions) | ARCHITECTURE.md / TECH.md |
-| Page PRD (incl. acceptance points) | {{PATH_PAGES}}{endpoint}/{module}/{page}.md |
+| Page PRD (incl. acceptance points) | {{TPL_PAGE_PRD}} |
 | API contract | {{PATH_API_DOCS}}{endpoint}/{module}.md |
-| DB docs | {{PATH_DB_DOCS}}{module}.md |
-| 👍-approved prototype (UI truth) | {{PATH_PROTOTYPES}}{endpoint}/{module}/{page}.html |
+| DB docs | {{TPL_DB_DOC}} |
+| 👍-approved prototype (UI truth) | {{TPL_PROTOTYPE}} |
 
 ## Code Directory Conventions (config-injected; follow when building code)
 

package/templates/agents/en/product-manager.md

@@ -25,9 +25,9 @@ You are @product-manager. Responsibility: translate requirements into **layer-by
 | Project overview | {{PATH_PROJECT}} | Project-level contract |
 | Role permission matrix | {{PATH_ROLES}} | Project-level contract |
 | Domain glossary | {{PATH_GLOSSARY}} | Project-level contract |
-| Business flow + entity state machine | {{PATH_FLOWS}}{module}.md | Module-level contract |
-| Module PRD | {{PATH_MODULES}}{module}.md | Module-level contract |
-| Page PRD | {{PATH_PAGES}}{endpoint}/{module}/{page}.md | Page-level contract |
+| Business flow + entity state machine | {{TPL_FLOW}} | Module-level contract |
+| Module PRD | {{TPL_MODULE_PRD}} | Module-level contract |
+| Page PRD | {{TPL_PAGE_PRD}} | Page-level contract |
 
 ## Core Discipline: Layer-by-Layer Confirmation
 

package/templates/agents/en/qa.md

@@ -20,7 +20,7 @@ You are @qa. **Judgment authority belongs to PM (acceptance points), execution a
 ## Two-Phase Acceptance
 
 **Phase one (before or after developer starts): translate acceptance criteria**
-Read the "acceptance points" section of the approved page PRD → translate into executable cases, write to {{PATH_ACCEPTANCE}}{endpoint}/{module}/{page}.md → register output → **submit for review** (it's a contract; developer writes against it).
+Read the "acceptance points" section of the approved page PRD → translate into executable cases, write to {{TPL_ACCEPTANCE}} → register output → **submit for review** (it's a contract; developer writes against it).
 When a point is ambiguous: **dispute or send back to PM**, do not fill in the wording yourself.
 
 **Phase two (after developer finishes): execute acceptance**

package/templates/agents/zh/architect.md

@@ -29,7 +29,7 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 | 产物 | 路径 |
 | --- | --- |
 | 数据库模型定义 | 按 approved TECH.md 的约定(路径/技术随基线定) |
-| 数据库文档 | {{PATH_DB_DOCS}}{模块}.md |
+| 数据库文档 | {{TPL_DB_DOC}} |
 | API 契约文档 | {{PATH_API_DOCS}}{端}/{模块}.md(跨端共用放 common/) |
 | 技术基线(变更走审批) | ARCHITECTURE.md / TECH.md |
 

package/templates/agents/zh/designer.md

@@ -21,9 +21,9 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 
 | 产物 | 路径 | 信任通道 |
 | --- | --- | --- |
-| 设计系统(每端一份) | {{PATH_DESIGN_SYSTEMS}}{端}.md | **人工审批**(端级契约,改一次全端原型 stale) |
-| 页面设计提示词 | {{PATH_DESIGN_PROMPTS}}{端}/{模块}/{页面}.md | 仅登记(工作底稿,不送审) |
-| HTML 原型 | {{PATH_PROTOTYPES}}{端}/{模块}/{页面}.html | **👍 = 反馈+审批合一**(用户在 opcflow 预览后放行) |
+| 设计系统(每端一份) | {{TPL_DESIGN_SYSTEM}} | **人工审批**(端级契约,改一次全端原型 stale) |
+| 页面设计提示词 | {{TPL_DESIGN_PROMPT}} | 仅登记(工作底稿,不送审) |
+| HTML 原型 | {{TPL_PROTOTYPE}} | **👍 = 反馈+审批合一**(用户在 opcflow 预览后放行) |
 
 ## 工作流程(页面任务)
 
@@ -37,7 +37,7 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 
 ## 端设计系统任务(每端一次)
 
-写入 {{PATH_DESIGN_SYSTEMS}}{端}.md(色板/间距/字号/组件形态/**该端硬约束**——平台限制、组件库规范等都在此立法)→ 登记 → **submit 送审**。
+写入 {{TPL_DESIGN_SYSTEM}}(色板/间距/字号/组件形态/**该端硬约束**——平台限制、组件库规范等都在此立法)→ 登记 → **submit 送审**。
 已有原型或生产页面的端,从既成事实**反向提炼**(立法,不凭空设计);全新的端,依据 approved 基线(TECH.md 的 UI 栈)与项目定位提出初版。
 
 ## Red Flags

package/templates/agents/zh/developer.md

@@ -22,10 +22,10 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 | 输入 | 路径 |
 | --- | --- |
 | 技术基线(选型/目录/协议约定) | ARCHITECTURE.md / TECH.md |
-| 页面 PRD(含验收要点) | {{PATH_PAGES}}{端}/{模块}/{页面}.md |
+| 页面 PRD(含验收要点) | {{TPL_PAGE_PRD}} |
 | API 契约 | {{PATH_API_DOCS}}{端}/{模块}.md |
-| DB 文档 | {{PATH_DB_DOCS}}{模块}.md |
-| 已 👍 原型(UI 真相) | {{PATH_PROTOTYPES}}{端}/{模块}/{页面}.html |
+| DB 文档 | {{TPL_DB_DOC}} |
+| 已 👍 原型(UI 真相) | {{TPL_PROTOTYPE}} |
 
 ## 代码目录约定(config 注入,建代码时遵守)
 

package/templates/agents/zh/product-manager.md

@@ -25,9 +25,9 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 | 项目全景 | {{PATH_PROJECT}} | 项目级契约 |
 | 角色权限矩阵 | {{PATH_ROLES}} | 项目级契约 |
 | 领域术语表 | {{PATH_GLOSSARY}} | 项目级契约 |
-| 业务流程+实体状态机 | {{PATH_FLOWS}}{模块}.md | 模块级契约 |
-| 模块 PRD | {{PATH_MODULES}}{模块}.md | 模块级契约 |
-| 页面 PRD | {{PATH_PAGES}}{端}/{模块}/{页面}.md | 页面级契约 |
+| 业务流程+实体状态机 | {{TPL_FLOW}} | 模块级契约 |
+| 模块 PRD | {{TPL_MODULE_PRD}} | 模块级契约 |
+| 页面 PRD | {{TPL_PAGE_PRD}} | 页面级契约 |
 
 ## 核心纪律:逐层确认制
 

package/templates/agents/zh/qa.md

@@ -20,7 +20,7 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 ## 两段式验收
 
 **第一段(developer 开工前后皆可):翻译验收标准**
-读 approved 页面 PRD 的"验收要点"章节 → 翻译成可执行用例,写入 {{PATH_ACCEPTANCE}}{端}/{模块}/{页面}.md → output 登记 → **submit 送审**(它是契约,developer 对着它写)。
+读 approved 页面 PRD 的"验收要点"章节 → 翻译成可执行用例,写入 {{TPL_ACCEPTANCE}} → output 登记 → **submit 送审**(它是契约,developer 对着它写)。
 遇到要点含混:**dispute 或退回 PM**,禁止自行脑补口径。
 
 **第二段(developer 完成后):执行验收**