@iloom/cli 0.2.0 → 0.3.1

package/dist/prompts/issue-prompt.txt

@@ -35,7 +35,7 @@ iloom is a CLI tool for scaling a human's understanding of the AI's work, as the
 4. **Planning** - Creates implementation roadmap with file specifications
 5. **Implementation** - Executes the plan with validation
 
-Each phase creates GitHub comments for team visibility and traceability.
+Each phase creates issue comments for team visibility and traceability.
 
 ### Key iloom Commands
 - `iloom init` / `iloom config` - Interactive configuration wizard
@@ -114,23 +114,23 @@ You are orchestrating a set of agents through a development process, with human
 
 **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
+2. Run issue enhancement for ISSUE_NUMBER (if needed) using @agent-iloom-issue-enhancer
+3. Extract 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
+6. Extract 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
+11. Extract 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
+14. If COMPLEX workflow: Extract 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.
+16. Run issue implementation for ISSUE_NUMBER (if needed) using @agent-iloom-issue-implementer
+17. Provide final summary with links to all issue 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
 
@@ -138,7 +138,7 @@ You are orchestrating a set of agents through a development process, with human
 
 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`
+1. Fetch complete issue data using the MCP tool `mcp__issue_management__get_issue` with `{ number: "ISSUE_NUMBER", includeComments: true }`
 2. Analyze the issue body and ALL comments in a single pass to determine:
 
    **Enhancement Decision:**
@@ -202,11 +202,11 @@ Perform ONE comprehensive scan to determine which agents need to run:
 **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
+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 issue comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link (including comment ID) from agent output and provide link to issue comment
 3. Mark todo #2 and #3 as completed
 4. Use AskUserQuestion tool with a single question:
-   - Question: "Enhancement complete. See results at: [GitHub comment URL]. How would you like to proceed?"
+   - Question: "Enhancement complete. See results at: [issue comment URL]. How would you like to proceed?"
    - Options:
      - "Continue to complexity evaluation" (default)
      - "Provide feedback on enhancement"
@@ -223,8 +223,8 @@ If workflow plan determined SKIP_ENHANCEMENT:
 **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)
+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 issue comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link from agent output and provide link to 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
@@ -243,7 +243,7 @@ Only execute if workflow plan determined NEEDS_COMPLEXITY_EVAL:
    Reasoning: [reasoning text from evaluator]
    ```
 5. Use AskUserQuestion tool with a single question:
-   - Question: "Complexity evaluated as [SIMPLE/COMPLEX]. See assessment at: [GitHub comment URL]. Do you agree with this classification?"
+   - Question: "Complexity evaluated as [SIMPLE/COMPLEX]. See assessment at: [issue comment URL]. Do you agree with this classification?"
    - Options:
      - "Yes, proceed with [SIMPLE/COMPLEX] workflow" (default)
      - "No, reclassify as SIMPLE"
@@ -271,11 +271,11 @@ If workflow plan determined SKIP_COMPLEXITY_EVAL:
 **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)
+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 issue comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link from agent output and provide link to issue comment (including comment ID)
 3. Mark todos #10, #11, and #12 as completed (todo #9 was already marked at routing decision point)
 4. Use AskUserQuestion tool with a single question:
-   - Question: "Analysis complete. See findings at: [GitHub comment URL]. How would you like to proceed?"
+   - Question: "Analysis complete. See findings at: [issue comment URL]. How would you like to proceed?"
    - Options:
      - "Continue to planning phase" (default)
      - "Provide feedback on analysis"
@@ -319,11 +319,11 @@ After STEP 1.5 completes and complexity is confirmed, determine which workflow p
 
 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)
+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 issue comments. This documents assumptions made during execution.
+3. Upon completion: Extract issue+comment link from agent output and provide link to issue comment (including comment ID)
 4. Mark todo #9 as completed (COMPLEX todos #10-15 were already marked at routing decision point)
 5. Use AskUserQuestion tool with a single question:
