@iloom/cli 0.5.4 → 0.6.0

package/README.md

@@ -120,7 +120,7 @@ Each loom is a fully isolated container for your work:
     
 *   **Database Branch:** (Neon 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`.
+*   **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.
 
 *   **Unique Runtime:**
     
@@ -144,6 +144,10 @@ Command Reference
 | `il spin` |  | Launch Claude inside the current loom with context auto-detected. |
 | `il open` | `run` | Open loom in browser (web) or run your CLI tool. |
 | `il dev-server` | `dev` | Start dev server in foreground for a workspace. |
+| `il build` |  | Run the build script for a workspace. |
+| `il lint` |  | Run the lint script for a workspace. |
+| `il test` |  | Run the test script for a workspace. |
+| `il compile` | `typecheck` | Run the compile or typecheck script for a workspace. |
 | `il add-issue` | `a` | Create and AI-enhance a new issue without starting work yet. |
 | `il init` | `config` | Interactive configuration wizard. |
 | `il feedback` | `f` | Submit bug reports/feedback directly from the CLI. |
@@ -232,6 +236,114 @@ This example shows how to configure a project-wide default (e.g., GitHub remote)
 }
 ```
 
+### Multi-Language/Framework Project Support
+
+iloom supports projects in any programming language through `.iloom/package.iloom.json`. This file defines scripts using raw shell commands instead of npm scripts.
+
+**File Location:** `.iloom/package.iloom.json`
+
+**Format:**
+```json
+{
+  "scripts": {
+    "install": "bundle install",
+    "build": "cargo build --release",
+    "test": "cargo test",
+    "dev": "cargo run",
+    "lint": "cargo clippy",
+    "typecheck": "cargo check"
+  }
+}
+```
+
+**Supported Scripts:**
+
+| Script | Purpose | When Used |
+|--------|---------|-----------|
+| `install` | Install dependencies | `il start` (loom creation), `il finish` (post-merge) |
+| `build` | Compile/build project | `il build`, `il finish` (CLI projects, post-merge) |
+| `test` | Run test suite | `il test`, `il finish` validation |
+| `dev` | Start dev server | `il dev-server` |
+| `lint` | Run linter | `il lint`, `il finish` validation |
+| `typecheck` | Type checking | `il typecheck`, `il finish` validation |
+| `compile` | Alternative to typecheck | `il compile`, `il finish` validation (preferred over typecheck if both exist) |
+
+All scripts are optional. If not defined, that step is skipped.
+
+**Language Examples:**
+
+| Language | Install | Build | Test | Dev | Lint | Typecheck |
+|----------|---------|-------|------|-----|------|-----------|
+| Rust | `cargo fetch` | `cargo build` | `cargo test` | `cargo run` | `cargo clippy` | `cargo check` |
+| Python (pip) | `pip install -e .` | - | `pytest` | `uvicorn app:app` | `ruff check .` | `mypy .` |
+| Python (poetry) | `poetry install` | - | `pytest` | `uvicorn app:app` | `ruff check .` | `mypy .` |
+| Ruby | `bundle install` | - | `bundle exec rspec` | `rails server` | `bundle exec rubocop` | - |
+| Go | `go mod download` | `go build ./...` | `go test ./...` | `go run .` | `golangci-lint run` | `go vet ./...` |
+
+**Precedence Rules:**
+1. `.iloom/package.iloom.json` (if exists) - highest priority
+2. `package.json` (if exists) - fallback for Node.js projects
+
+**Key Differences from package.json:**
+- Scripts are raw shell commands, executed directly (not via npm/pnpm)
+- No package manager prefix is added to commands
+- Works with any language's toolchain
+
+**Automatic Detection:** When running `il init` on a non-Node.js project, iloom will offer to detect your project's language and generate an appropriate `package.iloom.json`.
+
+**→ [Complete Multi-Language Project Guide](docs/multi-language-projects.md)** - Detailed setup instructions, more language examples, and troubleshooting.
+
+**Secret Storage Limitations:** iloom manages environment variables through standard `.env` files (via dotenv-flow). The following encrypted/proprietary secret storage formats are **not supported**:
+
+| Format | Why Unsupported |
+|--------|-----------------|
+| Rails encrypted credentials (`config/credentials.yml.enc`) | Requires Rails internals + master key |
+| ASP.NET Core User Secrets | Stored outside project at `~/.microsoft/usersecrets/<guid>/` |
+| SOPS/Sealed Secrets | Requires external decryption keys |
+
+**Recommendation:** If you want to use database isolation features (or anything else that requires updating env variables), use standard `.env` files for iloom compatibility. For Rails, consider [dotenv-rails](https://github.com/bkeepers/dotenv). For ASP.NET, use a local `.env` file alongside User Secrets.
+
+### Copying Gitignored Files to Looms
+
+By default, looms only contain files tracked by Git. If you have local files that are gitignored (like SQLite databases, test data, or sensitive configuration), they won't be available in your looms.
+
+**Automatically copied:** Some gitignored files are always copied to looms without configuration:
+- dotenv-flow files: `.env`, `.env.local`, `.env.development`, `.env.development.local`
+- `.iloom/settings.local.json`
+- `.claude/settings.local.json`
+
+For other gitignored files, use `copyGitIgnoredPatterns` to specify glob patterns for files that should be copied from your main repo to each loom.
+
+**When to use:**
+- **Local databases:** SQLite files (`*.db`, `*.sqlite`) for local development
+- **Test data:** Large test fixtures that are too big to commit to git
+- **Sensitive files:** Configuration files with credentials that shouldn't be in version control
+
+**.iloom/settings.json**
+
+```json
+{
+  "copyGitIgnoredPatterns": [
+    "*.db",
+    "*.sqlite",
+    "data/**/*.json",
+    "{data,fixtures}/*.sql"
+  ]
+}
+```
+
+**Supported patterns:**
+- `*.db` - Match files with .db extension in root
+- `**/*.db` - Recursively match all .db files in any directory
+- `data/**/*.sqlite` - Match .sqlite files anywhere under data/
+- `{data,backup}/*.db` - Match .db files in either data/ or backup/
+- `*.{db,sqlite}` - Match files with either .db or .sqlite extension
+
+**Notes:**
+- Files are copied from your main workspace to each loom during `il start`
+- Files are NOT copied back during `il finish` (one-way copy only)
+- The patterns use [fast-glob](https://github.com/mrmlnc/fast-glob) syntax
+
 ### Merge Behavior
 
 Control how `il finish` handles your work. Configure in `.iloom/settings.json`:
@@ -339,10 +451,10 @@ This is an early-stage product.
 **Project Support:**
 
 *   ✅ **Node.js Web Projects:** First-class support via package.json scripts (dev, test, build).
-    
+
 *   ✅ **Node.js CLI Tools:** Full support with isolated binary generation.
-    
-*   ⚠️ **Other Stacks:** Python/Go/Rust etc. can work via generic package.json scripts, but are not natively supported yet.    
+
+*   ✅ **Multi-Language Projects:** Python, Rust, Ruby, Go, and other languages via `.iloom/package.iloom.json`.    
 
 See all [known limitations](https://github.com/iloom-ai/iloom-cli/issues?q=is:issue+is:open+label:known-limitation) on GitHub. If you're feeling left out - you're absolutely right! The best way to complain about something is to fix it. So...
 

package/dist/{ClaudeContextManager-PQ46VILL.js → ClaudeContextManager-6J2EB4QU.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   ClaudeContextManager
-} from "./chunk-QPS6TZUW.js";
-import "./chunk-FXJKNVZW.js";
-import "./chunk-K5G5SFWY.js";
-import "./chunk-IDUICCZY.js";
+} from "./chunk-7WANFUIK.js";
+import "./chunk-6U6VI4SZ.js";
+import "./chunk-W6WVRHJ6.js";
+import "./chunk-F6WVM437.js";
 import "./chunk-AEIMYF4P.js";
 import "./chunk-6MLEBAYZ.js";
 import "./chunk-VT4PDUYT.js";
 export {
   ClaudeContextManager
 };
-//# sourceMappingURL=ClaudeContextManager-PQ46VILL.js.map
+//# sourceMappingURL=ClaudeContextManager-6J2EB4QU.js.map

package/dist/{ClaudeService-6OMO552H.js → ClaudeService-O2PB22GX.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   ClaudeService
-} from "./chunk-FXJKNVZW.js";
-import "./chunk-K5G5SFWY.js";
-import "./chunk-IDUICCZY.js";
+} from "./chunk-6U6VI4SZ.js";
+import "./chunk-W6WVRHJ6.js";
+import "./chunk-F6WVM437.js";
 import "./chunk-AEIMYF4P.js";
 import "./chunk-6MLEBAYZ.js";
 import "./chunk-VT4PDUYT.js";
 export {
   ClaudeService
 };
-//# sourceMappingURL=ClaudeService-6OMO552H.js.map
+//# sourceMappingURL=ClaudeService-O2PB22GX.js.map

package/dist/{LoomLauncher-ZHDTPKED.js → LoomLauncher-5LFM4LXB.js}

@@ -4,13 +4,13 @@ import {
 } from "./chunk-O7VL5N6S.js";
 import {
   ClaudeContextManager
-} from "./chunk-QPS6TZUW.js";
-import "./chunk-FXJKNVZW.js";
-import "./chunk-K5G5SFWY.js";
+} from "./chunk-7WANFUIK.js";
+import "./chunk-6U6VI4SZ.js";
+import "./chunk-W6WVRHJ6.js";
 import {
   getExecutablePath
 } from "./chunk-GYCR2LOU.js";
-import "./chunk-IDUICCZY.js";
+import "./chunk-F6WVM437.js";
 import {
   generateColorFromBranchName,
   hexToRgb
@@ -252,4 +252,4 @@ var LoomLauncher = class {
 export {
   LoomLauncher
 };
-//# sourceMappingURL=LoomLauncher-ZHDTPKED.js.map
+//# sourceMappingURL=LoomLauncher-5LFM4LXB.js.map

package/dist/ProjectCapabilityDetector-S5FLNCFI.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  ProjectCapabilityDetector
+} from "./chunk-ZPSTA5PR.js";
+import "./chunk-BXCPJJYM.js";
+import "./chunk-6MLEBAYZ.js";
+import "./chunk-VT4PDUYT.js";
+export {
+  ProjectCapabilityDetector
+};
+//# sourceMappingURL=ProjectCapabilityDetector-S5FLNCFI.js.map

package/dist/{PromptTemplateManager-5GNF7FCP.js → PromptTemplateManager-C3DK6XZL.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   PromptTemplateManager
-} from "./chunk-K5G5SFWY.js";
+} from "./chunk-W6WVRHJ6.js";
 import "./chunk-VT4PDUYT.js";
 export {
   PromptTemplateManager
 };
-//# sourceMappingURL=PromptTemplateManager-5GNF7FCP.js.map
+//# sourceMappingURL=PromptTemplateManager-C3DK6XZL.js.map

package/dist/README.md

@@ -120,7 +120,7 @@ Each loom is a fully isolated container for your work:
     
 *   **Database Branch:** (Neon 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`.
+*   **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.
 
 *   **Unique Runtime:**
     
@@ -144,6 +144,10 @@ Command Reference
 | `il spin` |  | Launch Claude inside the current loom with context auto-detected. |
 | `il open` | `run` | Open loom in browser (web) or run your CLI tool. |
 | `il dev-server` | `dev` | Start dev server in foreground for a workspace. |
+| `il build` |  | Run the build script for a workspace. |
+| `il lint` |  | Run the lint script for a workspace. |
+| `il test` |  | Run the test script for a workspace. |
+| `il compile` | `typecheck` | Run the compile or typecheck script for a workspace. |
 | `il add-issue` | `a` | Create and AI-enhance a new issue without starting work yet. |
 | `il init` | `config` | Interactive configuration wizard. |
 | `il feedback` | `f` | Submit bug reports/feedback directly from the CLI. |
@@ -232,6 +236,114 @@ This example shows how to configure a project-wide default (e.g., GitHub remote)
 }
 ```
 
+### Multi-Language/Framework Project Support
+
+iloom supports projects in any programming language through `.iloom/package.iloom.json`. This file defines scripts using raw shell commands instead of npm scripts.
+
+**File Location:** `.iloom/package.iloom.json`
+
+**Format:**
+```json
+{
+  "scripts": {
+    "install": "bundle install",
+    "build": "cargo build --release",
+    "test": "cargo test",
+    "dev": "cargo run",
+    "lint": "cargo clippy",
+    "typecheck": "cargo check"
+  }
+}
+```
+
+**Supported Scripts:**
+
+| Script | Purpose | When Used |
+|--------|---------|-----------|
+| `install` | Install dependencies | `il start` (loom creation), `il finish` (post-merge) |
+| `build` | Compile/build project | `il build`, `il finish` (CLI projects, post-merge) |
+| `test` | Run test suite | `il test`, `il finish` validation |
+| `dev` | Start dev server | `il dev-server` |
+| `lint` | Run linter | `il lint`, `il finish` validation |
+| `typecheck` | Type checking | `il typecheck`, `il finish` validation |
+| `compile` | Alternative to typecheck | `il compile`, `il finish` validation (preferred over typecheck if both exist) |
+
+All scripts are optional. If not defined, that step is skipped.
+
+**Language Examples:**
+
+| Language | Install | Build | Test | Dev | Lint | Typecheck |
+|----------|---------|-------|------|-----|------|-----------|
+| Rust | `cargo fetch` | `cargo build` | `cargo test` | `cargo run` | `cargo clippy` | `cargo check` |
+| Python (pip) | `pip install -e .` | - | `pytest` | `uvicorn app:app` | `ruff check .` | `mypy .` |
+| Python (poetry) | `poetry install` | - | `pytest` | `uvicorn app:app` | `ruff check .` | `mypy .` |
+| Ruby | `bundle install` | - | `bundle exec rspec` | `rails server` | `bundle exec rubocop` | - |
+| Go | `go mod download` | `go build ./...` | `go test ./...` | `go run .` | `golangci-lint run` | `go vet ./...` |
+
+**Precedence Rules:**
+1. `.iloom/package.iloom.json` (if exists) - highest priority
+2. `package.json` (if exists) - fallback for Node.js projects
+
+**Key Differences from package.json:**
+- Scripts are raw shell commands, executed directly (not via npm/pnpm)
+- No package manager prefix is added to commands
+- Works with any language's toolchain
+
+**Automatic Detection:** When running `il init` on a non-Node.js project, iloom will offer to detect your project's language and generate an appropriate `package.iloom.json`.
+
+**→ [Complete Multi-Language Project Guide](docs/multi-language-projects.md)** - Detailed setup instructions, more language examples, and troubleshooting.
+
+**Secret Storage Limitations:** iloom manages environment variables through standard `.env` files (via dotenv-flow). The following encrypted/proprietary secret storage formats are **not supported**:
+
+| Format | Why Unsupported |
+|--------|-----------------|
+| Rails encrypted credentials (`config/credentials.yml.enc`) | Requires Rails internals + master key |
+| ASP.NET Core User Secrets | Stored outside project at `~/.microsoft/usersecrets/<guid>/` |
+| SOPS/Sealed Secrets | Requires external decryption keys |
+
+**Recommendation:** If you want to use database isolation features (or anything else that requires updating env variables), use standard `.env` files for iloom compatibility. For Rails, consider [dotenv-rails](https://github.com/bkeepers/dotenv). For ASP.NET, use a local `.env` file alongside User Secrets.
+
+### Copying Gitignored Files to Looms
+
+By default, looms only contain files tracked by Git. If you have local files that are gitignored (like SQLite databases, test data, or sensitive configuration), they won't be available in your looms.
+
+**Automatically copied:** Some gitignored files are always copied to looms without configuration:
+- dotenv-flow files: `.env`, `.env.local`, `.env.development`, `.env.development.local`
+- `.iloom/settings.local.json`
+- `.claude/settings.local.json`
+
+For other gitignored files, use `copyGitIgnoredPatterns` to specify glob patterns for files that should be copied from your main repo to each loom.
+
+**When to use:**
+- **Local databases:** SQLite files (`*.db`, `*.sqlite`) for local development
+- **Test data:** Large test fixtures that are too big to commit to git
+- **Sensitive files:** Configuration files with credentials that shouldn't be in version control
+
+**.iloom/settings.json**
+
+```json
+{
+  "copyGitIgnoredPatterns": [
+    "*.db",
+    "*.sqlite",
+    "data/**/*.json",
+    "{data,fixtures}/*.sql"
+  ]
+}
+```
+
+**Supported patterns:**
+- `*.db` - Match files with .db extension in root
+- `**/*.db` - Recursively match all .db files in any directory
+- `data/**/*.sqlite` - Match .sqlite files anywhere under data/
+- `{data,backup}/*.db` - Match .db files in either data/ or backup/
+- `*.{db,sqlite}` - Match files with either .db or .sqlite extension
+
+**Notes:**
+- Files are copied from your main workspace to each loom during `il start`
+- Files are NOT copied back during `il finish` (one-way copy only)
+- The patterns use [fast-glob](https://github.com/mrmlnc/fast-glob) syntax
+
 ### Merge Behavior
 
 Control how `il finish` handles your work. Configure in `.iloom/settings.json`:
@@ -339,10 +451,10 @@ This is an early-stage product.
 **Project Support:**
 
 *   ✅ **Node.js Web Projects:** First-class support via package.json scripts (dev, test, build).
-    
+
 *   ✅ **Node.js CLI Tools:** Full support with isolated binary generation.
-    
-*   ⚠️ **Other Stacks:** Python/Go/Rust etc. can work via generic package.json scripts, but are not natively supported yet.    
+
+*   ✅ **Multi-Language Projects:** Python, Rust, Ruby, Go, and other languages via `.iloom/package.iloom.json`.    
 
 See all [known limitations](https://github.com/iloom-ai/iloom-cli/issues?q=is:issue+is:open+label:known-limitation) on GitHub. If you're feeling left out - you're absolutely right! The best way to complain about something is to fix it. So...
 

package/dist/{SettingsManager-CNYBGXDT.js → SettingsManager-35F5RUJH.js}

@@ -14,7 +14,7 @@ import {
   WorkflowPermissionSchemaNoDefaults,
   WorkflowsSettingsSchema,
   WorkflowsSettingsSchemaNoDefaults
-} from "./chunk-IDUICCZY.js";
+} from "./chunk-F6WVM437.js";
 import "./chunk-VT4PDUYT.js";
 export {
   AgentSettingsSchema,
@@ -32,4 +32,4 @@ export {
   WorkflowsSettingsSchema,
   WorkflowsSettingsSchemaNoDefaults
 };
-//# sourceMappingURL=SettingsManager-CNYBGXDT.js.map
+//# sourceMappingURL=SettingsManager-35F5RUJH.js.map