@ouro.bot/cli 0.1.0-alpha.43 → 0.1.0-alpha.44

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.44",
+      "changes": [
+        "Workflow skills now install into `~/.agents/skills` for Codex/OpenAI instead of duplicating installs under both `.agents` and `.codex`, which prevents duplicate advertised skills while keeping re-installs safe."
+      ]
+    },
     {
       "version": "0.1.0-alpha.43",
       "changes": [

package/dist/heart/daemon/subagent-installer.js

@@ -64,6 +64,16 @@ function pathExists(target) {
         return false;
     }
 }
+function isSameFile(source, target) {
+    try {
+        const sourceStats = fs.statSync(source);
+        const targetStats = fs.statSync(target);
+        return sourceStats.dev === targetStats.dev && sourceStats.ino === targetStats.ino;
+    }
+    catch {
+        return false;
+    }
+}
 function ensureSymlink(source, target) {
     fs.mkdirSync(path.dirname(target), { recursive: true });
     if (pathExists(target)) {
@@ -78,6 +88,25 @@ function ensureSymlink(source, target) {
     fs.symlinkSync(source, target);
     return true;
 }
+function ensureHardLink(source, target) {
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    if (pathExists(target)) {
+        const stats = fs.lstatSync(target);
+        if (!stats.isSymbolicLink() && isSameFile(source, target)) {
+            return false;
+        }
+        fs.unlinkSync(target);
+    }
+    fs.linkSync(source, target);
+    return true;
+}
+function hasOpenAiSkillHome(homeDir) {
+    return pathExists(path.join(homeDir, ".codex")) || pathExists(path.join(homeDir, ".agents"));
+}
+function openAiSkillTargets(homeDir, source) {
+    const skillName = path.basename(source, ".md");
+    return [path.join(homeDir, ".agents", "skills", skillName, "SKILL.md")];
+}
 async function installSubagentsForAvailableCli(options = {}) {
     const repoRoot = options.repoRoot ?? path.resolve(__dirname, "..", "..", "..");
     const homeDir = options.homeDir ?? os.homedir();
@@ -111,15 +140,18 @@ async function installSubagentsForAvailableCli(options = {}) {
         }
     }
     const codexPath = which("codex");
-    if (!codexPath) {
-        notes.push("codex CLI not found; skipping subagent install");
+    if (!codexPath && !hasOpenAiSkillHome(homeDir)) {
+        notes.push("codex CLI/config not found; skipping subagent install");
     }
     else {
-        const codexSkillsDir = path.join(homeDir, ".codex", "skills");
         for (const source of sources) {
-            const skillName = path.basename(source, ".md");
-            const target = path.join(codexSkillsDir, skillName, "SKILL.md");
-            if (ensureSymlink(source, target)) {
+            let installedForSkill = false;
+            for (const target of openAiSkillTargets(homeDir, source)) {
+                if (ensureHardLink(source, target)) {
+                    installedForSkill = true;
+                }
+            }
+            if (installedForSkill) {
                 codexInstalled += 1;
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.43",
+  "version": "0.1.0-alpha.44",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",

package/subagents/README.md

@@ -36,13 +36,39 @@ cp subagents/*.md ~/.claude/agents/
 ## Installing For Codex-Style Skills
 
 ```bash
-mkdir -p ~/.codex/skills/work-planner ~/.codex/skills/work-doer ~/.codex/skills/work-merger
-cp subagents/work-planner.md ~/.codex/skills/work-planner/SKILL.md
-cp subagents/work-doer.md ~/.codex/skills/work-doer/SKILL.md
-cp subagents/work-merger.md ~/.codex/skills/work-merger/SKILL.md
+mkdir -p ~/.agents/skills/work-planner ~/.agents/skills/work-doer ~/.agents/skills/work-merger
+
+# Hard-link to keep one source of truth
+ln -f "$(pwd)/subagents/work-planner.md" ~/.agents/skills/work-planner/SKILL.md
+ln -f "$(pwd)/subagents/work-doer.md" ~/.agents/skills/work-doer/SKILL.md
+ln -f "$(pwd)/subagents/work-merger.md" ~/.agents/skills/work-merger/SKILL.md
 ```
 
-If you prefer symlinks or hard-links, that is fine too, but plain copies are easier to reason about and easier to repair when editors replace files.
+**Important:** For Codex/OpenAI skill installs, use the generic `~/.agents/skills` root and use hard links (`ln`, not `ln -s`). Installing the same skill into both `~/.agents/skills` and `~/.codex/skills` can produce duplicate entries in Codex. Symlinked `SKILL.md` files may load but are not advertised reliably by Codex surfaces. Hard-links break when editors save by replacing the file (new inode). After editing any `subagents/*.md` file, re-run the `ln -f` command for that file to restore the link. You can verify with `stat -f '%i'` — both files should share the same inode.
+
+Optional UI metadata:
+
+```bash
+mkdir -p ~/.agents/skills/work-planner/agents ~/.agents/skills/work-doer/agents ~/.agents/skills/work-merger/agents
+cat > ~/.agents/skills/work-planner/agents/openai.yaml << 'EOF'
+interface:
+  display_name: "Work Planner"
+  short_description: "Create and gate planning/doing task docs"
+  default_prompt: "Use $work-planner to create or update a planning doc, then stop at NEEDS_REVIEW."
+EOF
+cat > ~/.agents/skills/work-doer/agents/openai.yaml << 'EOF'
+interface:
+  display_name: "Work Doer"
+  short_description: "Execute approved doing docs with strict TDD"
+  default_prompt: "Use $work-doer to execute an approved doing doc unit by unit."
+EOF
+cat > ~/.agents/skills/work-merger/agents/openai.yaml << 'EOF'
+interface:
+  display_name: "Work Merger"
+  short_description: "Merge feature branch into main via PR after work-doer completes"
+  default_prompt: "Use $work-merger to merge the current feature branch into main."
+EOF
+```
 
 ## Keeping Local Skill Copies Fresh
 
@@ -51,8 +77,8 @@ After editing any `subagents/*.md` file, resync your local installed copies.
 The repo workflow usually checks this with diffs like:
 
 ```bash
-diff -q ~/.codex/skills/work-planner/SKILL.md subagents/work-planner.md
-diff -q ~/.codex/skills/work-doer/SKILL.md subagents/work-doer.md
+diff -q ~/.agents/skills/work-planner/SKILL.md subagents/work-planner.md
+diff -q ~/.agents/skills/work-doer/SKILL.md subagents/work-doer.md
 ```
 
 ## Restart Behavior