@dawipong/opcflow 0.1.0 → 0.2.0

package/README.en.md

@@ -13,6 +13,8 @@ One template turns Claude Code / Codex / OpenCode / Cursor into a contract-gover
 
 [简体中文](README.md) · **English**
 
+<img src="screen-en.png" alt="opcflow visual workbench — artifact tree + review-queue diff + live rendering" width="840" />
+
 </div>
 
 ---
@@ -61,12 +63,17 @@ from contract to code to acceptance.**
 
 ## Installation
 
-opcflow is an npm package — it **does not drop source into your project**. Bootstrap from your
-project root with npx, zero install:
+opcflow is an npm package — it **does not drop source into your project**. Install it once globally to
+get the `opcflow` command:
+
+```bash
+pnpm i -g @dawipong/opcflow      # or npm i -g @dawipong/opcflow
+```
+
+Bootstrap from your project root (no args → interactive: pick platforms / endpoints / model; or pass flags):
 
 ```bash
-# In your project root: pick platforms (multi-select) + endpoints, generate in one shot
-npx -y @dawipong/opcflow init --platforms=claude,cursor --endpoints=service,web
+opcflow init --platforms=claude,cursor --endpoints=service,web
 #   backend-only:  --endpoints=service          (auto-prunes designer, qa kept)
 #   set models:    --model='{"codex":"gpt-5.1-codex"}'  or  --model=<single string> (defaults per platform)
 ```
