dic-workflow-kit 1.1.0 → 1.1.1

package/.codex-plugin/plugin.json

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

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to DIC Workflow Kit are documented in this file.
+
+The project follows [Semantic Versioning](https://semver.org/). Both npm packages, `dic-workflow-kit` and `@tonyclaw/dic-workflow-kit`, always use the same version and runtime payload.
+
+## [1.1.1] - 2026-07-27
+
+### Added
+
+- Added this changelog.
+- Added complete Chinese and English user guides covering installation, workflow prompts, OpenSpec Change usage, output interpretation, and troubleshooting.
+
+### Changed
+
+- Made the unscoped `npx dic-workflow-kit@<version>` command the recommended one-shot installation entry for consistent Windows behavior.
+- Updated version synchronization so both scoped and unscoped npm examples advance with each release.
+
+### Security and packaging
+
+- Kept the npm release as a runtime-only package: no development CLI source, Python helper, tests, release scripts, PowerPoint files, temporary files, or source maps.
+- Retained only the minified installer runtime and the Skills, Subagents, schemas, adapters, manifests, and user documentation required to use the kit.
+
+## [1.1.0] - 2026-07-27
+
+### Added
+
+- Added one npm installer for Codex, Claude Code, OpenCode, and MiMo Code.
+- Added user-level and project-level installation for supported hosts.
+- Added host-specific Subagent frontmatter adaptation.
+- Added convergent dual publishing for `dic-workflow-kit` and `@tonyclaw/dic-workflow-kit`.
+- Added isolated installation tests for all four hosts.
+
+### Changed
+
+- Promoted the package from a Codex-only installer to a multi-host runtime.
+- Published the CLI as a minified runtime and removed development source files from npm artifacts.
+
+## [1.0.0] - 2026-07-27
+
+### Added
+
+- Initial npm release.
+- Included seven workflow and knowledge Skills.
+- Included nine evidence-producing Subagents.
+- Added Codex personal marketplace installation.
+- Added OpenSpec intake, obligation extraction, BDD knowledge, repair planning, validation, and final evidence contracts.

package/README.md

@@ -1,6 +1,8 @@
 # Design-Implementation Consistency Workflow Kit
 
-Version: `1.1.0`
+Version: `1.1.1`
+
+[Changelog](CHANGELOG.md)
 
 Design-Implementation Consistency Workflow Kit, or DIC Workflow Kit, is a portable agentic workflow package for checking and repairing whether implementation matches design intent.
 
@@ -17,23 +19,23 @@ The npm package contains all seven Skills and all nine Subagents and installs th
 Codex remains the default, so the original command is backward compatible:
 
 ```text
-npx @tonyclaw/dic-workflow-kit@1.1.0 install
+npx dic-workflow-kit@1.1.1 install
 ```
 
 Select another host explicitly:
 
 ```text
-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
+npx dic-workflow-kit@1.1.1 install --host claude-code
+npx dic-workflow-kit@1.1.1 install --host opencode
+npx dic-workflow-kit@1.1.1 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
+npx dic-workflow-kit@1.1.1 install --host claude-code --scope project
+npx dic-workflow-kit@1.1.1 install --host opencode --scope project
+npx dic-workflow-kit@1.1.1 install --host mimo-code --scope project
 ```
 
 The host mappings are:
@@ -50,7 +52,7 @@ On Windows, MiMo Code's user root resolves to `%LOCALAPPDATA%\mimocode`; `MIMOCO
 You can also install the CLI globally:
 
 ```text
-npm install --global @tonyclaw/dic-workflow-kit@1.1.0
+npm install --global @tonyclaw/dic-workflow-kit@1.1.1
 dic-workflow-kit install --host opencode
 ```
 
@@ -63,6 +65,100 @@ dic-workflow-kit install
 
 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.
 
+## How to use it
+
+### 1. Start the Coding Agent in your project root
+
+After installation, enter the repository you want to inspect and restart Codex, Claude Code, OpenCode, or MiMo Code. An existing session may not discover a newly created Skills/agents directory immediately.
+
+```text
+cd /path/to/your-project
+```
+
+### 2. Start the workflow with a prompt
+
+This prompt works across all four hosts:
+
+```text
+Use DIC Workflow Kit to check design-implementation consistency in this project.
+First identify authoritative design sources and protected paths, then build the
+project profile. Map source-backed obligations to implementation, inspect gaps,
+plan repairs only where design evidence exists, run project-declared validation,
+and report the final consistency status and residual risks.
+```
+
+For an audit that must not modify code:
+
+```text
+Use DIC Workflow Kit to audit this project without modifying files.
+Report design obligations, implementation gaps, evidence locations,
+recommended repairs, and residual risks.
+```
+
+For an evidence-bounded repair:
+
+```text
+Use DIC Workflow Kit to inspect and repair this project.
+Repair only gaps traceable to authoritative design sources. Run relevant
+validation after each change; stop expanding changes when validation fails
+and record the blocker.
+```
+
+### 3. Check one OpenSpec Change
+
+Provide the Change ID explicitly to reduce search scope and avoid treating historical changes as current truth:
+
+```text
+Use DIC Workflow Kit to check the OpenSpec Change
+2026-06-09-add-ts-local-skill-source.
+Start from its proposal, design, tasks, and delta specs. Cross-check the current
+stable specs, implementation, and tests. Produce an obligation matrix,
+implementation gaps, and a validation conclusion.
+```
+
+For an archived Change, archived files remain historical context while the promoted current stable Spec becomes the authoritative baseline.
+
+### 4. Invoke the core Skill explicitly
+
+On hosts that expose slash Skills, start with:
+
+```text
+/workflow-core
+```
+
+You can also name the required Skills directly:
+
+```text
+Use workflow-core, workflow-intake, workflow-profile, and
+knowledge-openspec to inspect the current OpenSpec change.
+```
+
+You do not need to start all nine Subagents manually. The primary Agent should select roles according to evidence dependencies and require every delegation to produce an artifact consumed by a downstream step.
+
+### 5. Read the results
+
+Start with these outputs:
+
+| File | Purpose |
+| --- | --- |
+| `reports/project-profile.json` | Project structure, design sources, protected paths, and validation commands |
+| `reports/contract-obligations.md` | Human-readable design obligations with source anchors |
+| `reports/implementation-gaps.md` | Confirmed implementation gaps |
+| `reports/repair-plan.md` | Source-backed repair plan with stop conditions |
+| `reports/final-consistency-report.md` | Final consistency conclusion and residual risks |
+| `reports/FINAL_RESULT.json` | Machine-readable terminal status |
+| `logs/trace/` | Intake, delegation, change, and validation evidence |
+
+Terminal status is always `PASS`, `PARTIAL`, `BLOCKED`, or `FAIL`. `PASS` means the evidence chain and validation gates are satisfied, not merely that visible tests happen to pass.
+
+### Troubleshooting
+
+- **A Skill or Subagent is missing:** restart the Coding Agent and use `--dry-run` to confirm the resolved install root.
+- **Only this repository should use the kit:** add `--scope project` for Claude Code, OpenCode, or MiMo Code.
+- **The project does not use OpenSpec:** use design documents, APIs, schemas, READMEs, or product requirements as authoritative design sources.
+- **A validation tool is unavailable:** record the missing command and environment evidence, and finish as `BLOCKED` or `PARTIAL`; do not claim success.
+- **Do green tests prove consistency:** no. Requirements, branches, state transitions, side effects, and integration flows must also match the design.
+
 ### Dual npm release
 
 Every release publishes the same version and payload under both npm names:
@@ -73,7 +169,7 @@ Every release publishes the same version and payload under both npm names:
 `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:set-version -- 1.1.1
 npm run release:plan
 npm run release:dual:dry-run
 npm run release:dual

package/README.zh-CN.md

@@ -1,6 +1,8 @@
 # 设计—实现一致性 Workflow Kit
 
-版本：`1.1.0`
+版本：`1.1.1`
+
+[更新日志](CHANGELOG.md)
 
 Design-Implementation Consistency Workflow Kit，简称 DIC Workflow Kit，是一套可移植的智能体工作流包，用于检查和修复“代码实现是否符合设计意图”。
 
@@ -15,23 +17,23 @@ npm 包完整包含 7 个 Skills 和 9 个 Subagents，并支持 Codex、Claude
 Codex 仍是默认宿主，原命令保持兼容：
 
 ```text
-npx @tonyclaw/dic-workflow-kit@1.1.0 install
+npx dic-workflow-kit@1.1.1 install
 ```
 
 安装到其他宿主时显式指定 `--host`：
 
 ```text
-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
+npx dic-workflow-kit@1.1.1 install --host claude-code
+npx dic-workflow-kit@1.1.1 install --host opencode
+npx dic-workflow-kit@1.1.1 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
+npx dic-workflow-kit@1.1.1 install --host claude-code --scope project
+npx dic-workflow-kit@1.1.1 install --host opencode --scope project
+npx dic-workflow-kit@1.1.1 install --host mimo-code --scope project
 ```
 
 | 宿主 | 用户级目录 | 项目级目录 |
@@ -46,7 +48,7 @@ Windows 上 MiMo Code 的用户级根目录为 `%LOCALAPPDATA%\mimocode`；适
 也可以先全局安装 CLI：
 
 ```text
-npm install --global @tonyclaw/dic-workflow-kit@1.1.0
+npm install --global @tonyclaw/dic-workflow-kit@1.1.1
 dic-workflow-kit install --host opencode
 ```
 
@@ -59,6 +61,96 @@ dic-workflow-kit install
 
 使用 `--dry-run` 预演目标目录，使用 `--install-root <path>` 指定隔离的宿主根目录；Codex 仍兼容 `--marketplace-root <path>`。首次创建 Skills 或 agents 目录后，请重启或重新加载对应 Coding Agent 会话。
 
+## 用户如何使用
+
+### 1. 在项目根目录启动 Coding Agent
+
+安装完成后，进入需要检查的代码仓库，重新启动 Codex、Claude Code、OpenCode 或 MiMo Code。第一次安装新 Skills/agents 目录时，已有会话可能无法立即发现它们。
+
+```text
+cd /path/to/your-project
+```
+
+### 2. 用自然语言启动工作流
+
+下面这条提示词适用于四种宿主：
+
+```text
+使用 DIC Workflow Kit 检查当前项目的设计—实现一致性。
+先识别权威设计源和受保护路径，生成项目画像；
+然后建立需求义务、检查实现缺口，只对有设计证据的问题规划修复；
+运行项目声明的验证命令，最后输出一致性结论和残余风险。
+```
+
+如果只希望审计、不允许修改代码：
+
+```text
+使用 DIC Workflow Kit 审计当前项目，但不要修改任何文件。
+输出设计义务、实现缺口、证据位置、建议修复和残余风险。
+```
+
+如果希望检查并修复：
+
+```text
+使用 DIC Workflow Kit 检查并修复当前项目。
+仅修复能够追溯到权威设计源的缺口；每次修改后执行相关验证，
+验证失败时停止扩散修改并记录阻塞原因。
+```
+
+### 3. 检查一个 OpenSpec Change
+
+明确给出 Change ID，可以减少搜索范围并避免把历史 Change 当成当前事实：
+
+```text
+使用 DIC Workflow Kit 检查 OpenSpec Change
+2026-06-09-add-ts-local-skill-source。
+以该 Change 的 proposal、design、tasks 和增量 specs 为入口，
+同时核对当前稳定 specs、实现和测试，输出义务矩阵、实现缺口和验证结论。
+```
+
+如果 Change 已归档，工作流会将归档内容作为历史上下文，并以当前已经提升的稳定 Spec 为权威基线。
+
+### 4. 显式调用核心 Skill
+
+支持斜杠 Skill 的宿主可以先输入：
+
+```text
+/workflow-core
+```
+
+也可以在提示词中直接写出需要使用的 Skill：
+
+```text
+使用 workflow-core、workflow-intake、workflow-profile 和
+knowledge-openspec 检查当前 OpenSpec 变更。
+```
+
+不需要手工逐个启动 9 个 Subagents。主 Agent 应按照证据依赖关系选择角色，并保证每个委派都有被下游消费的产物。
+
+### 5. 查看结果
+
+默认应重点查看：
+
+| 文件 | 用途 |
+| --- | --- |
+| `reports/project-profile.json` | 项目结构、设计源、保护路径和验证命令 |
+| `reports/contract-obligations.md` | 人可读的设计义务与来源 |
+| `reports/implementation-gaps.md` | 已确认的实现缺口 |
+| `reports/repair-plan.md` | 带来源锚点和停止条件的修复计划 |
+| `reports/final-consistency-report.md` | 最终一致性结论与残余风险 |
+| `reports/FINAL_RESULT.json` | 机器可读的最终状态 |
+| `logs/trace/` | Intake、委派、修改和验证证据 |
+
+最终状态只使用 `PASS`、`PARTIAL`、`BLOCKED` 或 `FAIL`。`PASS` 表示证据链和验证均满足要求，并不只是“测试刚好通过”。
+
+### 常见问题
+
+- **找不到 Skill/Subagent**：重启 Coding Agent，并使用 `--dry-run` 检查安装目标。
+- **只想当前仓库使用**：Claude Code、OpenCode、MiMo Code 安装时增加 `--scope project`。
+- **项目没有 OpenSpec**：仍可使用设计文档、API、Schema、README 或产品需求作为权威设计源。
+- **缺少验证工具**：记录缺失的命令和环境原因，最终状态应为 `BLOCKED` 或 `PARTIAL`，不要伪造成功。
+- **测试通过是否等于一致**：不等于。还必须确认需求、分支、状态迁移、副作用及集成流程符合设计。
+
 ### 双 npm 包发布
 
 每次发布必须以相同版本、相同内容发布两个包名：
@@ -69,7 +161,7 @@ dic-workflow-kit install
 `package.json` 是唯一版本源。版本脚本会同步 Codex 插件清单、工作流脚本、全部 Skills、全部 Subagents 和中英文 README：
 
 ```text
-npm run release:set-version -- 1.1.0
+npm run release:set-version -- 1.1.1
 npm run release:plan
 npm run release:dual:dry-run
 npm run release:dual

package/agents/code-repairer.md

@@ -1,6 +1,6 @@
 ---
 name: code-repairer
-version: 1.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 description: Discover, run, and summarize project validation commands using evaluator-readable evidence.
 mode: subagent
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dic-workflow-kit",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Install DIC Workflow Kit Skills and Subagents for Codex, Claude Code, OpenCode, and MiMo Code.",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
     "dist/",
     "schemas/",
     "skills/",
+    "CHANGELOG.md",
     "INSTRUCTION.md",
     "README.md"
   ],

package/skills/knowledge-bdd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: knowledge-bdd
-version: 1.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 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.1.0
+version: 1.1.1
 description: Guide source-backed implementation inspection, repair planning, code repair, validation loops, and final consistency evidence.
 ---