@graypark/loophaus 3.4.0 → 3.5.0

package/dist/skills/ralph-orchestrator/SKILL.md

@@ -0,0 +1,254 @@
+---
+name: ralph-orchestrator
+description: "Orchestration patterns for loop: subagent spawning, parallel exploration, and task decomposition strategies"
+---
+
+# Loop Orchestrator — Multi-Agent Loop Patterns
+
+You are an expert at designing optimal execution strategies for Loop tasks.
+When asked to orchestrate a task, analyze its structure and recommend the best combination of sequential loops, parallel subagents, and phased execution.
+
+## Core Concept
+
+Not every task should run in a single linear loop. Complex tasks benefit from:
+
+- **Parallel exploration** — spawn subagents to search/analyze independently, then merge results
+- **Divide and conquer** — split work by service/directory/concern with isolated agents
+- **Pipeline stages** — sequential phases where each feeds into the next
+- **Hybrid patterns** — combine parallel research with sequential implementation
+
+## When to Use Subagents
+
+### Use Subagents (Parallel) When:
+
+| Signal                      | Example                                                    |
+| --------------------------- | ---------------------------------------------------------- |
+| **Broad codebase search**   | "Find all API endpoints that lack auth checks"             |
+| **Independent file groups** | Frontend components + backend routes + database migrations |
+| **Multi-service changes**   | auth-service + api-gateway + frontend simultaneously       |
+| **Audit/review tasks**      | Security audit + performance audit + accessibility audit   |
+| **Pattern extraction**      | Scan 50+ files for inconsistent patterns                   |
+
+### Do NOT Use Subagents When:
+
+| Signal                      | Reason                                               |
+| --------------------------- | ---------------------------------------------------- |
+| **Sequential dependencies** | Step 2 needs Step 1's output                         |
+| **Shared mutable state**    | Multiple agents editing the same file = conflicts    |
+| **Small scope (< 5 files)** | Overhead outweighs benefit                           |
+| **Context-heavy tasks**     | Agent needs deep understanding of full codebase flow |
+
+## Orchestration Patterns
+
+### Pattern 1: Parallel Explore → Sequential Implement
+
+Best for: Large codebases where you need to understand before you change.
+
+```
+Phase 1 (Parallel Subagents):
+├── Agent A: Scan src/frontend/** for pattern X → report-frontend.md
+├── Agent B: Scan src/backend/** for pattern X → report-backend.md
+└── Agent C: Scan src/shared/** for pattern X → report-shared.md
+
+Phase 2 (Sequential Loop):
+└── Loop: Read all reports → implement fixes in priority order
+```
+
+**Prompt pattern for Phase 1:**
+
+```
+## Subagent Tasks (run in parallel)
+Use the Agent tool to spawn these subagents simultaneously:
+
+1. Agent "frontend-scan": Search src/frontend/** for [pattern].
+   Write findings to .loophaus/reports/frontend-scan.md
+2. Agent "backend-scan": Search src/backend/** for [pattern].
+   Write findings to .loophaus/reports/backend-scan.md
+3. Agent "shared-scan": Search src/shared/** for [pattern].
+   Write findings to .loophaus/reports/shared-scan.md
+
+After ALL agents complete, merge reports into .loophaus/reports/merged.md
+with a unified priority list.
+```
+
+### Pattern 2: Divide by Ownership
+
+Best for: Multi-service changes where files don't overlap.
+
+```
+Phase 1 (Parallel Implementation):
+├── Agent "fe-dev": Modify src/frontend/** only → commit per item
+├── Agent "be-dev": Modify src/backend/** only → commit per item
+└── Agent "auth-dev": Modify src/auth/** only → commit per item
+
+Phase 2 (Integration Verification):
+└── Loop: Run full test suite, fix any integration issues
+```
+
+**Prompt pattern:**
+
+```
+## Parallel Work Streams
+Spawn these agents with strict file ownership:
+
+1. Agent "fe-dev" (isolation: worktree):
+   - ONLY touch files in src/frontend/**
+   - Tasks: [frontend items]
+   - Commit each fix individually
+
+2. Agent "be-dev" (isolation: worktree):
+   - ONLY touch files in src/backend/**
+   - Tasks: [backend items]
+   - Commit each fix individually
+
+After all agents complete, merge their branches and run integration tests.
+```
+
+### Pattern 3: Fan-Out / Fan-In Research
+
+Best for: Tasks that need comprehensive analysis before any action.
+
+```
+Fan-Out (Parallel):
+├── Agent 1: Analyze problem from angle A → findings-a.md
+├── Agent 2: Analyze problem from angle B → findings-b.md
+└── Agent 3: Analyze problem from angle C → findings-c.md
+
+Fan-In (Sequential):
+└── Loop: Synthesize all findings → create action plan → implement
+```
+
+### Pattern 4: Pipeline with Checkpoints
+
+Best for: Complex multi-stage transformations.
+
+```
+Stage 1 (Loop): Parse + validate input → intermediate.json
+  ↓ checkpoint: verify intermediate.json schema
+Stage 2 (Loop): Transform data → output draft
+  ↓ checkpoint: run regression tests
+Stage 3 (Parallel Agents): Apply fixes to multiple output files
+  ↓ checkpoint: final integration test
+```
+
+### Pattern 5: Scout-Then-Execute
+
+Best for: Unfamiliar codebases or risky changes.
+
+```
+Scout Phase (Single Agent, read-only):
+└── Agent "scout": Explore codebase, map dependencies, identify risks
+    → .loophaus/reports/scout-report.md
+
+Execute Phase (Loop):
+└── Loop: Use scout report as reference, implement changes
+```
+
+## Subagent Configuration Reference
+
+### Codex CLI (experimental)
+
+Codex spawns subagents via natural language prompts with keywords: "spawn", "parallel", "delegate", "one agent per".
+
+```
+# Enable in ~/.codex/config.toml
+[agents]
+max_threads = 6          # Max concurrent agent threads (default: 6)
+max_depth = 1            # No grandchild agents (default: 1)
+```
+
+**Custom agent definitions** in `.codex/agents/` (TOML):
+
+```toml
+# .codex/agents/scanner.toml
+name = "scanner"
+description = "Read-only codebase explorer for pattern extraction"
+model = "gpt-5.4-mini"          # Faster model for exploration
+model_reasoning_effort = "low"
+sandbox_mode = "read-only"
+developer_instructions = """
+Scan files for the requested pattern. Report findings with file paths and line numbers.
+Do NOT modify any files.
+"""
+```
+
+**Spawning in prompts:**
+
+```
+"Spawn one agent per service directory to scan for auth issues:
+ 1. scanner on src/frontend/** → .loophaus/reports/frontend.md
+ 2. scanner on src/backend/** → .loophaus/reports/backend.md
+ 3. scanner on src/auth/** → .loophaus/reports/auth.md
+ Wait for all, then summarize findings by severity."
+```
+
+**Batch processing** with `spawn_agents_on_csv`:
+
+```
+# For 100+ similar items, use CSV-driven batch spawning:
+spawn_agents_on_csv:
+  csv_path: .loophaus/items.csv
+  instruction: "Review {file_path} for {issue_type}. Return JSON via report_agent_job_result"
+  output_schema: { file: string, severity: string, fix: string }
+  output_csv_path: .loophaus/reports/batch-results.csv
+  max_concurrency: 6
+```
+
+### Model Selection Guide (Codex)
+
+| Role                    | Recommended Model   | Reasoning Effort |
+| ----------------------- | ------------------- | ---------------- |
+| Coordinator / main loop | gpt-5.4             | medium           |
+| Explorer / scanner      | gpt-5.4-mini        | low              |
+| Reviewer / security     | gpt-5.4             | high             |
+| Quick iteration / TDD   | gpt-5.3-codex-spark | medium           |
+
+### Key Constraints
+
+| Setting              | Default | Note                                                                    |
+| -------------------- | ------- | ----------------------------------------------------------------------- |
+| `agents.max_threads` | 6       | Hard cap on concurrent agents                                           |
+| `agents.max_depth`   | 1       | No recursive agent spawning                                             |
+| File conflicts       | N/A     | Multiple agents writing same file = conflicts. Use ownership isolation. |
+| Token usage          | Higher  | Each subagent does own inference. Use faster models for workers.        |
+
+## Report Directory Convention
+
+All subagent outputs should follow this structure:
+
+```
+.loophaus/
+└── reports/
+    ├── {agent-name}.md       # Individual agent output
+    ├── merged.md             # Combined findings (created by orchestrator)
+    └── plan.md               # Action plan derived from findings
+```
+
+This directory should be in `.gitignore` — reports are ephemeral working artifacts.
+
+## Decision Matrix
+
+When analyzing a task, use this scoring to decide the orchestration pattern:
+
+| Factor                         | Score | Pattern             |
+| ------------------------------ | ----- | ------------------- |
+| Files span 3+ directories      | +2    | Parallel            |
+| Items are independent          | +2    | Parallel            |
+| Need full context to decide    | -2    | Sequential          |
+| Order matters                  | -2    | Sequential          |
+| 10+ similar items              | +1    | Parallel            |
+| Needs cross-file understanding | -1    | Sequential          |
+| Multiple services/repos        | +3    | Divide by Ownership |
+
+- **Score >= 3**: Recommend parallel subagents
+- **Score 0–2**: Recommend sequential with optional scout phase
+- **Score < 0**: Recommend single sequential Loop
+
+## Integration with Loop Interview
+
+When `/loop-plan` invokes this skill, provide:
+
+1. **Recommended pattern** — which orchestration pattern fits best
+2. **Agent breakdown** — list of subagents with their roles and file boundaries
+3. **Phase structure** — how phases connect and what checkpoints exist
+4. **Prompt snippets** — ready-to-embed subagent instructions for the loop prompt

