@iloom/cli 0.3.4 → 0.4.1

package/README.md

@@ -51,7 +51,9 @@ iloom stops the "Context Window Tetris." It treats context as a first-class conc
 *   **Scale Understanding:** Because every loom holds its own isolated environment (Git worktree, DB branch, local server), you can switch between 5 complex features without losing your place or your AI's context.
     
 *   **Visible Reasoning:** The AI's decisions are documented publicly. Your team sees the plan, and "future you" knows exactly why a decision was made.
-    
+
+*   **Automatic Session Summaries:** When you finish a loom, iloom captures key insights, decisions, and lessons learned from your Claude session and posts them to the issue. These summaries become institutional knowledge that informs future tasks.
+
 
 _iloom is not just a tool for managing git worktrees - it's a control plane for maintaining alignment between you and your AI assistant._
 
@@ -73,8 +75,8 @@ iloom uses your existing Claude subscription to build a shared mental model of y
 
  # ... You, the iloom agents and Claude build the feature together in the isolated environment ...
  
- # 4. Finish & Merge  # Validates code (test/lint), handles merge conflicts, and cleans up the worktree/DB.
- il finish 
+ # 4. Finish & Merge  # Validates code, generates session summary, merges, and cleans up.
+ il finish
  ```
 
 **The iloom Difference:** il start doesn't just create a branch. It launches a multi-agent workflow that surfaces assumptions and creates a structured plan in your issue tracker **before you even need to look at your IDE.**
@@ -138,8 +140,10 @@ Command Reference
 | `il finish` | `dn` | Validate tests/lint, commit, handle conflicts, and merge/PR. |
 | `il cleanup` | `remove` | Safely remove a loom and its database branch without merging. |
 | `il list` |  | Show active looms and paths. |
+| `il projects` |  | List configured projects (JSON output). |
 | `il spin` |  | Launch Claude inside the current loom with context auto-detected. |
 | `il open` | `run` | Open loom in browser (web) or run your CLI tool. |
+| `il dev-server` | `dev` | Start dev server in foreground for a workspace. |
 | `il add-issue` | `a` | Create and AI-enhance a new issue without starting work yet. |
 | `il init` | `config` | Interactive configuration wizard. |
 | `il feedback` | `f` | Submit bug reports/feedback directly from the CLI. |
@@ -218,6 +222,12 @@ This example shows how to configure a project-wide default (e.g., GitHub remote)
     "issue": {
       "permissionMode": "acceptEdits" // Control Claude Code permissions
     }
+  },
+  "spin": {
+    "model": "opus" // Claude model for spin orchestrator: opus (default), sonnet, or haiku
+  },
+  "summary": {
+    "model": "sonnet" // Claude model for session summaries: sonnet (default), opus, or haiku
   }
 }
 ```

package/dist/{BranchNamingService-A77VI6AI.js → BranchNamingService-GCCWB3LK.js}

@@ -3,11 +3,12 @@ import {
   ClaudeBranchNameStrategy,
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
-} from "./chunk-SUOXY5WJ.js";
-import "./chunk-GEHQXLEI.js";
+} from "./chunk-QIUJPPJQ.js";
+import "./chunk-6UIGZD2N.js";
+import "./chunk-UYVWLISQ.js";
 export {
   ClaudeBranchNameStrategy,
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
 };
-//# sourceMappingURL=BranchNamingService-A77VI6AI.js.map
+//# sourceMappingURL=BranchNamingService-GCCWB3LK.js.map

package/dist/ClaudeContextManager-DK77227F.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  ClaudeContextManager
+} from "./chunk-UPUAQYAW.js";
+import "./chunk-POI7KLBH.js";
+import "./chunk-VWNS6DH5.js";
+import "./chunk-RUC7OULH.js";
+import "./chunk-VAYGNQTE.js";
+import "./chunk-Z5NXYJIG.js";
+import "./chunk-6UIGZD2N.js";
+import "./chunk-74VMN2KC.js";
+import "./chunk-UYVWLISQ.js";
+export {
+  ClaudeContextManager
+};
+//# sourceMappingURL=ClaudeContextManager-DK77227F.js.map

