@graypark/loophaus 3.6.1 → 3.8.0

package/README.ko.md

@@ -153,11 +153,13 @@ loophaus는 세 개의 주요 코딩 에이전트 플랫폼을 지원합니다:
 | 기능 | Claude Code | Codex CLI | Kiro CLI |
 | --- | --- | --- | --- |
 | 자동 감지 설치 | `~/.claude/` | `~/.codex/` | `~/.kiro/` |
-| Stop hook | bash 기반 | Node.js 기반 | bash 기반 |
+| Stop hook | Node.js 기반 | Node.js 기반 | Node.js 기반 |
 | 루프 실행 | Skill tool | 네이티브 커맨드 | 네이티브 커맨드 |
 | 멀티 에이전트 | Agent tool | 서브에이전트 | 서브에이전트 |
 | 상태 파일 | `.loophaus/state.json` | `.loophaus/state.json` | `.loophaus/state.json` |
 
+Windows에서도 PowerShell/CMD 기준으로 `install`, `upgrade`, `/loop` 초기화가 동작합니다. Git Bash나 WSL은 선택사항입니다.
+
 ## 설치
 
 ### 글로벌 설치 (권장)
@@ -167,6 +169,8 @@ npm install -g @graypark/loophaus
 loophaus install
 ```
 
+Windows에서는 전역 npm 실행 파일 경로(보통 `%AppData%\npm`)가 `PATH`에 포함되어 있어야 합니다.
+
 ### npx로 설치
 
 ```bash
@@ -366,6 +370,12 @@ Phase 2 — 순차 수정 (루프):
 
 ## 업데이트
 
+```bash
+loophaus upgrade
+```
+
+수동 업데이트가 필요하면:
+
 ```bash
 npm install -g @graypark/loophaus@latest
 loophaus install --force
@@ -381,7 +391,7 @@ npm uninstall -g @graypark/loophaus
 ## 개발
 
 ```bash
-npm install && npm test    # 296개 테스트
+npm install && npm test
 npm run typecheck          # TypeScript strict 모드
 npm run build              # dist/로 컴파일
 npx vitest                # watch 모드

package/README.md

@@ -119,6 +119,8 @@ That's it. The interview generates a PRD, activates the loop, and starts impleme
 
 All three platforms share the same core engine (`core/engine.ts`) and state store (`store/state-store.ts`). Platform-specific adapters handle the differences.
 
+Native Windows is supported for install, upgrade, and `/loop` initialization via PowerShell or CMD. Git Bash and WSL are optional, not required.
+
 ## Installation
 
 ### Global install (recommended)
@@ -128,6 +130,8 @@ npm install -g @graypark/loophaus
 loophaus install
 ```
 
+On Windows, ensure your global npm bin directory (typically `%AppData%\npm`) is on `PATH`.
+
 ### Via npx
 
 ```bash
@@ -283,6 +287,12 @@ Each story is sized to complete in one iteration (one context window). Dependenc
 
 ## Update
 