package/dist/store/state-store.d.ts

@@ -0,0 +1,17 @@
+import type { LoopState, QualityConfig } from "../core/types.js";
+export interface StateStoreData extends LoopState {
+    qualityThreshold: number;
+    maxRefineAttempts: number;
+    qualityConfig: QualityConfig | null;
+}
+declare const DEFAULT_STATE: StateStoreData;
+export declare function getStatePath(cwd?: string, name?: string): string;
+export declare function read(cwd?: string, name?: string): Promise<StateStoreData>;
+export declare function write(state: StateStoreData, cwd?: string, name?: string): Promise<void>;
+export declare function reset(cwd?: string): Promise<void>;
+export declare function readState(cwd?: string): Promise<StateStoreData>;
+export declare function writeState(state: StateStoreData, cwd?: string): Promise<void>;
+export declare function resetState(cwd?: string): Promise<void>;
+export declare function incrementIteration(cwd?: string): Promise<StateStoreData>;
+export { DEFAULT_STATE };
+//# sourceMappingURL=state-store.d.ts.map

package/dist/store/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../store/state-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,QAAA,MAAM,aAAa,EAAE,cAWpB,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhE;AAOD,wBAAsB,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B/E;AAED,wBAAsB,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7F;AAED,wBAAsB,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD;AAoBD,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAsB;AAC5F,wBAAsB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAA8B;AAClH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAuB;AACpF,wBAAsB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAK9E;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/store/state-store.js

