@dawipong/opcflow 0.3.0 → 0.4.0

package/dist/cli.mjs

@@ -690,6 +690,7 @@ __export(kind_exports, {
   META_KINDS: () => META_KINDS,
   PM_KINDS: () => PM_KINDS,
   contractKinds: () => contractKinds,
+  expandPattern: () => expandPattern,
   getKindRegistry: () => getKindRegistry,
   inferKind: () => inferKind,
   kindSpec: () => kindSpec,
@@ -755,15 +756,15 @@ var init_kind = __esm({
       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"] },
       glossary: { level: "project", approval: "human", parents: ["project"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/glossary.md"] },
-      flow: { level: "module", approval: "human", parents: ["project", "roles", "glossary"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/flows/"] },
-      "module-prd": { level: "module", approval: "human", parents: ["flow"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/modules/"] },
-      "page-prd": { level: "page", approval: "human", parents: ["module-prd"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/pages/"] },
-      "db-doc": { level: "module", approval: "human", parents: ["module-prd"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{architecture}/database/"] },
-      "api-doc": { level: "module", approval: "human", parents: ["module-prd", "db-doc"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{architecture}/api/"] },
-      "design-system": { level: "endpoint", approval: "human", parents: ["baseline"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{design}/systems/"] },
-      "design-prompt": { level: "page", approval: "none", parents: ["page-prd", "api-doc", "design-system"], drivesStale: false, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prompts/"] },
-      prototype: { level: "page", approval: "thumbs", parents: ["design-prompt", "design-system"], drivesStale: true, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prototypes/"] },
-      acceptance: { level: "page", approval: "human", parents: ["page-prd", "prototype"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{acceptance}/"] },
+      flow: { level: "module", approval: "human", parents: ["project", "roles", "glossary"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/flows/"], coords: "{module}", defaultEndpoint: "common" },
+      "module-prd": { level: "module", approval: "human", parents: ["flow"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/modules/"], coords: "{module}", defaultEndpoint: "common" },
+      "page-prd": { level: "page", approval: "human", parents: ["module-prd"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{prd}/pages/"], coords: "{endpoint}/{module}/{page}" },
+      "db-doc": { level: "module", approval: "human", parents: ["module-prd"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{architecture}/database/"], coords: "{module}", defaultEndpoint: "common" },
+      "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}" },
+      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" }
     };
@@ -2412,31 +2413,37 @@ import { existsSync as existsSync9, readdirSync as readdirSync4, statSync as sta
 import { join as join10 } from "node:path";
 function parseCoords(ctx, kind, relPath) {
   const none = { module: null, endpoint: null, page: null };
-  const base = (p) => p.split("/").pop().replace(/\.(md|html)$/i, "");
-  const seg = relPath.split("/");
+  const spec = getKindRegistry(ctx.config)[kind];
+  const grammar = spec?.coords;
+  if (!grammar) return none;
+  const prefix = spec.pathPatterns?.[0] ? expandPattern(spec.pathPatterns[0], ctx.config) : "";
+  const tail = relPath.startsWith(prefix) ? relPath.slice(prefix.length) : relPath;
+  const tailSegs = tail.split("/").filter(Boolean);
+  const gSegs = grammar.split("/");
+  const defEnd = spec.defaultEndpoint ?? null;
   const mod = (raw) => normalizeModule(raw, ctx.config);
-  switch (kind) {
-    case "flow":
-    case "module-prd":
-      return { module: mod(base(relPath)), endpoint: "common", page: null };
-    case "db-doc":
-      return { module: mod(base(relPath)), endpoint: "common", page: null };
-    case "api-doc":
-      return { module: mod(base(relPath)), endpoint: "service", page: null };
-    case "design-system":
-      return { module: null, endpoint: base(relPath), page: null };
-    case "page-prd":
-    case "design-prompt":
-    case "prototype":
-    case "acceptance": {
-      if (seg.length < 3) return none;
-      const endpoint = seg[seg.length - 3];
-      const module = mod(seg[seg.length - 2]);
-      return { module, endpoint, page: `${module}/${base(relPath)}` };
-    }
-    default:
-      return none;
-  }
+  if (gSegs.length === 1) {
+    if (tailSegs.length === 0) return null;
+    const leaf = stripExt(tailSegs[tailSegs.length - 1]);
+    if (gSegs[0] === "{module}") return { module: mod(leaf), endpoint: defEnd, page: null };
+    if (gSegs[0] === "{endpoint}") return { module: null, endpoint: leaf, page: null };
+    return none;
+  }
+  const hasPage = gSegs[gSegs.length - 1] === "{page}";
+  const fixed = hasPage ? gSegs.length - 1 : gSegs.length;
+  if (hasPage ? tailSegs.length < gSegs.length : tailSegs.length !== gSegs.length) return null;
+  const cap = {};
+  for (let i = 0; i < fixed; i++) cap[gSegs[i]] = stripExt(tailSegs[i]);
+  if (cap["{endpoint}"] !== void 0 && !ctx.config.endpoints.includes(cap["{endpoint}"])) return null;
+  const endpoint = cap["{endpoint}"] ?? defEnd;
+  const module = cap["{module}"] !== void 0 ? mod(cap["{module}"]) : null;
+  let page = null;
+  if (hasPage) {
+    const pageSegs = tailSegs.slice(fixed);
+    const pageTail = pageSegs.map((s, i) => i === pageSegs.length - 1 ? stripExt(s) : s).join("/");
+    page = module ? `${module}/${pageTail}` : pageTail;
+  }
+  return { module, endpoint, page };
 }
 function isMetaPath(ctx, relPath) {
   const registry = getKindRegistry(ctx.config);
@@ -2528,7 +2535,7 @@ function deriveEdges(ctx) {
   return created;
 }
 function scanArtifacts(ctx, actor = "system") {
-  const summary = { registered: 0, refreshed: 0, remapped: 0, edges: 0, skipped: [] };
+  const summary = { registered: 0, refreshed: 0, remapped: 0, edges: 0, skipped: [], unresolved: [] };
   const files = [];
   for (const dir of Object.values(ctx.config.docs)) {
     const abs = join10(ctx.root, dir);
@@ -2552,7 +2559,7 @@ function scanArtifacts(ctx, actor = "system") {
       const before = row.content_hash;
       const after = refreshArtifact(ctx, { id: row.id }, actor);
       if (after.content_hash !== before) summary.refreshed++;
-      if (row.kind !== kind || row.module !== coords.module || row.endpoint !== coords.endpoint || row.page !== coords.page) {
+      if (coords && (row.kind !== kind || row.module !== coords.module || row.endpoint !== coords.endpoint || row.page !== coords.page)) {
         const tx2 = ctx.db.transaction(() => {
           remap.run(kind, coords.module, coords.endpoint, coords.page, row.id);
           logEvent(ctx.db, {
@@ -2575,6 +2582,10 @@ function scanArtifacts(ctx, actor = "system") {
       }
       return;
     }
+    if (!coords) {
+      summary.unresolved.push(relPath);
+      return;
+    }
     const hash = hashPath(join10(ctx.root, relPath));
     if (hash === null) return;
     const tx = ctx.db.transaction(() => {
@@ -2607,6 +2618,7 @@ function scanArtifacts(ctx, actor = "system") {
   summary.edges = deriveEdges(ctx);
   return summary;
 }
+var stripExt;
 var init_scan_command = __esm({
   "core/commands/scan.command.ts"() {
     "use strict";
@@ -2614,6 +2626,7 @@ var init_scan_command = __esm({
     init_hash();
     init_kind();
     init_artifact_commands();
+    stripExt = (s) => s.replace(/\.(md|html)$/i, "");
   }
 });
 
@@ -3435,6 +3448,7 @@ __export(core_exports, {
   distillFeedback: () => distillFeedback,
   ensureSchema: () => ensureSchema,
   everApproved: () => everApproved,
+  expandPattern: () => expandPattern,
   exportEventLog: () => exportEventLog,
   feedbackArtifact: () => feedbackArtifact,
   findProjectRoot: () => findProjectRoot,
@@ -3682,7 +3696,7 @@ __export(app_exports, {
 import fastifyCors from "@fastify/cors";
 import fastifyStatic from "@fastify/static";
 import Fastify from "fastify";
-import { existsSync as existsSync14, readFileSync as readFileSync8, readdirSync as readdirSync7, statSync as statSync6 } from "node:fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync8, readFileSync as readFileSync8, readdirSync as readdirSync7, statSync as statSync6 } from "node:fs";
 import { isAbsolute as isAbsolute2, join as join16, normalize, relative as relative2 } from "node:path";
 function getArtifact(ctx, id) {
   const row = ctx.db.prepare("SELECT * FROM artifacts WHERE id = ?").get(id);
@@ -3706,6 +3720,9 @@ async function createServer(ctx) {
   if (existsSync14(webDist)) {
     await app.register(fastifyStatic, { root: webDist });
   }
+  const protoRoot = join16(ctx.root, ctx.config.docs.design, "prototypes");
+  mkdirSync8(protoRoot, { recursive: true });
+  await app.register(fastifyStatic, { root: protoRoot, prefix: "/proto/", decorateReply: false });
   app.get("/api/meta", async () => ({
     root: ctx.root,
     language: ctx.config.language,
@@ -3747,15 +3764,6 @@ async function createServer(ctx) {
     }
     return { artifact, content, isDirectory, missing, feedback, events };
   });
-  app.get("/api/artifact/:id/raw", async (req, reply) => {
-    const artifact = getArtifact(ctx, parseInt(req.params.id));
-    const abs = guardedAbsPath(ctx, artifact);
-    if (!existsSync14(abs) || statSync6(abs).isDirectory()) {
-      return reply.code(404).send("not found");
-    }
-    reply.header("content-type", artifact.path.endsWith(".html") ? "text/html; charset=utf-8" : "text/plain; charset=utf-8");
-    return reply.send(readFileSync8(abs));
-  });
   app.get("/api/artifact/:id/files", async (req) => {
     const artifact = getArtifact(ctx, parseInt(req.params.id));
     const base = guardedAbsPath(ctx, artifact);
@@ -4440,6 +4448,10 @@ async function runCommand(ctx, command, a) {
     case "scan": {
       const s = scanArtifacts(ctx, a.actor || "system");
       console.log(chalk.green(`\u2705 \u626B\u63CF\u5B8C\u6210:\u65B0\u767B\u8BB0 ${s.registered},\u5185\u5BB9\u5237\u65B0 ${s.refreshed},\u91CD\u6302\u5750\u6807 ${s.remapped},\u65B0\u589E\u8FB9 ${s.edges},\u6392\u9664\u5143\u4EA7\u7269 ${s.skipped.length}`));
+      if (s.unresolved.length > 0) {
+        console.log(chalk.yellow(`\u26A0 ${s.unresolved.length} \u4E2A\u6587\u4EF6\u547D\u4E2D kind \u4F46\u8DEF\u5F84\u4E0D\u7B26 coords \u6587\u6CD5,\u672A\u767B\u8BB0(\u975E\u89C4\u8303/\u5E9F\u5F03\u7AEF?):`));
+        for (const p of s.unresolved) console.log(chalk.yellow(`    - ${p}`));
+      }
       break;
     }
     case "move": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawipong/opcflow",
-  "version": "0.3.0",
+  "version": "0.4.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-B5Ymr02_.js → abnfDiagram-VRR7QNED-DAx6EpGI.js}

@@ -1 +1 @@
-import{m as e}from"./src-W4W9ly-y.js";import{n as t}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./chunk-WYO6CB5R-BaRUDpDl.js";import"./index-D02utICb.js";import{m as n,t as r}from"./mermaid-parser.core-CAAH_OSq.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-BJQ2jnj0.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{m as e}from"./src-W4W9ly-y.js";import{n as t}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./chunk-WYO6CB5R-BaRUDpDl.js";import"./index-HsPwY2CU.js";import{m as n,t as r}from"./mermaid-parser.core-CAAH_OSq.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-DXlFl9Jv.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};