cuhlab-companion 0.1.0

package/dist/bin/cuhlab.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cuhlab.d.ts.map

package/dist/bin/cuhlab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cuhlab.d.ts","sourceRoot":"","sources":["../../bin/cuhlab.ts"],"names":[],"mappings":""}

package/dist/bin/cuhlab.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("../src/index.js");
+(0, index_js_1.main)(process.argv.slice(2)).catch((err) => {
+    console.error(`\n  Fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cuhlab.js.map

package/dist/bin/cuhlab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cuhlab.js","sourceRoot":"","sources":["../../bin/cuhlab.ts"],"names":[],"mappings":";;;AACA,8CAAuC;AAEvC,IAAA,eAAI,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/claude-md.d.ts

@@ -0,0 +1,11 @@
+interface ClaudeMdOptions {
+    projectId: string;
+    projectUrl: string;
+}
+/**
+ * Generate a .claude/CLAUDE.md file in the project directory.
+ * Only overwrites if the file starts with "# Cuhlab Project" (preserves user customizations).
+ */
+export declare function generateClaudeMd(projectDir: string, options: ClaudeMdOptions): void;
+export {};
+//# sourceMappingURL=claude-md.d.ts.map

package/dist/src/claude-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../../src/claude-md.ts"],"names":[],"mappings":"AAKA,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,IAAI,CAkFN"}

package/dist/src/claude-md.js

@@ -0,0 +1,123 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateClaudeMd = generateClaudeMd;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const HEADER = '# Cuhlab Project';
+/**
+ * Generate a .claude/CLAUDE.md file in the project directory.
+ * Only overwrites if the file starts with "# Cuhlab Project" (preserves user customizations).
+ */
+function generateClaudeMd(projectDir, options) {
+    const claudeDir = path.join(projectDir, '.claude');
+    const claudeMdPath = path.join(claudeDir, 'CLAUDE.md');
+    // Check if file exists and was user-customized
+    if (fs.existsSync(claudeMdPath)) {
+        const existing = fs.readFileSync(claudeMdPath, 'utf-8');
+        if (!existing.startsWith(HEADER)) {
+            // User has customized it — don't overwrite
+            return;
+        }
+    }
+    // Ensure .claude directory exists
+    if (!fs.existsSync(claudeDir)) {
+        fs.mkdirSync(claudeDir, { recursive: true });
+    }
+    const content = `${HEADER}
+
+> Auto-generated by Cuhlab Companion. Edit freely — this file won't be overwritten
+> unless it starts with "# Cuhlab Project".
+
+## Project Info
+
+- **Project ID:** ${options.projectId}
+- **Project URL:** ${options.projectUrl}
+
+## Workflow
+
+This project uses Cuhlab for collaborative development. Here's how the workflow works:
+
+### Making Changes
+1. Edit files locally in this directory
+2. Use \`git add . && git commit -m "your message" && git push\` to push changes
+3. Changes appear on your individual branch in the Cuhlab web UI
+
+### Deploying to Live
+To deploy your changes to the live/production site:
+\`\`\`bash
+git add . && git commit -m "update from cuhlab" && git push
+\`\`\`
+Then use the "Deploy to Live" button in the web UI, or the \`push_to_shared\` MCP tool.
+
+### Pulling Latest
+To get the latest changes from the live site:
+\`\`\`bash
+git pull origin main
+\`\`\`
+
+## MCP Tools Reference
+
+The following MCP tools are available when connected to Cuhlab:
+
+| Tool | Description |
+|------|-------------|
+| \`list_files\` | List files in a directory |
+| \`read_file\` | Read file contents |
+| \`write_file\` | Create or update a file |
+| \`delete_file\` | Delete a file |
+| \`push_to_shared\` | Deploy changes to the live project |
+| \`pull_from_shared\` | Pull latest from live |
+| \`view_pending\` | See open pull requests |
+| \`view_activity\` | See recent merged changes |
+| \`approve_change\` | Approve and merge a PR |
+| \`reject_change\` | Reject a PR with feedback |
+| \`request_approval\` | Ask user for approval (returns approvalId) |
+| \`check_approval\` | Check status of an approval request |
+| \`project_status\` | Get project overview |
+| \`preview_url\` | Get preview URLs |
+| \`get_user_input\` | Check for user messages |
+| \`send_response\` | Send message to user |
+
+## Rules
+
+- **Never push directly to main** — always use your branch and create a PR
+- Keep commits small and descriptive
+- Test changes locally before deploying to live
+`;
+    fs.writeFileSync(claudeMdPath, content, 'utf-8');
+    console.log('  Generated .claude/CLAUDE.md');
+}
+//# sourceMappingURL=claude-md.js.map

package/dist/src/claude-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.js","sourceRoot":"","sources":["../../src/claude-md.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,4CAqFC;AAnGD,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,MAAM,GAAG,kBAAkB,CAAC;AAOlC;;;GAGG;AACH,SAAgB,gBAAgB,CAC9B,UAAkB,EAClB,OAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAEvD,+CAA+C;IAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,2CAA2C;YAC3C,OAAO;QACT,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,MAAM;;;;;;;oBAOP,OAAO,CAAC,SAAS;qBAChB,OAAO,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDtC,CAAC;IAEA,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/detect-tools.d.ts

@@ -0,0 +1,16 @@
+export interface DetectedTool {
+    name: string;
+    command: string;
+    version: string;
+    authenticated: boolean;
+}
+/**
+ * Detect which AI coding tools are installed on this system.
+ * Checks for Claude Code, Codex CLI, and Gemini CLI.
+ */
+export declare function detectTools(): Promise<DetectedTool[]>;
+/**
+ * Print a summary of detected tools to the console.
+ */
+export declare function printToolSummary(tools: DetectedTool[]): void;
+//# sourceMappingURL=detect-tools.d.ts.map

package/dist/src/detect-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-tools.d.ts","sourceRoot":"","sources":["../../src/detect-tools.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAyB3D;AAwFD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAgB5D"}

package/dist/src/detect-tools.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTools = detectTools;
+exports.printToolSummary = printToolSummary;
+const child_process_1 = require("child_process");
+const platform_js_1 = require("./platform.js");
+/**
+ * Detect which AI coding tools are installed on this system.
+ * Checks for Claude Code, Codex CLI, and Gemini CLI.
+ */
+async function detectTools() {
+    const tools = [];
+    // Claude Code
+    const claudePath = platform_js_1.platform.claudeCodePath();
+    if (claudePath) {
+        const tool = await probeClaudeCode(claudePath);
+        if (tool)
+            tools.push(tool);
+    }
+    // Codex CLI
+    const codexPath = platform_js_1.platform.codexPath();
+    if (codexPath) {
+        const tool = await probeCodex(codexPath);
+        if (tool)
+            tools.push(tool);
+    }
+    // Gemini CLI
+    const geminiPath = platform_js_1.platform.geminiPath();
+    if (geminiPath) {
+        const tool = await probeGemini(geminiPath);
+        if (tool)
+            tools.push(tool);
+    }
+    return tools;
+}
+async function probeClaudeCode(binaryPath) {
+    let version = 'unknown';
+    let authenticated = false;
+    try {
+        version = (0, child_process_1.execSync)(`"${binaryPath}" --version`, {
+            encoding: 'utf8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        // Could not get version but binary exists
+    }
+    try {
+        const authOutput = (0, child_process_1.execSync)(`"${binaryPath}" auth status`, {
+            encoding: 'utf8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // Claude Code auth status returns info about the authenticated user
+        authenticated = authOutput.length > 0 && !authOutput.toLowerCase().includes('not authenticated');
+    }
+    catch {
+        // Auth check failed; assume not authenticated
+    }
+    return {
+        name: 'Claude Code',
+        command: binaryPath,
+        version,
+        authenticated,
+    };
+}
+async function probeCodex(binaryPath) {
+    let version = 'unknown';
+    let authenticated = false;
+    try {
+        version = (0, child_process_1.execSync)(`"${binaryPath}" --version`, {
+            encoding: 'utf8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        // Could not get version
+    }
+    // Codex CLI authenticates via OPENAI_API_KEY env var
+    authenticated = typeof process.env.OPENAI_API_KEY === 'string' && process.env.OPENAI_API_KEY.length > 0;
+    return {
+        name: 'Codex CLI',
+        command: binaryPath,
+        version,
+        authenticated,
+    };
+}
+async function probeGemini(binaryPath) {
+    let version = 'unknown';
+    let authenticated = false;
+    try {
+        version = (0, child_process_1.execSync)(`"${binaryPath}" --version`, {
+            encoding: 'utf8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        // Could not get version
+    }
+    // Gemini CLI authenticates via GOOGLE_API_KEY or gcloud
+    authenticated =
+        (typeof process.env.GOOGLE_API_KEY === 'string' && process.env.GOOGLE_API_KEY.length > 0) ||
+            (typeof process.env.GEMINI_API_KEY === 'string' && process.env.GEMINI_API_KEY.length > 0);
+    return {
+        name: 'Gemini CLI',
+        command: binaryPath,
+        version,
+        authenticated,
+    };
+}
+/**
+ * Print a summary of detected tools to the console.
+ */
+function printToolSummary(tools) {
+    if (tools.length === 0) {
+        console.log('\n  No AI coding tools detected.');
+        console.log('  Install Claude Code, Codex CLI, or Gemini CLI to get started.\n');
+        return;
+    }
+    console.log(`\n  Detected ${tools.length} AI tool${tools.length > 1 ? 's' : ''}:\n`);
+    for (const tool of tools) {
+        const authLabel = tool.authenticated ? 'authenticated' : 'not authenticated';
+        console.log(`    ${tool.name}`);
+        console.log(`      Path:    ${tool.command}`);
+        console.log(`      Version: ${tool.version}`);
+        console.log(`      Auth:    ${authLabel}`);
+        console.log('');
+    }
+}
+//# sourceMappingURL=detect-tools.js.map

package/dist/src/detect-tools.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parse CLI arguments and dispatch to the appropriate command.
+ */
+export declare function main(args: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BxD"}

package/dist/src/index.js

@@ -0,0 +1,221 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const fs = __importStar(require("fs"));
+const server_js_1 = require("./server.js");
+const detect_tools_js_1 = require("./detect-tools.js");
+const version_js_1 = require("./version.js");
+const welcome_js_1 = require("./welcome.js");
+const CUHLAB_API_BASE = 'https://davisbrief.com';
+const URL_PATTERNS = [
+    /^https?:\/\/(?:www\.)?davisbrief\.com\/project\/([a-zA-Z0-9_-]+)/,
+    /^https?:\/\/localhost:\d+\/project\/([a-zA-Z0-9_-]+)/,
+];
+/**
+ * Parse CLI arguments and dispatch to the appropriate command.
+ */
+async function main(args) {
+    const command = args[0];
+    if (!command || command === '--help' || command === '-h') {
+        (0, welcome_js_1.printWelcome)();
+        return;
+    }
+    if (command === '--version' || command === '-v') {
+        console.log((0, version_js_1.versionString)());
+        return;
+    }
+    switch (command) {
+        case 'connect':
+            await handleConnect(args.slice(1));
+            break;
+        case 'status':
+            await handleStatus();
+            break;
+        default:
+            console.error(`  Unknown command: ${command}\n`);
+            printHelp();
+            process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`
+  ${bold((0, version_js_1.versionString)())}
+
+  Connect your local AI coding tools to the Cuhlab browser IDE.
+
+  ${bold('Usage:')}
+
+    cuhlab connect <project-url>     Connect to a Cuhlab project
+    cuhlab status                    Show connection status and detected tools
+    cuhlab --help                    Show this help message
+    cuhlab --version                 Show version number
+
+  ${bold('Examples:')}
+
+    cuhlab connect https://davisbrief.com/project/my-app
+    cuhlab status
+
+  ${bold('How it works:')}
+
+    1. Run "cuhlab connect <url>" in your project directory
+    2. The companion starts a local terminal and WebSocket server
+    3. Your Cuhlab browser tab connects to the companion
+    4. AI tool actions appear in the browser for review
+    5. Terminal output streams to the browser in real time
+`);
+}
+async function handleConnect(args) {
+    const projectUrl = args[0];
+    if (!projectUrl) {
+        console.error('  Error: Missing project URL.\n');
+        console.error('  Usage: cuhlab connect <project-url>');
+        console.error('  Example: cuhlab connect https://davisbrief.com/project/my-app\n');
+        process.exit(1);
+    }
+    // Extract project ID from URL
+    const projectId = extractProjectId(projectUrl);
+    if (!projectId) {
+        console.error('  Error: Could not extract project ID from URL.\n');
+        console.error('  Expected URL format: https://davisbrief.com/project/<project-id>\n');
+        process.exit(1);
+    }
+    // Determine project directory (current working directory)
+    const projectDir = process.cwd();
+    if (!fs.existsSync(projectDir)) {
+        console.error(`  Error: Directory does not exist: ${projectDir}\n`);
+        process.exit(1);
+    }
+    // Determine API base URL
+    const apiBaseUrl = extractApiBase(projectUrl);
+    console.log(`\n  ${bold('Cuhlab Companion')}\n`);
+    console.log(`  Project:   ${projectId}`);
+    console.log(`  Directory: ${projectDir}`);
+    console.log(`  API:       ${apiBaseUrl}`);
+    // Detect installed AI tools
+    const tools = await (0, detect_tools_js_1.detectTools)();
+    (0, detect_tools_js_1.printToolSummary)(tools);
+    // Start the server
+    const server = new server_js_1.CompanionServer({
+        projectId,
+        projectDir,
+        apiBaseUrl,
+    });
+    // Handle graceful shutdown
+    const shutdown = async () => {
+        console.log('\n  Shutting down...');
+        await server.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    try {
+        await server.start();
+        console.log(`  ${bold('Ready.')} Open your project in the Cuhlab browser to connect.\n`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`\n  Error: ${message}\n`);
+        process.exit(1);
+    }
+}
+async function handleStatus() {
+    console.log(`\n  ${bold('Cuhlab Companion Status')}\n`);
+    // Check if a companion server is already running
+    const wsRunning = await checkPort(19836);
+    const httpRunning = await checkPort(19837);
+    if (wsRunning || httpRunning) {
+        console.log('  Companion server: running');
+        console.log(`    WebSocket (port 19836): ${wsRunning ? 'active' : 'inactive'}`);
+        console.log(`    Permission (port 19837): ${httpRunning ? 'active' : 'inactive'}`);
+        // Try to get status from the WebSocket server's HTTP endpoint
+        if (wsRunning) {
+            try {
+                const response = await fetch('http://127.0.0.1:19836/');
+                if (response.ok) {
+                    const data = await response.json();
+                    console.log(`    Project: ${data.projectId || 'unknown'}`);
+                    console.log(`    PTY: ${data.pty ? 'running' : 'stopped'}`);
+                    console.log(`    Browser: ${data.browser ? 'connected' : 'disconnected'}`);
+                    if (typeof data.pendingPermissions === 'number' && data.pendingPermissions > 0) {
+                        console.log(`    Pending permissions: ${data.pendingPermissions}`);
+                    }
+                }
+            }
+            catch {
+                // Could not reach server status endpoint
+            }
+        }
+    }
+    else {
+        console.log('  Companion server: not running');
+    }
+    // Show detected tools
+    const tools = await (0, detect_tools_js_1.detectTools)();
+    (0, detect_tools_js_1.printToolSummary)(tools);
+}
+function extractProjectId(urlStr) {
+    for (const pattern of URL_PATTERNS) {
+        const match = urlStr.match(pattern);
+        if (match && match[1]) {
+            return match[1];
+        }
+    }
+    return null;
+}
+function extractApiBase(urlStr) {
+    try {
+        const parsed = new URL(urlStr);
+        return `${parsed.protocol}//${parsed.host}`;
+    }
+    catch {
+        return CUHLAB_API_BASE;
+    }
+}
+async function checkPort(port) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${port}/`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function bold(text) {
+    return `\x1b[1m${text}\x1b[0m`;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/mcp-config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Configure Claude Code hooks in the project directory.
+ * Writes to .claude/settings.local.json, merging with any existing settings.
+ */
+export declare function configureClaudeCode(projectDir: string): boolean;
+/**
+ * Configure Codex CLI for the project.
+ * Codex CLI uses a .codex/config.json file in the project directory for hooks.
+ */
+export declare function configureCodexCli(projectDir: string): boolean;
+/**
+ * Configure Gemini CLI for the project.
+ * Gemini CLI uses a .gemini/settings.json file in the project directory.
+ */
+export declare function configureGeminiCli(projectDir: string): boolean;
+/**
+ * Auto-configure all detected AI tools for the given project directory.
+ * Returns the number of tools successfully configured.
+ */
+export declare function configureAllTools(projectDir: string): number;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/src/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/mcp-config.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAmD/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAmC7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAoC9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAyB5D"}