dw-kit 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dw-kit",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
   "type": "module",
   "bin": {
@@ -8,15 +8,42 @@
   },
   "files": [
     "bin/",
-    "src/",
+    "src/cli.mjs",
+    "src/commands/",
+    "src/lib/",
     ".dw/core/",
     ".dw/config/",
     ".dw/adapters/",
-    "scripts/",
     ".claude/agents/",
     ".claude/hooks/",
     ".claude/rules/",
-    ".claude/skills/",
+    ".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"

package/src/cli.mjs

@@ -1,92 +1,92 @@
-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'));
+
+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();
+  }
+}

package/src/commands/init.mjs

@@ -135,7 +135,7 @@ async function setupProject(projectDir, { projectName, depth, roles, language, a
 
   if (adapter === 'claude-cli') {
     copyClaudeFiles(projectDir);
-    copyCLAUDEmd(projectDir);
+    createMinimalCLAUDEmd(projectDir, projectName);
   } else if (adapter === 'cursor') {
     copyCursorFiles(projectDir);
     copyGenericAdapter(projectDir);
@@ -191,34 +191,34 @@ function copyClaudeFiles(projectDir) {
   if (skipCount > 0) log(`  ${skipCount} existing files preserved`);
 }
 
-function copyCLAUDEmd(projectDir) {
-  const src = join(TOOLKIT_ROOT, 'CLAUDE.md');
+function createMinimalCLAUDEmd(projectDir, projectName) {
   const dst = join(projectDir, 'CLAUDE.md');
 
   if (existsSync(dst)) {
-    warn('CLAUDE.md already exists — skipping (review manually if needed)');
+    // User already has their own CLAUDE.md — leave it completely alone
     return;
   }
 
-  copyFile(src, dst);
+  const content = `# ${projectName}
+
+> Add your project description here.
 
-  const techStackSection = `
 ---
 
 ## Tech Stack
 
 <!-- Update with your project's actual stack -->
-- Framework: [e.g. NestJS / Django / Laravel / Next.js]
-- Database: [e.g. PostgreSQL / MySQL / MongoDB]
-- Testing: [e.g. Jest / Pytest / PHPUnit]
+- Framework:
+- Database:
+- Testing:
 
 ## Project-Specific Rules
 
-<!-- Add project-specific rules -->
-- [Rule 1]
+<!-- Add project-specific rules here -->
+<!-- dw workflow rules are auto-loaded from .claude/rules/ -->
 `;
-  appendFileSync(dst, techStackSection, 'utf-8');
-  ok('CLAUDE.md (with Tech Stack template section)');
+  writeFileSync(dst, content, 'utf-8');
+  ok('CLAUDE.md (minimal project template — dw rules are in .claude/rules/)');
 }
 
 function copyCursorFiles(projectDir) {
@@ -276,7 +276,7 @@ function createRuntimeDirs(projectDir) {
 
 function updateGitignore(projectDir) {
   const gitignorePath = join(projectDir, '.gitignore');
-  const entriesToAdd = ['CLAUDE.local.md', '.claude/settings.local.json'];
+  const entriesToAdd = ['CLAUDE.local.md', '.claude/settings.local.json', '.dw/config/dw.config.local.yml'];
 
   if (existsSync(gitignorePath)) {
     const content = readFileSync(gitignorePath, 'utf-8');
@@ -304,8 +304,8 @@ function printSummary({ projectName, depth, roles, language, adapter }) {
   console.log(`  Files created:`);
   console.log(`    .dw/               — core/, config/, adapters/, tasks, docs`);
   if (adapter === 'claude-cli') {
-    console.log(`    .claude/           — skills, agents, hooks, rules`);
-    console.log(`    CLAUDE.md`);
+    console.log(`    .claude/           — skills, agents, hooks, rules/`);
+    console.log(`    CLAUDE.md          — minimal project template (dw rules in .claude/rules/)`);
   } else if (adapter === 'cursor') {
     console.log(`    .cursor/rules/     — workflow rules for Cursor`);
     console.log(`    AGENT.md           — methodology reference`);
@@ -317,7 +317,7 @@ function printSummary({ projectName, depth, roles, language, adapter }) {
     console.log(`  Next steps:`);
     console.log(`    Run: claude (to open Claude Code in this directory in terminal)`);
     console.log(`    Run: /dw-flow [task-name]`);
-    console.log(`    Suggested: Update Tech Stack in CLAUDE.md (optional, recommended)`);
+    console.log(`    Suggested: Update Tech Stack + rules in CLAUDE.md`);
   } else if (adapter === 'cursor') {
     console.log(`  Next steps:`);
     console.log(`    1. Open Cursor in this directory`);

package/src/lib/config.mjs

@@ -7,6 +7,35 @@ export function loadConfig(configPath) {
   return yaml.load(content);
 }
 
+/**
+ * Load config với local override (v1.2+).
+ * dw.config.yml  — shared, committed
+ * dw.config.local.yml — machine-specific, gitignored
+ * Local values win over base values (shallow merge per top-level key).
+ */
+export function loadConfigWithLocal(configDir) {
+  const basePath = `${configDir}/dw.config.yml`;
+  const localPath = `${configDir}/dw.config.local.yml`;
+
+  const base = loadConfig(basePath);
+  if (!base) return null;
+
+  if (!existsSync(localPath)) return base;
+
+  const local = loadConfig(localPath);
+  if (!local) return base;
+
+  const merged = { ...base };
+  for (const key of Object.keys(local)) {
+    if (typeof local[key] === 'object' && !Array.isArray(local[key]) && local[key] !== null) {
+      merged[key] = { ...(merged[key] || {}), ...local[key] };
+    } else {
+      merged[key] = local[key];
+    }
+  }
+  return merged;
+}
+
 export function writeConfig(configPath, data) {
   const content = yaml.dump(data, {
     indent: 2,
@@ -57,9 +86,9 @@ export function buildConfig({ projectName, language, depth, roles }) {
       mcp: [],
     },
     _toolkit: {
-      core_version: '1.0',
+      core_version: '1.2',
       platform_version: '1.0',
-      capability_version: '1.0',
+      capability_version: '1.2',
       installed: today,
       last_upgrade: today,
     },

package/scripts/e2e-local-check.sh

@@ -1,75 +0,0 @@
-#!/bin/bash
-# scripts/e2e-local-check.sh
-# End-to-end local publish check (pack -> install -> run CLI)
-
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "$ROOT_DIR"
-
-log()  { echo "  $*"; }
-info() { echo ""; echo "▶ $*"; }
-ok()   { echo "  ✓  $*"; }
-warn() { echo "  ⚠  $*"; }
-
-cleanup() {
-  if [ -n "${TMP_DIR:-}" ] && [ -d "${TMP_DIR:-}" ]; then
-    rm -rf "$TMP_DIR"
-  fi
-  if [ -n "${PACK_FILE:-}" ] && [ -f "${PACK_FILE:-}" ]; then
-    rm -f "$PACK_FILE"
-  fi
-}
-trap cleanup EXIT
-
-info "Step 1: Run smoke tests"
-npm test
-ok "Smoke tests passed"
-
-info "Step 2: Build npm package tarball"
-PACK_OUTPUT="$(npm pack)"
-PACK_FILE="$(echo "$PACK_OUTPUT" | tail -n 1 | tr -d '\r')"
-if [ ! -f "$PACK_FILE" ]; then
-  echo "  ✗  Failed to produce package tarball"
-  exit 1
-fi
-ok "Tarball: $PACK_FILE"
-
-info "Step 3: Create isolated test project"
-TMP_DIR="$(mktemp -d 2>/dev/null || true)"
-if [ -z "${TMP_DIR}" ]; then
-  TMP_DIR=".tmp-e2e-local-check"
-  rm -rf "$TMP_DIR"
-  mkdir -p "$TMP_DIR"
-fi
-TEST_DIR="$TMP_DIR/e2e-project"
-mkdir -p "$TEST_DIR"
-cd "$TEST_DIR"
-npm init -y >/dev/null 2>&1
-git init >/dev/null 2>&1 || true
-ok "Created isolated project at $TEST_DIR"
-
-info "Step 4: Install from local tarball"
-npm install "$ROOT_DIR/$PACK_FILE" >/dev/null
-ok "Installed package from tarball"
-
-info "Step 5: Run CLI checks in isolated project"
-VERSION_OUT="$(npx dw --version | tr -d '\r')"
-log "dw --version: $VERSION_OUT"
-npx dw init --preset small-team
-npx dw validate
-npx dw doctor
-npx dw upgrade --check
-
-info "Step 6: Verify task-depth override guidance artifacts"
-grep -q "Task-Level Depth Override" ".dw/core/WORKFLOW.md"
-grep -q "Depth Source: default (from config) | override (task-specific)" ".dw/core/templates/vi/task-context.md"
-ok "Depth override guidance exists in generated artifacts"
-
-ok "CLI flow passed in isolated project"
-
-echo ""
-echo "══════════════════════════════════════════"
-echo "  E2E local check passed"
-echo "══════════════════════════════════════════"
-echo ""

package/src/__fixtures__/claude-cli-bug-snippet.js

@@ -1,15 +0,0 @@
-// Minimal fixture that contains the known Vietnamese IME bug pattern.
-// This is NOT the real Claude CLI; only used for testing the patcher logic.
-//
-// IMPORTANT: The comment below must contain both '@anthropic-ai' and 'claude-code'
-// to pass the bundle signature guard in patchCliJs(). Do not remove it.
-// @anthropic-ai/claude-code bundle stub
-
-function demo(INPUT) {
-  if(INPUT.includes("\x7f")){
-    let COUNT=(INPUT.match(/\x7f/g)||[]).length,STATE=CURSTATE;
-    UPDATETEXT(STATE.text);UPDATEOFFSET(STATE.offset)
-    return;
-  }
-}
-