@iloom/cli 0.10.1 → 0.11.0

package/LICENSE

@@ -20,7 +20,7 @@ it within your organization. What is prohibited is redistributing or offering
 access to this software (in original or modified form) as part of something
 you sell or provide to others.
 
-Change Date: 2030-02-25
+Change Date: 2030-03-01
 Change License: Apache License 2.0
 
 For clarity, on or after the Change Date, the Licensed Work will

package/README.md

@@ -668,7 +668,7 @@ This is an early-stage product.
 
 **Requirements:**
 
-*   ✅ **OS:** macOS (Fully supported). ⚠️ Linux/Windows are untested.
+*   ✅ **OS:** macOS (fully supported), Linux (GUI terminals + tmux for headless), WSL (Windows Terminal via [setup guide](docs/windows-wsl-guide.md)). ⚠️ Native Windows is unsupported.
     
 *   ✅ **Runtime:** Node.js 16+, Git 2.5+.
     
@@ -726,6 +726,8 @@ Acknowledgments
 ----------------
 
 - [@NoahCardoza](https://github.com/NoahCardoza) — Jira Cloud integration (PR [#588](https://github.com/iloom-ai/iloom-cli/pull/588)): JiraApiClient, JiraIssueTracker, ADF/Markdown conversion, MCP provider, sprint/mine filtering, and `il issues` Jira support.
+- [@TickTockBent](https://github.com/TickTockBent) — Linux, WSL, and tmux terminal support (PR [#796](https://github.com/iloom-ai/iloom-cli/pull/796)): strategy-pattern terminal backends, GUI-to-tmux fallback for headless environments, WSL detection, and cross-platform terminal launching.
+- [@rexsilex](https://github.com/rexsilex) — Original Linux/WSL terminal support design (PR [#649](https://github.com/iloom-ai/iloom-cli/pull/649)): pioneered the strategy pattern and backend interface that inspired the final implementation.
 
 License & Name
 --------------
@@ -738,7 +740,7 @@ License & Name
     
 *   ❌ You cannot resell iloom itself as a product or SaaS.
     
-*   Converts to Apache 2.0 on 2030-02-25.
+*   Converts to Apache 2.0 on 2030-03-01.
     
 
 See [LICENSE](https://raw.githubusercontent.com/iloom-ai/iloom-cli/main/LICENSE) for complete terms.

package/dist/{BranchNamingService-25KSZAEM.js → BranchNamingService-XBCO747L.js}

@@ -3,12 +3,12 @@ import {
   ClaudeBranchNameStrategy,
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
-} from "./chunk-QVLPWNE3.js";
-import "./chunk-6MLEBAYZ.js";
-import "./chunk-VT4PDUYT.js";
+} from "./chunk-7NFCGKZT.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
 export {
   ClaudeBranchNameStrategy,
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
 };
-//# sourceMappingURL=BranchNamingService-25KSZAEM.js.map
+//# sourceMappingURL=BranchNamingService-XBCO747L.js.map

package/dist/ClaudeContextManager-SXDCWDJA.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  ClaudeContextManager
+} from "./chunk-6YVJVUR4.js";
+import "./chunk-KQFIGI37.js";
+import "./chunk-Y3RX7LZT.js";
+import "./chunk-WG4MLJ6J.js";
+import "./chunk-ET6A2JR4.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
+export {
+  ClaudeContextManager
+};
+//# sourceMappingURL=ClaudeContextManager-SXDCWDJA.js.map

package/dist/ClaudeService-6E6MCGJE.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {
+  ClaudeService
+} from "./chunk-KQFIGI37.js";
+import "./chunk-Y3RX7LZT.js";
+import "./chunk-WG4MLJ6J.js";
+import "./chunk-ET6A2JR4.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
+export {
+  ClaudeService
+};
+//# sourceMappingURL=ClaudeService-6E6MCGJE.js.map

package/dist/GitHubService-2R5GQG4K.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  GitHubService
+} from "./chunk-LHDD4JHC.js";
+import "./chunk-NH3QZYE5.js";
+import "./chunk-CV47VCMQ.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
+export {
+  GitHubService
+};
+//# sourceMappingURL=GitHubService-2R5GQG4K.js.map

package/dist/IssueTrackerFactory-XN6MQ4UN.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  IssueTrackerFactory
+} from "./chunk-UHIBKD73.js";
+import "./chunk-5LTID2AF.js";
+import "./chunk-LHDD4JHC.js";
+import "./chunk-NH3QZYE5.js";
+import "./chunk-CV47VCMQ.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
+export {
+  IssueTrackerFactory
+};
+//# sourceMappingURL=IssueTrackerFactory-XN6MQ4UN.js.map

package/dist/{LoomLauncher-TDLZSYG2.js → LoomLauncher-5AZU2F5I.js}

@@ -1,29 +1,29 @@
 #!/usr/bin/env node
 import {
   openIdeWindow
-} from "./chunk-O7VL5N6S.js";
+} from "./chunk-K7R5QY6C.js";
 import {
   ClaudeContextManager
-} from "./chunk-E6KOWMKA.js";
-import "./chunk-S7PZA6IV.js";
-import "./chunk-UR5DGNUO.js";
-import "./chunk-UUEW5KWB.js";
+} from "./chunk-6YVJVUR4.js";
 import {
   getExecutablePath
 } from "./chunk-GYCR2LOU.js";
-import "./chunk-7VHJNVLF.js";
-import {
-  getLogger
-} from "./chunk-6MLEBAYZ.js";
 import {
   generateColorFromBranchName,
   hexToRgb
-} from "./chunk-433MOLAU.js";
+} from "./chunk-7OCGBJLR.js";
+import "./chunk-KQFIGI37.js";
+import "./chunk-Y3RX7LZT.js";
+import "./chunk-WG4MLJ6J.js";
+import "./chunk-ET6A2JR4.js";
+import {
+  getLogger
+} from "./chunk-ZAXRQLK3.js";
 import {
   getDotenvFlowFiles,
   openMultipleTerminalWindows,
   openTerminalWindow
-} from "./chunk-VT4PDUYT.js";
+} from "./chunk-H2SSF24U.js";
 
 // src/lib/LoomLauncher.ts
 import { existsSync } from "fs";