+```bash
+loophaus upgrade
+```
+
+Manual upgrade also works:
+
 ```bash
 npm install -g @graypark/loophaus@latest
 loophaus install --force
@@ -301,7 +311,7 @@ npm uninstall -g @graypark/loophaus
 git clone https://github.com/vcz-Gray/loophaus.git
 cd loophaus
 npm install
-npm test          # 296 test cases
+npm test
 npm run typecheck  # TypeScript strict mode
 npm run build      # Compile to dist/
 npx vitest        # watch mode

package/commands/cancel-ralph.md

@@ -1,11 +1,6 @@
 ---
 description: "Cancel active Ralph Loop"
-allowed-tools:
-  [
-    "Bash(test -f .claude/ralph-loop.local.md:*)",
-    "Bash(rm .claude/ralph-loop.local.md)",
-    "Read(.claude/ralph-loop.local.md)",
-  ]
+allowed-tools: ["Bash", "Read"]
 hide-from-slash-command-tool: "true"
 ---
 
@@ -13,11 +8,11 @@ hide-from-slash-command-tool: "true"
 
 To cancel the Ralph loop:
 
-1. Check if `.claude/ralph-loop.local.md` exists using Bash: `test -f .claude/ralph-loop.local.md && echo "EXISTS" || echo "NOT_FOUND"`
+1. Check if `.claude/ralph-loop.local.md` exists using a cross-platform Node command.
 
 2. **If NOT_FOUND**: Say "No active Ralph loop found."
 
 3. **If EXISTS**:
    - Read `.claude/ralph-loop.local.md` to get the current iteration number from the `iteration:` field
-   - Remove the file using Bash: `rm .claude/ralph-loop.local.md`
+   - Remove the file using a cross-platform Node file command
    - Report: "Cancelled Ralph loop (was at iteration N)" where N is the iteration value

package/commands/loop-plan.md

@@ -11,6 +11,49 @@ The user runs `/loop-plan` once and gets a single merged branch with all work do
 
 ---
 
+## Pre-flight: Update Check
+
+Run `loophaus update-check` silently before starting.
+
+If the command reports an available update:
+1. Show: `loophaus update available: v{current} → v{latest}`
+2. Ask user:
+   - **A) Upgrade now** → run `loophaus upgrade`, then continue
+   - **B) Always auto-upgrade** → run `loophaus config set autoUpgrade true && loophaus upgrade`, then continue
+   - **C) Not now** → run `loophaus config set updateCheck snoozed` silently, then continue
+   - **D) Never ask again** → run `loophaus config set updateCheck false`, then continue
+
+If auto-upgrade is enabled (`loophaus config get autoUpgrade` returns `true`):
+- Skip prompt, run `loophaus upgrade` silently, continue.
+
+If no update is available or the check fails: continue silently and never block the user.
+
+## Pre-flight: Skill Routing Check
+
+Check if the project has a CLAUDE.md with loophaus skill routing:
+
+```bash
+CLAUDE_MD="$(pwd)/CLAUDE.md"
+ROUTING_MARKER=".loophaus/routing-offered.json"
+```
+
+If CLAUDE.md exists but has no `## loophaus skill routing` section, AND routing hasn't been offered before:
+1. Suggest adding this section to CLAUDE.md:
+   ```markdown
+   ## loophaus skill routing
+   
+   | User intent | Route to |
+   |-------------|----------|
+   | Feature implementation, refactoring, multi-step task | `/loophaus:loop-plan` |
+   | "start the loop", "continue implementing" | `/loophaus:loop` |
+   | "stop the loop", "cancel" | `/loophaus:loop-stop` |
+   | "what's the status", "how far along" | `/loophaus:loop-pulse` |
+   ```
+2. If user agrees, add the section to CLAUDE.md
+3. Write `{ "offeredAt": "<ISO date>" }` to `.loophaus/routing-offered.json` so we don't ask again
+
+If CLAUDE.md doesn't exist or routing already offered: skip silently.
+
 ## Phase 0: Cleanup Previous Data
 
 Before starting a new plan, apply the cleanup policy from `.loophaus/config.json`:

package/commands/loop-stop.md

@@ -1,29 +1,21 @@
 ---
 description: "Stop active loop"
-allowed-tools:
-  [
-    "Bash(test -f .loophaus/state.json:*)",
-    "Bash(rm .loophaus/state.json)",
-    "Read(.loophaus/state.json)",
-    "Bash(test -f .claude/ralph-loop.local.md:*)",
-    "Bash(rm .claude/ralph-loop.local.md)",
-    "Read(.claude/ralph-loop.local.md)",
-  ]
+allowed-tools: ["Bash", "Read"]
 ---
 
 # /loop-stop — Stop Active Loop
 