@@ -0,0 +1,108 @@
+import { readFile, writeFile, mkdir, rename } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { validateState } from "../core/validate.js";
+const DEFAULT_STATE = {
+    active: false,
+    prompt: "",
+    completionPromise: "TADA",
+    maxIterations: 20,
+    currentIteration: 0,
+    sessionId: "",
+    verifyScript: "",
+    qualityThreshold: 80,
+    maxRefineAttempts: 3,
+    qualityConfig: null,
+};
+export function getStatePath(cwd, name) {
+    if (process.env.LOOPHAUS_STATE_FILE)
+        return process.env.LOOPHAUS_STATE_FILE;
+    if (process.env.RALPH_STATE_FILE)
+        return process.env.RALPH_STATE_FILE;
+    const base = cwd || process.cwd();
+    if (name)
+        return join(base, ".loophaus", "loops", name, "state.json");
+    return join(base, ".loophaus", "state.json");
+}
+const LEGACY_PATHS = [
+    (cwd) => join(cwd, ".codex", "ralph-loop.state.json"),
+    (cwd) => join(cwd, ".claude", "ralph-loop.local.md"),
+];
+export async function read(cwd, name) {
+    const primary = getStatePath(cwd, name);
+    try {
+        const raw = await readFile(primary, "utf-8");
+        const state = { ...DEFAULT_STATE, ...JSON.parse(raw) };
+        const result = validateState(state);
+        if (!result.valid) {
+            process.stderr.write(`loophaus: state validation warning: ${result.errors.join(", ")}\n`);
+        }
+        return state;
+    }
+    catch {
+        // Primary not found, try legacy paths
+    }
+    const dir = cwd || process.cwd();
+    for (const pathFn of LEGACY_PATHS) {
+        const legacyPath = pathFn(dir);
+        try {
+            const raw = await readFile(legacyPath, "utf-8");
+            if (legacyPath.endsWith(".md")) {
+                return migrateMdFormat(raw);
+            }
+            return { ...DEFAULT_STATE, ...JSON.parse(raw) };
+        }
+        catch {
+            continue;
+        }
+    }
+    return { ...DEFAULT_STATE };
+}
+export async function write(state, cwd, name) {
+    const result = validateState(state);
+    if (!result.valid) {
+        process.stderr.write(`loophaus: writing invalid state: ${result.errors.join(", ")}\n`);
+    }
+    const statePath = getStatePath(cwd, name);
+    await mkdir(dirname(statePath), { recursive: true });
+    const tmp = statePath + ".tmp";
+    await writeFile(tmp, JSON.stringify(state, null, 2), "utf-8");
+    await rename(tmp, statePath);
+}
+export async function reset(cwd) {
+    await write({ ...DEFAULT_STATE }, cwd);
+}
+function migrateMdFormat(raw) {
+    const state = { ...DEFAULT_STATE };
+    const lines = raw.split("\n");
+    for (const line of lines) {
+        const match = line.match(/^(\w+):\s*(.+)$/);
+        if (!match)
+            continue;
+        const [, key, value] = match;
+        if (key === "active")
+            state.active = value.trim() === "true";
+        else if (key === "iteration")
+            state.currentIteration = parseInt(value.trim(), 10) || 0;
+        else if (key === "max_iterations")
+            state.maxIterations = parseInt(value.trim(), 10) || 20;
+        else if (key === "completion_promise")
+            state.completionPromise = value.trim();
+        else if (key === "prompt")
+            state.prompt = value.trim();
+        else if (key === "session_id")
+            state.sessionId = value.trim();
+    }
+    return state;
+}
+// Backward-compatible exports (matching lib/state.mjs interface)
+export async function readState(cwd) { return read(cwd); }
+export async function writeState(state, cwd) { return write(state, cwd); }
+export async function resetState(cwd) { return reset(cwd); }
+export async function incrementIteration(cwd) {
+    const state = await read(cwd);
+    state.currentIteration += 1;
+    await write(state, cwd);
+    return state;
+}
+export { DEFAULT_STATE };
+//# sourceMappingURL=state-store.js.map

