@relipa/ai-flow-kit 0.1.1-beta.0 → 0.1.2-beta.0

package/scripts/doctor.js

@@ -1,218 +1,192 @@
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-const { spawnSync } = require('child_process');
-const { detectRtk, isRtkHookConfigured, isGitNexusConfigured } = require('./init');
-
-function formatAgo(isoString) {
-    const ms = Date.now() - new Date(isoString).getTime();
-    const mins = Math.floor(ms / 60000);
-    if (mins < 1)   return 'just now';
-    if (mins < 60)  return `${mins}m ago`;
-    const hrs = Math.floor(mins / 60);
-    if (hrs < 24)   return `${hrs}h ago`;
-    return `${Math.floor(hrs / 24)}d ago`;
-}
-
-async function showTokenBreakdown(ticketId) {
-    const tasksDir = path.join(process.cwd(), '.aiflow', 'tasks');
-    const checkpointsFile = path.join(tasksDir, ticketId, 'checkpoints.json');
-    if (!(await fs.pathExists(checkpointsFile))) return;
-
-    const data = await fs.readJson(checkpointsFile).catch(() => ({ checkpoints: [] }));
-    if (!data.checkpoints || data.checkpoints.length === 0) return;
-
-    // Aggregate tokens per gate (taking the max/latest)
-    const gateTokens = {};
-    for (const cp of data.checkpoints) {
-        if (!gateTokens[cp.gate] || cp.tokens > gateTokens[cp.gate]) {
-            gateTokens[cp.gate] = cp.tokens;
-        }
-    }
-
-    const GATE_LABELS = { 1: 'Analyze', 2: 'Plan', 3: 'Code', 4: 'Review', 5: 'PR' };
-    const gates = Object.keys(gateTokens).sort();
-    const total = gates.reduce((sum, g) => sum + gateTokens[g], 0);
-
-    console.log('');
-    console.log(chalk.bold(`Token usage for task ${ticketId}:`));
-    for (const g of gates) {
-        const label = GATE_LABELS[parseInt(g)] || `Gate ${g}`;
-        const t = gateTokens[g];
-        const bar = '█'.repeat(Math.round((t / total) * 20)).padEnd(20, '░');
-        const pct = Math.round((t / total) * 100);
-        console.log(`  Gate ${g}  ${label.padEnd(8)}  ~${t.toLocaleString().padStart(6)}  ${chalk.gray(bar)}  ${pct}%`);
-    }
-    console.log(`  Total estimated: ~${total.toLocaleString()} tokens`);
-}
-
-module.exports = async function doctor(options = {}) {
-    const projectDir = process.cwd();
-    const errors = [];
-    const warnings = [];
-
-    console.log(chalk.blue('Running health check for AI Flow Kit...\n'));
-
-    // ── Token breakdown ────────────────────────────────────────
-    let ticketId = options.ticket;
-    if (!ticketId) {
-        const contextFile = path.join(projectDir, '.aiflow', 'context', 'current.json');
-        if (await fs.pathExists(contextFile)) {
-            const ctx = await fs.readJson(contextFile).catch(() => ({}));
-            ticketId = ctx.taskId;
-        }
-    }
-
-    if (ticketId) {
-        await showTokenBreakdown(ticketId);
-    }
-
-    // ── Core setup ─────────────────────────────────────────────
-    if (!(await fs.pathExists(path.join(projectDir, '.claude', 'skills')))) {
-        errors.push('Missing `.claude/skills` directory. Did you run `aiflow init`?');
-    } else {
-        console.log(chalk.green('✓ .claude/skills exists'));
-    }
-
-    if (!(await fs.pathExists(path.join(projectDir, '.rules')))) {
-        errors.push('Missing `.rules` directory.');
-    } else {
-        console.log(chalk.green('✓ .rules exists'));
-    }
-
-    if (!(await fs.pathExists(path.join(projectDir, 'CLAUDE.md')))) {
-        errors.push('Missing CLAUDE.md. AI context prompt is not set up.');
-    } else {
-        console.log(chalk.green('✓ CLAUDE.md exists'));
-    }
-
-    // ── Version tracking ───────────────────────────────────────
-    const stateFile = path.join(projectDir, '.aiflow', 'state.json');
-    if (!(await fs.pathExists(stateFile))) {
-        errors.push('Missing `.aiflow/state.json`. Version tracking is broken.');
-    } else {
-        const state = await fs.readJson(stateFile);
-        console.log(chalk.green(`✓ Version tracking active (v${state.current_version})`));
-    }
-
-    // ── SessionStart hook ──────────────────────────────────────
-    const settingsPath = path.join(projectDir, '.claude', 'settings.json');
-    if (await fs.pathExists(settingsPath)) {
-        const settings = await fs.readJson(settingsPath).catch(() => ({}));
-        const hookList = settings?.hooks?.SessionStart || [];
-        const hasSessionHook = hookList.some(h =>
-            (h.hooks || []).some(e => typeof e.command === 'string' && e.command.includes('session-start'))
-        );
-        if (hasSessionHook) {
-            console.log(chalk.green('✓ SessionStart hook configured'));
-        } else {
-            warnings.push('SessionStart hook not found in .claude/settings.json — run `aiflow init` to set it up.');
-        }
-    } else {
-        warnings.push('Missing .claude/settings.json — run `aiflow init`.');
-    }
-
-    // ── Clipboard ─────────────────────────────────────────────
-    if (process.platform === 'linux') {
-        const isWsl = (() => {
-            try { return /microsoft|wsl/i.test(require('fs').readFileSync('/proc/version', 'utf-8')); }
-            catch (_) { return false; }
-        })();
-
-        if (!isWsl) {
-            const hasWlCopy  = spawnSync('which', ['wl-copy'],  { stdio: 'ignore' }).status === 0;
-            const hasXclip   = spawnSync('which', ['xclip'],    { stdio: 'ignore' }).status === 0;
-            const hasXsel    = spawnSync('which', ['xsel'],     { stdio: 'ignore' }).status === 0;
-
-            if (hasWlCopy || hasXclip || hasXsel) {
-                const tool = hasWlCopy ? 'wl-copy' : hasXclip ? 'xclip' : 'xsel';
-                console.log(chalk.green(`✓ Clipboard tool available (${tool})`));
-            } else {
-                const isWayland = !!process.env.WAYLAND_DISPLAY;
-                const pkg = isWayland ? 'wl-clipboard' : 'xclip';
-                warnings.push(`Clipboard tool missing — \`ak prompt\` cannot copy to clipboard. Fix: sudo apt install ${pkg}`);
-                console.log(chalk.yellow(`  ⚠ Clipboard tool not found (need: ${pkg})`));
-                console.log(chalk.gray(`    Fix: sudo apt install ${pkg}`));
-            }
-        }
-    }
-
-    // ── Token savings tools ────────────────────────────────────
-    console.log('');
-    console.log(chalk.bold('Token savings:'));
-
-    // RTK
-    const rtk = await detectRtk();
-    if (rtk.installed) {
-        const hookOk = await isRtkHookConfigured(projectDir);
-        if (hookOk) {
-            console.log(chalk.green(`  ✓ RTK (${rtk.version}) — bash output compression active`));
-            console.log(chalk.gray('    Estimated: 60–90% reduction on bash command outputs (test runs, git, npm...)'));
-        } else {
-            console.log(chalk.yellow(`  ⚠ RTK installed (${rtk.version}) but hook not configured`));
-            warnings.push('RTK hook not configured. Run `aiflow init` to enable token compression.');
-        }
-    } else {
-        console.log(chalk.gray('  ○ RTK not installed — bash output compression inactive'));
-        console.log(chalk.gray('    Install: cargo install rtk  |  Enable: aiflow init --with-rtk'));
-    }
-
-    // GitNexus
-    const gnConfigured = await isGitNexusConfigured(projectDir);
-    const gnStatusPath = path.join(projectDir, '.aiflow', 'gitnexus-status.json');
-    if (gnConfigured) {
-        let statusLine = chalk.green('  ✓ GitNexus MCP configured');
-        try {
-            if (await fs.pathExists(gnStatusPath)) {
-                const gn = await fs.readJson(gnStatusPath);
-                const GITNEXUS_STALE_MS = 3 * 60 * 60 * 1000; // 3 hours
-                if (gn.status === 'done') {
-                    const ago = gn.completedAt
-                        ? chalk.gray(` — indexed ${formatAgo(gn.completedAt)}`)
-                        : '';
-                    statusLine = chalk.green(`  ✓ GitNexus MCP configured — index ready${ago}`);
-                    console.log(statusLine);
-                    console.log(chalk.gray('    Estimated: ~50% fewer tokens at Gate 1 (context queries vs file reads)'));
-                    console.log(chalk.gray('    Estimated: ~70% fewer tokens at Gate 4 (impact() vs grep codebase)'));
-                } else if (gn.status === 'running') {
-                    const age = Date.now() - new Date(gn.startedAt).getTime();
-                    if (age > GITNEXUS_STALE_MS) {
-                        console.log(chalk.red('  ✗ GitNexus MCP configured — indexing timed out (stale)'));
-                        console.log(chalk.gray(`    Started ${formatAgo(gn.startedAt)} but never finished. Process may have crashed.`));
-                        // console.log(chalk.gray('    Retry: aiflow init --with-gitnexus --wait  |  Log: .aiflow/gitnexus-analyze.log'));
-                    } else {
-                        console.log(chalk.yellow('  ⟳ GitNexus MCP configured — indexing in progress...'));
-                        console.log(chalk.gray('    Log: .aiflow/gitnexus-analyze.log'));
-                    }
-                } else if (gn.status === 'error') {
-                    console.log(chalk.red('  ✗ GitNexus MCP configured — last index failed'));
-                    console.log(chalk.gray('    Retry: npx gitnexus analyze  |  Log: .aiflow/gitnexus-analyze.log'));
-                }
-            } else {
-                console.log(chalk.yellow('  ⚠ GitNexus MCP configured but not yet indexed'));
-                console.log(chalk.gray('    Run: npx gitnexus analyze'));
-            }
-        } catch (_) {
-            console.log(statusLine);
-        }
-    } else {
-        console.log(chalk.gray('  ○ GitNexus not configured — code intelligence inactive'));
-        // console.log(chalk.gray('    Enable: aiflow init --with-gitnexus'));
-    }
-
-    // ── Summary ────────────────────────────────────────────────
-    console.log('');
-    if (warnings.length > 0) {
-        console.log(chalk.yellow('Warnings:'));
-        warnings.forEach(w => console.log(chalk.yellow(`  ⚠ ${w}`)));
-        console.log('');
-    }
-
-    if (errors.length > 0) {
-        console.log(chalk.red('Issues found:'));
-        errors.forEach(e => console.log(chalk.red(`  ✗ ${e}`)));
-        console.log(chalk.yellow('\nTry running `aiflow init` or `aiflow update` to fix these files.'));
-    } else {
-        console.log(chalk.green('✨ Everything looks healthy! You are ready to fly.'));
-    }
-};
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const { detectRtk, isRtkHookConfigured, isGitNexusConfigured } = require('./init');
+
+function formatAgo(isoString) {
+    const ms = Date.now() - new Date(isoString).getTime();
+    const mins = Math.floor(ms / 60000);
+    if (mins < 1)   return 'just now';
+    if (mins < 60)  return `${mins}m ago`;
+    const hrs = Math.floor(mins / 60);
+    if (hrs < 24)   return `${hrs}h ago`;
+    return `${Math.floor(hrs / 24)}d ago`;
+}
+
+async function showTokenBreakdown(ticketId) {
+    const tasksDir = path.join(process.cwd(), '.aiflow', 'tasks');
+    const checkpointsFile = path.join(tasksDir, ticketId, 'checkpoints.json');
+    if (!(await fs.pathExists(checkpointsFile))) return;
+
+    const data = await fs.readJson(checkpointsFile).catch(() => ({ checkpoints: [] }));
+    if (!data.checkpoints || data.checkpoints.length === 0) return;
+
+    // Aggregate tokens per gate (taking the max/latest)
+    const gateTokens = {};
+    for (const cp of data.checkpoints) {
+        if (!gateTokens[cp.gate] || cp.tokens > gateTokens[cp.gate]) {
+            gateTokens[cp.gate] = cp.tokens;
+        }
+    }
+
+    const GATE_LABELS = { 1: 'Analyze', 2: 'Plan', 3: 'Code', 4: 'Review', 5: 'PR' };
+    const gates = Object.keys(gateTokens).sort();
+    const total = gates.reduce((sum, g) => sum + gateTokens[g], 0);
+
+    console.log('');
+    console.log(chalk.bold(`Token usage for task ${ticketId}:`));
+    for (const g of gates) {
+        const label = GATE_LABELS[parseInt(g)] || `Gate ${g}`;
+        const t = gateTokens[g];
+        const bar = '█'.repeat(Math.round((t / total) * 20)).padEnd(20, '░');
+        const pct = Math.round((t / total) * 100);
+        console.log(`  Gate ${g}  ${label.padEnd(8)}  ~${t.toLocaleString().padStart(6)}  ${chalk.gray(bar)}  ${pct}%`);
+    }
+    console.log(`  Total estimated: ~${total.toLocaleString()} tokens`);
+}
+
+module.exports = async function doctor(options = {}) {
+    const projectDir = process.cwd();
+    const errors = [];
+    const warnings = [];
+
+    console.log(chalk.blue('Running health check for AI Flow Kit...\n'));
+
+    // ── Token breakdown ────────────────────────────────────────
+    let ticketId = options.ticket;
+    if (!ticketId) {
+        const contextFile = path.join(projectDir, '.aiflow', 'context', 'current.json');
+        if (await fs.pathExists(contextFile)) {
+            const ctx = await fs.readJson(contextFile).catch(() => ({}));
+            ticketId = ctx.taskId;
+        }
+    }
+
+    if (ticketId) {
+        await showTokenBreakdown(ticketId);
+    }
+
+    // ── Core setup ─────────────────────────────────────────────
+    if (!(await fs.pathExists(path.join(projectDir, '.claude', 'skills')))) {
+        errors.push('Missing `.claude/skills` directory. Did you run `aiflow init`?');
+    } else {
+        console.log(chalk.green('✓ .claude/skills exists'));
+    }
+
+    if (!(await fs.pathExists(path.join(projectDir, '.rules')))) {
+        errors.push('Missing `.rules` directory.');
+    } else {
+        console.log(chalk.green('✓ .rules exists'));
+    }
+
+    if (!(await fs.pathExists(path.join(projectDir, 'CLAUDE.md')))) {
+        errors.push('Missing CLAUDE.md. AI context prompt is not set up.');
+    } else {
+        console.log(chalk.green('✓ CLAUDE.md exists'));
+    }
+
+    // ── Version tracking ───────────────────────────────────────
+    const stateFile = path.join(projectDir, '.aiflow', 'state.json');
+    if (!(await fs.pathExists(stateFile))) {
+        errors.push('Missing `.aiflow/state.json`. Version tracking is broken.');
+    } else {
+        const state = await fs.readJson(stateFile);
+        console.log(chalk.green(`✓ Version tracking active (v${state.current_version})`));
+    }
+
+    // ── SessionStart hook ──────────────────────────────────────
+    const settingsPath = path.join(projectDir, '.claude', 'settings.json');
+    if (await fs.pathExists(settingsPath)) {
+        const settings = await fs.readJson(settingsPath).catch(() => ({}));
+        const hookList = settings?.hooks?.SessionStart || [];
+        const hasSessionHook = hookList.some(h =>
+            (h.hooks || []).some(e => typeof e.command === 'string' && e.command.includes('session-start'))
+        );
+        if (hasSessionHook) {
+            console.log(chalk.green('✓ SessionStart hook configured'));
+        } else {
+            warnings.push('SessionStart hook not found in .claude/settings.json — run `aiflow init` to set it up.');
+        }
+    } else {
+        warnings.push('Missing .claude/settings.json — run `aiflow init`.');
+    }
+
+    // ── Token savings tools ────────────────────────────────────
+    console.log('');
+    console.log(chalk.bold('Token savings:'));
+
+    // RTK
+    const rtk = await detectRtk();
+    if (rtk.installed) {
+        const hookOk = await isRtkHookConfigured(projectDir);
+        if (hookOk) {
+            console.log(chalk.green(`  ✓ RTK (${rtk.version}) — bash output compression active`));
+            console.log(chalk.gray('    Estimated: 60–90% reduction on bash command outputs (test runs, git, npm...)'));
+        } else {
+            console.log(chalk.yellow(`  ⚠ RTK installed (${rtk.version}) but hook not configured`));
+            warnings.push('RTK hook not configured. Run `aiflow init` to enable token compression.');
+        }
+    } else {
+        console.log(chalk.gray('  ○ RTK not installed — bash output compression inactive'));
+        console.log(chalk.gray('    Install: cargo install rtk  |  Enable: aiflow init --with-rtk'));
+    }
+
+    // GitNexus
+    const gnConfigured = await isGitNexusConfigured(projectDir);
+    const gnStatusPath = path.join(projectDir, '.aiflow', 'gitnexus-status.json');
+    if (gnConfigured) {
+        let statusLine = chalk.green('  ✓ GitNexus MCP configured');
+        try {
+            if (await fs.pathExists(gnStatusPath)) {
+                const gn = await fs.readJson(gnStatusPath);
+                const GITNEXUS_STALE_MS = 3 * 60 * 60 * 1000; // 3 hours
+                if (gn.status === 'done') {
+                    const ago = gn.completedAt
+                        ? chalk.gray(` — indexed ${formatAgo(gn.completedAt)}`)
+                        : '';
+                    statusLine = chalk.green(`  ✓ GitNexus MCP configured — index ready${ago}`);
+                    console.log(statusLine);
+                    console.log(chalk.gray('    Estimated: ~50% fewer tokens at Gate 1 (context queries vs file reads)'));
+                    console.log(chalk.gray('    Estimated: ~70% fewer tokens at Gate 4 (impact() vs grep codebase)'));
+                } else if (gn.status === 'running') {
+                    const age = Date.now() - new Date(gn.startedAt).getTime();
+                    if (age > GITNEXUS_STALE_MS) {
+                        console.log(chalk.red('  ✗ GitNexus MCP configured — indexing timed out (stale)'));
+                        console.log(chalk.gray(`    Started ${formatAgo(gn.startedAt)} but never finished. Process may have crashed.`));
+                        // console.log(chalk.gray('    Retry: aiflow init --with-gitnexus --wait  |  Log: .aiflow/gitnexus-analyze.log'));
+                    } else {
+                        console.log(chalk.yellow('  ⟳ GitNexus MCP configured — indexing in progress...'));
+                        console.log(chalk.gray('    Log: .aiflow/gitnexus-analyze.log'));
+                    }
+                } else if (gn.status === 'error') {
+                    console.log(chalk.red('  ✗ GitNexus MCP configured — last index failed'));
+                    console.log(chalk.gray('    Retry: npx gitnexus analyze  |  Log: .aiflow/gitnexus-analyze.log'));
+                }
+            } else {
+                console.log(chalk.yellow('  ⚠ GitNexus MCP configured but not yet indexed'));
+                console.log(chalk.gray('    Run: npx gitnexus analyze'));
+            }
+        } catch (_) {
+            console.log(statusLine);
+        }
+    } else {
+        console.log(chalk.gray('  ○ GitNexus not configured — code intelligence inactive'));
+        // console.log(chalk.gray('    Enable: aiflow init --with-gitnexus'));
+    }
+
+    // ── Summary ────────────────────────────────────────────────
+    console.log('');
+    if (warnings.length > 0) {
+        console.log(chalk.yellow('Warnings:'));
+        warnings.forEach(w => console.log(chalk.yellow(`  ⚠ ${w}`)));
+        console.log('');
+    }
+
+    if (errors.length > 0) {
+        console.log(chalk.red('Issues found:'));
+        errors.forEach(e => console.log(chalk.red(`  ✗ ${e}`)));
+        console.log(chalk.yellow('\nTry running `aiflow init` or `aiflow update` to fix these files.'));
+    } else {
+        console.log(chalk.green('✨ Everything looks healthy! You are ready to fly.'));
+    }
+};