@iloom/cli 0.13.2 → 0.13.4

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-03-21
+Change Date: 2030-03-25
 Change License: Apache License 2.0
 
 For clarity, on or after the Change Date, the Licensed Work will

package/README.md

@@ -880,7 +880,7 @@ License & Name
     
 *   ❌ You cannot resell iloom itself as a product or SaaS.
     
-*   Converts to Apache 2.0 on 2030-03-21.
+*   Converts to Apache 2.0 on 2030-03-25.
     
 
 See [LICENSE](https://raw.githubusercontent.com/iloom-ai/iloom-cli/main/LICENSE) for complete terms.

package/dist/{BranchNamingService-MEK2WZUD.js → BranchNamingService-PBP6DY3H.js}

@@ -3,7 +3,7 @@ import {
   ClaudeBranchNameStrategy,
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
-} from "./chunk-AQUSMNBF.js";
+} from "./chunk-CWRQ4NU4.js";
 import "./chunk-FTYWGQFM.js";
 import "./chunk-VRPPI6GU.js";
 export {
@@ -11,4 +11,4 @@ export {
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
 };
-//# sourceMappingURL=BranchNamingService-MEK2WZUD.js.map
+//# sourceMappingURL=BranchNamingService-PBP6DY3H.js.map

package/dist/{ClaudeContextManager-KJ4VEA2F.js → ClaudeContextManager-3HT4LEIU.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   ClaudeContextManager
-} from "./chunk-32D4CWWH.js";
-import "./chunk-UMAOVKQX.js";
+} from "./chunk-R2RGFNR4.js";
+import "./chunk-CSJ7JNJV.js";
 import "./chunk-LDE6VNG5.js";
-import "./chunk-DDHWZNGL.js";
-import "./chunk-MNPKEWBQ.js";
+import "./chunk-MB4CB7Q4.js";
+import "./chunk-UVZBZ5IF.js";
 import "./chunk-FTYWGQFM.js";
 import "./chunk-VRPPI6GU.js";
 export {
   ClaudeContextManager
 };
-//# sourceMappingURL=ClaudeContextManager-KJ4VEA2F.js.map
+//# sourceMappingURL=ClaudeContextManager-3HT4LEIU.js.map

package/dist/{ClaudeService-WTJO4UW6.js → ClaudeService-7BHL2GWC.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   ClaudeService
-} from "./chunk-UMAOVKQX.js";
+} from "./chunk-CSJ7JNJV.js";
 import "./chunk-LDE6VNG5.js";
-import "./chunk-DDHWZNGL.js";
-import "./chunk-MNPKEWBQ.js";
+import "./chunk-MB4CB7Q4.js";
+import "./chunk-UVZBZ5IF.js";
 import "./chunk-FTYWGQFM.js";
 import "./chunk-VRPPI6GU.js";
 export {
   ClaudeService
 };
-//# sourceMappingURL=ClaudeService-WTJO4UW6.js.map
+//# sourceMappingURL=ClaudeService-7BHL2GWC.js.map

package/dist/{IssueTrackerFactory-UEJALI4X.js → IssueTrackerFactory-JH34S4GX.js}

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   IssueTrackerFactory
-} from "./chunk-ZWXJ7G2C.js";
+} from "./chunk-JIMFSNZI.js";
 import "./chunk-DMSL5BAP.js";
 import "./chunk-D4Q7T5KD.js";
 import "./chunk-KV4NU3RP.js";
 import "./chunk-NPVA65KS.js";
-import "./chunk-MNPKEWBQ.js";
+import "./chunk-UVZBZ5IF.js";
 import "./chunk-FTYWGQFM.js";
 import "./chunk-VRPPI6GU.js";
 export {
   IssueTrackerFactory
 };
-//# sourceMappingURL=IssueTrackerFactory-UEJALI4X.js.map
+//# sourceMappingURL=IssueTrackerFactory-JH34S4GX.js.map

