@graypark/loophaus 2.0.2 → 2.1.1

package/bin/uninstall.mjs

@@ -12,6 +12,7 @@ import {
   getClaudePluginCacheDir,
   getClaudeSettingsPath,
   getClaudeInstalledPluginsPath,
+  getAgentsSkillsDir,
 } from "../lib/paths.mjs";
 import { getStatePath } from "../lib/state.mjs";
 
@@ -175,8 +176,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",
@@ -196,6 +203,21 @@ export async function uninstall({
     }
   }
 
+  // 3b. Remove skills from ~/.agents/skills/ (new Codex CLI standard path)
+  if (!local) {
+    const agentsSkillsDir = getAgentsSkillsDir();
+    const agentsSkillNames = ["loop", "loop-stop", "loop-plan", "loop-pulse"];
+    for (const name of agentsSkillNames) {
+      const skillDir = join(agentsSkillsDir, name);
+      if (await fileExists(skillDir)) {
+        log(">", `Remove agents skill: ${skillDir}`);
+        if (!dryRun) {
+          await rm(skillDir, { recursive: true, force: true });
+        }
+      }
+    }
+  }
+
   // 4. Remove state file
   const statePath = getStatePath();
   if (await fileExists(statePath)) {

package/lib/paths.mjs

@@ -24,7 +24,7 @@ export function isWindows() {
   return process.platform === "win32";
 }
 
-// --- Codex CLI paths ---
+// --- Codex CLI paths (legacy ~/.codex + new ~/.agents) ---
 
 export function getCodexHome() {
   if (process.env.CODEX_HOME) {
@@ -33,6 +33,14 @@ export function getCodexHome() {
   return join(homedir(), ".codex");
 }
 
+export function getAgentsHome() {
+  return join(homedir(), ".agents");
+}
+
+export function getAgentsSkillsDir() {
+  return join(getAgentsHome(), "skills");
+}
+
 export function getHooksJsonPath() {
   return join(getCodexHome(), "hooks.json");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graypark/loophaus",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "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 {
@@ -7,6 +7,8 @@ import {
   getHooksJsonPath,
   getPluginInstallDir,
   getSkillsDir,
+  getAgentsHome,
+  getAgentsSkillsDir,
 } from "../../lib/paths.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -17,9 +19,106 @@ async function fileExists(p) {
 }
 
 export async function detect() {
-  return fileExists(getCodexHome());
+  return (await fileExists(getCodexHome())) || (await fileExists(getAgentsHome()));
 }
 
+// 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 +145,22 @@ export async function install({ dryRun = false, force = false, local = false } =
     }
   }
 
-  // Step 1: Copy files
-  console.log("[1/3] Copying plugin files...");
+  const totalSteps = local ? 4 : 5;
+
+  // Step 1: Clean up legacy ralph-* skills
+  console.log(`[1/${totalSteps}] 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/${totalSteps}] 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 +174,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/${totalSteps}] Configuring Stop hook...`);
   const stopCmd = `node "${join(pluginDir, "hooks", "stop-hook.mjs")}"`;
   let existing = { hooks: {} };
   if (await fileExists(hooksJsonPath)) {
@@ -79,41 +192,35 @@ 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 skills to ~/.codex/skills/
+  console.log(`[4/${totalSteps}] Installing skills to ~/.codex/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",
-        );
-      }
+      await writeFile(
+        join(skillDir, "SKILL.md"),
+        skill.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}`);
+  // Step 5: Mirror skills to ~/.agents/skills/ (new Codex CLI standard path)
+  if (!local) {
+    const agentsSkillsDir = getAgentsSkillsDir();
+    console.log(`[5/${totalSteps}] Installing skills to ~/.agents/skills/...`);
+    for (const [name, skill] of Object.entries(CODEX_SKILLS)) {
+      const skillDir = join(agentsSkillsDir, name);
+      console.log(`  > Install skill: ${name}`);
       if (!dryRun) {
-        await mkdir(join(skillsDir, sk), { recursive: true });
-        await cp(srcDir, join(skillsDir, sk), { recursive: true });
+        await mkdir(skillDir, { 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

@@ -1,5 +1,5 @@
 // platforms/kiro-cli/installer.mjs
-import { readFile, writeFile, mkdir, cp, access, rm } from "node:fs/promises";
+import { readFile, writeFile, mkdir, access, rm } from "node:fs/promises";
 import { join, resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
@@ -15,6 +15,98 @@ async function fileExists(p) {
   try { await access(p); return true; } catch { return false; }
 }
 
+// Kiro CLI skill definitions (description-based auto-matching)
+const KIRO_SKILLS = {
+  loop: {
+    content: `---
+name: loop
+description: "Start iterative dev loop — use when user says 'start loop', 'loop this', 'iterate on task', 'run loop'"
+argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]"
+---
+
+# 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 — use when user says 'stop loop', 'cancel loop', 'halt', 'stop iterating'"
+---
+
+# Stop Active Loop
+
+1. Check if \`.loophaus/state.json\` exists
+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 — use when user says 'plan loop', 'interview', 'create PRD', 'plan task'"
+argument-hint: "TASK_DESCRIPTION"
+---
+
+# Interactive Planning & Loop
+
+## Phase 1: Discovery Interview
+Ask 3-5 focused questions about the task.
+
+## 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 — use when user says 'loop status', 'check progress', 'how is the loop', 'pulse'"
+---
+
+# Check Loop Status
+
+1. Read .loophaus/state.json
+2. If active: show iteration, promise, progress
+3. If prd.json exists: show story progress (done/total)
+`,
+  },
+};
+
+// Legacy files to clean up
+const LEGACY_STEERING = [
+  "steering/ralph-loop.md",
+  "steering/cancel-ralph.md",
+  "steering/loop.md",
+  "steering/loop-plan.md",
+  "steering/loop-stop.md",
+  "steering/loop-pulse.md",
+];
+
 export async function detect() {
   return fileExists(getKiroHome());
 }
@@ -22,7 +114,7 @@ export async function detect() {
 export async function install({ dryRun = false, force = false } = {}) {
   const kiroHome = getKiroHome();
   const agentsDir = join(kiroHome, "agents");
-  const steeringDir = join(kiroHome, "steering");
+  const skillsDir = join(kiroHome, "skills");
 
   console.log("");
   console.log(`loophaus installer — Kiro CLI${dryRun ? " (DRY RUN)" : ""}`);
@@ -30,7 +122,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/4] Configuring agent with stop hook...");
   const agentConfig = {
     name: "loophaus",
     description: "loophaus — iterative dev loop agent",
@@ -55,23 +147,35 @@ 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...");
-  const commands = [
-    { src: "commands/loop.md", dest: "loop.md" },
-    { src: "commands/loop-plan.md", dest: "loop-plan.md" },
-    { src: "commands/loop-stop.md", dest: "loop-stop.md" },
-    { src: "commands/loop-pulse.md", dest: "loop-pulse.md" },
-  ];
-  for (const { src, dest } of commands) {
-    const srcPath = join(PROJECT_ROOT, src);
-    if (await fileExists(srcPath)) {
-      const destPath = join(steeringDir, dest);
-      console.log(`  > Copy ${src} -> ${destPath}`);
-      if (!dryRun) {
-        await mkdir(steeringDir, { recursive: true });
-        await cp(srcPath, destPath);
-      }
+  // Step 2: Clean up legacy steering files
+  console.log("[2/4] Cleaning up legacy steering files...");
+  for (const relPath of LEGACY_STEERING) {
+    const fullPath = join(kiroHome, relPath);
+    if (await fileExists(fullPath)) {
+      console.log(`  > Remove legacy: ${relPath}`);
+      if (!dryRun) await rm(fullPath);
+    }
+  }
+
+  // Step 3: Clean up legacy skill directories (in case of partial migration)
+  console.log("[3/4] Cleaning up legacy skill directories...");
+  const legacySkillNames = ["ralph-loop", "cancel-ralph"];
+  for (const name of legacySkillNames) {
+    const legacySkillDir = join(skillsDir, name);
+    if (await fileExists(legacySkillDir)) {
+      console.log(`  > Remove legacy skill: ${name}`);
+      if (!dryRun) await rm(legacySkillDir, { recursive: true, force: true });
+    }
+  }
+
+  // Step 4: Install skills (description-based auto-matching)
+  console.log("[4/4] Installing skills...");
+  for (const [name, skill] of Object.entries(KIRO_SKILLS)) {
+    const skillDir = join(skillsDir, name);
+    console.log(`  > Install skill: ${name}`);
+    if (!dryRun) {
+      await mkdir(skillDir, { recursive: true });
+      await writeFile(join(skillDir, "SKILL.md"), skill.content, "utf-8");
     }
   }
 
@@ -80,7 +184,7 @@ export async function install({ dryRun = false, force = false } = {}) {
     console.log("  \u2714 Dry run complete. No files were modified.");
   } else {
     console.log("  \u2714 loophaus installed for Kiro CLI!");
-    console.log("  Commands: /loop, /loop-plan, /loop-stop, /loop-pulse");
+    console.log("  Skills auto-match via description keywords.");
     console.log("  To uninstall: npx @graypark/loophaus uninstall --kiro");
   }
   console.log("");
@@ -90,26 +194,51 @@ export async function install({ dryRun = false, force = false } = {}) {
 export async function uninstall({ dryRun = false } = {}) {
   const kiroHome = getKiroHome();
 
-  const targets = [
-    join(kiroHome, "agents", "loophaus.json"),
-    join(kiroHome, "steering", "loop.md"),
-    join(kiroHome, "steering", "loop-plan.md"),
-    join(kiroHome, "steering", "loop-stop.md"),
-    join(kiroHome, "steering", "loop-pulse.md"),
-  ];
-
   console.log("");
   console.log(`loophaus uninstaller — Kiro CLI${dryRun ? " (DRY RUN)" : ""}`);
   console.log("");
 
-  for (const p of targets) {
-    if (await fileExists(p)) {
-      console.log(`  > Remove ${p}`);
-      if (!dryRun) await rm(p);
+  // Remove agent config
+  const agentPath = join(kiroHome, "agents", "loophaus.json");
+  if (await fileExists(agentPath)) {
+    console.log(`  > Remove ${agentPath}`);
+    if (!dryRun) await rm(agentPath);
+  }
+
+  // Remove skill directories
+  const skillNames = ["loop", "loop-stop", "loop-plan", "loop-pulse"];
+  for (const name of skillNames) {
+    const skillDir = join(kiroHome, "skills", name);
+    if (await fileExists(skillDir)) {
+      console.log(`  > Remove skill: ${skillDir}`);
+      if (!dryRun) await rm(skillDir, { recursive: true, force: true });
+    }
+  }
+
+  // Remove legacy steering files
+  for (const relPath of LEGACY_STEERING) {
+    const fullPath = join(kiroHome, relPath);
+    if (await fileExists(fullPath)) {
+      console.log(`  > Remove legacy: ${fullPath}`);
+      if (!dryRun) await rm(fullPath);
+    }
+  }
+
+  // Remove legacy skill directories
+  const legacySkillNames = ["ralph-loop", "cancel-ralph"];
+  for (const name of legacySkillNames) {
+    const legacySkillDir = join(kiroHome, "skills", name);
+    if (await fileExists(legacySkillDir)) {
+      console.log(`  > Remove legacy skill: ${legacySkillDir}`);
+      if (!dryRun) await rm(legacySkillDir, { recursive: true, force: true });
     }
   }
 
   console.log("");
-  console.log("  \u2714 loophaus removed from Kiro CLI.");
+  if (dryRun) {
+    console.log("  \u2714 Dry run complete. No files were modified.");
+  } else {
+    console.log("  \u2714 loophaus removed from Kiro CLI.");
+  }
   console.log("");
 }