@iloom/cli 0.1.14

package/dist/run-2JCPQAX3.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/run.ts
+import path from "path";
+import fs from "fs-extra";
+import { execa } from "execa";
+var RunCommand = 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("cli")) {
+      await this.runCLITool(worktree.path, binEntries, input.args ?? []);
+    } else if (capabilities.includes("web")) {
+      await this.openWebBrowser(worktree.path);
+    } else {
+      throw new Error(
+        `No CLI or web 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 run 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}`;
+  }
+  /**
+   * 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
+    });
+  }
+  /**
+   * 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;
+  }
+};
+export {
+  RunCommand
+};
+//# sourceMappingURL=run-2JCPQAX3.js.map

package/dist/run-2JCPQAX3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/run.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 RunCommandInput {\n\tidentifier?: string\n\targs?: string[]\n}\n\ninterface ParsedRunInput {\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 * RunCommand - Runs CLI tool or opens workspace in browser\n * Priority: CLI first, Web fallback\n */\nexport class RunCommand {\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: RunCommandInput): 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 (CLI first, web fallback)\n\t\tif (capabilities.includes('cli')) {\n\t\t\tawait this.runCLITool(worktree.path, binEntries, input.args ?? [])\n\t\t} else if (capabilities.includes('web')) {\n\t\t\tawait this.openWebBrowser(worktree.path)\n\t\t} else {\n\t\t\tthrow new Error(\n\t\t\t\t`No CLI or web 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<ParsedRunInput> {\n\t\tconst parsed = await this.identifierParser.parseForPatternDetection(identifier)\n\n\t\t// Description type should never reach run command (converted in start)\n\t\tif (parsed.type === 'description') {\n\t\t\tthrow new Error('Description input type is not supported in run command')\n\t\t}\n\n\t\tconst result: ParsedRunInput = {\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<ParsedRunInput> {\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: ParsedRunInput): 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: ParsedRunInput): 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 * 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\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"],"mappings":"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","names":["port"]}

package/dist/schema/settings.schema.json

@@ -0,0 +1,221 @@
+{
+  "$ref": "#/definitions/IloomSettings",
+  "definitions": {
+    "IloomSettings": {
+      "type": "object",
+      "properties": {
+        "mainBranch": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Name of the main/primary branch for the repository"
+        },
+        "worktreePrefix": {
+          "type": "string",
+          "description": "Prefix for worktree directories. Empty string disables prefix. Defaults to <repo-name>-looms if not set."
+        },
+        "protectedBranches": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "List of branches that cannot be deleted (defaults to [mainBranch, \"main\", \"master\", \"develop\"])"
+        },
+        "workflows": {
+          "type": "object",
+          "properties": {
+            "issue": {
+              "type": "object",
+              "properties": {
+                "permissionMode": {
+                  "type": "string",
+                  "enum": [
+                    "plan",
+                    "acceptEdits",
+                    "bypassPermissions",
+                    "default"
+                  ],
+                  "description": "Permission mode for Claude CLI in this workflow type"
+                },
+                "noVerify": {
+                  "type": "boolean",
+                  "description": "Skip pre-commit hooks (--no-verify) when committing during finish workflow"
+                },
+                "startIde": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch IDE (code) when starting this workflow type"
+                },
+                "startDevServer": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch development server when starting this workflow type"
+                },
+                "startAiAgent": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch Claude AI agent when starting this workflow type"
+                },
+                "startTerminal": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Launch terminal window without dev server when starting this workflow type"
+                }
+              },
+              "additionalProperties": false
+            },
+            "pr": {
+              "type": "object",
+              "properties": {
+                "permissionMode": {
+                  "type": "string",
+                  "enum": [
+                    "plan",
+                    "acceptEdits",
+                    "bypassPermissions",
+                    "default"
+                  ],
+                  "description": "Permission mode for Claude CLI in this workflow type"
+                },
+                "noVerify": {
+                  "type": "boolean",
+                  "description": "Skip pre-commit hooks (--no-verify) when committing during finish workflow"
+                },
+                "startIde": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch IDE (code) when starting this workflow type"
+                },
+                "startDevServer": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch development server when starting this workflow type"
+                },
+                "startAiAgent": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch Claude AI agent when starting this workflow type"
+                },
+                "startTerminal": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Launch terminal window without dev server when starting this workflow type"
+                }
+              },
+              "additionalProperties": false
+            },
+            "regular": {
+              "type": "object",
+              "properties": {
+                "permissionMode": {
+                  "type": "string",
+                  "enum": [
+                    "plan",
+                    "acceptEdits",
+                    "bypassPermissions",
+                    "default"
+                  ],
+                  "description": "Permission mode for Claude CLI in this workflow type"
+                },
+                "noVerify": {
+                  "type": "boolean",
+                  "description": "Skip pre-commit hooks (--no-verify) when committing during finish workflow"
+                },
+                "startIde": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch IDE (code) when starting this workflow type"
+                },
+                "startDevServer": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch development server when starting this workflow type"
+                },
+                "startAiAgent": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Launch Claude AI agent when starting this workflow type"
+                },
+                "startTerminal": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Launch terminal window without dev server when starting this workflow type"
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false,
+          "description": "Per-workflow-type permission configurations"
+        },
+        "agents": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "not": {}
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "object",
+                    "properties": {
+                      "model": {
+                        "type": "string",
+                        "enum": [
+                          "sonnet",
+                          "opus",
+                          "haiku"
+                        ],
+                        "description": "Claude model shorthand: sonnet, opus, or haiku"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                }
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Per-agent configuration overrides"
+        },
+        "capabilities": {
+          "type": "object",
+          "properties": {
+            "web": {
+              "type": "object",
+              "properties": {
+                "basePort": {
+                  "type": "number",
+                  "minimum": 1,
+                  "maximum": 65535,
+                  "description": "Base port for web workspace port calculations (default: 3000)"
+                }
+              },
+              "additionalProperties": false
+            },
+            "database": {
+              "type": "object",
+              "properties": {
+                "databaseUrlEnvVarName": {
+                  "type": "string",
+                  "minLength": 1,
+                  "pattern": "^[A-Z_][A-Z0-9_]*$",
+                  "default": "DATABASE_URL",
+                  "description": "Name of environment variable for database connection URL"
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false,
+          "description": "Project capability configurations"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}