@graypark/loophaus 2.0.2 → 2.1.0

package/bin/uninstall.mjs

@@ -175,8 +175,14 @@ export async function uninstall({
     log("-", "Plugin directory not found");
   }
 
-  // 3. Remove skill directories
+  // 3. Remove skill directories (both legacy ralph-* and new loop-* names)
   const skillNames = [
+    // New skill names
+    "loop",
+    "loop-stop",
+    "loop-plan",
+    "loop-pulse",
+    // Legacy skill names
     "ralph-loop",
     "cancel-ralph",
     "ralph-interview",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graypark/loophaus",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "type": "module",
   "description": "loophaus — Control plane for coding agents. Iterative dev loops with multi-agent orchestration.",
   "license": "MIT",

package/platforms/codex-cli/installer.mjs

@@ -1,5 +1,5 @@
 // platforms/codex-cli/installer.mjs
-import { readFile, writeFile, mkdir, cp, access } from "node:fs/promises";
+import { readFile, writeFile, mkdir, cp, access, rm } from "node:fs/promises";
 import { join, resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import {
@@ -20,6 +20,103 @@ export async function detect() {
   return fileExists(getCodexHome());
 }
 
+// Legacy ralph-* skill names to clean up
+const LEGACY_SKILLS = [
+  "ralph-loop",
+  "cancel-ralph",
+  "ralph-interview",
+  "ralph-orchestrator",
+  "ralph-claude-interview",
+  "ralph-claude-loop",
+  "ralph-claude-cancel",
+  "ralph-claude-orchestrator",
+];
+
+// New skill definitions for Codex CLI
+const CODEX_SKILLS = {
+  loop: {
+    content: `---
+name: loop
+description: "Start iterative dev loop"
+argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]"
+---
+
+# /loop — Start Iterative Dev Loop
+
+Parse the user's arguments:
+1. Extract \`--max-iterations N\` (default: 20)
+2. Extract \`--completion-promise TEXT\` (default: "TADA")
+3. Everything else is the prompt
+
+Create \`.loophaus/state.json\`:
+\`\`\`json
+{
+  "active": true,
+  "prompt": "<user's prompt>",
+  "completionPromise": "<promise text>",
+  "maxIterations": 20,
+  "currentIteration": 0,
+  "sessionId": ""
+}
+\`\`\`
+
+Then begin working on the task. The stop hook intercepts exit and feeds the SAME PROMPT back.
+
+CRITICAL: If a completion promise is set, ONLY output \`<promise>TEXT</promise>\` when genuinely complete.
+`,
+  },
+  "loop-stop": {
+    content: `---
+name: loop-stop
+description: "Stop active loop"
+---
+
+# /loop-stop
+
+1. Check \`.loophaus/state.json\` exists
+   - Also check legacy \`.codex/ralph-loop.state.json\`
+
+2. If not found: "No active loop."
+
+3. If found: read \`currentIteration\`, set \`active: false\`, report "Stopped loop at iteration N."
+`,
+  },
+  "loop-plan": {
+    content: `---
+name: loop-plan
+description: "Plan and start loop via interactive interview"
+argument-hint: "TASK_DESCRIPTION"
+---
+
+# /loop-plan — Interactive Planning & Loop
+
+## Phase 1: Discovery Interview
+Ask 3-5 focused questions about the task to understand scope, acceptance criteria, constraints.
+
+## Phase 2: PRD Generation
+Generate \`prd.json\` with right-sized user stories.
+
+## Phase 3: Loop Activation
+Create \`.loophaus/state.json\` and start working on US-001 immediately.
+
+Use \`<promise>TASK COMPLETE</promise>\` ONLY when ALL stories pass.
+`,
+  },
+  "loop-pulse": {
+    content: `---
+name: loop-pulse
+description: "Check loop status"
+---
+
+# /loop-pulse
+
+1. Read \`.loophaus/state.json\` (or legacy paths)
+2. If active, show iteration, promise, progress
+3. If \`prd.json\` exists, show story progress
+`,
+  },
+};
+
 export async function install({ dryRun = false, force = false, local = false } = {}) {
   const pluginDir = local
     ? join(process.cwd(), ".codex", "plugins", "loophaus")
@@ -46,8 +143,20 @@ export async function install({ dryRun = false, force = false, local = false } =
     }
   }
 
-  // Step 1: Copy files
-  console.log("[1/3] Copying plugin files...");
+  // Step 1: Clean up legacy ralph-* skills
+  console.log("[1/4] Cleaning up legacy skills...");
+  for (const name of LEGACY_SKILLS) {
+    const legacyDir = join(skillsDir, name);
+    if (await fileExists(legacyDir)) {
+      console.log(`  > Remove legacy skill: ${name}`);
+      if (!dryRun) {
+        await rm(legacyDir, { recursive: true, force: true });
+      }
+    }
+  }
+
+  // Step 2: Copy files
+  console.log("[2/4] Copying plugin files...");
   for (const dir of ["hooks", "codex/commands", "lib", "core", "store"]) {
     const src = join(PROJECT_ROOT, dir);
     if (!(await fileExists(src))) continue;
@@ -61,8 +170,8 @@ export async function install({ dryRun = false, force = false, local = false } =
   }
   if (!dryRun) await cp(join(PROJECT_ROOT, "package.json"), join(pluginDir, "package.json"));
 
-  // Step 2: Hooks
-  console.log("[2/3] Configuring Stop hook...");
+  // Step 3: Hooks
+  console.log("[3/4] Configuring Stop hook...");
   const stopCmd = `node "${join(pluginDir, "hooks", "stop-hook.mjs")}"`;
   let existing = { hooks: {} };
   if (await fileExists(hooksJsonPath)) {
@@ -79,42 +188,18 @@ export async function install({ dryRun = false, force = false, local = false } =
     await writeFile(hooksJsonPath, JSON.stringify(existing, null, 2), "utf-8");
   }
 
-  // Step 3: Skills
-  console.log("[3/3] Installing skills...");
-  for (const name of ["ralph-loop", "cancel-ralph"]) {
+  // Step 4: Install new skills (loop, loop-stop, loop-plan, loop-pulse)
+  console.log("[4/4] Installing skills...");
+  for (const [name, skill] of Object.entries(CODEX_SKILLS)) {
     const skillDir = join(skillsDir, name);
-    const src = name === "ralph-loop" ? "codex/commands/ralph-loop.md" : "codex/commands/cancel-ralph.md";
     console.log(`  > Install skill: ${name}`);
     if (!dryRun) {
       await mkdir(skillDir, { recursive: true });
-      const srcPath = join(PROJECT_ROOT, src);
-      if (await fileExists(srcPath)) {
-        const content = await readFile(srcPath, "utf-8");
-        await writeFile(
-          join(skillDir, "SKILL.md"),
-          content.replaceAll("${RALPH_CODEX_ROOT}", pluginDir).replaceAll("${LOOPHAUS_ROOT}", pluginDir),
-          "utf-8",
-        );
-      }
-    }
-  }
-
-  const standaloneSkills = [
-    "ralph-interview",
-    "ralph-orchestrator",
-    "ralph-claude-interview",
-    "ralph-claude-loop",
-    "ralph-claude-cancel",
-    "ralph-claude-orchestrator",
-  ];
-  for (const sk of standaloneSkills) {
-    const srcDir = join(PROJECT_ROOT, "skills", sk);
-    if (await fileExists(srcDir)) {
-      console.log(`  > Install skill: ${sk}`);
-      if (!dryRun) {
-        await mkdir(join(skillsDir, sk), { recursive: true });
-        await cp(srcDir, join(skillsDir, sk), { recursive: true });
-      }
+      await writeFile(
+        join(skillDir, "SKILL.md"),
+        skill.content.replaceAll("${RALPH_CODEX_ROOT}", pluginDir).replaceAll("${LOOPHAUS_ROOT}", pluginDir),
+        "utf-8",
+      );
     }
   }
 

package/platforms/kiro-cli/installer.mjs

@@ -15,6 +15,28 @@ async function fileExists(p) {
   try { await access(p); return true; } catch { return false; }
 }
 
+/**
+ * Convert Claude Code frontmatter to Kiro steering manual mode format.
+ * Strips Claude-specific fields (allowed-tools, argument-hint, hide-from-slash-command-tool)
+ * and ensures `inclusion: manual` is set for Kiro CLI slash command support.
+ */
+function convertToKiroFrontmatter(content) {
+  // Match the YAML frontmatter block
+  const fmRegex = /^---\n([\s\S]*?)\n---\n/;
+  const match = content.match(fmRegex);
+
+  if (!match) {
+    // No frontmatter found — add Kiro frontmatter
+    return `---\ninclusion: manual\n---\n\n${content}`;
+  }
+
+  // Extract the body after frontmatter
+  const body = content.slice(match[0].length);
+
+  // Build new Kiro frontmatter with inclusion: manual
+  return `---\ninclusion: manual\n---\n\n${body}`;
+}
+
 export async function detect() {
   return fileExists(getKiroHome());
 }
@@ -30,7 +52,7 @@ export async function install({ dryRun = false, force = false } = {}) {
   console.log("");
 
   // Step 1: Create agent config with stop hook
-  console.log("[1/2] Configuring agent with stop hook...");
+  console.log("[1/3] Configuring agent with stop hook...");
   const agentConfig = {
     name: "loophaus",
     description: "loophaus — iterative dev loop agent",
@@ -55,8 +77,22 @@ export async function install({ dryRun = false, force = false } = {}) {
     await writeFile(agentPath, JSON.stringify(agentConfig, null, 2), "utf-8");
   }
 
-  // Step 2: Copy steering files
-  console.log("[2/2] Installing steering files...");
+  // Step 2: Clean up legacy ralph-* steering files
+  console.log("[2/3] Cleaning up legacy steering files...");
+  const legacySteering = [
+    "ralph-loop.md",
+    "cancel-ralph.md",
+  ];
+  for (const name of legacySteering) {
+    const legacyPath = join(steeringDir, name);
+    if (await fileExists(legacyPath)) {
+      console.log(`  > Remove legacy steering: ${name}`);
+      if (!dryRun) await rm(legacyPath);
+    }
+  }
+
+  // Step 3: Copy steering files with Kiro frontmatter conversion
+  console.log("[3/3] Installing steering files...");
   const commands = [
     { src: "commands/loop.md", dest: "loop.md" },
     { src: "commands/loop-plan.md", dest: "loop-plan.md" },
@@ -67,10 +103,12 @@ export async function install({ dryRun = false, force = false } = {}) {
     const srcPath = join(PROJECT_ROOT, src);
     if (await fileExists(srcPath)) {
       const destPath = join(steeringDir, dest);
-      console.log(`  > Copy ${src} -> ${destPath}`);
+      console.log(`  > Copy ${src} -> ${destPath} (Kiro frontmatter)`);
       if (!dryRun) {
         await mkdir(steeringDir, { recursive: true });
-        await cp(srcPath, destPath);
+        const content = await readFile(srcPath, "utf-8");
+        const kiroContent = convertToKiroFrontmatter(content);
+        await writeFile(destPath, kiroContent, "utf-8");
       }
     }
   }
@@ -96,6 +134,9 @@ export async function uninstall({ dryRun = false } = {}) {
     join(kiroHome, "steering", "loop-plan.md"),
     join(kiroHome, "steering", "loop-stop.md"),
     join(kiroHome, "steering", "loop-pulse.md"),
+    // Legacy steering files
+    join(kiroHome, "steering", "ralph-loop.md"),
+    join(kiroHome, "steering", "cancel-ralph.md"),
   ];
 
   console.log("");