@graypark/loophaus 2.1.0 → 2.1.2

package/bin/uninstall.mjs

@@ -12,6 +12,7 @@ import {
   getClaudePluginCacheDir,
   getClaudeSettingsPath,
   getClaudeInstalledPluginsPath,
+  getAgentsSkillsDir,
 } from "../lib/paths.mjs";
 import { getStatePath } from "../lib/state.mjs";
 
@@ -202,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.1.0",
+  "version": "2.1.2",
   "type": "module",
   "description": "loophaus — Control plane for coding agents. Iterative dev loops with multi-agent orchestration.",
   "license": "MIT",

package/platforms/codex-cli/installer.mjs

@@ -7,6 +7,8 @@ import {
   getHooksJsonPath,
   getPluginInstallDir,
   getSkillsDir,
+  getAgentsHome,
+  getAgentsSkillsDir,
 } from "../../lib/paths.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -17,7 +19,7 @@ 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
@@ -143,12 +145,15 @@ export async function install({ dryRun = false, force = false, local = false } =
     }
   }
 
-  // Step 1: Clean up legacy ralph-* skills
-  console.log("[1/4] Cleaning up legacy skills...");
-  for (const name of LEGACY_SKILLS) {
+  const totalSteps = 4;
+
+  // Step 1: Clean up legacy skills from ~/.codex/skills/
+  console.log(`[1/${totalSteps}] Cleaning up legacy skills...`);
+  const CLEANUP_FROM_CODEX = [...LEGACY_SKILLS, "loop", "loop-stop", "loop-plan", "loop-pulse"];
+  for (const name of CLEANUP_FROM_CODEX) {
     const legacyDir = join(skillsDir, name);
     if (await fileExists(legacyDir)) {
-      console.log(`  > Remove legacy skill: ${name}`);
+      console.log(`  > Remove from ~/.codex/skills/: ${name}`);
       if (!dryRun) {
         await rm(legacyDir, { recursive: true, force: true });
       }
@@ -156,7 +161,7 @@ export async function install({ dryRun = false, force = false, local = false } =
   }
 
   // Step 2: Copy files
-  console.log("[2/4] Copying plugin 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;
@@ -171,7 +176,7 @@ export async function install({ dryRun = false, force = false, local = false } =
   if (!dryRun) await cp(join(PROJECT_ROOT, "package.json"), join(pluginDir, "package.json"));
 
   // Step 3: Hooks
-  console.log("[3/4] Configuring Stop hook...");
+  console.log(`[3/${totalSteps}] Configuring Stop hook...`);
   const stopCmd = `node "${join(pluginDir, "hooks", "stop-hook.mjs")}"`;
   let existing = { hooks: {} };
   if (await fileExists(hooksJsonPath)) {
@@ -188,10 +193,13 @@ export async function install({ dryRun = false, force = false, local = false } =
     await writeFile(hooksJsonPath, JSON.stringify(existing, null, 2), "utf-8");
   }
 
-  // Step 4: Install new skills (loop, loop-stop, loop-plan, loop-pulse)
-  console.log("[4/4] Installing skills...");
+  // Step 4: Install skills to standard path
+  // Global: ~/.agents/skills/ (new Codex CLI standard — avoids duplicates with ~/.codex/skills/)
+  // Local: .codex/skills/ (project-scoped)
+  const targetSkillsDir = local ? skillsDir : getAgentsSkillsDir();
+  console.log(`[4/${totalSteps}] Installing skills to ${local ? ".codex/skills/" : "~/.agents/skills/"}...`);
   for (const [name, skill] of Object.entries(CODEX_SKILLS)) {
-    const skillDir = join(skillsDir, name);
+    const skillDir = join(targetSkillsDir, name);
     console.log(`  > Install skill: ${name}`);
     if (!dryRun) {
       await mkdir(skillDir, { recursive: true });

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,27 +15,97 @@ 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}`;
+// 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());
@@ -44,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)" : ""}`);
@@ -52,7 +122,7 @@ export async function install({ dryRun = false, force = false } = {}) {
   console.log("");
 
   // Step 1: Create agent config with stop hook
-  console.log("[1/3] Configuring agent with stop hook...");
+  console.log("[1/4] Configuring agent with stop hook...");
   const agentConfig = {
     name: "loophaus",
     description: "loophaus — iterative dev loop agent",
@@ -77,39 +147,35 @@ export async function install({ dryRun = false, force = false } = {}) {
     await writeFile(agentPath, JSON.stringify(agentConfig, null, 2), "utf-8");
   }
 
-  // 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 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 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" },
-    { 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} (Kiro frontmatter)`);
-      if (!dryRun) {
-        await mkdir(steeringDir, { recursive: true });
-        const content = await readFile(srcPath, "utf-8");
-        const kiroContent = convertToKiroFrontmatter(content);
-        await writeFile(destPath, kiroContent, "utf-8");
-      }
+  // 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");
     }
   }
 
@@ -118,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("");
@@ -128,29 +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"),
-    // Legacy steering files
-    join(kiroHome, "steering", "ralph-loop.md"),
-    join(kiroHome, "steering", "cancel-ralph.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("");
 }