workflow-ledger 0.3.5 → 0.3.8

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
     {
       "name": "workflow-ledger",
       "description": "Lightweight, recoverable workflow ledger for Claude Code projects",
-      "version": "0.3.5",
+      "version": "0.3.8",
       "source": "./",
       "author": {
         "name": "MorseWayne"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "workflow-ledger",
   "description": "Lightweight, recoverable workflow ledger for Claude Code projects",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "author": {
     "name": "MorseWayne"
   },

package/README.md

@@ -94,18 +94,21 @@ npx workflow-ledger setup --tool codex
 npx workflow-ledger setup --tool all
 ```
 
-Then initialize a project ledger from the target project root:
+`setup` only installs the integration so supported agents can find it. It does not activate Workflow Ledger in every project.
+
+Then initialize a project ledger from the target project root. Bare `init` asks you to choose a language first; automation can pass `--lang en` or `--lang zh-CN` to skip the prompt:
 
 ```bash
 npx workflow-ledger init
-npx workflow-ledger init --tool claude-code
-npx workflow-ledger init --tool codex
-npx workflow-ledger init --tool all
+npx workflow-ledger init --lang en
+npx workflow-ledger init --tool claude-code --lang en
+npx workflow-ledger init --tool codex --lang en
+npx workflow-ledger init --tool all --lang en
 ```
 
-`setup` installs global tool integrations. `init` creates project-local ledger files and short instruction snippets. `claude-code` uses `.claude/WORKFLOW.md`; `codex` uses `.workflow-ledger/WORKFLOW.md` plus `AGENTS.md`.
+`init` is the activation step. It creates project-local ledger files and short instruction snippets. Without `init`, the skill stays dormant for ordinary development work. `claude-code` uses `.claude/WORKFLOW.md`; `codex` uses `.workflow-ledger/WORKFLOW.md` plus `AGENTS.md`. The language choice controls newly created ledger templates and tool instruction snippets; existing files are not overwritten.
 
-The Bash installer remains available for Claude Code project initialization:
+The Bash installer remains available for Claude Code project initialization. It uses the Node.js CLI internally, so Node.js 18 or newer is required:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/MorseWayne/workflow-ledger/main/install.sh | bash
@@ -131,11 +134,11 @@ mkdir -p ~/.claude/skills
 cp -R skills/workflow-ledger ~/.claude/skills/workflow-ledger
 ```
 
-The installer also copies a project-local CLI to `.claude/bin/workflow-ledger`:
+The CLI can check and summarize the ledger:
 
 ```bash
-.claude/bin/workflow-ledger doctor
-.claude/bin/workflow-ledger list
+npx workflow-ledger doctor
+npx workflow-ledger list
 ```
 
 See [docs/cli.md](docs/cli.md) for command details. The CLI is an optional guardrail; it does not replace the skill workflow.
@@ -153,7 +156,7 @@ Then invoke it in Claude Code:
 A project needs two layers:
 
 1. Global tool setup with `workflow-ledger setup` so supported agents can find the workflow instructions.
-2. Project initialization with `workflow-ledger init` so the repository has a ledger file and a short tool-specific reminder.
+2. Project initialization with `workflow-ledger init` so the repository has a ledger file and a short tool-specific reminder. This is what makes Workflow Ledger active for that project.
 
 For Claude Code, `init` adds the snippet from [examples/claude-project/CLAUDE.md.snippet](examples/claude-project/CLAUDE.md.snippet) to your project's `CLAUDE.md` and creates [skills/workflow-ledger/templates/WORKFLOW.md](skills/workflow-ledger/templates/WORKFLOW.md) at `.claude/WORKFLOW.md`.
 
@@ -190,7 +193,7 @@ Resume next:
 
 | Level | Use for | Ledger? |
 |---|---|---|
-| Level 0 | Q&A, read-only explanation | No |
+| Level 0 | Q&A, read-only explanation, tagging or release-version publishing | No |
 | Level 1 | typo, docs tweak, tiny config, no behavior change | Optional |
 | Level 2 | standard code work, tests, single-module behavior changes | Yes |
 | Level 3 | new features, cross-module work, public APIs, unclear or high-risk changes | Yes, attachments optional |
@@ -223,4 +226,4 @@ Skip it for:
 
 ## Repository status
 
-This version supports both npm setup and the legacy Bash installer. The CLI can install Workflow Ledger for Claude Code, Codex, or both, while keeping the ledger format lightweight and tool-readable.
+This version uses the Node.js CLI as the single implementation for setup, init, doctor, list, and hooks. The Bash installer remains as a small bootstrap wrapper for Claude Code project initialization.

package/README.zh-CN.md

@@ -92,18 +92,21 @@ npx workflow-ledger setup --tool codex
 npx workflow-ledger setup --tool all
 ```
 
-然后在目标项目根目录初始化 ledger：
+`setup` 只安装工具接入，让支持的 agent 能找到它；它不会让 Workflow Ledger 在所有项目里自动生效。
+
+然后在目标项目根目录初始化 ledger。裸 `init` 会先交互式选择语言；自动化脚本可传 `--lang en` 或 `--lang zh-CN` 跳过交互：
 
 ```bash
 npx workflow-ledger init
-npx workflow-ledger init --tool claude-code
-npx workflow-ledger init --tool codex
-npx workflow-ledger init --tool all
+npx workflow-ledger init --lang zh-CN
+npx workflow-ledger init --tool claude-code --lang zh-CN
+npx workflow-ledger init --tool codex --lang zh-CN
+npx workflow-ledger init --tool all --lang zh-CN
 ```
 
-`setup` 安装全局工具接入；`init` 创建项目本地 ledger 和短指令片段。`claude-code` 使用 `.claude/WORKFLOW.md`；`codex` 使用 `.workflow-ledger/WORKFLOW.md` 和 `AGENTS.md`。
+`init` 是启用步骤。它创建项目本地 ledger 和短指令片段。没有 `init` 时，本 skill 对普通开发任务保持 dormant。`claude-code` 使用 `.claude/WORKFLOW.md`；`codex` 使用 `.workflow-ledger/WORKFLOW.md` 和 `AGENTS.md`。语言选择会影响新创建的 ledger 模板和工具指令片段；已有文件不会被覆盖。
 
-Bash 安装器仍可用于 Claude Code 项目初始化：
+Bash 安装器仍可用于 Claude Code 项目初始化。它内部使用 Node.js CLI，因此需要 Node.js 18 或更高版本：
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/MorseWayne/workflow-ledger/main/install.sh | bash
@@ -129,11 +132,11 @@ mkdir -p ~/.claude/skills
 cp -R skills/workflow-ledger ~/.claude/skills/workflow-ledger
 ```
 
-安装器也会把项目本地 CLI 复制到 `.claude/bin/workflow-ledger`：
+CLI 可以检查和汇总 ledger：
 
 ```bash
-.claude/bin/workflow-ledger doctor
-.claude/bin/workflow-ledger list
+npx workflow-ledger doctor
+npx workflow-ledger list
 ```
 
 详见 [docs/cli.md](docs/cli.md)。CLI 是可选保护栏，不替代 skill 工作流。
@@ -151,7 +154,7 @@ cp -R skills/workflow-ledger ~/.claude/skills/workflow-ledger
 项目接入分两层：
 
 1. 先用 `workflow-ledger setup` 做全局工具接入，让支持的 agent 能找到工作流指令。
-2. 再用 `workflow-ledger init` 初始化项目，让仓库里有 ledger 文件和短工具提醒。
+2. 再用 `workflow-ledger init` 初始化项目，让仓库里有 ledger 文件和短工具提醒。这一步才会让 Workflow Ledger 在该项目生效。
 
 对 Claude Code，`init` 会把 [examples/claude-project/CLAUDE.md.snippet](examples/claude-project/CLAUDE.md.snippet) 加入项目 `CLAUDE.md`，并把 [skills/workflow-ledger/templates/WORKFLOW.md](skills/workflow-ledger/templates/WORKFLOW.md) 创建到 `.claude/WORKFLOW.md`。
 
@@ -188,7 +191,7 @@ Resume next:
 
 | Level | 适用场景 | 是否写 ledger |
 |---|---|---|
-| Level 0 | 问答、只读解释 | 不需要 |
+| Level 0 | 问答、只读解释、新增 tag 或发布版本 | 不需要 |
 | Level 1 | typo、文档小改、小配置、无行为变化 | 可选 |
 | Level 2 | 标准代码修改、测试、单模块行为变更 | 需要 |
 | Level 3 | 新功能、跨模块、公共 API、不明确或高风险变更 | 需要，可选附件 |
@@ -221,4 +224,4 @@ Resume next:
 
 ## 当前状态
 
-当前版本同时支持 npm setup 和旧的 Bash installer。CLI 可以为 Claude Code、Codex 或两者安装 Workflow Ledger，同时保持 ledger 格式轻量、可被多个工具读取。
+当前版本以 Node.js CLI 作为 setup、init、doctor、list 和 hooks 的唯一实现。Bash 安装器保留为 Claude Code 项目初始化的轻量 bootstrap wrapper。