package/dist/store/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../store/state-store.ts"],"names":[],"mappings":"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"}

package/hooks/stop-hook.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-import { evaluateStopHook } from "../core/engine.mjs";
-import { getLastAssistantText, hasPendingStories } from "../core/io-helpers.mjs";
-import { read as readState, write as writeState } from "../store/state-store.mjs";
-import { logEvents } from "../core/event-logger.mjs";
+import { evaluateStopHook } from "../core/engine.js";
+import { getLastAssistantText, hasPendingStories } from "../core/io-helpers.js";
+import { read as readState, write as writeState } from "../store/state-store.js";
+import { logEvents } from "../core/event-logger.js";
 import { join } from "node:path";
 
 async function runStoryTests(cwd) {
@@ -69,7 +69,7 @@ async function main() {
   const testResults = await runStoryTests(cwd);
 
   // Evaluate loop policy
-  const { loadPolicy, evaluatePolicy } = await import("../core/policy.mjs");
+  const { loadPolicy, evaluatePolicy } = await import("../core/policy.js");
   const policy = await loadPolicy(cwd);
   const policyResult = evaluatePolicy(policy, state, { totalCost: 0, errorCount: 0 });
 
@@ -89,7 +89,7 @@ async function main() {
 
   // Save session checkpoint (best-effort)
   try {
-    const { saveCheckpoint } = await import("../core/session.mjs");
+    const { saveCheckpoint } = await import("../core/session.js");
     await saveCheckpoint(result.nextState.sessionId || `auto-${Date.now()}`, {
       prompt: result.nextState.prompt,
       completionPromise: result.nextState.completionPromise,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graypark/loophaus",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "type": "module",
   "description": "loophaus — Control plane for coding agents. Iterative dev loops with multi-agent orchestration.",
   "license": "MIT",
@@ -17,18 +17,15 @@
     "access": "public"
   },
   "bin": {
-    "loophaus": "./bin/loophaus.mjs"
+    "loophaus": "./dist/bin/loophaus.js"
   },
   "files": [
-    "bin/",
+    "dist/",
     "hooks/",
     "commands/",
     "codex/",
-    "core/",
-    "store/",
     "platforms/",
     "scripts/",
-    "lib/",
     "skills/",
     ".claude-plugin/",
     "README.md",
@@ -36,8 +33,13 @@
     "LICENSE"
   ],
   "scripts": {
+    "build": "tsc && npm run postbuild",
+    "postbuild": "node -e \"const fs=require('fs');const p=require('path');['platforms','hooks','codex','commands','scripts','skills','.claude-plugin'].forEach(d=>{const s=p.join(__dirname,d);const t=p.join(__dirname,'dist',d);if(fs.existsSync(s))fs.cpSync(s,t,{recursive:true})});['package.json','LICENSE','README.md','README.ko.md'].forEach(f=>{const s=p.join(__dirname,f);const t=p.join(__dirname,'dist',f);if(fs.existsSync(s))fs.cpSync(s,t)})\"",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "postinstall": "echo 'Run: npx loophaus --help'"
+    "postinstall": "echo 'Run: npx loophaus --help'",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run build"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -52,6 +54,8 @@
     "coding-agents"
   ],
   "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
     "vitest": "^4.1.0"
   }
 }

package/platforms/claude-code/installer.d.mts

@@ -0,0 +1,3 @@
+export function detect(): Promise<boolean>;
+export function install(opts: { dryRun?: boolean; force?: boolean }): Promise<void>;
+export function uninstall(opts: { dryRun?: boolean }): Promise<void>;

package/platforms/claude-code/installer.mjs

@@ -9,7 +9,7 @@ import {
   getClaudeSettingsPath,
   getClaudeInstalledPluginsPath,
   getPackageVersion,
-} from "../../lib/paths.mjs";
+} from "../../lib/paths.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const PROJECT_ROOT = resolve(dirname(__filename), "../..");
@@ -168,6 +168,6 @@ export async function install({ dryRun = false, force = false } = {}) {
 }
 
 export async function uninstall({ dryRun = false } = {}) {
-  const { uninstall: doUninstall } = await import("../../bin/uninstall.mjs");
+  const { uninstall: doUninstall } = await import("../../bin/uninstall.js");
   return doUninstall({ dryRun, claude: true });
 }

package/platforms/codex-cli/installer.d.mts

@@ -0,0 +1,2 @@
+export function detect(): Promise<boolean>;
+export function install(opts: { dryRun?: boolean; force?: boolean; local?: boolean }): Promise<void>;

package/platforms/codex-cli/installer.mjs

@@ -9,7 +9,7 @@ import {
   getSkillsDir,
   getAgentsHome,
   getAgentsSkillsDir,
-} from "../../lib/paths.mjs";
+} from "../../lib/paths.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const PROJECT_ROOT = resolve(dirname(__filename), "../..");

package/platforms/kiro-cli/installer.d.mts

@@ -0,0 +1,3 @@
+export function detect(): Promise<boolean>;
+export function install(opts: { dryRun?: boolean; force?: boolean }): Promise<void>;
+export function uninstall(opts: { dryRun?: boolean }): Promise<void>;