@iloom/cli 0.11.1 → 0.13.0-beta.0

package/LICENSE

@@ -20,7 +20,7 @@ it within your organization. What is prohibited is redistributing or offering
 access to this software (in original or modified form) as part of something
 you sell or provide to others.
 
-Change Date: 2030-03-01
+Change Date: 2030-03-10
 Change License: Apache License 2.0
 
 For clarity, on or after the Change Date, the Licensed Work will

package/README.md

@@ -97,7 +97,7 @@ Each loom is a fully isolated container for your work:
 
 *   **Git Worktree:** A separate filesystem at ~/project-looms/issue-25/. No stashing, no branch switching overhead.
     
-*   **Database Branch:** (Neon support) Schema changes in this loom are isolated—they won't break your main environment or your other active looms.
+*   **Database Branch:** (Neon and Supabase support) Schema changes in this loom are isolated—they won't break your main environment or your other active looms.
 
 *   **Environment Variables:** Each loom has its own environment files (`.env`, `.env.local`, `.env.development`, `.env.development.local`). Uses `development` by default, override with `DOTENV_FLOW_NODE_ENV`. See [Secret Storage Limitations](#multi-language-project-support) for frameworks with encrypted credentials.
 
@@ -111,9 +111,9 @@ Each loom is a fully isolated container for your work:
     `ILOOM_COLOR_HEX` is useful for downstream tools that want to visually distinguish looms. For example, a Vite app can read it via `import.meta.env.VITE_ILOOM_COLOR_HEX` to tint the UI. See [Vite Integration Guide](docs/vite-iloom-color.md) for details.
 
 *   **Unique Runtime:**
-    
-    *   **Web Apps:** Runs on a deterministic port (e.g., base port 3000 + issue #25 = 3025).
-        
+
+    *   **Web Apps:** Runs on a deterministic port (e.g., base port 3000 + issue #25 = 3025). Optionally supports [Docker mode](#docker-dev-server) for frameworks that don't respect `PORT`.
+
     *   **CLI Tools:** Creates an isolated binary copy (e.g., my-tool-25). You can run issue #25's version of your CLI alongside issue #99's version without conflicts. (Fun fact: iloom was built with iloom using this feature).
         
 *   **Context Persistence:** All reasoning is stored in issue comments. This makes the "why" behind the code visible to your teammates and your future self.
@@ -153,7 +153,7 @@ Configuration
 
 ### 1. Interactive Setup (Recommended)
 
-The easiest way to configure iloom is the interactive wizard. It guides you through setting up your environment (GitHub/Linear, Neon, IDE).
+The easiest way to configure iloom is the interactive wizard. It guides you through setting up your environment (GitHub/Linear, Neon/Supabase, IDE).
 
 You can even use natural language to jump-start the process:
 
@@ -206,6 +206,21 @@ This example shows how to configure a project-wide default (e.g., GitHub remote)
 }
 ```
 
+Or, if using Supabase (requires a paid plan):
+
+```json
+{
+  "databaseProviders": {
+    "supabase": {
+      "projectRef": "abcdefghijklmnop",
+      "parentBranch": "main"
+    }
+  }
+}
+```
+
+> Only one database provider can be active at a time. See [Database Branching](docs/iloom-commands.md#database-branching) for full details.
+
 **.iloom/settings.local.json (Gitignored)**
 
 ```json
@@ -344,7 +359,7 @@ Control how `il finish` handles your work. Configure in `.iloom/settings.json`:
 ```json
 {
   "mergeBehavior": {
-    "mode": "local"  // "local", "github-pr", or "github-draft-pr"
+    "mode": "local"  // "local", "pr", or "draft-pr"
   }
 }
 ```
@@ -352,8 +367,8 @@ Control how `il finish` handles your work. Configure in `.iloom/settings.json`:
 | **Mode** | **Description** |
 |----------|-----------------|
 | `local` | (Default) Merge directly into main branch locally. Fast-forward merge, no PR created. |
-| `github-pr` | Push branch and create a GitHub PR on `il finish`. Worktree cleanup is optional. |
-| `github-draft-pr` | Create a draft PR immediately on `il start`. On `il finish`, the PR is marked ready for review. **Recommended for contributions to forked repos.** |
+| `pr` | Push branch and create a PR on `il finish`. Worktree cleanup is optional. |
+| `draft-pr` | Create a draft PR immediately on `il start`. On `il finish`, the PR is marked ready for review. **Recommended for contributions to forked repos.** |
 
 ### Artifact Review
 
@@ -411,8 +426,8 @@ When `il finish` or `il rebase` encounter rebase conflicts, iloom automatically
 
 Note: Potentially destructive commands like `git reset` and `git checkout` are intentionally not auto-approved to prevent accidental data loss.
 
-**When to use `github-draft-pr`:**
-- **Contributing to forks:** When you don't are contributing to a forked repo use this mode to create the PR from your fork immediately, allowing iloom's agents to post workflow comments directly to the PR instead of writing to the upstream repo's issues (which may not be appreciated by the repo owners).
+**When to use `draft-pr`:**
+- **Contributing to forks:** When you are contributing to a forked repo use this mode to create the PR from your fork immediately, allowing iloom's agents to post workflow comments directly to the PR instead of writing to the upstream repo's issues (which may not be appreciated by the repo owners).
 - CI runs on your branch during development (draft PRs trigger CI on most repos)
 - Your team requires PRs for all changes (no direct merges to main)
 - You want reviewers to see progress before the work is complete
@@ -430,6 +445,15 @@ iloom supports multiple issue tracking providers to fit your team's workflow.
 | **Linear**   | `il init` | Requires API token. Supports full read/write on Linear issues. |
 | **Jira**     | Configure in `.iloom/settings.json` | Atlassian Cloud. Requires API token. See [Jira Setup](#jira-setup) below. |
 
+### Version Control Providers
+
+Choose which platform hosts your pull requests and code reviews.
+
+| **Provider** | **Setup** | **Notes** |
+|--------------|-----------|-----------|
+| **GitHub**   | `gh auth login` | Default. Integrated with GitHub Issues. |
+| **BitBucket** | Configure in `.iloom/settings.json` | Atlassian Cloud. Requires API token. See [BitBucket Setup](#bitbucket-setup) below. |
+
 ### Jira Setup
 
 To use Jira as your issue tracker, add this configuration:
@@ -478,14 +502,122 @@ To use Jira as your issue tracker, add this configuration:
 - `doneStatuses`: (Optional) Status names to exclude from `il issues` lists (default: `["Done"]`). Set to match your Jira workflow, e.g., `["Done", "Closed", "Verified"]`
 - `transitionMappings`: (Optional) Map iloom states to your Jira workflow transition names
 
+### BitBucket Setup
+
+To use BitBucket for pull requests, add this configuration:
+
+**.iloom/settings.json (Committed)**
+```json
+{
+  "versionControl": {
+    "provider": "bitbucket",
+    "bitbucket": {
+      "username": "your-bitbucket-username",
+      "workspace": "your-workspace",
+      "repoSlug": "your-repo"
+    }
+  },
+  "mergeBehavior": {
+    "mode": "bitbucket-pr"
+  }
+}
+```
+
+**.iloom/settings.local.json (Gitignored - Never commit this file)**
+```json
+{
+  "versionControl": {
+    "bitbucket": {
+      "apiToken": "your-bitbucket-api-token"
+    }
+  }
+}
+```
+
+**Generate a BitBucket API Token:**
+1. Visit https://bitbucket.org/account/settings/app-passwords/
+2. Click "Create API token" (Note: App passwords were deprecated September 2025)
+3. Grant permissions: `repository:read`, `repository:write`, `pullrequest:read`, `pullrequest:write`
+4. Copy the token to `.iloom/settings.local.json`
+
+**Configuration Options:**
+- `username`: Your BitBucket username
+- `apiToken`: API token (store in settings.local.json only!)
+- `workspace`: (Optional) BitBucket workspace, auto-detected from git remote if not provided
+- `repoSlug`: (Optional) Repository slug, auto-detected from git remote if not provided
+- `reviewers`: (Optional) Array of BitBucket usernames to automatically add as PR reviewers. Usernames are resolved to BitBucket account IDs at PR creation time. Unresolved usernames are logged as warnings but don't block PR creation.
+
+**Example with Reviewers:**
+```json
+{
+  "versionControl": {
+    "provider": "bitbucket",
+    "bitbucket": {
+      "username": "your-bitbucket-username",
+      "reviewers": [
+        "alice.jones",
+        "bob.smith"
+      ]
+    }
+  },
+  "mergeBehavior": {
+    "mode": "bitbucket-pr"
+  }
+}
+```
+
+### Jira + BitBucket Together
+
+Use Jira for issues and BitBucket for pull requests:
+
+**.iloom/settings.json**
+```json
+{
+  "issueManagement": {
+    "provider": "jira",
+    "jira": {
+      "host": "https://yourcompany.atlassian.net",
+      "username": "your.email@company.com",
+      "projectKey": "PROJ"
+    }
+  },
+  "versionControl": {
+    "provider": "bitbucket",
+    "bitbucket": {
+      "username": "your-bitbucket-username"
+    }
+  },
+  "mergeBehavior": {
+    "mode": "bitbucket-pr"
+  }
+}
+```
+
+**.iloom/settings.local.json**
+```json
+{
+  "issueManagement": {
+    "jira": {
+      "apiToken": "your-jira-api-token"
+    }
+  },
+  "versionControl": {
+    "bitbucket": {
+      "apiToken": "your-bitbucket-api-token"
+    }
+  }
+}
+```
+
 
 ### IDE Support
 iloom creates isolated workspace settings for your editor. Color synchronization (visual context) only works best VS Code-based editors.
 
 *   **Supported:** VS Code, Cursor, Windsurf, Antigravity, WebStorm, IntelliJ, Sublime Text.
-    
+
 *   **Config:** Set your preference via `il init` or `il start --set ide.type=cursor`.
 
+
 ### Git Operation Settings
 
 Configure git operation timeouts for projects with long-running pre-commit hooks.
@@ -505,7 +637,6 @@ Configure git operation timeouts for projects with long-running pre-commit hooks
 
 **When to increase:** If you see timeout errors during `il commit` or `il finish`, your pre-commit hooks are taking longer than the default 60 seconds. Set a higher value based on your typical hook duration.
 
-
 Advanced Features
 -----------------
 
@@ -551,6 +682,27 @@ iloom provides first-class support for building CLI tools. When you start a loom
 > my-cli --version     # Unaffected by other looms' CLIs
 ```
 
+### Docker Dev Server
+
+By default, iloom runs your dev server as a native process and sets the `PORT` environment variable so each loom gets its own port. If your framework ignores `PORT` (e.g., Angular CLI hardcodes its listen port), you can opt in to Docker mode instead. You provide a Dockerfile, and iloom uses Docker's `-p` flag to map the container's port to the workspace port on the host — no changes to your app required.
+
+To enable it, create a Dockerfile that builds and runs your dev server, then set `devServer` to `"docker"` in `.iloom/settings.json`:
+
+```json
+{
+  "capabilities": {
+    "web": {
+      "devServer": "docker",
+      "containerPort": 4200
+    }
+  }
+}
+```
+
+Then use `il dev-server`, `il open`, or `il run` as normal.
+
+Docker Compose multi-service stacks are not yet supported — see [#332](https://github.com/iloom-ai/iloom-cli/issues/332) for the roadmap. For full configuration options and known limitations, see the [Complete Command Reference](docs/iloom-commands.md#docker-dev-server-mode).
+
 ### Epic Planning and Decomposition
 
 The `il plan` command launches an interactive Architect session that helps you break down complex features into manageable child issues.
@@ -673,7 +825,9 @@ This is an early-stage product.
 *   ✅ **Runtime:** Node.js 16+, Git 2.5+.
     
 *   ✅ **AI:** Claude CLI installed. A Claude Max subscription is recommended (iloom uses your subscription).
-    
+
+*   ☑️ **Docker** (optional): Only required if using [Docker dev server mode](#docker-dev-server). Docker Desktop or Docker Engine must be installed and running.
+
 
 **Project Support:**
 
@@ -718,7 +872,7 @@ This command:
 1. Forks the repository (if not already forked)
 2. Clones your fork locally
 3. Configures iloom for the project
-4. Sets merge behavior to `github-draft-pr` (creates a draft PR immediately when you start work)
+4. Sets merge behavior to `draft-pr` (creates a draft PR immediately when you start work)
 
 The draft PR workflow is ideal for open source: as you work, iloom posts the AI's analysis, implementation plan, and progress directly to that draft PR—giving maintainers full context before the code is even ready for review.
 
@@ -726,6 +880,7 @@ Acknowledgments
 ----------------
 
 - [@NoahCardoza](https://github.com/NoahCardoza) — Jira Cloud integration (PR [#588](https://github.com/iloom-ai/iloom-cli/pull/588)): JiraApiClient, JiraIssueTracker, ADF/Markdown conversion, MCP provider, sprint/mine filtering, and `il issues` Jira support.
+- [@NoahCardoza](https://github.com/NoahCardoza) — BitBucket integration (PR [#609](https://github.com/iloom-ai/iloom-cli/pull/609)): BitBucketApiClient, BitBucketVCSProvider, PR creation/listing, reviewer resolution, repository auto-detection, and token redaction.
 - [@TickTockBent](https://github.com/TickTockBent) — Linux, WSL, and tmux terminal support (PR [#796](https://github.com/iloom-ai/iloom-cli/pull/796)): strategy-pattern terminal backends, GUI-to-tmux fallback for headless environments, WSL detection, and cross-platform terminal launching.
 - [@rexsilex](https://github.com/rexsilex) — Original Linux/WSL terminal support design (PR [#649](https://github.com/iloom-ai/iloom-cli/pull/649)): pioneered the strategy pattern and backend interface that inspired the final implementation.
 
@@ -740,7 +895,7 @@ License & Name
     
 *   ❌ You cannot resell iloom itself as a product or SaaS.
     
-*   Converts to Apache 2.0 on 2030-03-01.
+*   Converts to Apache 2.0 on 2030-03-10.
     
 
 See [LICENSE](https://raw.githubusercontent.com/iloom-ai/iloom-cli/main/LICENSE) for complete terms.

package/dist/BitBucketApiClient-J2ZSCS5N.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  BitBucketApiClient
+} from "./chunk-P5MXXHXQ.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  BitBucketApiClient
+};
+//# sourceMappingURL=BitBucketApiClient-J2ZSCS5N.js.map

package/dist/BitBucketVCSProvider-5X64IXXW.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  BitBucketVCSProvider
+} from "./chunk-QC65IOV3.js";
+import "./chunk-P5MXXHXQ.js";
+import "./chunk-BZ7KTXPB.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  BitBucketVCSProvider
+};
+//# sourceMappingURL=BitBucketVCSProvider-5X64IXXW.js.map

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

@@ -3,12 +3,12 @@ import {
   ClaudeBranchNameStrategy,
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
-} from "./chunk-7NFCGKZT.js";
-import "./chunk-ZAXRQLK3.js";
-import "./chunk-H2SSF24U.js";
+} from "./chunk-AQUSMNBF.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
 export {
   ClaudeBranchNameStrategy,
   DefaultBranchNamingService,
   SimpleBranchNameStrategy
 };
-//# sourceMappingURL=BranchNamingService-XBCO747L.js.map
+//# sourceMappingURL=BranchNamingService-MEK2WZUD.js.map

package/dist/ClaudeContextManager-RRGREEZQ.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  ClaudeContextManager
+} from "./chunk-JDN4SPV3.js";
+import "./chunk-XCP2WDYA.js";
+import "./chunk-7RCUWU3I.js";
+import "./chunk-DDHWZNGL.js";
+import "./chunk-WGUGB54H.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  ClaudeContextManager
+};
+//# sourceMappingURL=ClaudeContextManager-RRGREEZQ.js.map

package/dist/ClaudeService-LEPW6QAC.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {
+  ClaudeService
+} from "./chunk-XCP2WDYA.js";
+import "./chunk-7RCUWU3I.js";
+import "./chunk-DDHWZNGL.js";
+import "./chunk-WGUGB54H.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  ClaudeService
+};
+//# sourceMappingURL=ClaudeService-LEPW6QAC.js.map

package/dist/GitHubService-UTAYZXL3.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  GitHubService
+} from "./chunk-D4Q7T5KD.js";
+import "./chunk-KV4NU3RP.js";
+import "./chunk-NPVA65KS.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  GitHubService
+};
+//# sourceMappingURL=GitHubService-UTAYZXL3.js.map

package/dist/IssueTrackerFactory-KE2BDCLC.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import {
+  IssueTrackerFactory
+} from "./chunk-NUUFP53X.js";
+import "./chunk-DMSL5BAP.js";
+import "./chunk-D4Q7T5KD.js";
+import "./chunk-KV4NU3RP.js";
+import "./chunk-NPVA65KS.js";
+import "./chunk-WGUGB54H.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  IssueTrackerFactory
+};
+//# sourceMappingURL=IssueTrackerFactory-KE2BDCLC.js.map

package/dist/{LoomLauncher-5AZU2F5I.js → LoomLauncher-GKQMR5E6.js}

@@ -1,29 +1,29 @@
 #!/usr/bin/env node
 import {
   openIdeWindow
-} from "./chunk-K7R5QY6C.js";
+} from "./chunk-CE676WCN.js";
 import {
   ClaudeContextManager
-} from "./chunk-6YVJVUR4.js";
+} from "./chunk-JDN4SPV3.js";
+import "./chunk-XCP2WDYA.js";
+import "./chunk-7RCUWU3I.js";
 import {
   getExecutablePath
 } from "./chunk-GYCR2LOU.js";
 import {
   generateColorFromBranchName,
   hexToRgb
-} from "./chunk-7OCGBJLR.js";
-import "./chunk-KQFIGI37.js";
-import "./chunk-Y3RX7LZT.js";
-import "./chunk-WG4MLJ6J.js";
-import "./chunk-ET6A2JR4.js";
+} from "./chunk-OIVFHJOA.js";
+import "./chunk-DDHWZNGL.js";
+import "./chunk-WGUGB54H.js";
 import {
   getLogger
-} from "./chunk-ZAXRQLK3.js";
+} from "./chunk-FTYWGQFM.js";
 import {
   getDotenvFlowFiles,
   openMultipleTerminalWindows,
   openTerminalWindow
-} from "./chunk-H2SSF24U.js";
+} from "./chunk-VRPPI6GU.js";
 
 // src/lib/LoomLauncher.ts
 import { existsSync } from "fs";
@@ -255,4 +255,4 @@ var LoomLauncher = class {
 export {
   LoomLauncher
 };
-//# sourceMappingURL=LoomLauncher-5AZU2F5I.js.map
+//# sourceMappingURL=LoomLauncher-GKQMR5E6.js.map

package/dist/MetadataManager-V4LSJ2PB.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  MetadataManager
+} from "./chunk-4JZEQBWV.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  MetadataManager
+};
+//# sourceMappingURL=MetadataManager-V4LSJ2PB.js.map

package/dist/ProjectCapabilityDetector-I4J66WKF.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  ProjectCapabilityDetector
+} from "./chunk-772N5WCA.js";
+import "./chunk-K3QGG4O2.js";
+import "./chunk-FTYWGQFM.js";
+import "./chunk-VRPPI6GU.js";
+export {
+  ProjectCapabilityDetector
+};
+//# sourceMappingURL=ProjectCapabilityDetector-I4J66WKF.js.map

package/dist/{PromptTemplateManager-T5VTLJP3.js → PromptTemplateManager-I75WKXM4.js}

@@ -2,10 +2,10 @@
 import {
   PromptTemplateManager,
   buildReviewTemplateVariables
-} from "./chunk-WG4MLJ6J.js";
-import "./chunk-H2SSF24U.js";
+} from "./chunk-7RCUWU3I.js";
+import "./chunk-VRPPI6GU.js";
 export {
   PromptTemplateManager,
   buildReviewTemplateVariables
 };
-//# sourceMappingURL=PromptTemplateManager-T5VTLJP3.js.map
+//# sourceMappingURL=PromptTemplateManager-I75WKXM4.js.map