@@ -85,13 +92,13 @@ Requires Node ≥ 22.
 1. **Fill in code-dir conventions** — edit `codeRoots` in `workbench.config.json` (each endpoint's code dir, `{module}` placeholder).
 2. **Start the opcflow** (visual approval panel, connects to the project's `.workbench`):
    ```bash
-   npx -y @dawipong/opcflow serve       # → http://127.0.0.1:5620 (--project sets the root, defaults to cwd)
+   opcflow serve       # → http://127.0.0.1:5620 (--project sets the root, defaults to cwd)
    ```
 3. **Give the AI your first requirement** (one sentence). It runs the five-role pipeline, producing contracts layer by layer and submitting them for review.
 4. **Nod in the review queue** — view diffs in the opcflow; approve / reject; thumbs-up prototypes.
 5. **Once all contracts are approved, dispatch:**
    ```bash
-   npx -y @dawipong/opcflow plan --module=<module>   # dispatch architect/designer/developer/qa tasks
+   opcflow plan --module=<module>   # dispatch architect/designer/developer/qa tasks
    ```
 
 Every later change is tracked: edit an approved contract → auto-invalidate → downstream stale → a
@@ -136,7 +143,7 @@ never silently deviate.
 
 ## CLI Commands & Parameters
 
-Every command: `npx -y @dawipong/opcflow <command> [args]`. Global `--project=<path>` sets the project
+Every command: `opcflow <command> [args]` (after global install; or `npx -y @dawipong/opcflow <command>` without installing). Global `--project=<path>` sets the project
 root (otherwise it searches upward for `workbench.config.json`). File-path arguments are separated with
 `--` (e.g. `submit --actor=x -- <path>`).
 
@@ -227,7 +234,7 @@ root (otherwise it searches upward for `workbench.config.json`). File-path argum
 
 ## Visual opcflow
 
-`npx -y @dawipong/opcflow serve` serves at `http://127.0.0.1:5620`: the artifact tree (colors update live), markdown /
+`opcflow serve` serves at `http://127.0.0.1:5620`: the artifact tree (colors update live), markdown /
 mermaid / HTML-prototype iframe / code rendering, the **review-queue diff** (approved version vs.
 current), an event timeline, and live SSE refresh. Approve, reject, and thumbs-up/down prototypes right
 here.
@@ -235,9 +242,8 @@ here.
 ## Scripts
 
 ```bash
-pnpm start                # start the opcflow (build frontend + start server; use for first run)
-pnpm run serve            # server only, no frontend build (404 if web/dist is missing)
-pnpm run web:build        # build the frontend
+pnpm run web:build        # build the frontend (required before first serve, else web/dist is missing → 404)
+pnpm exec tsx cli.ts serve  # start the workbench from source → http://127.0.0.1:5620
 pnpm test                 # core unit tests
 pnpm run typecheck        # type check
 pnpm run check:isolation  # zero business-coupling check

package/README.md

@@ -13,6 +13,8 @@
 
 **简体中文** · [English](README.en.md)
 
+<img src="screen.png" alt="opcflow 可视化工作台 —— artifact 树 + 待审队列 diff + 实时渲染" width="840" />
+
 </div>
 
 ---
@@ -56,11 +58,16 @@ opcflow 接管 **spec 之后的执行与验证**,两者是不同层次、可互
 
 ## 安装
 
-opcflow 是一个 npm 包 —— **不往你的项目里塞源码**。在项目根用 npx 零安装引导:
+opcflow 是一个 npm 包 —— **不往你的项目里塞源码**。全局装一次,拿到 `opcflow` 命令:
+
+```bash
+pnpm i -g @dawipong/opcflow      # 或 npm i -g @dawipong/opcflow
+```
+
+在你的项目根一键引导(不带参数进交互:选平台 / 端 / 模型;也可用参数直接指定):
 
 ```bash
-# 在你的项目根:选平台(多选)+ 端,一键生成
-npx -y @dawipong/opcflow init --platforms=claude,cursor --endpoints=service,web
+opcflow init --platforms=claude,cursor --endpoints=service,web
 #   纯后端:      --endpoints=service          (自动裁掉 designer,qa 保留)
 #   指定模型:    --model='{"codex":"gpt-5.1-codex"}'  或  --model=<单个串>(缺省用各平台默认)
 ```
@@ -78,13 +85,13 @@ npx -y @dawipong/opcflow init --platforms=claude,cursor --endpoints=service,web
 1. **填代码目录约定** —— 编辑 `workbench.config.json` 的 `codeRoots`(每个端的代码目录,`{module}` 占位)。
 2. **起工作台**(可视化审批面板,连接项目的 `.workbench`):
    ```bash
-   npx -y @dawipong/opcflow serve       # → http://127.0.0.1:5620(--project 指定项目根,缺省 cwd)
+   opcflow serve       # → http://127.0.0.1:5620(--project 指定项目根,缺省 cwd)
    ```
 3. **对 AI 提第一个需求**(一句话)。它走五角色流水线逐层产出契约并送审。
 4. **在待审队列点头** —— 工作台看 diff,approve / 打回 / 给原型 👍。
 5. **契约全 approved 后派发**:
    ```bash
-   npx -y @dawipong/opcflow plan --module=<模块>   # 一键派发 architect/designer/developer/qa 任务
+   opcflow plan --module=<模块>   # 一键派发 architect/designer/developer/qa 任务
    ```
 
 之后的每次改动都被追踪:改了已批契约 → 自动失效 → 下游 stale → 待审队列出现复审任务。
@@ -124,7 +131,7 @@ flowchart LR
 
 ## CLI 命令参数
 
-所有命令:`npx -y @dawipong/opcflow <命令> [参数]`。全局 `--project=<路径>` 指定项目根(缺省向上找
+所有命令:`opcflow <命令> [参数]`(全局装后即用;或 `npx -y @dawipong/opcflow <命令>` 免装)。全局 `--project=<路径>` 指定项目根(缺省向上找
 `workbench.config.json`)。文件路径参数用 `--` 分隔(如 `submit --actor=x -- <路径>`)。
 
 **任务**
@@ -214,16 +221,15 @@ flowchart LR
 
 ## 可视化工作台
 
-`npx -y @dawipong/opcflow serve` 起在 `http://127.0.0.1:5620`:artifact 树(状态实时变色)、markdown / mermaid / HTML 原型
+`opcflow serve` 起在 `http://127.0.0.1:5620`:artifact 树(状态实时变色)、markdown / mermaid / HTML 原型
 iframe / 代码渲染、**待审队列 diff**(approved 版本 vs 当前)、事件时间线、SSE 实时刷新。审批、打回、
 给原型 👍👎 都在这里点。
 
 ## 脚本
 
 ```bash
-pnpm start                # 启动工作台(build 前端 + 起 server;首次用它)
-pnpm run serve            # 只起 server,不 build 前端(web/dist 未生成会 404)
-pnpm run web:build        # 构建前端
+pnpm run web:build        # 构建前端(工作台首次运行前需先构建,否则 web/dist 未生成会 404)
+pnpm exec tsx cli.ts serve  # 从源码起工作台 → http://127.0.0.1:5620
 pnpm test                 # core 单元测试
 pnpm run typecheck        # 类型检查
 pnpm run check:isolation  # 零业务耦合校验

package/dist/cli.mjs

@@ -4466,9 +4466,12 @@ function fail(msg) {
 }
 
 // cli.ts
-init_core();
 async function main() {
   const { command, a } = parseArgs(process.argv.slice(2));
+  if (!command || command === "-h" || command === "--help" || command === "help") {
+    console.log(HELP);
+    return;
+  }
   if (command === "init") {
     await runInit(a.project || process.cwd(), a);
     return;
@@ -4534,10 +4537,6 @@ async function main() {
     return;
   }
   const ctx = openWorkbench(a.project);
-  if (!command) {
-    printTasks(listTasks(ctx, {}));
-    return;
-  }
   try {
     await runCommand(ctx, command, a);
   } catch (err) {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@dawipong/opcflow",
-  "version": "0.1.0",
+  "version": "0.2.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",
   "homepage": "https://github.com/nvrenshiren/opcflow#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/nvrenshiren/opcflow.git"
+    "url": "git+https://github.com/nvrenshiren/opcflow.git"
   },
   "bugs": "https://github.com/nvrenshiren/opcflow/issues",
   "keywords": [
@@ -44,9 +44,7 @@
     "check:isolation": "tsx scripts/check-isolation.ts",
     "web:build": "vite build",
     "build": "pnpm run web:build && node scripts/build.mjs",
-    "prepublishOnly": "pnpm run build",
-    "serve": "tsx cli.ts serve",
-    "start": "pnpm run web:build && tsx cli.ts serve"
+    "prepublishOnly": "pnpm run build"
   },
   "dependencies": {
     "@fastify/cors": "^11",
@@ -62,11 +60,13 @@
   "devDependencies": {
     "@ant-design/icons": "^6",
     "@monaco-editor/react": "^4.7.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/better-sqlite3": "^7",
     "@types/node": "^22",
     "@types/react": "^18",
     "@types/react-dom": "^18",
-    "@vitejs/plugin-react": "^5",
+    "@vitejs/plugin-react": "^6",
     "antd": "^6",
     "esbuild": "^0.28.1",
     "mermaid": "^11",
@@ -74,8 +74,9 @@
     "react-dom": "^18.3.1",
     "react-markdown": "^10",
     "remark-gfm": "^4",
+    "semantic-release": "^25.0.5",
     "tsx": "^4",
     "typescript": "^5.5.0",
-    "vite": "^7"
+    "vite": "^8"
   }
 }

package/web/dist/assets/abnfDiagram-VRR7QNED-DctuL32B.js

@@ -0,0 +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-DVXPy-Pj.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-Y0jSjq4a.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};

package/web/dist/assets/arc-DPoWLLje.js

@@ -0,0 +1 @@
+import{n as e,t}from"./path-BWPyau1x.js";import{a as n,c as r,d as i,f as a,i as o,l as s,m as c,n as l,o as u,p as d,r as f,u as p}from"./dist-zlHGdC4Y.js";function m(e){return e.innerRadius}function h(e){return e.outerRadius}function g(e){return e.startAngle}function _(e){return e.endAngle}function v(e){return e&&e.padAngle}function y(e,t,n,r,i,a,o,s){var c=n-e,l=r-t,u=o-i,d=s-a,f=d*c-u*l;if(!(f*f<1e-12))return f=(u*(t-a)-d*(e-i))/f,[e+f*c,t+f*l]}function b(e,t,n,r,i,a,o){var c=e-n,l=t-r,u=(o?a:-a)/d(c*c+l*l),f=u*l,p=-u*c,m=e+f,h=t+p,g=n+f,_=r+p,v=(m+g)/2,y=(h+_)/2,b=g-m,x=_-h,S=b*b+x*x,C=i-a,w=m*_-g*h,T=(x<0?-1:1)*d(s(0,C*C*S-w*w)),E=(w*x-b*T)/S,D=(-w*b-x*T)/S,O=(w*x+b*T)/S,k=(-w*b+x*T)/S,A=E-v,j=D-y,M=O-v,N=k-y;return A*A+j*j>M*M+N*N&&(E=O,D=k),{cx:E,cy:D,x01:-f,y01:-p,x11:E*(i/C-1),y11:D*(i/C-1)}}function x(){var s=m,x=h,S=e(0),C=null,w=g,T=_,E=v,D=null,O=t(k);function k(){var e,t,m=+s.apply(this,arguments),h=+x.apply(this,arguments),g=w.apply(this,arguments)-r,_=T.apply(this,arguments)-r,v=l(_-g),k=_>g;if(D||=e=O(),h<m&&(t=h,h=m,m=t),!(h>1e-12))D.moveTo(0,0);else if(v>c-1e-12)D.moveTo(h*u(g),h*a(g)),D.arc(0,0,h,g,_,!k),m>1e-12&&(D.moveTo(m*u(_),m*a(_)),D.arc(0,0,m,_,g,k));else{var A=g,j=_,M=g,N=_,P=v,F=v,I=E.apply(this,arguments)/2,L=I>1e-12&&(C?+C.apply(this,arguments):d(m*m+h*h)),R=p(l(h-m)/2,+S.apply(this,arguments)),z=R,B=R,V,H;if(L>1e-12){var U=o(L/m*a(I)),W=o(L/h*a(I));(P-=U*2)>1e-12?(U*=k?1:-1,M+=U,N-=U):(P=0,M=N=(g+_)/2),(F-=W*2)>1e-12?(W*=k?1:-1,A+=W,j-=W):(F=0,A=j=(g+_)/2)}var G=h*u(A),K=h*a(A),q=m*u(N),J=m*a(N);if(R>1e-12){var Y=h*u(j),X=h*a(j),Z=m*u(M),Q=m*a(M),$;if(v<i)if($=y(G,K,Z,Q,Y,X,q,J)){var ee=G-$[0],te=K-$[1],ne=Y-$[0],re=X-$[1],ie=1/a(f((ee*ne+te*re)/(d(ee*ee+te*te)*d(ne*ne+re*re)))/2),ae=d($[0]*$[0]+$[1]*$[1]);z=p(R,(m-ae)/(ie-1)),B=p(R,(h-ae)/(ie+1))}else z=B=0}F>1e-12?B>1e-12?(V=b(Z,Q,G,K,h,B,k),H=b(Y,X,q,J,h,B,k),D.moveTo(V.cx+V.x01,V.cy+V.y01),B<R?D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,h,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),!k),D.arc(H.cx,H.cy,B,n(H.y11,H.x11),n(H.y01,H.x01),!k))):(D.moveTo(G,K),D.arc(0,0,h,A,j,!k)):D.moveTo(G,K),!(m>1e-12)||!(P>1e-12)?D.lineTo(q,J):z>1e-12?(V=b(q,J,Y,X,m,-z,k),H=b(G,K,Z,Q,m,-z,k),D.lineTo(V.cx+V.x01,V.cy+V.y01),z<R?D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,m,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),k),D.arc(H.cx,H.cy,z,n(H.y11,H.x11),n(H.y01,H.x01),!k))):D.arc(0,0,m,N,M,k)}if(D.closePath(),e)return D=null,e+``||null}return k.centroid=function(){var e=(+s.apply(this,arguments)+ +x.apply(this,arguments))/2,t=(+w.apply(this,arguments)+ +T.apply(this,arguments))/2-i/2;return[u(t)*e,a(t)*e]},k.innerRadius=function(t){return arguments.length?(s=typeof t==`function`?t:e(+t),k):s},k.outerRadius=function(t){return arguments.length?(x=typeof t==`function`?t:e(+t),k):x},k.cornerRadius=function(t){return arguments.length?(S=typeof t==`function`?t:e(+t),k):S},k.padRadius=function(t){return arguments.length?(C=t==null?null:typeof t==`function`?t:e(+t),k):C},k.startAngle=function(t){return arguments.length?(w=typeof t==`function`?t:e(+t),k):w},k.endAngle=function(t){return arguments.length?(T=typeof t==`function`?t:e(+t),k):T},k.padAngle=function(t){return arguments.length?(E=typeof t==`function`?t:e(+t),k):E},k.context=function(e){return arguments.length?(D=e??null,k):D},k}export{x as t};

package/web/dist/assets/architecture-TIHT7OUA-Bgyz4pDY.js

@@ -0,0 +1 @@
+import"./chunk-KEIR6QF5-BfrZ3jm6.js";import{M as e}from"./mermaid-parser.core-CAAH_OSq.js";export{e as createArchitectureServices};