@iloom/cli 0.1.14

package/dist/open-X6BTENPV.js

@@ -0,0 +1,278 @@
+#!/usr/bin/env node
+import {
+  DevServerManager
+} from "./chunk-W3DQTW63.js";
+import "./chunk-GZP4UGGM.js";
+import {
+  extractSettingsOverrides
+} from "./chunk-GYCR2LOU.js";
+import {
+  openBrowser
+} from "./chunk-YETJNRQM.js";
+import {
+  IdentifierParser
+} from "./chunk-H4E4THUZ.js";
+import "./chunk-SPYPLHMK.js";
+import {
+  calculatePortForBranch
+} from "./chunk-37DYYFVK.js";
+import "./chunk-BLCTGFZN.js";
+import {
+  ProjectCapabilityDetector
+} from "./chunk-CWR2SANQ.js";
+import "./chunk-2ZPFJQ3B.js";
+import {
+  extractPort,
+  parseEnvFile
+} from "./chunk-SJUQ2NDR.js";
+import {
+  GitWorktreeManager
+} from "./chunk-QEPVTTHD.js";
+import {
+  SettingsManager
+} from "./chunk-JBH2ZYYZ.js";
+import "./chunk-JQ7VOSTC.js";
+import {
+  logger
+} from "./chunk-GEHQXLEI.js";
+
+// src/commands/open.ts
+import path from "path";
+import fs from "fs-extra";
+import { execa } from "execa";
+var OpenCommand = class {
+  constructor(gitWorktreeManager = new GitWorktreeManager(), capabilityDetector = new ProjectCapabilityDetector(), identifierParser = new IdentifierParser(new GitWorktreeManager()), devServerManager = new DevServerManager(), settingsManager = new SettingsManager()) {
+    this.gitWorktreeManager = gitWorktreeManager;
+    this.capabilityDetector = capabilityDetector;
+    this.identifierParser = identifierParser;
+    this.devServerManager = devServerManager;
+    this.settingsManager = settingsManager;
+  }
+  async execute(input) {
+    const parsed = input.identifier ? await this.parseExplicitInput(input.identifier) : await this.autoDetectFromCurrentDirectory();
+    logger.debug(`Parsed input: ${JSON.stringify(parsed)}`);
+    const worktree = await this.findWorktreeForIdentifier(parsed);
+    logger.info(`Found worktree at: ${worktree.path}`);
+    const { capabilities, binEntries } = await this.capabilityDetector.detectCapabilities(worktree.path);
+    logger.debug(`Detected capabilities: ${capabilities.join(", ")}`);
+    if (capabilities.includes("web")) {
+      await this.openWebBrowser(worktree.path);
+    } else if (capabilities.includes("cli")) {
+      await this.runCLITool(worktree.path, binEntries, input.args ?? []);
+    } else {
+      throw new Error(
+        `No web or CLI capabilities detected for workspace at ${worktree.path}`
+      );
+    }
+  }
+  /**
+   * Parse explicit identifier input
+   */
+  async parseExplicitInput(identifier) {
+    const parsed = await this.identifierParser.parseForPatternDetection(identifier);
+    if (parsed.type === "description") {
+      throw new Error("Description input type is not supported in open command");
+    }
+    const result = {
+      type: parsed.type,
+      originalInput: parsed.originalInput,
+      autoDetected: false
+    };
+    if (parsed.number !== void 0) {
+      result.number = parsed.number;
+    }
+    if (parsed.branchName !== void 0) {
+      result.branchName = parsed.branchName;
+    }
+    return result;
+  }
+  /**
+   * Auto-detect identifier from current directory
+   * Same logic as FinishCommand.autoDetectFromCurrentDirectory()
+   */
+  async autoDetectFromCurrentDirectory() {
+    const currentDir = path.basename(process.cwd());
+    const prPattern = /_pr_(\d+)$/;
+    const prMatch = currentDir.match(prPattern);
+    if (prMatch == null ? void 0 : prMatch[1]) {
+      const prNumber = parseInt(prMatch[1], 10);
+      logger.debug(`Auto-detected PR #${prNumber} from directory: ${currentDir}`);
+      return {
+        type: "pr",
+        number: prNumber,
+        originalInput: currentDir,
+        autoDetected: true
+      };
+    }
+    const issuePattern = /issue-(\d+)/;
+    const issueMatch = currentDir.match(issuePattern);
+    if (issueMatch == null ? void 0 : issueMatch[1]) {
+      const issueNumber = parseInt(issueMatch[1], 10);
+      logger.debug(`Auto-detected issue #${issueNumber} from directory: ${currentDir}`);
+      return {
+        type: "issue",
+        number: issueNumber,
+        originalInput: currentDir,
+        autoDetected: true
+      };
+    }
+    const repoInfo = await this.gitWorktreeManager.getRepoInfo();
+    const currentBranch = repoInfo.currentBranch;
+    if (!currentBranch) {
+      throw new Error(
+        "Could not auto-detect identifier. Please provide an issue number, PR number, or branch name.\nExpected directory pattern: feat/issue-XX-description OR worktree with _pr_N suffix"
+      );
+    }
+    const branchIssueMatch = currentBranch.match(issuePattern);
+    if (branchIssueMatch == null ? void 0 : branchIssueMatch[1]) {
+      const issueNumber = parseInt(branchIssueMatch[1], 10);
+      logger.debug(`Auto-detected issue #${issueNumber} from branch: ${currentBranch}`);
+      return {
+        type: "issue",
+        number: issueNumber,
+        originalInput: currentBranch,
+        autoDetected: true
+      };
+    }
+    return {
+      type: "branch",
+      branchName: currentBranch,
+      originalInput: currentBranch,
+      autoDetected: true
+    };
+  }
+  /**
+   * Find worktree for the given identifier
+   */
+  async findWorktreeForIdentifier(parsed) {
+    let worktree = null;
+    if (parsed.type === "issue" && parsed.number !== void 0) {
+      worktree = await this.gitWorktreeManager.findWorktreeForIssue(parsed.number);
+    } else if (parsed.type === "pr" && parsed.number !== void 0) {
+      worktree = await this.gitWorktreeManager.findWorktreeForPR(parsed.number, "");
+    } else if (parsed.type === "branch" && parsed.branchName) {
+      worktree = await this.gitWorktreeManager.findWorktreeForBranch(
+        parsed.branchName
+      );
+    }
+    if (!worktree) {
+      throw new Error(
+        `No worktree found for ${this.formatParsedInput(parsed)}. Run 'il start ${parsed.originalInput}' to create one.`
+      );
+    }
+    return worktree;
+  }
+  /**
+   * Format parsed input for display
+   */
+  formatParsedInput(parsed) {
+    const autoLabel = parsed.autoDetected ? " (auto-detected)" : "";
+    if (parsed.type === "issue") {
+      return `issue #${parsed.number}${autoLabel}`;
+    }
+    if (parsed.type === "pr") {
+      return `PR #${parsed.number}${autoLabel}`;
+    }
+    return `branch "${parsed.branchName}"${autoLabel}`;
+  }
+  /**
+   * Open web browser with workspace URL
+   * Auto-starts dev server if not already running
+   */
+  async openWebBrowser(worktreePath) {
+    const port = await this.getWorkspacePort(worktreePath);
+    const serverReady = await this.devServerManager.ensureServerRunning(
+      worktreePath,
+      port
+    );
+    if (!serverReady) {
+      logger.warn(
+        `Dev server failed to start on port ${port}. Opening browser anyway...`
+      );
+    }
+    const url = `http://localhost:${port}`;
+    logger.info(`Opening browser: ${url}`);
+    await openBrowser(url);
+    logger.success("Browser opened");
+  }
+  /**
+   * Get port for workspace - reads from .env or calculates based on workspace type
+   */
+  async getWorkspacePort(worktreePath) {
+    var _a, _b;
+    const cliOverrides = extractSettingsOverrides();
+    const settings = await this.settingsManager.loadSettings(void 0, cliOverrides);
+    const basePort = ((_b = (_a = settings.capabilities) == null ? void 0 : _a.web) == null ? void 0 : _b.basePort) ?? 3e3;
+    const envPath = path.join(worktreePath, ".env");
+    if (await fs.pathExists(envPath)) {
+      const envContent = await fs.readFile(envPath, "utf8");
+      const envMap = parseEnvFile(envContent);
+      const port2 = extractPort(envMap);
+      if (port2) {
+        logger.debug(`Using PORT from .env: ${port2}`);
+        return port2;
+      }
+    }
+    logger.debug("PORT not found in .env, calculating from workspace identifier");
+    const worktrees = await this.gitWorktreeManager.listWorktrees();
+    const worktree = worktrees.find((wt) => wt.path === worktreePath);
+    if (!worktree) {
+      throw new Error(`Could not find worktree for path: ${worktreePath}`);
+    }
+    const dirName = path.basename(worktreePath);
+    const prPattern = /_pr_(\d+)$/;
+    const prMatch = dirName.match(prPattern);
+    if (prMatch == null ? void 0 : prMatch[1]) {
+      const prNumber = parseInt(prMatch[1], 10);
+      const port2 = basePort + prNumber;
+      logger.debug(`Calculated PORT for PR #${prNumber}: ${port2}`);
+      return port2;
+    }
+    const issuePattern = /issue-(\d+)/;
+    const issueMatch = dirName.match(issuePattern) ?? worktree.branch.match(issuePattern);
+    if (issueMatch == null ? void 0 : issueMatch[1]) {
+      const issueNumber = parseInt(issueMatch[1], 10);
+      const port2 = basePort + issueNumber;
+      logger.debug(`Calculated PORT for issue #${issueNumber}: ${port2}`);
+      return port2;
+    }
+    const port = calculatePortForBranch(worktree.branch, basePort);
+    logger.debug(`Calculated PORT for branch "${worktree.branch}": ${port}`);
+    return port;
+  }
+  /**
+   * Run CLI tool directly from worktree bin path (NO SYMLINKS!)
+   */
+  async runCLITool(worktreePath, binEntries, args) {
+    if (Object.keys(binEntries).length === 0) {
+      throw new Error("No bin entries found in package.json");
+    }
+    const firstEntry = Object.entries(binEntries)[0];
+    if (!firstEntry) {
+      throw new Error("No bin entries found in package.json");
+    }
+    const [binName, binPath] = firstEntry;
+    logger.debug(`Using bin entry: ${binName} -> ${binPath}`);
+    const binFilePath = path.resolve(worktreePath, binPath);
+    logger.debug(`Resolved bin file path: ${binFilePath}`);
+    if (!await fs.pathExists(binFilePath)) {
+      throw new Error(
+        `CLI executable not found: ${binFilePath}
+Make sure the project is built (run 'il start' first)`
+      );
+    }
+    logger.info(`Running CLI: node ${binFilePath} ${args.join(" ")}`);
+    await execa("node", [binFilePath, ...args], {
+      stdio: "inherit",
+      // Allow interactive CLIs (prompts, colors, etc.)
+      cwd: worktreePath,
+      // Execute in worktree context
+      env: process.env
+      // Inherit environment
+    });
+  }
+};
+export {
+  OpenCommand
+};
+//# sourceMappingURL=open-X6BTENPV.js.map