@@ -167,6 +167,9 @@ var LoomLauncher = class {
         claudeCommand += ` --set ${setArg}`;
       }
     }
+    if (options.complexity) {
+      claudeCommand += ` --complexity=${options.complexity}`;
+    }
     const backgroundColor = options.colorTerminal ?? true ? options.colorHex ? hexToRgb(options.colorHex) : generateColorFromBranchName(options.branchName).rgb : void 0;
     return {
       workspacePath: options.worktreePath,
@@ -252,4 +255,4 @@ var LoomLauncher = class {
 export {
   LoomLauncher
 };
-//# sourceMappingURL=LoomLauncher-TDLZSYG2.js.map
+//# sourceMappingURL=LoomLauncher-5AZU2F5I.js.map

package/dist/LoomLauncher-5AZU2F5I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/LoomLauncher.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { openTerminalWindow, openMultipleTerminalWindows } from '../utils/terminal.js'\nimport type { TerminalWindowOptions } from '../utils/terminal.js'\nimport { openIdeWindow } from '../utils/ide.js'\nimport { generateColorFromBranchName, hexToRgb } from '../utils/color.js'\nimport { getLogger } from '../utils/logger-context.js'\nimport { ClaudeContextManager } from './ClaudeContextManager.js'\nimport type { SettingsManager } from './SettingsManager.js'\nimport type { Capability } from '../types/loom.js'\nimport { getDotenvFlowFiles } from '../utils/env.js'\nimport { getExecutablePath } from '../utils/cli-overrides.js'\n\nexport interface LaunchLoomOptions {\n\tenableClaude: boolean\n\tenableCode: boolean\n\tenableDevServer: boolean\n\tenableTerminal: boolean\n\tworktreePath: string\n\tbranchName: string\n\tport?: number\n\tcapabilities: Capability[]\n\tworkflowType: 'issue' | 'pr' | 'regular'\n\tidentifier: string | number\n\ttitle?: string\n\toneShot?: import('../types/index.js').OneShotMode\n\tsetArguments?: string[] // Raw --set arguments to forward\n\texecutablePath?: string // Executable path to use for spin command\n\tsourceEnvOnStart?: boolean // defaults to false if undefined\n\tcolorTerminal?: boolean // defaults to true if undefined\n\tcolorHex?: string // Pre-calculated hex color from metadata, avoids recalculation\n\tcomplexity?: import('../types/index.js').ComplexityOverride\n}\n\n/**\n * LoomLauncher orchestrates opening loom components\n */\nexport class LoomLauncher {\n\tprivate claudeContext: ClaudeContextManager\n\tprivate settings?: SettingsManager\n\n\tconstructor(claudeContext?: ClaudeContextManager, settings?: SettingsManager) {\n\t\tthis.claudeContext = claudeContext ?? new ClaudeContextManager()\n\t\tif (settings !== undefined) {\n\t\t\tthis.settings = settings\n\t\t}\n\t}\n\n\t/**\n\t * Launch loom components based on individual flags\n\t */\n\tasync launchLoom(options: LaunchLoomOptions): Promise<void> {\n\t\tconst { enableClaude, enableCode, enableDevServer, enableTerminal } = options\n\n\t\tgetLogger().debug(`Launching loom components: Claude=${enableClaude}, Code=${enableCode}, DevServer=${enableDevServer}, Terminal=${enableTerminal}`)\n\n\t\tconst launchPromises: Promise<void>[] = []\n\n\t\t// Launch VSCode if enabled\n\t\tif (enableCode) {\n\t\t\tgetLogger().debug('Launching VSCode')\n\t\t\tlaunchPromises.push(this.launchVSCode(options))\n\t\t}\n\n\t\t// Build array of terminals to launch\n\t\tconst terminalsToLaunch: Array<{\n\t\t\ttype: 'claude' | 'devServer' | 'terminal'\n\t\t\toptions: TerminalWindowOptions\n\t\t}> = []\n\n\t\tif (enableDevServer) {\n\t\t\tterminalsToLaunch.push({\n\t\t\t\ttype: 'devServer',\n\t\t\t\toptions: this.buildDevServerTerminalOptions(options),\n\t\t\t})\n\t\t}\n\n\t\tif (enableTerminal) {\n\t\t\tterminalsToLaunch.push({\n\t\t\t\ttype: 'terminal',\n\t\t\t\toptions: this.buildStandaloneTerminalOptions(options),\n\t\t\t})\n\t\t}\n\n\t\tif (enableClaude) {\n\t\t\tterminalsToLaunch.push({\n\t\t\t\ttype: 'claude',\n\t\t\t\toptions: await this.buildClaudeTerminalOptions(options),\n\t\t\t})\n\t\t}\n\n\t\t// Launch terminals based on count\n\t\tif (terminalsToLaunch.length > 1) {\n\t\t\t// Multiple terminals - launch as tabs in single window\n\t\t\tgetLogger().debug(`Launching ${terminalsToLaunch.length} terminals in single window`)\n\t\t\tlaunchPromises.push(this.launchMultipleTerminals(terminalsToLaunch, options))\n\t\t} else if (terminalsToLaunch.length === 1) {\n\t\t\t// Single terminal - launch standalone\n\t\t\tconst terminal = terminalsToLaunch[0]\n\t\t\tif (!terminal) {\n\t\t\t\tthrow new Error('Terminal configuration is undefined')\n\t\t\t}\n\t\t\tconst terminalType = terminal.type\n\t\t\tgetLogger().debug(`Launching single ${terminalType} terminal`)\n\n\t\t\tif (terminalType === 'claude') {\n\t\t\t\tlaunchPromises.push(this.launchClaudeTerminal(options))\n\t\t\t} else if (terminalType === 'devServer') {\n\t\t\t\tlaunchPromises.push(this.launchDevServerTerminal(options))\n\t\t\t} else {\n\t\t\t\tlaunchPromises.push(this.launchStandaloneTerminal(options))\n\t\t\t}\n\t\t}\n\n\t\t// Wait for all components to launch\n\t\tawait Promise.all(launchPromises)\n\n\t\tgetLogger().success('loom launched successfully')\n\t}\n\n\t/**\n\t * Launch IDE (VSCode or configured alternative)\n\t */\n\tprivate async launchVSCode(options: LaunchLoomOptions): Promise<void> {\n\t\tconst ideConfig = await this.settings?.loadSettings().then((s) => s.ide)\n\t\tawait openIdeWindow(options.worktreePath, ideConfig)\n\t\tgetLogger().info('IDE opened')\n\t}\n\n\t/**\n\t * Launch Claude terminal\n\t */\n\tprivate async launchClaudeTerminal(options: LaunchLoomOptions): Promise<void> {\n\t\tawait this.claudeContext.launchWithContext({\n\t\t\tworkspacePath: options.worktreePath,\n\t\t\ttype: options.workflowType,\n\t\t\tidentifier: options.identifier,\n\t\t\tbranchName: options.branchName,\n\t\t\t...(options.title && { title: options.title }),\n\t\t\t...(options.port !== undefined && { port: options.port }),\n\t\t\toneShot: options.oneShot ?? 'default',\n\t\t\t...(options.setArguments && { setArguments: options.setArguments }),\n\t\t\t...(options.executablePath && { executablePath: options.executablePath }),\n\t\t})\n\t\tgetLogger().info('Claude terminal opened')\n\t}\n\n\t/**\n\t * Launch dev server terminal\n\t * Runs `il dev-server [identifier]` which handles env loading internally\n\t */\n\tprivate async launchDevServerTerminal(options: LaunchLoomOptions): Promise<void> {\n\t\t// Build dev-server command with identifier\n\t\tconst executable = options.executablePath ?? getExecutablePath()\n\t\tconst devServerIdentifier = String(options.identifier)\n\t\tconst devServerCommand = `${executable} dev-server ${devServerIdentifier}`\n\n\t\t// Only generate color if terminal coloring is enabled (default: true)\n\t\tconst backgroundColor = (options.colorTerminal ?? true)\n\t\t\t? options.colorHex\n\t\t\t\t? hexToRgb(options.colorHex)\n\t\t\t\t: generateColorFromBranchName(options.branchName).rgb\n\t\t\t: undefined\n\n\t\tawait openTerminalWindow({\n\t\t\tworkspacePath: options.worktreePath,\n\t\t\tcommand: devServerCommand,\n\t\t\t...(backgroundColor && { backgroundColor }),\n\t\t\t// il dev-server handles env loading internally, so no includeEnvSetup\n\t\t\tincludeEnvSetup: false,\n\t\t\tincludePortExport: options.capabilities.includes('web'),\n\t\t\t...(options.port !== undefined && { port: options.port }),\n\t\t})\n\t\tgetLogger().info('Dev server terminal opened')\n\t}\n\n\t/**\n\t * Launch standalone terminal running `il shell <identifier>`\n\t */\n\tprivate async launchStandaloneTerminal(options: LaunchLoomOptions): Promise<void> {\n\t\t// Build shell command with identifier\n\t\tconst executable = options.executablePath ?? getExecutablePath()\n\t\tconst shellIdentifier = String(options.identifier)\n\t\tconst shellCommand = `${executable} shell ${shellIdentifier}`\n\n\t\t// Only generate color if terminal coloring is enabled (default: true)\n\t\tconst backgroundColor = (options.colorTerminal ?? true)\n\t\t\t? options.colorHex\n\t\t\t\t? hexToRgb(options.colorHex)\n\t\t\t\t: generateColorFromBranchName(options.branchName).rgb\n\t\t\t: undefined\n\n\t\tawait openTerminalWindow({\n\t\t\tworkspacePath: options.worktreePath,\n\t\t\tcommand: shellCommand,\n\t\t\t...(backgroundColor && { backgroundColor }),\n\t\t\t// il shell handles env loading internally, so we don't need includeEnvSetup\n\t\t\tincludeEnvSetup: false,\n\t\t\tincludePortExport: options.capabilities.includes('web'),\n\t\t\t...(options.port !== undefined && { port: options.port }),\n\t\t})\n\t\tgetLogger().info('Standalone terminal opened')\n\t}\n\n\t/**\n\t * Build terminal options for Claude\n\t */\n\tprivate async buildClaudeTerminalOptions(\n\t\toptions: LaunchLoomOptions\n\t): Promise<TerminalWindowOptions> {\n\t\tconst hasEnvFile = this.hasAnyEnvFiles(options.worktreePath)\n\t\tconst claudeTitle = `Claude - ${this.formatIdentifier(options.workflowType, options.identifier)}`\n\n\t\tconst executable = options.executablePath ?? 'iloom'\n\t\tlet claudeCommand = `${executable} spin`\n\t\tif (options.oneShot !== undefined && options.oneShot !== 'default') {\n\t\t\tclaudeCommand += ` --one-shot=${options.oneShot}`\n\t\t}\n\t\tif (options.setArguments && options.setArguments.length > 0) {\n\t\t\tfor (const setArg of options.setArguments) {\n\t\t\t\tclaudeCommand += ` --set ${setArg}`\n\t\t\t}\n\t\t}\n\t\tif (options.complexity) {\n\t\t\tclaudeCommand += ` --complexity=${options.complexity}`\n\t\t}\n\n\t\t// Only generate color if terminal coloring is enabled (default: true)\n\t\tconst backgroundColor = (options.colorTerminal ?? true)\n\t\t\t? options.colorHex\n\t\t\t\t? hexToRgb(options.colorHex)\n\t\t\t\t: generateColorFromBranchName(options.branchName).rgb\n\t\t\t: undefined\n\n\t\treturn {\n\t\t\tworkspacePath: options.worktreePath,\n\t\t\tcommand: claudeCommand,\n\t\t\t...(backgroundColor && { backgroundColor }),\n\t\t\ttitle: claudeTitle,\n\t\t\tincludeEnvSetup: (options.sourceEnvOnStart ?? false) && hasEnvFile,\n\t\t\t...(options.port !== undefined && { port: options.port, includePortExport: true }),\n\t\t}\n\t}\n\n\t/**\n\t * Build terminal options for dev server\n\t * Uses `il dev-server [identifier]` which handles env loading internally\n\t */\n\tprivate buildDevServerTerminalOptions(\n\t\toptions: LaunchLoomOptions\n\t): TerminalWindowOptions {\n\t\t// Build dev-server command with identifier\n\t\tconst executable = options.executablePath ?? getExecutablePath()\n\t\tconst devServerIdentifier = String(options.identifier)\n\t\tconst devServerCommand = `${executable} dev-server ${devServerIdentifier}`\n\n\t\tconst devServerTitle = `Dev Server - ${this.formatIdentifier(options.workflowType, options.identifier)}`\n\n\t\t// Only generate color if terminal coloring is enabled (default: true)\n\t\tconst backgroundColor = (options.colorTerminal ?? true)\n\t\t\t? options.colorHex\n\t\t\t\t? hexToRgb(options.colorHex)\n\t\t\t\t: generateColorFromBranchName(options.branchName).rgb\n\t\t\t: undefined\n\n\t\treturn {\n\t\t\tworkspacePath: options.worktreePath,\n\t\t\tcommand: devServerCommand,\n\t\t\t...(backgroundColor && { backgroundColor }),\n\t\t\ttitle: devServerTitle,\n\t\t\t// il dev-server handles env loading internally\n\t\t\tincludeEnvSetup: false,\n\t\t\tincludePortExport: options.capabilities.includes('web'),\n\t\t\t...(options.port !== undefined && { port: options.port }),\n\t\t}\n\t}\n\n\t/**\n\t * Build terminal options for standalone terminal\n\t * Runs `il shell <identifier>` which handles env loading internally\n\t */\n\tprivate buildStandaloneTerminalOptions(\n\t\toptions: LaunchLoomOptions\n\t): TerminalWindowOptions {\n\t\tconst terminalTitle = `Terminal - ${this.formatIdentifier(options.workflowType, options.identifier)}`\n\n\t\t// Build shell command with identifier\n\t\t// Use the same executable path pattern as buildClaudeTerminalOptions\n\t\tconst executable = options.executablePath ?? getExecutablePath()\n\t\tconst shellIdentifier = String(options.identifier)\n\t\tconst shellCommand = `${executable} shell ${shellIdentifier}`\n\n\t\t// Only generate color if terminal coloring is enabled (default: true)\n\t\tconst backgroundColor = (options.colorTerminal ?? true)\n\t\t\t? options.colorHex\n\t\t\t\t? hexToRgb(options.colorHex)\n\t\t\t\t: generateColorFromBranchName(options.branchName).rgb\n\t\t\t: undefined\n\n\t\treturn {\n\t\t\tworkspacePath: options.worktreePath,\n\t\t\tcommand: shellCommand,\n\t\t\t...(backgroundColor && { backgroundColor }),\n\t\t\ttitle: terminalTitle,\n\t\t\t// il shell handles env loading internally, so we don't need includeEnvSetup\n\t\t\tincludeEnvSetup: false,\n\t\t\tincludePortExport: options.capabilities.includes('web'),\n\t\t\t...(options.port !== undefined && { port: options.port }),\n\t\t}\n\t}\n\n\t/**\n\t * Launch multiple terminals (2+) as tabs in single window\n\t */\n\tprivate async launchMultipleTerminals(\n\t\tterminals: Array<{ type: string; options: TerminalWindowOptions }>,\n\t\t_options: LaunchLoomOptions\n\t): Promise<void> {\n\t\tconst terminalOptions = terminals.map((t) => t.options)\n\n\t\tawait openMultipleTerminalWindows(terminalOptions)\n\n\t\tconst terminalTypes = terminals.map((t) => t.type).join(' + ')\n\t\tgetLogger().info(`Multiple terminals opened: ${terminalTypes}`)\n\t}\n\n\t/**\n\t * Check if any dotenv-flow files exist in the workspace\n\t * Checks all files: .env, .env.local, .env.{NODE_ENV}, .env.{NODE_ENV}.local\n\t */\n\tprivate hasAnyEnvFiles(workspacePath: string): boolean {\n\t\tconst envFiles = getDotenvFlowFiles()\n\t\treturn envFiles.some(file => existsSync(join(workspacePath, file)))\n\t}\n\n\t/**\n\t * Format identifier for terminal tab titles\n\t */\n\tprivate formatIdentifier(workflowType: 'issue' | 'pr' | 'regular', identifier: string | number): string {\n\t\tif (workflowType === 'issue') {\n\t\t\treturn `Issue #${identifier}`\n\t\t} else if (workflowType === 'pr') {\n\t\t\treturn `PR #${identifier}`\n\t\t} else {\n\t\t\treturn `Branch: ${identifier}`\n\t\t}\n\t}\n}\n"],"mappings":"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","names":[]}

package/dist/MetadataManager-CMQQTFLQ.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  MetadataManager
+} from "./chunk-YRCEOQPX.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
+export {
+  MetadataManager
+};
+//# sourceMappingURL=MetadataManager-CMQQTFLQ.js.map

package/dist/ProjectCapabilityDetector-IC6NAFGY.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  ProjectCapabilityDetector
+} from "./chunk-G2MNSPA4.js";
+import "./chunk-NCPZYQ4B.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
+export {
+  ProjectCapabilityDetector
+};
+//# sourceMappingURL=ProjectCapabilityDetector-IC6NAFGY.js.map

package/dist/{PromptTemplateManager-YOE2SIPG.js → PromptTemplateManager-T5VTLJP3.js}

@@ -2,10 +2,10 @@
 import {
   PromptTemplateManager,
   buildReviewTemplateVariables
-} from "./chunk-UUEW5KWB.js";
-import "./chunk-VT4PDUYT.js";
+} from "./chunk-WG4MLJ6J.js";
+import "./chunk-H2SSF24U.js";
 export {
   PromptTemplateManager,
   buildReviewTemplateVariables
 };
