dic-workflow-kit 1.0.0 → 1.1.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dic-workflow-kit",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Design-implementation consistency workflow with OpenSpec obligations, BDD knowledge, Skills, and Subagents.",
   "author": {
     "name": "TonyClaw"

package/README.md

@@ -1,6 +1,6 @@
 # Design-Implementation Consistency Workflow Kit
 
-Version: `1.0.0`
+Version: `1.1.0`
 
 Design-Implementation Consistency Workflow Kit, or DIC Workflow Kit, is a portable agentic workflow package for checking and repairing whether implementation matches design intent.
 
@@ -10,31 +10,76 @@ The kit is not tied to one contest, one repository, one language stack, or one a
 
 > The differentiator is not the number of agents. DIC Workflow Kit uses design intent, typed handoffs, project profiles, validation evidence, and residual-risk reporting to prove that implementation remains aligned with its design contract.
 
-## Install in Codex with npm
+## Install with npm
 
-The npm package contains all seven Skills and all nine Subagents. Install it into the default personal Codex plugin marketplace with:
+The npm package contains all seven Skills and all nine Subagents and installs them with host-native directory layouts for Codex, Claude Code, OpenCode, and MiMo Code.
+
+Codex remains the default, so the original command is backward compatible:
 
 ```text
-npx dic-workflow-kit install
+npx @tonyclaw/dic-workflow-kit@1.1.0 install
 ```
 
-Or install the CLI globally:
+Select another host explicitly:
 
 ```text
-npm install --global dic-workflow-kit
-dic-workflow-kit install
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host claude-code
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host opencode
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host mimo-code
+```
+
+User scope is the default. To install into the current repository instead, use `--scope project`:
+
+```text
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host claude-code --scope project
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host opencode --scope project
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host mimo-code --scope project
+```
+
+The host mappings are:
+
+| Host | User scope | Project scope |
+| --- | --- | --- |
+| Codex | `~/.agents/plugins/plugins/dic-workflow-kit` plus marketplace registration | Not applicable to this plugin installer |
+| Claude Code | `~/.claude/{skills,agents}` | `.claude/{skills,agents}` |
+| OpenCode | `~/.config/opencode/{skills,agents}` | `.opencode/{skills,agents}` |
+| MiMo Code | platform config root under `mimocode/{skills,agents}` | `.mimocode/{skills,agents}` |
+
+On Windows, MiMo Code's user root resolves to `%LOCALAPPDATA%\mimocode`; `MIMOCODE_HOME` and `XDG_CONFIG_HOME` are honored where applicable. The installer adapts Subagent frontmatter per host while keeping `agents/` in the package as the single source of truth.
+
+You can also install the CLI globally:
+
+```text
+npm install --global @tonyclaw/dic-workflow-kit@1.1.0
+dic-workflow-kit install --host opencode
 ```
 
-Before the package is published to the npm registry, install the same CLI directly from the repository:
+The same CLI can also be installed directly from the repository:
 
 ```text
 npm install --global git+ssh://git@gitcode.com/TonyClaw/DICWorkflowKit.git
 dic-workflow-kit install
 ```
 
-The installer writes the plugin to `~/.agents/plugins/plugins/dic-workflow-kit` and registers it in `~/.agents/plugins/marketplace.json`. It preserves unrelated entries and replaces only the entry with the same plugin name.
+Use `--dry-run` to preview the resolved destination, `--install-root <path>` for an isolated host root, or the backward-compatible Codex-only `--marketplace-root <path>`. The Codex installer preserves unrelated marketplace entries and replaces only the entry with the same plugin name. Restart or reload the target coding-agent session after its first Skills/agents directory is created.
+
+### Dual npm release
+
+Every release publishes the same version and payload under both npm names:
+
+- `@tonyclaw/dic-workflow-kit`
+- `dic-workflow-kit`
+
+`package.json` is the canonical version source. Set a new version once; the helper propagates it to the Codex plugin manifest, workflow runtime, all Skills, all Subagents, and both READMEs:
+
+```text
+npm run release:set-version -- 1.1.0
+npm run release:plan
+npm run release:dual:dry-run
+npm run release:dual
+```
 
-Use `npx dic-workflow-kit install --dry-run` to preview the destination, or `--marketplace-root /path/to/.agents/plugins` for an isolated environment. Start a new Codex task after installation so its Skills and Subagents are discovered.
+npm cannot provide an atomic transaction across two package names. The coordinator therefore uses a convergent release: it completes all local checks first, publishes both packages from temporary staging directories, skips a package when the exact version already exists, and can be safely rerun to publish only the missing side after a partial failure.
 
 For a defense-oriented walkthrough of the project claims and their code evidence, see [答辩引导：项目特点与代码证据](docs/答辩引导-项目特点与代码证据.md).
 
@@ -157,7 +202,7 @@ For OpenSpec projects, the kit treats these as first-class design sources:
 
 The kit checks whether proposals, specs, scenarios, and tasks were actually reflected in implementation and tests.
 
-To scope intake to one OpenSpec Change, pass its identifier explicitly. Active changes are preferred; if no active match exists, the archived location is resolved and recorded in the profile. Keep evidence outside the target repository with `--output-root`:
+The source repository also contains a development helper for generating these profiles directly. It is intentionally excluded from the npm runtime package. From a source checkout, scope intake to one OpenSpec Change with:
 
 ```text
 python scripts/dic_workflow.py \

package/README.zh-CN.md

@@ -1,6 +1,6 @@
 # 设计—实现一致性 Workflow Kit
 
-版本：`1.0.0`
+版本：`1.1.0`
 
 Design-Implementation Consistency Workflow Kit，简称 DIC Workflow Kit，是一套可移植的智能体工作流包，用于检查和修复“代码实现是否符合设计意图”。
 
@@ -8,29 +8,74 @@ Design-Implementation Consistency Workflow Kit，简称 DIC Workflow Kit，是
 
 > 项目的差异不在 Agent 数量。DIC Workflow Kit 通过设计意图、类型化交接、项目画像、验证证据和残余风险报告，证明实现仍然符合设计契约。
 
-## 通过 npm 安装到 Codex
+## 通过 npm 安装
 
-npm 包完整包含 7 个 Skills 和 9 个 Subagents：
+npm 包完整包含 7 个 Skills 和 9 个 Subagents，并支持 Codex、Claude Code、OpenCode 和 MiMo Code 的原生目录结构。
+
+Codex 仍是默认宿主，原命令保持兼容：
+
+```text
+npx @tonyclaw/dic-workflow-kit@1.1.0 install
+```
+
+安装到其他宿主时显式指定 `--host`：
 
 ```text
-npx dic-workflow-kit install
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host claude-code
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host opencode
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host mimo-code
 ```
 
+默认是用户级安装；若只希望当前仓库使用，则增加 `--scope project`：
+
+```text
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host claude-code --scope project
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host opencode --scope project
+npx @tonyclaw/dic-workflow-kit@1.1.0 install --host mimo-code --scope project
+```
+
+| 宿主 | 用户级目录 | 项目级目录 |
+| --- | --- | --- |
+| Codex | `~/.agents/plugins/plugins/dic-workflow-kit`，并注册 marketplace | 当前插件安装器不提供项目级模式 |
+| Claude Code | `~/.claude/{skills,agents}` | `.claude/{skills,agents}` |
+| OpenCode | `~/.config/opencode/{skills,agents}` | `.opencode/{skills,agents}` |
+| MiMo Code | 平台配置根目录下的 `mimocode/{skills,agents}` | `.mimocode/{skills,agents}` |
+
+Windows 上 MiMo Code 的用户级根目录为 `%LOCALAPPDATA%\mimocode`；适用时也会读取 `MIMOCODE_HOME` 和 `XDG_CONFIG_HOME`。安装器以仓库中的 `agents/` 为唯一来源，并按宿主转换 Subagent frontmatter，避免维护四套重复内容。
+
 也可以先全局安装 CLI：
 
 ```text
-npm install --global dic-workflow-kit
-dic-workflow-kit install
+npm install --global @tonyclaw/dic-workflow-kit@1.1.0
+dic-workflow-kit install --host opencode
 ```
 
-在 npm registry 正式发布前，可以直接从仓库安装同一个 CLI：
+也可以直接从仓库安装同一个 CLI：
 
 ```text
 npm install --global git+ssh://git@gitcode.com/TonyClaw/DICWorkflowKit.git
 dic-workflow-kit install
 ```
 
-默认安装到 `~/.agents/plugins/plugins/dic-workflow-kit`，并在 `~/.agents/plugins/marketplace.json` 中注册。安装器会保留其他 marketplace 条目，只更新同名插件。使用 `--dry-run` 预演，或使用 `--marketplace-root` 指定隔离目录。安装后请新建 Codex 任务，以重新发现 Skills 和 Subagents。
+使用 `--dry-run` 预演目标目录，使用 `--install-root <path>` 指定隔离的宿主根目录；Codex 仍兼容 `--marketplace-root <path>`。首次创建 Skills 或 agents 目录后，请重启或重新加载对应 Coding Agent 会话。
+
+### 双 npm 包发布
+
+每次发布必须以相同版本、相同内容发布两个包名：
+
+- `@tonyclaw/dic-workflow-kit`
+- `dic-workflow-kit`
+
+`package.json` 是唯一版本源。版本脚本会同步 Codex 插件清单、工作流脚本、全部 Skills、全部 Subagents 和中英文 README：
+
+```text
+npm run release:set-version -- 1.1.0
+npm run release:plan
+npm run release:dual:dry-run
+npm run release:dual
+```
+
+npm 不支持两个包名之间的原子事务，因此发布协调器采用可收敛策略：先完成全部本地检查，再从临时 staging 分别发布两个包；某一侧已经存在相同版本时自动跳过，部分失败后重复运行只会补发缺失的一侧。
 
 答辩时如何讲解项目特点并定位代码证据，请参考[《答辩引导：项目特点与代码证据》](docs/答辩引导-项目特点与代码证据.md)。
 

package/agents/code-repairer.md

@@ -1,6 +1,6 @@
 ---
 name: code-repairer
-version: 1.0.0
+version: 1.1.0
 description: Implement approved repair slices while preserving contracts, minimizing blast radius, and avoiding unrelated refactors.
 mode: subagent
 ---

package/agents/contract-oracle.md

@@ -1,6 +1,6 @@
 ---
 name: contract-oracle
-version: 1.0.0
+version: 1.1.0
 description: Convert source requirements, OpenSpec scenarios, and feedback hypotheses into source-confirmed implementation obligations.
 mode: subagent
 ---

package/agents/final-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: final-reviewer
-version: 1.0.0
+version: 1.1.0
 description: Perform the final consistency gate across source coverage, protected paths, validation evidence, residual risks, changed files, and output artifacts.
 mode: subagent
 ---

package/agents/flow-auditor.md

@@ -1,6 +1,6 @@
 ---
 name: flow-auditor
-version: 1.0.0
+version: 1.1.0
 description: Audit business and use-case flow completeness, including lifecycle, branches, state transitions, side effects, integration paths, and failure handling.
 mode: subagent
 ---

package/agents/impl-inspector.md

@@ -1,6 +1,6 @@
 ---
 name: impl-inspector
-version: 1.0.0
+version: 1.1.0
 description: Inspect implementation against source-confirmed obligations without editing files.
 mode: subagent
 ---

package/agents/profile-builder.md

@@ -1,6 +1,6 @@
 ---
 name: profile-builder
-version: 1.0.0
+version: 1.1.0
 description: Build a normalized project profile from repository evidence so downstream agents stop guessing paths, tools, and source hierarchy.
 mode: subagent
 ---

package/agents/repair-planner.md

@@ -1,6 +1,6 @@
 ---
 name: repair-planner
-version: 1.0.0
+version: 1.1.0
 description: Create small, source-backed repair slices with target files, validation commands, stop conditions, and fallback plans.
 mode: subagent
 ---

package/agents/spec-reader.md

@@ -1,6 +1,6 @@
 ---
 name: spec-reader
-version: 1.0.0
+version: 1.1.0
 description: Read authoritative design, OpenSpec, API, schema, README, and configuration sources and produce a source-backed requirement brief.
 mode: subagent
 ---

package/agents/validation-runner.md

@@ -1,6 +1,6 @@
 ---
 name: validation-runner
-version: 1.0.0
+version: 1.1.0
 description: Discover, run, and summarize project validation commands using evaluator-readable evidence.
 mode: subagent
 ---

package/dist/dic-workflow-kit.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import{cp as A,mkdir as w,readFile as y,readdir as g,writeFile as E}from"node:fs/promises";import{homedir as f}from"node:os";import{dirname as x,join as n,resolve as m}from"node:path";import{fileURLToPath as N}from"node:url";var h="dic-workflow-kit",p=m(x(N(import.meta.url)),".."),j=new Map([["codex","codex"],["claude","claude-code"],["claude-code","claude-code"],["opencode","opencode"],["mimo","mimo-code"],["mimocode","mimo-code"],["mimo-code","mimo-code"]]),L=[".codex-plugin","adapters","agents","schemas","skills","INSTRUCTION.md"];function u(e,o,t){let r=e[o+1];if(!r)throw new Error(`${t} requires a value`);return r}function C(e){let o=e[0]??"help",t="codex",r="user",c,a,s=process.cwd(),d=!1;for(let i=1;i<e.length;i+=1){let l=e[i];if(l==="--host"){let k=u(e,i,l).toLowerCase();if(t=j.get(k),!t)throw new Error(`unsupported host: ${k}; expected codex, claude-code, opencode, or mimo-code`);i+=1}else if(l==="--scope"){if(r=u(e,i,l).toLowerCase(),!["user","project"].includes(r))throw new Error("--scope must be user or project");i+=1}else if(l==="--install-root")c=m(u(e,i,l)),i+=1;else if(l==="--project-root")s=m(u(e,i,l)),i+=1;else if(l==="--marketplace-root")a=m(u(e,i,l)),i+=1;else if(l==="--dry-run")d=!0;else throw new Error(`unknown argument: ${l}`)}if(t!=="codex"&&a)throw new Error("--marketplace-root is only valid for --host codex");if(t==="codex"&&r==="project")throw new Error("Codex plugin installation supports user scope only");return{command:o,host:t,scope:r,installRoot:c,marketplaceRoot:a,projectRoot:s,dryRun:d}}function O({host:e,scope:o,projectRoot:t}){if(o==="project"){let r={"claude-code":".claude",opencode:".opencode","mimo-code":".mimocode"}[e];return n(t,r)}return e==="claude-code"?n(f(),".claude"):e==="opencode"?n(process.env.XDG_CONFIG_HOME||n(f(),".config"),"opencode"):e==="mimo-code"?process.env.MIMOCODE_HOME?m(process.env.MIMOCODE_HOME):process.platform==="win32"&&process.env.LOCALAPPDATA?n(process.env.LOCALAPPDATA,"mimocode"):n(process.env.XDG_CONFIG_HOME||n(f(),".config"),"mimocode"):n(f(),".agents","plugins")}async function v(e){try{let o=JSON.parse(await y(e,"utf8"));if(!o||typeof o!="object"||Array.isArray(o))throw new Error("marketplace.json must contain an object");if(!Array.isArray(o.plugins))throw new Error("marketplace.json must contain a plugins array");return o}catch(o){if(o?.code!=="ENOENT")throw o;return{name:"personal",interface:{displayName:"Personal"},plugins:[]}}}function S(){return{name:h,source:{source:"local",path:`./plugins/${h}`},policy:{installation:"AVAILABLE",authentication:"ON_INSTALL"},category:"Developer Tools"}}async function T(e){let o=e.marketplaceRoot||e.installRoot||O(e),t=n(o,"marketplace.json"),r=n(o,"plugins",h),c=await v(t),a=S(),s=c.plugins.findIndex(d=>d?.name===h);if(s>=0?c.plugins[s]=a:c.plugins.push(a),!e.dryRun){await w(r,{recursive:!0});for(let d of L)await A(n(p,d),n(r,d),{recursive:!0,force:!0});await w(o,{recursive:!0}),await E(t,`${JSON.stringify(c,null,2)}
+`,"utf8")}R({...e,root:r,skillsRoot:n(r,"skills"),agentsRoot:n(r,"agents"),extra:`MARKETPLACE: ${t}`})}function I(e,o){let t=e.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);if(!t)return e;let r=o==="claude-code"?new Set(["name","description","tools","disallowedTools","model","permissionMode","skills","memory","background","isolation"]):new Set(["name","description","mode","model","temperature","top_p","tools","permission","steps","hidden","color"]);return`---
+${t[1].split(/\r?\n/).filter(a=>{let s=a.match(/^([A-Za-z][A-Za-z0-9_-]*):/)?.[1];return!s||r.has(s)}).join(`
+`)}
+---
+${e.slice(t[0].length)}`}async function $(e){let o=e.installRoot||O(e),t=n(o,"skills"),r=n(o,"agents"),c=await g(n(p,"skills")),a=(await g(n(p,"agents"))).filter(s=>s.endsWith(".md"));if(!e.dryRun){await w(t,{recursive:!0});for(let s of c)await A(n(p,"skills",s),n(t,s),{recursive:!0,force:!0});await w(r,{recursive:!0});for(let s of a){let d=await y(n(p,"agents",s),"utf8");await E(n(r,s),I(d,e.host),"utf8")}}R({...e,root:o,skillsRoot:t,agentsRoot:r})}function R({host:e,scope:o,root:t,skillsRoot:r,agentsRoot:c,dryRun:a,extra:s}){process.stdout.write([a?"DRY_RUN: true":"INSTALLED: true",`HOST: ${e}`,`SCOPE: ${o}`,`ROOT: ${t}`,`SKILLS: ${r}`,`SUBAGENTS: ${c}`,s,""].filter(d=>d!==void 0).join(`
+`))}async function P(e){e.host==="codex"?await T(e):await $(e)}function _(){process.stdout.write(["DIC Workflow Kit multi-host installer","","Usage:","  dic-workflow-kit install [--host <host>] [--scope user|project]","                           [--project-root <path>] [--install-root <path>]","                           [--marketplace-root <path>] [--dry-run]","","Hosts:","  codex (default), claude-code, opencode, mimo-code","","Examples:","  dic-workflow-kit install","  dic-workflow-kit install --host claude-code","  dic-workflow-kit install --host opencode --scope project","  dic-workflow-kit install --host mimo-code --scope project","","--marketplace-root is a backward-compatible Codex-only option.","--install-root overrides the resolved host configuration directory.",""].join(`
+`))}try{let e=C(process.argv.slice(2));if(e.command==="install")await P(e);else if(e.command==="help"||e.command==="--help")_();else throw new Error(`unknown command: ${e.command}`)}catch(e){process.stderr.write(`ERROR: ${e.message}
+`),process.exitCode=1}

package/package.json

@@ -1,31 +1,26 @@
 {
   "name": "dic-workflow-kit",
-  "version": "1.0.0",
-  "description": "Install DIC Workflow Kit Skills and Subagents as a Codex plugin.",
+  "version": "1.1.0",
+  "description": "Install DIC Workflow Kit Skills and Subagents for Codex, Claude Code, OpenCode, and MiMo Code.",
   "type": "module",
   "bin": {
-    "dic-workflow-kit": "bin/dic-workflow-kit.mjs"
-  },
-  "scripts": {
-    "test": "python -m unittest discover -s tests -v && node --test tests/test_npm_installer.mjs",
-    "pack:check": "npm pack --dry-run"
+    "dic-workflow-kit": "dist/dic-workflow-kit.mjs"
   },
   "files": [
     ".codex-plugin/",
     "adapters/",
     "agents/",
-    "bin/",
+    "dist/",
     "schemas/",
-    "scripts/",
-    "!scripts/__pycache__/",
-    "!**/*.pyc",
     "skills/",
     "INSTRUCTION.md",
-    "README.md",
-    "README.zh-CN.md"
+    "README.md"
   ],
   "keywords": [
     "codex",
+    "claude-code",
+    "opencode",
+    "mimo-code",
     "plugin",
     "skills",
     "subagents",
@@ -39,6 +34,10 @@
     "url": "git+ssh://git@gitcode.com/TonyClaw/DICWorkflowKit.git"
   },
   "homepage": "https://gitcode.com/TonyClaw/DICWorkflowKit",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "engines": {
     "node": ">=20"
   }

package/skills/knowledge-bdd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: knowledge-bdd
-version: 1.0.0
+version: 1.1.0
 description: Derive Given-When-Then acceptance scenarios from confirmed design rules and flow contracts.
 ---
 

package/skills/knowledge-openspec/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: knowledge-openspec
-version: 1.0.0
+version: 1.1.0
 description: OpenSpec knowledge pack for proposals, specs, scenarios, tasks, changes, archived capabilities, validation, and design-to-implementation mapping.
 ---
 

package/skills/knowledge-repair-distill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: knowledge-repair-distill
-version: 1.0.0
+version: 1.1.0
 description: Generic repair convergence guidance, gap taxonomy, model steering hints, and validation gates for design-implementation consistency work.
 ---
 

package/skills/workflow-core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow-core
-version: 1.0.0
+version: 1.1.0
 description: Core Design-Implementation Consistency workflow contract, evidence model, handoff rules, and final output expectations.
 ---
 

package/skills/workflow-intake/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow-intake
-version: 1.0.0
+version: 1.1.0
 description: Discover authoritative design sources, implementation roots, test roots, protected paths, validation commands, and adapter hints.
 ---
 

package/skills/workflow-profile/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow-profile
-version: 1.0.0
+version: 1.1.0
 description: Build a normalized project profile for design-implementation consistency work without hardcoding a repository or technology stack.
 ---
 

package/skills/workflow-repair/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow-repair
-version: 1.0.0
+version: 1.1.0
 description: Guide source-backed implementation inspection, repair planning, code repair, validation loops, and final consistency evidence.
 ---
 

package/bin/dic-workflow-kit.mjs

@@ -1,150 +0,0 @@
-#!/usr/bin/env node
-
-import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const PLUGIN_NAME = "dic-workflow-kit";
-const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const PAYLOAD = [
-  ".codex-plugin",
-  "adapters",
-  "agents",
-  "schemas",
-  "scripts",
-  "skills",
-  "INSTRUCTION.md",
-  "README.md",
-  "README.zh-CN.md",
-];
-
-function parseArgs(argv) {
-  const command = argv[0] ?? "help";
-  let marketplaceRoot = join(homedir(), ".agents", "plugins");
-  let dryRun = false;
-  for (let index = 1; index < argv.length; index += 1) {
-    const value = argv[index];
-    if (value === "--marketplace-root") {
-      const next = argv[index + 1];
-      if (!next) {
-        throw new Error("--marketplace-root requires a directory");
-      }
-      marketplaceRoot = resolve(next);
-      index += 1;
-    } else if (value === "--dry-run") {
-      dryRun = true;
-    } else {
-      throw new Error(`unknown argument: ${value}`);
-    }
-  }
-  return { command, marketplaceRoot: resolve(marketplaceRoot), dryRun };
-}
-
-async function loadMarketplace(path) {
-  try {
-    const value = JSON.parse(await readFile(path, "utf8"));
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-      throw new Error("marketplace.json must contain an object");
-    }
-    if (!Array.isArray(value.plugins)) {
-      throw new Error("marketplace.json must contain a plugins array");
-    }
-    return value;
-  } catch (error) {
-    if (error?.code !== "ENOENT") {
-      throw error;
-    }
-    return {
-      name: "personal",
-      interface: { displayName: "Personal" },
-      plugins: [],
-    };
-  }
-}
-
-function pluginEntry() {
-  return {
-    name: PLUGIN_NAME,
-    source: {
-      source: "local",
-      path: `./plugins/${PLUGIN_NAME}`,
-    },
-    policy: {
-      installation: "AVAILABLE",
-      authentication: "ON_INSTALL",
-    },
-    category: "Developer Tools",
-  };
-}
-
-async function install({ marketplaceRoot, dryRun }) {
-  const marketplacePath = join(marketplaceRoot, "marketplace.json");
-  const pluginRoot = join(marketplaceRoot, "plugins", PLUGIN_NAME);
-  const marketplace = await loadMarketplace(marketplacePath);
-  const entry = pluginEntry();
-  const existingIndex = marketplace.plugins.findIndex(
-    (candidate) => candidate?.name === PLUGIN_NAME,
-  );
-  if (existingIndex >= 0) {
-    marketplace.plugins[existingIndex] = entry;
-  } else {
-    marketplace.plugins.push(entry);
-  }
-
-  if (!dryRun) {
-    await mkdir(pluginRoot, { recursive: true });
-    for (const relativePath of PAYLOAD) {
-      await cp(join(PACKAGE_ROOT, relativePath), join(pluginRoot, relativePath), {
-        recursive: true,
-        force: true,
-      });
-    }
-    await mkdir(marketplaceRoot, { recursive: true });
-    await writeFile(
-      marketplacePath,
-      `${JSON.stringify(marketplace, null, 2)}\n`,
-      "utf8",
-    );
-  }
-
-  process.stdout.write(
-    [
-      dryRun ? "DRY_RUN: true" : "INSTALLED: true",
-      `PLUGIN_ROOT: ${pluginRoot}`,
-      `MARKETPLACE: ${marketplacePath}`,
-      "SKILLS: skills/",
-      "SUBAGENTS: agents/",
-      "",
-    ].join("\n"),
-  );
-}
-
-function printHelp() {
-  process.stdout.write(
-    [
-      "DIC Workflow Kit Codex installer",
-      "",
-      "Usage:",
-      "  dic-workflow-kit install [--marketplace-root <path>] [--dry-run]",
-      "",
-      "Default destination:",
-      "  ~/.agents/plugins/plugins/dic-workflow-kit",
-      "",
-    ].join("\n"),
-  );
-}
-
-try {
-  const options = parseArgs(process.argv.slice(2));
-  if (options.command === "install") {
-    await install(options);
-  } else if (options.command === "help" || options.command === "--help") {
-    printHelp();
-  } else {
-    throw new Error(`unknown command: ${options.command}`);
-  }
-} catch (error) {
-  process.stderr.write(`ERROR: ${error.message}\n`);
-  process.exitCode = 1;
-}

package/scripts/dic_workflow.py

@@ -1,507 +0,0 @@
-#!/usr/bin/env python3
-"""Portable helper skeleton for DIC Workflow Kit.
-
-This script intentionally uses only the Python standard library.
-"""
-
-from __future__ import annotations
-
-import argparse
-import hashlib
-import json
-import os
-import re
-import shlex
-from pathlib import Path
-from typing import Any
-
-
-VERSION = "1.0.0"
-
-
-def write_text(path: Path, text: str) -> None:
-    path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_text(text, encoding="utf-8", newline="\n")
-
-
-def find_workflow_root(start: Path) -> Path:
-    current = start.resolve()
-    if current.is_file():
-        current = current.parent
-    for candidate in [current, *current.parents]:
-        if (candidate / "INSTRUCTION.md").exists():
-            return candidate
-    return current
-
-
-def rel(path: Path, root: Path) -> str:
-    try:
-        return path.resolve().relative_to(root.resolve()).as_posix()
-    except ValueError:
-        return path.as_posix()
-
-
-def extract_validation_commands(text: str, source: str) -> list[dict[str, Any]]:
-    commands = []
-    seen = set()
-    for value in re.findall(r"`([^`\r\n]+)`", text):
-        if not re.match(
-            r"^(?:npm\s+(?:run|test|exec)\b|npx\s+|pnpm\s+|yarn\s+|"
-            r"openspec\s+validate\b|pytest(?:\s|$)|python\s+|mvn\s+)",
-            value,
-        ):
-            continue
-        try:
-            command = shlex.split(value)
-        except ValueError:
-            continue
-        key = tuple(command)
-        if key in seen:
-            continue
-        seen.add(key)
-        commands.append(
-            {
-                "name": value,
-                "command": command,
-                "cwd": ".",
-                "source": source,
-                "kind": "suggested",
-            }
-        )
-    return commands
-
-
-def obligation_id(capability_id: str, kind: str, title: str) -> str:
-    digest = hashlib.sha256(
-        f"{capability_id}\0{kind}\0{title}".encode("utf-8")
-    ).hexdigest()[:12]
-    return f"obl-{digest}"
-
-
-def extract_openspec_obligations(
-    spec_path: Path,
-    project_root: Path,
-    capability_id: str,
-    authority: str,
-) -> list[dict[str, Any]]:
-    lines = spec_path.read_text(encoding="utf-8").splitlines()
-    obligations = []
-    current_requirement = None
-    index = 0
-    while index < len(lines):
-        line = lines[index]
-        requirement_match = re.match(r"^###\s+Requirement:\s*(.+?)\s*$", line)
-        scenario_match = re.match(r"^####\s+Scenario:\s*(.+?)\s*$", line)
-        if requirement_match:
-            title = requirement_match.group(1)
-            statement_lines = []
-            cursor = index + 1
-            while cursor < len(lines) and not re.match(
-                r"^#{3,4}\s+(?:Requirement|Scenario):", lines[cursor]
-            ):
-                value = lines[cursor].strip()
-                if value and not value.startswith("#"):
-                    statement_lines.append(value)
-                cursor += 1
-            current_requirement = obligation_id(capability_id, "requirement", title)
-            obligations.append(
-                {
-                    "id": current_requirement,
-                    "capabilityId": capability_id,
-                    "kind": "requirement",
-                    "title": title,
-                    "statement": " ".join(statement_lines),
-                    "source": rel(spec_path, project_root),
-                    "line": index + 1,
-                    "authority": authority,
-                    "parentId": None,
-                    "acceptanceClauses": [],
-                }
-            )
-        elif scenario_match:
-            title = scenario_match.group(1)
-            clauses = []
-            cursor = index + 1
-            while cursor < len(lines) and not re.match(
-                r"^#{3,4}\s+(?:Requirement|Scenario):", lines[cursor]
-            ):
-                clause_match = re.match(
-                    r"^\s*-\s+\*\*(GIVEN|WHEN|THEN|AND|BUT)\*\*\s*(.+?)\s*$",
-                    lines[cursor],
-                    flags=re.IGNORECASE,
-                )
-                if clause_match:
-                    clauses.append(
-                        {
-                            "keyword": clause_match.group(1).upper(),
-                            "text": clause_match.group(2),
-                            "line": cursor + 1,
-                        }
-                    )
-                cursor += 1
-            obligations.append(
-                {
-                    "id": obligation_id(capability_id, "scenario", title),
-                    "capabilityId": capability_id,
-                    "kind": "scenario",
-                    "title": title,
-                    "statement": " ".join(
-                        f"{item['keyword']} {item['text']}" for item in clauses
-                    ),
-                    "source": rel(spec_path, project_root),
-                    "line": index + 1,
-                    "authority": authority,
-                    "parentId": current_requirement,
-                    "acceptanceClauses": clauses,
-                }
-            )
-        index += 1
-    return obligations
-
-
-def build_obligation_catalog(
-    project_root: Path, design_entry: dict[str, Any]
-) -> dict[str, Any]:
-    use_baseline = design_entry["lifecycle"] == "archived" and design_entry["baselineSpecs"]
-    selected_specs = (
-        design_entry["baselineSpecs"] if use_baseline else design_entry["deltaSpecs"]
-    )
-    authority = "current-baseline" if use_baseline else "active-change"
-    obligations = []
-    for spec in selected_specs:
-        spec_path = project_root / spec
-        capability_id = spec_path.parent.name
-        obligations.extend(
-            extract_openspec_obligations(
-                spec_path, project_root, capability_id, authority
-            )
-        )
-    return {
-        "schema": "dic.contract-obligations.v1",
-        "version": VERSION,
-        "changeId": design_entry["changeId"],
-        "changeLifecycle": design_entry["lifecycle"],
-        "authorityPolicy": (
-            "Archived changes use promoted current baseline specs."
-            if use_baseline
-            else "Active changes use their delta specs."
-        ),
-        "sources": selected_specs,
-        "counts": {
-            "requirements": sum(item["kind"] == "requirement" for item in obligations),
-            "scenarios": sum(item["kind"] == "scenario" for item in obligations),
-            "total": len(obligations),
-        },
-        "obligations": obligations,
-    }
-
-
-def render_obligation_catalog(catalog: dict[str, Any]) -> str:
-    lines = [
-        "# Contract Obligations",
-        "",
-        f"- Change: `{catalog['changeId']}`",
-        f"- Lifecycle: {catalog['changeLifecycle']}",
-        f"- Authority: {catalog['authorityPolicy']}",
-        f"- Requirements: {catalog['counts']['requirements']}",
-        f"- Scenarios: {catalog['counts']['scenarios']}",
-        "",
-    ]
-    for item in catalog["obligations"]:
-        lines.extend(
-            [
-                f"## {item['id']} — {item['title']}",
-                "",
-                f"- Kind: {item['kind']}",
-                f"- Source: `{item['source']}:{item['line']}`",
-                f"- Authority: {item['authority']}",
-            ]
-        )
-        if item["parentId"]:
-            lines.append(f"- Parent: `{item['parentId']}`")
-        lines.extend(["", item["statement"] or "_No normative body extracted._", ""])
-    return "\n".join(lines)
-
-
-def resolve_design_map(project_root: Path, capability_ids: list[str]) -> dict[str, Any] | None:
-    map_path = project_root / "openspec" / "designs" / "spec-to-design-map.md"
-    if not map_path.exists():
-        return None
-    text = map_path.read_text(encoding="utf-8")
-    for line in text.splitlines():
-        if not line.lstrip().startswith("|"):
-            continue
-        cells = [cell.strip() for cell in line.strip().strip("|").split("|")]
-        if len(cells) < 5:
-            continue
-        capability = cells[0].strip("` ")
-        if capability not in capability_ids:
-            continue
-        linked_paths = []
-        for cell in cells[1:4]:
-            linked_paths.extend(re.findall(r"`(openspec/[^`]+\.md)`", cell))
-        linked_paths = list(dict.fromkeys(linked_paths))
-        return {
-            "source": rel(map_path, project_root),
-            "capabilityId": capability,
-            "architectureDesigns": [
-                path for path in linked_paths if "/designs/architecture/" in path
-            ],
-            "moduleDesigns": [
-                path for path in linked_paths if "/designs/modules/" in path
-            ],
-            "adrs": [path for path in linked_paths if "/designs/adr/" in path],
-            "validationSummary": cells[4],
-            "validationCommands": extract_validation_commands(cells[4], rel(map_path, project_root)),
-        }
-    return None
-
-
-def resolve_openspec_change(project_root: Path, change_id: str) -> dict[str, Any]:
-    candidates = [
-        ("active", project_root / "openspec" / "changes" / change_id),
-        ("archived", project_root / "openspec" / "changes" / "archive" / change_id),
-    ]
-    for lifecycle, change_root in candidates:
-        if not change_root.is_dir():
-            continue
-        delta_specs = sorted(change_root.glob("specs/**/spec.md"))
-        capability_ids = [
-            path.relative_to(change_root / "specs").parts[0] for path in delta_specs
-        ]
-        baseline_specs = []
-        for delta_spec in delta_specs:
-            relative_spec = delta_spec.relative_to(change_root / "specs")
-            baseline = project_root / "openspec" / "specs" / relative_spec
-            if baseline.exists():
-                baseline_specs.append(baseline)
-        documents = [
-            path
-            for path in [
-                change_root / "proposal.md",
-                change_root / "design.md",
-                change_root / "tasks.md",
-            ]
-            if path.exists()
-        ]
-        result = {
-            "type": "openspec-change",
-            "changeId": change_id,
-            "lifecycle": lifecycle,
-            "changeRoot": rel(change_root, project_root),
-            "documents": [rel(path, project_root) for path in documents],
-            "deltaSpecs": [rel(path, project_root) for path in delta_specs],
-            "baselineSpecs": [rel(path, project_root) for path in baseline_specs],
-        }
-        design_map = resolve_design_map(project_root, capability_ids)
-        if design_map:
-            result["designMap"] = design_map
-        return result
-    raise SystemExit(
-        f"OpenSpec change not found: {change_id} "
-        f"(checked active and archived changes under {project_root})"
-    )
-
-
-def detect_project(root: Path, change_id: str = "") -> dict[str, Any]:
-    project_root = root
-    openspec = list(project_root.glob("**/openspec/specs/**/spec.md")) + list(
-        project_root.glob("**/openspec/changes/**/proposal.md")
-    )
-    design_entry = resolve_openspec_change(project_root, change_id) if change_id else None
-    if design_entry:
-        selected = (
-            design_entry["documents"]
-            + design_entry["deltaSpecs"]
-            + design_entry["baselineSpecs"]
-        )
-        design_map = design_entry.get("designMap")
-        if design_map:
-            selected += [
-                design_map["source"],
-                *design_map["architectureDesigns"],
-                *design_map["moduleDesigns"],
-                *design_map["adrs"],
-            ]
-        design_sources = [project_root / path for path in selected]
-    else:
-        design_sources = []
-        for pattern in ["README*", "docs/**/*.md", "design/**/*.md", "spec/**/*.md", "api/**/*.md", "schemas/**/*"]:
-            design_sources.extend(project_root.glob(pattern))
-        for path in openspec:
-            if path not in design_sources:
-                design_sources.append(path)
-
-    impl_roots = [p for p in [project_root / "src", project_root / "app", project_root / "code"] if p.exists()]
-    test_roots = [p for p in [project_root / "test", project_root / "tests", project_root / "test-cases"] if p.exists()]
-    project_types = []
-    adapters = ["generic"]
-    if openspec:
-        project_types.append("openspec")
-        adapters.append("openspec")
-    if (project_root / "pom.xml").exists() or list(project_root.glob("**/pom.xml")):
-        project_types.append("maven")
-    if (project_root / "package.json").exists() or list(project_root.glob("**/package.json")):
-        project_types.append("node")
-
-    validation_commands = []
-    if design_entry:
-        for document in design_entry["documents"]:
-            path = project_root / document
-            validation_commands.extend(
-                extract_validation_commands(path.read_text(encoding="utf-8"), document)
-            )
-        if design_entry.get("designMap"):
-            validation_commands.extend(design_entry["designMap"]["validationCommands"])
-        if design_entry["lifecycle"] == "archived":
-            validation_commands = [
-                item
-                for item in validation_commands
-                if not (
-                    item["command"][:2] == ["openspec", "validate"]
-                    and "--all" not in item["command"]
-                )
-            ]
-        unique_commands = {}
-        for item in validation_commands:
-            unique_commands.setdefault(tuple(item["command"]), item)
-        validation_commands = list(unique_commands.values())
-
-    profile = {
-        "schema": "dic.project-profile.v1",
-        "version": VERSION,
-        "projectRoot": project_root.as_posix(),
-        "projectTypes": sorted(set(project_types)) or ["generic"],
-        "adapters": adapters,
-        "designSources": [rel(p, project_root) for p in sorted(set(design_sources))],
-        "implementationRoots": [rel(p, project_root) for p in impl_roots],
-        "testRoots": [rel(p, project_root) for p in test_roots],
-        "protectedPaths": [rel(p, project_root) for p in sorted(set(design_sources))],
-        "validationCommands": validation_commands,
-        "riskFamilies": ["requirements", "api-contract", "flow-completeness", "validation"],
-        "outputContract": {
-            "finalResultJson": "reports/FINAL_RESULT.json",
-            "finalOutputMd": "result/output.md",
-            "contractObligationsJson": "reports/contract-obligations.json",
-            "contractObligationsMd": "reports/contract-obligations.md",
-            "traceDir": "logs/trace"
-        }
-    }
-    if design_entry:
-        profile["designEntry"] = design_entry
-        profile["deltaSpecs"] = design_entry["deltaSpecs"]
-        profile["baselineSpecs"] = design_entry["baselineSpecs"]
-    return profile
-
-
-def command_init(args: argparse.Namespace) -> int:
-    root = Path(args.root or os.getcwd()).resolve()
-    output_root = Path(args.output_root).resolve() if args.output_root else root
-    for directory in ["reports", "result", "logs/trace"]:
-        (output_root / directory).mkdir(parents=True, exist_ok=True)
-    profile = detect_project(root, args.change)
-    profile_path = output_root / "reports" / "project-profile.json"
-    write_text(profile_path, json.dumps(profile, indent=2, ensure_ascii=False))
-    if profile.get("designEntry"):
-        catalog = build_obligation_catalog(root, profile["designEntry"])
-        write_text(
-            output_root / "reports" / "contract-obligations.json",
-            json.dumps(catalog, indent=2, ensure_ascii=False),
-        )
-        write_text(
-            output_root / "reports" / "contract-obligations.md",
-            render_obligation_catalog(catalog),
-        )
-    output = [
-        "# DIC Workflow Init",
-        "",
-        f"- Version: {VERSION}",
-        f"- Project root: `{root.as_posix()}`",
-        f"- Output root: `{output_root.as_posix()}`",
-        f"- Project profile: `{profile_path.as_posix()}`",
-        f"- Adapters: {', '.join(profile['adapters'])}",
-    ]
-    if profile.get("designEntry"):
-        entry = profile["designEntry"]
-        output.extend(
-            [
-                f"- Design entry: OpenSpec Change `{entry['changeId']}`",
-                f"- Change lifecycle: {entry['lifecycle']}",
-            ]
-        )
-    output.append("")
-    write_text(output_root / "logs" / "trace" / "init.md", "\n".join(output))
-    print(f"DIC_WORKFLOW_VERSION: {VERSION}")
-    print(f"PROJECT_ROOT: {root}")
-    print(f"OUTPUT_ROOT: {output_root}")
-    print(f"PROJECT_PROFILE: {profile_path}")
-    return 0
-
-
-def command_finalize(args: argparse.Namespace) -> int:
-    root = find_workflow_root(Path(args.root or os.getcwd()))
-    status = args.status.upper()
-    if status not in {"PASS", "PARTIAL", "BLOCKED", "FAIL"}:
-        raise SystemExit(f"invalid status: {args.status}")
-    result = {
-        "schema": "dic.final-result.v1",
-        "status": status,
-        "final": True,
-        "summary": args.summary,
-        "artifacts": [
-            "reports/project-profile.json",
-            "reports/contract-obligations.json",
-            "reports/contract-obligations.md",
-            "reports/final-consistency-report.md",
-            "reports/FINAL_RESULT.json",
-            "result/output.md",
-            "logs/trace/"
-        ],
-        "validation": [],
-        "changedFiles": [],
-        "residualRisks": []
-    }
-    write_text(root / "reports" / "FINAL_RESULT.json", json.dumps(result, indent=2, ensure_ascii=False))
-    lines = [
-        "# DIC Final Result",
-        "",
-        f"FINAL_EXECUTION_RESULT: {status}",
-        "FINAL_RESULT_FINAL: true",
-        "",
-        args.summary,
-        "",
-        "## Artifacts",
-        "",
-        "- `reports/FINAL_RESULT.json`",
-        "- `reports/contract-obligations.json`",
-        "- `reports/contract-obligations.md`",
-        "- `result/output.md`",
-        "- `logs/trace/`",
-        "",
-    ]
-    write_text(root / "result" / "output.md", "\n".join(lines))
-    print(f"FINAL_EXECUTION_RESULT: {status}")
-    return 0
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(prog="dic_workflow")
-    parser.add_argument("--root", default="")
-    parser.add_argument("--output-root", default="")
-    sub = parser.add_subparsers(dest="command", required=True)
-
-    p = sub.add_parser("init")
-    p.add_argument("--change", default="")
-    p.set_defaults(func=command_init)
-
-    p = sub.add_parser("finalize")
-    p.add_argument("--status", default="PARTIAL")
-    p.add_argument("--summary", default="DIC workflow finished with recorded evidence.")
-    p.set_defaults(func=command_finalize)
-
-    args = parser.parse_args()
-    return int(args.func(args))
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())