@orderful/droid 0.18.0 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @orderful/droid
 
+## 0.20.0
+
+### Minor Changes
+
+- [#109](https://github.com/Orderful/droid/pull/109) [`1014243`](https://github.com/Orderful/droid/commit/10142438bcd75723027d12ec7bdc23f012643ee3) Thanks [@frytyler](https://github.com/frytyler)! - Add codex tool for shared organizational knowledge
+
+  New tool providing access to the orderful-codex repo containing PRDs, tech designs, patterns, and explored topics. Features include:
+  - Load project context with `/codex {name}`
+  - Search across all categories
+  - Capture decisions during implementation
+  - Add explored topics with freshness tracking
+  - Auto-generate CONTEXT.md from project artifacts
+
+## 0.19.0
+
+### Minor Changes
+
+- [#104](https://github.com/Orderful/droid/pull/104) [`b6eaef4`](https://github.com/Orderful/droid/commit/b6eaef4fb3b003d41b5451e7efdba633a50b525e) Thanks [@frytyler](https://github.com/frytyler)! - Add tool migration system and fix skill config paths
+  - **Migration system**: Tools can now define migrations that run after install/update. Migrations are tracked per-tool in config and logged to `~/.droid/.migrations.log`.
+  - **Config path fix**: Skill overrides now save to unprefixed paths (`~/.droid/skills/brain/` not `~/.droid/skills/droid-brain/`), matching what SKILL.md tells Claude to read.
+  - **Automatic migration**: Existing users with prefixed config directories will have them automatically migrated on tool update.
+
+  Tool version bumps:
+  - brain: 0.2.2 → 0.2.3
+  - comments: 0.2.5 → 0.2.6
+  - project: 0.1.4 → 0.1.5
+  - coach: 0.1.2 → 0.1.3
+
 ## 0.18.0
 
 ### Minor Changes

package/dist/bin/droid.js

@@ -7,8 +7,8 @@ import { program } from "commander";
 import inquirer from "inquirer";
 import chalk2 from "chalk";
 import { execSync as execSync2 } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5 } from "fs";
+import { join as join8 } from "path";
 import { homedir as homedir3 } from "os";
 
 // src/lib/config.ts
@@ -126,8 +126,15 @@ function setConfigValue(key, value) {
 function getConfigPath() {
   return CONFIG_FILE;
 }
+function getConfigDir() {
+  return CONFIG_DIR;
+}
+function normalizeSkillNameForConfig(skillName) {
+  return skillName.replace(/^droid-/, "");
+}
 function getSkillOverridesPath(skillName) {
-  return join(CONFIG_DIR, "skills", skillName, "overrides.yaml");
+  const normalizedName = normalizeSkillNameForConfig(skillName);
+  return join(CONFIG_DIR, "skills", normalizedName, "overrides.yaml");
 }
 function loadSkillOverrides(skillName) {
   const overridesPath = getSkillOverridesPath(skillName);
@@ -142,8 +149,9 @@ function loadSkillOverrides(skillName) {
   }
 }
 function saveSkillOverrides(skillName, overrides) {
+  const normalizedName = normalizeSkillNameForConfig(skillName);
   const overridesPath = getSkillOverridesPath(skillName);
-  const skillDir = join(CONFIG_DIR, "skills", skillName);
+  const skillDir = join(CONFIG_DIR, "skills", normalizedName);
   if (!existsSync(skillDir)) {
     mkdirSync(skillDir, { recursive: true });
   }
@@ -168,8 +176,8 @@ function setAutoUpdateConfig(updates) {
 }
 
 // src/lib/skills.ts
-import { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, rmSync } from "fs";
-import { join as join6, dirname as dirname4 } from "path";
+import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync5, mkdirSync as mkdirSync4, writeFileSync as writeFileSync3, rmSync as rmSync2 } from "fs";
+import { join as join7, dirname as dirname5, basename } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import YAML4 from "yaml";
 
@@ -508,11 +516,104 @@ function uninstallAgent(agentName) {
   }
 }
 
+// src/lib/migrations.ts
+import { existsSync as existsSync4, appendFileSync, mkdirSync as mkdirSync3, renameSync, rmSync } from "fs";
+import { join as join6, dirname as dirname4 } from "path";
+var MIGRATIONS_LOG_FILE = ".migrations.log";
+function getMigrationsLogPath() {
+  return join6(getConfigDir(), MIGRATIONS_LOG_FILE);
+}
+function logMigration(toolName, fromVersion, toVersion, status, error) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const logEntry = error ? `${timestamp} ${toolName} ${fromVersion} \u2192 ${toVersion} ${status}: ${error}
+` : `${timestamp} ${toolName} ${fromVersion} \u2192 ${toVersion} ${status}
+`;
+  const logPath = getMigrationsLogPath();
+  const logDir = dirname4(logPath);
+  if (!existsSync4(logDir)) {
+    mkdirSync3(logDir, { recursive: true });
+  }
+  appendFileSync(logPath, logEntry);
+}
+function createConfigDirMigration(skillName, version2) {
+  const unprefixedName = skillName.replace(/^droid-/, "");
+  return {
+    version: version2,
+    description: `Move ${skillName} config to unprefixed location`,
+    up: (configDir) => {
+      const oldDir = join6(configDir, "skills", skillName);
+      const newDir = join6(configDir, "skills", unprefixedName);
+      if (existsSync4(oldDir) && !existsSync4(newDir)) {
+        const parentDir = dirname4(newDir);
+        if (!existsSync4(parentDir)) {
+          mkdirSync3(parentDir, { recursive: true });
+        }
+        renameSync(oldDir, newDir);
+      } else if (existsSync4(oldDir) && existsSync4(newDir)) {
+        rmSync(oldDir, { recursive: true });
+      }
+    }
+  };
+}
+var TOOL_MIGRATIONS = {
+  brain: [createConfigDirMigration("droid-brain", "0.2.3")],
+  comments: [createConfigDirMigration("droid-comments", "0.2.6")],
+  project: [createConfigDirMigration("droid-project", "0.1.5")],
+  coach: [createConfigDirMigration("droid-coach", "0.1.3")]
+};
+function getToolMigrations(toolName) {
+  return TOOL_MIGRATIONS[toolName] ?? [];
+}
+function getLastMigratedVersion(toolName) {
+  const config = loadConfig();
+  return config.migrations?.[toolName] ?? "0.0.0";
+}
+function setLastMigratedVersion(toolName, version2) {
+  const config = loadConfig();
+  if (!config.migrations) {
+    config.migrations = {};
+  }
+  config.migrations[toolName] = version2;
+  saveConfig(config);
+}
+function runMigrations(toolName, fromVersion, toVersion) {
+  const migrations = getToolMigrations(toolName);
+  const pendingMigrations = migrations.filter((m) => {
+    const afterFrom = compareSemver(m.version, fromVersion) > 0;
+    const beforeOrAtTo = compareSemver(m.version, toVersion) <= 0;
+    return afterFrom && beforeOrAtTo;
+  });
+  if (pendingMigrations.length === 0) {
+    setLastMigratedVersion(toolName, toVersion);
+    return { success: true };
+  }
+  const configDir = getConfigDir();
+  for (const migration of pendingMigrations) {
+    try {
+      migration.up(configDir);
+      logMigration(toolName, fromVersion, migration.version, "OK");
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logMigration(toolName, fromVersion, migration.version, "FAILED", errorMessage);
+      return { success: false, error: `Migration ${migration.version} failed: ${errorMessage}` };
+    }
+  }
+  setLastMigratedVersion(toolName, toVersion);
+  return { success: true };
+}
+function runToolMigrations(toolName, installedVersion) {
+  const lastMigrated = getLastMigratedVersion(toolName);
+  if (compareSemver(installedVersion, lastMigrated) <= 0) {
+    return { success: true };
+  }
+  return runMigrations(toolName, lastMigrated, installedVersion);
+}
+
 // src/lib/skills.ts
 var DROID_SKILLS_START = "<!-- droid-skills-start -->";
 var DROID_SKILLS_END = "<!-- droid-skills-end -->";