-1. Check if `.loophaus/state.json` exists: `test -f .loophaus/state.json && echo "EXISTS" || echo "NOT_FOUND"`
-   - If not found, also check legacy path: `test -f .claude/ralph-loop.local.md && echo "LEGACY" || echo "NOT_FOUND"`
+1. Check if `.loophaus/state.json` exists using a cross-platform Node command.
+   - If not found, also check legacy path `.claude/ralph-loop.local.md`.
 
 2. **If NOT_FOUND** on both: Say "No active loop found."
 
 3. **If EXISTS** (.loophaus/state.json):
    - Read the file to get `currentIteration`
-   - Remove it: `rm .loophaus/state.json`
+   - Remove it with a cross-platform Node file command
    - Report: "Stopped loop at iteration N."
 
 4. **If LEGACY** (.claude/ralph-loop.local.md):
    - Read it to get the iteration field
-   - Remove it: `rm .claude/ralph-loop.local.md`
+   - Remove it with a cross-platform Node file command
    - Report: "Stopped loop at iteration N. (migrated from legacy path)"

package/commands/loop.md

@@ -1,15 +1,24 @@
 ---
 description: "Start iterative dev loop"
 argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]"
-allowed-tools: ["Bash(${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh:*)"]
+allowed-tools: ["Bash"]
 ---
 
 # /loop — Start Iterative Dev Loop
 
+## Pre-flight
+
+Run `loophaus update-check` quietly before starting.
+If it reports an available update and auto-upgrade is enabled, run `loophaus upgrade` and continue.
+If it reports an available update and auto-upgrade is disabled, show one-line notice: `loophaus update available. Run: loophaus upgrade`.
+If the check fails or no update is available, continue silently.
+
+---
+
 Execute the setup script to initialize the loop:
 
 ```!
-"${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh" $ARGUMENTS
+node "${CLAUDE_PLUGIN_ROOT}/scripts/setup-loop.mjs" $ARGUMENTS
 ```
 
 Work on the task. When you try to exit, the stop hook feeds the SAME PROMPT back for the next iteration. Your previous work persists in files and git history.

package/commands/ralph-loop.md

@@ -1,7 +1,7 @@
 ---
 description: "Start Ralph Loop in current session"
 argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]"
-allowed-tools: ["Bash(${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh:*)"]
+allowed-tools: ["Bash"]
 hide-from-slash-command-tool: "true"
 ---
 
@@ -10,7 +10,7 @@ hide-from-slash-command-tool: "true"
 Execute the setup script to initialize the Ralph loop:
 
 ```!
-"${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh" $ARGUMENTS
+node "${CLAUDE_PLUGIN_ROOT}/scripts/setup-loop.mjs" $ARGUMENTS
 ```
 
 Please work on the task. When you try to exit, the Ralph loop will feed the SAME PROMPT back to you for the next iteration. You'll see your previous work in files and git history, allowing you to iterate and improve.

package/dist/README.ko.md

@@ -153,11 +153,13 @@ loophaus는 세 개의 주요 코딩 에이전트 플랫폼을 지원합니다:
 | 기능 | Claude Code | Codex CLI | Kiro CLI |
 | --- | --- | --- | --- |
 | 자동 감지 설치 | `~/.claude/` | `~/.codex/` | `~/.kiro/` |
-| Stop hook | bash 기반 | Node.js 기반 | bash 기반 |
+| Stop hook | Node.js 기반 | Node.js 기반 | Node.js 기반 |
 | 루프 실행 | Skill tool | 네이티브 커맨드 | 네이티브 커맨드 |
 | 멀티 에이전트 | Agent tool | 서브에이전트 | 서브에이전트 |
 | 상태 파일 | `.loophaus/state.json` | `.loophaus/state.json` | `.loophaus/state.json` |
 
+Windows에서도 PowerShell/CMD 기준으로 `install`, `upgrade`, `/loop` 초기화가 동작합니다. Git Bash나 WSL은 선택사항입니다.
+
 ## 설치
 
 ### 글로벌 설치 (권장)
