dw-kit 1.0.0 → 1.0.2

package/src/commands/prompt.mjs

@@ -0,0 +1,125 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { load as yamlLoad } from 'js-yaml';
+import { header, info, ok, warn, err, log } from '../lib/ui.mjs';
+import { copyToClipboard } from '../lib/clipboard.mjs';
+import { getSuggestions, isVague, expandTemplate } from '../lib/prompt-suggest.mjs';
+
+export async function promptCommand(opts) {
+  header('dw-kit Prompt Builder');
+
+  const adapter = readAdapter();
+
+  // Non-interactive mode: --text <text>
+  if (opts.text !== undefined) {
+    if (!opts.text.trim()) {
+      err('--text cannot be empty.');
+      process.exit(1);
+    }
+    const result = await buildPrompt(opts.text, { interactive: false });
+    outputResult(result, adapter);
+    return;
+  }
+
+  // Interactive mode
+  const result = await buildPrompt('', { interactive: true });
+  outputResult(result, adapter);
+}
+
+async function buildPrompt(initialText, { interactive }) {
+  let description = initialText;
+
+  if (interactive) {
+    description = await runAutocompleteStep();
+    if (!description.trim()) {
+      err('No description provided.');
+      process.exit(1);
+    }
+  }
+
+  let area = '';
+  let outcome = '';
+
+  if (isVague(description)) {
+    if (interactive) {
+      info('Description seems short — a couple of quick questions (Enter to skip):');
+      ({ area, outcome } = await runWizardStep());
+    }
+    // In non-interactive mode: expand with just the description (no wizard data)
+  }
+
+  return expandTemplate(description, { area, outcome });
+}
+
+async function runAutocompleteStep() {
+  const { AutoComplete } = await import('enquirer');
+  const suggestions = getSuggestions(process.cwd());
+
+  const prompt = new AutoComplete({
+    name: 'description',
+    message: 'Describe your task:',
+    limit: 7,
+    choices: suggestions.length ? suggestions : ['(no suggestions — type your task)'],
+    suggest(typed, choices) {
+      const lower = typed.toLowerCase();
+      const filtered = choices.filter((c) => c.message.toLowerCase().includes(lower));
+      // Always offer the raw typed text as first selectable option
+      if (typed && !filtered.find((c) => c.message === typed)) {
+        return [{ message: typed, value: typed }, ...filtered];
+      }
+      return filtered.length ? filtered : [{ message: typed || '(empty)', value: typed }];
+    },
+  });
+
+  return prompt.run();
+}
+
+async function runWizardStep() {
+  const { Input } = await import('enquirer');
+
+  const area = await new Input({
+    name: 'area',
+    message: 'Which area/files? (e.g. auth middleware, src/login/)',
+    initial: '',
+  }).run().catch(() => '');
+
+  const outcome = await new Input({
+    name: 'outcome',
+    message: 'Expected outcome? (e.g. user redirected to /dashboard)',
+    initial: '',
+  }).run().catch(() => '');
+
+  return { area, outcome };
+}
+
+function outputResult(text, adapter) {
+  log('');
+  log('─── Result ───────────────────────────────────────────');
+  log(text);
+  log('──────────────────────────────────────────────────────');
+  log('');
+
+  const shouldCopy = adapter === 'claude-cli' || adapter === 'cursor';
+  if (shouldCopy) {
+    const copied = copyToClipboard(text);
+    if (copied) {
+      ok('Copied to clipboard. Paste into Claude CLI or your IDE.');
+    } else {
+      warn('Clipboard copy failed. Copy the text above manually.');
+    }
+  } else {
+    // generic adapter: just output to stdout
+    info('(generic adapter — copy the text above manually)');
+  }
+}
+
+function readAdapter() {
+  const configPath = join(process.cwd(), '.dw', 'config', 'dw.config.yml');
+  if (!existsSync(configPath)) return 'claude-cli';
+  try {
+    const config = yamlLoad(readFileSync(configPath, 'utf-8'));
+    return config?.adapter || 'claude-cli';
+  } catch {
+    return 'claude-cli';
+  }
+}