package/dist/ClaudeService-W3SA7HVG.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import {
+  ClaudeService
+} from "./chunk-POI7KLBH.js";
+import "./chunk-VWNS6DH5.js";
+import "./chunk-RUC7OULH.js";
+import "./chunk-VAYGNQTE.js";
+import "./chunk-Z5NXYJIG.js";
+import "./chunk-6UIGZD2N.js";
+import "./chunk-74VMN2KC.js";
+import "./chunk-UYVWLISQ.js";
+export {
+  ClaudeService
+};
+//# sourceMappingURL=ClaudeService-W3SA7HVG.js.map

package/dist/GitHubService-RPM27GWD.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  GitHubService
+} from "./chunk-OEGECBFS.js";
+import "./chunk-KO2FOMHL.js";
+import "./chunk-SJ2GZ6RF.js";
+import "./chunk-6UIGZD2N.js";
+import "./chunk-UYVWLISQ.js";
+export {
+  GitHubService
+};
+//# sourceMappingURL=GitHubService-RPM27GWD.js.map

package/dist/{LoomLauncher-ZV3ZZIBA.js → LoomLauncher-S3YGJRJQ.js}

@@ -1,29 +1,35 @@
 #!/usr/bin/env node
 import {
   getDevServerLaunchCommand
-} from "./chunk-ZM3CFL5L.js";
-import "./chunk-ZT3YZB4K.js";
+} from "./chunk-QRBOPFAA.js";
+import "./chunk-VBFDVGAE.js";
 import {
   ClaudeContextManager
-} from "./chunk-AKUJXDNW.js";
-import "./chunk-PGPI5LR4.js";
-import "./chunk-RIEO2WML.js";
-import "./chunk-CDZERT7Z.js";
+} from "./chunk-UPUAQYAW.js";
+import "./chunk-POI7KLBH.js";
+import {
+  getExecutablePath
+} from "./chunk-GYCR2LOU.js";
+import "./chunk-VWNS6DH5.js";
 import {
   generateColorFromBranchName,
   hexToRgb
-} from "./chunk-CFFQ2Z7A.js";
-import "./chunk-OYF4VIFI.js";
+} from "./chunk-WUQQNE63.js";
+import "./chunk-RUC7OULH.js";
 import {
   openMultipleTerminalWindows,
   openTerminalWindow
-} from "./chunk-RW54ZMBM.js";
+} from "./chunk-VAYGNQTE.js";
 import {
   getDotenvFlowFiles
-} from "./chunk-UJL4HI2R.js";
+} from "./chunk-Z5NXYJIG.js";
+import {
+  getLogger
+} from "./chunk-6UIGZD2N.js";
+import "./chunk-74VMN2KC.js";
 import {
   logger
-} from "./chunk-GEHQXLEI.js";
+} from "./chunk-UYVWLISQ.js";
 
 // src/lib/LoomLauncher.ts
 import { existsSync } from "fs";