-   - Question: "Combined analysis and planning complete. See results at: [GitHub comment URL]. How would you like to proceed?"
+   - Question: "Combined analysis and planning complete. See results at: [issue comment URL]. How would you like to proceed?"
    - Options:
      - "Continue to implementation" (default)
      - "Provide feedback on plan"
@@ -340,11 +340,11 @@ Execute combined analyze-and-plan agent:
 **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)
+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 issue comments. This documents assumptions made during execution.
+2. Upon completion: Extract issue+comment link from agent output and provide link to 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. Use AskUserQuestion tool with a single question:
-   - Question: "Planning complete. See implementation plan at: [GitHub comment URL]. How would you like to proceed?"
+   - Question: "Planning complete. See implementation plan at: [issue comment URL]. How would you like to proceed?"
    - Options:
      - "Continue to implementation" (default)
      - "Provide feedback on plan"
@@ -365,14 +365,14 @@ If workflow plan determined SKIP_PLANNING AND complexity is COMPLEX:
 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
+   - Extract the comment ID from the issue 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
+   - Add your own answers to any questions you asked in the question tables you create in your issue 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.
+4. Provide summary and links to any issue 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:

package/dist/{rebase-DUNFOJVS.js → rebase-C4WNCVGM.js}

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 import {
   MergeManager
-} from "./chunk-4IV6W4U5.js";
-import "./chunk-MFU53H6J.js";
+} from "./chunk-IXKLYTWO.js";
 import {
   GitWorktreeManager
-} from "./chunk-VETG35MF.js";
+} from "./chunk-TSKY3JI7.js";
+import "./chunk-ZWFBBPJI.js";
 import {
   SettingsManager
-} from "./chunk-T3KEIB4D.js";
+} from "./chunk-O5OH5MRX.js";
 import {
   getRepoRoot,
   isValidGitRepo
-} from "./chunk-HBVFXN7R.js";
+} from "./chunk-4BGK7T6X.js";
 import {
   logger
 } from "./chunk-GEHQXLEI.js";
@@ -92,4 +92,4 @@ export {
   RebaseCommand,
   WorktreeValidationError
 };
-//# sourceMappingURL=rebase-DUNFOJVS.js.map
+//# sourceMappingURL=rebase-C4WNCVGM.js.map

package/dist/{remote-ZCXJVVNW.js → remote-VUNCQZ6J.js}

@@ -5,7 +5,8 @@ import {
   hasMultipleRemotes,
   parseGitRemotes,
   validateConfiguredRemote
-} from "./chunk-DJUGYNQE.js";
+} from "./chunk-PA6Q6AWM.js";
+import "./chunk-GEHQXLEI.js";
 export {
   getConfiguredRepoFromSettings,
   getEffectivePRTargetRemote,
@@ -13,4 +14,4 @@ export {
   parseGitRemotes,
   validateConfiguredRemote
 };
-//# sourceMappingURL=remote-ZCXJVVNW.js.map
+//# sourceMappingURL=remote-VUNCQZ6J.js.map

package/dist/remote-VUNCQZ6J.js.map

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

package/dist/{run-O7ZK7CKA.js → run-IOGNIOYN.js}

@@ -1,35 +1,36 @@
 #!/usr/bin/env node
 import {
   DevServerManager
-} from "./chunk-USVVV3FP.js";
+} from "./chunk-MKWYLDFK.js";
+import "./chunk-ZM3CFL5L.js";
 import {
-  IdentifierParser
-} from "./chunk-H4E4THUZ.js";
-import "./chunk-SPYPLHMK.js";
-import "./chunk-GZP4UGGM.js";
-import {
-  calculatePortForBranch,
+  IdentifierParser,
   extractPort,
   parseEnvFile
-} from "./chunk-ZMNQBJUI.js";
-import "./chunk-BLCTGFZN.js";
+} from "./chunk-IP7SMKIF.js";
 import {
-  extractSettingsOverrides
-} from "./chunk-GYCR2LOU.js";
-import {
-  ProjectCapabilityDetector
-} from "./chunk-CWR2SANQ.js";
-import "./chunk-2ZPFJQ3B.js";
+  calculatePortForBranch
+} from "./chunk-VU3QMIP2.js";
 import {
   openBrowser
 } from "./chunk-YETJNRQM.js";
 import {
   GitWorktreeManager
-} from "./chunk-VETG35MF.js";
+} from "./chunk-TSKY3JI7.js";
+import "./chunk-ZT3YZB4K.js";
+import {
+  ProjectCapabilityDetector
+} from "./chunk-EBISESAP.js";
+import "./chunk-2ZPFJQ3B.js";
+import {
+  extractSettingsOverrides
+} from "./chunk-GYCR2LOU.js";
 import {
   SettingsManager
-} from "./chunk-T3KEIB4D.js";
-import "./chunk-HBVFXN7R.js";
+} from "./chunk-O5OH5MRX.js";
+import {
+  extractIssueNumber
+} from "./chunk-4BGK7T6X.js";
 import {
   logger
 } from "./chunk-GEHQXLEI.js";
