@iloom/cli 0.7.0 → 0.7.1

package/dist/{ProjectCapabilityDetector-UZYW32SY.js → ProjectCapabilityDetector-IA56AUE6.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   ProjectCapabilityDetector
-} from "./chunk-3CDWFEGL.js";
-import "./chunk-ITN64ENQ.js";
+} from "./chunk-7GLZVDPQ.js";
+import "./chunk-XPKN3QWY.js";
 import "./chunk-6MLEBAYZ.js";
 import "./chunk-VT4PDUYT.js";
 export {
   ProjectCapabilityDetector
 };
-//# sourceMappingURL=ProjectCapabilityDetector-UZYW32SY.js.map
+//# sourceMappingURL=ProjectCapabilityDetector-IA56AUE6.js.map

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

@@ -8,12 +8,57 @@ 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.
+**Your Core Mission**: Detect the project's programming language and framework, then create the appropriate iloom package configuration file with 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)
 
+---
+
+## 🍴 FORK CHECK - DO THIS FIRST (Before Any File Decisions)
+
+**CRITICAL: Before creating ANY configuration file, check if this is a fork.**
+
+### Step 0: Detect Fork Pattern
+
+Run this check FIRST, before any other detection work:
+
+```bash
+git remote -v 2>/dev/null | grep -E '^(origin|upstream)\s' | awk '{print $1}' | sort -u
+```
+
+**If BOTH `origin` AND `upstream` are present → This is a FORK**
+
+### Fork Mode Behavior
+
+When fork is detected:
+
+1. **Default to `.iloom/package.iloom.local.json`** (NOT `package.iloom.json`)
+2. **Inform the user immediately:**
+   ```
+   🍴 Fork Detected (origin + upstream remotes)
+
+   For fork contributors, iloom configuration should be saved to LOCAL files
+   to prevent your personal settings from appearing in PRs to upstream.
+
+   Recommendation: Save to `.iloom/package.iloom.local.json`
+   - This file is globally gitignored
+   - Won't appear in your PRs to upstream
+   - Local scripts merge with package.iloom.json (local takes precedence)
+
+   If the upstream project already has package.iloom.json, your local file
+   will override/extend those scripts for your environment only.
+   ```
+
+3. **Proceed with detection** but write to the local file by default
+
+### Non-Fork Behavior
+
+If only `origin` exists (or no upstream), proceed normally with `package.iloom.json`.
+
+---
+
 ## Core Workflow
 
 ### Step 1: Scan for Language Markers
@@ -299,18 +344,37 @@ Create `.iloom/package.iloom.json` with appropriate scripts and capabilities bas
 
 ### Step 4: Write the File
 
-1. Read `.iloom/package.iloom.json` first to check if it already exists
-2. **If the file exists:**
+**⚠️ CHECKPOINT: Verify fork status from Step 0 before proceeding.**
+
+If fork was detected (both `origin` and `upstream` remotes exist):
+- Default target file: `.iloom/package.iloom.local.json`
+- This prevents personal config from appearing in PRs to upstream
+
+If NOT a fork:
+- Default target file: `.iloom/package.iloom.json`
+
+**Writing Process:**
+
+1. **Determine target file** based on fork status (see above)
+2. Read the target file first to check if it already exists
+3. **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:**
+4. **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)
+5. Ensure `.iloom/` directory exists
+6. Write the merged/new JSON to the target file
+7. Report what was detected, which file was written, and what changes were made (if any)
+
+**File Selection Summary:**
+| Scenario | Target File | Reason |
+|----------|-------------|--------|
+| Fork detected (origin + upstream) | `package.iloom.local.json` | Keeps PRs clean, gitignored globally |
+| Direct contributor (origin only) | `package.iloom.json` | Shared team configuration |
+| User explicitly requests shared | `package.iloom.json` | User override (even for forks) |
 
 ## Output Format
 
@@ -324,8 +388,9 @@ Detected:
 - Framework: [framework or "None detected"]
 - Package Manager: [package manager]
 - Capabilities: [cli, web, or none]
