@iloom/cli 0.6.1 → 0.7.1

package/dist/index.js

@@ -494,11 +494,12 @@ import path2 from "path";
 import os from "os";
 import { z } from "zod";
 import deepmerge from "deepmerge";
-var AgentSettingsSchema, SpinAgentSettingsSchema, SummarySettingsSchema, WorkflowPermissionSchema, WorkflowPermissionSchemaNoDefaults, WorkflowsSettingsSchema, WorkflowsSettingsSchemaNoDefaults, CapabilitiesSettingsSchema, CapabilitiesSettingsSchemaNoDefaults, NeonSettingsSchema, DatabaseProvidersSettingsSchema, IloomSettingsSchema, IloomSettingsSchemaNoDefaults, SettingsManager;
+var PROJECT_CAPABILITIES, AgentSettingsSchema, SpinAgentSettingsSchema, SummarySettingsSchema, WorkflowPermissionSchema, WorkflowPermissionSchemaNoDefaults, WorkflowsSettingsSchema, WorkflowsSettingsSchemaNoDefaults, CapabilitiesSettingsSchema, CapabilitiesSettingsSchemaNoDefaults, NeonSettingsSchema, DatabaseProvidersSettingsSchema, IloomSettingsSchema, IloomSettingsSchemaNoDefaults, SettingsManager;
 var init_SettingsManager = __esm({
   "src/lib/SettingsManager.ts"() {
     "use strict";
     init_logger();
+    PROJECT_CAPABILITIES = ["cli", "web"];
     AgentSettingsSchema = z.object({
       model: z.enum(["sonnet", "opus", "haiku"]).optional().describe("Claude model shorthand: sonnet, opus, or haiku")
       // Future: could add other per-agent overrides
@@ -511,7 +512,7 @@ var init_SettingsManager = __esm({
     });
     WorkflowPermissionSchema = z.object({
       permissionMode: z.enum(["plan", "acceptEdits", "bypassPermissions", "default"]).optional().describe("Permission mode for Claude CLI in this workflow type"),
-      noVerify: z.boolean().optional().describe("Skip pre-commit hooks (--no-verify) when committing during finish workflow"),
+      noVerify: z.boolean().optional().describe("Skip pre-commit hooks (--no-verify) when committing during commit and finish workflows"),
       startIde: z.boolean().default(true).describe("Launch IDE (code) when starting this workflow type"),
       startDevServer: z.boolean().default(true).describe("Launch development server when starting this workflow type"),
       startAiAgent: z.boolean().default(true).describe("Launch Claude Code agent when starting this workflow type"),
@@ -520,7 +521,7 @@ var init_SettingsManager = __esm({
     });
     WorkflowPermissionSchemaNoDefaults = z.object({
       permissionMode: z.enum(["plan", "acceptEdits", "bypassPermissions", "default"]).optional().describe("Permission mode for Claude CLI in this workflow type"),
-      noVerify: z.boolean().optional().describe("Skip pre-commit hooks (--no-verify) when committing during finish workflow"),
+      noVerify: z.boolean().optional().describe("Skip pre-commit hooks (--no-verify) when committing during commit and finish workflows"),
       startIde: z.boolean().optional().describe("Launch IDE (code) when starting this workflow type"),
       startDevServer: z.boolean().optional().describe("Launch development server when starting this workflow type"),
       startAiAgent: z.boolean().optional().describe("Launch Claude Code agent when starting this workflow type"),
@@ -538,6 +539,7 @@ var init_SettingsManager = __esm({
       regular: WorkflowPermissionSchemaNoDefaults.optional()
     }).optional();
     CapabilitiesSettingsSchema = z.object({
+      capabilities: z.array(z.enum(PROJECT_CAPABILITIES)).optional().describe("Explicitly declared project capabilities (auto-detected if not specified)"),
       web: z.object({
         basePort: z.number().min(1, "Base port must be >= 1").max(65535, "Base port must be <= 65535").optional().describe("Base port for web workspace port calculations (default: 3000)")
       }).optional(),
@@ -546,6 +548,7 @@ var init_SettingsManager = __esm({
       }).optional()
     }).optional();
     CapabilitiesSettingsSchemaNoDefaults = z.object({
+      capabilities: z.array(z.enum(PROJECT_CAPABILITIES)).optional().describe("Explicitly declared project capabilities (auto-detected if not specified)"),
       web: z.object({
         basePort: z.number().min(1, "Base port must be >= 1").max(65535, "Base port must be <= 65535").optional().describe("Base port for web workspace port calculations (default: 3000)")
       }).optional(),
@@ -1171,6 +1174,30 @@ function getLogger() {
 var MetadataManager = class {
   constructor() {
     this.loomsDir = path3.join(os2.homedir(), ".config", "iloom-ai", "looms");
+    this.finishedDir = path3.join(this.loomsDir, "finished");
+  }
+  /**
+   * Convert MetadataFile to LoomMetadata with default values for optional fields
+   */
+  toMetadata(data) {
+    return {
+      description: data.description,
+      created_at: data.created_at ?? null,
+      branchName: data.branchName ?? null,
+      worktreePath: data.worktreePath ?? null,
+      issueType: data.issueType ?? null,
+      issue_numbers: data.issue_numbers ?? [],
+      pr_numbers: data.pr_numbers ?? [],
+      issueTracker: data.issueTracker ?? null,
+      colorHex: data.colorHex ?? null,
+      sessionId: data.sessionId ?? null,
+      projectPath: data.projectPath ?? null,
+      issueUrls: data.issueUrls ?? {},
+      prUrls: data.prUrls ?? {},
+      draftPrNumber: data.draftPrNumber ?? null,
+      capabilities: data.capabilities ?? [],
+      parentLoom: data.parentLoom ?? null
+    };
   }
   /**
    * Convert worktree path to filename slug per spec section 2.2
@@ -1230,6 +1257,7 @@ var MetadataManager = class {
         projectPath: input.projectPath,
         issueUrls: input.issueUrls,
         prUrls: input.prUrls,
+        capabilities: input.capabilities,
         ...input.draftPrNumber && { draftPrNumber: input.draftPrNumber },
         ...input.parentLoom && { parentLoom: input.parentLoom }
       };
@@ -1259,23 +1287,7 @@ var MetadataManager = class {
       if (!data.description) {
         return null;
       }
-      return {
-        description: data.description,
-        created_at: data.created_at ?? null,
-        branchName: data.branchName ?? null,
-        worktreePath: data.worktreePath ?? null,
-        issueType: data.issueType ?? null,
-        issue_numbers: data.issue_numbers ?? [],
-        pr_numbers: data.pr_numbers ?? [],
-        issueTracker: data.issueTracker ?? null,
-        colorHex: data.colorHex ?? null,
-        sessionId: data.sessionId ?? null,
-        projectPath: data.projectPath ?? null,
-        issueUrls: data.issueUrls ?? {},
-        prUrls: data.prUrls ?? {},
-        draftPrNumber: data.draftPrNumber ?? null,
-        parentLoom: data.parentLoom ?? null
-      };
+      return this.toMetadata(data);
     } catch (error) {
       getLogger().debug(
         `Could not read metadata for worktree ${worktreePath}: ${error instanceof Error ? error.message : String(error)}`
@@ -1309,23 +1321,7 @@ var MetadataManager = class {
           if (!data.description) {
             continue;
           }
-          results.push({
-            description: data.description,
-            created_at: data.created_at ?? null,
-            branchName: data.branchName ?? null,
-            worktreePath: data.worktreePath ?? null,
-            issueType: data.issueType ?? null,
-            issue_numbers: data.issue_numbers ?? [],
-            pr_numbers: data.pr_numbers ?? [],
-            issueTracker: data.issueTracker ?? null,
-            colorHex: data.colorHex ?? null,
-            sessionId: data.sessionId ?? null,
-            projectPath: data.projectPath ?? null,
-            issueUrls: data.issueUrls ?? {},
-            prUrls: data.prUrls ?? {},
-            draftPrNumber: data.draftPrNumber ?? null,
-            parentLoom: data.parentLoom ?? null
-          });
+          results.push(this.toMetadata(data));
         } catch (error) {
           getLogger().debug(
             `Skipping metadata file ${file}: ${error instanceof Error ? error.message : String(error)}`
@@ -1362,10 +1358,104 @@ var MetadataManager = class {
       );
     }
   }
+  /**
+   * Archive metadata for a finished worktree
+   *
+   * Moves the metadata file to the finished/ subdirectory and adds
+   * status: 'finished' and finishedAt timestamp fields.
+   *
+   * Idempotent: silently succeeds if source file doesn't exist
+   * Non-fatal: logs warning on errors but doesn't throw
+   *
+   * @param worktreePath - Absolute path to the worktree
+   */
+  async archiveMetadata(worktreePath) {
+    try {
+      const filename = this.slugifyPath(worktreePath);
+      const sourcePath = path3.join(this.loomsDir, filename);
+      if (!await fs.pathExists(sourcePath)) {
+        getLogger().debug(`No metadata file to archive for worktree: ${worktreePath}`);
+        return;
+      }
+      const content = await fs.readFile(sourcePath, "utf8");
+      const data = JSON.parse(content);
+      const finishedData = {
+        ...data,
+        status: "finished",
+        finishedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      await fs.ensureDir(this.finishedDir, { mode: 493 });
+      const destPath = path3.join(this.finishedDir, filename);
+      await fs.writeFile(destPath, JSON.stringify(finishedData, null, 2), { mode: 420 });
+      await fs.unlink(sourcePath);
+      getLogger().debug(`Metadata archived for worktree: ${worktreePath}`);
+    } catch (error) {
+      getLogger().warn(
+        `Failed to archive metadata for worktree: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * List all finished loom metadata files
+   *
+   * Returns an array of LoomMetadata objects for all finished looms
+   * in the finished/ subdirectory, sorted by finishedAt in descending order
+   * (most recently finished first).
+   *
+   * @returns Array of LoomMetadata objects from finished files, sorted by finishedAt desc
+   */
+  async listFinishedMetadata() {
+    const results = [];
+    try {
+      if (!await fs.pathExists(this.finishedDir)) {
+        return results;
+      }
+      const files = await fs.readdir(this.finishedDir);
+      for (const file of files) {
+        if (!file.endsWith(".json")) {
+          continue;
+        }
+        try {
+          const filePath = path3.join(this.finishedDir, file);
+          const content = await fs.readFile(filePath, "utf8");
+          const data = JSON.parse(content);
+          if (!data.description) {
+            continue;
+          }
+          const metadata = this.toMetadata(data);
+          metadata.status = data.status ?? "finished";
+          metadata.finishedAt = data.finishedAt ?? null;
+          results.push(metadata);
+        } catch (error) {
+          getLogger().warn(
+            `Skipping finished metadata file ${file}: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      }
+      results.sort((a, b) => {
+        const aTime = a.finishedAt ? new Date(a.finishedAt).getTime() : 0;
+        const bTime = b.finishedAt ? new Date(b.finishedAt).getTime() : 0;
+        return bTime - aTime;
+      });
+    } catch (error) {
+      getLogger().warn(
+        `Could not list finished metadata files: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    return results;
+  }
 };
 
 // src/utils/git.ts
 init_logger();
+var GitCommandError = class extends Error {
+  constructor(message, exitCode, stderr) {
+    super(message);
+    this.exitCode = exitCode;
+    this.stderr = stderr;
+    this.name = "GitCommandError";
+  }
+};
 async function executeGitCommand(args, options) {
   try {
     const result = await execa2("git", args, {
@@ -1381,7 +1471,11 @@ async function executeGitCommand(args, options) {
   } catch (error) {
     const execaError = error;
     const stderr = execaError.stderr ?? execaError.message ?? "Unknown Git error";
-    throw new Error(`Git command failed: ${stderr}`);
+    throw new GitCommandError(
+      `Git command failed: ${stderr}`,
+      execaError.exitCode,
+      stderr
+    );
   }
 }
 function parseWorktreeList(output, defaultBranch) {
@@ -1621,10 +1715,10 @@ async function getRepoRoot(path7 = process.cwd()) {
     const repoRoot = trimmedPath.replace(/\/\.git\/worktrees\/[^/]+$/, "").replace(/\/\.git$/, "");
     return repoRoot;
   } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    if (errorMessage.includes("not a git repository")) {
+    if (error instanceof GitCommandError && (error.exitCode === 128 || /fatal: not a git repository/i.test(error.stderr))) {
       logger.info(`Note: No git repository detected: ${path7}`);
     } else {
+      const errorMessage = error instanceof Error ? error.message : String(error);
       logger.warn(`Failed to determine repo root from git-common-dir: ${path7}`, errorMessage);
     }
     return null;
@@ -1979,7 +2073,7 @@ async function getMergeTargetBranch(worktreePath = process.cwd(), options) {
   logger.debug(`Using configured main branch as merge target: ${mainBranch}`);
   return mainBranch;
 }
-var PLACEHOLDER_COMMIT_PREFIX = "[iloom-temp]";
+var PLACEHOLDER_COMMIT_PREFIX = "[iloom]";
 async function isPlaceholderCommit(cwd = process.cwd()) {
   try {
     const subject = await executeGitCommand(["log", "-1", "--format=%s", "HEAD"], { cwd });
@@ -3058,7 +3152,6 @@ async function updateLinearIssueState(identifier, stateName) {
 }
 
 // src/lib/LinearService.ts
-init_logger();
 var LinearService = class {
   constructor(config, options) {
     // IssueTracker interface implementation
@@ -3077,22 +3170,22 @@ var LinearService = class {
    * @returns Detection result with type and identifier
    */
   async detectInputType(input, _repo) {
-    logger.debug(`LinearService.detectInputType called with input: "${input}"`);
+    getLogger().debug(`LinearService.detectInputType called with input: "${input}"`);
     const linearPattern = /^([A-Z]{2,}-\d+)$/i;
     const match = input.match(linearPattern);
     if (!(match == null ? void 0 : match[1])) {
-      logger.debug(`LinearService: Input "${input}" does not match Linear pattern`);
+      getLogger().debug(`LinearService: Input "${input}" does not match Linear pattern`);
       return { type: "unknown", identifier: null, rawInput: input };
     }
     const identifier = match[1].toUpperCase();
-    logger.debug(`LinearService: Matched Linear identifier: ${identifier}`);
-    logger.debug(`LinearService: Checking if ${identifier} is a valid Linear issue via SDK`);
+    getLogger().debug(`LinearService: Matched Linear identifier: ${identifier}`);
+    getLogger().debug(`LinearService: Checking if ${identifier} is a valid Linear issue via SDK`);
     const issue = await this.isValidIssue(identifier);
     if (issue) {
-      logger.debug(`LinearService: Issue ${identifier} found: "${issue.title}"`);
+      getLogger().debug(`LinearService: Issue ${identifier} found: "${issue.title}"`);
       return { type: "issue", identifier, rawInput: input };
     }
-    logger.debug(`LinearService: Issue ${identifier} NOT found by SDK`);
+    getLogger().debug(`LinearService: Issue ${identifier} NOT found by SDK`);
     return { type: "unknown", identifier: null, rawInput: input };
   }
   /**
@@ -3153,7 +3246,7 @@ var LinearService = class {
         "Linear teamId not configured. Run `il init` to configure Linear settings."
       );
     }
-    logger.info(`Creating Linear issue in team ${this.config.teamId}: ${title}`);
+    getLogger().info(`Creating Linear issue in team ${this.config.teamId}: ${title}`);
     const result = await createLinearIssue(title, body, this.config.teamId, labels);
     return {
       number: result.identifier,
@@ -3176,7 +3269,7 @@ var LinearService = class {
    * @throws LinearServiceError if state update fails
    */
   async moveIssueToInProgress(identifier) {
-    logger.info(`Moving Linear issue ${identifier} to In Progress`);
+    getLogger().info(`Moving Linear issue ${identifier} to In Progress`);
     await updateLinearIssueState(String(identifier), "In Progress");
   }
   /**
@@ -3262,11 +3355,25 @@ var IssueTrackerFactory = class {
 };
 
 // src/lib/EnvironmentManager.ts
-import fs3 from "fs-extra";
+import fs4 from "fs-extra";
 init_env();
 
 // src/utils/port.ts
 import { createHash } from "crypto";
+init_env();
+import fs3 from "fs-extra";
+init_logger();
+function wrapPort(rawPort, basePort) {
+  if (rawPort <= 65535) return rawPort;
+  const range = 65535 - basePort;
+  return (rawPort - basePort - 1) % range + basePort + 1;
+}
+function extractNumericSuffix(issueId) {
+  const match = issueId.match(/[-_]?(\d+)$/);
+  const digits = match == null ? void 0 : match[1];
+  if (digits === void 0) return null;
+  return parseInt(digits, 10);
+}
 function generatePortOffsetFromBranchName(branchName) {
   if (!branchName || branchName.trim().length === 0) {
     throw new Error("Branch name cannot be empty");
@@ -3280,12 +3387,21 @@ function generatePortOffsetFromBranchName(branchName) {
 function calculatePortForBranch(branchName, basePort = 3e3) {
   const offset = generatePortOffsetFromBranchName(branchName);
   const port = basePort + offset;
-  if (port > 65535) {
-    throw new Error(
-      `Calculated port ${port} exceeds maximum (65535). Use a lower base port (current: ${basePort}).`
-    );
+  return wrapPort(port, basePort);
+}
+function calculatePortFromIdentifier(identifier, basePort = 3e3) {
+  if (typeof identifier === "number") {
+    return wrapPort(basePort + identifier, basePort);
+  }
+  const numericValue = parseInt(identifier, 10);
+  if (!isNaN(numericValue) && String(numericValue) === identifier) {
+    return wrapPort(basePort + numericValue, basePort);
   }
-  return port;
+  const numericSuffix = extractNumericSuffix(identifier);
+  if (numericSuffix !== null) {
+    return wrapPort(basePort + numericSuffix, basePort);
+  }
+  return calculatePortForBranch(`issue-${identifier}`, basePort);
 }
 
 // src/lib/EnvironmentManager.ts
@@ -3303,15 +3419,15 @@ var EnvironmentManager = class {
     if (!validation.valid) {
       throw new Error(validation.error ?? "Invalid variable name");
     }
-    const fileExists = await fs3.pathExists(filePath);
+    const fileExists = await fs4.pathExists(filePath);
     if (!fileExists) {
       getLogger().info(`Creating ${filePath} with ${key}...`);
       const content = formatEnvLine(key, value);
-      await fs3.writeFile(filePath, content, "utf8");
+      await fs4.writeFile(filePath, content, "utf8");
       getLogger().success(`${filePath} created with ${key}`);
       return;
     }
-    const existingContent = await fs3.readFile(filePath, "utf8");
+    const existingContent = await fs4.readFile(filePath, "utf8");
     const envMap = parseEnvFile(existingContent);
     let backupPath;
     if (backup) {
@@ -3348,7 +3464,7 @@ var EnvironmentManager = class {
       getLogger().success(`${key} updated successfully`);
     }
     const newContent = newLines.join("\n");
-    await fs3.writeFile(filePath, newContent, "utf8");
+    await fs4.writeFile(filePath, newContent, "utf8");
     return backupPath;
   }
   /**
@@ -3356,7 +3472,7 @@ var EnvironmentManager = class {
    */
   async readEnvFile(filePath) {
     try {
-      const content = await fs3.readFile(filePath, "utf8");
+      const content = await fs4.readFile(filePath, "utf8");
       return parseEnvFile(content);
     } catch (error) {
       getLogger().debug(
@@ -3379,12 +3495,12 @@ var EnvironmentManager = class {
    * @private
    */
   async copyIfExists(source, destination) {
-    const sourceExists = await fs3.pathExists(source);
+    const sourceExists = await fs4.pathExists(source);
     if (!sourceExists) {
       getLogger().debug(`Source file ${source} does not exist, skipping copy`);
       return;
     }
-    await fs3.copy(source, destination, { overwrite: false });
+    await fs4.copy(source, destination, { overwrite: false });
     getLogger().success(`Copied ${source} to ${destination}`);
   }
   /**
@@ -3392,30 +3508,15 @@ var EnvironmentManager = class {
    * Implements:
    * - Issue/PR: 3000 + issue/PR number
    * - Branch: 3000 + deterministic hash offset (1-999)
+   * Delegates to calculatePortFromIdentifier for the core calculation.
    */
   calculatePort(options) {
     const basePort = options.basePort ?? 3e3;
     if (options.issueNumber !== void 0) {
-      const numericIssue = typeof options.issueNumber === "number" ? options.issueNumber : parseInt(String(options.issueNumber), 10);
-      if (!isNaN(numericIssue) && String(numericIssue) === String(options.issueNumber)) {
-        const port = basePort + numericIssue;
-        if (port > 65535) {
-          throw new Error(
-            `Calculated port ${port} exceeds maximum (65535). Use a lower base port or issue number.`
-          );
-        }
-        return port;
-      }
-      return calculatePortForBranch(String(options.issueNumber), basePort);
+      return calculatePortFromIdentifier(options.issueNumber, basePort);
     }
     if (options.prNumber !== void 0) {
-      const port = basePort + options.prNumber;
-      if (port > 65535) {
-        throw new Error(
-          `Calculated port ${port} exceeds maximum (65535). Use a lower base port or PR number.`
-        );
-      }
-      return port;
+      return calculatePortFromIdentifier(options.prNumber, basePort);
     }
     if (options.branchName !== void 0) {
       return calculatePortForBranch(options.branchName, basePort);
@@ -3445,7 +3546,7 @@ var EnvironmentManager = class {
    */
   async validateEnvFile(filePath) {
     try {
-      const content = await fs3.readFile(filePath, "utf8");
+      const content = await fs4.readFile(filePath, "utf8");
       const envMap = parseEnvFile(content);
       const errors = [];
       for (const [key, value] of envMap.entries()) {
@@ -3473,7 +3574,7 @@ var EnvironmentManager = class {
   async createBackup(filePath) {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
     const backupPath = `${filePath}${this.backupSuffix}-${timestamp}`;
-    await fs3.copy(filePath, backupPath);
+    await fs4.copy(filePath, backupPath);
     getLogger().debug(`Created backup at ${backupPath}`);
     return backupPath;
   }
@@ -3481,7 +3582,7 @@ var EnvironmentManager = class {
 
 // src/lib/DatabaseManager.ts
 init_env();
-import fs4 from "fs-extra";
+import fs5 from "fs-extra";
 var DatabaseManager = class {
   constructor(provider, environment, databaseUrlEnvVarName = "DATABASE_URL") {
     this.provider = provider;
@@ -3670,7 +3771,7 @@ var DatabaseManager = class {
       const hasConfiguredVar = await hasVariableInAnyEnvFile(
         workspacePath,
         this.databaseUrlEnvVarName,
-        async (p) => fs4.pathExists(p),
+        async (p) => fs5.pathExists(p),
         async (p, v) => this.environment.getEnvVariable(p, v)
       );
       if (hasConfiguredVar) {
@@ -3690,7 +3791,7 @@ var DatabaseManager = class {
       const hasDefaultVar = await hasVariableInAnyEnvFile(
         workspacePath,
         "DATABASE_URL",
-        async (p) => fs4.pathExists(p),
+        async (p) => fs5.pathExists(p),
         async (p, v) => this.environment.getEnvVariable(p, v)
       );
       if (hasDefaultVar) {
@@ -3713,7 +3814,7 @@ init_logger();
 import { execa as execa4 } from "execa";
 import { existsSync as existsSync2 } from "fs";
 import { join } from "path";
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash3, randomUUID } from "crypto";
 init_terminal();
 async function detectClaudeCli() {
   try {
@@ -4002,6 +4103,10 @@ import { readFile as readFile2 } from "fs/promises";
 import { accessSync } from "fs";
 import path6 from "path";
 import { fileURLToPath } from "url";
+import Handlebars from "handlebars";
+Handlebars.registerHelper("raw", function(options) {
+  return options.fn(this);
+});
 var PromptTemplateManager = class {
   constructor(templateDir) {
     if (templateDir) {
@@ -4048,187 +4153,11 @@ var PromptTemplateManager = class {
     }
   }
   /**
-   * Substitute variables in a template string
+   * Substitute variables in a template string using Handlebars
    */
   substituteVariables(template, variables) {
-    let result = template;
-    result = this.processConditionalSections(result, variables);
-    if (variables.ISSUE_NUMBER !== void 0) {
-      result = result.replace(/ISSUE_NUMBER/g, String(variables.ISSUE_NUMBER));
-    }
-    if (variables.PR_NUMBER !== void 0) {
-      result = result.replace(/PR_NUMBER/g, String(variables.PR_NUMBER));
-    }
-    if (variables.ISSUE_TITLE !== void 0) {
-      result = result.replace(/ISSUE_TITLE/g, variables.ISSUE_TITLE);
-    }
-    if (variables.PR_TITLE !== void 0) {
-      result = result.replace(/PR_TITLE/g, variables.PR_TITLE);
-    }
-    if (variables.WORKSPACE_PATH !== void 0) {
-      result = result.replace(/WORKSPACE_PATH/g, variables.WORKSPACE_PATH);
-    }
-    if (variables.PORT !== void 0) {
-      result = result.replace(/PORT/g, String(variables.PORT));
-    }
-    if (variables.SETTINGS_SCHEMA !== void 0) {
-      result = result.replace(/SETTINGS_SCHEMA/g, variables.SETTINGS_SCHEMA);
-    }
-    if (variables.SETTINGS_GLOBAL_JSON !== void 0) {
-      result = result.replace(/SETTINGS_GLOBAL_JSON/g, variables.SETTINGS_GLOBAL_JSON);
-    }
-    if (variables.SETTINGS_JSON !== void 0) {
-      result = result.replace(/SETTINGS_JSON/g, variables.SETTINGS_JSON);
-    }
-    if (variables.SETTINGS_LOCAL_JSON !== void 0) {
-      result = result.replace(/SETTINGS_LOCAL_JSON/g, variables.SETTINGS_LOCAL_JSON);
-    }
-    if (variables.SHELL_TYPE !== void 0) {
-      result = result.replace(/SHELL_TYPE/g, variables.SHELL_TYPE);
-    }
-    if (variables.SHELL_CONFIG_PATH !== void 0) {
-      result = result.replace(/SHELL_CONFIG_PATH/g, variables.SHELL_CONFIG_PATH);
-    }
-    if (variables.SHELL_CONFIG_CONTENT !== void 0) {
-      result = result.replace(/SHELL_CONFIG_CONTENT/g, variables.SHELL_CONFIG_CONTENT);
-    }
-    if (variables.REMOTES_INFO !== void 0) {
-      result = result.replace(/REMOTES_INFO/g, variables.REMOTES_INFO);
-    }
-    if (variables.MULTIPLE_REMOTES !== void 0) {
-      result = result.replace(/MULTIPLE_REMOTES/g, variables.MULTIPLE_REMOTES);
-    }
-    if (variables.SINGLE_REMOTE !== void 0) {
-      result = result.replace(/SINGLE_REMOTE/g, variables.SINGLE_REMOTE);
-    }
-    if (variables.SINGLE_REMOTE_NAME !== void 0) {
-      result = result.replace(/SINGLE_REMOTE_NAME/g, variables.SINGLE_REMOTE_NAME);
-    }
-    if (variables.SINGLE_REMOTE_URL !== void 0) {
-      result = result.replace(/SINGLE_REMOTE_URL/g, variables.SINGLE_REMOTE_URL);
-    }
-    if (variables.NO_REMOTES !== void 0) {
-      result = result.replace(/NO_REMOTES/g, variables.NO_REMOTES);
-    }
-    if (variables.README_CONTENT !== void 0) {
-      result = result.replace(/README_CONTENT/g, variables.README_CONTENT);
-    }
-    if (variables.SETTINGS_SCHEMA_CONTENT !== void 0) {
-      result = result.replace(/SETTINGS_SCHEMA_CONTENT/g, variables.SETTINGS_SCHEMA_CONTENT);
-    }
-    if (variables.VSCODE_SETTINGS_GITIGNORED !== void 0) {
-      result = result.replace(/VSCODE_SETTINGS_GITIGNORED/g, variables.VSCODE_SETTINGS_GITIGNORED);
-    }
-    if (variables.SESSION_CONTEXT !== void 0) {
-      result = result.replace(/SESSION_CONTEXT/g, variables.SESSION_CONTEXT);
-    }
-    if (variables.BRANCH_NAME !== void 0) {
-      result = result.replace(/BRANCH_NAME/g, variables.BRANCH_NAME);
-    }
-    if (variables.LOOM_TYPE !== void 0) {
-      result = result.replace(/LOOM_TYPE/g, variables.LOOM_TYPE);
-    }
-    if (variables.COMPACT_SUMMARIES !== void 0) {
-      result = result.replace(/COMPACT_SUMMARIES/g, variables.COMPACT_SUMMARIES);
-    }
-    if (variables.DRAFT_PR_NUMBER !== void 0) {
-      result = result.replace(/DRAFT_PR_NUMBER/g, String(variables.DRAFT_PR_NUMBER));
-    }
-    return result;
-  }
-  /**
-   * Process conditional sections in template
-   * Format: {{#IF ONE_SHOT_MODE}}content{{/IF ONE_SHOT_MODE}}
-   *
-   * Note: /s flag allows . to match newlines
-   */
-  processConditionalSections(template, variables) {
-    let result = template;
-    const oneShotRegex = /\{\{#IF ONE_SHOT_MODE\}\}(.*?)\{\{\/IF ONE_SHOT_MODE\}\}/gs;
-    if (variables.ONE_SHOT_MODE === true) {
-      result = result.replace(oneShotRegex, "$1");
-    } else {
-      result = result.replace(oneShotRegex, "");
-    }
-    const settingsJsonRegex = /\{\{#IF SETTINGS_JSON\}\}(.*?)\{\{\/IF SETTINGS_JSON\}\}/gs;
-    if (variables.SETTINGS_JSON !== void 0 && variables.SETTINGS_JSON !== "") {
-      result = result.replace(settingsJsonRegex, "$1");
-    } else {
-      result = result.replace(settingsJsonRegex, "");
-    }
-    const settingsGlobalJsonRegex = /\{\{#IF SETTINGS_GLOBAL_JSON\}\}(.*?)\{\{\/IF SETTINGS_GLOBAL_JSON\}\}/gs;
-    if (variables.SETTINGS_GLOBAL_JSON !== void 0 && variables.SETTINGS_GLOBAL_JSON !== "") {
-      result = result.replace(settingsGlobalJsonRegex, "$1");
-    } else {
-      result = result.replace(settingsGlobalJsonRegex, "");
-    }
-    const settingsLocalJsonRegex = /\{\{#IF SETTINGS_LOCAL_JSON\}\}(.*?)\{\{\/IF SETTINGS_LOCAL_JSON\}\}/gs;
-    if (variables.SETTINGS_LOCAL_JSON !== void 0 && variables.SETTINGS_LOCAL_JSON !== "") {
-      result = result.replace(settingsLocalJsonRegex, "$1");
-    } else {
-      result = result.replace(settingsLocalJsonRegex, "");
-    }
-    const multipleRemotesRegex = /\{\{#IF MULTIPLE_REMOTES\}\}(.*?)\{\{\/IF MULTIPLE_REMOTES\}\}/gs;
-    if (variables.MULTIPLE_REMOTES !== void 0 && variables.MULTIPLE_REMOTES !== "") {
-      result = result.replace(multipleRemotesRegex, "$1");
-    } else {
-      result = result.replace(multipleRemotesRegex, "");
-    }
-    const singleRemoteRegex = /\{\{#IF SINGLE_REMOTE\}\}(.*?)\{\{\/IF SINGLE_REMOTE\}\}/gs;
-    if (variables.SINGLE_REMOTE !== void 0 && variables.SINGLE_REMOTE !== "") {
-      result = result.replace(singleRemoteRegex, "$1");
-    } else {
-      result = result.replace(singleRemoteRegex, "");
-    }
-    const noRemotesRegex = /\{\{#IF NO_REMOTES\}\}(.*?)\{\{\/IF NO_REMOTES\}\}/gs;
-    if (variables.NO_REMOTES !== void 0 && variables.NO_REMOTES !== "") {
-      result = result.replace(noRemotesRegex, "$1");
-    } else {
-      result = result.replace(noRemotesRegex, "");
-    }
-    const firstTimeUserRegex = /\{\{#IF FIRST_TIME_USER\}\}(.*?)\{\{\/IF FIRST_TIME_USER\}\}/gs;
-    if (variables.FIRST_TIME_USER === true) {
-      result = result.replace(firstTimeUserRegex, "$1");
-    } else {
-      result = result.replace(firstTimeUserRegex, "");
-    }
-    const interactiveModeRegex = /\{\{#IF INTERACTIVE_MODE\}\}(.*?)\{\{\/IF INTERACTIVE_MODE\}\}/gs;
-    if (variables.INTERACTIVE_MODE === true) {
-      result = result.replace(interactiveModeRegex, "$1");
-    } else {
-      result = result.replace(interactiveModeRegex, "");
-    }
-    const compactSummariesRegex = /\{\{#IF COMPACT_SUMMARIES\}\}(.*?)\{\{\/IF COMPACT_SUMMARIES\}\}/gs;
-    if (variables.COMPACT_SUMMARIES !== void 0 && variables.COMPACT_SUMMARIES !== "") {
-      result = result.replace(compactSummariesRegex, "$1");
-    } else {
-      result = result.replace(compactSummariesRegex, "");
-    }
-    const draftPrModeRegex = /\{\{#IF DRAFT_PR_MODE\}\}(.*?)\{\{\/IF DRAFT_PR_MODE\}\}/gs;
-    if (variables.DRAFT_PR_MODE === true) {
-      result = result.replace(draftPrModeRegex, "$1");
-    } else {
-      result = result.replace(draftPrModeRegex, "");
-    }
-    const standardIssueModeRegex = /\{\{#IF STANDARD_ISSUE_MODE\}\}(.*?)\{\{\/IF STANDARD_ISSUE_MODE\}\}/gs;
-    if (variables.STANDARD_ISSUE_MODE === true) {
-      result = result.replace(standardIssueModeRegex, "$1");
-    } else {
-      result = result.replace(standardIssueModeRegex, "");
-    }
-    const hasPackageJsonRegex = /\{\{#IF HAS_PACKAGE_JSON\}\}(.*?)\{\{\/IF HAS_PACKAGE_JSON\}\}/gs;
-    if (variables.HAS_PACKAGE_JSON === true) {
-      result = result.replace(hasPackageJsonRegex, "$1");
-    } else {
-      result = result.replace(hasPackageJsonRegex, "");
-    }
-    const noPackageJsonRegex = /\{\{#IF NO_PACKAGE_JSON\}\}(.*?)\{\{\/IF NO_PACKAGE_JSON\}\}/gs;
-    if (variables.NO_PACKAGE_JSON === true) {
-      result = result.replace(noPackageJsonRegex, "$1");
-    } else {
-      result = result.replace(noPackageJsonRegex, "");
-    }
-    return result;
+    const compiled = Handlebars.compile(template, { noEscape: true });
+    return compiled(variables);
   }
   /**
    * Get a fully processed prompt for a workflow type
@@ -4716,6 +4645,7 @@ export {
   ClaudeContextManager,
   DatabaseManager,
   EnvironmentManager,
+  GitCommandError,
   GitHubService,
   GitWorktreeManager,
   IssueTrackerFactory,