@@ -102,10 +103,8 @@ var RunCommand = class {
         autoDetected: true
       };
     }
-    const issuePattern = /issue-(\d+)/;
-    const issueMatch = currentDir.match(issuePattern);
-    if (issueMatch == null ? void 0 : issueMatch[1]) {
-      const issueNumber = parseInt(issueMatch[1], 10);
+    const issueNumber = extractIssueNumber(currentDir);
+    if (issueNumber !== null) {
       logger.debug(`Auto-detected issue #${issueNumber} from directory: ${currentDir}`);
       return {
         type: "issue",
@@ -121,13 +120,12 @@ var RunCommand = class {
         "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}`);
+    const branchIssueNumber = extractIssueNumber(currentBranch);
+    if (branchIssueNumber !== null) {
+      logger.debug(`Auto-detected issue #${branchIssueNumber} from branch: ${currentBranch}`);
       return {
         type: "issue",
-        number: issueNumber,
+        number: branchIssueNumber,
         originalInput: currentBranch,
         autoDetected: true
       };
@@ -147,7 +145,11 @@ var RunCommand = class {
     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, "");
+      const prNumber = typeof parsed.number === "number" ? parsed.number : Number(parsed.number);
+      if (isNaN(prNumber) || !isFinite(prNumber)) {
+        throw new Error(`Invalid PR number: ${parsed.number}. PR numbers must be numeric.`);
+      }
+      worktree = await this.gitWorktreeManager.findWorktreeForPR(prNumber, "");
     } else if (parsed.type === "branch" && parsed.branchName) {
       worktree = await this.gitWorktreeManager.findWorktreeForBranch(
         parsed.branchName
@@ -257,13 +259,14 @@ Make sure the project is built (run 'il start' first)`
       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 issueId = extractIssueNumber(dirName) ?? extractIssueNumber(worktree.branch);
+    if (issueId !== null) {
+      const issueNumber = parseInt(issueId, 10);
+      if (!isNaN(issueNumber)) {
+        const port2 = basePort + issueNumber;
+        logger.debug(`Calculated PORT for issue #${issueId}: ${port2}`);
+        return port2;
+      }
     }
     const port = calculatePortForBranch(worktree.branch, basePort);
     logger.debug(`Calculated PORT for branch "${worktree.branch}": ${port}`);
@@ -273,4 +276,4 @@ Make sure the project is built (run 'il start' first)`
 export {
   RunCommand
 };
-//# sourceMappingURL=run-O7ZK7CKA.js.map
+//# sourceMappingURL=run-IOGNIOYN.js.map

package/dist/run-IOGNIOYN.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 { extractIssueNumber } from '../utils/git.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?: string | 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 issueNumber = extractIssueNumber(currentDir)\n\n\t\tif (issueNumber !== null) {\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 branchIssueNumber = extractIssueNumber(currentBranch)\n\t\tif (branchIssueNumber !== null) {\n\t\t\tlogger.debug(`Auto-detected issue #${branchIssueNumber} from branch: ${currentBranch}`)\n\t\t\treturn {\n\t\t\t\ttype: 'issue',\n\t\t\t\tnumber: branchIssueNumber,\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// For PRs, ensure the number is numeric (PRs are always numeric per GitHub)\n\t\t\tconst prNumber = typeof parsed.number === 'number' ? parsed.number : Number(parsed.number)\n\t\t\tif (isNaN(prNumber) || !isFinite(prNumber)) {\n\t\t\t\tthrow new Error(`Invalid PR number: ${parsed.number}. PR numbers must be numeric.`)\n\t\t\t}\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(prNumber, '')\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 issueId = extractIssueNumber(dirName) ?? extractIssueNumber(worktree.branch)\n\t\tif (issueId !== null) {\n\t\t\tconst issueNumber = parseInt(issueId, 10)\n\t\t\tif (!isNaN(issueNumber)) {\n\t\t\t\tconst port = basePort + issueNumber\n\t\t\t\tlogger.debug(`Calculated PORT for issue #${issueId}: ${port}`)\n\t\t\t\treturn port\n\t\t\t}\n\t\t\t// For alphanumeric IDs, fall through to branch-based hash\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

@@ -9,6 +9,11 @@
           "minLength": 1,
           "description": "Name of the main/primary branch for the repository"
         },
+        "sourceEnvOnStart": {
+          "type": "boolean",
+          "default": false,
+          "description": "Source .env file when launching terminal processes (Claude, dev server, terminal). NOTE TO AI AGENTS: Before making changes to settings files, YOU MUST OFFER to check  .env compatibility. WARNING: Unquoted values in .env files may break sourcing in bash/zsh shells. Before enabling, verify your .env file does not contain unquoted special characters (e.g., database URLs with ?, &, or other shell metacharacters). Shell compatibility issues may cause processes to fail or behave unexpectedly."
+        },
         "worktreePrefix": {
           "type": "string",
           "description": "Prefix for worktree directories. Empty string disables prefix. Defaults to <repo-name>-looms if not set."
@@ -54,7 +59,7 @@
                 "startAiAgent": {
                   "type": "boolean",
                   "default": true,
-                  "description": "Launch Claude AI agent when starting this workflow type"
+                  "description": "Launch Claude Code agent when starting this workflow type"
                 },
                 "startTerminal": {
                   "type": "boolean",
@@ -94,7 +99,7 @@
                 "startAiAgent": {
                   "type": "boolean",
                   "default": true,
-                  "description": "Launch Claude AI agent when starting this workflow type"
+                  "description": "Launch Claude Code agent when starting this workflow type"
                 },
                 "startTerminal": {
                   "type": "boolean",
@@ -134,7 +139,7 @@
                 "startAiAgent": {
                   "type": "boolean",
                   "default": true,
-                  "description": "Launch Claude AI agent when starting this workflow type"
+                  "description": "Launch Claude Code agent when starting this workflow type"
                 },
                 "startTerminal": {
                   "type": "boolean",
@@ -245,6 +250,15 @@
         "issueManagement": {
           "type": "object",
           "properties": {
+            "provider": {
+              "type": "string",
+              "enum": [
+                "github",
+                "linear"
+              ],
+              "default": "github",
+              "description": "Issue tracker provider (github, linear)"
+            },
             "github": {
               "type": "object",
               "properties": {
@@ -258,6 +272,28 @@
                 "remote"
               ],
               "additionalProperties": false
+            },
+            "linear": {
+              "type": "object",
+              "properties": {
+                "teamId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Linear team identifier (e.g., \"ENG\", \"PLAT\")"
+                },
+                "branchFormat": {
+                  "type": "string",
+                  "description": "Branch naming template for Linear issues"
+                },
+                "apiToken": {
+                  "type": "string",
+                  "description": "Linear API token (lin_api_...). SECURITY: Store in settings.local.json only, never commit to source control."
+                }
+              },
+              "required": [
+                "teamId"
+              ],
+              "additionalProperties": false
             }
           },
           "additionalProperties": false,
@@ -280,6 +316,26 @@
           },
           "additionalProperties": false,
           "description": "Merge behavior configuration: local (merge locally) or github-pr (create PR)"
+        },
+        "ide": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "vscode",
+                "cursor",
+                "webstorm",
+                "sublime",
+                "intellij",
+                "windsurf"
+              ],
+              "default": "vscode",
+              "description": "IDE to launch when starting a loom. Options: vscode (Visual Studio Code), cursor (Cursor AI editor), webstorm (JetBrains WebStorm), sublime (Sublime Text), intellij (JetBrains IntelliJ IDEA), windsurf (Windsurf editor)."
+            }
+          },
+          "additionalProperties": false,
+          "description": "IDE configuration for workspace launches. Controls which editor opens when you start a loom. Supports VSCode, Cursor, WebStorm, Sublime Text, IntelliJ, and Windsurf. Note: Color synchronization (title bar colors) only works with VSCode-compatible editors (vscode, cursor, windsurf)."
         }
       },
       "additionalProperties": false