+- Fork Status: [Yes (origin + upstream) | No]
 
-Created: .iloom/package.iloom.json
+Created: .iloom/[package.iloom.json OR package.iloom.local.json]
 
 Configuration:
 - capabilities: [list of detected capabilities]
@@ -334,7 +399,11 @@ Configuration:
 - test: [command]
 - dev: [command]
 
-You can customize these settings by editing .iloom/package.iloom.json.
+[If fork]: This configuration was saved to the LOCAL file (package.iloom.local.json)
+           because you're working on a fork. This prevents your iloom settings
+           from appearing in PRs to upstream.
+
+You can customize these settings by editing .iloom/[filename].
 ```
 
 ## Error Handling

package/dist/{build-O2EJHDEW.js → build-HQ5HGA3T.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   ScriptCommandBase
-} from "./chunk-Z6BO53V7.js";
+} from "./chunk-ELJKYFSH.js";
 import "./chunk-5V74K5ZA.js";
-import "./chunk-LLWX3PCW.js";
+import "./chunk-RD7I2Q2F.js";
 import "./chunk-UDRZY65Y.js";
-import "./chunk-ITN64ENQ.js";
+import "./chunk-XPKN3QWY.js";
 import "./chunk-ZA575VLF.js";
 import "./chunk-WFQ5CLTR.js";
 import "./chunk-VWGKGNJP.js";
@@ -24,4 +24,4 @@ var BuildCommand = class extends ScriptCommandBase {
 export {
   BuildCommand
 };
-//# sourceMappingURL=build-O2EJHDEW.js.map
+//# sourceMappingURL=build-HQ5HGA3T.js.map

package/dist/{chunk-3CDWFEGL.js → chunk-7GLZVDPQ.js}

@@ -4,7 +4,7 @@ import {
   getPackageConfig,
   hasWebDependencies,
   parseBinField
-} from "./chunk-ITN64ENQ.js";
+} from "./chunk-XPKN3QWY.js";
 
 // src/lib/ProjectCapabilityDetector.ts
 var ProjectCapabilityDetector = class {
@@ -46,4 +46,4 @@ var ProjectCapabilityDetector = class {
 export {
   ProjectCapabilityDetector
 };
-//# sourceMappingURL=chunk-3CDWFEGL.js.map
+//# sourceMappingURL=chunk-7GLZVDPQ.js.map

package/dist/{chunk-GV5X6XUE.js → chunk-AFRICMSW.js}

@@ -5,10 +5,10 @@ import {
 import {
   detectPackageManager,
   runScript
-} from "./chunk-LLWX3PCW.js";
+} from "./chunk-RD7I2Q2F.js";
 import {
   readPackageJson
-} from "./chunk-ITN64ENQ.js";
+} from "./chunk-XPKN3QWY.js";
 import {
   logger
 } from "./chunk-VT4PDUYT.js";
@@ -212,4 +212,4 @@ var DevServerManager = class {
 export {
   DevServerManager
 };
-//# sourceMappingURL=chunk-GV5X6XUE.js.map
+//# sourceMappingURL=chunk-AFRICMSW.js.map

package/dist/{chunk-LQBLDI47.js → chunk-DAOS6EC3.js}

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   ProjectCapabilityDetector
-} from "./chunk-3CDWFEGL.js";
+} from "./chunk-7GLZVDPQ.js";
 import {
   detectPackageManager,
   runScript
-} from "./chunk-LLWX3PCW.js";
+} from "./chunk-RD7I2Q2F.js";
 import {
   getPackageConfig,
   hasScript
-} from "./chunk-ITN64ENQ.js";
+} from "./chunk-XPKN3QWY.js";
 import {
   executeGitCommand,
   findMainWorktreePathWithSettings,
@@ -467,4 +467,4 @@ export {
   MergeManager,
   BuildRunner
 };
-//# sourceMappingURL=chunk-LQBLDI47.js.map
+//# sourceMappingURL=chunk-DAOS6EC3.js.map

package/dist/{chunk-Z6BO53V7.js → chunk-ELJKYFSH.js}

@@ -4,13 +4,13 @@ import {
 } from "./chunk-5V74K5ZA.js";
 import {
   runScript
-} from "./chunk-LLWX3PCW.js";
+} from "./chunk-RD7I2Q2F.js";
 import {
   GitWorktreeManager
 } from "./chunk-UDRZY65Y.js";
 import {
   getPackageScripts
-} from "./chunk-ITN64ENQ.js";
+} from "./chunk-XPKN3QWY.js";
 import {
   extractIssueNumber
 } from "./chunk-ZA575VLF.js";
@@ -156,4 +156,4 @@ var ScriptCommandBase = class {
 export {
   ScriptCommandBase
 };
-//# sourceMappingURL=chunk-Z6BO53V7.js.map
+//# sourceMappingURL=chunk-ELJKYFSH.js.map

package/dist/{chunk-S7YMZQUD.js → chunk-QQFBMCAH.js}

@@ -6,11 +6,11 @@ import {
 import {
   installDependencies,
   runScript
-} from "./chunk-LLWX3PCW.js";
+} from "./chunk-RD7I2Q2F.js";
 import {
   getPackageConfig,
   hasScript
-} from "./chunk-ITN64ENQ.js";
+} from "./chunk-XPKN3QWY.js";
 import {
   branchExists,
   checkRemoteBranchStatus,
@@ -253,6 +253,7 @@ var LoomManager = class {
     const { capabilities, binEntries } = await this.capabilityDetector.detectCapabilities(worktreePath);
     await this.copyEnvironmentFiles(worktreePath);
     await this.copyIloomSettings(worktreePath);
+    await this.copyIloomPackageLocal(worktreePath);
     await this.copyClaudeSettings(worktreePath);
     await this.copyGitIgnoredFiles(worktreePath);
     const settingsData = await this.settings.loadSettings();
@@ -718,6 +719,27 @@ This PR was created automatically by iloom.`;
       getLogger().warn(`Warning: Failed to copy settings.local.json: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
   }
+  /**
+   * Copy iloom package local config (package.iloom.local.json) from main repo to worktree
+   * Always called regardless of project capabilities
+   * Follows the same pattern as copyIloomSettings()
+   * @param worktreePath Path to the worktree
+   */
+  async copyIloomPackageLocal(worktreePath) {
+    const mainPackageLocalPath = path2.join(process.cwd(), ".iloom", "package.iloom.local.json");
+    try {
+      const worktreeIloomDir = path2.join(worktreePath, ".iloom");
+      await fs2.ensureDir(worktreeIloomDir);
+      const worktreePackageLocalPath = path2.join(worktreeIloomDir, "package.iloom.local.json");
+      if (await fs2.pathExists(worktreePackageLocalPath)) {
+        getLogger().debug("package.iloom.local.json already exists in worktree, skipping copy");
+      } else {
+        await this.environment.copyIfExists(mainPackageLocalPath, worktreePackageLocalPath);
+      }
+    } catch (error) {
+      getLogger().warn(`Warning: Failed to copy package.iloom.local.json: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
   /**
    * Copy Claude settings (settings.local.json) from main repo to worktree
    * Always called regardless of project capabilities
@@ -968,6 +990,7 @@ This PR was created automatically by iloom.`;
     const { capabilities, binEntries } = await this.capabilityDetector.detectCapabilities(worktreePath);
     await this.copyEnvironmentFiles(worktreePath);
     await this.copyIloomSettings(worktreePath);
+    await this.copyIloomPackageLocal(worktreePath);
     await this.copyClaudeSettings(worktreePath);
     await this.copyGitIgnoredFiles(worktreePath);
     const settingsData = await this.settings.loadSettings();
@@ -2413,4 +2436,4 @@ export {
   DatabaseManager,
   ResourceCleanup
 };
-//# sourceMappingURL=chunk-S7YMZQUD.js.map
+//# sourceMappingURL=chunk-QQFBMCAH.js.map