@promptwheel/cli 0.6.0

package/dist/lib/doctor.js

@@ -0,0 +1,382 @@
+/**
+ * Doctor checks for PromptWheel prerequisites
+ *
+ * Detects missing tools, auth issues, and configuration problems
+ * before users hit cryptic errors mid-workflow.
+ */
+import { spawnSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Helper to create CheckResult objects consistently
+ */
+function createCheckResult(name, status, message, options) {
+    const result = { name, status, message };
+    if (options?.fix)
+        result.fix = options.fix;
+    if (options?.details)
+        result.details = options.details;
+    return result;
+}
+/**
+ * Run all doctor checks
+ */
+export async function runDoctorChecks(options) {
+    const checks = [];
+    // 1. Git installed
+    checks.push(checkGitInstalled());
+    // 2. In a git repo
+    checks.push(checkIsGitRepo(options.repoRoot));
+    // 3. Node version
+    checks.push(checkNodeVersion());
+    // 4. Claude CLI installed
+    checks.push(checkClaudeInstalled());
+    // 5. Claude CLI authenticated
+    checks.push(await checkClaudeAuthenticated());
+    // 6. gh CLI installed (for --pr)
+    checks.push(checkGhInstalled());
+    // 7. gh CLI authenticated (for --pr)
+    checks.push(await checkGhAuthenticated());
+    // 8. .promptwheel/ writable
+    checks.push(checkPromptwheelWritable(options.repoRoot));
+    // 9. Optional: ripgrep for faster scanning
+    checks.push(checkRipgrepInstalled());
+    // 10. SQLite native module
+    checks.push(await checkSqliteModule());
+    // Determine capabilities
+    const hasGit = checks.find(c => c.name === 'git')?.status === 'pass';
+    const isRepo = checks.find(c => c.name === 'git-repo')?.status === 'pass';
+    const hasClaude = checks.find(c => c.name === 'claude')?.status === 'pass';
+    const claudeAuth = checks.find(c => c.name === 'claude-auth')?.status === 'pass';
+    const hasGh = checks.find(c => c.name === 'gh')?.status === 'pass';
+    const ghAuth = checks.find(c => c.name === 'gh-auth')?.status === 'pass';
+    const writable = checks.find(c => c.name === 'promptwheel-dir')?.status !== 'fail';
+    const hasSqlite = checks.find(c => c.name === 'sqlite')?.status === 'pass';
+    return {
+        checks,
+        canScout: hasGit && isRepo && writable && hasSqlite,
+        canRun: hasGit && isRepo && hasClaude && claudeAuth && writable && hasSqlite,
+        canPr: hasGit && isRepo && hasClaude && claudeAuth && hasGh && ghAuth && writable && hasSqlite,
+    };
+}
+/**
+ * Check: git installed
+ */
+function checkGitInstalled() {
+    try {
+        const result = spawnSync('git', ['--version'], { encoding: 'utf-8' });
+        if (result.status === 0) {
+            const version = result.stdout.trim().replace('git version ', '');
+            return createCheckResult('git', 'pass', `git found (${version})`);
+        }
+    }
+    catch {
+        // Fall through to fail
+    }
+    return createCheckResult('git', 'fail', 'git not found', {
+        fix: 'Install git: https://git-scm.com/downloads',
+    });
+}
+/**
+ * Check: current directory is a git repo
+ */
+function checkIsGitRepo(repoRoot) {
+    const cwd = repoRoot ?? process.cwd();
+    try {
+        const result = spawnSync('git', ['rev-parse', '--git-dir'], {
+            cwd,
+            encoding: 'utf-8',
+        });
+        if (result.status === 0) {
+            return createCheckResult('git-repo', 'pass', 'Inside a git repository');
+        }
+    }
+    catch {
+        // Fall through to fail
+    }
+    return createCheckResult('git-repo', 'fail', 'Not a git repository', {
+        fix: 'Run `git init` or cd into an existing repo',
+    });
+}
+/**
+ * Check: Node version is supported
+ */
+function checkNodeVersion() {
+    const version = process.version;
+    const major = parseInt(version.slice(1).split('.')[0], 10);
+    // Require Node 18+ for ESM and modern features
+    if (major >= 18) {
+        return createCheckResult('node', 'pass', `Node ${version} (supported)`);
+    }
+    if (major >= 16) {
+        return createCheckResult('node', 'warn', `Node ${version} (may work, but 18+ recommended)`, {
+            fix: 'Upgrade to Node 18+: https://nodejs.org/',
+        });
+    }
+    return createCheckResult('node', 'fail', `Node ${version} (too old)`, {
+        fix: 'Upgrade to Node 18+: https://nodejs.org/',
+    });
+}
+/**
+ * Check: Claude CLI installed
+ */
+function checkClaudeInstalled() {
+    try {
+        const result = spawnSync('claude', ['--version'], {
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        if (result.status === 0) {
+            const version = result.stdout.trim();
+            return createCheckResult('claude', 'pass', `Claude CLI found (${version})`);
+        }
+    }
+    catch {
+        // Fall through to fail
+    }
+    return createCheckResult('claude', 'fail', 'Claude CLI not found', {
+        fix: 'Install Claude Code: https://claude.ai/code',
+        details: 'Required for `solo run` to execute tickets',
+    });
+}
+/**
+ * Check: Claude CLI authenticated
+ */
+async function checkClaudeAuthenticated() {
+    try {
+        // Try a simple command that requires auth
+        const result = spawnSync('claude', ['--help'], {
+            encoding: 'utf-8',
+            timeout: 10000,
+        });
+        // If claude is installed, assume it handles its own auth
+        // We can't easily test auth without making an API call
+        if (result.status === 0) {
+            return createCheckResult('claude-auth', 'pass', 'Claude CLI accessible', {
+                details: 'Auth will be checked on first run',
+            });
+        }
+    }
+    catch {
+        // Fall through
+    }
+    // If Claude isn't installed, skip this check
+    return createCheckResult('claude-auth', 'warn', 'Could not verify Claude authentication', {
+        fix: 'Run `claude` and complete authentication',
+    });
+}
+/**
+ * Check: gh CLI installed
+ */
+function checkGhInstalled() {
+    try {
+        const result = spawnSync('gh', ['--version'], {
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        if (result.status === 0) {
+            const firstLine = result.stdout.split('\n')[0];
+            const version = firstLine.replace('gh version ', '').split(' ')[0];
+            return createCheckResult('gh', 'pass', `GitHub CLI found (${version})`);
+        }
+    }
+    catch {
+        // Fall through
+    }
+    return createCheckResult('gh', 'warn', 'GitHub CLI not found', {
+        fix: 'Install gh: https://cli.github.com/',
+        details: 'Only needed for `solo run --pr` to create PRs',
+    });
+}
+/**
+ * Check: gh CLI authenticated
+ */
+async function checkGhAuthenticated() {
+    try {
+        const result = spawnSync('gh', ['auth', 'status'], {
+            encoding: 'utf-8',
+            timeout: 10000,
+        });
+        if (result.status === 0) {
+            // Parse the output to get the account
+            const match = result.stdout.match(/Logged in to .* as (\S+)/);
+            const account = match ? match[1] : 'authenticated';
+            return createCheckResult('gh-auth', 'pass', `GitHub CLI authenticated (${account})`);
+        }
+        // Check stderr for more info
+        if (result.stderr?.includes('not logged in')) {
+            return createCheckResult('gh-auth', 'warn', 'GitHub CLI not authenticated', {
+                fix: 'Run `gh auth login`',
+                details: 'Only needed for `solo run --pr` to create PRs',
+            });
+        }
+    }
+    catch {
+        // Fall through
+    }
+    return createCheckResult('gh-auth', 'warn', 'Could not verify GitHub authentication', {
+        fix: 'Run `gh auth login`',
+        details: 'Only needed for `solo run --pr` to create PRs',
+    });
+}
+/**
+ * Check: .promptwheel/ directory is writable
+ */
+function checkPromptwheelWritable(repoRoot) {
+    const cwd = repoRoot ?? process.cwd();
+    const promptwheelDir = path.join(cwd, '.promptwheel');
+    try {
+        // Check if directory exists
+        if (fs.existsSync(promptwheelDir)) {
+            // Check if writable
+            fs.accessSync(promptwheelDir, fs.constants.W_OK);
+            return createCheckResult('promptwheel-dir', 'pass', '.promptwheel/ exists and is writable');
+        }
+        // Directory doesn't exist - check if we can create it
+        fs.accessSync(cwd, fs.constants.W_OK);
+        return createCheckResult('promptwheel-dir', 'pass', '.promptwheel/ can be created');
+    }
+    catch {
+        return createCheckResult('promptwheel-dir', 'fail', 'Cannot write to .promptwheel/', {
+            fix: 'Check directory permissions or run with appropriate access',
+        });
+    }
+}
+/**
+ * Check: ripgrep installed (optional, for faster scanning)
+ */
+function checkRipgrepInstalled() {
+    try {
+        const result = spawnSync('rg', ['--version'], {
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        if (result.status === 0) {
+            const version = result.stdout.split('\n')[0].replace('ripgrep ', '');
+            return createCheckResult('ripgrep', 'pass', `ripgrep found (${version})`, {
+                details: 'Enables faster code scanning',
+            });
+        }
+    }
+    catch {
+        // Fall through
+    }
+    return createCheckResult('ripgrep', 'warn', 'ripgrep not found (optional)', {
+        fix: 'Install rg: https://github.com/BurntSushi/ripgrep#installation',
+        details: 'Scanning will work but may be slower on large repos',
+    });
+}
+/**
+ * Check: SQLite native module
+ *
+ * better-sqlite3 is a native module that requires either:
+ * 1. Prebuild binary for the platform (automatic via prebuild-install)
+ * 2. Node-gyp build tools (python, c++ compiler)
+ */
+async function checkSqliteModule() {
+    try {
+        // Try to import better-sqlite3 - this will fail if native module isn't built
+        const { default: Database } = await import('better-sqlite3');
+        // Try to create a temporary in-memory database
+        const db = new Database(':memory:');
+        db.exec('SELECT 1');
+        db.close();
+        return createCheckResult('sqlite', 'pass', 'SQLite native module loaded', {
+            details: 'better-sqlite3 working correctly',
+        });
+    }
+    catch (err) {
+        const error = err;
+        const message = error.message || String(err);
+        // Check for common native module errors
+        if (message.includes('Could not locate the bindings file') ||
+            message.includes('was compiled against a different Node.js version') ||
+            message.includes('NODE_MODULE_VERSION')) {
+            return createCheckResult('sqlite', 'fail', 'SQLite native module needs rebuild', {
+                fix: 'Run: npm rebuild better-sqlite3',
+                details: message,
+            });
+        }
+        if (message.includes('Cannot find module')) {
+            return createCheckResult('sqlite', 'fail', 'SQLite native module not installed', {
+                fix: 'Run: npm install better-sqlite3',
+                details: message,
+            });
+        }
+        // Generic failure
+        return createCheckResult('sqlite', 'fail', 'SQLite native module failed to load', {
+            fix: 'Try: npm rebuild better-sqlite3. If that fails, ensure you have build tools (python, c++ compiler)',
+            details: message,
+        });
+    }
+}
+/**
+ * Format doctor report for human-readable output
+ */
+export function formatDoctorReport(report) {
+    const lines = [];
+    // Status icons
+    const icons = {
+        pass: '✅',
+        warn: '⚠️',
+        fail: '❌',
+    };
+    lines.push('PromptWheel Doctor\n');
+    // Group checks by status
+    const failed = report.checks.filter(c => c.status === 'fail');
+    const warned = report.checks.filter(c => c.status === 'warn');
+    // Show all checks
+    for (const check of report.checks) {
+        lines.push(`${icons[check.status]} ${check.message}`);
+        if (check.fix && check.status !== 'pass') {
+            lines.push(`   fix: ${check.fix}`);
+        }
+    }
+    lines.push('');
+    // Summary
+    lines.push('Capabilities:');
+    lines.push(`  ${report.canScout ? '✅' : '❌'} solo scout — Find improvement opportunities`);
+    lines.push(`  ${report.canRun ? '✅' : '❌'} solo run — Execute tickets with Claude`);
+    lines.push(`  ${report.canPr ? '✅' : '❌'} solo run --pr — Create PRs on GitHub`);
+    // Action items if there are failures
+    if (failed.length > 0) {
+        lines.push('');
+        lines.push('Action required:');
+        for (const check of failed) {
+            if (check.fix) {
+                lines.push(`  • ${check.fix}`);
+            }
+        }
+    }
+    // Warnings that might affect workflow
+    if (warned.length > 0 && failed.length === 0) {
+        lines.push('');
+        lines.push('Optional improvements:');
+        for (const check of warned) {
+            if (check.fix) {
+                lines.push(`  • ${check.fix}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format doctor report as JSON
+ */
+export function formatDoctorReportJson(report) {
+    return JSON.stringify({
+        checks: report.checks.map(c => ({
+            name: c.name,
+            status: c.status,
+            message: c.message,
+            fix: c.fix,
+            details: c.details,
+        })),
+        capabilities: {
+            scout: report.canScout,
+            run: report.canRun,
+            pr: report.canPr,
+        },
+    }, null, 2);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/lib/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/lib/doctor.ts"],"names":[],"mappings":"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"}

package/dist/lib/exclusion-index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Exclusion index — discovers what artifact patterns a project generates
+ * by scanning for indicator files (lockfiles, configs, build manifests)
+ * and writes any patterns missing from .gitignore to the worktree's
+ * .git/info/exclude so `git status` filters them natively.
+ *
+ * Detection is organic: the project's own files tell us what frameworks
+ * and languages are in use, and therefore what artifact directories will
+ * exist.  The INDICATOR_MAP below is a knowledge base that drives
+ * detection — it only fires when we actually find the indicator file in
+ * the worktree, not unconditionally.
+ *
+ * As a second layer, solo-ticket.ts captures a baseline `git status`
+ * snapshot after dep install (before the agent runs).  Anything present
+ * in the baseline is subtracted from the post-agent status, so even
+ * artifacts the indicator map doesn't know about are filtered out.
+ *
+ * Note: the enterprise worker path (src/worker/) uses `git diff --name-only`
+ * which only shows tracked changes and is not affected by untracked
+ * artifacts.  This module is only used by the CLI solo path.
+ */
+/**
+ * Resolve the git common directory for a worktree.
+ *
+ * Git reads `info/exclude` from the *common* dir — not the per-worktree
+ * dir.  For a normal repo `.git/` IS the common dir.  For a linked
+ * worktree `.git` is a file pointing to `.git/worktrees/<name>/`; the
+ * common dir is its grandparent (`.git/`).
+ *
+ * Exported for testing.
+ */
+export declare function resolveGitDir(worktreePath: string): string;
+/**
+ * Build an exclusion index for a worktree by scanning the project tree
+ * for indicator files and writing any inferred artifact patterns to
+ * `.git/info/exclude`.
+ *
+ * Call this after worktree creation but before installing dependencies
+ * or running the agent. After this, `git status --porcelain` natively
+ * filters out all discovered artifact directories.
+ *
+ * Idempotent — safe to call multiple times on the same worktree
+ * (e.g. on ticket retry).  Subsequent calls are no-ops.
+ *
+ * @param worktreePath - Absolute path to the worktree root
+ * @param maxDepth - How deep to scan for indicators (default 4, sufficient for monorepos)
+ * @returns List of patterns written to the exclude file (empty on no-op)
+ */
+export declare function buildExclusionIndex(worktreePath: string, maxDepth?: number): string[];
+//# sourceMappingURL=exclusion-index.d.ts.map

package/dist/lib/exclusion-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusion-index.d.ts","sourceRoot":"","sources":["../../src/lib/exclusion-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA+JH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAkC1D;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,EAAE,CA2ChF"}