package/dist/{test-git-T76HOTIA.js → test-git-J7I5MFYH.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   SettingsManager
-} from "./chunk-T3KEIB4D.js";
+} from "./chunk-O5OH5MRX.js";
 import {
   findMainWorktreePath
-} from "./chunk-HBVFXN7R.js";
+} from "./chunk-4BGK7T6X.js";
 import {
   logger
 } from "./chunk-GEHQXLEI.js";
@@ -49,4 +49,4 @@ var TestGitCommand = class {
 export {
   TestGitCommand
 };
-//# sourceMappingURL=test-git-T76HOTIA.js.map
+//# sourceMappingURL=test-git-J7I5MFYH.js.map

package/dist/{test-prefix-6HJUVQMH.js → test-prefix-ZCONBCBX.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   SettingsManager
-} from "./chunk-T3KEIB4D.js";
+} from "./chunk-O5OH5MRX.js";
 import {
   generateWorktreePath
-} from "./chunk-HBVFXN7R.js";
+} from "./chunk-4BGK7T6X.js";
 import {
   logger
 } from "./chunk-GEHQXLEI.js";
@@ -65,4 +65,4 @@ var TestPrefixCommand = class {
 export {
   TestPrefixCommand
 };
-//# sourceMappingURL=test-prefix-6HJUVQMH.js.map
+//# sourceMappingURL=test-prefix-ZCONBCBX.js.map

package/dist/{test-webserver-M2I3EV4J.js → test-webserver-DAHONWCS.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ProcessManager
-} from "./chunk-SPYPLHMK.js";
+} from "./chunk-VU3QMIP2.js";
 import {
   logger
 } from "./chunk-GEHQXLEI.js";
