@dawipong/opcflow 0.7.0 → 0.8.0

package/dist/cli.mjs

@@ -837,6 +837,71 @@ var init_kind = __esm({
   }
 });
 
+// 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" }]
+      }
+    };
+  }
+});
+
 // core/derive.ts
 var derive_exports = {};
 __export(derive_exports, {
@@ -974,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);
@@ -1027,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;
@@ -1154,6 +1209,7 @@ var init_gates = __esm({
     init_derive();
     init_kind();
     init_lints();
+    init_roles();
   }
 });
 
@@ -1800,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(
@@ -1948,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(
@@ -2051,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",
@@ -2215,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";
@@ -2225,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"];
   }
 });
 
@@ -2752,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";
@@ -2780,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",
@@ -2804,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();
   }
@@ -3019,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'`
@@ -3092,6 +3143,7 @@ var init_plan_command = __esm({
     init_derive();
     init_events();
     init_kind();
+    init_roles();
     init_task_commands();
   }
 });
@@ -3142,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];
@@ -3211,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 = {
@@ -3242,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)
 
@@ -3365,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}`,
@@ -3553,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,
@@ -3586,6 +3648,7 @@ __export(core_exports, {
   genAgents: () => genAgents,
   getAdapter: () => getAdapter,
   getKindRegistry: () => getKindRegistry,
+  getRoleRegistry: () => getRoleRegistry,
   getTaskDetail: () => getTaskDetail,
   getTaskRow: () => getTaskRow,
   gitHead: () => gitHead,
@@ -3614,6 +3677,7 @@ __export(core_exports, {
   openWorkbench: () => openWorkbench,
   openWorkbenchAt: () => openWorkbenchAt,
   ownerRole: () => ownerRole,
+  ownerRoleOf: () => ownerRoleOf,
   planModule: () => planModule,
   prototypeEndorsed: () => prototypeEndorsed,
   recordNote: () => recordNote,
@@ -3651,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.7.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",