package/dist/open-X6BTENPV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/open.ts"],"sourcesContent":["import path from 'path'\nimport fs from 'fs-extra'\nimport { execa } from 'execa'\nimport { GitWorktreeManager } from '../lib/GitWorktreeManager.js'\nimport { ProjectCapabilityDetector } from '../lib/ProjectCapabilityDetector.js'\nimport { DevServerManager } from '../lib/DevServerManager.js'\nimport { SettingsManager } from '../lib/SettingsManager.js'\nimport { IdentifierParser } from '../utils/IdentifierParser.js'\nimport { openBrowser } from '../utils/browser.js'\nimport { parseEnvFile, extractPort } from '../utils/env.js'\nimport { calculatePortForBranch } from '../utils/port.js'\nimport { logger } from '../utils/logger.js'\nimport { extractSettingsOverrides } from '../utils/cli-overrides.js'\nimport type { GitWorktree } from '../types/worktree.js'\n\nexport interface OpenCommandInput {\n\tidentifier?: string\n\targs?: string[]\n}\n\ninterface ParsedOpenInput {\n\ttype: 'issue' | 'pr' | 'branch'\n\tnumber?: number // For issues and PRs\n\tbranchName?: string // For branches\n\toriginalInput: string\n\tautoDetected: boolean\n}\n\n/**\n * OpenCommand - Opens workspace in browser or runs CLI tool\n * Priority: Web first, CLI fallback\n */\nexport class OpenCommand {\n\tconstructor(\n\t\tprivate gitWorktreeManager = new GitWorktreeManager(),\n\t\tprivate capabilityDetector = new ProjectCapabilityDetector(),\n\t\tprivate identifierParser = new IdentifierParser(new GitWorktreeManager()),\n\t\tprivate devServerManager = new DevServerManager(),\n\t\tprivate settingsManager = new SettingsManager()\n\t) {}\n\n\tasync execute(input: OpenCommandInput): Promise<void> {\n\t\t// 1. Parse or auto-detect identifier\n\t\tconst parsed = input.identifier\n\t\t\t? await this.parseExplicitInput(input.identifier)\n\t\t\t: await this.autoDetectFromCurrentDirectory()\n\n\t\tlogger.debug(`Parsed input: ${JSON.stringify(parsed)}`)\n\n\t\t// 2. Find worktree path based on identifier\n\t\tconst worktree = await this.findWorktreeForIdentifier(parsed)\n\n\t\tlogger.info(`Found worktree at: ${worktree.path}`)\n\n\t\t// 3. Detect project capabilities\n\t\tconst { capabilities, binEntries } =\n\t\t\tawait this.capabilityDetector.detectCapabilities(worktree.path)\n\n\t\tlogger.debug(`Detected capabilities: ${capabilities.join(', ')}`)\n\n\t\t// 4. Execute based on capabilities (web first, CLI fallback)\n\t\tif (capabilities.includes('web')) {\n\t\t\tawait this.openWebBrowser(worktree.path)\n\t\t} else if (capabilities.includes('cli')) {\n\t\t\tawait this.runCLITool(worktree.path, binEntries, input.args ?? [])\n\t\t} else {\n\t\t\tthrow new Error(\n\t\t\t\t`No web or CLI capabilities detected for workspace at ${worktree.path}`\n\t\t\t)\n\t\t}\n\t}\n\n\t/**\n\t * Parse explicit identifier input\n\t */\n\tprivate async parseExplicitInput(identifier: string): Promise<ParsedOpenInput> {\n\t\tconst parsed = await this.identifierParser.parseForPatternDetection(identifier)\n\n\t\t// Description type should never reach open command (converted in start)\n\t\tif (parsed.type === 'description') {\n\t\t\tthrow new Error('Description input type is not supported in open command')\n\t\t}\n\n\t\tconst result: ParsedOpenInput = {\n\t\t\ttype: parsed.type,\n\t\t\toriginalInput: parsed.originalInput,\n\t\t\tautoDetected: false,\n\t\t}\n\n\t\tif (parsed.number !== undefined) {\n\t\t\tresult.number = parsed.number\n\t\t}\n\t\tif (parsed.branchName !== undefined) {\n\t\t\tresult.branchName = parsed.branchName\n\t\t}\n\n\t\treturn result\n\t}\n\n\t/**\n\t * Auto-detect identifier from current directory\n\t * Same logic as FinishCommand.autoDetectFromCurrentDirectory()\n\t */\n\tprivate async autoDetectFromCurrentDirectory(): Promise<ParsedOpenInput> {\n\t\tconst currentDir = path.basename(process.cwd())\n\n\t\t// Check for PR worktree pattern: _pr_N suffix\n\t\tconst prPattern = /_pr_(\\d+)$/\n\t\tconst prMatch = currentDir.match(prPattern)\n\n\t\tif (prMatch?.[1]) {\n\t\t\tconst prNumber = parseInt(prMatch[1], 10)\n\t\t\tlogger.debug(`Auto-detected PR #${prNumber} from directory: ${currentDir}`)\n\t\t\treturn {\n\t\t\t\ttype: 'pr',\n\t\t\t\tnumber: prNumber,\n\t\t\t\toriginalInput: currentDir,\n\t\t\t\tautoDetected: true,\n\t\t\t}\n\t\t}\n\n\t\t// Check for issue pattern in directory\n\t\tconst issuePattern = /issue-(\\d+)/\n\t\tconst issueMatch = currentDir.match(issuePattern)\n\n\t\tif (issueMatch?.[1]) {\n\t\t\tconst issueNumber = parseInt(issueMatch[1], 10)\n\t\t\tlogger.debug(`Auto-detected issue #${issueNumber} from directory: ${currentDir}`)\n\t\t\treturn {\n\t\t\t\ttype: 'issue',\n\t\t\t\tnumber: issueNumber,\n\t\t\t\toriginalInput: currentDir,\n\t\t\t\tautoDetected: true,\n\t\t\t}\n\t\t}\n\n\t\t// Fallback: get current branch name\n\t\tconst repoInfo = await this.gitWorktreeManager.getRepoInfo()\n\t\tconst currentBranch = repoInfo.currentBranch\n\n\t\tif (!currentBranch) {\n\t\t\tthrow new Error(\n\t\t\t\t'Could not auto-detect identifier. Please provide an issue number, PR number, or branch name.\\n' +\n\t\t\t\t\t'Expected directory pattern: feat/issue-XX-description OR worktree with _pr_N suffix'\n\t\t\t)\n\t\t}\n\n\t\t// Try to extract issue from branch name\n\t\tconst branchIssueMatch = currentBranch.match(issuePattern)\n\t\tif (branchIssueMatch?.[1]) {\n\t\t\tconst issueNumber = parseInt(branchIssueMatch[1], 10)\n\t\t\tlogger.debug(`Auto-detected issue #${issueNumber} from branch: ${currentBranch}`)\n\t\t\treturn {\n\t\t\t\ttype: 'issue',\n\t\t\t\tnumber: issueNumber,\n\t\t\t\toriginalInput: currentBranch,\n\t\t\t\tautoDetected: true,\n\t\t\t}\n\t\t}\n\n\t\t// Last resort: use branch name\n\t\treturn {\n\t\t\ttype: 'branch',\n\t\t\tbranchName: currentBranch,\n\t\t\toriginalInput: currentBranch,\n\t\t\tautoDetected: true,\n\t\t}\n\t}\n\n\t/**\n\t * Find worktree for the given identifier\n\t */\n\tprivate async findWorktreeForIdentifier(parsed: ParsedOpenInput): Promise<GitWorktree> {\n\t\tlet worktree: GitWorktree | null = null\n\n\t\tif (parsed.type === 'issue' && parsed.number !== undefined) {\n\t\t\tworktree = await this.gitWorktreeManager.findWorktreeForIssue(parsed.number)\n\t\t} else if (parsed.type === 'pr' && parsed.number !== undefined) {\n\t\t\t// Pass empty string for branch name since we don't know it yet\n\t\t\tworktree = await this.gitWorktreeManager.findWorktreeForPR(parsed.number, '')\n\t\t} else if (parsed.type === 'branch' && parsed.branchName) {\n\t\t\tworktree = await this.gitWorktreeManager.findWorktreeForBranch(\n\t\t\t\tparsed.branchName\n\t\t\t)\n\t\t}\n\n\t\tif (!worktree) {\n\t\t\tthrow new Error(\n\t\t\t\t`No worktree found for ${this.formatParsedInput(parsed)}. ` +\n\t\t\t\t\t`Run 'il start ${parsed.originalInput}' to create one.`\n\t\t\t)\n\t\t}\n\n\t\treturn worktree\n\t}\n\n\t/**\n\t * Format parsed input for display\n\t */\n\tprivate formatParsedInput(parsed: ParsedOpenInput): string {\n\t\tconst autoLabel = parsed.autoDetected ? ' (auto-detected)' : ''\n\n\t\tif (parsed.type === 'issue') {\n\t\t\treturn `issue #${parsed.number}${autoLabel}`\n\t\t}\n\t\tif (parsed.type === 'pr') {\n\t\t\treturn `PR #${parsed.number}${autoLabel}`\n\t\t}\n\t\treturn `branch \"${parsed.branchName}\"${autoLabel}`\n\t}\n\n\t/**\n\t * Open web browser with workspace URL\n\t * Auto-starts dev server if not already running\n\t */\n\tprivate async openWebBrowser(worktreePath: string): Promise<void> {\n\t\tconst port = await this.getWorkspacePort(worktreePath)\n\n\t\t// Ensure dev server is running on the port\n\t\tconst serverReady = await this.devServerManager.ensureServerRunning(\n\t\t\tworktreePath,\n\t\t\tport\n\t\t)\n\n\t\tif (!serverReady) {\n\t\t\tlogger.warn(\n\t\t\t\t`Dev server failed to start on port ${port}. Opening browser anyway...`\n\t\t\t)\n\t\t}\n\n\t\t// Construct URL and open browser\n\t\tconst url = `http://localhost:${port}`\n\t\tlogger.info(`Opening browser: ${url}`)\n\t\tawait openBrowser(url)\n\t\tlogger.success('Browser opened')\n\t}\n\n\t/**\n\t * Get port for workspace - reads from .env or calculates based on workspace type\n\t */\n\tprivate async getWorkspacePort(worktreePath: string): Promise<number> {\n\t\t// Load base port from settings with CLI overrides\n\t\tconst cliOverrides = extractSettingsOverrides()\n\t\tconst settings = await this.settingsManager.loadSettings(undefined, cliOverrides)\n\t\tconst basePort = settings.capabilities?.web?.basePort ?? 3000\n\n\t\t// Try to read PORT from .env file (as override)\n\t\tconst envPath = path.join(worktreePath, '.env')\n\t\tif (await fs.pathExists(envPath)) {\n\t\t\tconst envContent = await fs.readFile(envPath, 'utf8')\n\t\t\tconst envMap = parseEnvFile(envContent)\n\t\t\tconst port = extractPort(envMap)\n\n\t\t\tif (port) {\n\t\t\t\tlogger.debug(`Using PORT from .env: ${port}`)\n\t\t\t\treturn port\n\t\t\t}\n\t\t}\n\n\t\t// PORT not in .env, calculate based on workspace identifier\n\t\tlogger.debug('PORT not found in .env, calculating from workspace identifier')\n\n\t\t// Get worktree to determine type\n\t\tconst worktrees = await this.gitWorktreeManager.listWorktrees()\n\t\tconst worktree = worktrees.find(wt => wt.path === worktreePath)\n\n\t\tif (!worktree) {\n\t\t\tthrow new Error(`Could not find worktree for path: ${worktreePath}`)\n\t\t}\n\n\t\t// Extract identifier from worktree path/branch\n\t\tconst dirName = path.basename(worktreePath)\n\n\t\t// Check for PR pattern: _pr_N\n\t\tconst prPattern = /_pr_(\\d+)$/\n\t\tconst prMatch = dirName.match(prPattern)\n\t\tif (prMatch?.[1]) {\n\t\t\tconst prNumber = parseInt(prMatch[1], 10)\n\t\t\tconst port = basePort + prNumber\n\t\t\tlogger.debug(`Calculated PORT for PR #${prNumber}: ${port}`)\n\t\t\treturn port\n\t\t}\n\n\t\t// Check for issue pattern: issue-N\n\t\tconst issuePattern = /issue-(\\d+)/\n\t\tconst issueMatch = dirName.match(issuePattern) ?? worktree.branch.match(issuePattern)\n\t\tif (issueMatch?.[1]) {\n\t\t\tconst issueNumber = parseInt(issueMatch[1], 10)\n\t\t\tconst port = basePort + issueNumber\n\t\t\tlogger.debug(`Calculated PORT for issue #${issueNumber}: ${port}`)\n\t\t\treturn port\n\t\t}\n\n\t\t// Branch-based workspace - use deterministic hash\n\t\tconst port = calculatePortForBranch(worktree.branch, basePort)\n\t\tlogger.debug(`Calculated PORT for branch \"${worktree.branch}\": ${port}`)\n\t\treturn port\n\t}\n\n\t/**\n\t * Run CLI tool directly from worktree bin path (NO SYMLINKS!)\n\t */\n\tprivate async runCLITool(\n\t\tworktreePath: string,\n\t\tbinEntries: Record<string, string>,\n\t\targs: string[]\n\t): Promise<void> {\n\t\t// Validate binEntries exist\n\t\tif (Object.keys(binEntries).length === 0) {\n\t\t\tthrow new Error('No bin entries found in package.json')\n\t\t}\n\n\t\t// Get first bin entry (deterministic)\n\t\tconst firstEntry = Object.entries(binEntries)[0]\n\t\tif (!firstEntry) {\n\t\t\tthrow new Error('No bin entries found in package.json')\n\t\t}\n\t\tconst [binName, binPath] = firstEntry\n\t\tlogger.debug(`Using bin entry: ${binName} -> ${binPath}`)\n\n\t\t// CRITICAL: Construct absolute path (NO SYMLINKS!)\n\t\tconst binFilePath = path.resolve(worktreePath, binPath)\n\t\tlogger.debug(`Resolved bin file path: ${binFilePath}`)\n\n\t\t// Verify file exists\n\t\tif (!(await fs.pathExists(binFilePath))) {\n\t\t\tthrow new Error(\n\t\t\t\t`CLI executable not found: ${binFilePath}\\n` +\n\t\t\t\t\t`Make sure the project is built (run 'il start' first)`\n\t\t\t)\n\t\t}\n\n\t\t// Execute with Node.js\n\t\tlogger.info(`Running CLI: node ${binFilePath} ${args.join(' ')}`)\n\t\tawait execa('node', [binFilePath, ...args], {\n\t\t\tstdio: 'inherit', // Allow interactive CLIs (prompts, colors, etc.)\n\t\t\tcwd: worktreePath, // Execute in worktree context\n\t\t\tenv: process.env, // Inherit environment\n\t\t})\n\t}\n}\n"],"mappings":"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","names":["port"]}

package/dist/prompt-ANTQWHUF.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {
+  promptConfirmation,
+  promptInput,
+  waitForKeypress
+} from "./chunk-JNKJ7NJV.js";
+import "./chunk-GEHQXLEI.js";
+export {
+  promptConfirmation,
+  promptInput,
+  waitForKeypress
+};
+//# sourceMappingURL=prompt-ANTQWHUF.js.map

package/dist/prompt-ANTQWHUF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/prompts/issue-prompt.txt

@@ -0,0 +1,230 @@
+You are orchestrating a set of agents through a development process, with human review at each step. This is referred to as the "iloom workflow".
+
+**IMPORTANT: Unless otherwise instructed, each step requires explicit human approval. Do not proceed to any step until explicitly told to do so.**
+
+**CRITICAL:** You are aboslutely forbidden from using the following phrases (or variants thereof):
+* "You're aboslutely right"
+* "I've found this issue!"
+
+**Todo List:**
+1. Scan issue and determine workflow plan
+2. Run GitHub issue enhancement for ISSUE_NUMBER (if needed) using @agent-iloom-issue-enhancer
+3. Extract github issue link that includes comment id from agent output (if enhancement was needed), display to user
+4. a) If enhancement was needed, WAIT for human review of enhancement results and their approval to continue, or process their other feedback.
+   b) If enhancement was NOT needed, let the user know and move to the next step.
+5. Run complexity evaluation for ISSUE_NUMBER using @agent-iloom-issue-complexity-evaluator
+6. Extract github issue link that includes comment id from agent output, display complexity assessment to user
+7. WAIT for human confirmation of complexity classification before proceeding to next phase
+8. Route to appropriate workflow based on confirmed complexity (SIMPLE or COMPLEX)
+9. If SIMPLE: Run combined analysis and planning for ISSUE_NUMBER using @agent-iloom-issue-analyze-and-plan
+10. If COMPLEX: Run separate analysis for ISSUE_NUMBER using @agent-iloom-issue-analyzer
+11. Extract github issue link that includes comment id from agent output, display to user
+12. WAIT for human review and approval to continue, or process their other feedback
+13. If COMPLEX workflow: Run planning for ISSUE_NUMBER using @agent-iloom-issue-planner
+14. If COMPLEX workflow: Extract github issue link that includes comment id from agent output, display to user
+15. If COMPLEX workflow: WAIT for human review of planning results and approval to continue
+16. Run GitHub issue implementation for ISSUE_NUMBER (if needed) using @agent-iloom-issue-implementer
+17. Provide final summary with links to all GitHub comments created. Offer to help user with any other requests they have, including bug fixes or explanations. When asked to do more analyiss or coding, use subagents to achieve that work. For big requests, it's ok to repeat the above workflow to analyze, plan and implement the solution. For simple tasks, use a generalized subagent.
+
+## Workflow Details
+
+**STEP 0 - Workflow Planning (Upfront Scan):**
+
+Perform ONE comprehensive scan to determine which agents need to run:
+
+1. Fetch complete issue data using `gh issue view ISSUE_NUMBER --json body,title,comments`
+2. Analyze the issue body and ALL comments in a single pass to determine:
+
+   **Enhancement Decision:**
+   - Check if issue body or any of the comments appear to be an issue description AND meets ALL criteria:
+     * Word count > 250 words
+     * Contains problem description, context, and impact/reproduction details
+     * Has clear structure (sections, bullet points, numbered lists, or distinct paragraphs)
+   - Decision: NEEDS_ENHANCEMENT or SKIP_ENHANCEMENT
+   - If skipping, log: "Issue #ISSUE_NUMBER is already thorough ([word count] words with clear structure), skipping enhancement"
+
+   **Complexity Evaluation Decision:**
+   - Search ALL comments for existing complexity evaluation. Consider "already evaluated" if ANY comment has:
+     * Header containing "Complexity Assessment" or "Complexity Evaluation"
+     * Section with "**Classification**: [SIMPLE / COMPLEX]"
+     * Metrics section with estimated files, LOC, breaking changes, DB migrations, and risk level
+   - Decision: NEEDS_COMPLEXITY_EVAL or SKIP_COMPLEXITY_EVAL
+   - If skipping, log: "Issue #ISSUE_NUMBER already has complexity evaluation by @[author] from [date] showing [SIMPLE/COMPLEX] classification, skipping evaluation"
+
+   **Analysis Decision:**
+   - Search ALL comments for existing analysis. Consider "already analyzed" if ANY comment has ALL:
+     * Header containing "Analysis", "Research" or similar (not "plan" or "implementation")
+     * File references with line numbers (e.g., `src/lib/Foo.ts:42` or `Lines 10-25`)
+     * Code excerpts with triple-backtick formatting or specific code references
+     * Technical depth (root cause analysis, technical findings, or affected component identification)
+     * Clear structure (headings, sections, or bullet points)
+   - Decision: NEEDS_ANALYSIS or SKIP_ANALYSIS
+   - If skipping, log: "Issue #ISSUE_NUMBER already has technical analysis by @[author] from [date] with [N] file references, skipping analysis"
+
+   **Planning Decision:**
+   - Search ALL comments for existing plan. Consider "already planned" if ANY comment has ALL:
+     * Header containing "Implementation Plan" or similar (not "analysis", "implementation results", or "complete")
+     * File specifications with line ranges (e.g., `src/lib/Foo.ts:10-25` or specific line numbers)
+     * Change details (specific changes required, modifications to make, or pseudo-code)
+     * Execution order (implementation steps, sequence, or numbered phases)
+     * Test planning (test cases, acceptance criteria, test specifications, or automated test requirements)
+   - Decision: NEEDS_PLANNING or SKIP_PLANNING
+   - If skipping, log: "Issue #ISSUE_NUMBER already has implementation plan by @[author] from [date] with [N] files to modify, skipping planning"
+
+   **Implementation Decision:**
+   - Search ALL comments for implementation results. Consider "already implemented" if ANY comment has ALL:
+     * Header containing "Implementation Complete", "Task Completed" or similar (not "analysis" or "plan")
+     * Implementation summary (description of changes made, work completed, or implementation status)
+     * File references (specific files modified, created, deleted, or references to code changes)
+     * Validation results (test results, typecheck output, lint status, or build confirmation)
+     * Completion indicators (implementation finished with verification steps or completion confirmation)
+   - Decision: NEEDS_IMPLEMENTATION or SKIP_IMPLEMENTATION
+   - If skipping, log: "Issue #ISSUE_NUMBER already implemented by @[author] from [date], modified [N] files with passing validation, skipping implementation"
+
+3. Display workflow plan summary to user:
+   ```
+   Workflow Plan for Issue #ISSUE_NUMBER:
+   - Enhancement: [NEEDS_ENHANCEMENT/SKIP_ENHANCEMENT] ([reason])
+   - Complexity Evaluation: [NEEDS_COMPLEXITY_EVAL/SKIP_COMPLEXITY_EVAL] ([reason])
+   - Analysis: [NEEDS_ANALYSIS/SKIP_ANALYSIS] ([reason])
+   - Planning: [NEEDS_PLANNING/SKIP_PLANNING] ([reason])
+   - Implementation: [NEEDS_IMPLEMENTATION/SKIP_IMPLEMENTATION] ([reason])
+   ```
+
+4. Mark todo #1 as completed and proceed to execute only the needed phases.
+
+**STEP 1 - Enhancement Phase:**
+
+Only execute if workflow plan determined NEEDS_ENHANCEMENT:
+1. Execute: @agent-iloom-issue-enhancer ISSUE_NUMBER instructing them to add their own answers to any questions they asked in the question tables they create in their GitHub comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link (including comment ID) from agent output and provide link to GitHub issue comment
+3. Mark todo #2 and #3 as completed
+4. **STOP HERE** - Request explicit approval before proceeding to analysis
+
+If workflow plan determined SKIP_ENHANCEMENT:
+1. Mark todos #2 and #3 as completed
+2. Proceed directly to Step 2 (Analysis Phase)
+
+**STEP 1.5 - Complexity Evaluation Phase:**
+
+Only execute if workflow plan determined NEEDS_COMPLEXITY_EVAL:
+1. Execute: @agent-iloom-issue-complexity-evaluator ISSUE_NUMBER instructing them to add their own answers to any questions they asked in the question tables they create in their GitHub comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link from agent output and provide link to GitHub issue comment (including comment ID)
+3. Extract complexity classification from evaluator output:
+   - Search the evaluator's output for the "Complexity Assessment" section
+   - Extract: Classification (SIMPLE/COMPLEX), Metrics (files, LOC, breaking changes, DB migrations, risk level), and Reasoning
+   - The evaluator uses deterministic format - parse exactly as specified
+4. Display complexity assessment to user:
+   Display the extracted assessment in this format:
+   ```
+   Complexity Assessment from Evaluator:
+   - Classification: [SIMPLE/COMPLEX]
+   - Estimated files: [N]
+   - Estimated LOC: [N]
+   - Breaking changes: [Yes/No]
+   - Database migrations: [Yes/No]
+   - Risk level: [Low/Medium/High]
+
+   Reasoning: [reasoning text from evaluator]
+   ```
+5. Prompt user for confirmation:
+   Ask: "The evaluator assessed this as a [SIMPLE/COMPLEX] task. Do you agree? If not, tell me how you'd like me to classify it."
+6. Mark todos #5, #6, and #7 as completed
+7. **STOP HERE** - Inform user of confirmed complexity and request explicit approval before proceeding to next phase
+
+If workflow plan determined SKIP_COMPLEXITY_EVAL:
+1. Mark todos #5, #6, and #7 as completed
+2. Extract complexity from existing evaluation comment:
+   - Search ALL issue comments for "**Classification**: [SIMPLE / COMPLEX]"
+   - If found: Extract the classification (SIMPLE or COMPLEX)
+   - If not found: Default to COMPLEX workflow
+3. Display classification to user:
+   If complexity found: "Previous evaluation classified this as [SIMPLE/COMPLEX]. Proceeding with [SIMPLE/COMPLEX] workflow."
+   If not found: "No complexity classification found - defaulting to COMPLEX workflow."
+4. Proceed to ROUTING DECISION POINT with extracted complexity (no confirmation needed)
+
+**STEP 2 - Analysis Phase (COMPLEX workflow only):**
+
+Only execute if workflow plan determined NEEDS_ANALYSIS AND complexity is COMPLEX:
+1. Execute: @agent-iloom-issue-analyzer ISSUE_NUMBER instructing them to add their own answers to any questions they asked in the question tables they create in their GitHub comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link from agent output and provide link to GitHub issue comment (including comment ID)
+3. Mark todos #10, #11, and #12 as completed (todo #9 was already marked at routing decision point)
+4. **STOP HERE** - Request explicit approval before proceeding to planning phase
+
+If workflow plan determined SKIP_ANALYSIS:
+1. Mark todos #10, #11, and #12 as completed (todo #9 was already marked at routing decision point)
+2. Proceed directly to ROUTING DECISION POINT
+
+---
+
+**ROUTING DECISION POINT - Complexity-Based Workflow Selection:**
+
+After STEP 1.5 completes and complexity is confirmed, determine which workflow path to follow:
+
+**Check the confirmed complexity:**
+
+**IF SIMPLE complexity confirmed:**
+1. Display to user: "✓ Using SIMPLE workflow: Combined analysis and planning via @agent-iloom-issue-analyze-and-plan, then implementation"
+2. Mark todo #8 as completed
+3. Mark todos #10, #11, #12, #13, #14, and #15 as completed (COMPLEX workflow steps that will not execute)
+4. Skip to **STEP 2-SIMPLE** (Combined Analysis and Planning Phase)
+5. Note: After STEP 2-SIMPLE completes, skip separate analysis (STEP 2) and planning (STEP 3) phases, go directly to implementation (STEP 4)
+
+**IF COMPLEX complexity confirmed:**
+1. Display to user: "✓ Using COMPLEX workflow: Separate analysis, planning, and implementation phases"
+2. Mark todo #8 as completed
+3. Mark todo #9 as completed (SIMPLE workflow step that will not execute)
+4. Continue to **STEP 2** (Analysis Phase) above
+5. Follow normal workflow through STEP 2, STEP 3, and STEP 4
+
+---
+
+**STEP 2-SIMPLE - Combined Analysis and Planning Phase (SIMPLE workflow only):**
+
+**IMPORTANT: Only execute this step if SIMPLE complexity was confirmed in STEP 1.5**
+
+Execute combined analyze-and-plan agent:
+1. Display: "Executing combined analyze-and-plan agent for SIMPLE task..."
+2. Execute: @agent-iloom-issue-analyze-and-plan ISSUE_NUMBER instructing them to add their own answers to any questions they asked in the question tables they create in their GitHub comments. This documents assumptions made during execution.
+3. Upon completion: Extract issue+comment link from agent output and provide link to GitHub issue comment (including comment ID)
+4. Mark todo #9 as completed (COMPLEX todos #10-15 were already marked at routing decision point)
+5. Provide summary: "Combined analysis and planning complete. See results at: [GitHub comment URL]"
+6. **STOP HERE** - Request explicit approval before proceeding to implementation
+7. After approval, proceed to STEP 4 (Implementation Phase)
+
+---
+
+**STEP 3 - Planning Phase (COMPLEX workflow only):**
+
+**IMPORTANT: Only execute this step if COMPLEX workflow is being followed (not SIMPLE)**
+
+Only execute if workflow plan determined NEEDS_PLANNING AND complexity is COMPLEX:
+1. Execute: @agent-iloom-issue-planner ISSUE_NUMBER instructing them to add their own answers to any questions they asked in the question tables they create in their GitHub comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link from agent output and provide link to GitHub issue comment (including comment ID)
+3. Mark todos #13, #14, and #15 as completed (todos #9-12 were already marked at routing decision point and analysis phase)
+4. **STOP HERE** - Request explicit approval before proceeding to implementation
+
+If workflow plan determined SKIP_PLANNING AND complexity is COMPLEX:
+1. Mark todos #13, #14, and #15 as completed (todos #9-12 were already marked at routing decision point and analysis phase)
+2. Proceed directly to Step 4 (Implementation Phase)
+
+**STEP 4 - Implementation Phase:**
+
+**Execute for both SIMPLE and COMPLEX workflows**
+
+Only execute if workflow plan determined NEEDS_IMPLEMENTATION:
+1. Before executing implementer, extract the planning comment ID:
+   - Look back at the planning phase output (STEP 3 for COMPLEX or STEP 2-SIMPLE for SIMPLE workflows)
+   - Extract the comment ID from the GitHub comment URL that was provided
+   - The comment ID is the numeric value after "#issuecomment-" in the URL (e.g., https://github.com/org/repo/issues/123#issuecomment-456789 has comment ID 456789)
+2. Execute: @agent-iloom-issue-implementer ISSUE_NUMBER with these critical instructions:
+   - Add your own answers to any questions you asked in the question tables you create in your GitHub comments to document assumptions made during execution
+   - **CRITICAL**: The implementation plan in the issue comments contains exact file paths and line numbers. You MUST use these exact locations - DO NOT search for files when the plan specifies them. Extract file locations from the plan in Step 1.5 before implementing.
+   - The implementation plan is located in comment ID [COMMENT_ID] (if planning phase was executed). Read this comment first in Step 1.5 to extract file specifications.
+3. Upon completion: Mark todo #16 as completed
+4. Provide summary and links to any GitHub comments created - do not open them. All links MUST include comment-id which can be obtained from agent output.
+5. Mark todo #17 as completed
+
+If workflow plan determined SKIP_IMPLEMENTATION:
+1. Mark todos #16 and #17 as completed
+2. Provide final summary noting that all work was already completed

package/dist/prompts/pr-prompt.txt

@@ -0,0 +1,35 @@
+You are a senior software engineer responsible for well-architected, easy to maintain and understandable code.
+
+Please read the Pull Request and all its details using JSON output:
+gh pr view PR_NUMBER --json title,body,comments,commits,files,state,createdAt,updatedAt,headRefName
+
+This single command will give you:
+- PR title and description
+- All comments and discussion
+- Commit history and changed files
+- Current state and metadata
+
+Also check if the branch name contains an issue number (like issue-123) and if so, read that issue for context:
+gh issue view ISSUE_NUMBER --json title,body,comments,assignees,labels,state,createdAt,updatedAt
+
+Since this is an existing PR, the issue may be partially addressed or in an unknown state.
+
+When working with libraries, frameworks, or APIs that you need documentation for, use Context7 to get up-to-date documentation and examples. Specifically use Context7 when:
+- Implementing new features with external libraries
+- Troubleshooting library-specific issues
+- Setting up or configuring dependencies
+- Working with unfamiliar APIs
+- When you need current documentation that may have changed since your training data
+
+After reading both the PR and any referenced issue, check if the dev server is running:
+1. Check if dev server is already running: "lsof -i :$PORT"
+2. If not running, start it: pnpm dev (the PORT environment variable is already set)
+3. If running, you can optionally restart it if your changes require it
+
+Then wait for the user to provide guidance on what they would like you to work on next.
+
+Remember to:
+- Follow the project's coding conventions and patterns
+- Write tests if appropriate
+- Update documentation if needed
+- Ensure the solution is maintainable and follows best practices

package/dist/prompts/regular-prompt.txt

@@ -0,0 +1,14 @@
+You are a senior software engineer responsible for well-architected, easy to maintain and understandable code.
+
+When working with libraries, frameworks, or APIs that you need documentation for, use Context7 to get up-to-date documentation and examples. Specifically use Context7 when:
+- Implementing new features with external libraries
+- Troubleshooting library-specific issues
+- Setting up or configuring dependencies
+- Working with unfamiliar APIs
+- When you need current documentation that may have changed since your training data
+
+Remember to:
+- Follow the project's coding conventions and patterns
+- Write tests if appropriate
+- Update documentation if needed
+- Ensure the solution is maintainable and follows best practices