@@ -16,8 +16,8 @@ var TestWebserverCommand = class {
    */
   async execute(input) {
     const { issueNumber, options } = input;
-    if (!Number.isInteger(issueNumber) || issueNumber <= 0) {
-      throw new Error("Issue number must be a positive integer");
+    if (typeof issueNumber !== "number" || !Number.isInteger(issueNumber) || issueNumber <= 0) {
+      throw new Error("Issue number must be a positive integer for port calculation");
     }
     const port = this.processManager.calculatePort(issueNumber);
     logger.info(`Checking port ${port} (issue #${issueNumber})...`);
@@ -59,4 +59,4 @@ var TestWebserverCommand = class {
 export {
   TestWebserverCommand
 };
-//# sourceMappingURL=test-webserver-M2I3EV4J.js.map
+//# sourceMappingURL=test-webserver-DAHONWCS.js.map

package/dist/test-webserver-DAHONWCS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/test-webserver.ts"],"sourcesContent":["import { logger } from '../utils/logger.js'\nimport { ProcessManager } from '../lib/process/ProcessManager.js'\n\nexport interface TestWebserverOptions {\n\tkill?: boolean\n}\n\nexport interface TestWebserverCommandInput {\n\tissueNumber: string | number\n\toptions: TestWebserverOptions\n}\n\n/**\n * Command to test if a web server is running on a workspace port\n * and optionally kill it if detected.\n *\n * This uses the ProcessManager to detect processes on ports and\n * safely terminate web servers when requested.\n */\nexport class TestWebserverCommand {\n\tprivate readonly processManager: ProcessManager\n\n\tconstructor(processManager?: ProcessManager) {\n\t\tthis.processManager = processManager ?? new ProcessManager()\n\t}\n\n\t/**\n\t * Main entry point for the test-webserver command\n\t */\n\tpublic async execute(input: TestWebserverCommandInput): Promise<void> {\n\t\tconst { issueNumber, options } = input\n\n\t\t// Validate issue number - test-webserver requires numeric for port calculation\n\t\tif (typeof issueNumber !== 'number' || !Number.isInteger(issueNumber) || issueNumber <= 0) {\n\t\t\tthrow new Error('Issue number must be a positive integer for port calculation')\n\t\t}\n\n\t\t// Calculate port from issue number\n\t\tconst port = this.processManager.calculatePort(issueNumber)\n\t\tlogger.info(`Checking port ${port} (issue #${issueNumber})...`)\n\n\t\t// Detect what's running on the port\n\t\tconst processInfo = await this.processManager.detectDevServer(port)\n\n\t\tif (!processInfo) {\n\t\t\tlogger.info(`No process found on port ${port}`)\n\t\t\treturn\n\t\t}\n\n\t\t// Report what we found\n\t\tlogger.info(`Found process on port ${port}:`)\n\t\tlogger.info(`   PID: ${processInfo.pid}`)\n\t\tlogger.info(`   Name: ${processInfo.name}`)\n\t\tlogger.info(`   Command: ${processInfo.command}`)\n\n\t\tif (processInfo.isDevServer) {\n\t\t\tlogger.success(`Detected as web server`)\n\t\t} else {\n\t\t\tlogger.warn(`Not detected as web server`)\n\t\t\tlogger.info(`This appears to be a non-web-server process. Skipping for safety.`)\n\t\t}\n\n\t\t// Kill process if requested (and it's a web server)\n\t\tif (options.kill) {\n\t\t\tif (!processInfo.isDevServer) {\n\t\t\t\tlogger.error(`Cannot kill non-web-server process (PID ${processInfo.pid}) for safety reasons`)\n\t\t\t\tlogger.info(`Process must match web server patterns to be killed automatically`)\n\t\t\t\tthrow new Error('Cannot kill non-web-server process')\n\t\t\t}\n\n\t\t\tlogger.info(`Terminating web server (PID ${processInfo.pid})...`)\n\t\t\tconst terminated = await this.processManager.terminateProcess(processInfo.pid)\n\n\t\t\tif (terminated) {\n\t\t\t\tlogger.success(`Web server terminated successfully`)\n\n\t\t\t\t// Verify port is now free\n\t\t\t\tconst isFree = await this.processManager.verifyPortFree(port)\n\t\t\t\tif (isFree) {\n\t\t\t\t\tlogger.success(`Port ${port} is now free`)\n\t\t\t\t} else {\n\t\t\t\t\tlogger.warn(`Port ${port} may still be in use (TIME_WAIT state)`)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;AAmBO,IAAM,uBAAN,MAA2B;AAAA,EAGjC,YAAY,gBAAiC;AAC5C,SAAK,iBAAiB,kBAAkB,IAAI,eAAe;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,QAAQ,OAAiD;AACrE,UAAM,EAAE,aAAa,QAAQ,IAAI;AAGjC,QAAI,OAAO,gBAAgB,YAAY,CAAC,OAAO,UAAU,WAAW,KAAK,eAAe,GAAG;AAC1F,YAAM,IAAI,MAAM,8DAA8D;AAAA,IAC/E;AAGA,UAAM,OAAO,KAAK,eAAe,cAAc,WAAW;AAC1D,WAAO,KAAK,iBAAiB,IAAI,YAAY,WAAW,MAAM;AAG9D,UAAM,cAAc,MAAM,KAAK,eAAe,gBAAgB,IAAI;AAElE,QAAI,CAAC,aAAa;AACjB,aAAO,KAAK,4BAA4B,IAAI,EAAE;AAC9C;AAAA,IACD;AAGA,WAAO,KAAK,yBAAyB,IAAI,GAAG;AAC5C,WAAO,KAAK,WAAW,YAAY,GAAG,EAAE;AACxC,WAAO,KAAK,YAAY,YAAY,IAAI,EAAE;AAC1C,WAAO,KAAK,eAAe,YAAY,OAAO,EAAE;AAEhD,QAAI,YAAY,aAAa;AAC5B,aAAO,QAAQ,wBAAwB;AAAA,IACxC,OAAO;AACN,aAAO,KAAK,4BAA4B;AACxC,aAAO,KAAK,mEAAmE;AAAA,IAChF;AAGA,QAAI,QAAQ,MAAM;AACjB,UAAI,CAAC,YAAY,aAAa;AAC7B,eAAO,MAAM,2CAA2C,YAAY,GAAG,sBAAsB;AAC7F,eAAO,KAAK,mEAAmE;AAC/E,cAAM,IAAI,MAAM,oCAAoC;AAAA,MACrD;AAEA,aAAO,KAAK,+BAA+B,YAAY,GAAG,MAAM;AAChE,YAAM,aAAa,MAAM,KAAK,eAAe,iBAAiB,YAAY,GAAG;AAE7E,UAAI,YAAY;AACf,eAAO,QAAQ,oCAAoC;AAGnD,cAAM,SAAS,MAAM,KAAK,eAAe,eAAe,IAAI;AAC5D,YAAI,QAAQ;AACX,iBAAO,QAAQ,QAAQ,IAAI,cAAc;AAAA,QAC1C,OAAO;AACN,iBAAO,KAAK,QAAQ,IAAI,wCAAwC;AAAA,QACjE;AAAA,MACD;AAAA,IACD;AAAA,EACD;AACD;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iloom/cli",
-  "version": "0.2.0",
-  "description": "Control plane for maintaining alignment between you and Claude AI as you work across multiple issues using isolated environments, visible context, and multi-agent workflows to scale understanding, not just output",
+  "version": "0.3.1",
+  "description": "Control plane for maintaining alignment between you and Claude Code as you work across multiple issues using isolated environments, visible context, and multi-agent workflows to scale understanding, not just output",
   "keywords": [
     "ai",
     "claude",
@@ -65,6 +65,7 @@
     "prepare": "husky"
   },
   "dependencies": {
+    "@linear/sdk": "^65.1.0",
     "@modelcontextprotocol/sdk": "^1.0.4",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",

package/dist/ClaudeContextManager-LVCYRM6Q.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-import {
-  ClaudeContextManager
-} from "./chunk-2PLUQT6J.js";
-import "./chunk-LHP6ROUM.js";
-import "./chunk-MFU53H6J.js";
-import "./chunk-PVAVNJKS.js";
-import "./chunk-T3KEIB4D.js";
-import "./chunk-GEHQXLEI.js";
-export {
-  ClaudeContextManager
-};
-//# sourceMappingURL=ClaudeContextManager-LVCYRM6Q.js.map

package/dist/ClaudeService-WVTWB3DK.js

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-import {
-  ClaudeService
-} from "./chunk-LHP6ROUM.js";
-import "./chunk-MFU53H6J.js";
-import "./chunk-PVAVNJKS.js";
-import "./chunk-T3KEIB4D.js";
-import "./chunk-GEHQXLEI.js";
-export {
-  ClaudeService
-};
-//# sourceMappingURL=ClaudeService-WVTWB3DK.js.map

package/dist/GitHubService-7E2S5NNZ.js

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-import {
-  GitHubService
-} from "./chunk-TS6DL67T.js";
-import "./chunk-SWCRXDZC.js";
-import "./chunk-JNKJ7NJV.js";
-import "./chunk-GEHQXLEI.js";
-export {
-  GitHubService
-};
-//# sourceMappingURL=GitHubService-7E2S5NNZ.js.map