@dawipong/opcflow 0.8.0 → 0.10.0

package/README.en.md

@@ -174,7 +174,7 @@ Generated by `init`, hand-edited afterwards — each project's coordinate system
 mermaid / HTML-prototype iframe / code rendering, the **review-queue diff** (approved version vs.
 current), the **artifact relation graph** (derived edges + manually declared edges: drag to connect,
 manual edges unbindable, derived edges reconciled by scan; manual edges join invalidation propagation),
-an event timeline, and live SSE refresh. Approve, reject, and thumbs-up/down prototypes right
+an event timeline, and live SSE refresh. Set your **actor identity** in the header (when a team shares one workbench, approvals/feedback/edges are attributed per actor). Approve, reject, and thumbs-up/down prototypes right
 here.
 
 ## Scripts

package/README.md

@@ -161,7 +161,7 @@ flowchart LR
 `opcflow serve` 起在 `http://127.0.0.1:5620`:artifact 树(状态实时变色)、markdown / mermaid / HTML 原型
 iframe / 代码渲染、**待审队列 diff**(approved 版本 vs 当前)、**产出物关系图**(自动推导边 + 手动声明边:
 画布上拖线即声明、手动边可解绑、推导边由 scan 对账维护;手动边同样参与失效传播)、事件时间线、
-SSE 实时刷新。审批、打回、给原型 👍👎 都在这里点。
+SSE 实时刷新。审批、打回、给原型 👍👎 都在这里点;头部可设置**操作人身份**(多人共用一个工作台时,审批/反馈/建边按 actor 区分留痕)。
 
 ## 脚本
 

package/dist/cli.mjs