package/dist/{LoomLauncher-KG2VBNQA.js → LoomLauncher-RGXJOCMC.js}

@@ -4,8 +4,8 @@ import {
 } from "./chunk-CE676WCN.js";
 import {
   ClaudeContextManager
-} from "./chunk-32D4CWWH.js";
-import "./chunk-UMAOVKQX.js";
+} from "./chunk-R2RGFNR4.js";
+import "./chunk-CSJ7JNJV.js";
 import "./chunk-LDE6VNG5.js";
 import {
   getExecutablePath
@@ -14,8 +14,8 @@ import {
   generateColorFromBranchName,
   hexToRgb
 } from "./chunk-OIVFHJOA.js";
-import "./chunk-DDHWZNGL.js";
-import "./chunk-MNPKEWBQ.js";
+import "./chunk-MB4CB7Q4.js";
+import "./chunk-UVZBZ5IF.js";
 import {
   getLogger
 } from "./chunk-FTYWGQFM.js";
@@ -170,6 +170,9 @@ var LoomLauncher = class {
     if (options.complexity) {
       claudeCommand += ` --complexity=${options.complexity}`;
     }
+    if (options.effort) {
+      claudeCommand += ` --effort=${options.effort}`;
+    }
     const backgroundColor = options.colorTerminal ?? true ? options.colorHex ? hexToRgb(options.colorHex) : generateColorFromBranchName(options.branchName).rgb : void 0;
     return {
       workspacePath: options.worktreePath,
@@ -255,4 +258,4 @@ var LoomLauncher = class {
 export {
   LoomLauncher
 };
-//# sourceMappingURL=LoomLauncher-KG2VBNQA.js.map
+//# sourceMappingURL=LoomLauncher-RGXJOCMC.js.map

package/dist/LoomLauncher-RGXJOCMC.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\teffort?: import('../types/index.js').EffortLevel\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\t\tif (options.effort) {\n\t\t\tclaudeCommand += ` --effort=${options.effort}`\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-HHE6LQF2.js → MetadataManager-WKM7JJIO.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   MetadataManager
-} from "./chunk-XIVLGWUX.js";
+} from "./chunk-JDXJIPXR.js";
 import "./chunk-FTYWGQFM.js";
 import "./chunk-VRPPI6GU.js";
 export {
   MetadataManager
 };
-//# sourceMappingURL=MetadataManager-HHE6LQF2.js.map
+//# sourceMappingURL=MetadataManager-WKM7JJIO.js.map

package/dist/README.md

@@ -880,7 +880,7 @@ License & Name
     
 *   ❌ You cannot resell iloom itself as a product or SaaS.
     
-*   Converts to Apache 2.0 on 2030-03-21.
+*   Converts to Apache 2.0 on 2030-03-25.
     
 
 See [LICENSE](https://raw.githubusercontent.com/iloom-ai/iloom-cli/main/LICENSE) for complete terms.

package/dist/{SettingsManager-PVHBSCMI.js → SettingsManager-Y5OU5HCX.js}

@@ -15,13 +15,14 @@ import {
   SpinAgentSettingsSchema,
   SummarySettingsSchema,
   VALID_CLAUDE_MODELS,
+  VALID_EFFORT_LEVELS,
   WorkflowPermissionSchema,
   WorkflowPermissionSchemaNoDefaults,
   WorkflowsSettingsSchema,
   WorkflowsSettingsSchemaNoDefaults,
   mergeModeValues,
   redactSensitiveFields
-} from "./chunk-MNPKEWBQ.js";
+} from "./chunk-UVZBZ5IF.js";
 import "./chunk-VRPPI6GU.js";
 export {
   AgentSettingsSchema,
@@ -39,6 +40,7 @@ export {
   SpinAgentSettingsSchema,
   SummarySettingsSchema,
   VALID_CLAUDE_MODELS,
+  VALID_EFFORT_LEVELS,
   WorkflowPermissionSchema,
   WorkflowPermissionSchemaNoDefaults,
   WorkflowsSettingsSchema,
@@ -46,4 +48,4 @@ export {
   mergeModeValues,
   redactSensitiveFields
 };
-//# sourceMappingURL=SettingsManager-PVHBSCMI.js.map
+//# sourceMappingURL=SettingsManager-Y5OU5HCX.js.map

package/dist/agents/CLAUDE.md

@@ -34,11 +34,14 @@ complexity-evaluator → analyzer (or analyze-and-plan for SIMPLE) → planner
 
 ## YAML Frontmatter Format
 
+Frontmatter fields support Handlebars expressions because template substitution runs on the raw file content **before** YAML parsing. This allows conditional defaults based on execution mode (e.g., swarm vs regular).
+
 ```yaml
 ---
 name: iloom-issue-implementer
 description: One-line description of this agent's role
-model: opus          # Default model (can be overridden by settings)
+model: {{#if SWARM_MODE}}sonnet{{else}}opus{{/if}}
+{{#if SWARM_MODE}}effort: medium{{/if}}
 color: green         # Optional: terminal color for status display
 tools:               # Optional: restrict available tools
   - Read
@@ -49,15 +52,17 @@ tools:               # Optional: restrict available tools
 Agent prompt content in Markdown...
 ```
 
-## Model Override Rules
+When `SWARM_MODE` is falsy, conditional lines (like `{{#if SWARM_MODE}}effort: medium{{/if}}`) resolve to an empty line, which is ignored by the parser — the agent inherits the session default.
+
+## Model and Effort Override Rules
 
-Agent models resolve in this order (highest priority first):
+Agent models and effort resolve in this order (highest priority first):
 1. **CLI flag**: `--set agents.iloom-issue-implementer.model=sonnet`
-2. **Settings**: `settings.agents["iloom-issue-implementer"].model`
-3. **Swarm model defaults**: `SwarmSetupService` applies swarm-specific defaults (e.g., haiku for complexity evaluator)
-4. **Frontmatter**: The `model` field in the YAML above
+2. **Settings**: `settings.agents["iloom-issue-implementer"].model` / `.effort`
+3. **Swarm settings**: `settings.agents["iloom-issue-implementer"].swarmModel` / `.swarmEffort` (applied by `SwarmSetupService` in swarm mode)
+4. **Frontmatter**: The `model` / `effort` field in YAML above (which may use `{{#if SWARM_MODE}}` conditionals for mode-specific defaults)
 
-Do NOT hardcode model choices in agent templates to work around performance issues — use the settings system instead.
+Swarm-specific model and effort defaults are declared directly in agent template frontmatter using `{{#if SWARM_MODE}}` conditionals, not in hardcoded maps.
 
 ## Swarm Agent Rendering
 

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

@@ -1,7 +1,8 @@
 ---
 name: iloom-code-reviewer
 description: Use this agent to review code changes.
-model: opus
+model: {{#if SWARM_MODE}}sonnet{{else}}opus{{/if}}
+{{#if SWARM_MODE}}effort: medium{{/if}}
 color: cyan
 ---
 

package/dist/agents/iloom-framework-detector.md

@@ -3,6 +3,7 @@ name: iloom-framework-detector
 description: Use this agent to detect a project's language and framework, then generate appropriate build/test/dev scripts for non-Node.js projects. The agent creates `.iloom/package.iloom.json` with shell commands tailored to the detected stack. Use this for Python, Rust, Ruby, Go, and other non-Node.js projects that don't have a package.json.
 color: cyan
 model: opus
+effort: high
 ---
 
 You are Claude, a framework detection specialist. Your task is to analyze a project's structure and generate appropriate install/build/test/dev scripts for iloom.
@@ -60,9 +61,9 @@ If only `origin` exists (or no upstream), proceed normally with `package.iloom.j
 
 ## Core Workflow
 
-### Step 1: Scan for Language Markers
+### Step 1: Scan for Language Markers and Dockerfile
 
-Examine the project root for language-specific files:
+Examine the project root for language-specific files **and** a Dockerfile:
 
 | Marker File | Language | Package Manager |
 |-------------|----------|-----------------|
@@ -76,10 +77,11 @@ Examine the project root for language-specific files:
 | `*.csproj`, `*.sln` | C#/.NET | dotnet |
 | `Makefile` | C/C++/Generic | make |
 | `CMakeLists.txt` | C/C++ | cmake |
+| `Dockerfile` | Any (Docker) | docker |
 
 Use the `Glob` tool to check for these files:
 ```
-Glob pattern: "{Cargo.toml,requirements.txt,pyproject.toml,setup.py,Gemfile,go.mod,pom.xml,build.gradle*,Package.swift,mix.exs,*.csproj,*.sln,Makefile,CMakeLists.txt}"
+Glob pattern: "{Cargo.toml,requirements.txt,pyproject.toml,setup.py,Gemfile,go.mod,pom.xml,build.gradle*,Package.swift,mix.exs,*.csproj,*.sln,Makefile,CMakeLists.txt,Dockerfile}"
 ```
 
 ### Step 2: Detect Framework (if applicable)
@@ -107,7 +109,21 @@ For each detected language, look for framework-specific indicators:
 - `gorilla/mux` in go.mod = Gorilla Mux
 - `fiber` in go.mod = Fiber
 
-### Step 3: Generate package.iloom.json
+### Step 3: Docker Detection (Report Only)
+
+If a `Dockerfile` was found in Step 1:
+
+1. **Record the finding** — set `dockerfileFound: true` in `_metadata`
+2. **Do NOT ask the user** about Docker — you don't have access to interactive tools. The init prompt will handle that question.
+3. **Always generate a `dev` script** as normal — the init prompt will decide whether to use Docker or native mode based on the user's answer.
+
+If no `Dockerfile` was found, skip this and proceed to Step 4.
+
+**Note:** Docker Compose (`docker-compose.yml`) is not supported. Only single-container Dockerfiles are supported.
+
+---
+
+### Step 4: Generate package.iloom.json
 
 Create `.iloom/package.iloom.json` with appropriate scripts and capabilities based on detection:
 
@@ -115,6 +131,27 @@ Create `.iloom/package.iloom.json` with appropriate scripts and capabilities bas
 - `"cli"` - Include if project has CLI components (e.g., `[[bin]]` in Cargo.toml, CLI frameworks like click/typer/clap)
 - `"web"` - Include if project has web components (e.g., Flask/Django/FastAPI/Rails/Actix/Rocket)
 
+**Dockerfile Detection (from Step 3):**
+If a Dockerfile was found, include `"dockerfileFound": true` in `_metadata`. Always generate the `dev` script regardless — the init prompt will ask the user whether to use Docker and will remove the `dev` script if Docker mode is chosen.
+
+Example — web project where Dockerfile was found:
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "pip install -r requirements.txt",
+    "test": "pytest",
+    "dev": "python manage.py runserver"
+  },
+  "_metadata": {
+    "detectedLanguage": "python",
+    "detectedFramework": "django",
+    "dockerfileFound": true,
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
 **Common Patterns by Language:**
 
 #### Rust CLI
@@ -341,7 +378,7 @@ Create `.iloom/package.iloom.json` with appropriate scripts and capabilities bas
 }
 ```
 
-### Step 4: Write the File
+### Step 5: Write the File
 
 **⚠️ CHECKPOINT: Verify fork status from Step 0 before proceeding.**
 
@@ -364,9 +401,12 @@ If NOT a fork:
    - Preserve any other existing fields (like `_metadata`)
 4. **If the file does not exist:**
    - Create the full detected configuration
-5. Ensure `.iloom/` directory exists
-6. Write the merged/new JSON to the target file
-7. Report what was detected, which file was written, and what changes were made (if any)
+5. **If Dockerfile was found (from Step 3):**
+   - Add `"dockerfileFound": true` to `_metadata`
+   - Still include the `dev` script — the init prompt handles Docker mode
+6. Ensure `.iloom/` directory exists
+7. Write the merged/new JSON to the target file
+8. Report what was detected, which file was written, and what changes were made (if any)
 
 **File Selection Summary:**
 | Scenario | Target File | Reason |
@@ -387,6 +427,7 @@ Detected:
 - Framework: [framework or "None detected"]
 - Package Manager: [package manager]
 - Capabilities: [cli, web, or none]
+- Dockerfile: [Found | Not found]
 - Fork Status: [Yes (origin + upstream) | No]
 
 Created: .iloom/[package.iloom.json OR package.iloom.local.json]
@@ -398,6 +439,9 @@ Configuration:
 - test: [command]
 - dev: [command]
 
+[If Dockerfile found]: A Dockerfile was detected. The init wizard will ask whether
+                        to use Docker for the dev server.
+
 [If fork]: This configuration was saved to the LOCAL file (package.iloom.local.json)
            because you're working on a fork. This prevents your iloom settings
            from appearing in PRs to upstream.
@@ -429,6 +473,9 @@ You can customize these settings by editing .iloom/[filename].
 DO NOT:
 - Execute any build/test/dev commands
 - Install dependencies
-- Modify any files other than `.iloom/package.iloom.json`
+- Modify any files other than `.iloom/package.iloom.json` (or `.local.json` for forks)
 - Make assumptions about project-specific configuration
 - Add scripts that require additional setup not evident from the project
+- Ask the user questions — you don't have access to interactive tools. Report findings in `_metadata` and let the init prompt handle user interaction.
+- Configure Docker settings in `.iloom/settings.json` — that's the init prompt's responsibility
+- Recommend Docker for `docker-compose.yml` projects — only single-container Dockerfiles are supported

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

@@ -3,6 +3,7 @@ name: iloom-issue-analyze-and-plan
 description: Combined analysis and planning agent for SIMPLE tasks. This agent performs lightweight analysis and creates an implementation plan in one streamlined phase. Only invoked for tasks pre-classified as SIMPLE (< 5 files, <200 LOC, no breaking changes, no DB migrations). Use this agent when you have a simple issue that needs quick analysis followed by immediate planning.
 color: teal
 model: opus
+{{#if SWARM_MODE}}effort: high{{/if}}
 ---
 
 {{#if SWARM_MODE}}

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

@@ -3,6 +3,7 @@ name: iloom-issue-analyzer
 description: Use this agent when you need to analyze and research issues, bugs, or enhancement requests. The agent will investigate the codebase, recent commits, and third-party dependencies to identify root causes WITHOUT proposing solutions. Ideal for initial issue triage, regression analysis, and documenting technical findings for team discussion.\n\nExamples:\n<example>\nContext: User wants to analyze a newly reported bug in issue #42\nuser: "Please analyze issue #42 - users are reporting that the login button doesn't work on mobile"\nassistant: "I'll use the issue-analyzer agent to investigate this issue and document my findings."\n<commentary>\nSince this is a request to analyze an issue, use the Task tool to launch the issue-analyzer agent to research the problem.\n</commentary>\n</example>\n<example>\nContext: User needs to understand a regression that appeared after recent changes\nuser: "Can you look into issue #78? It seems like something broke after yesterday's deployment"\nassistant: "Let me launch the issue-analyzer agent to research this regression and identify what changed."\n<commentary>\nThe user is asking for issue analysis and potential regression investigation, so use the issue-analyzer agent.\n</commentary>\n</example>
 color: pink
 model: opus
+{{#if SWARM_MODE}}effort: high{{/if}}
 ---
 
 {{#if SWARM_MODE}}

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

@@ -3,6 +3,7 @@ name: iloom-issue-complexity-evaluator
 description: Use this agent when you need to quickly assess the complexity of an issue before deciding on the appropriate workflow. This agent performs a lightweight scan to classify issues as SIMPLE or COMPLEX based on estimated scope, risk, and impact. Runs first before any detailed analysis or planning.
 color: orange
 model: haiku
+{{#if SWARM_MODE}}effort: high{{/if}}
 ---
 
 {{#if SWARM_MODE}}

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

@@ -2,7 +2,8 @@
 name: iloom-issue-enhancer
 description: Use this agent when you need to analyze bug or enhancement reports from a Product Manager perspective. The agent accepts either an issue identifier or direct text description and creates structured specifications that enhance the original user report for development teams without performing code analysis or suggesting implementations. Ideal for triaging bugs and feature requests to prepare them for technical analysis and planning.\n\nExamples:\n<example>\nContext: User wants to triage and enhance a bug report from issue tracker\nuser: "Please analyze issue #42 - the login button doesn't work on mobile"\nassistant: "I'll use the iloom-issue-enhancer agent to analyze this bug report and create a structured specification."\n<commentary>\nSince this is a request to triage and structure a bug report from a user experience perspective, use the iloom-issue-enhancer agent.\n</commentary>\n</example>\n<example>\nContext: User needs to enhance an enhancement request that lacks detail\nuser: "Can you improve the description on issue #78? The user's request is pretty vague"\nassistant: "Let me launch the iloom-issue-enhancer agent to analyze the enhancement request and create a clear specification."\n<commentary>\nThe user is asking for enhancement report structuring, so use the iloom-issue-enhancer agent.\n</commentary>\n</example>\n<example>\nContext: User provides direct description without issue identifier\nuser: "Analyze this bug: Users report that the search function returns no results when they include special characters like & or # in their query"\nassistant: "I'll use the iloom-issue-enhancer agent to create a structured specification for this bug report."\n<commentary>\nEven though no issue identifier was provided, the iloom-issue-enhancer agent can analyze the direct description and create a structured specification.\n</commentary>\n</example>\n<example>\nContext: An issue has been labeled as a valid baug and needs structured analysis\nuser: "Structure issue #123 that was just labeled as a triaged bug"\nassistant: "I'll use the iloom-issue-enhancer agent to create a comprehensive bug specification."\n<commentary>\nThe issue needs Product Manager-style analysis and structuring, so use the iloom-issue-enhancer agent.\n</commentary>\n</example>
 color: purple
-model: opus
+model: {{#if SWARM_MODE}}sonnet{{else}}opus{{/if}}
+{{#if SWARM_MODE}}effort: medium{{/if}}
 ---
 
 {{#if SWARM_MODE}}

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

@@ -1,7 +1,8 @@
 ---
 name: iloom-issue-implementer
 description: Use this agent when you need to implement an issue exactly as specified in its comments and description. This agent reads issue details, follows implementation plans precisely, and ensures all code passes tests, typechecking, and linting before completion. Examples:\n\n<example>\nContext: User wants to implement a specific issue.\nuser: "Please implement issue #42"\nassistant: "I'll use the issue-implementer agent to read and implement issue #42 exactly as specified."\n<commentary>\nSince the user is asking to implement an issue, use the Task tool to launch the issue-implementer agent.\n</commentary>\n</example>\n\n<example>\nContext: User references an issue that needs implementation.\nuser: "Can you work on the authentication issue we discussed in #15?"\nassistant: "Let me launch the issue-implementer agent to read issue #15 and implement it according to the plan in the comments."\n<commentary>\nThe user is referencing a specific issue number, so use the issue-implementer agent to handle the implementation.\n</commentary>\n</example>
-model: opus
+model: {{#if SWARM_MODE}}sonnet{{else}}opus{{/if}}
+{{#if SWARM_MODE}}effort: medium{{/if}}
 color: green
 ---
 
@@ -43,6 +44,8 @@ After creating or updating any issue comment, use the Recap MCP tools:
 
 This enables the recap panel to show quick-reference links to artifacts created during the session.
 
+**Do NOT log `fix` recap entries** — the orchestrator tracks which review findings were addressed.
+
 {{#if SWARM_MODE}}
 **IMPORTANT**: You are running inline in a swarm worker's context. You MUST pass `worktreePath` on ALL recap calls (`add_artifact`, `add_entry`, `set_loom_state`, `get_recap`). The worktree path is provided by the caller — look for it in your invocation prompt (e.g., "Your worktree path is ..."). Without `worktreePath`, recap entries go to the epic's recap file instead of the child's.
 {{/if}}

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

@@ -2,7 +2,8 @@
 name: iloom-issue-planner
 description: Use this agent when you need to analyze issues and create detailed implementation plans. This agent specializes in reading issue context, understanding requirements, and creating focused implementation plans with specific file changes and line numbers. The agent will document the plan as a comment on the issue without executing any changes. Examples: <example>Context: The user wants detailed implementation planning for an issue.\nuser: "Analyze issue #42 and create an implementation plan"\nassistant: "I'll use the issue-planner agent to analyze the issue and create a detailed implementation plan"\n<commentary>Since the user wants issue analysis and implementation planning, use the issue-planner agent.</commentary></example> <example>Context: The user needs a plan for implementing a feature described in an issue.\nuser: "Read issue #15 and plan out what needs to be changed"\nassistant: "Let me use the issue-planner agent to analyze the issue and document a comprehensive implementation plan"\n<commentary>The user needs issue analysis and planning, so the issue-planner agent is the right choice.</commentary></example>
 color: blue
-model: opus
+model: {{#if SWARM_MODE}}sonnet{{else}}opus{{/if}}
+{{#if SWARM_MODE}}effort: high{{/if}}
 ---
 
 {{#if SWARM_MODE}}

package/dist/agents/iloom-wave-verifier.md

@@ -2,6 +2,7 @@
 name: iloom-wave-verifier
 description: Wave verification agent that checks must-have criteria from child issues after each swarm wave, invokes fix skills for failures, and reports structured results.\n\nExamples:\n<example>\nContext: Orchestrator wants to verify that wave 1 work meets acceptance criteria\nuser: "Verify must-haves for issues #101, #102, #103 from wave 1"\nassistant: "I'll check all must-have criteria from those issues against the codebase and report results."\n<commentary>\nThe orchestrator needs wave verification after a completed wave, so use the iloom-wave-verifier agent.\n</commentary>\n</example>\n<example>\nContext: Swarm orchestrator needs to gate the next wave on verification passing\nuser: "Run wave verification for child issues #45, #46 before proceeding to wave 2"\nassistant: "I'll verify all must-haves for the specified issues, fix any failures, and return a structured report."\n<commentary>\nWave gating requires verification of completed work, so use the iloom-wave-verifier agent.\n</commentary>\n</example>
 model: opus
+effort: high
 color: red
 ---
 

package/dist/{build-2FXDYEZQ.js → build-NJJT6UHO.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   ScriptCommandBase
-} from "./chunk-DMNI225H.js";
-import "./chunk-XC5JKRSH.js";
+} from "./chunk-SM2YM3YR.js";
+import "./chunk-6RKZDUTQ.js";
 import "./chunk-OLJ54WGW.js";
-import "./chunk-D6FU4DLN.js";
+import "./chunk-LULQYBRA.js";
 import "./chunk-K3QGG4O2.js";
-import "./chunk-5W44AI63.js";
-import "./chunk-MNPKEWBQ.js";
-import "./chunk-XIVLGWUX.js";
+import "./chunk-6FHFHMNF.js";
+import "./chunk-UVZBZ5IF.js";
+import "./chunk-JDXJIPXR.js";
 import "./chunk-FTYWGQFM.js";
 import "./chunk-VRPPI6GU.js";
 
@@ -24,4 +24,4 @@ var BuildCommand = class extends ScriptCommandBase {
 export {
   BuildCommand
 };
-//# sourceMappingURL=build-2FXDYEZQ.js.map
+//# sourceMappingURL=build-NJJT6UHO.js.map

package/dist/{chunk-VUIPDX3T.js → chunk-27CQSBUG.js}

@@ -38,7 +38,7 @@ import {
 } from "./chunk-KV4NU3RP.js";
 import {
   SettingsManager
-} from "./chunk-MNPKEWBQ.js";
+} from "./chunk-UVZBZ5IF.js";
 import {
   logger
 } from "./chunk-VRPPI6GU.js";
@@ -1436,4 +1436,4 @@ var IssueManagementProviderFactory = class {
 export {
   IssueManagementProviderFactory
 };
-//# sourceMappingURL=chunk-VUIPDX3T.js.map
+//# sourceMappingURL=chunk-27CQSBUG.js.map

package/dist/{chunk-YVNG35OW.js → chunk-2Z4VKQND.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   extractIssueNumber
-} from "./chunk-5W44AI63.js";
+} from "./chunk-6FHFHMNF.js";
 import {
   extractPort,
   findEnvFileContainingVariable,
@@ -113,4 +113,4 @@ export {
   calculatePortFromIdentifier,
   getWorkspacePort
 };
-//# sourceMappingURL=chunk-YVNG35OW.js.map
+//# sourceMappingURL=chunk-2Z4VKQND.js.map

package/dist/{chunk-UQWMPQ2Q.js → chunk-4QROZMPZ.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   findMainWorktreePathWithSettings
-} from "./chunk-5W44AI63.js";
+} from "./chunk-6FHFHMNF.js";
 import {
   MetadataManager
-} from "./chunk-XIVLGWUX.js";
+} from "./chunk-JDXJIPXR.js";
 import {
   getLogger
 } from "./chunk-FTYWGQFM.js";
@@ -70,4 +70,4 @@ export {
   archiveRecap,
   findArchivedRecap
 };
-//# sourceMappingURL=chunk-UQWMPQ2Q.js.map
+//# sourceMappingURL=chunk-4QROZMPZ.js.map

package/dist/{chunk-U2OPXZ6E.js → chunk-5NVJ6N3C.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-NXMDEL3F.js";
 import {
   VCSProviderFactory
-} from "./chunk-L3P3YJCE.js";
+} from "./chunk-RLFS5KHU.js";
 import {
   TelemetryService
 } from "./chunk-MY2Q3FJ3.js";
 import {
   resolveRecapFilePath
-} from "./chunk-CQHHEW2M.js";
+} from "./chunk-5WJN63T4.js";
 import {
   IssueManagementProviderFactory
-} from "./chunk-VUIPDX3T.js";
+} from "./chunk-27CQSBUG.js";
 import {
   PromptTemplateManager
 } from "./chunk-LDE6VNG5.js";
@@ -23,13 +23,13 @@ import {
 import {
   generateDeterministicSessionId,
   launchClaude
-} from "./chunk-DDHWZNGL.js";
+} from "./chunk-MB4CB7Q4.js";
 import {
   SettingsManager
-} from "./chunk-MNPKEWBQ.js";
+} from "./chunk-UVZBZ5IF.js";
 import {
   MetadataManager
-} from "./chunk-XIVLGWUX.js";
+} from "./chunk-JDXJIPXR.js";
 import {
   getLogger
 } from "./chunk-FTYWGQFM.js";
@@ -617,4 +617,4 @@ var SessionSummaryService = class {
 export {
   SessionSummaryService
 };
-//# sourceMappingURL=chunk-U2OPXZ6E.js.map
+//# sourceMappingURL=chunk-5NVJ6N3C.js.map