-var __dirname4 = dirname4(fileURLToPath4(import.meta.url));
-var BUNDLED_SKILLS_DIR = join6(__dirname4, "../tools");
+var __dirname4 = dirname5(fileURLToPath4(import.meta.url));
+var BUNDLED_SKILLS_DIR = join7(__dirname4, "../tools");
 function getSkillsInstallPath(platform) {
   return getSkillsPath(platform);
 }
@@ -525,7 +626,7 @@ function getPlatformConfigPath(platform) {
 function updatePlatformConfigSkills(platform, installedSkills) {
   const configPath = getPlatformConfigPath(platform);
   let content = "";
-  if (existsSync4(configPath)) {
+  if (existsSync5(configPath)) {
     content = readFileSync5(configPath, "utf-8");
   }
   const skillLines = installedSkills.map((name) => {
@@ -544,9 +645,9 @@ ${DROID_SKILLS_END}` : "";
   } else if (skillsSection) {
     content = content.trim() + "\n\n" + skillsSection + "\n";
   }
-  const configDir = dirname4(configPath);
-  if (!existsSync4(configDir)) {
-    mkdirSync3(configDir, { recursive: true });
+  const configDir = dirname5(configPath);
+  if (!existsSync5(configDir)) {
+    mkdirSync4(configDir, { recursive: true });
   }
   writeFileSync3(configPath, content, "utf-8");
 }
@@ -567,8 +668,8 @@ function parseSkillFrontmatter(content) {
   }
 }
 function loadSkillManifest(skillDir) {
-  const skillMdPath = join6(skillDir, "SKILL.md");
-  if (!existsSync4(skillMdPath)) {
+  const skillMdPath = join7(skillDir, "SKILL.md");
+  if (!existsSync5(skillMdPath)) {
     return null;
   }
   const content = readFileSync5(skillMdPath, "utf-8");
@@ -576,7 +677,7 @@ function loadSkillManifest(skillDir) {
   if (!frontmatter || !frontmatter.name) {
     return null;
   }
-  const toolDir = dirname4(dirname4(skillDir));
+  const toolDir = dirname5(dirname5(skillDir));
   const toolManifest = loadToolManifest(toolDir);
   return {
     name: frontmatter.name,
@@ -588,17 +689,17 @@ function loadSkillManifest(skillDir) {
   };
 }
 function findSkillPath(skillName) {
-  if (!existsSync4(BUNDLED_SKILLS_DIR)) {
+  if (!existsSync5(BUNDLED_SKILLS_DIR)) {
     return null;
   }
   const toolDirs = readdirSync3(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
   for (const toolName of toolDirs) {
-    const skillsDir = join6(BUNDLED_SKILLS_DIR, toolName, "skills");
-    if (!existsSync4(skillsDir)) continue;
-    const skillDir = join6(skillsDir, skillName);
-    if (existsSync4(skillDir) && existsSync4(join6(skillDir, "SKILL.md"))) {
+    const skillsDir = join7(BUNDLED_SKILLS_DIR, toolName, "skills");
+    if (!existsSync5(skillsDir)) continue;
+    const skillDir = join7(skillsDir, skillName);
+    if (existsSync5(skillDir) && existsSync5(join7(skillDir, "SKILL.md"))) {
       return {
-        toolDir: join6(BUNDLED_SKILLS_DIR, toolName),
+        toolDir: join7(BUNDLED_SKILLS_DIR, toolName),
         skillDir
       };
     }
@@ -606,17 +707,17 @@ function findSkillPath(skillName) {
   return null;
 }
 function getBundledSkills() {
-  if (!existsSync4(BUNDLED_SKILLS_DIR)) {
+  if (!existsSync5(BUNDLED_SKILLS_DIR)) {
     return [];
   }
   const toolDirs = readdirSync3(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
   const skills = [];
   for (const toolName of toolDirs) {
-    const skillsDir = join6(BUNDLED_SKILLS_DIR, toolName, "skills");
-    if (!existsSync4(skillsDir)) continue;
+    const skillsDir = join7(BUNDLED_SKILLS_DIR, toolName, "skills");
+    if (!existsSync5(skillsDir)) continue;
     const skillSubdirs = readdirSync3(skillsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
     for (const skillName of skillSubdirs) {
-      const manifest = loadSkillManifest(join6(skillsDir, skillName));
+      const manifest = loadSkillManifest(join7(skillsDir, skillName));
       if (manifest) {
         skills.push(manifest);
       }
@@ -693,15 +794,15 @@ function installSkill(skillName) {
     }
   }
   const skillsPath = getSkillsInstallPath(config.platform);
-  const targetSkillDir = join6(skillsPath, skillName);
+  const targetSkillDir = join7(skillsPath, skillName);
   const commandsPath = getCommandsInstallPath(config.platform);
   const tools = getPlatformTools(config);
   if (skillName.startsWith("droid-")) {
     const oldSkillName = skillName.replace(/^droid-/, "");
-    const oldSkillDir = join6(skillsPath, oldSkillName);
-    if (existsSync4(oldSkillDir)) {
+    const oldSkillDir = join7(skillsPath, oldSkillName);
+    if (existsSync5(oldSkillDir)) {
       try {
-        rmSync(oldSkillDir, { recursive: true });
+        rmSync2(oldSkillDir, { recursive: true });
       } catch (error) {
         console.warn(`Warning: Could not remove old skill directory ${oldSkillDir}: ${error}`);
       }
@@ -712,14 +813,14 @@ function installSkill(skillName) {
       saveConfig(config);
     }
   }
-  const commandsSource = join6(toolDir, "commands");
-  const agentsSource = join6(toolDir, "agents");
+  const commandsSource = join7(toolDir, "commands");
+  const agentsSource = join7(toolDir, "agents");
   if (!tools[skillName]) {
-    if (existsSync4(commandsSource)) {
+    if (existsSync5(commandsSource)) {
       const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
       for (const file of commandFiles) {
-        const targetCommandPath = join6(commandsPath, file);
-        if (existsSync4(targetCommandPath)) {
+        const targetCommandPath = join7(commandsPath, file);
+        if (existsSync5(targetCommandPath)) {
           const commandName = file.replace(".md", "");
           return {
             success: false,
@@ -728,7 +829,7 @@ function installSkill(skillName) {
         }
       }
     }
-    if (existsSync4(agentsSource)) {
+    if (existsSync5(agentsSource)) {
       const agentDirs = readdirSync3(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
       for (const agentName of agentDirs) {
         if (isAgentInstalled(agentName)) {
@@ -740,49 +841,49 @@ function installSkill(skillName) {
       }
     }
   }
-  if (!existsSync4(skillsPath)) {
-    mkdirSync3(skillsPath, { recursive: true });
+  if (!existsSync5(skillsPath)) {
+    mkdirSync4(skillsPath, { recursive: true });
   }
-  const skillMdSource = join6(skillDir, "SKILL.md");
-  if (existsSync4(skillMdSource)) {
-    if (!existsSync4(targetSkillDir)) {
-      mkdirSync3(targetSkillDir, { recursive: true });
+  const skillMdSource = join7(skillDir, "SKILL.md");
+  if (existsSync5(skillMdSource)) {
+    if (!existsSync5(targetSkillDir)) {
+      mkdirSync4(targetSkillDir, { recursive: true });
     }
-    const skillMdTarget = join6(targetSkillDir, "SKILL.md");
+    const skillMdTarget = join7(targetSkillDir, "SKILL.md");
     const content = readFileSync5(skillMdSource, "utf-8");
     writeFileSync3(skillMdTarget, content);
   }
-  const referencesSource = join6(skillDir, "references");
-  if (existsSync4(referencesSource)) {
-    const targetReferencesDir = join6(targetSkillDir, "references");
-    if (!existsSync4(targetReferencesDir)) {
-      mkdirSync3(targetReferencesDir, { recursive: true });
+  const referencesSource = join7(skillDir, "references");
+  if (existsSync5(referencesSource)) {
+    const targetReferencesDir = join7(targetSkillDir, "references");
+    if (!existsSync5(targetReferencesDir)) {
+      mkdirSync4(targetReferencesDir, { recursive: true });
     }
     const referenceFiles = readdirSync3(referencesSource).filter((f) => f.endsWith(".md"));
     for (const file of referenceFiles) {
-      const sourcePath = join6(referencesSource, file);
-      const targetPath = join6(targetReferencesDir, file);
+      const sourcePath = join7(referencesSource, file);
+      const targetPath = join7(targetReferencesDir, file);
       const content = readFileSync5(sourcePath, "utf-8");
       writeFileSync3(targetPath, content);
     }
   }
-  if (existsSync4(commandsSource)) {
-    if (!existsSync4(commandsPath)) {
-      mkdirSync3(commandsPath, { recursive: true });
+  if (existsSync5(commandsSource)) {
+    if (!existsSync5(commandsPath)) {
+      mkdirSync4(commandsPath, { recursive: true });
     }
     const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
     for (const file of commandFiles) {
-      const sourcePath = join6(commandsSource, file);
-      const targetPath = join6(commandsPath, file);
+      const sourcePath = join7(commandsSource, file);
+      const targetPath = join7(commandsPath, file);
       const content = readFileSync5(sourcePath, "utf-8");
       writeFileSync3(targetPath, content);
     }
   }
   const installedAgents = [];
-  if (existsSync4(agentsSource)) {
+  if (existsSync5(agentsSource)) {
     const agentDirs = readdirSync3(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
     for (const agentName of agentDirs) {
-      const agentDir = join6(agentsSource, agentName);
+      const agentDir = join7(agentsSource, agentName);
       const result = installAgentFromPath(agentDir, agentName);
       if (result.success) {
         installedAgents.push(agentName);
@@ -801,6 +902,11 @@ function installSkill(skillName) {
   saveConfig(config);
   const installedSkillNames = Object.keys(updatedTools);
   updatePlatformConfigSkills(config.platform, installedSkillNames);
+  const toolName = basename(toolDir);
+  const migrationResult = runToolMigrations(toolName, manifest.version);
+  if (!migrationResult.success) {
+    console.warn(`Warning: Migration failed for ${toolName}: ${migrationResult.error}`);
+  }
   return { success: true, message: `Installed ${skillName} v${manifest.version}` };
 }
 function uninstallSkill(skillName) {
@@ -810,19 +916,19 @@ function uninstallSkill(skillName) {
     return { success: false, message: `Skill '${skillName}' is not installed` };
   }
   const skillsPath = getSkillsInstallPath(config.platform);
-  const skillDir = join6(skillsPath, skillName);
-  if (existsSync4(skillDir)) {
-    rmSync(skillDir, { recursive: true });
+  const skillDir = join7(skillsPath, skillName);
+  if (existsSync5(skillDir)) {
+    rmSync2(skillDir, { recursive: true });
   }
   const skillPath = findSkillPath(skillName);
   const commandsPath = getCommandsInstallPath(config.platform);
-  const commandsSource = skillPath ? join6(skillPath.toolDir, "commands") : null;
-  if (commandsSource && existsSync4(commandsSource)) {
+  const commandsSource = skillPath ? join7(skillPath.toolDir, "commands") : null;
+  if (commandsSource && existsSync5(commandsSource)) {
     const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
     for (const file of commandFiles) {
-      const commandPath = join6(commandsPath, file);
-      if (existsSync4(commandPath)) {
-        rmSync(commandPath);
+      const commandPath = join7(commandsPath, file);
+      if (existsSync5(commandPath)) {
+        rmSync2(commandPath);
       }
     }
   }
@@ -872,13 +978,13 @@ var OPENCODE_SKILLS_PLUGIN = "opencode-skills";
 function configurePlatformPermissions(platform) {
   const added = [];
   if (platform === "claude-code" /* ClaudeCode */) {
-    const settingsPath = join7(homedir3(), ".claude", "settings.json");
-    const claudeDir = join7(homedir3(), ".claude");
-    if (!existsSync5(claudeDir)) {
-      mkdirSync4(claudeDir, { recursive: true });
+    const settingsPath = join8(homedir3(), ".claude", "settings.json");
+    const claudeDir = join8(homedir3(), ".claude");
+    if (!existsSync6(claudeDir)) {
+      mkdirSync5(claudeDir, { recursive: true });
     }
     let settings = {};
-    if (existsSync5(settingsPath)) {
+    if (existsSync6(settingsPath)) {
       try {
         settings = JSON.parse(readFileSync6(settingsPath, "utf-8"));
       } catch {
@@ -909,13 +1015,13 @@ function configurePlatformPermissions(platform) {
     return { added, alreadyPresent: added.length === 0 };
   }
   if (platform === "opencode" /* OpenCode */) {
-    const globalConfigDir = join7(homedir3(), ".config", "opencode");
-    const globalConfigPath = join7(globalConfigDir, "opencode.json");
-    if (!existsSync5(globalConfigDir)) {
-      mkdirSync4(globalConfigDir, { recursive: true });
+    const globalConfigDir = join8(homedir3(), ".config", "opencode");
+    const globalConfigPath = join8(globalConfigDir, "opencode.json");
+    if (!existsSync6(globalConfigDir)) {
+      mkdirSync5(globalConfigDir, { recursive: true });
     }
     let config = {};
-    if (existsSync5(globalConfigPath)) {
+    if (existsSync6(globalConfigPath)) {
       try {
         config = JSON.parse(readFileSync6(globalConfigPath, "utf-8"));
       } catch {
@@ -1180,8 +1286,9 @@ async function promptForSkillConfig(skillName, configSchema, askFirst = true) {
   }
   if (Object.keys(overrides).length > 0) {
     saveSkillOverrides(skillName, overrides);
+    const displayName = skillName.replace(/^droid-/, "");
     console.log(chalk4.green(`
-\u2713 Configuration saved to ~/.droid/skills/${skillName}/overrides.yaml`));
+\u2713 Configuration saved to ~/.droid/skills/${displayName}/overrides.yaml`));
   } else {
     console.log(chalk4.gray("\nNo custom configuration set (using defaults)."));
   }
@@ -2240,8 +2347,8 @@ function ReadmeViewer({ title, content, onClose }) {
 // src/commands/tui/views/ToolExplorer.tsx
 import { Box as Box10, Text as Text11, useInput as useInput5 } from "ink";
 import { useState as useState5, useMemo as useMemo3 } from "react";
-import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
+import { join as join9 } from "path";
 import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
 function ToolExplorer({ tool, onViewSource, onClose }) {
   const [selectedIndex, setSelectedIndex] = useState5(0);
@@ -2252,21 +2359,21 @@ function ToolExplorer({ tool, onViewSource, onClose }) {
       result.push({
         type: "skill",
         name: skill.name,
-        path: join8(toolDir, tool.name, "skills", skill.name, "SKILL.md")
+        path: join9(toolDir, tool.name, "skills", skill.name, "SKILL.md")
       });
     }
     for (const cmd of tool.includes.commands) {
       result.push({
         type: "command",
         name: `/${cmd}`,
-        path: join8(toolDir, tool.name, "commands", `${cmd}.md`)
+        path: join9(toolDir, tool.name, "commands", `${cmd}.md`)
       });
     }
     for (const agent of tool.includes.agents) {
       result.push({
         type: "agent",
         name: agent,
-        path: join8(toolDir, tool.name, "agents", agent, "AGENT.md")
+        path: join9(toolDir, tool.name, "agents", agent, "AGENT.md")
       });
     }
     return result;
@@ -2284,12 +2391,12 @@ function ToolExplorer({ tool, onViewSource, onClose }) {
     }
     if (key.return && items.length > 0) {
       const item = items[selectedIndex];
-      if (existsSync6(item.path)) {
+      if (existsSync7(item.path)) {
         const content = readFileSync7(item.path, "utf-8");
         onViewSource(`${tool.name} / ${item.name}`, content);
       } else {
         const yamlPath = item.path.replace(".md", ".yaml");
-        if (existsSync6(yamlPath)) {
+        if (existsSync7(yamlPath)) {
           const content = readFileSync7(yamlPath, "utf-8");
           onViewSource(`${tool.name} / ${item.name}`, content);
         }