@@ -506,6 +506,9 @@ var init_platforms = __esm({
       agentsDir: ".claude/agents",
       skillsDir: ".claude/skills",
       hooksScanDir: ".claude/hooks",
+      rulesDir: null,
+      // 规则载体是 CLAUDE.md(手改大文件,刻意不追)
+      memoryDir: ".claude/agent-memory",
       defaultModel: "opus",
       memoryBlock: (role, lang) => claudeMemory(role, lang),
       projectDirEnvVar: "CLAUDE_PROJECT_DIR",
@@ -555,6 +558,9 @@ var init_platforms = __esm({
       agentsDir: ".codex/agents",
       skillsDir: ".agents/skills",
       hooksScanDir: null,
+      rulesDir: null,
+      // 规则/记忆载体都是 AGENTS.md(手改大文件,刻意不追)
+      memoryDir: null,
       defaultModel: "gpt-5.1-codex",
       memoryBlock: (_role, lang) => agentsMdMemory("Codex", lang),
       projectDirEnvVar: "CODEX_PROJECT_DIR",
@@ -601,6 +607,9 @@ var init_platforms = __esm({
       agentsDir: ".opencode/agents",
       skillsDir: ".opencode/skills",
       hooksScanDir: null,
+      rulesDir: null,
+      // 同 codex:AGENTS.md 承载,不追
+      memoryDir: null,
       defaultModel: "anthropic/claude-opus-4-8",
       memoryBlock: (_role, lang) => agentsMdMemory("OpenCode", lang),
       projectDirEnvVar: "OPENCODE_PROJECT_DIR",
@@ -675,6 +684,9 @@ export const opcflow = async () => ({
       agentsDir: ".cursor/agents",
       skillsDir: ".cursor/skills",
       hooksScanDir: null,
+      rulesDir: ".cursor/rules",
+      memoryDir: null,
+      // Cursor 原生 Memories 非文件形态,无法登记跟踪
       defaultModel: "claude-opus-4-8",
       memoryBlock: (_role, lang) => cursorMemory(lang),
       projectDirEnvVar: "CURSOR_PROJECT_DIR",
@@ -755,6 +767,14 @@ function getKindRegistry(config) {
     ...merged["hook-script"],
     pathPatterns: uniq(adapters.map((a) => a.hooksScanDir).filter((d) => !!d).map((d) => `${d}/`))
   };
+  merged.rule = {
+    ...merged.rule,
+    pathPatterns: uniq(adapters.map((a) => a.rulesDir).filter((d) => !!d).map((d) => `${d}/`))
+  };
+  merged.memory = {
+    ...merged.memory,
+    pathPatterns: uniq(adapters.map((a) => a.memoryDir).filter((d) => !!d).map((d) => `${d}/`))
+  };
   return merged;
 }
 function kindSpec(config, kind) {
@@ -803,6 +823,10 @@ var init_kind = __esm({
       skill: { level: "project", approval: "human", parents: [], drivesStale: false, hashMode: "text-normalize", retrieval: "full", meta: true, pathPatterns: [".claude/skills/"] },
       "hook-script": { level: "project", approval: "human", parents: [], drivesStale: false, hashMode: "text-normalize", retrieval: "full", meta: true, pathPatterns: [".claude/hooks/"] },
       plan: { level: "project", approval: "human", parents: [], drivesStale: false, hashMode: "text-normalize", retrieval: "summary", meta: true, pathPatterns: ["docs/workbench/PLAN.md"] },
+      // 规则/记忆:平台原生读取生效的内容(approval:none——opcflow 只登记+跟踪变更进 draft,不设审卡);
+      // pathPatterns 按目标平台的 rulesDir/memoryDir 动态展开(getKindRegistry),仅目录文件形态可追
+      rule: { level: "project", approval: "none", parents: [], drivesStale: false, hashMode: "text-normalize", retrieval: "full", meta: true },
+      memory: { level: "project", approval: "none", parents: [], drivesStale: false, hashMode: "text-normalize", retrieval: "summary", meta: true },
       baseline: { level: "project", approval: "human", parents: [], drivesStale: true, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["ARCHITECTURE.md", "TECH.md"] },
       project: { level: "project", approval: "human", parents: [], drivesStale: true, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{prd}/project.md"] },
       roles: { level: "project", approval: "human", parents: ["project"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/roles.md"] },
@@ -863,7 +887,8 @@ var init_roles = __esm({
     init_kind();
     DEFAULT_ROLE_REGISTRY = {
       "product-manager": {
-        produces: ["project", "roles", "glossary", "flow", "module-prd", "page-prd"]
+        produces: ["project", "roles", "glossary", "flow", "module-prd", "page-prd"],
+        completeWithoutClaim: true
       },
       architect: {
         produces: ["db-doc", "api-doc"],
@@ -1144,7 +1169,7 @@ function completeOutputRequirement(ctx, task) {
 function validateComplete(ctx, task, status, opts = {}) {
   const warnings = [];
   if (status !== "completed") return { warnings, inputs: [] };
-  if (task.role !== "product-manager" && task.assignee === null) {
+  if (task.assignee === null && !getRoleRegistry(ctx.config)[task.role]?.completeWithoutClaim) {
     throw new Error(`\u4EFB\u52A1\u5C1A\u672A\u88AB\u9886\u53D6,\u65E0\u6CD5\u66F4\u65B0\u72B6\u6001`);
   }
   if (task.type === "legacy") return { warnings, inputs: [] };
@@ -2078,6 +2103,9 @@ function updateTask(ctx, { id, status, operator, force = false }) {
   if (task.assignee !== null && task.assignee !== operator) {
     throw new Error(`\u53EA\u6709\u6267\u884C\u4EBA\u624D\u80FD\u66F4\u65B0\u4EFB\u52A1\u72B6\u6001`);
   }
+  if (task.assignee === null && operator !== task.role && operator !== task.creator) {
+    throw new Error(`\u672A\u9886\u53D6\u7684\u4EFB\u52A1\u4EC5\u521B\u5EFA\u8005\u6216\u89D2\u8272\u672C\u4EBA\u53EF\u66F4\u65B0\u72B6\u6001`);
+  }
   const { warnings } = validateComplete(ctx, task, status, { force });
   let followupQaId = null;
   const tx = ctx.db.transaction(() => {
@@ -2460,6 +2488,8 @@ function metaSources(config) {
     add({ dir: a.agentsDir, filter: (n) => n.endsWith(".md") || n.endsWith(".toml") });
     add({ dir: a.skillsDir, filter: (n) => n === "SKILL.md", recursive: true });
     if (a.hooksScanDir) add({ dir: a.hooksScanDir, recursive: true });
+    if (a.rulesDir) add({ dir: a.rulesDir, filter: (n) => n.endsWith(".md") || n.endsWith(".mdc"), recursive: true });
+    if (a.memoryDir) add({ dir: a.memoryDir, filter: (n) => n.endsWith(".md"), recursive: true });
   }
   add({ dir: "docs/workbench", filter: (n) => n === "PLAN.md" });
   return sources;
@@ -2840,6 +2870,9 @@ function recordQaResult(ctx, p) {
     return { reworkTaskId: null };
   }
   const reworkRole = ownerRoleOf(ctx.config, "code") ?? "developer";
+  if (getRoleRegistry(ctx.config)[reworkRole]?.onQaFail !== "rework") {
+    return { reworkTaskId: null };
+  }
   const tx2 = ctx.db.transaction(() => {
     const result = ctx.db.prepare(
       `INSERT INTO tasks (module, role, endpoint, page, type, status, assignee, creator, content)
@@ -3914,13 +3947,25 @@ function guardedAbsPath(ctx, artifact, rel) {
 async function createServer(ctx) {
   const app = Fastify({ logger: false });
   await app.register(fastifyCors, { origin: true });
+  const authToken = ctx.config.server?.authToken;
+  if (authToken) {
+    app.addHook("preHandler", async (req, reply) => {
+      if (req.method === "GET" || req.method === "HEAD" || req.method === "OPTIONS") return;
+      if (req.headers["x-workbench-token"] !== authToken) {
+        return reply.code(401).send({ error: "\u7F3A\u5C11\u6216\u9519\u8BEF\u7684 x-workbench-token(\u8BE5\u5DE5\u4F5C\u53F0\u5DF2\u542F\u7528\u5199\u4FDD\u62A4)" });
+      }
+    });
+  }
   const webDist = join17(WORKBENCH_DIR, "web/dist");
   if (existsSync15(webDist)) {
     await app.register(fastifyStatic, { root: webDist });
   }
-  const protoRoot = join17(ctx.root, ctx.config.docs.design, "prototypes");
+  const protoPattern = getKindRegistry(ctx.config).prototype.pathPatterns?.[0];
+  const protoRel = (protoPattern ? expandPattern(protoPattern, ctx.config) : `${ctx.config.docs.design}/prototypes/`).replace(/\/+$/, "");
+  const protoRoot = join17(ctx.root, protoRel);
   mkdirSync8(protoRoot, { recursive: true });
   await app.register(fastifyStatic, { root: protoRoot, prefix: "/proto/", decorateReply: false });
+  const previewUrlOf = (a) => a.path.startsWith(protoRel + "/") ? encodeURI(`/proto/${a.path.slice(protoRel.length + 1)}`) : null;
   app.get("/api/meta", async () => ({
     root: ctx.root,
     language: ctx.config.language,
@@ -3960,7 +4005,7 @@ async function createServer(ctx) {
     } else if (statSync6(abs).size <= MAX_INLINE_SIZE) {
       content = readFileSync8(abs, "utf-8");
     }
-    return { artifact, content, isDirectory, missing, feedback, events };
+    return { artifact, content, isDirectory, missing, feedback, events, previewUrl: previewUrlOf(artifact) };
   });
   app.get("/api/artifact/:id/files", async (req) => {
     const artifact = getArtifact(ctx, parseInt(req.params.id));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawipong/opcflow",
-  "version": "0.8.0",
+  "version": "0.10.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/web/dist/assets/{abnfDiagram-VRR7QNED-Cwj4KBKb.js → abnfDiagram-VRR7QNED-CnWTNSpE.js}

@@ -1 +1 @@
-import{E as e}from"./src-Bp5IDfvJ.js";import{n as t}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./chunk-WYO6CB5R-C0vPAP7X.js";import"./index-Cf-76g9P.js";import{m as n,t as r}from"./mermaid-parser.core-CICKlqAN.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-BrFLYoih.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";var c=n().RailroadAbnf.parser.LangiumParser,l=t(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=t(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=t(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=t(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=t(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=t(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=t(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:t(t=>{o.clear(),e.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(t);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new r(n);let i=n.value;e.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),e.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
+import{E as e}from"./src-Bp5IDfvJ.js";import{n as t}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./chunk-WYO6CB5R-C0vPAP7X.js";import"./index-Bqp1_f-s.js";import{m as n,t as r}from"./mermaid-parser.core-CICKlqAN.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-kgvZO8mh.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";var c=n().RailroadAbnf.parser.LangiumParser,l=t(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=t(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=t(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=t(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=t(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=t(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=t(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:t(t=>{o.clear(),e.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(t);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new r(n);let i=n.value;e.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),e.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};