@iloom/cli 0.5.4 → 0.6.0

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

@@ -0,0 +1,366 @@
+---
+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.
+tools: Bash, Glob, Grep, Read, Write
+color: cyan
+model: sonnet
+---
+
+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.
+
+**Your Core Mission**: Detect the project's programming language and framework, then create `.iloom/package.iloom.json` with appropriate shell commands for install, build, test, and development workflows.
+
+**Key Distinction:**
+- `install` - Installs dependencies (runs during loom creation and post-merge)
+- `build` - Compiles/builds the project (for compiled languages or asset compilation)
+
+## Core Workflow
+
+### Step 1: Scan for Language Markers
+
+Examine the project root for language-specific files:
+
+| Marker File | Language | Package Manager |
+|-------------|----------|-----------------|
+| `Cargo.toml` | Rust | cargo |
+| `requirements.txt`, `pyproject.toml`, `setup.py` | Python | pip/poetry |
+| `Gemfile` | Ruby | bundler |
+| `go.mod` | Go | go |
+| `pom.xml`, `build.gradle`, `build.gradle.kts` | Java/Kotlin | maven/gradle |
+| `Package.swift` | Swift | swift |
+| `mix.exs` | Elixir | mix |
+| `*.csproj`, `*.sln` | C#/.NET | dotnet |
+| `Makefile` | C/C++/Generic | make |
+| `CMakeLists.txt` | C/C++ | cmake |
+
+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}"
+```
+
+### Step 2: Detect Framework (if applicable)
+
+For each detected language, look for framework-specific indicators:
+
+**Python:**
+- `manage.py` + `settings.py` = Django
+- `app.py` + `flask` in requirements = Flask
+- `main.py` + `fastapi` in requirements = FastAPI
+- `pyproject.toml` with `[tool.poetry]` = Poetry project
+
+**Ruby:**
+- `config/application.rb` = Rails
+- `sinatra` in Gemfile = Sinatra
+- `spec/` directory = RSpec testing
+
+**Rust:**
+- `Rocket.toml` = Rocket web framework
+- `actix-web` in Cargo.toml = Actix
+- `warp` in Cargo.toml = Warp
+
+**Go:**
+- `gin-gonic/gin` in go.mod = Gin framework
+- `gorilla/mux` in go.mod = Gorilla Mux
+- `fiber` in go.mod = Fiber
+
+### Step 3: Generate package.iloom.json
+
+Create `.iloom/package.iloom.json` with appropriate scripts and capabilities based on detection:
+
+**Capabilities Detection:**
+- `"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)
+
+**Common Patterns by Language:**
+
+#### Rust CLI
+```json
+{
+  "capabilities": ["cli"],
+  "scripts": {
+    "install": "cargo fetch",
+    "build": "cargo build --release",
+    "test": "cargo test",
+    "dev": "cargo run"
+  },
+  "_metadata": {
+    "detectedLanguage": "rust",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Rust Web (Actix/Rocket/Axum)
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "cargo fetch",
+    "build": "cargo build --release",
+    "test": "cargo test",
+    "dev": "cargo run"
+  },
+  "_metadata": {
+    "detectedLanguage": "rust",
+    "detectedFramework": "actix-web",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Python CLI (with pip)
+```json
+{
+  "capabilities": ["cli"],
+  "scripts": {
+    "install": "python -m pip install -e .",
+    "test": "pytest",
+    "dev": "python -m <module_name>"
+  },
+  "_metadata": {
+    "detectedLanguage": "python",
+    "detectedPackageManager": "pip",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Python CLI (with poetry)
+```json
+{
+  "capabilities": ["cli"],
+  "scripts": {
+    "install": "poetry install",
+    "test": "poetry run pytest",
+    "dev": "poetry run python -m <module_name>"
+  },
+  "_metadata": {
+    "detectedLanguage": "python",
+    "detectedPackageManager": "poetry",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Python (Django)
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "python -m pip install -r requirements.txt",
+    "test": "python manage.py test",
+    "dev": "python manage.py runserver"
+  },
+  "_metadata": {
+    "detectedLanguage": "python",
+    "detectedFramework": "django",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Python (Flask/FastAPI)
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "python -m pip install -r requirements.txt",
+    "test": "pytest",
+    "dev": "flask run"
+  },
+  "_metadata": {
+    "detectedLanguage": "python",
+    "detectedFramework": "flask",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Ruby (with Bundler)
+```json
+{
+  "capabilities": ["cli"],
+  "scripts": {
+    "install": "bundle install",
+    "test": "bundle exec rspec",
+    "dev": "bundle exec ruby app.rb"
+  },
+  "_metadata": {
+    "detectedLanguage": "ruby",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Ruby (Rails)
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "bundle install",
+    "build": "bundle exec rails assets:precompile",
+    "test": "bundle exec rails test",
+    "dev": "bundle exec rails server"
+  },
+  "_metadata": {
+    "detectedLanguage": "ruby",
+    "detectedFramework": "rails",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Go CLI
+```json
+{
+  "capabilities": ["cli"],
+  "scripts": {
+    "install": "go mod download",
+    "build": "go build ./...",
+    "test": "go test ./...",
+    "dev": "go run ."
+  },
+  "_metadata": {
+    "detectedLanguage": "go",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Go Web (Gin/Echo/Fiber)
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "go mod download",
+    "build": "go build ./...",
+    "test": "go test ./...",
+    "dev": "go run ."
+  },
+  "_metadata": {
+    "detectedLanguage": "go",
+    "detectedFramework": "gin",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Java (Maven)
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "mvn dependency:resolve",
+    "build": "mvn package",
+    "test": "mvn test",
+    "dev": "mvn spring-boot:run"
+  },
+  "_metadata": {
+    "detectedLanguage": "java",
+    "detectedBuildTool": "maven",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Java (Gradle)
+```json
+{
+  "capabilities": ["web"],
+  "scripts": {
+    "install": "./gradlew dependencies",
+    "build": "./gradlew build",
+    "test": "./gradlew test",
+    "dev": "./gradlew bootRun"
+  },
+  "_metadata": {
+    "detectedLanguage": "java",
+    "detectedBuildTool": "gradle",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+#### Library (no CLI or web)
+```json
+{
+  "capabilities": [],
+  "scripts": {
+    "install": "cargo fetch",
+    "build": "cargo build",
+    "test": "cargo test"
+  },
+  "_metadata": {
+    "detectedLanguage": "rust",
+    "generatedBy": "iloom-framework-detector"
+  }
+}
+```
+
+### Step 4: Write the File
+
+1. Read `.iloom/package.iloom.json` first to check if it already exists
+2. **If the file exists:**
+   - Compare existing configuration with detected configuration
+   - Preserve existing scripts (user may have customized them)
+   - Only add missing scripts that were detected
+   - Preserve existing capabilities, add any missing ones
+   - Preserve any other existing fields (like `_metadata`)
+3. **If the file does not exist:**
+   - Create the full detected configuration
+4. Ensure `.iloom/` directory exists
+5. Write the merged/new JSON to `.iloom/package.iloom.json`
+6. Report what was detected and what changes were made (if any)
+
+## Output Format
+
+After creating the file, provide a summary:
+
+```
+Framework Detection Complete
+
+Detected:
+- Language: [language]
+- Framework: [framework or "None detected"]
+- Package Manager: [package manager]
+- Capabilities: [cli, web, or none]
+
+Created: .iloom/package.iloom.json
+
+Configuration:
+- capabilities: [list of detected capabilities]
+- install: [command]
+- build: [command] (if applicable)
+- test: [command]
+- dev: [command]
+
+You can customize these settings by editing .iloom/package.iloom.json.
+```
+
+## Error Handling
+
+**If no language markers are found:**
+- Ask the user what language/framework they're using
+- Provide a template they can fill in manually
+
+**If multiple languages are detected:**
+- Report all detected languages
+- Ask the user which is the primary language
+- Generate scripts for the primary language
+
+## Behavioral Constraints
+
+1. **Only analyze project structure** - Don't read or execute code
+2. **Keep scripts simple** - Use standard commands that work out of the box
+3. **Don't assume** - If unsure, ask the user for clarification
+4. **Be conservative** - Use widely-adopted conventions and tools
+5. **Document choices** - Include _metadata so users know what was detected
+
+## What to Avoid
+
+DO NOT:
+- Execute any build/test/dev commands
+- Install dependencies
+- Modify any files other than `.iloom/package.iloom.json`
+- Make assumptions about project-specific configuration
+- Add scripts that require additional setup not evident from the project

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

@@ -603,16 +603,6 @@ When planning frontend changes:
   - Look for alternative existing classes first
   - Create new classes or element-specific overrides when needed
 
-### Payload 3.0 CMS Data Migrations
-See context7 for more information. Key points:
-* Custom migrations (data migrations): Create using `pnpm payload migrate:create --force-accept-warning`, then edit to implement up()/down()
-* IMPORTANT: Cross-reference tables/columns with most recent *.json file in migrations folder (contains current schema)
-* Schema migrations (adding/removing fields): Use `pnpm payload migrate:create --skip-empty`
-* Multiple phases: Create separate migrations after each phase (e.g., add fields, then remove fields)
-* Separate data migrations from schema migrations
-* Provide slug string argument for descriptive filenames
-* Do not plan to run migrations - deploy process handles this automatically
-
 ## Documentation Standards
 
 **Code Output Formatting:**

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

@@ -141,7 +141,7 @@ Before implementing, extract and validate the implementation plan:
    - Keep the user informed of your plan and updated with your progress via an issue comment (see "HOW TO UPDATE THE USER OF YOUR PROGRESS", below)
    - Identify any ambiguities or decision points before starting
    - Implement the solution exactly as specified
-   - When done, run "validate:commit" command if available in package.json. If not: typecheck, run tests and lint in that order.
+   - When done, run "validate:commit" command if available in package.json. If not: run `il compile`, `il test`, and `il lint` in that order.
    - When all is validated, update your issue comment with a concise final summary (see "Final Summary Format" below)
    - Avoid escaping issues by writing comments to temporary files before posting
 

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

@@ -186,16 +186,6 @@ When planning frontend changes:
   - Look for alternative existing classes first
   - Create new classes or element-specific overrides when needed
 
-  ### Payload 3.0 CMS Data Migrations - see context7 for more information:
-* If you need to do custom migrations (such as a data migration), you must first create a migration using `pnpm payload migrate:create --force-accept-warning` - you must then edit that empty migration to implement the data migration. Focus on making the up() implementation correct, and provide a reasonable proxy to a down() solution. It doesn’t have to be a perfect reversal in terms of data correctness, only schema correctness.
-* IMPORTANT - DO NOT SKIP THIS (OR ANY OTHER) STEP: When doing custom migrations (which should only be necessary in case of data migrations, you must make sure all tables and columns exist by cross-referencing them with the most recently committed *.json file in the migrations folder.  These JSON files contain the most recent schema as understood by the migration tool. It should be used in lieu of access to the the DB, which you don’t have.
-* If you are creating a regular migration after adjusting the schema you must use `pnpm payload migrate:create --skip-empty`
-* If performing multiple phases (i.e creating some fields and deleting some fields) create migrations after each phase (i.e after adding to a collection or global config, then again after removing fields from a collection or global config). Doing them together will cause issues with the migration tool and you won’t be able to complete your task.
-* Similarly, separate data migration files from schema change files - using a separate migration for each
-* IMPORTANT: DO NOT manually create/edit migrations for adding or removing fields from a collection or global config. This is handled by running the migrate:create command. You only need to create manual migrations when doing data migrations, not schema migrations.
-* You should provide a slug string argument to migrate:create that is a description of the change - this will create more descriptive filenames and makes part of the filename deterministic, but be mindful of multiple files with the same slug (but will have a different timestamp)
-* Do not plan to run the migrations - the implementor will not have permissions to do that. The deploy process will automatically do that when the implementor makes a commit.
-
 ## Plan Documentation Format
 
 **CRITICAL**: Your implementation plan must be structured in TWO sections for different audiences:

package/dist/build-FJVYP7EV.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import {
+  ScriptCommandBase
+} from "./chunk-TRQ76ISK.js";
+import "./chunk-AXX3QIKK.js";
+import "./chunk-UQIXZ3BA.js";
+import "./chunk-BXCPJJYM.js";
+import "./chunk-EK3XCAAS.js";
+import "./chunk-GEXP5IOF.js";
+import "./chunk-F6WVM437.js";
+import "./chunk-CFUWQHCJ.js";
+import "./chunk-6MLEBAYZ.js";
+import "./chunk-VT4PDUYT.js";
+
+// src/commands/build.ts
+var BuildCommand = class extends ScriptCommandBase {
+  getScriptName() {
+    return "build";
+  }
+  getScriptDisplayName() {
+    return "Build";
+  }
+};
+export {
+  BuildCommand
+};
+//# sourceMappingURL=build-FJVYP7EV.js.map

package/dist/build-FJVYP7EV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/build.ts"],"sourcesContent":["import { ScriptCommandBase, ScriptCommandInput } from './script-command-base.js'\n\nexport type { ScriptCommandInput as BuildCommandInput }\n\n/**\n * BuildCommand - Run the build script for a workspace\n * Uses package.iloom.json if available, otherwise falls back to package.json\n */\nexport class BuildCommand extends ScriptCommandBase {\n\tgetScriptName(): string {\n\t\treturn 'build'\n\t}\n\n\tgetScriptDisplayName(): string {\n\t\treturn 'Build'\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;AAQO,IAAM,eAAN,cAA2B,kBAAkB;AAAA,EACnD,gBAAwB;AACvB,WAAO;AAAA,EACR;AAAA,EAEA,uBAA+B;AAC9B,WAAO;AAAA,EACR;AACD;","names":[]}

package/dist/{chunk-SHVB3EFE.js → chunk-64O2UIWO.js}

@@ -1,10 +1,14 @@
 #!/usr/bin/env node
-import {
-  detectPackageManager
-} from "./chunk-LVLRMP7V.js";
 import {
   ProcessManager
 } from "./chunk-VU3QMIP2.js";
+import {
+  detectPackageManager,
+  runScript
+} from "./chunk-AXX3QIKK.js";
+import {
+  readPackageJson
+} from "./chunk-BXCPJJYM.js";
 import {
   logger
 } from "./chunk-VT4PDUYT.js";
@@ -77,6 +81,17 @@ var DevServerManager = class {
    * Start dev server in background and wait for it to be ready
    */
   async startDevServer(worktreePath, port) {
+    var _a;
+    try {
+      const packageJson = await readPackageJson(worktreePath);
+      if (!((_a = packageJson.scripts) == null ? void 0 : _a["dev"])) {
+        logger.warn('Skipping auto-start: no "dev" script found in package.json');
+        return;
+      }
+    } catch {
+      logger.debug("Skipping auto-start: no package.json found");
+      return;
+    }
     const devCommand = await buildDevServerCommand(worktreePath);
     logger.debug(`Starting dev server with command: ${devCommand}`);
     const serverProcess = execa("sh", ["-c", devCommand], {
@@ -144,26 +159,36 @@ var DevServerManager = class {
    * @returns Process information including PID
    */
   async runServerForeground(worktreePath, port, redirectToStderr = false, onProcessStarted, envOverrides) {
-    const devCommand = await buildDevServerCommand(worktreePath);
-    logger.debug(`Starting dev server in foreground with command: ${devCommand}`);
-    const stdio = redirectToStderr ? [process.stdin, process.stderr, process.stderr] : "inherit";
-    const serverProcess = execa("sh", ["-c", devCommand], {
-      cwd: worktreePath,
+    logger.debug(`Starting dev server in foreground on port ${port}`);
+    if (redirectToStderr) {
+      const devCommand = await buildDevServerCommand(worktreePath);
+      logger.debug(`Starting dev server with command: ${devCommand}`);
+      const serverProcess = execa("sh", ["-c", devCommand], {
+        cwd: worktreePath,
+        env: {
+          ...process.env,
+          ...envOverrides,
+          PORT: port.toString()
+        },
+        stdio: [process.stdin, process.stderr, process.stderr]
+      });
+      const processInfo = serverProcess.pid !== void 0 ? { pid: serverProcess.pid } : {};
+      if (onProcessStarted) {
+        onProcessStarted(processInfo.pid);
+      }
+      await serverProcess;
+      return processInfo;
+    }
+    return await runScript("dev", worktreePath, [], {
       env: {
-        ...process.env,
         ...envOverrides,
         PORT: port.toString()
-        // PORT always wins (explicit parameter)
       },
-      // Configure stdio based on whether we want to redirect output
-      stdio
+      foreground: true,
+      ...onProcessStarted && { onStart: onProcessStarted },
+      noCi: true
+      // Dev servers should not have CI=true
     });
-    const processInfo = serverProcess.pid !== void 0 ? { pid: serverProcess.pid } : {};
-    if (onProcessStarted) {
-      onProcessStarted(processInfo.pid);
-    }
-    await serverProcess;
-    return processInfo;
   }
   /**
    * Clean up all running server processes
@@ -187,4 +212,4 @@ var DevServerManager = class {
 export {
   DevServerManager
 };
-//# sourceMappingURL=chunk-SHVB3EFE.js.map
+//# sourceMappingURL=chunk-64O2UIWO.js.map

package/dist/chunk-64O2UIWO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/DevServerManager.ts","../src/utils/dev-server.ts"],"sourcesContent":["import { execa, type ExecaChildProcess } from 'execa'\nimport { setTimeout } from 'timers/promises'\nimport { ProcessManager } from './process/ProcessManager.js'\nimport { buildDevServerCommand } from '../utils/dev-server.js'\nimport { runScript } from '../utils/package-manager.js'\nimport { readPackageJson } from '../utils/package-json.js'\nimport { logger } from '../utils/logger.js'\n\nexport interface DevServerManagerOptions {\n\t/**\n\t * Maximum time to wait for server to start (in milliseconds)\n\t * Default: 30000 (30 seconds)\n\t */\n\tstartupTimeout?: number\n\n\t/**\n\t * Interval between port checks (in milliseconds)\n\t * Default: 1000 (1 second)\n\t */\n\tcheckInterval?: number\n}\n\n/**\n * DevServerManager handles auto-starting and monitoring dev servers\n * Used by open/run commands to ensure dev server is running before opening browser\n */\nexport class DevServerManager {\n\tprivate readonly processManager: ProcessManager\n\tprivate readonly options: Required<DevServerManagerOptions>\n\tprivate runningServers: Map<number, ExecaChildProcess> = new Map()\n\n\tconstructor(\n\t\tprocessManager?: ProcessManager,\n\t\toptions: DevServerManagerOptions = {}\n\t) {\n\t\tthis.processManager = processManager ?? new ProcessManager()\n\t\tthis.options = {\n\t\t\tstartupTimeout: options.startupTimeout ?? 30000,\n\t\t\tcheckInterval: options.checkInterval ?? 1000,\n\t\t}\n\t}\n\n\t/**\n\t * Ensure dev server is running on the specified port\n\t * If not running, start it and wait for it to be ready\n\t *\n\t * @param worktreePath - Path to the worktree\n\t * @param port - Port the server should run on\n\t * @returns true if server is ready, false if startup failed/timed out\n\t */\n\tasync ensureServerRunning(worktreePath: string, port: number): Promise<boolean> {\n\t\tlogger.debug(`Checking if dev server is running on port ${port}...`)\n\n\t\t// Check if already running\n\t\tconst existingProcess = await this.processManager.detectDevServer(port)\n\t\tif (existingProcess) {\n\t\t\tlogger.debug(\n\t\t\t\t`Dev server already running on port ${port} (PID: ${existingProcess.pid})`\n\t\t\t)\n\t\t\treturn true\n\t\t}\n\n\t\t// Not running - start it\n\t\tlogger.info(`Dev server not running on port ${port}, starting...`)\n\n\t\ttry {\n\t\t\tawait this.startDevServer(worktreePath, port)\n\t\t\treturn true\n\t\t} catch (error) {\n\t\t\tlogger.error(\n\t\t\t\t`Failed to start dev server: ${error instanceof Error ? error.message : 'Unknown error'}`\n\t\t\t)\n\t\t\treturn false\n\t\t}\n\t}\n\n\t/**\n\t * Start dev server in background and wait for it to be ready\n\t */\n\tprivate async startDevServer(worktreePath: string, port: number): Promise<void> {\n\t\t// Guard: Check if package.json exists and has a dev script\n\t\t// Note: buildDevServerCommand only supports package.json via package managers,\n\t\t// not package.iloom.json. See #406 for multi-language support.\n\t\ttry {\n\t\t\tconst packageJson = await readPackageJson(worktreePath)\n\t\t\tif (!packageJson.scripts?.['dev']) {\n\t\t\t\tlogger.warn('Skipping auto-start: no \"dev\" script found in package.json')\n\t\t\t\treturn\n\t\t\t}\n\t\t} catch {\n\t\t\t// package.json doesn't exist - skip auto-start silently\n\t\t\tlogger.debug('Skipping auto-start: no package.json found')\n\t\t\treturn\n\t\t}\n\n\t\t// Build dev server command\n\t\tconst devCommand = await buildDevServerCommand(worktreePath)\n\t\tlogger.debug(`Starting dev server with command: ${devCommand}`)\n\n\t\t// Start server in background\n\t\tconst serverProcess = execa('sh', ['-c', devCommand], {\n\t\t\tcwd: worktreePath,\n\t\t\tenv: {\n\t\t\t\t...process.env,\n\t\t\t\tPORT: port.toString(),\n\t\t\t},\n\t\t\t// Important: Don't inherit stdio - server runs in background\n\t\t\tstdio: 'ignore',\n\t\t\t// Detach from parent process so it continues running\n\t\t\tdetached: true,\n\t\t})\n\n\t\t// Store reference to prevent cleanup\n\t\tthis.runningServers.set(port, serverProcess)\n\n\t\t// Unref so parent can exit\n\t\tserverProcess.unref()\n\n\t\t// Wait for server to be ready\n\t\tlogger.info(`Waiting for dev server to start on port ${port}...`)\n\t\tconst ready = await this.waitForServerReady(port)\n\n\t\tif (!ready) {\n\t\t\tthrow new Error(\n\t\t\t\t`Dev server failed to start within ${this.options.startupTimeout}ms timeout`\n\t\t\t)\n\t\t}\n\n\t\tlogger.success(`Dev server started successfully on port ${port}`)\n\t}\n\n\t/**\n\t * Wait for server to be ready by polling the port\n\t */\n\tprivate async waitForServerReady(port: number): Promise<boolean> {\n\t\tconst startTime = Date.now()\n\t\tlet attempts = 0\n\n\t\twhile (Date.now() - startTime < this.options.startupTimeout) {\n\t\t\tattempts++\n\n\t\t\t// Check if server is listening\n\t\t\tconst processInfo = await this.processManager.detectDevServer(port)\n\n\t\t\tif (processInfo) {\n\t\t\t\tlogger.debug(\n\t\t\t\t\t`Server detected on port ${port} after ${attempts} attempts (${Date.now() - startTime}ms)`\n\t\t\t\t)\n\t\t\t\treturn true\n\t\t\t}\n\n\t\t\t// Wait before next check\n\t\t\tawait setTimeout(this.options.checkInterval)\n\t\t}\n\n\t\t// Timeout\n\t\tlogger.warn(\n\t\t\t`Server did not start on port ${port} after ${this.options.startupTimeout}ms (${attempts} attempts)`\n\t\t)\n\t\treturn false\n\t}\n\n\t/**\n\t * Check if a dev server is running on the specified port\n\t *\n\t * @param port - Port to check\n\t * @returns true if server is running, false otherwise\n\t */\n\tasync isServerRunning(port: number): Promise<boolean> {\n\t\tconst existingProcess = await this.processManager.detectDevServer(port)\n\t\treturn existingProcess !== null\n\t}\n\n\t/**\n\t * Run dev server in foreground mode (blocking)\n\t * This method blocks until the server is stopped (e.g., via Ctrl+C)\n\t *\n\t * @param worktreePath - Path to the worktree\n\t * @param port - Port the server should run on\n\t * @param redirectToStderr - If true, redirect stdout/stderr to stderr (useful for JSON output)\n\t * @param onProcessStarted - Callback called immediately after process starts with PID\n\t * @returns Process information including PID\n\t */\n\tasync runServerForeground(\n\t\tworktreePath: string,\n\t\tport: number,\n\t\tredirectToStderr = false,\n\t\tonProcessStarted?: (pid?: number) => void,\n\t\tenvOverrides?: Record<string, string>\n\t): Promise<{ pid?: number }> {\n\t\tlogger.debug(`Starting dev server in foreground on port ${port}`)\n\n\t\t// Use runScript for foreground mode to support multi-language projects\n\t\t// Note: redirectToStderr is handled via custom execa call when needed\n\t\tif (redirectToStderr) {\n\t\t\t// For redirectToStderr, we still need direct execa control for custom stdio\n\t\t\tconst devCommand = await buildDevServerCommand(worktreePath)\n\t\t\tlogger.debug(`Starting dev server with command: ${devCommand}`)\n\n\t\t\tconst serverProcess = execa('sh', ['-c', devCommand], {\n\t\t\t\tcwd: worktreePath,\n\t\t\t\tenv: {\n\t\t\t\t\t...process.env,\n\t\t\t\t\t...envOverrides,\n\t\t\t\t\tPORT: port.toString(),\n\t\t\t\t},\n\t\t\t\tstdio: [process.stdin, process.stderr, process.stderr],\n\t\t\t})\n\n\t\t\tconst processInfo: { pid?: number } = serverProcess.pid !== undefined ? { pid: serverProcess.pid } : {}\n\n\t\t\tif (onProcessStarted) {\n\t\t\t\tonProcessStarted(processInfo.pid)\n\t\t\t}\n\n\t\t\tawait serverProcess\n\t\t\treturn processInfo\n\t\t}\n\n\t\t// Use runScript for standard foreground mode\n\t\treturn await runScript('dev', worktreePath, [], {\n\t\t\tenv: {\n\t\t\t\t...envOverrides,\n\t\t\t\tPORT: port.toString(),\n\t\t\t},\n\t\t\tforeground: true,\n\t\t\t...(onProcessStarted && { onStart: onProcessStarted }),\n\t\t\tnoCi: true, // Dev servers should not have CI=true\n\t\t})\n\t}\n\n\t/**\n\t * Clean up all running server processes\n\t * This should be called when the manager is being disposed\n\t */\n\tasync cleanup(): Promise<void> {\n\t\tfor (const [port, serverProcess] of this.runningServers.entries()) {\n\t\t\ttry {\n\t\t\t\tlogger.debug(`Cleaning up server process on port ${port}`)\n\t\t\t\tserverProcess.kill()\n\t\t\t} catch (error) {\n\t\t\t\tlogger.warn(\n\t\t\t\t\t`Failed to kill server process on port ${port}: ${error instanceof Error ? error.message : 'Unknown error'}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\tthis.runningServers.clear()\n\t}\n}\n","import { detectPackageManager } from './package-manager.js'\nimport { logger } from './logger.js'\nimport type { Capability } from '../types/loom.js'\n\n/**\n * Build dev server command for workspace\n * Detects package manager and constructs appropriate command\n */\nexport async function buildDevServerCommand(\n\tworkspacePath: string\n): Promise<string> {\n\tconst packageManager = await detectPackageManager(workspacePath)\n\n\tlet devCommand: string\n\n\tswitch (packageManager) {\n\t\tcase 'pnpm':\n\t\t\tdevCommand = 'pnpm dev'\n\t\t\tbreak\n\t\tcase 'npm':\n\t\t\tdevCommand = 'npm run dev'\n\t\t\tbreak\n\t\tcase 'yarn':\n\t\t\tdevCommand = 'yarn dev'\n\t\t\tbreak\n\t\tdefault:\n\t\t\t// Fallback to npm (handles bun and other package managers)\n\t\t\tlogger.warn(`Unknown or unsupported package manager: ${packageManager}, defaulting to npm`)\n\t\t\tdevCommand = 'npm run dev'\n\t}\n\n\tlogger.debug(`Dev server command: ${devCommand}`)\n\treturn devCommand\n}\n\n/**\n * Build complete dev server launch command for terminal\n * Includes VSCode launch, echo message (only for web projects), and dev server start\n */\nexport async function getDevServerLaunchCommand(\n\tworkspacePath: string,\n\tport?: number,\n\tcapabilities: Capability[] = []\n): Promise<string> {\n\tconst devCommand = await buildDevServerCommand(workspacePath)\n\n\tconst commands: string[] = []\n\n\t// // Open VSCode\n\t// commands.push('code .')\n\n\t// Echo message (only for web projects)\n\tif (capabilities.includes('web')) {\n\t\tif (port !== undefined) {\n\t\t\tcommands.push(`echo 'Starting dev server on PORT=${port}...'`)\n\t\t} else {\n\t\t\tcommands.push(`echo 'Starting dev server...'`)\n\t\t}\n\t}\n\n\t// Start dev server\n\tcommands.push(devCommand)\n\n\treturn commands.join(' && ')\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-FXJKNVZW.js → chunk-6U6VI4SZ.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   PromptTemplateManager
-} from "./chunk-K5G5SFWY.js";
+} from "./chunk-W6WVRHJ6.js";
 import {
   SettingsManager
-} from "./chunk-IDUICCZY.js";
+} from "./chunk-F6WVM437.js";
 import {
   detectClaudeCli,
   launchClaude,
@@ -122,4 +122,4 @@ var ClaudeService = class {
 export {
   ClaudeService
 };
-//# sourceMappingURL=chunk-FXJKNVZW.js.map
+//# sourceMappingURL=chunk-6U6VI4SZ.js.map

package/dist/{chunk-QPS6TZUW.js → chunk-7WANFUIK.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ClaudeService
-} from "./chunk-FXJKNVZW.js";
+} from "./chunk-6U6VI4SZ.js";
 import {
   logger
 } from "./chunk-VT4PDUYT.js";
@@ -63,4 +63,4 @@ var ClaudeContextManager = class {
 export {
   ClaudeContextManager
 };
-//# sourceMappingURL=chunk-QPS6TZUW.js.map
+//# sourceMappingURL=chunk-7WANFUIK.js.map