@iloom/cli 0.1.18 → 0.2.0

package/README.md

@@ -35,7 +35,7 @@ The promise of AI-assisted development is profound: write more code, ship featur
 
 **AI agents write code quickly. They struggle to stay in sync with their humans.**
 
-When you juggle multiple issues, the hard part is not branches or ports. It is keeping you and your AI aligned on the goal.
+The hard part is not writing a ton of code. It's knowing what decisions your AI is making, what assumptions it's operating under, and why it's producing what it produces.
 
 Friction piles up:
 - You open new chats for each problem and rebuild context in your head.
@@ -47,7 +47,7 @@ The outcome is familiar: more time briefing the AI than building, more time fixi
 
 **The bottleneck isn't output velocity. It's maintaining shared understanding between human and AI at scale.**
 
-*iloom treats context as a first-class concern. It's not a tool for managing branches - it's a control plane for maintaining alignment between you and your AI assistant as you work across multiple issues simultaneously.*
+*iloom treats context as a first-class concern. It's not a tool for managing branches - it's a control plane for maintaining alignment between you and your AI assistant.*
 
 ## How iloom Solves This
 
@@ -316,7 +316,17 @@ iloom start <issue-number | pr-number | issue-description | branch-name>
 
 iloom finish
 # AI assisted validation, commit, merge steps, as well as loom cleanup (run this from the loom directory)
+# Behavior depends on mergeBehavior.mode setting:
+#   local (default): Merge locally and cleanup
+#   github-pr: Push branch, create PR, prompt for cleanup
 # Alias: dn
+# Options:
+#   -f, --force        - Skip confirmation prompts
+#   -n, --dry-run      - Preview actions without executing
+#   --skip-build       - Skip post-merge build verification
+#   --no-browser       - Skip opening PR in browser (github-pr mode only)
+#   --cleanup          - Clean up worktree after PR creation (github-pr mode only)
+#   --no-cleanup       - Keep worktree after PR creation (github-pr mode only)
 
 iloom rebase
 # Rebase current branch on main with Claude-assisted conflict resolution (run this from a loom directory)
@@ -382,20 +392,47 @@ Your feedback helps make iloom better for everyone! Issues created through `iloo
 
 ```bash
 iloom init
-# Setup guide for shell autocomplete, settings file initialization (will do much more soon)
+# Interactive Claude-powered configuration wizard
+# Sets up settings.json, .gitignore, and guides you through all configuration options
+# Automatically detects multi-remote setups and helps you configure GitHub integration
+# Alias: il config
 # Run this once per project
 
