@dawipong/opcflow 0.6.0 → 0.7.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,7 @@ var init_kind = __esm({
       ["prototype", "acceptance"],
       ["code"]
     ];
+    COORD_LABELS_ZH = { "{module}": "{\u6A21\u5757}", "{endpoint}": "{\u7AEF}", "{page}": "{\u9875\u9762}" };
   }
 });
 
@@ -3178,6 +3188,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")
@@ -3578,6 +3598,7 @@ __export(core_exports, {
   initProject: () => initProject,
   installGitHooks: () => installGitHooks,
   intakeIssues: () => intakeIssues,
+  kindPathTemplate: () => kindPathTemplate,
   kindSpec: () => kindSpec,
   listArtifacts: () => listArtifacts,
   listEvents: () => listEvents,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawipong/opcflow",
-  "version": "0.6.0",
+  "version": "0.7.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 完成后):执行验收**