@orderful/droid 0.18.0 → 0.20.0

package/dist/index.js

@@ -140,8 +140,12 @@ function getConfigPath() {
 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);
@@ -156,8 +160,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 });
   }
@@ -182,8 +187,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";
 
@@ -457,11 +462,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, version) {
+  const unprefixedName = skillName.replace(/^droid-/, "");
+  return {
+    version,
+    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, version) {
+  const config = loadConfig();
+  if (!config.migrations) {
+    config.migrations = {};
+  }
+  config.migrations[toolName] = version;
+  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 getBundledSkillsDir() {
   return BUNDLED_SKILLS_DIR;
 }
@@ -477,7 +575,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) => {
@@ -496,9 +594,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");
 }
@@ -519,8 +617,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");
@@ -528,7 +626,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,
@@ -540,17 +638,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
       };
     }
@@ -558,17 +656,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);
       }
@@ -691,15 +789,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}`);
       }
@@ -710,14 +808,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,
@@ -726,7 +824,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)) {
@@ -738,49 +836,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);
@@ -799,6 +897,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) {
@@ -808,19 +911,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);
       }
     }
   }
@@ -856,7 +959,7 @@ function isCommandInstalled(commandName, skillName) {
   const commandsPath = getCommandsInstallPath(config.platform);
   const cmdPart = commandName.startsWith(skillName + " ") ? commandName.slice(skillName.length + 1) : commandName;
   const filename = cmdPart.replace(/\s+/g, "-") + ".md";
-  return existsSync4(join6(commandsPath, filename));
+  return existsSync5(join7(commandsPath, filename));
 }
 function installCommand(commandName, skillName) {
   const config = loadConfig();
@@ -864,8 +967,8 @@ function installCommand(commandName, skillName) {
   if (!skillPath) {
     return { success: false, message: `Skill '${skillName}' not found` };
   }
-  const commandsDir = join6(skillPath.toolDir, "commands");
-  if (!existsSync4(commandsDir)) {
+  const commandsDir = join7(skillPath.toolDir, "commands");
+  if (!existsSync5(commandsDir)) {
     return { success: false, message: `No commands found for skill '${skillName}'` };
   }
   const cmdPart = commandName.startsWith(skillName + " ") ? commandName.slice(skillName.length + 1) : commandName;
@@ -878,11 +981,11 @@ function installCommand(commandName, skillName) {
     return { success: false, message: `Command file not found for: ${commandName}` };
   }
   const commandsPath = getCommandsInstallPath(config.platform);
-  if (!existsSync4(commandsPath)) {
-    mkdirSync3(commandsPath, { recursive: true });
+  if (!existsSync5(commandsPath)) {
+    mkdirSync4(commandsPath, { recursive: true });
   }
-  const actualSourcePath = join6(commandsDir, sourceFile);
-  const targetPath = join6(commandsPath, sourceFile);
+  const actualSourcePath = join7(commandsDir, sourceFile);
+  const targetPath = join7(commandsPath, sourceFile);
   try {
     const content = readFileSync5(actualSourcePath, "utf-8");
     writeFileSync3(targetPath, content);
@@ -906,10 +1009,10 @@ function uninstallCommand(commandName, skillName) {
     cmdPart.replace(/\s+/g, "-") + ".md"
   ];
   for (const filename of possibleFilenames) {
-    const commandPath = join6(commandsPath, filename);
-    if (existsSync4(commandPath)) {
+    const commandPath = join7(commandsPath, filename);
+    if (existsSync5(commandPath)) {
       try {
-        rmSync(commandPath);
+        rmSync2(commandPath);
         return { success: true, message: `Uninstalled /${commandName}` };
       } catch (error) {
         return { success: false, message: `Failed to uninstall command: ${error}` };

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,WAAW,EAA0B,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgDxI;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,WAAW,CA2BxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAKpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAchE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAapE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAUrF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAQ5E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,WAAW,EAA0B,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgDxI;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,WAAW,CA2BxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAKpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAchE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAWD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAapE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAWrF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAQ5E"}

package/dist/lib/migrations.d.ts

@@ -0,0 +1,30 @@
+import { type Migration } from './types';
+/**
+ * Get migrations for a tool
+ */
+export declare function getToolMigrations(toolName: string): Migration[];
+/**
+ * Get the last migrated version for a tool
+ */
+export declare function getLastMigratedVersion(toolName: string): string;
+/**
+ * Update the last migrated version for a tool
+ */
+export declare function setLastMigratedVersion(toolName: string, version: string): void;
+/**
+ * Run migrations for a tool between two versions
+ * Returns true if all migrations succeeded, false otherwise
+ */
+export declare function runMigrations(toolName: string, fromVersion: string, toVersion: string): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Run migrations for a tool after install/update
+ * Call this after installSkill() completes
+ */
+export declare function runToolMigrations(toolName: string, installedVersion: string): {
+    success: boolean;
+    error?: string;
+};
+//# sourceMappingURL=migrations.d.ts.map

package/dist/lib/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/lib/migrations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AA4FzC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAO9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAiCtC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAStC"}

package/dist/lib/skill-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-config.d.ts","sourceRoot":"","sources":["../../src/lib/skill-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnF;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC1C,QAAQ,GAAE,OAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAgFf"}
+{"version":3,"file":"skill-config.d.ts","sourceRoot":"","sources":["../../src/lib/skill-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnF;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC1C,QAAQ,GAAE,OAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAkFf"}

package/dist/lib/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -39,6 +39,7 @@ export interface DroidConfig {
     git_username: string;
     platforms: Record<string, PlatformConfig>;
     auto_update?: AutoUpdateConfig;
+    migrations?: Record<string, string>;
 }
 export interface LegacyDroidConfig {
     ai_tool: Platform;
@@ -84,6 +85,15 @@ export interface ConfigOption {
 export interface SkillOverrides {
     [key: string]: string | boolean | number;
 }
+/**
+ * Tool migration function
+ * Should be idempotent - safe to run multiple times
+ */
+export interface Migration {
+    version: string;
+    description: string;
+    up: (configDir: string) => Promise<void> | void;
+}
 /**
  * Tool manifest structure (TOOL.yaml)
  */

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/tools/brain/TOOL.yaml

@@ -1,6 +1,6 @@
 name: brain
 description: "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
-version: 0.2.2
+version: 0.2.3
 status: beta
 
 includes:

package/dist/tools/coach/TOOL.yaml

@@ -1,6 +1,6 @@
 name: coach
 description: "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions."
-version: 0.1.2
+version: 0.1.3
 status: beta
 
 includes:

package/dist/tools/codex/TOOL.yaml

@@ -0,0 +1,32 @@
+name: codex
+description: "Shared organizational knowledge - PRDs, tech designs, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or adding explored topics."
+version: 0.1.0
+status: beta
+
+includes:
+  skills:
+    - name: droid-codex
+      required: true
+  commands:
+    - codex
+  agents: []
+
+dependencies: []
+
+# Prerequisites checked on install
+prerequisites:
+  - name: gh
+    description: GitHub CLI for PR workflows
+    check: "gh --version"
+    install_hint: "brew install gh && gh auth login"
+
+config_schema:
+  codex_repo:
+    type: string
+    description: Path to local orderful-codex repository (required)
+    required: true
+    default: "~/src/github.com/orderful-codex"
+  freshness_days:
+    type: number
+    description: Days before showing staleness warning
+    default: 30

package/dist/tools/codex/commands/codex.md

@@ -0,0 +1,70 @@
+---
+description: Shared organizational knowledge - PRDs, tech designs, patterns, and explored topics
+argument-hint: "[projects | patterns | topics | {name} | search {query} | new {name} | decision {text} | add topic {name}]"
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash(gh:*), Bash(git:*), Bash(ls:*), Bash(mkdir:*)
+---
+
+# /codex
+
+Entry point for shared organizational knowledge. See the **codex skill** for full behaviour.
+
+> Context is AI's multiplier. This is Orderful's.
+
+## Arguments
+
+$ARGUMENTS
+
+## Prerequisites
+
+Before first use, verify:
+
+1. **Repo cloned** at configured `codex_repo` path
+2. **gh CLI** installed and authenticated
+
+## Usage
+
+```bash
+/codex                           # Show categories (projects, patterns, topics)
+/codex projects                  # List projects
+/codex patterns                  # List patterns
+/codex topics                    # List topics
+/codex {name}                    # Load entry (searches all categories)
+/codex search {query}            # Search across everything
+/codex new {name}                # Scaffold new project from templates
+/codex decision {text}           # Append to active project's DECISIONS.md
+/codex snapshot {file} {name}    # Import PDF/markdown to project
+/codex add topic {name}          # Add explored topic with freshness metadata
+```
+
+## Configuration
+
+**ALWAYS read `~/.droid/skills/codex/overrides.yaml` first.**
+
+- `codex_repo` - Path to local orderful-codex repository (required)
+- `freshness_days` - Days before showing staleness warning (default: 30)
+
+## Behaviour
+
+Refer to the codex skill for:
+- **Loading**: How to search, handle matches, check freshness, auto-generate CONTEXT.md
+- **Decisions**: How to append to active project's DECISIONS.md
+- **Topics**: How to capture explored codebase areas with freshness metadata
+- **Creating**: How to scaffold new projects from templates
+
+The skill's `references/` folder contains detailed procedures for each workflow.
+
+## Examples
+
+```bash
+# Load project context
+/codex transaction-templates
+
+# Search for webhook-related content
+/codex search webhook
+
+# Capture a decision during implementation
+/codex decision "Using UUIDv7 for IDs because it's sortable and includes timestamp"
+
+# Save today's exploration as a topic
+/codex add topic organization-hierarchy
+```