@@ -167,6 +169,8 @@ npm install -g @graypark/loophaus
 loophaus install
 ```
 
+Windows에서는 전역 npm 실행 파일 경로(보통 `%AppData%\npm`)가 `PATH`에 포함되어 있어야 합니다.
+
 ### npx로 설치
 
 ```bash
@@ -366,6 +370,12 @@ Phase 2 — 순차 수정 (루프):
 
 ## 업데이트
 
+```bash
+loophaus upgrade
+```
+
+수동 업데이트가 필요하면:
+
 ```bash
 npm install -g @graypark/loophaus@latest
 loophaus install --force
@@ -381,7 +391,7 @@ npm uninstall -g @graypark/loophaus
 ## 개발
 
 ```bash
-npm install && npm test    # 296개 테스트
+npm install && npm test
 npm run typecheck          # TypeScript strict 모드
 npm run build              # dist/로 컴파일
 npx vitest                # watch 모드

package/dist/README.md

@@ -119,6 +119,8 @@ That's it. The interview generates a PRD, activates the loop, and starts impleme
 
 All three platforms share the same core engine (`core/engine.ts`) and state store (`store/state-store.ts`). Platform-specific adapters handle the differences.
 
+Native Windows is supported for install, upgrade, and `/loop` initialization via PowerShell or CMD. Git Bash and WSL are optional, not required.
+
 ## Installation
 
 ### Global install (recommended)
@@ -128,6 +130,8 @@ npm install -g @graypark/loophaus
 loophaus install
 ```
 
+On Windows, ensure your global npm bin directory (typically `%AppData%\npm`) is on `PATH`.
+
 ### Via npx
 
 ```bash
@@ -283,6 +287,12 @@ Each story is sized to complete in one iteration (one context window). Dependenc
 
 ## Update
 
