dw-kit 1.2.1 → 1.3.0

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.');
+}

package/src/commands/doctor.mjs

@@ -1,149 +1,165 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { header, ok, warn, err, info, log } from '../lib/ui.mjs';
-import { loadConfig, getToolkitVersions } from '../lib/config.mjs';
-import { detectPlatform, platformLabel } from '../lib/platform.mjs';
-
-const TOOLKIT_ROOT = resolve(fileURLToPath(import.meta.url), '..', '..', '..');
-
-const CORE_FILES = [
-  '.dw/core/WORKFLOW.md',
-  '.dw/core/THINKING.md',
-  '.dw/core/QUALITY.md',
-  '.dw/core/ROLES.md',
-];
-
-const CONFIG_FILES = [
-  '.dw/config/dw.config.yml',
-  '.dw/config/config.schema.json',
-];
-
-const CLAUDE_ESSENTIAL = [
-  '.claude/settings.json',
-  '.claude/hooks/pre-commit-gate.sh',
-  '.claude/hooks/safety-guard.sh',
-];
-
-export async function doctorCommand() {
-  const projectDir = process.cwd();
-
-  header('dw-kit Doctor');
-  let issues = 0;
-  let warnings = 0;
-
-  info('Environment');
-  log(`Node.js     : ${process.version}`);
-  log(`Platform    : ${process.platform} ${process.arch}`);
-  log(`Working dir : ${projectDir}`);
-
-  const pkg = JSON.parse(readFileSync(join(TOOLKIT_ROOT, 'package.json'), 'utf-8'));
-  log(`dw-kit CLI  : v${pkg.version}`);
-
-  const platform = detectPlatform(projectDir);
-  log(`AI Platform : ${platformLabel(platform)}`);
-
-  info('Core Files (Layer 0)');
-  for (const file of CORE_FILES) {
-    const fullPath = join(projectDir, file);
-    if (existsSync(fullPath)) {
-      ok(file);
-    } else {
-      err(`${file} — MISSING`);
-      issues++;
-    }
-  }
-
-  info('Config (Layer 2)');
-  for (const file of CONFIG_FILES) {
-    const fullPath = join(projectDir, file);
-    if (existsSync(fullPath)) {
-      ok(file);
-    } else {
-      err(`${file} — MISSING`);
-      issues++;
-    }
-  }
-
-  const configPath = join(projectDir, '.dw', 'config', 'dw.config.yml');
-  if (existsSync(configPath)) {
-    const config = loadConfig(configPath);
-    if (config) {
-      const versions = getToolkitVersions(config);
-      log(`  Core version     : ${versions.core}`);
-      log(`  Platform version : ${versions.platform}`);
-
-      const toolkitConfig = loadConfig(join(TOOLKIT_ROOT, '.dw', 'config', 'dw.config.yml'));
-      if (toolkitConfig) {
-        const toolkitVersions = getToolkitVersions(toolkitConfig);
-        if (versions.core !== toolkitVersions.core) {
-          warn(`Update available: ${versions.core} → ${toolkitVersions.core} (run \`dw upgrade\`)`);
-          warnings++;
-        }
-      }
-    } else {
-      err('.dw/config/dw.config.yml — YAML parse error');
-      issues++;
-    }
-  }
-
-  info('Claude Files (Layer 1)');
-  if (platform === 'claude-cli' || existsSync(join(projectDir, '.claude'))) {
-    for (const file of CLAUDE_ESSENTIAL) {
-      const fullPath = join(projectDir, file);
-      if (existsSync(fullPath)) {
-        ok(file);
-      } else {
-        warn(`${file} — missing (optional for non-Claude platforms)`);
-        warnings++;
-      }
-    }
-
-    if (existsSync(join(projectDir, 'CLAUDE.md'))) {
-      ok('CLAUDE.md');
-    } else {
-      warn('CLAUDE.md — missing');
-      warnings++;
-    }
-  } else {
-    log('Skipped — not a Claude CLI project');
-  }
-
-  info('Adapter Structure (Layer 3)');
-  const adapterDirs = [
-    '.dw/adapters/claude-cli/generated',
-    '.dw/adapters/claude-cli/overrides',
-    '.dw/adapters/claude-cli/extensions',
-  ];
-  for (const dir of adapterDirs) {
-    if (existsSync(join(projectDir, dir))) {
-      ok(dir);
-    } else {
-      warn(`${dir} — missing`);
-      warnings++;
-    }
-  }
-
-  info('Runtime Directories');
-  for (const dir of ['.dw/tasks', '.dw/docs']) {
-    if (existsSync(join(projectDir, dir))) {
-      ok(dir);
-    } else {
-      warn(`${dir} — missing (will be created on first use)`);
-      warnings++;
-    }
-  }
-
-  console.log();
-  header('Diagnosis');
-  if (issues === 0 && warnings === 0) {
-    ok('Everything looks good!');
-  } else if (issues === 0) {
-    warn(`${warnings} warning(s), 0 errors — mostly fine`);
-  } else {
-    err(`${issues} error(s), ${warnings} warning(s) — run \`dw init\` to fix`);
-  }
-  console.log();
-
-  process.exit(issues > 0 ? 1 : 0);
-}
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { header, ok, warn, err, info, log } from '../lib/ui.mjs';
+import { loadConfig, getToolkitVersions } from '../lib/config.mjs';
+import { detectPlatform, platformLabel } from '../lib/platform.mjs';
+
+const TOOLKIT_ROOT = resolve(fileURLToPath(import.meta.url), '..', '..', '..');
+
+const CORE_FILES = [
+  '.dw/core/WORKFLOW.md',
+  '.dw/core/THINKING.md',
+  '.dw/core/QUALITY.md',
+  '.dw/core/ROLES.md',
+];
+
+const V2_OPTIONAL = [
+  '.dw/core/PILLARS.md',
+  '.dw/decisions',
+  '.dw/tasks/ACTIVE.md',
+  '.dw/metrics',
+];
+
+const CONFIG_FILES = [
+  '.dw/config/dw.config.yml',
+  '.dw/config/config.schema.json',
+];
+
+const CLAUDE_ESSENTIAL = [
+  '.claude/settings.json',
+  '.claude/hooks/pre-commit-gate.sh',
+  '.claude/hooks/safety-guard.sh',
+];
+
+export async function doctorCommand() {
+  const projectDir = process.cwd();
+
+  header('dw-kit Doctor');
+  let issues = 0;
+  let warnings = 0;
+
+  info('Environment');
+  log(`Node.js     : ${process.version}`);
+  log(`Platform    : ${process.platform} ${process.arch}`);
+  log(`Working dir : ${projectDir}`);
+
+  const pkg = JSON.parse(readFileSync(join(TOOLKIT_ROOT, 'package.json'), 'utf-8'));
+  log(`dw-kit CLI  : v${pkg.version}`);
+
+  const platform = detectPlatform(projectDir);
+  log(`AI Platform : ${platformLabel(platform)}`);
+
+  info('Core Files (Layer 0)');
+  for (const file of CORE_FILES) {
+    const fullPath = join(projectDir, file);
+    if (existsSync(fullPath)) {
+      ok(file);
+    } else {
+      err(`${file} — MISSING`);
+      issues++;
+    }
+  }
+
+  info('Config (Layer 2)');
+  for (const file of CONFIG_FILES) {
+    const fullPath = join(projectDir, file);
+    if (existsSync(fullPath)) {
+      ok(file);
+    } else {
+      err(`${file} — MISSING`);
+      issues++;
+    }
+  }
+
+  const configPath = join(projectDir, '.dw', 'config', 'dw.config.yml');
+  if (existsSync(configPath)) {
+    const config = loadConfig(configPath);
+    if (config) {
+      const versions = getToolkitVersions(config);
+      log(`  Core version     : ${versions.core}`);
+      log(`  Platform version : ${versions.platform}`);
+
+      const toolkitConfig = loadConfig(join(TOOLKIT_ROOT, '.dw', 'config', 'dw.config.yml'));
+      if (toolkitConfig) {
+        const toolkitVersions = getToolkitVersions(toolkitConfig);
+        if (versions.core !== toolkitVersions.core) {
+          warn(`Update available: ${versions.core} → ${toolkitVersions.core} (run \`dw upgrade\`)`);
+          warnings++;
+        }
+      }
+    } else {
+      err('.dw/config/dw.config.yml — YAML parse error');
+      issues++;
+    }
+  }
+
+  info('Claude Files (Layer 1)');
+  if (platform === 'claude-cli' || existsSync(join(projectDir, '.claude'))) {
+    for (const file of CLAUDE_ESSENTIAL) {
+      const fullPath = join(projectDir, file);
+      if (existsSync(fullPath)) {
+        ok(file);
+      } else {
+        warn(`${file} — missing (optional for non-Claude platforms)`);
+        warnings++;
+      }
+    }
+
+    if (existsSync(join(projectDir, 'CLAUDE.md'))) {
+      ok('CLAUDE.md');
+    } else {
+      warn('CLAUDE.md — missing');
+      warnings++;
+    }
+  } else {
+    log('Skipped — not a Claude CLI project');
+  }
+
+  info('Adapter Structure (Layer 3)');
+  const adapterDirs = [
+    '.dw/adapters/claude-cli/generated',
+    '.dw/adapters/claude-cli/overrides',
+    '.dw/adapters/claude-cli/extensions',
+  ];
+  for (const dir of adapterDirs) {
+    if (existsSync(join(projectDir, dir))) {
+      ok(dir);
+    } else {
+      warn(`${dir} — missing`);
+      warnings++;
+    }
+  }
+
+  info('Runtime Directories');
+  for (const dir of ['.dw/tasks', '.dw/docs']) {
+    if (existsSync(join(projectDir, dir))) {
+      ok(dir);
+    } else {
+      warn(`${dir} — missing (will be created on first use)`);
+      warnings++;
+    }
+  }
+
+  info('v2 Artifacts (optional)');
+  for (const path of V2_OPTIONAL) {
+    if (existsSync(join(projectDir, path))) {
+      ok(path);
+    } else {
+      log(`  ${path} — not yet created (opt-in)`);
+    }
+  }
+
+  console.log();
+  header('Diagnosis');
+  if (issues === 0 && warnings === 0) {
+    ok('Everything looks good!');
+  } else if (issues === 0) {
+    warn(`${warnings} warning(s), 0 errors — mostly fine`);
+  } else {
+    err(`${issues} error(s), ${warnings} warning(s) — run \`dw init\` to fix`);
+  }
+  console.log();
+
+  process.exit(issues > 0 ? 1 : 0);
+}