kachow 0.1.0

package/dist/index.js

@@ -0,0 +1,510 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * KA-CHOW CLI — single entry point for the living knowledge graph.
+ *
+ * Primary command:  kachow init
+ *   1. Runs credential wizard → saves .env
+ *   2. Starts backend automatically
+ *   3. Creates default team
+ *   4. Scans current repo and assigns it to team
+ *   5. Opens browser at localhost:3000
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const dotenv_1 = __importDefault(require("dotenv"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const http_1 = __importDefault(require("http"));
+const child_process_1 = require("child_process");
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const config_js_1 = require("./config.js");
+const setup_js_1 = require("./setup.js");
+// ── Data directory ────────────────────────────────────────────────────────────
+const KACHOW_DIR_NAME = '.kachow';
+function getDataDir(dir) {
+    return path_1.default.join(dir, KACHOW_DIR_NAME);
+}
+function getEnvPath(dir) {
+    return path_1.default.join(getDataDir(dir), '.env');
+}
+function getConfigJsonPath(dir) {
+    return path_1.default.join(getDataDir(dir), 'config.json');
+}
+function readLocalConfig(dir) {
+    const p = getConfigJsonPath(dir);
+    if (!fs_1.default.existsSync(p))
+        return {};
+    try {
+        return JSON.parse(fs_1.default.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeLocalConfig(dir, data) {
+    const d = getDataDir(dir);
+    if (!fs_1.default.existsSync(d))
+        fs_1.default.mkdirSync(d, { recursive: true });
+    fs_1.default.writeFileSync(getConfigJsonPath(dir), JSON.stringify(data, null, 2));
+}
+// ── Load .env from .kachow dir if it exists ───────────────────────────────────
+const cwd = process.cwd();
+const kachowEnv = getEnvPath(cwd);
+if (fs_1.default.existsSync(kachowEnv)) {
+    dotenv_1.default.config({ path: kachowEnv });
+}
+else {
+    dotenv_1.default.config();
+}
+// ── Locate server package (npm-installed or monorepo) ──────────────────────────
+function getServerDir() {
+    // When installed via npm: __dirname is <pkg>/dist/, _server/ is at <pkg>/_server/
+    const bundled = path_1.default.resolve(__dirname, '../_server');
+    if (fs_1.default.existsSync(path_1.default.join(bundled, 'dist/server.js')))
+        return bundled;
+    // Monorepo dev: __dirname is packages/cli/dist/, server is at packages/server/
+    const mono = path_1.default.resolve(__dirname, '../../server');
+    if (fs_1.default.existsSync(path_1.default.join(mono, 'dist/server.js')))
+        return mono;
+    // Last resort: check for unbuilt monorepo with tsx
+    if (fs_1.default.existsSync(path_1.default.join(mono, 'src/server.ts')))
+        return mono;
+    return mono; // will fail later with a helpful message
+}
+const program = new commander_1.Command();
+program.name('kachow').description('⚡ KA-CHOW — Living knowledge graph').version('0.1.0');
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function apiGet(port, apiPath) {
+    return new Promise((resolve, reject) => {
+        http_1.default.get(`http://localhost:${port}${apiPath}`, (r) => {
+            let b = '';
+            r.on('data', (c) => { b += c.toString(); });
+            r.on('end', () => { try {
+                resolve(JSON.parse(b));
+            }
+            catch {
+                reject(new Error('Invalid JSON'));
+            } });
+        }).on('error', reject);
+    });
+}
+function apiPost(port, apiPath, data) {
+    return new Promise((resolve, reject) => {
+        const body = JSON.stringify(data);
+        const req = http_1.default.request({
+            hostname: 'localhost', port, path: apiPath, method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) }
+        }, (r) => {
+            let buf = '';
+            r.on('data', (c) => { buf += c.toString(); });
+            r.on('end', () => { try {
+                resolve(JSON.parse(buf));
+            }
+            catch {
+                reject(new Error('Invalid JSON'));
+            } });
+        });
+        req.on('error', reject);
+        req.write(body);
+        req.end();
+    });
+}
+async function waitForServer(port, retries = 25) {
+    for (let i = 0; i < retries; i++) {
+        await new Promise(r => setTimeout(r, 1000));
+        try {
+            await apiGet(port, '/health');
+            return true;
+        }
+        catch {
+            process.stdout.write('.');
+        }
+    }
+    return false;
+}
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+    (0, child_process_1.spawn)(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
+}
+function detectRepos(cwd) {
+    const repos = [];
+    const langMarkers = [
+        { file: 'package.json', lang: 'typescript' },
+        { file: 'setup.py', lang: 'python' },
+        { file: 'pyproject.toml', lang: 'python' },
+        { file: 'pom.xml', lang: 'java' },
+        { file: 'go.mod', lang: 'go' },
+        { file: 'Cargo.toml', lang: 'rust' },
+    ];
+    // Check CWD itself
+    const cwdLang = langMarkers.find(m => fs_1.default.existsSync(path_1.default.join(cwd, m.file)))?.lang;
+    if (cwdLang)
+        repos.push({ name: path_1.default.basename(cwd), path: cwd, language: cwdLang });
+    // Scan common monorepo subdirs
+    for (const subdir of ['services', 'packages', 'apps']) {
+        const subdirPath = path_1.default.join(cwd, subdir);
+        if (!fs_1.default.existsSync(subdirPath))
+            continue;
+        for (const entry of fs_1.default.readdirSync(subdirPath, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const ep = path_1.default.join(subdirPath, entry.name);
+            const lang = langMarkers.find(m => fs_1.default.existsSync(path_1.default.join(ep, m.file)))?.lang;
+            if (lang)
+                repos.push({ name: entry.name, path: ep, language: lang });
+        }
+    }
+    return repos;
+}
+function generateConfig(dir, repos) {
+    return js_yaml_1.default.dump({
+        version: 1,
+        project: { name: path_1.default.basename(dir), description: `Auto-detected from ${dir}` },
+        repos: repos.map(r => ({ name: r.name, path: path_1.default.relative(dir, r.path) || '.', language: r.language })),
+        standards: { require_readme: true, require_error_handling: true, min_test_coverage: 70 },
+        llm: { anthropic_key: '${ANTHROPIC_API_KEY}', qa_model: 'claude-sonnet-4-6', healing_model: 'gpt-4o' },
+    }, { lineWidth: 80 });
+}
+// ── init ──────────────────────────────────────────────────────────────────────
+program.command('init')
+    .description('Setup KA-CHOW: credentials → server → team → scan → browser')
+    .option('-p, --port <number>', 'Server port', '3000')
+    .option('--no-browser', 'Skip opening browser')
+    .option('--skip-wizard', 'Skip credential wizard (use existing .env)')
+    .action(async (opts) => {
+    const port = parseInt(opts.port, 10);
+    const projectDir = process.cwd();
+    const dataDir = getDataDir(projectDir);
+    const envPath = getEnvPath(projectDir);
+    console.log('\n⚡ KA-CHOW init\n');
+    // ── 1. Ensure data directory ──────────────────────────────────────
+    if (!fs_1.default.existsSync(dataDir)) {
+        fs_1.default.mkdirSync(dataDir, { recursive: true });
+        const gitignore = path_1.default.join(projectDir, '.gitignore');
+        if (fs_1.default.existsSync(gitignore)) {
+            const content = fs_1.default.readFileSync(gitignore, 'utf-8');
+            if (!content.includes('.kachow')) {
+                fs_1.default.appendFileSync(gitignore, '\n# KA-CHOW local data\n.kachow/\n');
+                console.log('  ✓ Added .kachow/ to .gitignore');
+            }
+        }
+    }
+    // ── 2. Credential wizard ──────────────────────────────────────────
+    if (opts.skipWizard && fs_1.default.existsSync(envPath)) {
+        console.log('  ✓ Using existing credentials from .kachow/.env');
+        dotenv_1.default.config({ path: envPath, override: true });
+    }
+    else {
+        const creds = await (0, setup_js_1.runSetupWizard)(envPath);
+        (0, setup_js_1.writeEnvFile)(envPath, creds);
+        console.log(`  ✓ Saved credentials to .kachow/.env`);
+        dotenv_1.default.config({ path: envPath, override: true });
+    }
+    // ── 3. Find / create kachow.config.yaml ──────────────────────────
+    const yamlPath = path_1.default.join(projectDir, 'kachow.config.yaml');
+    let repos = [];
+    if (fs_1.default.existsSync(yamlPath)) {
+        console.log('  ✓ Found kachow.config.yaml');
+        try {
+            const cfg = (0, config_js_1.readConfig)(projectDir);
+            repos = (cfg.repos ?? []).map(r => ({
+                name: r.name,
+                path: path_1.default.resolve(projectDir, r.path ?? '.'),
+                language: r.language ?? 'unknown',
+            }));
+        }
+        catch { /* fallback to auto-detect */ }
+    }
+    if (repos.length === 0) {
+        console.log('  🔍 Auto-detecting repos...');
+        repos = detectRepos(projectDir);
+        if (repos.length === 0) {
+            repos = [{ name: path_1.default.basename(projectDir), path: projectDir, language: 'unknown' }];
+        }
+        console.log(`  Found: ${repos.map(r => r.name).join(', ')}`);
+        fs_1.default.writeFileSync(yamlPath, generateConfig(projectDir, repos));
+        console.log('  ✓ Created kachow.config.yaml');
+    }
+    // ── 4. Start server ───────────────────────────────────────────────
+    let serverAlreadyRunning = false;
+    try {
+        await apiGet(port, '/health');
+        serverAlreadyRunning = true;
+        console.log(`  ✓ Server already running on :${port}`);
+    }
+    catch { /* not running */ }
+    if (!serverAlreadyRunning) {
+        console.log(`  🚀 Starting server on :${port}...`);
+        const serverPkg = getServerDir();
+        const distEntry = path_1.default.join(serverPkg, 'dist/server.js');
+        const srcEntry = path_1.default.join(serverPkg, 'src/server.ts');
+        const useTs = !fs_1.default.existsSync(distEntry) && fs_1.default.existsSync(srcEntry);
+        const entry = useTs ? srcEntry : distEntry;
+        if (!fs_1.default.existsSync(entry)) {
+            console.error(`  ✗ Server not found at ${entry}`);
+            console.error('    If installed via npm, try reinstalling: npm i -g kachow');
+            console.error('    If in monorepo, run: cd packages/server && pnpm build');
+            process.exit(1);
+        }
+        const childEnv = {
+            ...process.env,
+            PORT: String(port),
+            DB_PATH: path_1.default.join(dataDir, 'kachow.db'),
+        };
+        if (fs_1.default.existsSync(envPath)) {
+            const envContent = fs_1.default.readFileSync(envPath, 'utf-8');
+            for (const line of envContent.split('\n')) {
+                const t = line.trim();
+                if (!t || t.startsWith('#'))
+                    continue;
+                const eq = t.indexOf('=');
+                if (eq > 0)
+                    childEnv[t.slice(0, eq)] = t.slice(eq + 1);
+            }
+        }
+        const args = useTs ? ['tsx', entry] : [entry];
+        const cmd = useTs ? 'npx' : 'node';
+        const child = (0, child_process_1.spawn)(cmd, args, {
+            env: childEnv,
+            stdio: 'ignore',
+            detached: true,
+            cwd: serverPkg,
+        });
+        child.unref();
+        process.stdout.write('  Waiting for server');
+        const ready = await waitForServer(port);
+        console.log('');
+        if (!ready) {
+            console.error('  ✗ Server failed to start after 30s.');
+            console.error('    Try manually: cd packages/server && npx tsx src/server.ts');
+            process.exit(1);
+        }
+        console.log('  ✓ Server ready');
+    }
+    // ── 5. Create or reuse team ──────────────────────────────────────
+    let teamId;
+    const localCfg = readLocalConfig(projectDir);
+    if (localCfg.teamId) {
+        teamId = localCfg.teamId;
+        console.log(`  ✓ Using saved team: ${teamId.slice(0, 8)}...`);
+    }
+    else {
+        console.log('  🏗️  Creating default team...');
+        try {
+            const teamsRes = await apiGet(port, '/api/manager/teams');
+            const teams = (teamsRes.data ?? []);
+            if (teams.length > 0) {
+                teamId = teams[0].id;
+                console.log(`  ✓ Found existing team: ${teamId.slice(0, 8)}...`);
+            }
+            else {
+                const projectName = path_1.default.basename(projectDir);
+                const createRes = await apiPost(port, '/api/manager/teams', {
+                    name: projectName,
+                    description: `Default team for ${projectName}`,
+                });
+                const created = (createRes.data ?? {});
+                teamId = created.id ?? '';
+                if (!teamId) {
+                    console.error('  ✗ Failed to create team — no ID returned');
+                    process.exit(1);
+                }
+                console.log(`  ✓ Created team "${projectName}" → ${teamId.slice(0, 8)}...`);
+            }
+        }
+        catch (e) {
+            console.error(`  ✗ Team creation failed: ${e instanceof Error ? e.message : String(e)}`);
+            process.exit(1);
+        }
+        writeLocalConfig(projectDir, { ...localCfg, teamId });
+        (0, setup_js_1.appendToEnv)(envPath, 'DEFAULT_TEAM_ID', teamId);
+    }
+    // ── 6. Ingest repos ──────────────────────────────────────────────
+    console.log(`\n  📦 Scanning ${repos.length} repo(s)...\n`);
+    for (const repo of repos) {
+        if (!fs_1.default.existsSync(repo.path)) {
+            console.log(`  ⚠  ${repo.name}: path not found — skipping`);
+            continue;
+        }
+        try {
+            const r = await apiPost(port, '/api/ingest/repo', {
+                repoPath: repo.path,
+                repoName: repo.name,
+                team: repo.name,
+            });
+            const jobId = (r.data ?? {}).jobId;
+            console.log(`  ✓ ${repo.name} → job ${jobId?.slice(0, 8) ?? 'started'}`);
+        }
+        catch (e) {
+            console.log(`  ✗ ${repo.name}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    // ── 7. Open browser ──────────────────────────────────────────────
+    const url = `http://localhost:${port}`;
+    if (opts.browser !== false) {
+        console.log(`\n  🌐 Opening ${url} ...`);
+        setTimeout(() => openBrowser(url), 2000);
+    }
+    console.log(`\n  ⚡ KA-CHOW is live at ${url}`);
+    console.log(`     Team ID: ${teamId}`);
+    console.log(`     Data dir: ${dataDir}`);
+    console.log(`\n  Press Ctrl+C to stop the server.\n`);
+    // Keep process alive
+    await new Promise(() => { });
+});
+// ── serve ─────────────────────────────────────────────────────────────────────
+program.command('serve')
+    .description('Start the KA-CHOW server without re-scanning')
+    .option('-p, --port <number>', 'Port', '3000')
+    .action((opts) => {
+    const port = parseInt(opts.port, 10);
+    const projectDir = process.cwd();
+    const envPath = getEnvPath(projectDir);
+    const dataDir = getDataDir(projectDir);
+    if (fs_1.default.existsSync(envPath))
+        dotenv_1.default.config({ path: envPath, override: true });
+    process.env.PORT = String(port);
+    process.env.DB_PATH = process.env.DB_PATH ?? path_1.default.join(dataDir, 'kachow.db');
+    console.log(`🚀 KA-CHOW server on :${port}`);
+    const serverPkg = getServerDir();
+    const entry = path_1.default.join(serverPkg, 'dist/server.js');
+    if (!fs_1.default.existsSync(entry)) {
+        console.error('Server not found. If in monorepo: cd packages/server && pnpm build');
+        process.exit(1);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    require(entry);
+});
+// ── scan ──────────────────────────────────────────────────────────────────────
+program.command('scan')
+    .description('Scan a repo and add it to the knowledge graph')
+    .requiredOption('-p, --path <path>', 'Repository path')
+    .option('--port <number>', 'Server port', '3000')
+    .option('--name <name>', 'Service name')
+    .option('--team <team>', 'Team name')
+    .action(async (opts) => {
+    const port = parseInt(opts.port, 10);
+    const repoPath = path_1.default.resolve(opts.path);
+    const repoName = opts.name ?? path_1.default.basename(repoPath);
+    if (!fs_1.default.existsSync(repoPath)) {
+        console.error(`✗ Path not found: ${repoPath}`);
+        process.exit(1);
+    }
+    console.log(`🔍 Scanning ${repoName}...`);
+    try {
+        const r = await apiPost(port, '/api/ingest/repo', { repoPath, repoName, team: opts.team ?? null });
+        const jobId = (r.data ?? {}).jobId;
+        console.log(`✓ Job ${jobId} started — watch: GET http://localhost:${port}/api/ingest/status/${jobId}`);
+    }
+    catch {
+        console.error(`✗ Server not running on :${port}. Start with: kachow serve`);
+        process.exit(1);
+    }
+});
+// ── health ────────────────────────────────────────────────────────────────────
+program.command('health')
+    .description('Print system health')
+    .option('--port <number>', 'Server port', '3000')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    try {
+        const r = await apiGet(parseInt(opts.port, 10), '/api/graph/health');
+        const h = r.data;
+        if (opts.json) {
+            console.log(JSON.stringify(h, null, 2));
+            return;
+        }
+        const icon = h.overallScore >= 75 ? '💚' : h.overallScore >= 50 ? '🟡' : '🔴';
+        console.log(`\n${icon} KA-CHOW Health — ${h.overallScore}/100`);
+        console.log(`   Services: ${h.totalServices} | Healthy: ${h.healthy} | Warning: ${h.warning} | Critical: ${h.critical}`);
+        console.log(`   Edges: ${h.totalEdges}\n`);
+    }
+    catch {
+        console.error(`✗ Server not running on :${opts.port}`);
+        process.exit(1);
+    }
+});
+// ── onboard ───────────────────────────────────────────────────────────────────
+program.command('onboard')
+    .description('Print onboarding path for a new engineer')
+    .requiredOption('-r, --role <role>', 'backend-engineer | sre | engineering-manager')
+    .option('--port <number>', 'Server port', '3000')
+    .action(async (opts) => {
+    try {
+        const r = await apiGet(parseInt(opts.port, 10), `/api/manager/onboarding/path/${opts.role}`);
+        const d = r.data;
+        console.log(`\n🎓 Onboarding: ${opts.role}\n`);
+        for (const s of d.steps) {
+            console.log(`  ${s.step}. ${s.title} (~${s.estimatedMinutes}min)\n     ${s.description}\n`);
+        }
+    }
+    catch {
+        console.error(`✗ Server not running on :${opts.port}`);
+        process.exit(1);
+    }
+});
+// ── blueprint ─────────────────────────────────────────────────────────────────
+program.command('blueprint')
+    .description('Print service architecture blueprint')
+    .requiredOption('-s, --service <id>', 'Service ID')
+    .option('--port <number>', 'Server port', '3000')
+    .action(async (opts) => {
+    try {
+        const r = await apiGet(parseInt(opts.port, 10), `/api/architecture/blueprint/${opts.service}`);
+        const bp = r.data;
+        console.log(`\n📐 ${bp.service.name} — ${bp.service.healthScore}/100 (${bp.service.healthTier})`);
+        for (const s of bp.standardsCompliance)
+            console.log(`  ${s.passing ? '✓' : '✗'} ${s.standard}${s.violation ? ` — ${s.violation}` : ''}`);
+        console.log('');
+    }
+    catch {
+        console.error(`✗ Server not running on :${opts.port}`);
+        process.exit(1);
+    }
+});
+// ── reset ─────────────────────────────────────────────────────────────────────
+program.command('reset')
+    .description('Wipe the KA-CHOW database and local config')
+    .option('--force', 'Skip confirmation')
+    .action((opts) => {
+    if (!opts.force) {
+        console.log('⚠️  This will delete the KA-CHOW database and config.');
+        console.log('   Re-run with --force to confirm.');
+        return;
+    }
+    const projectDir = process.cwd();
+    const dataDir = getDataDir(projectDir);
+    const dbPath = path_1.default.join(dataDir, 'kachow.db');
+    if (fs_1.default.existsSync(dbPath)) {
+        fs_1.default.unlinkSync(dbPath);
+        console.log(`🗑️  Deleted ${dbPath}`);
+    }
+    const cfgPath = getConfigJsonPath(projectDir);
+    if (fs_1.default.existsSync(cfgPath)) {
+        fs_1.default.unlinkSync(cfgPath);
+        console.log(`🗑️  Deleted ${cfgPath}`);
+    }
+    console.log('✓ Reset complete. Run `kachow init` to start fresh.');
+});
+// ── analyze (CI mode) ─────────────────────────────────────────────────────────
+program.command('analyze')
+    .description('Run PR impact analysis in CI mode')
+    .requiredOption('--pr <number>', 'PR number')
+    .requiredOption('--repo <owner/repo>', 'GitHub repo')
+    .option('--port <number>', 'Server port', '3000')
+    .action(async (opts) => {
+    try {
+        const r = await apiPost(parseInt(opts.port, 10), '/api/ci/analyze-pr', { prNumber: parseInt(opts.pr, 10), repoFullName: opts.repo });
+        console.log(JSON.stringify(r, null, 2));
+    }
+    catch {
+        console.error(`✗ Server not running on :${opts.port}`);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map