package/src/lib/clipboard.mjs

@@ -0,0 +1,24 @@
+import { spawnSync } from 'node:child_process';
+import { platform } from 'node:process';
+
+/**
+ * Copy text to system clipboard.
+ * @returns {boolean} true if succeeded
+ */
+export function copyToClipboard(text) {
+  const candidates = platform === 'win32'
+    ? [['clip']]
+    : platform === 'darwin'
+      ? [['pbcopy']]
+      : [['wl-copy'], ['xclip', '-selection', 'clipboard'], ['xsel', '--clipboard', '--input']];
+
+  for (const [cmd, ...args] of candidates) {
+    try {
+      const result = spawnSync(cmd, args, { input: text, encoding: 'utf-8' });
+      if (result.status === 0) return true;
+    } catch {
+      // Try next candidate.
+    }
+  }
+  return false;
+}

package/src/lib/prompt-suggest.mjs

@@ -0,0 +1,84 @@
+import { execSync } from 'node:child_process';
+
+const TEMPLATE_SUGGESTIONS = [
+  'fix: ',
+  'fix authentication redirect after login',
+  'fix null pointer / undefined error in ',
+  'fix performance issue in ',
+  'feat: add ',
+  'feat: implement ',
+  'feat: support ',
+  'refactor: simplify ',
+  'refactor: extract ',
+  'refactor: rename ',
+  'perf: optimize ',
+  'perf: reduce load time of ',
+  'chore: update dependencies',
+  'docs: update README',
+  'test: add tests for ',
+];
+
+// Common verbs to detect whether a description has intent
+const INTENT_VERBS = [
+  'fix', 'add', 'update', 'remove', 'delete', 'create', 'implement', 'refactor',
+  'rename', 'move', 'improve', 'optimize', 'support', 'extract', 'migrate',
+  'replace', 'upgrade', 'enable', 'disable', 'integrate', 'patch',
+];
+
+function getTemplateSuggestions() {
+  return [...TEMPLATE_SUGGESTIONS];
+}
+
+export function getGitSuggestions(cwd) {
+  try {
+    const out = execSync('git log --oneline -50 --no-merges', {
+      cwd,
+      encoding: 'utf-8',
+      timeout: 3000,
+      stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    return out
+      .trim()
+      .split('\n')
+      .filter(Boolean)
+      .map((line) => line.replace(/^[a-f0-9]+ /, '').trim())  // strip hash
+      .filter((msg) => msg.length > 5)
+      .slice(0, 30);
+  } catch {
+    return [];
+  }
+}
+
+export function getSuggestions(cwd = process.cwd()) {
+  const git = getGitSuggestions(cwd);
+  const templates = getTemplateSuggestions();
+  // git log first (most relevant to this repo), then templates
+  const merged = [...git, ...templates];
+  // dedupe
+  return [...new Set(merged)].slice(0, 20);
+}
+
+/**
+ * Returns true if the description is likely too vague to give Claude good context.
+ */
+export function isVague(text) {
+  const trimmed = (text || '').trim();
+  if (trimmed.length < 50) return true;
+  const lower = trimmed.toLowerCase();
+  const hasVerb = INTENT_VERBS.some((v) => lower.startsWith(v) || lower.includes(` ${v} `));
+  return !hasVerb;
+}
+
+/**
+ * Expand a short description into a structured prompt.
+ * @param {string} text - core task description
+ * @param {{ area?: string, outcome?: string }} extras
+ * @returns {string}
+ */
+export function expandTemplate(text, { area = '', outcome = '' } = {}) {
+  const base = text.trim();
+  const parts = [base];
+  if (area) parts.push(`Scope: ${area.trim()}.`);
+  if (outcome) parts.push(`Expected: ${outcome.trim()}.`);
+  return parts.join('\n');
+}

package/src/lib/update-checker.mjs

@@ -0,0 +1,73 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const REGISTRY_URL = 'https://registry.npmjs.org/dw-kit/latest';
+const CACHE_DIR = join(homedir(), '.dw-kit');
+const CACHE_FILE = join(CACHE_DIR, 'update-cache.json');
+
+function parseSemver(v) {
+  const parts = String(v).replace(/^v/, '').split('.').map(Number);
+  return { major: parts[0] || 0, minor: parts[1] || 0, patch: parts[2] || 0 };
+}
+
+function isNewer(latest, current) {
+  const l = parseSemver(latest);
+  const c = parseSemver(current);
+  if (l.major !== c.major) return l.major > c.major;
+  if (l.minor !== c.minor) return l.minor > c.minor;
+  return l.patch > c.patch;
+}
+
+function readCache() {
+  try {
+    return JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeCache(data) {
+  try {
+    mkdirSync(CACHE_DIR, { recursive: true });
+    writeFileSync(CACHE_FILE, JSON.stringify(data), 'utf-8');
+  } catch {
+    // ignore write errors (permission, disk full, etc.)
+  }
+}
+
+async function fetchLatestVersion() {
+  const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(3000) });
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  const data = await res.json();
+  return data.version;
+}
+
+/**
+ * Returns latest version string if an update is available (from cache), null otherwise.
+ * Never throws, never makes network calls.
+ */
+export function getUpdateNotice(currentVersion) {
+  if (process.env.DW_NO_UPDATE_CHECK) return null;
+  const cache = readCache();
+  if (!cache?.latest) return null;
+  return isNewer(cache.latest, currentVersion) ? cache.latest : null;
+}
+
+/**
+ * Fires off an async check against npm registry and updates the cache.
+ * Non-blocking — caller should NOT await this.
+ * Skips the check if cache is still fresh (< 24h).
+ */
+export function scheduleUpdateCheck(currentVersion) {
+  if (process.env.DW_NO_UPDATE_CHECK) return;
+
+  const cache = readCache();
+  const now = Date.now();
+  if (cache?.checkedAt && now - cache.checkedAt < CACHE_TTL_MS) return;
+
+  fetchLatestVersion()
+    .then((latest) => writeCache({ latest, checkedAt: now, current: currentVersion }))
+    .catch(() => {});
+}

package/src/smoke-test.mjs

@@ -11,6 +11,7 @@ import { mkdirSync, rmSync, existsSync, readFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
+import { copyFileSync } from 'node:fs';
 
 const __dirname = resolve(fileURLToPath(import.meta.url), '..');
 const DW_BIN = resolve(__dirname, '..', 'bin', 'dw.mjs');
@@ -72,7 +73,7 @@ test('--version returns semver', () => {
 
 test('--help lists all commands', () => {
   const out = dw('--help', TEMP_BASE);
-  for (const cmd of ['init', 'upgrade', 'validate', 'doctor', 'migrate']) {
+  for (const cmd of ['init', 'upgrade', 'validate', 'doctor', 'prompt', 'claude-vn-fix']) {
     assert(out.includes(cmd), `Missing command: ${cmd}`);
   }
 });
@@ -262,6 +263,51 @@ test('doctor reports issues on empty project', () => {
   }
 });
 
+// ── Test: dw prompt ──────────────────────────────────────────────────────────
+console.log();
+console.log('▶ dw prompt');
+
+test('prompt --text outputs structured result', () => {
+  const out = dw('prompt --text "fix login redirect after OAuth in auth middleware"', TEMP_BASE);
+  assert(out.includes('fix login redirect'), 'Should include description in output');
+  assert(!out.includes('Description seems short'), 'Long description should skip wizard');
+});
+
+test('prompt --text with short input expands without error', () => {
+  const out = dw('prompt --text "fix login"', TEMP_BASE);
+  assert(out.includes('fix login'), 'Should include description in output');
+});
+
+test('prompt --text empty string exits with error', () => {
+  try {
+    dw('prompt --text ""', TEMP_BASE);
+    assert(false, 'Should have thrown');
+  } catch (e) {
+    assert(e.status === 1, 'Should exit with code 1');
+  }
+});
+
+test('prompt --help shows options', () => {
+  const out = dw('prompt --help', TEMP_BASE);
+  assert(out.includes('--text'), 'Missing --text option');
+});
+
+// ── Test: dw claude-vn-fix (fixture patch) ───────────────────────────────────
+console.log();
+console.log('▶ dw claude-vn-fix');
+
+test('claude-vn-fix patches known bug fixture', () => {
+  const dir = freshDir('claude-vn-fix-fixture');
+  const fixtureSrc = resolve(__dirname, '__fixtures__', 'claude-cli-bug-snippet.js');
+  const target = join(dir, 'cli.js');
+  copyFileSync(fixtureSrc, target);
+
+  const out = dw(`claude-vn-fix --path "${target}"`, dir);
+  assert(out.includes('Patch applied') || out.includes('Already patched'), 'Should apply patch');
+  const patched = readFileSync(target, 'utf-8');
+  assert(patched.includes('dw-kit Vietnamese IME fix'), 'Patch marker missing in output file');
+});
+
 // ── Test: dw upgrade ─────────────────────────────────────────────────────────
 console.log();
 console.log('▶ dw upgrade');
@@ -288,16 +334,6 @@ test('upgrade fails on project without config', () => {
   }
 });
 
-// ── Test: dw migrate ─────────────────────────────────────────────────────────
-console.log();
-console.log('▶ dw migrate');
-
-test('migrate on v1 project reports no v0.3 config', () => {
-  const dir = join(TEMP_BASE, 'init-solo');
-  const out = dw('migrate', dir);
-  assert(out.includes('Already on v1') || out.includes('No v0.3'), 'Should report no migration needed');
-});
-
 // ── Cleanup ──────────────────────────────────────────────────────────────────
 rmSync(TEMP_BASE, { recursive: true });
 

package/scripts/migrate-v03-to-v1.sh

@@ -1,243 +0,0 @@
-#!/bin/bash
-# scripts/migrate-v03-to-v1.sh
-# ⚠ DEPRECATED: Prefer `dw migrate` from npm CLI.
-# Migrate project từ dw-kit v0.3 sang v1
-# Usage: bash scripts/migrate-v03-to-v1.sh [--dry-run]
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-DRY_RUN=false
-[ "${1:-}" = "--dry-run" ] && DRY_RUN=true
-
-log()  { echo "  $*"; }
-info() { echo ""; echo "▶ $*"; }
-warn() { echo "  ⚠  $*"; }
-ok()   { echo "  ✓  $*"; }
-dry()  { [ "$DRY_RUN" = true ] && echo "  [dry] $*" || true; }
-do_action() {
-  if [ "$DRY_RUN" = true ]; then echo "  [dry] $*"; else eval "$*"; fi
-}
-
-OLD_CONFIG="$PROJECT_ROOT/.dw/config/dw.config.yml"
-NEW_CONFIG_DIR="$PROJECT_ROOT/config"
-NEW_CONFIG="$NEW_CONFIG_DIR/dw.config.yml"
-
-echo ""
-echo "══════════════════════════════════════════"
-echo "  dw-kit v0.3 → v1 Migration"
-[ "$DRY_RUN" = true ] && echo "  Mode: DRY RUN"
-echo "══════════════════════════════════════════"
-
-# ── Step 1: Validate v0.3 present ────────────────────────────────────────────
-info "Step 1: Validate source config"
-
-if [ ! -f "$OLD_CONFIG" ]; then
-  echo "  No config/dw.config.yml found. Already on v1 or fresh install."
-  exit 0
-fi
-
-if [ -L "$OLD_CONFIG" ]; then
-  warn "config/dw.config.yml is already a symlink → migration may have already run."
-  read -r -p "  Continue anyway? [y/N] " confirm
-  [[ "$confirm" =~ ^[Yy]$ ]] || exit 0
-fi
-
-ok "Found config/dw.config.yml"
-
-# ── Step 2: Detect customized skills ─────────────────────────────────────────
-info "Step 2: Detect customized skills"
-
-OVERRIDES_DIR="$PROJECT_ROOT/.dw/adapters/claude-cli/overrides/skills"
-SKILLS_DIR="$PROJECT_ROOT/.claude/skills"
-customized_count=0
-
-# Heuristic: compare với toolkit's own copy nếu có, hoặc check git
-if command -v git &>/dev/null && git -C "$PROJECT_ROOT" rev-parse --git-dir &>/dev/null; then
-  for skill_dir in "$SKILLS_DIR"/*/; do
-    [ -d "$skill_dir" ] || continue
-    skill_name=$(basename "$skill_dir")
-    skill_file="$skill_dir/SKILL.md"
-    [ -f "$skill_file" ] || continue
-
-    # Check if file was modified from its committed version
-    if ! git -C "$PROJECT_ROOT" diff --quiet HEAD -- ".claude/skills/$skill_name/SKILL.md" 2>/dev/null; then
-      warn "Skill '$skill_name' has uncommitted changes → preserving to overrides/"
-      do_action "mkdir -p '$OVERRIDES_DIR/$skill_name'"
-      do_action "cp '$skill_file' '$OVERRIDES_DIR/$skill_name/SKILL.md'"
-      customized_count=$((customized_count + 1))
-    fi
-  done
-else
-  warn "Not a git repo or git not available. Cannot auto-detect customizations."
-  warn "Manually copy customized skills to adapters/claude-cli/overrides/skills/ before upgrading."
-fi
-
-if [ $customized_count -gt 0 ]; then
-  ok "$customized_count customized skill(s) preserved to overrides/"
-else
-  ok "No customized skills detected"
-fi
-
-# ── Step 3: Migrate config ────────────────────────────────────────────────────
-info "Step 3: Migrate config (config/dw.config.yml → config/dw.config.yml)"
-
-if [ -f "$NEW_CONFIG" ]; then
-  warn "config/dw.config.yml already exists. Skipping config migration."
-  warn "Review manually: $NEW_CONFIG"
-else
-  if ! command -v python3 &>/dev/null; then
-    warn "python3 not found. Manual config migration needed."
-    warn "Map: level: 1 → default_depth: quick"
-    warn "     level: 2 → default_depth: standard"
-    warn "     level: 3 → default_depth: thorough"
-  else
-    if [ "$DRY_RUN" = false ]; then
-      mkdir -p "$NEW_CONFIG_DIR"
-      python3 - "$OLD_CONFIG" "$NEW_CONFIG" <<'PYEOF'
-import sys, re
-
-old_path = sys.argv[1]
-new_path = sys.argv[2]
-
-with open(old_path) as f:
-    old_content = f.read()
-
-# Extract values from old config
-def get_val(key, content, default=""):
-    m = re.search(rf'^\s*{re.escape(key)}:\s*([^\n#]+)', content, re.MULTILINE)
-    if m:
-        return m.group(1).strip().strip('"').strip("'")
-    return default
-
-project_name = get_val("name", old_content, "my-project")
-project_lang = get_val("language", old_content, "vi")
-level_str    = get_val("level", old_content, "2")
-
-depth_map = {"1": "quick", "2": "standard", "3": "thorough"}
-depth = depth_map.get(level_str, "standard")
-
-# Extract roles
-roles_match = re.findall(r'^\s+-\s+(dev|techlead|ba|qc|pm)\b', old_content, re.MULTILINE)
-roles = roles_match if roles_match else ["dev"]
-
-# Extract quality commands
-test_cmd = get_val("test_command", old_content, "")
-lint_cmd  = get_val("lint_command", old_content, "")
-
-# Extract paths
-tasks_path   = get_val("tasks", old_content, ".dw/tasks")
-docs_path    = get_val("docs", old_content, ".dw/docs")
-
-# Build new config
-roles_yaml = "\n".join(f"    - {r}" for r in roles)
-
-new_config = f"""# dw-kit Configuration
-# Generated by migrate-v03-to-v1.sh
-# Review and adjust as needed.
-
-project:
-  name: "{project_name}"
-  language: "{project_lang}"
-
-workflow:
-  default_depth: "{depth}"   # quick | standard | thorough
-  # AI assesses per-task and may recommend different depth
-
-team:
-  roles:
-{roles_yaml}
-
-quality:
-  test_command: "{test_cmd}"   # empty = skip
-  lint_command: "{lint_cmd}"   # empty = skip
-  block_on_fail: false
-
-tracking:
-  estimation: false
-  log_work: false
-  estimation_unit: "hours"
-
-paths:
-  tasks: "{tasks_path}"
-  docs: "{docs_path}"
-
-# Claude-specific capabilities (Layer 2)
-claude:
-  models:
-    plan: ""          # empty = inherit from Claude Code settings
-    execute: ""
-    review: ""
-  structured_output: true
-  worktree_execution: false
-  mcp: []
-
-# Toolkit version tracking (do not edit manually)
-_toolkit:
-  core_version: "1.0"
-  platform_version: "1.0"
-  capability_version: "1.0"
-  migrated_from: "v0.3"
-  last_upgrade: "{__import__('datetime').date.today().isoformat()}"
-"""
-
-with open(new_path, 'w') as f:
-    f.write(new_config)
-PYEOF
-      ok "config/dw.config.yml created (migrated from level: $level_str → depth: $(grep default_depth "$NEW_CONFIG" | head -1))"
-    else
-      dry "Would create config/dw.config.yml from config/dw.config.yml"
-    fi
-  fi
-fi
-
-# ── Step 4: Create backward-compat symlink ────────────────────────────────────
-info "Step 4: Create backward-compat symlink"
-
-if [ -f "$NEW_CONFIG" ] && [ ! -L "$OLD_CONFIG" ]; then
-  if [ "$DRY_RUN" = false ]; then
-    # Backup original
-    cp "$OLD_CONFIG" "${OLD_CONFIG}.bak"
-    ok "Backed up original to config/dw.config.yml.bak"
-    # Create symlink
-    rm "$OLD_CONFIG"
-    ln -s ".dw/.dw/config/dw.config.yml" "$OLD_CONFIG"
-    ok "Created symlink: config/dw.config.yml → config/dw.config.yml"
-  else
-    dry "Would create symlink: config/dw.config.yml → config/dw.config.yml"
-  fi
-fi
-
-# ── Step 5: Check CI/CD references ───────────────────────────────────────────
-info "Step 5: Check CI/CD references"
-
-found_refs=false
-for ci_file in ".github/workflows/"*.yml ".gitlab-ci.yml" "Makefile" ".circleci/config.yml" "package.json"; do
-  full_path="$PROJECT_ROOT/$ci_file"
-  if [ -f "$full_path" ]; then
-    if grep -qE "dv-workflow\.config\.yml|dv-workflow-kit" "$full_path" 2>/dev/null; then
-      warn "Found reference in: $ci_file — update to config/dw.config.yml"
-      found_refs=true
-    fi
-  fi
-done
-[ "$found_refs" = false ] && ok "No CI/CD references found"
-
-# ── Summary ───────────────────────────────────────────────────────────────────
-echo ""
-echo "══════════════════════════════════════════"
-if [ "$DRY_RUN" = true ]; then
-  echo "  DRY RUN complete. Review above, then run without --dry-run."
-else
-  echo "  Migration complete!"
-  echo ""
-  echo "  Next steps:"
-  echo "  1. Review config/dw.config.yml — adjust team.roles, quality commands"
-  echo "  2. Run: bash setup.sh to regenerate .claude/ from new config"
-  echo "  3. Check adapters/claude-cli/overrides/ for preserved customizations"
-  [ "$found_refs" = true ] && echo "  4. ⚠  Update CI/CD files (see warnings above)"
-fi
-echo "══════════════════════════════════════════"
-echo ""