dw-kit 1.2.0 → 1.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 > 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)
+**v1.3** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md) · [Migration v1.3](MIGRATION-v1.3.md) · [Changelog](CHANGELOG.md)
 
 ---
 
@@ -34,6 +34,14 @@ It’s designed for collaboration (Dev / Tech Lead / QA / PM) and keeps work aud
 
 ---
 
+## 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
@@ -53,7 +61,7 @@ dw init
 Then in **Claude Code CLI**, run the full workflow:
 
 ```
-/dw-flow your-task-or-anythings
+/dw:flow your-task-or-anythings
 ```
 
 ---
@@ -61,18 +69,21 @@ Then in **Claude Code CLI**, run the full workflow:
 Discover other skills:
 
 ```
-/dw-prompt
-/dw-thinking
+/dw:prompt
+/dw:thinking
+/dw:decision
 ...
-
 ```
 
+> **v1.3 note**: Slash commands switched from `/dw-*` to `/dw:*` (namespace convention). See [MIGRATION-v1.3.md](MIGRATION-v1.3.md).
+
 ---
 
 ## CLI commands
 
 ```bash
 dw init                 # setup wizard / presets
+dw init --solo          # zero-config solo dev setup (v1.3)
 dw validate             # validate .dw/config/dw.config.yml
 dw doctor               # installation health check
 dw upgrade              # update toolkit files (override-aware)
@@ -80,6 +91,9 @@ 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 active               # regenerate .dw/tasks/ACTIVE.md index (v1.3)
+dw metrics              # inspect local telemetry (v1.3, opt-out via DW_NO_TELEMETRY=1)
+dw dashboard            # active tasks + ADRs + telemetry summary (v1.3)
 dw claude-vn-fix        # patch Claude CLI to fix Vietnamese IME (backup/restore)
 ```
 
@@ -109,11 +123,34 @@ workflow:
 ## What gets added to your repo?
 
 ```
-.dw/        # methodology, config, adapters, task docs
+.dw/
+  core/       methodology + PILLARS.md
+  config/     dw.config.yml (+ optional .local.yml)
+  decisions/  ADRs (v1.3) — architectural decision records
+  tasks/      task docs + ACTIVE.md index (v1.3)
+  metrics/    local telemetry (v1.3, opt-out)
 .claude/    # Claude Code: skills, hooks, agents, rules
 CLAUDE.md   # project context for the agent
 ```
 
 ---
 
+## 5-pillar architecture (v1.3+)
+
+dw-kit is a **context-first governance layer** on top of your AI agent — not a prescriptive workflow engine. Five pillars, verb-based:
+
+| Pillar | Purpose | Examples |
+|--------|---------|----------|
+| **Guards** | Safety before action | `safety-guard`, `privacy-block`, `pre-commit-gate` |
+| **Surfaces** | Make state visible | `ACTIVE.md`, `dw dashboard`, `project-map.md` |
+| **Records** | Preserve memory | ADRs in `.dw/decisions/`, task docs |
+| **Bridges** | Continuity across sessions/roles | `session-init`, auto-handoff in `tracking.md` |
+| **Tunes** | Adapt to team shape | presets (`solo`, `team`, `enterprise`), config flags |
+
+Full spec: [`.dw/core/PILLARS.md`](.dw/core/PILLARS.md)
+
+**Design principle — obsolescence test**: Every feature must answer "will this be *more* valuable when AI is smarter?" If no → cut or defer.
+
+---
+
 Maintainer: [huygdv](mailto:huygdv19@gmail.com)

package/package.json