+```bash
+loophaus upgrade
+```
+
+Manual upgrade also works:
+
 ```bash
 npm install -g @graypark/loophaus@latest
 loophaus install --force
@@ -301,7 +311,7 @@ npm uninstall -g @graypark/loophaus
 git clone https://github.com/vcz-Gray/loophaus.git
 cd loophaus
 npm install
-npm test          # 296 test cases
+npm test
 npm run typecheck  # TypeScript strict mode
 npm run build      # Compile to dist/
 npx vitest        # watch mode

package/dist/bin/loophaus.js

@@ -3,6 +3,8 @@
 import { resolve, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { access } from "node:fs/promises";
+import { getLoophausHome } from "../lib/paths.js";
+import { getGlobalBinaryPath, runCommand } from "../lib/runtime.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const PROJECT_ROOT = resolve(__dirname, "..");
@@ -16,12 +18,13 @@ const showHelp = args.includes("--help") || args.includes("-h");
 const KNOWN_FLAGS = new Set([
     "--help", "-h", "--version", "--dry-run", "--force", "--local", "--verbose",
     "--host", "--claude", "--kiro", "--name", "--speed", "--count", "--base", "--story",
-    "--all", "--traces", "--sessions", "--results", "--before", "--config",
+    "--all", "--traces", "--sessions", "--results", "--before", "--config", "--quiet",
 ]);
 const VALID_COMMANDS = [
     "install", "uninstall", "status", "stats", "loops", "watch",
     "replay", "compare", "worktree", "parallel", "quality",
-    "sessions", "resume", "benchmark", "clean", "help",
+    "sessions", "resume", "benchmark", "clean", "config",
+    "update-check", "upgrade", "help",
 ];
 function validateFlags() {
     for (const arg of args) {
@@ -114,6 +117,9 @@ Usage:
   npx @graypark/loophaus quality [--story US-001]
   npx @graypark/loophaus benchmark
   npx @graypark/loophaus clean [--all|--traces|--sessions|--results] [--before DATE]
+  npx @graypark/loophaus config [list|get|set] [key] [value]
+  npx @graypark/loophaus update-check
+  npx @graypark/loophaus upgrade
   npx @graypark/loophaus sessions
   npx @graypark/loophaus resume <session-id>
   npx @graypark/loophaus --version
@@ -156,6 +162,11 @@ async function detectHosts() {
     return hosts;
 }
 async function runInstall() {
+    const { getPackageVersion } = await import("../lib/paths.js");
+    const version = getPackageVersion();
+    const quiet = args.includes("--quiet");
+    const loophausDir = getLoophausHome();
+    const welcomePath = join(loophausDir, ".welcome-seen");
     let targets = [];
     if (host) {
         targets = [host];
@@ -192,6 +203,57 @@ async function runInstall() {
             s?.stop();
         }
     }
+    if (quiet || dryRun)
+        return;
+    // First-run welcome or upgrade notice
+    const { mkdir: mk, writeFile: wf, readFile: rf } = await import("node:fs/promises");
+    await mk(loophausDir, { recursive: true });
+    let isFirstRun = false;
+    try {
+        const seen = await rf(welcomePath, "utf-8");
+        // Existing install — show What's New if version changed
+        if (seen.trim() !== version) {
+            await wf(welcomePath, version, "utf-8");
+            try {
+                const changelog = await rf(join(__dirname, "..", "CHANGELOG.md"), "utf-8");
+                const firstEntry = changelog.match(/## \[[\d.]+\][^\n]*\n([\s\S]*?)(?=\n## \[|$)/);
+                if (firstEntry) {
+                    console.log(`\n  \x1b[36mWhat's New in v${version}:\x1b[0m`);
+                    const lines = firstEntry[1].trim().split("\n").slice(0, 8);
+                    for (const l of lines)
+                        console.log(`  ${l}`);
+                }
+            }
+            catch { /* no CHANGELOG */ }
+        }
+    }
+    catch {
+        isFirstRun = true;
+        await wf(welcomePath, version, "utf-8");
+    }
+    if (isFirstRun) {
+        console.log(`
+  \x1b[36m\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\x1b[0m
+  Welcome to \x1b[1mloophaus\x1b[0m v${version}
+
+  Control plane for coding agents.
+  Iterative dev loops with quality verification.
+
+  Quick start:
+    /loop-plan <describe your task>
+
+  Commands:
+    /loop-plan   Interview → PRD → implement → verify
+    /loop        Start loop with existing PRD
+    /loop-pulse  Check progress
+    /loop-stop   Cancel loop
+
+  CLI:
+    loophaus benchmark    Project quality score
+    loophaus config list  View settings
+    loophaus upgrade      Update to latest
+  \x1b[36m\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\x1b[0m`);
+    }
 }
 async function runUninstall() {
     if (host === "claude-code" || args.includes("--claude")) {
@@ -683,6 +745,139 @@ Options:
         console.log("  Nothing to clean.");
     }
 }