@@ -102,10 +108,10 @@ var LoomLauncher = class {
    */
   async launchLoom(options) {
     const { enableClaude, enableCode, enableDevServer, enableTerminal } = options;
-    logger.debug(`Launching loom components: Claude=${enableClaude}, Code=${enableCode}, DevServer=${enableDevServer}, Terminal=${enableTerminal}`);
+    getLogger().debug(`Launching loom components: Claude=${enableClaude}, Code=${enableCode}, DevServer=${enableDevServer}, Terminal=${enableTerminal}`);
     const launchPromises = [];
     if (enableCode) {
-      logger.debug("Launching VSCode");
+      getLogger().debug("Launching VSCode");
       launchPromises.push(this.launchVSCode(options));
     }
     const terminalsToLaunch = [];
@@ -128,7 +134,7 @@ var LoomLauncher = class {
       });
     }
     if (terminalsToLaunch.length > 1) {
-      logger.debug(`Launching ${terminalsToLaunch.length} terminals in single window`);
+      getLogger().debug(`Launching ${terminalsToLaunch.length} terminals in single window`);
       launchPromises.push(this.launchMultipleTerminals(terminalsToLaunch, options));
     } else if (terminalsToLaunch.length === 1) {
       const terminal = terminalsToLaunch[0];
@@ -136,7 +142,7 @@ var LoomLauncher = class {
         throw new Error("Terminal configuration is undefined");
       }
       const terminalType = terminal.type;
-      logger.debug(`Launching single ${terminalType} terminal`);
+      getLogger().debug(`Launching single ${terminalType} terminal`);
       if (terminalType === "claude") {
         launchPromises.push(this.launchClaudeTerminal(options));
       } else if (terminalType === "devServer") {
@@ -146,7 +152,7 @@ var LoomLauncher = class {
       }
     }
     await Promise.all(launchPromises);
-    logger.success("loom launched successfully");
+    getLogger().success("loom launched successfully");
   }
   /**
    * Launch IDE (VSCode or configured alternative)
@@ -155,7 +161,7 @@ var LoomLauncher = class {
     var _a;
     const ideConfig = await ((_a = this.settings) == null ? void 0 : _a.loadSettings().then((s) => s.ide));
     await openIdeWindow(options.worktreePath, ideConfig);
-    logger.info("IDE opened");
+    getLogger().info("IDE opened");
   }
   /**
    * Launch Claude terminal
@@ -172,7 +178,7 @@ var LoomLauncher = class {
       ...options.setArguments && { setArguments: options.setArguments },
       ...options.executablePath && { executablePath: options.executablePath }
     });
-    logger.info("Claude terminal opened");
+    getLogger().info("Claude terminal opened");
   }
   /**
    * Launch dev server terminal
@@ -192,21 +198,26 @@ var LoomLauncher = class {
       includePortExport: options.capabilities.includes("web"),
       ...options.port !== void 0 && { port: options.port }
     });
-    logger.info("Dev server terminal opened");
+    getLogger().info("Dev server terminal opened");
   }
   /**
-   * Launch standalone terminal (no command, just workspace with env vars)
+   * Launch standalone terminal running `il shell <identifier>`
    */
   async launchStandaloneTerminal(options) {
+    const executable = options.executablePath ?? getExecutablePath();
+    const shellIdentifier = String(options.identifier);
+    const shellCommand = `${executable} shell ${shellIdentifier}`;
     const backgroundColor = options.colorTerminal ?? true ? options.colorHex ? hexToRgb(options.colorHex) : generateColorFromBranchName(options.branchName).rgb : void 0;
     await openTerminalWindow({
       workspacePath: options.worktreePath,
+      command: shellCommand,
       ...backgroundColor && { backgroundColor },
-      includeEnvSetup: (options.sourceEnvOnStart ?? false) && this.hasAnyEnvFiles(options.worktreePath),
+      // il shell handles env loading internally, so we don't need includeEnvSetup
+      includeEnvSetup: false,
       includePortExport: options.capabilities.includes("web"),
       ...options.port !== void 0 && { port: options.port }
     });
-    logger.info("Standalone terminal opened");
+    getLogger().info("Standalone terminal opened");
   }
   /**
    * Build terminal options for Claude
@@ -257,17 +268,22 @@ var LoomLauncher = class {
     };
   }
   /**
-   * Build terminal options for standalone terminal (no command)
+   * Build terminal options for standalone terminal
+   * Runs `il shell <identifier>` which handles env loading internally
    */
   buildStandaloneTerminalOptions(options) {
-    const hasEnvFile = this.hasAnyEnvFiles(options.worktreePath);
     const terminalTitle = `Terminal - ${this.formatIdentifier(options.workflowType, options.identifier)}`;
+    const executable = options.executablePath ?? getExecutablePath();
+    const shellIdentifier = String(options.identifier);
+    const shellCommand = `${executable} shell ${shellIdentifier}`;
     const backgroundColor = options.colorTerminal ?? true ? options.colorHex ? hexToRgb(options.colorHex) : generateColorFromBranchName(options.branchName).rgb : void 0;
     return {
       workspacePath: options.worktreePath,
+      command: shellCommand,
       ...backgroundColor && { backgroundColor },
       title: terminalTitle,
-      includeEnvSetup: (options.sourceEnvOnStart ?? false) && hasEnvFile,
+      // il shell handles env loading internally, so we don't need includeEnvSetup
+      includeEnvSetup: false,
       includePortExport: options.capabilities.includes("web"),
       ...options.port !== void 0 && { port: options.port }
     };
@@ -279,7 +295,7 @@ var LoomLauncher = class {
     const terminalOptions = terminals.map((t) => t.options);
     await openMultipleTerminalWindows(terminalOptions);
     const terminalTypes = terminals.map((t) => t.type).join(" + ");
-    logger.info(`Multiple terminals opened: ${terminalTypes}`);
+    getLogger().info(`Multiple terminals opened: ${terminalTypes}`);
   }
   /**
    * Check if any dotenv-flow files exist in the workspace
@@ -305,4 +321,4 @@ var LoomLauncher = class {
 export {
   LoomLauncher
 };
-//# sourceMappingURL=LoomLauncher-ZV3ZZIBA.js.map
+//# sourceMappingURL=LoomLauncher-S3YGJRJQ.js.map

package/dist/LoomLauncher-S3YGJRJQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/LoomLauncher.ts","../src/utils/ide.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 { getDevServerLaunchCommand } from '../utils/dev-server.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}\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: await 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 */\n\tprivate async launchDevServerTerminal(options: LaunchLoomOptions): Promise<void> {\n\t\tconst devServerCommand = await getDevServerLaunchCommand(\n\t\t\toptions.worktreePath,\n\t\t\toptions.port,\n\t\t\toptions.capabilities\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\tawait openTerminalWindow({\n\t\t\tworkspacePath: options.worktreePath,\n\t\t\tcommand: devServerCommand,\n\t\t\t...(backgroundColor && { backgroundColor }),\n\t\t\tincludeEnvSetup: (options.sourceEnvOnStart ?? false) && this.hasAnyEnvFiles(options.worktreePath),\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\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 */\n\tprivate async buildDevServerTerminalOptions(\n\t\toptions: LaunchLoomOptions\n\t): Promise<TerminalWindowOptions> {\n\t\tconst devServerCommand = await getDevServerLaunchCommand(\n\t\t\toptions.worktreePath,\n\t\t\toptions.port,\n\t\t\toptions.capabilities\n\t\t)\n\t\tconst hasEnvFile = this.hasAnyEnvFiles(options.worktreePath)\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\tincludeEnvSetup: (options.sourceEnvOnStart ?? false) && hasEnvFile,\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","import { execa } from 'execa'\nimport { logger } from './logger.js'\nimport type { IdeSettings } from '../lib/SettingsManager.js'\n\n// IDE preset configuration\nconst IDE_PRESETS = {\n\tvscode: { command: 'code', name: 'Visual Studio Code', args: [] },\n\tcursor: { command: 'cursor', name: 'Cursor', args: [] },\n\twebstorm: { command: 'webstorm', name: 'WebStorm', args: ['--nosplash'] },\n\tsublime: { command: 'subl', name: 'Sublime Text', args: [] },\n\tintellij: { command: 'idea', name: 'IntelliJ IDEA', args: ['--nosplash'] },\n\twindsurf: { command: 'surf', name: 'Windsurf', args: [] },\n\tantigravity: { command: 'agy', name: 'Antigravity', args: [] },\n} as const\n\ntype IdePreset = keyof typeof IDE_PRESETS\n\n// Resolve IDE configuration to command and args\nexport function getIdeConfig(ideSettings?: IdeSettings): {\n\tcommand: string\n\targs: string[]\n\tname: string\n} {\n\t// Default to vscode if not configured\n\tconst type = ideSettings?.type ?? 'vscode'\n\n\tconst preset = IDE_PRESETS[type as IdePreset]\n\treturn {\n\t\tcommand: preset.command,\n\t\targs: [...preset.args],\n\t\tname: preset.name,\n\t}\n}\n\n// Check if IDE is available\nexport async function isIdeAvailable(command: string): Promise<boolean> {\n\ttry {\n\t\tawait execa('command', ['-v', command], { shell: true, timeout: 5000 })\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n\n// Get installation hint for IDE\nfunction getInstallHint(type: string): string {\n\tconst hints: Record<string, string> = {\n\t\tvscode:\n\t\t\t'Install command-line tools: Open VSCode > Command Palette > \"Shell Command: Install \\'code\\' command in PATH\"',\n\t\tcursor:\n\t\t\t'Install command-line tools: Open Cursor > Command Palette > \"Install \\'cursor\\' command in PATH\"',\n\t\twebstorm: 'Install via JetBrains Toolbox > Settings > Shell Scripts > Enable',\n\t\tsublime:\n\t\t\t'Create symlink: ln -s \"/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl\" /usr/local/bin/subl',\n\t\tintellij: 'Install via JetBrains Toolbox > Settings > Shell Scripts > Enable',\n\t\twindsurf:\n\t\t\t'Install command-line tools during Windsurf installation or create symlink manually',\n\t\tantigravity:\n\t\t\t'Install command-line tools during Antigravity installation or create symlink manually',\n\t}\n\treturn hints[type] ?? `Ensure the IDE command is available in your PATH`\n}\n\n// Open IDE window for workspace\nexport async function openIdeWindow(\n\tworkspacePath: string,\n\tideSettings?: IdeSettings\n): Promise<void> {\n\tconst config = getIdeConfig(ideSettings)\n\tconst available = await isIdeAvailable(config.command)\n\n\tif (!available) {\n\t\tconst type = ideSettings?.type ?? 'vscode'\n\t\tthrow new Error(\n\t\t\t`${config.name} is not available. The \"${config.command}\" command was not found in PATH.\\n` +\n\t\t\t\tgetInstallHint(type)\n\t\t)\n\t}\n\n\ttry {\n\t\tawait execa(config.command, [...config.args, workspacePath])\n\t\tlogger.debug(`Opened ${config.name} for workspace: ${workspacePath}`)\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Failed to open ${config.name}: ${error instanceof Error ? error.message : 'Unknown error'}`\n\t\t)\n\t}\n}\n"],"mappings":"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","names":[]}

package/dist/PromptTemplateManager-2TDZAUC6.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  PromptTemplateManager
+} from "./chunk-74VMN2KC.js";
+import "./chunk-UYVWLISQ.js";
+export {
+  PromptTemplateManager
+};
+//# sourceMappingURL=PromptTemplateManager-2TDZAUC6.js.map

package/dist/README.md

@@ -51,7 +51,9 @@ iloom stops the "Context Window Tetris." It treats context as a first-class conc
 *   **Scale Understanding:** Because every loom holds its own isolated environment (Git worktree, DB branch, local server), you can switch between 5 complex features without losing your place or your AI's context.
     
 *   **Visible Reasoning:** The AI's decisions are documented publicly. Your team sees the plan, and "future you" knows exactly why a decision was made.
-    
+
+*   **Automatic Session Summaries:** When you finish a loom, iloom captures key insights, decisions, and lessons learned from your Claude session and posts them to the issue. These summaries become institutional knowledge that informs future tasks.
+
 
 _iloom is not just a tool for managing git worktrees - it's a control plane for maintaining alignment between you and your AI assistant._
 
@@ -73,8 +75,8 @@ iloom uses your existing Claude subscription to build a shared mental model of y
 
  # ... You, the iloom agents and Claude build the feature together in the isolated environment ...
  
- # 4. Finish & Merge  # Validates code (test/lint), handles merge conflicts, and cleans up the worktree/DB.
- il finish 
+ # 4. Finish & Merge  # Validates code, generates session summary, merges, and cleans up.
+ il finish
  ```
 
 **The iloom Difference:** il start doesn't just create a branch. It launches a multi-agent workflow that surfaces assumptions and creates a structured plan in your issue tracker **before you even need to look at your IDE.**
@@ -138,8 +140,10 @@ Command Reference
 | `il finish` | `dn` | Validate tests/lint, commit, handle conflicts, and merge/PR. |
 | `il cleanup` | `remove` | Safely remove a loom and its database branch without merging. |
 | `il list` |  | Show active looms and paths. |
+| `il projects` |  | List configured projects (JSON output). |
 | `il spin` |  | Launch Claude inside the current loom with context auto-detected. |
 | `il open` | `run` | Open loom in browser (web) or run your CLI tool. |
+| `il dev-server` | `dev` | Start dev server in foreground for a workspace. |
 | `il add-issue` | `a` | Create and AI-enhance a new issue without starting work yet. |
 | `il init` | `config` | Interactive configuration wizard. |
 | `il feedback` | `f` | Submit bug reports/feedback directly from the CLI. |
@@ -218,6 +222,12 @@ This example shows how to configure a project-wide default (e.g., GitHub remote)
     "issue": {
       "permissionMode": "acceptEdits" // Control Claude Code permissions
     }
+  },
+  "spin": {
+    "model": "opus" // Claude model for spin orchestrator: opus (default), sonnet, or haiku
+  },
+  "summary": {
+    "model": "sonnet" // Claude model for session summaries: sonnet (default), opus, or haiku
   }
 }
 ```

package/dist/{SettingsManager-I2LRCW2A.js → SettingsManager-FJFU6JJD.js}

@@ -8,12 +8,14 @@ import {
   IloomSettingsSchemaNoDefaults,
   NeonSettingsSchema,
   SettingsManager,
+  SpinAgentSettingsSchema,
+  SummarySettingsSchema,
   WorkflowPermissionSchema,
   WorkflowPermissionSchemaNoDefaults,
   WorkflowsSettingsSchema,
   WorkflowsSettingsSchemaNoDefaults
-} from "./chunk-CDZERT7Z.js";
-import "./chunk-GEHQXLEI.js";
+} from "./chunk-VWNS6DH5.js";
+import "./chunk-UYVWLISQ.js";
 export {
   AgentSettingsSchema,
   CapabilitiesSettingsSchema,
@@ -23,9 +25,11 @@ export {
   IloomSettingsSchemaNoDefaults,
   NeonSettingsSchema,
   SettingsManager,
+  SpinAgentSettingsSchema,
+  SummarySettingsSchema,
   WorkflowPermissionSchema,
   WorkflowPermissionSchemaNoDefaults,
   WorkflowsSettingsSchema,
   WorkflowsSettingsSchemaNoDefaults
 };
-//# sourceMappingURL=SettingsManager-I2LRCW2A.js.map
+//# sourceMappingURL=SettingsManager-FJFU6JJD.js.map

package/dist/SettingsMigrationManager-EH3J2TCN.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  SettingsMigrationManager
+} from "./chunk-UYWAESOT.js";
+import "./chunk-SJ2GZ6RF.js";
+import "./chunk-UYVWLISQ.js";
+export {
+  SettingsMigrationManager
+};
+//# sourceMappingURL=SettingsMigrationManager-EH3J2TCN.js.map

package/dist/{chunk-5Q3NDNNV.js → chunk-2W2FBL5G.js}

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
+import {
+  MetadataManager
+} from "./chunk-IJ7IGJT3.js";
 import {
   SettingsManager
-} from "./chunk-CDZERT7Z.js";
+} from "./chunk-VWNS6DH5.js";
 import {
   logger
-} from "./chunk-GEHQXLEI.js";
+} from "./chunk-UYVWLISQ.js";
 
 // src/utils/git.ts
 import path from "path";
@@ -16,7 +19,9 @@ async function executeGitCommand(args, options) {
       timeout: (options == null ? void 0 : options.timeout) ?? 3e4,
       encoding: "utf8",
       stdio: (options == null ? void 0 : options.stdio) ?? "pipe",
-      verbose: logger.isDebugEnabled()
+      verbose: logger.isDebugEnabled(),
+      // Spread env conditionally - only include if defined
+      ...(options == null ? void 0 : options.env) && { env: options.env }
     });
     return result.stdout;
   } catch (error) {
@@ -304,6 +309,27 @@ async function findMainWorktreePathWithSettings(path2, settingsManager) {
   const findOptions = settings.mainBranch ? { mainBranch: settings.mainBranch } : void 0;
   return findMainWorktreePath(path2, findOptions);
 }
+async function findWorktreeForBranch(branchName, path2 = process.cwd()) {
+  try {
+    const output = await executeGitCommand(["worktree", "list", "--porcelain"], { cwd: path2 });
+    const worktrees = parseWorktreeList(output, branchName);
+    if (worktrees.length === 0) {
+      throw new Error("No worktrees found in repository");
+    }
+    const targetWorktree = worktrees.find((wt) => wt.branch === branchName);
+    if (!(targetWorktree == null ? void 0 : targetWorktree.path)) {
+      throw new Error(
+        `No worktree found with branch '${branchName}' checked out. Available worktrees: ${worktrees.map((wt) => `${wt.path} (${wt.branch})`).join(", ")}`
+      );
+    }
+    return targetWorktree.path;
+  } catch (error) {
+    if (error instanceof Error && (error.message.includes("No worktree found with branch") || error.message.includes("No worktrees found"))) {
+      throw error;
+    }
+    throw new Error(`Failed to find worktree for branch '${branchName}': ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
 async function hasUncommittedChanges(path2 = process.cwd()) {
   try {
     const result = await executeGitCommand(["status", "--porcelain"], { cwd: path2 });
@@ -332,7 +358,7 @@ async function getDefaultBranch(path2 = process.cwd()) {
 }
 async function findAllBranchesForIssue(issueNumber, path2 = process.cwd(), settingsManager) {
   if (!settingsManager) {
-    const { SettingsManager: SM } = await import("./SettingsManager-I2LRCW2A.js");
+    const { SettingsManager: SM } = await import("./SettingsManager-FJFU6JJD.js");
     settingsManager = new SM();
   }
   const protectedBranches = await settingsManager.getProtectedBranches(path2);
@@ -472,6 +498,122 @@ async function isFileGitignored(filePath, cwd = process.cwd()) {
     return false;
   }
 }
+async function isBranchMergedIntoMain(branchName, mainBranch = "main", cwd = process.cwd()) {
+  try {
+    await executeGitCommand(["merge-base", "--is-ancestor", branchName, mainBranch], { cwd });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function isRemoteBranchUpToDate(branchName, cwd) {
+  try {
+    const remoteResult = await executeGitCommand(["ls-remote", "--heads", "origin", branchName], { cwd });
+    if (remoteResult.trim().length === 0) {
+      return false;
+    }
+    const remoteCommit = remoteResult.trim().split("	")[0];
+    const localCommit = await executeGitCommand(["rev-parse", branchName], { cwd });
+    return localCommit.trim() === remoteCommit;
+  } catch {
+    return false;
+  }
+}
+async function checkRemoteBranchStatus(branchName, cwd) {
+  try {
+    try {
+      await executeGitCommand(["fetch", "origin", branchName], { cwd, timeout: 3e4 });
+    } catch (fetchError) {
+      const fetchErrorMessage = fetchError instanceof Error ? fetchError.message : String(fetchError);
+      if (fetchErrorMessage.includes("Could not resolve host") || fetchErrorMessage.includes("unable to access") || fetchErrorMessage.includes("network") || fetchErrorMessage.includes("Connection refused") || fetchErrorMessage.includes("Connection timed out")) {
+        return {
+          exists: false,
+          remoteAhead: false,
+          localAhead: false,
+          networkError: true,
+          errorMessage: fetchErrorMessage
+        };
+      }
+    }
+    const remoteResult = await executeGitCommand(["ls-remote", "--heads", "origin", branchName], { cwd });
+    if (remoteResult.trim().length === 0) {
+      return {
+        exists: false,
+        remoteAhead: false,
+        localAhead: false,
+        networkError: false
+      };
+    }
+    const remoteCommit = remoteResult.trim().split("	")[0];
+    if (!remoteCommit) {
+      return {
+        exists: false,
+        remoteAhead: false,
+        localAhead: false,
+        networkError: false
+      };
+    }
+    const localCommit = await executeGitCommand(["rev-parse", branchName], { cwd });
+    const localCommitTrimmed = localCommit.trim();
+    if (remoteCommit === localCommitTrimmed) {
+      return {
+        exists: true,
+        remoteAhead: false,
+        localAhead: false,
+        networkError: false
+      };
+    }
+    try {
+      await executeGitCommand(["merge-base", "--is-ancestor", localCommitTrimmed, remoteCommit], { cwd });
+      return {
+        exists: true,
+        remoteAhead: true,
+        localAhead: false,
+        networkError: false
+      };
+    } catch {
+      return {
+        exists: true,
+        remoteAhead: false,
+        localAhead: true,
+        networkError: false
+      };
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    if (errorMessage.includes("Could not resolve host") || errorMessage.includes("unable to access") || errorMessage.includes("network") || errorMessage.includes("Connection refused") || errorMessage.includes("Connection timed out")) {
+      return {
+        exists: false,
+        remoteAhead: false,
+        localAhead: false,
+        networkError: true,
+        errorMessage
+      };
+    }
+    return {
+      exists: false,
+      remoteAhead: false,
+      localAhead: false,
+      networkError: false
+    };
+  }
+}
+async function getMergeTargetBranch(worktreePath = process.cwd(), options) {
+  var _a;
+  const settingsManager = (options == null ? void 0 : options.settingsManager) ?? new SettingsManager();
+  const metadataManager = (options == null ? void 0 : options.metadataManager) ?? new MetadataManager();
+  logger.debug(`Checking for parent loom metadata at: ${worktreePath}`);
+  const metadata = await metadataManager.readMetadata(worktreePath);
+  if ((_a = metadata == null ? void 0 : metadata.parentLoom) == null ? void 0 : _a.branchName) {
+    logger.debug(`Using parent branch as merge target: ${metadata.parentLoom.branchName}`);
+    return metadata.parentLoom.branchName;
+  }
+  logger.debug("No parent loom metadata found, falling back to settings");
+  const settings = await settingsManager.loadSettings(worktreePath);
+  const mainBranch = settings.mainBranch ?? "main";
+  logger.debug(`Using configured main branch as merge target: ${mainBranch}`);
+  return mainBranch;
+}
 
 export {
   executeGitCommand,
@@ -488,6 +630,7 @@ export {
   getRepoRoot,
   findMainWorktreePath,
   findMainWorktreePathWithSettings,
+  findWorktreeForBranch,
   hasUncommittedChanges,
   getDefaultBranch,
   findAllBranchesForIssue,
@@ -495,6 +638,10 @@ export {
   ensureRepositoryHasCommits,
   pushBranchToRemote,
   isFileTrackedByGit,
-  isFileGitignored
+  isFileGitignored,
+  isBranchMergedIntoMain,
+  isRemoteBranchUpToDate,
+  checkRemoteBranchStatus,
+  getMergeTargetBranch
 };
-//# sourceMappingURL=chunk-5Q3NDNNV.js.map
+//# sourceMappingURL=chunk-2W2FBL5G.js.map