-//# sourceMappingURL=PromptTemplateManager-YOE2SIPG.js.map
+//# sourceMappingURL=PromptTemplateManager-T5VTLJP3.js.map

package/dist/README.md

@@ -668,7 +668,7 @@ This is an early-stage product.
 
 **Requirements:**
 
-*   ✅ **OS:** macOS (Fully supported). ⚠️ Linux/Windows are untested.
+*   ✅ **OS:** macOS (fully supported), Linux (GUI terminals + tmux for headless), WSL (Windows Terminal via [setup guide](docs/windows-wsl-guide.md)). ⚠️ Native Windows is unsupported.
     
 *   ✅ **Runtime:** Node.js 16+, Git 2.5+.
     
@@ -726,6 +726,8 @@ Acknowledgments
 ----------------
 
 - [@NoahCardoza](https://github.com/NoahCardoza) — Jira Cloud integration (PR [#588](https://github.com/iloom-ai/iloom-cli/pull/588)): JiraApiClient, JiraIssueTracker, ADF/Markdown conversion, MCP provider, sprint/mine filtering, and `il issues` Jira support.
+- [@TickTockBent](https://github.com/TickTockBent) — Linux, WSL, and tmux terminal support (PR [#796](https://github.com/iloom-ai/iloom-cli/pull/796)): strategy-pattern terminal backends, GUI-to-tmux fallback for headless environments, WSL detection, and cross-platform terminal launching.
+- [@rexsilex](https://github.com/rexsilex) — Original Linux/WSL terminal support design (PR [#649](https://github.com/iloom-ai/iloom-cli/pull/649)): pioneered the strategy pattern and backend interface that inspired the final implementation.
 
 License & Name
 --------------
@@ -738,7 +740,7 @@ License & Name
     
 *   ❌ You cannot resell iloom itself as a product or SaaS.
     
-*   Converts to Apache 2.0 on 2030-02-25.
+*   Converts to Apache 2.0 on 2030-03-01.
     
 
 See [LICENSE](https://raw.githubusercontent.com/iloom-ai/iloom-cli/main/LICENSE) for complete terms.

package/dist/{SettingsManager-FNKCOZMQ.js → SettingsManager-WQ5NSGAH.js}

@@ -16,8 +16,8 @@ import {
   WorkflowPermissionSchemaNoDefaults,
   WorkflowsSettingsSchema,
   WorkflowsSettingsSchemaNoDefaults
-} from "./chunk-7VHJNVLF.js";
-import "./chunk-VT4PDUYT.js";
+} from "./chunk-ET6A2JR4.js";
+import "./chunk-H2SSF24U.js";
 export {
   AgentSettingsSchema,
   BaseAgentSettingsSchema,
@@ -36,4 +36,4 @@ export {
   WorkflowsSettingsSchema,
   WorkflowsSettingsSchemaNoDefaults
 };
-//# sourceMappingURL=SettingsManager-FNKCOZMQ.js.map
+//# sourceMappingURL=SettingsManager-WQ5NSGAH.js.map

package/dist/SettingsMigrationManager-S6J7OHUH.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  SettingsMigrationManager
+} from "./chunk-IDCE26KD.js";
+import "./chunk-CV47VCMQ.js";
+import "./chunk-H2SSF24U.js";
+export {
+  SettingsMigrationManager
+};
+//# sourceMappingURL=SettingsMigrationManager-S6J7OHUH.js.map

package/dist/agents/iloom-code-reviewer.md

@@ -1,11 +1,11 @@
 ---
 name: iloom-code-reviewer
-description: Use this agent to review uncommitted code changes.
+description: Use this agent to review code changes.
 model: opus
 color: cyan
 ---
 
-You are an expert code reviewer. Your task is to analyze uncommitted code changes and provide actionable feedback.
+You are an expert code reviewer. Your task is to analyze code changes and provide actionable feedback.
 
 {{#if SWARM_MODE}}
 ## Swarm Mode
@@ -77,7 +77,19 @@ Codex review configured with model: {{REVIEW_CODEX_MODEL}}
 
 **ORCHESTRATOR: Execute the following steps:**
 
-1. Gather context: Run `git status` to identify all changes, then run `git diff` for tracked file changes, then read all CLAUDE.md files. **IMPORTANT:** `git diff` does NOT show untracked (new) files. For any new untracked files listed by `git status`, you MUST read them directly using the Read tool to include their contents in the review.
+1. Determine what to review and gather context:
+   a. Run `git status --porcelain` to check for uncommitted changes
+   b. If there ARE uncommitted changes, use `git diff` to get the diff of tracked file changes
+   c. If there are NO uncommitted changes:
+      - Get current branch: `git branch --show-current`
+      - If on a protected branch (main, master, develop) or detached HEAD, there is nothing to review — inform the user
+      - If on a feature branch:
+        - Try to find remote tracking: `git rev-parse --abbrev-ref @{upstream} 2>/dev/null`
+        - If upstream exists: use `git diff $(git merge-base HEAD <upstream>)` to see changes not yet on remote
+        - If no upstream: use `git diff $(git merge-base HEAD main)` to see changes since diverging from main (try `master` if `main` doesn't exist)
+   d. If the diff is empty, inform the user there are no changes to review
+   e. Read all CLAUDE.md files for project guidelines
+   f. **IMPORTANT:** `git diff` does NOT show untracked (new) files. For any new untracked files listed by `git status`, you MUST read them directly using the Read tool to include their contents in the review.
 2. Execute 5 parallel Task agents (below) with the git diff and CLAUDE.md content
 
 ### Agent 1: Compliance Review
@@ -252,10 +264,25 @@ Summary: X critical, Y warnings, Z suggestions
 {{#if HAS_REVIEW_GEMINI}}
 ## Review Process
 
+### Step 0 - Determine What to Review
+
+Before gathering code for review, determine what changes to review:
+
+1. Check for uncommitted changes: `git status --porcelain`
+2. If there ARE uncommitted changes, use `git diff` to review them
+3. If there are NO uncommitted changes:
+   a. Get current branch: `git branch --show-current`
+   b. If on a protected branch (main, master, develop) or detached HEAD, there is nothing to review — inform the user
+   c. If on a feature branch:
+      - Try to find remote tracking: `git rev-parse --abbrev-ref @{upstream} 2>/dev/null`
+      - If upstream exists: use `git diff $(git merge-base HEAD <upstream>)` to see changes not yet on remote
+      - If no upstream: use `git diff $(git merge-base HEAD main)` to see changes since diverging from main (try `master` if `main` doesn't exist)
+4. If the diff is empty, inform the user there are no changes to review
+
 ### Step 1 - Gather Context
 
-1. Run `git status` to see all uncommitted changes (including untracked new files)
-2. Run `git diff` to get the full diff of tracked file changes (save this - you will need it)
+1. Run `git status` to see all changes (including untracked new files)
+2. Run the appropriate git diff command (determined in Step 0) to get the full diff (save this - you will need it)
 3. **IMPORTANT:** `git diff` does NOT show untracked (new) files. For any new untracked files listed by `git status`, read them directly using the Read tool and include their contents alongside the diff for review.
 4. Search for CLAUDE.md files in the repository for project guidelines using Glob tool
 
@@ -495,10 +522,25 @@ If ANY critical issues (95-100 confidence) are found from Gemini review:
 {{#if HAS_REVIEW_CODEX}}
 ## Review Process
 
+### Step 0 - Determine What to Review
+
+Before gathering code for review, determine what changes to review:
+
+1. Check for uncommitted changes: `git status --porcelain`
+2. If there ARE uncommitted changes, use `git diff` to review them
+3. If there are NO uncommitted changes:
+   a. Get current branch: `git branch --show-current`
+   b. If on a protected branch (main, master, develop) or detached HEAD, there is nothing to review — inform the user
+   c. If on a feature branch:
+      - Try to find remote tracking: `git rev-parse --abbrev-ref @{upstream} 2>/dev/null`
+      - If upstream exists: use `git diff $(git merge-base HEAD <upstream>)` to see changes not yet on remote
+      - If no upstream: use `git diff $(git merge-base HEAD main)` to see changes since diverging from main (try `master` if `main` doesn't exist)
+4. If the diff is empty, inform the user there are no changes to review
+
 ### Step 1 - Gather Context
 
-1. Run `git status` to see all uncommitted changes (including untracked new files)
-2. Run `git diff` to get the full diff of tracked file changes (save this - you will need it)
+1. Run `git status` to see all changes (including untracked new files)
+2. Run the appropriate git diff command (determined in Step 0) to get the full diff (save this - you will need it)
 3. **IMPORTANT:** `git diff` does NOT show untracked (new) files. For any new untracked files listed by `git status`, read them directly using the Read tool and include their contents alongside the diff for review.
 4. Search for CLAUDE.md files in the repository for project guidelines using Glob tool
 
@@ -748,4 +790,4 @@ No review providers are configured. To enable code review, configure providers i
 - Be specific with file paths and line numbers
 - Provide actionable recommendations
 - Acknowledge when code is well-written
-- Do NOT review the entire codebase - only uncommitted changes
+- Do NOT review the entire codebase - only the relevant code changes

package/dist/agents/iloom-issue-analyze-and-plan.md

@@ -49,6 +49,9 @@ The recap panel helps users stay oriented without reading all your output. Captu
 **During planning, log:**
 - **decision**: Significant choices - "Using WebSocket instead of polling for real-time updates"
 - **assumption**: Bets you're making - "Assuming no backwards compat needed"
+  - **CRITICAL**: When your plan references a specific value (threshold, score range, enum, format) defined in another component:
+    - If verified: call `recap.add_entry({ type: 'insight', content: '[value] for [purpose] confirmed at [file:line]' })`
+    - If NOT verified: describe the intent instead of the value, and call `recap.add_entry({ type: 'assumption', content: 'Could not verify [value] for [purpose] — described intent instead of specific value' })`
 
 **Never log** workflow status, complexity classifications, or phase information.
 
@@ -228,6 +231,11 @@ With this analysis, you will:
 - [ ] Similar patterns: Grep for similar implementations
 - [ ] Historical: Why is the code this way? (git blame if unclear)
 
+**4. Integration Contracts (if plan references other components)**
+- [ ] List every specific value (score ranges, enums, formats, thresholds) your plan references from another component
+- [ ] For each: verify the source with a file:line citation
+- [ ] If you cannot find the source: do NOT include the value — describe the intent instead and log a recap assumption (see Recap section)
+
 **Output**: Document findings briefly in Section 2. One sentence per finding. File:line references required.
 
 **CONSTRAINTS:**
@@ -689,6 +697,7 @@ When including code, configuration, or examples:
 10. **Section 1 Scannable**: <5 minutes to read - ruthlessly prioritize
 11. **Section 2 Concise**: Brief, actionable, no "AI slop"
 12. **One-Sentence Rule**: Apply throughout Section 2 for descriptions and risks
+13. **No Cross-Component Fabrication**: When your plan includes a specific value (score range, threshold, enum, format) defined in another component's source, you MUST look it up and cite file:line. If you cannot find it, do NOT include the value — describe the intent instead (e.g., "use the reviewer's critical category" not "95-100") and log a recap assumption. Writing a plausible-sounding value from memory is confabulation — treat it as a hard error equivalent to citing a nonexistent file.
 
 ## Quality Assurance
 
@@ -715,6 +724,7 @@ Before submitting your combined analysis and plan, verify (DO NOT print this che
 - No "AI slop": No time estimates, rollback plans, manual testing checklists, or redundant sections
 - One-sentence descriptions used throughout Section 2
 - **FOR CROSS-CUTTING CHANGES**: Call chain is documented, ALL interfaces in chain are identified, cross-cutting impact is noted for each file
+- **FOR CROSS-COMPONENT VALUES**: Scan plan for specific values (scores, thresholds, enums) sourced from other components. Each must have a file:line citation. Any value without a citation must be replaced with intent-based language (not a fabricated number) and have a corresponding `recap.add_entry({ type: 'assumption' })` call.
 
 ## Error Handling
 

package/dist/agents/iloom-issue-analyzer.md

@@ -48,6 +48,16 @@ The recap panel helps users stay oriented without reading all your output. Captu
 **Log these:**
 - **insight**: Technical discoveries - "Auth module depends on session middleware being initialized first"
 - **risk**: Things that could go wrong - "Removing this function breaks the CLI's --verbose flag"
+- **assumption / insight**: When your analysis references a specific value (threshold, score range, enum, format) from another component:
+  - If verified: call `recap.add_entry({ type: 'insight', content: '[value] for [purpose] confirmed at [file:line]' })`
+  - If NOT verified: describe the intent instead of the value, and call `recap.add_entry({ type: 'assumption', content: 'Could not verify [value] — described intent instead' })`
+
+**CRITICAL: Assumption quality rules:**
+- **NEVER restate information from the issue title or description as an assumption.** If the issue already states something, logging it as an "assumption" adds zero value.
+- Assumptions must be about genuinely **unknown or ambiguous** technical details that you're inferring from evidence.
+- Good assumption: "Assuming the dropdown uses CSS position:relative based on the described layout shift behavior" - infers something NOT stated.
+- Bad assumption: "Assuming the issue affects components X and Y" when the issue explicitly mentions both.
+- If you have no genuine assumptions to log, **don't log any**.
 
 **Never log** workflow status, complexity classifications, or what phases you skipped.
 
@@ -314,6 +324,7 @@ Use domain-specific MCP tools when available (Figma MCP, Database MCPs, etc.) as
 - **Do NOT stop at first result** - cross-reference for critical behaviors
 - **Do NOT include irrelevant research** - this is slop
 - **Do NOT assume an operation is necessary** just because the issue describes it — verify that the system doesn't already exhibit the desired behavior without the change
+- **Do NOT fabricate cross-component values** - when documenting a specific value (score range, threshold, enum, format) from another component, you MUST look it up and cite file:line. If you cannot find it, describe the intent (e.g., "the reviewer's critical threshold") instead of writing a plausible-sounding number from memory
 
 ## If this is a web front end issue:
 - Be mindful of different responsive breakpoints
@@ -609,6 +620,7 @@ Before submitting your analysis, verify:
 - [ ] Findings are organized logically and easy to follow
 - [ ] You have not detailed the solution - only identified relevant parts of the code, and potential risks, edge cases to be aware of
 - [ ] **FOR CROSS-CUTTING CHANGES**: Architectural Flow Analysis section is complete with call chain map, ALL affected interfaces listed, and implementation complexity noted
+- [ ] **FOR CROSS-COMPONENT VALUES**: Every specific value (scores, thresholds, enums) referenced from other components has a file:line citation. Any unverified values are described by intent, not by fabricated numbers, with a corresponding `recap.add_entry({ type: 'assumption' })` call.
 
 ## Behavioral Constraints
 
@@ -617,6 +629,7 @@ Before submitting your analysis, verify:
 3. **Precise**: Use exact file paths, line numbers, and version numbers
 4. **Neutral Tone**: Present findings objectively without blame or judgment
 6. **Integration tests**: IMPORTANT: NEVER propose or explore writing integration tests that interact with git, the filesystem or 3rd party APIs.
+7. **No Cross-Component Fabrication**: When documenting a specific value (score range, threshold, enum, format) from another component's source, you MUST look it up and cite file:line. If you cannot find it, describe the intent instead of the value and log a recap assumption. Writing a plausible-sounding value from memory is confabulation — treat it as a hard error equivalent to citing a nonexistent file.
 
 ## Error Handling
 

package/dist/agents/iloom-issue-complexity-evaluator.md

@@ -54,7 +54,14 @@ recap.set_complexity({ complexity: 'simple', reason: 'Few files, low risk' })
 **Log these with add_entry:**
 - **insight**: Complexity factor discoveries - "Change requires coordinating updates across 5 TypeScript interfaces"
 - **risk**: Implementation concerns - "Large god-object file (2000+ LOC) will make changes error-prone"
-- **assumption**: Scope estimates - "Assuming existing test patterns can be followed without new test infrastructure"
+- **assumption**: Genuinely unknown information you're inferring that affects complexity - "Assuming existing test patterns can be followed without new test infrastructure"
+
+**CRITICAL: Assumption quality rules:**
+- **NEVER restate information from the issue title or description as an assumption.** If the issue says "search results push content down in Create New Loom and Child Loom modals", logging "Assuming the issue affects both modals" is worthless - the issue already says that.
+- Assumptions must be about genuinely **unknown or ambiguous** aspects that you are choosing to interpret a certain way for your assessment.
+- Good assumption: "Assuming the dropdown uses CSS position:relative (not absolute) based on the described layout shift behavior" - this infers something NOT stated in the issue.
+- Bad assumption: "Assuming this affects component X and component Y" when the issue explicitly mentions both X and Y.
+- If you have no genuine assumptions to log, **don't log any** - zero assumptions is better than low-quality ones.
 
 **Never log** workflow status or routine metric observations.
 

package/dist/agents/iloom-issue-enhancer.md

@@ -52,7 +52,14 @@ The recap panel helps users stay oriented without reading all your output. Captu
 **Log these:**
 - **insight**: User need discoveries - "Users need to configure multiple environments per project"
 - **risk**: User impact concerns - "Current behavior causes data loss when session expires mid-edit"
-- **assumption**: Interpretations of user intent - "Assuming user wants this to work across all browsers, not just Chrome"
+- **assumption**: Interpretations of genuinely ambiguous user intent - "Assuming user wants this to work across all browsers, not just Chrome"
+
+**CRITICAL: Assumption quality rules:**
+- **NEVER restate information from the issue title or description as an assumption.** If the issue already states something, logging it as an "assumption" adds zero value.
+- Assumptions must be about genuinely **unknown or ambiguous** aspects where you're making an interpretive choice.
+- Good assumption: "Assuming the user wants keyboard navigation support in addition to mouse interaction" - the issue didn't mention this.
+- Bad assumption: "Assuming this affects the Create New Loom modal" when the issue title literally says "Create New Loom modal."
+- If you have no genuine assumptions to log, **don't log any** - zero assumptions is better than restating the obvious.
 
 **Never log** workflow status, that enhancement was completed, or quality assessment results.
 {{/unless}}

package/dist/agents/iloom-issue-planner.md

@@ -45,6 +45,9 @@ The recap panel helps users stay oriented without reading all your output. Captu
 **Log these:**
 - **decision**: Significant choices - "Adding new CLI flag rather than environment variable for this config"
 - **assumption**: Bets you're making - "Assuming backwards compat not needed since atomically deployed"
+  - **CRITICAL**: When your plan references a specific value (threshold, score range, enum, format) defined in another component:
+    - If verified: call `recap.add_entry({ type: 'insight', content: '[value] for [purpose] confirmed at [file:line]' })`
+    - If NOT verified: describe the intent instead of the value, and call `recap.add_entry({ type: 'assumption', content: 'Could not verify [value] for [purpose] — described intent instead of specific value' })`
 
 **Never log** workflow status, phase information, or that a plan was created.
 
@@ -504,6 +507,7 @@ This section tells the orchestrator EXACTLY how to execute the implementation st
 - All file-by-file changes, test structures, and execution details go in Section 2 (collapsible)
 - Use pseudocode and comments in Section 2 - NOT full code implementations
 - Code blocks >5 lines must be wrapped in nested `<details>` tags within Section 2
+- **FOR CROSS-COMPONENT VALUES**: Every specific value (scores, thresholds, enums) referenced from other components must have a file:line citation. Any value without a citation must be replaced with intent-based language and have a corresponding `recap.add_entry({ type: 'assumption' })` call.
 
 
 ## HOW TO UPDATE THE USER OF YOUR PROGRESS
@@ -521,6 +525,7 @@ This section tells the orchestrator EXACTLY how to execute the implementation st
 - **NO ASSUMPTIONS** - if something is unclear, note it in the plan
 - **NO ENHANCEMENTS** - stick strictly to stated requirements
 - **QUESTION NECESSITY** - if requirements describe writing values that already match the system's built-in defaults, the write may be unnecessary. Plan for the actual need, not the literal phrasing of the issue.
+- **NO CROSS-COMPONENT FABRICATION** - when your plan includes a specific value (score range, threshold, enum, format) from another component's source, look it up and cite file:line. If you cannot find it, describe the intent (e.g., "the reviewer's critical category") instead of a plausible-sounding number. Log a recap assumption. Fabricating values is a hard error.
 
 ## Workflow
 

package/dist/build-OLS6J5KZ.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import {
+  ScriptCommandBase
+} from "./chunk-V4STTBQD.js";
+import "./chunk-UDCI3QTS.js";
+import "./chunk-3GTUXW26.js";
+import "./chunk-NCPZYQ4B.js";
+import "./chunk-LE2NOUTN.js";
+import "./chunk-3RXYOBME.js";
+import "./chunk-ET6A2JR4.js";
+import "./chunk-YRCEOQPX.js";
+import "./chunk-ZAXRQLK3.js";
+import "./chunk-H2SSF24U.js";
+
+// src/commands/build.ts
+var BuildCommand = class extends ScriptCommandBase {
+  getScriptName() {
+    return "build";
+  }
+  getScriptDisplayName() {
+    return "Build";
+  }
+};
+export {
+  BuildCommand
+};
+//# sourceMappingURL=build-OLS6J5KZ.js.map

package/dist/{chunk-WWKOVDWC.js → chunk-3GTUXW26.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   getPackageScripts
-} from "./chunk-YQ57ORTV.js";
+} from "./chunk-NCPZYQ4B.js";
 import {
   getLogger
-} from "./chunk-6MLEBAYZ.js";
+} from "./chunk-ZAXRQLK3.js";
 
 // src/utils/package-manager.ts
 import { execa } from "execa";
@@ -161,4 +161,4 @@ export {
   installDependencies,
   runScript
 };
-//# sourceMappingURL=chunk-WWKOVDWC.js.map
+//# sourceMappingURL=chunk-3GTUXW26.js.map

package/dist/{chunk-4FGEGQW4.js → chunk-3RXYOBME.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   SettingsManager
-} from "./chunk-7VHJNVLF.js";
+} from "./chunk-ET6A2JR4.js";
 import {
   MetadataManager
-} from "./chunk-KB64WNBZ.js";
+} from "./chunk-YRCEOQPX.js";
 import {
   logger
-} from "./chunk-VT4PDUYT.js";
+} from "./chunk-H2SSF24U.js";
 
 // src/utils/git.ts
 import path from "path";
@@ -375,7 +375,7 @@ async function getDefaultBranch(path2 = process.cwd()) {
 }
 async function findAllBranchesForIssue(issueNumber, path2 = process.cwd(), settingsManager) {
   if (!settingsManager) {
-    const { SettingsManager: SM } = await import("./SettingsManager-FNKCOZMQ.js");
+    const { SettingsManager: SM } = await import("./SettingsManager-WQ5NSGAH.js");
     settingsManager = new SM();
   }
   const protectedBranches = await settingsManager.getProtectedBranches(path2);
@@ -738,4 +738,4 @@ export {
   removePlaceholderCommitFromHead,
   removePlaceholderCommitFromHistory
 };
-//# sourceMappingURL=chunk-4FGEGQW4.js.map
+//# sourceMappingURL=chunk-3RXYOBME.js.map