+async function runUpdateCheck() {
+    const { getPackageVersion } = await import("../lib/paths.js");
+    const { checkForUpdate } = await import("../core/update-checker.js");
+    const current = getPackageVersion();
+    const result = await checkForUpdate(current);
+    console.log("Update Check");
+    console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    console.log(`  Current:  v${result.current}`);
+    console.log(`  Latest:   v${result.latest}`);
+    console.log(`  Status:   ${result.status}`);
+    if (result.message)
+        console.log(`  Note:     ${result.message}`);
+    if (result.status === "upgrade_available") {
+        console.log(`\n  \x1b[33mUpdate available: v${result.current} → v${result.latest}\x1b[0m`);
+        console.log(`  Run: loophaus upgrade`);
+    }
+}
+async function runUpgrade() {
+    const { getPackageVersion } = await import("../lib/paths.js");
+    const { checkForUpdate } = await import("../core/update-checker.js");
+    const current = getPackageVersion();
+    const result = await checkForUpdate(current);
+    if (result.status === "up_to_date") {
+        console.log(`Already on latest version: v${current}`);
+        return;
+    }
+    if (result.status !== "upgrade_available" && result.status !== "snoozed") {
+        console.log(`No update available (status: ${result.status})`);
+        return;
+    }
+    console.log(`Upgrading loophaus: v${result.current} → v${result.latest}`);
+    const s = spinner("Installing...");
+    try {
+        await runCommand("npm", ["install", "-g", `@graypark/loophaus@${result.latest}`], { timeout: 120_000 });
+        s.stop();
+        console.log(`\u2714 Installed v${result.latest}`);
+        const s2 = spinner("Reinstalling plugins...");
+        try {
+            const { stdout: prefixStdout } = await runCommand("npm", ["prefix", "-g"], { timeout: 30_000 });
+            const globalLoophaus = getGlobalBinaryPath(prefixStdout.trim(), "loophaus");
+            await runCommand(globalLoophaus, ["install", "--force"], { timeout: 60_000 });
+            s2.stop();
+            console.log("\u2714 Plugins reinstalled");
+        }
+        catch {
+            s2.stop();
+            console.log("  Note: Run 'loophaus install --force' to update plugins.");
+        }
+        console.log(`\n  Upgrade complete: v${result.current} → v${result.latest}`);
+    }
+    catch (err) {
+        s.stop();
+        console.error(`\u2718 Upgrade failed: ${err.message}`);
+        console.error("  Try manually: npm install -g @graypark/loophaus@latest");
+    }
+}
+async function runConfigCmd() {
+    const { readConfig, writeConfig } = await import("../core/cleanup.js");
+    const sub = args[1];
+    const KNOWN_KEYS = {
+        "cleanup.onNewPlan": "Policy when /loop-plan starts: archive | delete | keep",
+        "cleanup.traceRetentionDays": "Days to keep trace data",
+        "cleanup.sessionRetentionDays": "Days to keep session checkpoints",
+        "updateCheck": "Check for updates on skill execution: true | false",
+        "autoUpgrade": "Auto-upgrade without prompting: true | false",
+    };
+    if (!sub || sub === "list") {
+        const config = await readConfig();
+        console.log("Configuration (.loophaus/config.json)");
+        console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
+        for (const [key, desc] of Object.entries(KNOWN_KEYS)) {
+            const val = getNestedValue(config, key);
+            console.log(`  ${key.padEnd(30)} ${String(val ?? "(default)").padEnd(12)} ${desc}`);
+        }
+        console.log(`\nUsage: loophaus config set <key> <value>`);
+        return;
+    }
+    if (sub === "get") {
+        const key = args[2];
+        if (!key) {
+            console.log("Usage: loophaus config get <key>");
+            return;
+        }
+        const config = await readConfig();
+        const val = getNestedValue(config, key);
+        console.log(val !== undefined ? String(val) : "(not set)");
+        return;
+    }
+    if (sub === "set") {
+        const key = args[3] ? args[2] : args[2];
+        const value = args[3] || args[3];
+        if (!key || value === undefined) {
+            console.log("Usage: loophaus config set <key> <value>");
+            return;
+        }
+        const rawValue = args[3];
+        if (!key || rawValue === undefined) {
+            console.log("Usage: loophaus config set <key> <value>");
+            return;
+        }
+        if (!KNOWN_KEYS[key]) {
+            console.log(`Warning: '${key}' is not a known config key.`);
+        }
+        const config = await readConfig();
+        const parsed = rawValue === "true" ? true : rawValue === "false" ? false : isNaN(Number(rawValue)) ? rawValue : Number(rawValue);
+        setNestedValue(config, key, parsed);
+        await writeConfig(config);
+        console.log(`Set ${key} = ${String(parsed)}`);
+        return;
+    }
+    console.log("Usage: loophaus config [list|get|set] [key] [value]");
+}
+function getNestedValue(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== "object")
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function setNestedValue(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!(parts[i] in current) || typeof current[parts[i]] !== "object") {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
 try {
     switch (command) {
         case "install":
@@ -724,6 +919,15 @@ try {
         case "clean":
             await runCleanCmd();
             break;
+        case "config":
+            await runConfigCmd();
+            break;
+        case "update-check":
+            await runUpdateCheck();
+            break;
+        case "upgrade":
+            await runUpgrade();
+            break;
         case "sessions":
             await runSessions();
             break;

package/dist/commands/cancel-ralph.md

@@ -1,11 +1,6 @@
 ---
 description: "Cancel active Ralph Loop"
-allowed-tools:
-  [
-    "Bash(test -f .claude/ralph-loop.local.md:*)",
-    "Bash(rm .claude/ralph-loop.local.md)",
-    "Read(.claude/ralph-loop.local.md)",
-  ]
+allowed-tools: ["Bash", "Read"]
 hide-from-slash-command-tool: "true"
 ---
 
@@ -13,11 +8,11 @@ hide-from-slash-command-tool: "true"
 
 To cancel the Ralph loop:
 
-1. Check if `.claude/ralph-loop.local.md` exists using Bash: `test -f .claude/ralph-loop.local.md && echo "EXISTS" || echo "NOT_FOUND"`
+1. Check if `.claude/ralph-loop.local.md` exists using a cross-platform Node command.
 
 2. **If NOT_FOUND**: Say "No active Ralph loop found."
 
 3. **If EXISTS**:
    - Read `.claude/ralph-loop.local.md` to get the current iteration number from the `iteration:` field
-   - Remove the file using Bash: `rm .claude/ralph-loop.local.md`
+   - Remove the file using a cross-platform Node file command
    - Report: "Cancelled Ralph loop (was at iteration N)" where N is the iteration value

package/dist/commands/loop-plan.md

@@ -11,6 +11,49 @@ The user runs `/loop-plan` once and gets a single merged branch with all work do
 
 ---
 
+## Pre-flight: Update Check
+
+Run `loophaus update-check` silently before starting.
+
+If the command reports an available update:
+1. Show: `loophaus update available: v{current} → v{latest}`
+2. Ask user:
+   - **A) Upgrade now** → run `loophaus upgrade`, then continue
+   - **B) Always auto-upgrade** → run `loophaus config set autoUpgrade true && loophaus upgrade`, then continue
+   - **C) Not now** → run `loophaus config set updateCheck snoozed` silently, then continue
+   - **D) Never ask again** → run `loophaus config set updateCheck false`, then continue
+
+If auto-upgrade is enabled (`loophaus config get autoUpgrade` returns `true`):
+- Skip prompt, run `loophaus upgrade` silently, continue.
+
+If no update is available or the check fails: continue silently and never block the user.
+
+## Pre-flight: Skill Routing Check
+
+Check if the project has a CLAUDE.md with loophaus skill routing:
+
+```bash
+CLAUDE_MD="$(pwd)/CLAUDE.md"
+ROUTING_MARKER=".loophaus/routing-offered.json"
+```
+
+If CLAUDE.md exists but has no `## loophaus skill routing` section, AND routing hasn't been offered before:
+1. Suggest adding this section to CLAUDE.md:
+   ```markdown
+   ## loophaus skill routing
+   
+   | User intent | Route to |
+   |-------------|----------|
+   | Feature implementation, refactoring, multi-step task | `/loophaus:loop-plan` |
+   | "start the loop", "continue implementing" | `/loophaus:loop` |
+   | "stop the loop", "cancel" | `/loophaus:loop-stop` |
+   | "what's the status", "how far along" | `/loophaus:loop-pulse` |
+   ```
+2. If user agrees, add the section to CLAUDE.md
+3. Write `{ "offeredAt": "<ISO date>" }` to `.loophaus/routing-offered.json` so we don't ask again
+
+If CLAUDE.md doesn't exist or routing already offered: skip silently.
+
 ## Phase 0: Cleanup Previous Data
 
 Before starting a new plan, apply the cleanup policy from `.loophaus/config.json`: