@dawipong/opcflow 0.1.0 → 0.1.1

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.

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,7 +221,7 @@ 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 实时刷新。审批、打回、
 给原型 👍👎 都在这里点。
 

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@dawipong/opcflow",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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": [
@@ -62,6 +62,8 @@
   "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",
@@ -74,6 +76,7 @@
     "react-dom": "^18.3.1",
     "react-markdown": "^10",
     "remark-gfm": "^4",
+    "semantic-release": "^25.0.5",
     "tsx": "^4",
     "typescript": "^5.5.0",
     "vite": "^7"