+iloom contribute
+# Set up local development environment for contributing to iloom
+# Automatically forks the repository, clones it locally, configures upstream remote,
+# and runs il init to complete setup
+# Streamlines contributor onboarding with a single command
+
 iloom update
 # Update iloom-cli to the latest version
 ```
 
 ## Configuration
 
-iloom uses a flexible configuration system with clear priority ordering.
+### Interactive Configuration Wizard
 
-### Configuration Priority
+The recommended way to configure iloom:
+
+```bash
+iloom init
+# or
+il config
+```
 
-Settings are loaded in this order (highest to lowest priority):
+This Claude-powered assistant will guide you through all configuration options and automatically:
+- Create and configure `.iloom/settings.json` and `.iloom/settings.local.json`
+- Set up `.gitignore` entries
+- Help you choose the right GitHub remote (if you have multiple)
+- Configure database providers (Neon, etc.)
+- Set workflow permissions and preferences
+- Explain each option as you go
+
+For most users, this is all you need. The wizard creates the files and explains everything as you configure it.
+
+### Manual Configuration Files
+
+If you prefer manual configuration, iloom uses these files (highest to lowest priority):
 
 1. **CLI arguments** - Command-line flags (e.g., `--one-shot bypassPermissions`)
 2. **`.iloom/settings.local.json`** - Local machine settings (gitignored, not committed)
@@ -416,6 +453,10 @@ This allows teams to share project defaults via `settings.json` while individual
 ```jsonc
 {
   "mainBranch": "main",
+  "mergeBehavior": {
+    "mode": "local",  // or "github-pr" for PR-based workflows
+    "remote": "upstream"  // optional, defaults to issueManagement.github.remote
+  },
   "capabilities": {
     "web": { "basePort": 3000 },
     "database": { "databaseUrlEnvVarName": "DATABASE_URL" }
@@ -450,6 +491,8 @@ This allows teams to share project defaults via `settings.json` while individual
 
 ** Common configuration options:**
 - `mainBranch` - Primary branch for merging (default: "main")
+- `mergeBehavior.mode` - How to finish work: "local" (merge locally) or "github-pr" (create PR) (default: "local")
+- `mergeBehavior.remote` - Remote to target for PRs (optional, defaults to `issueManagement.github.remote`)
 - `capabilities.web.basePort` - Base port for dev servers (default: 3000)
 - `capabilities.database.databaseUrlEnvVarName` - Name of environment variable for database connection URL (default: "DATABASE_URL")
 - `databaseProviders.neon.projectId` - Neon project ID (found in project URL, e.g., "fantastic-fox-3566354")
@@ -722,3 +765,7 @@ This project follows Test-Driven Development. All code must:
 For commercial licensing inquiries, contact Adam Creeger.
 
 See [LICENSE](https://raw.githubusercontent.com/iloom-ai/iloom-cli/main/LICENSE) for complete terms.
+
+## About the Name
+
+**iloom** comes from "illuminate" - it illuminates the mysterious AI coding process - and "intelligent loom" that weaves artificial and human intelligence together.

package/dist/ClaudeContextManager-LVCYRM6Q.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {
+  ClaudeContextManager
+} from "./chunk-2PLUQT6J.js";
+import "./chunk-LHP6ROUM.js";
+import "./chunk-MFU53H6J.js";
+import "./chunk-PVAVNJKS.js";
+import "./chunk-T3KEIB4D.js";
+import "./chunk-GEHQXLEI.js";
+export {
+  ClaudeContextManager
+};
+//# sourceMappingURL=ClaudeContextManager-LVCYRM6Q.js.map

package/dist/ClaudeService-WVTWB3DK.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  ClaudeService
+} from "./chunk-LHP6ROUM.js";
+import "./chunk-MFU53H6J.js";
+import "./chunk-PVAVNJKS.js";
+import "./chunk-T3KEIB4D.js";
+import "./chunk-GEHQXLEI.js";
+export {
+  ClaudeService
+};
+//# sourceMappingURL=ClaudeService-WVTWB3DK.js.map

package/dist/{GitHubService-SH4H6VS5.js → GitHubService-7E2S5NNZ.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   GitHubService
-} from "./chunk-IIPTBZQW.js";
-import "./chunk-DGEKUT7Q.js";
+} from "./chunk-TS6DL67T.js";
+import "./chunk-SWCRXDZC.js";
 import "./chunk-JNKJ7NJV.js";
 import "./chunk-GEHQXLEI.js";
 export {
   GitHubService
 };
-//# sourceMappingURL=GitHubService-SH4H6VS5.js.map
+//# sourceMappingURL=GitHubService-7E2S5NNZ.js.map

package/dist/{LoomLauncher-FB2MV2ZI.js → LoomLauncher-CTSWJL35.js}

@@ -5,18 +5,18 @@ import {
 import "./chunk-BLCTGFZN.js";
 import {
   ClaudeContextManager
-} from "./chunk-SLIMABFA.js";
+} from "./chunk-2PLUQT6J.js";
 import {
   openMultipleTerminalWindows,
   openTerminalWindow
-} from "./chunk-RSRO7564.js";
+} from "./chunk-ZE74H5BR.js";
 import {
   generateColorFromBranchName
 } from "./chunk-ZZZWQGTS.js";
-import "./chunk-HURVAQRK.js";
-import "./chunk-PXZBAC2M.js";
-import "./chunk-L4QGC27H.js";
-import "./chunk-VYQLLHZ7.js";
+import "./chunk-LHP6ROUM.js";
+import "./chunk-MFU53H6J.js";
+import "./chunk-PVAVNJKS.js";
+import "./chunk-T3KEIB4D.js";
 import {
   logger
 } from "./chunk-GEHQXLEI.js";
@@ -260,4 +260,4 @@ var LoomLauncher = class {
 export {
   LoomLauncher
 };
-//# sourceMappingURL=LoomLauncher-FB2MV2ZI.js.map
+//# sourceMappingURL=LoomLauncher-CTSWJL35.js.map

package/dist/{PromptTemplateManager-WM5GIPEF.js → PromptTemplateManager-WII75TKH.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   PromptTemplateManager
-} from "./chunk-L4QGC27H.js";
+} from "./chunk-PVAVNJKS.js";
 import "./chunk-GEHQXLEI.js";
 export {
   PromptTemplateManager
 };
-//# sourceMappingURL=PromptTemplateManager-WM5GIPEF.js.map
+//# sourceMappingURL=PromptTemplateManager-WII75TKH.js.map