@@ -1,84 +1,86 @@
-{
-  "name": "dw-kit",
-  "version": "1.2.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/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"
-  }
-}
+{
+  "name": "dw-kit",
+  "version": "1.3.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/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-decision/",
+    ".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",
+    "MIGRATION-v1.3.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

@@ -9,11 +9,14 @@ 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) {
-  // Show cached update notice (non-blocking), then schedule fresh check in background
-  const latestVersion = getUpdateNotice(pkg.version);
+  // 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();
 
@@ -25,7 +28,8 @@ export function run(argv) {
   program
     .command('init')
     .description('Setup dw-kit in current project (interactive wizard)')
-    .option('-p, --preset <name>', 'Use preset: solo-quick | small-team | enterprise')
+    .option('-p, --preset <name>', 'Use preset: solo | solo-quick | small-team | team | enterprise')
+    .option('--solo', 'Shortcut for --preset solo (zero-config setup)')
     .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) => {
@@ -70,6 +74,33 @@ export function run(argv) {
       await promptCommand(opts);
     });
 
+  program
+    .command('metrics [sub]')
+    .description('Inspect local telemetry (show | cut-analysis | clear). Default: show')
+    .option('--since <date>', 'Filter events since ISO date (YYYY-MM-DD)')
+    .option('--skill <name>', 'Filter by skill name')
+    .action(async (sub, opts) => {
+      const { metricsCommand } = await import('./commands/metrics.mjs');
+      await metricsCommand({ sub, ...opts });
+    });
+
+  program
+    .command('active')
+    .description('Regenerate .dw/tasks/ACTIVE.md index')
+    .action(async () => {
+      const { writeActiveIndex } = await import('./lib/active-index.mjs');
+      const target = writeActiveIndex();
+      console.log(chalk.green('✓') + ` Wrote ${target}`);
+    });
+
+  program
+    .command('dashboard')
+    .description('Show team dashboard — active tasks, ADRs, telemetry summary, health')
+    .action(async (opts) => {
+      const { dashboardCommand } = await import('./commands/dashboard.mjs');
+      await dashboardCommand(opts);
+    });
+
   program
     .command('claude-vn-fix')
     .description('Patch Claude CLI to fix Vietnamese IME (local, with backup/restore)')
@@ -81,12 +112,17 @@ export function run(argv) {
       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();
+    // 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);
 }

package/src/commands/dashboard.mjs

@@ -0,0 +1,116 @@
+import { readEvents, summarize } from '../lib/telemetry.mjs';
+import { generateActiveIndex } from '../lib/active-index.mjs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { banner, log, info, warn, ok } from '../lib/ui.mjs';
+import chalk from 'chalk';
+
+export async function dashboardCommand(opts) {
+  banner('dw-kit Dashboard');
+
+  const rootDir = process.cwd();
+
+  log(chalk.bold('📋 Active Tasks'));
+  log('');
+  const activeContent = generateActiveIndex(rootDir);
+  const taskLines = activeContent.split('\n').filter((l) => l.startsWith('- `'));
+  if (taskLines.length === 0) {
+    log('  (none)');
+  } else {
+    taskLines.forEach((l) => log('  ' + l));
+  }
+  log('');
+
+  log(chalk.bold('🗂️  Decisions (ADRs)'));
+  log('');
+  const decisionsDir = join(rootDir, '.dw/decisions');
+  if (existsSync(decisionsDir)) {
+    const adrs = readdirSync(decisionsDir).filter((f) => /^\d{4}-.*\.md$/.test(f));
+    if (adrs.length === 0) {
+      log('  (none)');
+    } else {
+      adrs.sort().forEach((f) => {
+        try {
+          const content = readFileSync(join(decisionsDir, f), 'utf8');
+          const statusMatch = content.match(/^status:\s*(.+)$/m);
+          const titleMatch = content.match(/^title:\s*(.+)$/m);
+          const status = statusMatch ? statusMatch[1].trim() : 'unknown';
+          const title = titleMatch ? titleMatch[1].trim() : f;
+          const statusColor =
+            status === 'Accepted'
+              ? chalk.green
+              : status.startsWith('Proposed')
+              ? chalk.yellow
+              : status === 'Deprecated'
+              ? chalk.gray
+              : chalk.white;
+          log(`  ${chalk.cyan(f.replace(/\.md$/, ''))} · ${statusColor(status)}`);
+          log(`    ${chalk.dim(title)}`);
+        } catch {
+          log(`  ${f} · (unreadable)`);
+        }
+      });
+    }
+  } else {
+    log('  (decisions layer not initialized — run `/dw:decision` to create first ADR)');
+  }
+  log('');
+
+  log(chalk.bold('📊 Telemetry Summary'));
+  log('');
+  if (process.env.DW_NO_TELEMETRY === '1') {
+    warn('Telemetry disabled (DW_NO_TELEMETRY=1)');
+  } else {
+    const events = readEvents(rootDir);
+    if (events.length === 0) {
+      log('  No events yet. Use dw-kit normally to populate.');
+    } else {
+      const s = summarize(events);
+      log(`  Total events: ${s.totalEvents}`);
+      if (s.dateRange) {
+        log(`  Range: ${s.dateRange.from.slice(0, 10)} → ${s.dateRange.to.slice(0, 10)}`);
+      }
+
+      const topSkills = Object.entries(s.bySkill)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5);
+      if (topSkills.length > 0) {
+        log('');
+        log(chalk.dim('  Top 5 skills:'));
+        topSkills.forEach(([n, c]) => log(`    ${c.toString().padStart(4)}× /${n}`));
+      }
+
+      const topHooks = Object.entries(s.byHook)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5);
+      if (topHooks.length > 0) {
+        log('');
+        log(chalk.dim('  Top 5 hooks:'));
+        topHooks.forEach(([n, c]) => log(`    ${c.toString().padStart(4)}× ${n}`));
+      }
+    }
+  }
+  log('');
+
+  log(chalk.bold('🔧 Health'));
+  log('');
+  const checks = [
+    { path: '.dw/config/dw.config.yml', label: 'Config' },
+    { path: '.dw/tasks/ACTIVE.md', label: 'ACTIVE index' },
+    { path: '.dw/decisions', label: 'Decisions layer' },
+    { path: '.claude/hooks/privacy-block.sh', label: 'Privacy guard' },
+    { path: '.claude/hooks/pre-commit-gate.sh', label: 'Commit gate' },
+  ];
+
+  for (const c of checks) {
+    const full = join(rootDir, c.path);
+    if (existsSync(full)) {
+      ok(`${c.label}: ${c.path}`);
+    } else {
+      warn(`${c.label}: missing (${c.path})`);
+    }
+  }
+
+  log('');
+  info('Run `dw metrics show` for detailed telemetry, `dw doctor` for full health check.');
+}