dw-kit 1.1.0 → 1.2.1

package/README.md

@@ -1,119 +1,127 @@
-# dw-kit
-
-> An AI development workflow toolkit for teams using agentic IDEs (Claude Code, Cursor) — from idea to review-ready commits.
-
-**v1.0** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md)
-
----
-
-## What is dw-kit?
-
-dw-kit helps your team run AI-assisted development with a **repeatable workflow** and clear checkpoints:
-
-```
-Initialize → Understand → Plan → Execute (TDD) → Verify → Close
-```
-
-<img src="docs/workflow-diagram.svg" alt="dw-kit workflow diagram" />
-
-## Workflow overview
-
-`dw` runs a 6-phase process (all phases for `standard` and `thorough`):
-
-Initialize → Understand → Plan (stops for approval) → Execute (TDD; 1 commit per subtask) → Verify (quality gates + review sign-off) → Close (handoff + archive when done).
-
-### 6 phases (full workflow)
-- **Initialize**: clarify task scope and set up the workspace + task docs.
-- **Understand**: survey the codebase, dependencies, patterns, and test coverage (no implementation).
-- **Plan**: design the solution and subtasks; **pause for your approval**.
-- **Execute**: implement using **TDD**; each subtask produces a commit.
-- **Verify**: run quality gates + review sign-off to ensure correctness and safety.
-- **Close**: handoff notes, finalize progress, and archive when done.
-
-It’s designed for collaboration (Dev / Tech Lead / QA / PM) and keeps work auditable via lightweight task docs.
-
----
-
-## Install
-
-```bash
-npm install -g dw-kit
-```
-
----
-
-## Quick start
-
-Setup dw in project directory:
-
-```bash
-dw init
-```
-
-Then in **Claude Code CLI**, run the full workflow:
-
-```
-/dw-flow your-task-or-anythings
-```
-
----
-
-Discover other skills:
-
-```
-/dw-prompt
-/dw-thinking
-...
-
-```
-
----
-
-## CLI commands
-
-```bash
-dw init                 # setup wizard / presets
-dw validate             # validate .dw/config/dw.config.yml
-dw doctor               # installation health check
-dw upgrade              # update toolkit files (override-aware)
-dw upgrade --check      # check for updates only
-dw upgrade --dry-run    # preview changes
-dw prompt               # build a well-structured task prompt (autocomplete + wizard)
-dw prompt --text "..."  # non-interactive: structure a description directly
-dw claude-vn-fix        # patch Claude CLI to fix Vietnamese IME (backup/restore)
-```
-
-`dw claude-vn-fix` patches the local Claude CLI bundle to fix Vietnamese IME input (DEL char `\x7f` issue). Includes auto-backup and rollback.
-
----
-
-## Depth system
-
-Pick a default depth for your project, then override per task when risk increases.
-
-| Depth | Best for | Workflow |
-|-------|----------|----------|
-| `quick` | Solo dev, hotfix, familiar code | Understand → Execute → Close |
-| `standard` | Small teams, new features | Full 6 phases |
-| `thorough` | Risky changes (API/DB/security) | Full workflow + arch-review + test-plan |
-
-Configured in `.dw/config/dw.config.yml`:
-
-```yaml
-workflow:
-  default_depth: "standard"
-```
-
----
-
-## What gets added to your repo?
-
-```
-.dw/        # methodology, config, adapters, task docs
-.claude/    # Claude Code: skills, hooks, agents, rules
-CLAUDE.md   # project context for the agent
-```
-
----
-
-Maintainer: [huygdv](mailto:huygdv19@gmail.com)
+# dw-kit
+
+> An AI development workflow toolkit for teams using agentic IDEs (Claude Code, Cursor) — from idea to review-ready commits.
+
+**v1.2** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md) · [Changelog](CHANGELOG.md#v120--2026-04-09)
+
+---
+
+## What is dw-kit?
+
+dw-kit helps your team run AI-assisted development with a **repeatable workflow** and clear checkpoints:
+
+```
+Initialize → Understand → Plan → Execute (TDD) → Verify → Close
+```
+
+<img src="docs/workflow-diagram.svg" alt="dw-kit workflow diagram" />
+
+## Workflow overview
+
+`dw` runs a 6-phase process (all phases for `standard` and `thorough`):
+
+Initialize → Understand → Plan (stops for approval) → Execute (TDD; 1 commit per subtask) → Verify (quality gates + review sign-off) → Close (handoff + archive when done).
+
+### 6 phases (full workflow)
+- **Initialize**: clarify task scope and set up the workspace + task docs.
+- **Understand**: survey the codebase, dependencies, patterns, and test coverage (no implementation).
+- **Plan**: design the solution and subtasks; **pause for your approval**.
+- **Execute**: implement using **TDD**; each subtask produces a commit.
+- **Verify**: run quality gates + review sign-off to ensure correctness and safety.
+- **Close**: handoff notes, finalize progress, and archive when done.
+
+It’s designed for collaboration (Dev / Tech Lead / QA / PM) and keeps work auditable via lightweight task docs.
+
+---
+
+## Release notes
+
+- v1.2.0 notes: [`CHANGELOG.md#v120--2026-04-09`](CHANGELOG.md#v120--2026-04-09)
+- Full changelog: `CHANGELOG.md`
+- Latest release notes: [GitHub Releases](https://github.com/dv-workflow/dv-workflow/releases)
+
+---
+
+## Install
+
+```bash
+npm install -g dw-kit
+```
+
+---
+
+## Quick start
+
+Setup dw in project directory:
+
+```bash
+dw init
+```
+
+Then in **Claude Code CLI**, run the full workflow:
+
+```
+/dw-flow your-task-or-anythings
+```
+
+---
+
+Discover other skills:
+
+```
+/dw-prompt
+/dw-thinking
+...
+
+```
+
+---
+
+## CLI commands
+
+```bash
+dw init                 # setup wizard / presets
+dw validate             # validate .dw/config/dw.config.yml
+dw doctor               # installation health check
+dw upgrade              # update toolkit files (override-aware)
+dw upgrade --check      # check for updates only
+dw upgrade --dry-run    # preview changes
+dw prompt               # build a well-structured task prompt (autocomplete + wizard)
+dw prompt --text "..."  # non-interactive: structure a description directly
+dw claude-vn-fix        # patch Claude CLI to fix Vietnamese IME (backup/restore)
+```
+
+`dw claude-vn-fix` patches the local Claude CLI bundle to fix Vietnamese IME input (DEL char `\x7f` issue). Includes auto-backup and rollback.
+
+---
+
+## Depth system
+
+Pick a default depth for your project, then override per task when risk increases.
+
+| Depth | Best for | Workflow |
+|-------|----------|----------|
+| `quick` | Solo dev, hotfix, familiar code | Understand → Execute → Close |
+| `standard` | Small teams, new features | Full 6 phases |
+| `thorough` | Risky changes (API/DB/security) | Full workflow + arch-review + test-plan |
+
+Configured in `.dw/config/dw.config.yml`:
+
+```yaml
+workflow:
+  default_depth: "standard"
+```
+
+---
+
+## What gets added to your repo?
+
+```
+.dw/        # methodology, config, adapters, task docs
+.claude/    # Claude Code: skills, hooks, agents, rules
+CLAUDE.md   # project context for the agent
+```
+
+---
+
+Maintainer: [huygdv](mailto:huygdv19@gmail.com)

package/package.json

@@ -1,57 +1,84 @@
-{
-  "name": "dw-kit",
-  "version": "1.1.0",
-  "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
-  "type": "module",
-  "bin": {
-    "dw": "bin/dw.mjs"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    ".dw/core/",
-    ".dw/config/",
-    ".dw/adapters/",
-    "scripts/",
-    ".claude/agents/",
-    ".claude/hooks/",
-    ".claude/rules/",
-    ".claude/skills/",
-    ".claude/templates/",
-    ".claude/settings.json",
-    "CLAUDE.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "test": "node src/smoke-test.mjs",
-    "link": "npm link",
-    "test:e2e-local": "bash scripts/e2e-local-check.sh"
-  },
-  "keywords": [
-    "ai",
-    "workflow",
-    "claude",
-    "cursor",
-    "development",
-    "toolkit",
-    "tdd",
-    "code-review",
-    "agent"
-  ],
-  "author": "huygdv <huygdv19@gmail.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/dv-workflow/dv-workflow.git"
-  },
-  "homepage": "https://github.com/dv-workflow/dv-workflow#readme",
-  "dependencies": {
-    "ajv": "^8.18.0",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.3",
-    "enquirer": "^2.4.1",
-    "js-yaml": "^4.1.1"
-  }
-}
+{
+  "name": "dw-kit",
+  "version": "1.2.1",
+  "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
+  "type": "module",
+  "bin": {
+    "dw": "bin/dw.mjs"
+  },
+  "files": [
+    "bin/",
+    "src/cli.mjs",
+    "src/commands/",
+    "src/lib/",
+    ".dw/core/",
+    ".dw/config/",
+    ".dw/adapters/",
+    ".claude/agents/",
+    ".claude/hooks/",
+    ".claude/rules/",
+    ".claude/skills/dw-arch-review/",
+    ".claude/skills/dw-archive/",
+    ".claude/skills/dw-commit/",
+    ".claude/skills/dw-config-init/",
+    ".claude/skills/dw-config-validate/",
+    ".claude/skills/dw-dashboard/",
+    ".claude/skills/dw-debug/",
+    ".claude/skills/dw-docs-update/",
+    ".claude/skills/dw-estimate/",
+    ".claude/skills/dw-execute/",
+    ".claude/skills/dw-flow/",
+    ".claude/skills/dw-handoff/",
+    ".claude/skills/dw-kit-report/",
+    ".claude/skills/dw-log-work/",
+    ".claude/skills/dw-onboard/",
+    ".claude/skills/dw-plan/",
+    ".claude/skills/dw-prompt/",
+    ".claude/skills/dw-requirements/",
+    ".claude/skills/dw-research/",
+    ".claude/skills/dw-retroactive/",
+    ".claude/skills/dw-review/",
+    ".claude/skills/dw-rollback/",
+    ".claude/skills/dw-sprint-review/",
+    ".claude/skills/dw-task-init/",
+    ".claude/skills/dw-test-plan/",
+    ".claude/skills/dw-thinking/",
+    ".claude/skills/dw-upgrade/",
+    ".claude/templates/",
+    ".claude/settings.json",
+    "CLAUDE.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node src/smoke-test.mjs",
+    "link": "npm link",
+    "test:e2e-local": "bash scripts/e2e-local-check.sh"
+  },
+  "keywords": [
+    "ai",
+    "workflow",
+    "claude",
+    "cursor",
+    "development",
+    "toolkit",
+    "tdd",
+    "code-review",
+    "agent"
+  ],
+  "author": "huygdv <huygdv19@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dv-workflow/dv-workflow.git"
+  },
+  "homepage": "https://github.com/dv-workflow/dv-workflow#readme",
+  "dependencies": {
+    "ajv": "^8.18.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "enquirer": "^2.4.1",
+    "js-yaml": "^4.1.1"
+  }
+}

package/src/cli.mjs

@@ -1,92 +1,100 @@
-import { Command } from 'commander';
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import chalk from 'chalk';
-import { getUpdateNotice, scheduleUpdateCheck } from './lib/update-checker.mjs';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const require = createRequire(import.meta.url);
-const pkg = require(join(__dirname, '..', 'package.json'));
-
-export function run(argv) {
-  // Show cached update notice (non-blocking), then schedule fresh check in background
-  const latestVersion = getUpdateNotice(pkg.version);
-  scheduleUpdateCheck(pkg.version);
-
-  const program = new Command();
-
-  program
-    .name('dw')
-    .description('dw-kit — AI development workflow toolkit')
-    .version(pkg.version, '-v, --version');
-
-  program
-    .command('init')
-    .description('Setup dw-kit in current project (interactive wizard)')
-    .option('-p, --preset <name>', 'Use preset: solo-quick | small-team | enterprise')
-    .option('-a, --adapter <platform>', 'Target platform: claude-cli | cursor | generic', 'claude-cli')
-    .option('-s, --silent', 'Non-interactive mode (reads DW_NAME, DW_DEPTH, DW_ROLES, DW_LANG env vars)')
-    .action(async (opts) => {
-      const { initCommand } = await import('./commands/init.mjs');
-      await initCommand(opts);
-    });
-
-  program
-    .command('upgrade')
-    .description('Update dw-kit files in current project')
-    .option('-n, --dry-run', 'Preview changes without applying')
-    .option('-c, --check', 'Only check if update is available')
-    .option('-l, --layer <name>', 'Update specific layer: core | platform | capability | all', 'all')
-    .action(async (opts) => {
-      const { upgradeCommand } = await import('./commands/upgrade.mjs');
-      await upgradeCommand(opts);
-    });
-
-  program
-    .command('validate')
-    .description('Validate .dw/config/dw.config.yml against schema')
-    .option('-f, --file <path>', 'Config file path', '.dw/config/dw.config.yml')
-    .action(async (opts) => {
-      const { validateCommand } = await import('./commands/validate.mjs');
-      await validateCommand(opts);
-    });
-
-  program
-    .command('doctor')
-    .description('Check dw-kit installation health')
-    .action(async () => {
-      const { doctorCommand } = await import('./commands/doctor.mjs');
-      await doctorCommand();
-    });
-
-  program
-    .command('prompt')
-    .description('Build a well-structured task prompt with autocomplete + guided wizard')
-    .option('-t, --text <text>', 'Non-interactive: provide description directly')
-    .action(async (opts) => {
-      const { promptCommand } = await import('./commands/prompt.mjs');
-      await promptCommand(opts);
-    });
-
-  program
-    .command('claude-vn-fix')
-    .description('Patch Claude CLI to fix Vietnamese IME (local, with backup/restore)')
-    .option('--path <file>', 'Path to @anthropic-ai/claude-code/cli.js (optional; auto-detect if omitted)')
-    .option('--restore', 'Restore from latest backup')
-    .option('--dry-run', 'Show what would change without writing')
-    .action(async (opts) => {
-      const { claudeVnFixCommand } = await import('./commands/claude-vn-fix.mjs');
-      await claudeVnFixCommand(opts);
-    });
-
-  program.parse(argv);
-
-  if (latestVersion) {
-    console.log();
-    console.log(chalk.yellow(`  ↑ Update available`) + `  v${pkg.version} → ` + chalk.green.bold(`v${latestVersion}`));
-    console.log(`    Run ` + chalk.cyan(`npm install -g dw-kit`) + ` to update`);
-    console.log();
-  }
-}
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import chalk from 'chalk';
+import { getUpdateNotice, scheduleUpdateCheck } from './lib/update-checker.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+const pkg = require(join(__dirname, '..', 'package.json'));
+const RELEASES_URL = 'https://github.com/dv-workflow/dv-workflow/releases';
+
+export function run(argv) {
+  // Schedule fresh check in background (non-blocking).
+  // Notice is shown via process.on('exit') so it always appears AFTER command output,
+  // even when commands call process.exit() internally.
+  scheduleUpdateCheck(pkg.version);
+  const latestVersion = getUpdateNotice(pkg.version);
+
+  const program = new Command();
+
+  program
+    .name('dw')
+    .description('dw-kit — AI development workflow toolkit')
+    .version(pkg.version, '-v, --version');
+
+  program
+    .command('init')
+    .description('Setup dw-kit in current project (interactive wizard)')
+    .option('-p, --preset <name>', 'Use preset: solo-quick | small-team | enterprise')
+    .option('-a, --adapter <platform>', 'Target platform: claude-cli | cursor | generic', 'claude-cli')
+    .option('-s, --silent', 'Non-interactive mode (reads DW_NAME, DW_DEPTH, DW_ROLES, DW_LANG env vars)')
+    .action(async (opts) => {
+      const { initCommand } = await import('./commands/init.mjs');
+      await initCommand(opts);
+    });
+
+  program
+    .command('upgrade')
+    .description('Update dw-kit files in current project')
+    .option('-n, --dry-run', 'Preview changes without applying')
+    .option('-c, --check', 'Only check if update is available')
+    .option('-l, --layer <name>', 'Update specific layer: core | platform | capability | all', 'all')
+    .action(async (opts) => {
+      const { upgradeCommand } = await import('./commands/upgrade.mjs');
+      await upgradeCommand(opts);
+    });
+
+  program
+    .command('validate')
+    .description('Validate .dw/config/dw.config.yml against schema')
+    .option('-f, --file <path>', 'Config file path', '.dw/config/dw.config.yml')
+    .action(async (opts) => {
+      const { validateCommand } = await import('./commands/validate.mjs');
+      await validateCommand(opts);
+    });
+
+  program
+    .command('doctor')
+    .description('Check dw-kit installation health')
+    .action(async () => {
+      const { doctorCommand } = await import('./commands/doctor.mjs');
+      await doctorCommand();
+    });
+
+  program
+    .command('prompt')
+    .description('Build a well-structured task prompt with autocomplete + guided wizard')
+    .option('-t, --text <text>', 'Non-interactive: provide description directly')
+    .action(async (opts) => {
+      const { promptCommand } = await import('./commands/prompt.mjs');
+      await promptCommand(opts);
+    });
+
+  program
+    .command('claude-vn-fix')
+    .description('Patch Claude CLI to fix Vietnamese IME (local, with backup/restore)')
+    .option('--path <file>', 'Path to @anthropic-ai/claude-code/cli.js (optional; auto-detect if omitted)')
+    .option('--restore', 'Restore from latest backup')
+    .option('--dry-run', 'Show what would change without writing')
+    .action(async (opts) => {
+      const { claudeVnFixCommand } = await import('./commands/claude-vn-fix.mjs');
+      await claudeVnFixCommand(opts);
+    });
+
+  if (latestVersion) {
+    // Register notice to print AFTER the command completes (on clean exit only)
+    process.on('exit', (code) => {
+      if (code !== 0) return;
+      console.log();
+      console.log(chalk.yellow(`  ↑ Update available`) + `  v${pkg.version} → ` + chalk.green.bold(`v${latestVersion}`));
+      console.log(`    Run ` + chalk.cyan(`npm install -g dw-kit`) + ` to update`);
+      console.log(`    Changelog: ` + chalk.cyan(`${RELEASES_URL}/tag/v${latestVersion}`));
+      console.log();
+    });
+  }
+
+  program.parse(argv);
+}