@orderful/droid 0.26.0 → 0.27.1

package/.claude-plugin/marketplace.json

@@ -22,7 +22,7 @@
     {
       "name": "droid-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.3",
+      "version": "0.3.0",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -35,7 +35,7 @@
     {
       "name": "droid-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.3",
+      "version": "0.2.0",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -48,7 +48,7 @@
     {
       "name": "droid-code-review",
       "description": "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring.",
-      "version": "0.1.2",
+      "version": "0.2.0",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -61,7 +61,7 @@
     {
       "name": "droid-codex",
       "description": "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries.",
-      "version": "0.1.5",
+      "version": "0.1.6",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -74,7 +74,7 @@
     {
       "name": "droid-comments",
       "description": "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration.",
-      "version": "0.2.6",
+      "version": "0.3.0",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -87,7 +87,7 @@
     {
       "name": "droid-project",
       "description": "Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features.",
-      "version": "0.2.0",
+      "version": "0.3.0",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -100,7 +100,7 @@
     {
       "name": "droid-tech-design",
       "description": "Technical design authoring tool for engineers. Create structured tech design docs with /tech-design start, iterate in brain, publish to codex. Three-document approach: research doc (codebase discoveries) + thought doc (design workspace) + roll-up (clean summary for review).",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "source": {
         "source": "github",
         "repo": "orderful/droid",

package/AGENTS.md

@@ -50,12 +50,13 @@ src/
 
 We use **two** terminal UI libraries for different purposes:
 
-| Library | Purpose | Used In |
-|---------|---------|---------|
-| **Ink** | Full React-based TUI dashboard | `tui.tsx`, `tui/components/`, `tui/views/` |
+| Library      | Purpose                                     | Used In                                    |
+| ------------ | ------------------------------------------- | ------------------------------------------ |
+| **Ink**      | Full React-based TUI dashboard              | `tui.tsx`, `tui/components/`, `tui/views/` |
 | **Inquirer** | Simple CLI prompts (select, confirm, input) | `skills.ts`, `setup.ts`, `skill-config.ts` |
 
 **Why both?**
+
 - **Ink** is for the interactive dashboard—stateful, component-based, keyboard navigation
 - **Inquirer** is for quick sequential prompts ("Which tool?", "Configure now? y/n")
 
@@ -78,13 +79,12 @@ Don't consolidate them. Using Ink for simple prompts would be overkill.
 
 Things that will bite you if you don't know:
 
-| Gotcha | Why | What to do |
-|--------|-----|------------|
-| Single-line YAML descriptions | Claude Code's frontmatter parser doesn't handle multiline YAML (`>-`) | Use single-line quoted strings in frontmatter |
-| Skill directories have `droid-` prefix | Workaround for Claude Code bug where directories matching command names block invocation | Name skill dirs `droid-{name}/`, commands stay as `{name}.md` |
-| Bump tool version when skill content changes | Users won't get updates otherwise | Patch bump the tool's TOOL.yaml version |
-| Config-first in commands | User overrides must take precedence | Always read `~/.droid/skills/{skill}/overrides.yaml` before using defaults |
-| Changeset package name | npm package is scoped | Use `"@orderful/droid"` not `"droid"` in changesets |
+| Gotcha                                       | Why                                                                   | What to do                                                                 |
+| -------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| Single-line YAML descriptions                | Claude Code's frontmatter parser doesn't handle multiline YAML (`>-`) | Use single-line quoted strings in frontmatter                              |
+| Bump tool version when skill content changes | Users won't get updates otherwise                                     | Patch bump the tool's TOOL.yaml version                                    |
+| Config-first in commands                     | User overrides must take precedence                                   | Always read `~/.droid/skills/{skill}/overrides.yaml` before using defaults |
+| Changeset package name                       | npm package is scoped                                                 | Use `"@orderful/droid"` not `"droid"` in changesets                        |
 
 ## Testing
 
@@ -96,6 +96,7 @@ bun run screenshot      # On-demand TUI screenshot for visual verification
 ```
 
 **When to run what:**
+
 - Changed core logic (`lib/`) → `bun test src/`
 - Changed TUI components → `bun run test:tui`
 - Visual changes you want to verify → `bun run screenshot`
@@ -107,7 +108,7 @@ bun run screenshot      # On-demand TUI screenshot for visual verification
 2. Add `SKILL.md` with frontmatter:
    ```yaml
    ---
-   name: droid-{skill}
+   name: { skill }
    description: "{What it does}. Use when {scenarios}. User prompts like {examples}."
    globs: []
    alwaysApply: false
@@ -124,16 +125,16 @@ bun run screenshot      # On-demand TUI screenshot for visual verification
 
 Each tool has a specific domain. Know where your feature belongs:
 
-| Tool | Purpose | Add skills here when... |
-|------|---------|------------------------|
-| `brain` | Personal scratchpad, planning docs | Working with brain vault, planning, research |
-| `coach` | Learning-mode assistance | Educational interactions, scaffolding |
-| `code-review` | PR and code review | Review-related features |
-| `codex` | Shared org knowledge (PRDs, designs) | Codex content management, org context |
-| `comments` | Inline @mentions in code | Comment handling, async collaboration |
-| `droid` | **Meta-tool only** - updates, discovery | NEVER add skills here - create new tool instead |
-| `project` | Personal project context | Project file management |
-| `tech-design` | Tech design authoring | Tech design workflows |
+| Tool          | Purpose                                 | Add skills here when...                         |
+| ------------- | --------------------------------------- | ----------------------------------------------- |
+| `brain`       | Personal scratchpad, planning docs      | Working with brain vault, planning, research    |
+| `coach`       | Learning-mode assistance                | Educational interactions, scaffolding           |
+| `code-review` | PR and code review                      | Review-related features                         |
+| `codex`       | Shared org knowledge (PRDs, designs)    | Codex content management, org context           |
+| `comments`    | Inline @mentions in code                | Comment handling, async collaboration           |
+| `droid`       | **Meta-tool only** - updates, discovery | NEVER add skills here - create new tool instead |
+| `project`     | Personal project context                | Project file management                         |
+| `tech-design` | Tech design authoring                   | Tech design workflows                           |
 
 > **Important:** The `droid` tool is special. It only handles update awareness and tool discovery.
 > If you're building a full-featured capability (like tech-design, codex, brain), create a **new tool**.
@@ -141,6 +142,7 @@ Each tool has a specific domain. Know where your feature belongs:
 ## Adding a New Tool
 
 Create a new tool when the feature:
+
 - Has its own user-facing identity (e.g., `/tech-design`, `/deploy`)
 - Doesn't naturally belong to an existing tool's domain
 - Needs its own versioning/release cycle
@@ -150,24 +152,26 @@ Create a new tool when the feature:
 
 1. Create directory: `src/tools/{tool}/`
 2. Add `TOOL.yaml`:
+
    ```yaml
-   name: {tool}
+   name: { tool }
    description: "What this tool does"
    version: 0.1.0
    status: beta
 
    includes:
      skills:
-       - name: droid-{tool}
+       - name: { tool }
          required: true
      commands:
-       - name: {tool}
+       - name: { tool }
          required: false
      agents: []
 
    dependencies: []
    ```
-3. Create skill: `src/tools/{tool}/skills/droid-{tool}/SKILL.md`
+
+3. Create skill: `src/tools/{tool}/skills/{tool}/SKILL.md`
 4. Create command: `src/tools/{tool}/commands/{tool}.md`
 5. Add changeset: `.changeset/{tool}-initial.md`
 
@@ -177,10 +181,10 @@ Create a new tool when the feature:
 
 Decisions that affect how you work:
 
-| Decision | Rationale |
-|----------|-----------|
-| "Scripts" not "tools" for skill CLIs | Avoids terminology collision—droid "tools" are packages, skill "scripts" are executables |
-| Parallel skills (`{skill}-next`) for risky refactors | Dogfood new implementation alongside original, swap when confident |
-| Each .md owns its metadata | Single source of truth per artifact, contributors can bring existing skills as-is |
-| Ink + Inquirer (not consolidated) | Ink for stateful TUI, Inquirer for simple prompts—right tool for each job |
-| Collision detection over prefixing | Detect conflicts at install time rather than polluting command names with prefixes |
+| Decision                                             | Rationale                                                                                |
+| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| "Scripts" not "tools" for skill CLIs                 | Avoids terminology collision—droid "tools" are packages, skill "scripts" are executables |
+| Parallel skills (`{skill}-next`) for risky refactors | Dogfood new implementation alongside original, swap when confident                       |
+| Each .md owns its metadata                           | Single source of truth per artifact, contributors can bring existing skills as-is        |
+| Ink + Inquirer (not consolidated)                    | Ink for stateful TUI, Inquirer for simple prompts—right tool for each job                |
+| Collision detection over prefixing                   | Detect conflicts at install time rather than polluting command names with prefixes       |

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @orderful/droid
 
+## 0.27.1
+
+### Patch Changes
+
+- [#148](https://github.com/Orderful/droid/pull/148) [`7b030da`](https://github.com/Orderful/droid/commit/7b030da044551b66674f06b0fb8e31257b5a1fd4) Thanks [@frytyler](https://github.com/frytyler)! - Fix installation detection after commands-skills merge
+
+  **Bug fix:**
+  - Add package migration (v0.27.0) to update config entries from `droid-*` to unprefixed names
+  - Fixes TUI showing tools as not installed after upgrade from v0.26.0
+  - Migration handles both Claude Code and OpenCode platforms automatically
+  - Runs seamlessly on TUI startup - no user action required
+
+  **Technical details:**
+  - Config entries renamed: `droid-brain` → `brain`, `droid-codex` → `codex`, etc.
+  - Special `droid` tool preserved (not renamed)
+  - Platform switching continues to work correctly after migration
+
+## 0.27.0
+
+### Minor Changes
+
+- [#145](https://github.com/Orderful/droid/pull/145) [`8bce17d`](https://github.com/Orderful/droid/commit/8bce17d98824e796573db1f8a640a8af786fc2d1) Thanks [@frytyler](https://github.com/frytyler)! - Remove droid- prefix from skills and fix command argument passing
+
+  **Breaking internal changes:**
+  - Skills renamed: `droid-brain` → `brain`, `droid-comments` → `comments`, etc.
+  - All skill directories now use unprefixed names
+  - Automatic cleanup removes old `droid-*` directories on upgrade
+
+  **Command improvements:**
+  - Commands now use explicit instruction pattern for better argument passing in OpenCode
+  - Each command file includes examples and quick reference
+  - Alias commands (e.g., `/scratchpad`) properly documented as aliases
+
+  **Platform compatibility:**
+  - OpenCode: Receives all commands (for autocomplete)
+  - Claude Code: Receives only alias commands (relies on unified skills/commands)
+  - Both platforms get unprefixed skill names
+
+  Tools updated: brain, coach, code-review, codex, comments, project, tech-design
+
+### Patch Changes
+
+- [#146](https://github.com/Orderful/droid/pull/146) [`2c87b87`](https://github.com/Orderful/droid/commit/2c87b874a38b0f52d1edf77b2995e565f155f251) Thanks [@frytyler](https://github.com/frytyler)! - fix(codex): make CONTEXT.md generation synchronous by default with optional async
+
+  Changed auto-generation from async-only (with background agents) to flexible approach where LLM can choose synchronous (works everywhere) or asynchronous (Claude Code only). This fixes the issue where CONTEXT.md files were never being generated because background agents weren't working reliably.
+
 ## 0.26.0
 
 ### Minor Changes

package/dist/bin/droid.js

@@ -392,7 +392,9 @@ function getToolsWithUpdates() {
   const toolsWithUpdates = [];
   for (const tool of bundledTools) {
     const requiredSkills = tool.includes.skills.filter((s) => s.required).map((s) => s.name);
-    const isInstalled = requiredSkills.some((skillName) => skillName in installedTools);
+    const isInstalled = requiredSkills.some(
+      (skillName) => skillName in installedTools
+    );
     if (isInstalled) {
       const updateStatus = getToolUpdateStatus(tool.name);
       if (updateStatus.hasUpdate) {
@@ -613,27 +615,76 @@ function createPlatformSyncMigration(version2) {
     }
   };
 }
+function createConfigSkillNameMigration(version2) {
+  return {
+    version: version2,
+    description: "Remove droid- prefix from config skill names",
+    up: () => {
+      const config = loadConfig();
+      let configChanged = false;
+      const originalPlatform = config.platform;
+      for (const platformKey of ["claude-code" /* ClaudeCode */, "opencode" /* OpenCode */]) {
+        if (!config.platforms[platformKey]) continue;
+        config.platform = platformKey;
+        const trackedTools = getPlatformTools(config);
+        const skillNames = Object.keys(trackedTools);
+        for (const skillName of skillNames) {
+          if (!skillName.startsWith("droid-") || skillName === "droid") {
+            continue;
+          }
+          const unprefixedName = skillName.replace(/^droid-/, "");
+          if (!trackedTools[unprefixedName]) {
+            trackedTools[unprefixedName] = trackedTools[skillName];
+            delete trackedTools[skillName];
+            configChanged = true;
+          }
+        }
+        if (configChanged) {
+          setPlatformTools(config, trackedTools);
+        }
+      }
+      config.platform = originalPlatform;
+      if (configChanged) {
+        saveConfig(config);
+      }
+    }
+  };
+}
+var PACKAGE_MIGRATIONS = [
+  createPlatformSyncMigration("0.25.0"),
+  createConfigSkillNameMigration("0.27.0")
+];
 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")],
-  // Global migration for the droid meta-tool
-  droid: [createPlatformSyncMigration("0.25.0")]
+  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";
+  if (config.migrations?.tools?.[toolName]) {
+    return config.migrations.tools[toolName];
+  }
+  if (config.migrations && typeof config.migrations[toolName] === "string") {
+    return config.migrations[toolName];
+  }
+  return "0.0.0";
 }
 function setLastMigratedVersion(toolName, version2) {
   const config = loadConfig();
   if (!config.migrations) {
     config.migrations = {};
   }
-  config.migrations[toolName] = version2;
+  if (!config.migrations.tools) {
+    config.migrations.tools = {};
+  }
+  config.migrations.tools[toolName] = version2;
+  if (typeof config.migrations[toolName] === "string") {
+    delete config.migrations[toolName];
+  }
   saveConfig(config);
 }
 function runMigrations(toolName, fromVersion, toVersion) {
@@ -677,6 +728,48 @@ function runToolMigrations(toolName, installedVersion) {
   }
   return runMigrations(toolName, lastMigrated, installedVersion);
 }
+function runPackageMigrations(packageVersion) {
+  const config = loadConfig();
+  const lastMigrated = config.migrations?.package ?? "0.0.0";
+  if (compareSemver(packageVersion, lastMigrated) <= 0) {
+    return { success: true };
+  }
+  const pendingMigrations = PACKAGE_MIGRATIONS.filter((m) => {
+    const afterFrom = compareSemver(m.version, lastMigrated) > 0;
+    const beforeOrAtTo = compareSemver(m.version, packageVersion) <= 0;
+    return afterFrom && beforeOrAtTo;
+  });
+  if (pendingMigrations.length === 0) {
+    config.migrations = config.migrations || {};
+    config.migrations.package = packageVersion;
+    saveConfig(config);
+    return { success: true };
+  }
+  const configDir = getConfigDir();
+  for (const migration of pendingMigrations) {
+    try {
+      migration.up(configDir);
+      logMigration("package", lastMigrated, migration.version, "OK");
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logMigration(
+        "package",
+        lastMigrated,
+        migration.version,
+        "FAILED",
+        errorMessage
+      );
+      return {
+        success: false,
+        error: `Package migration ${migration.version} failed: ${errorMessage}`
+      };
+    }
+  }
+  config.migrations = config.migrations || {};
+  config.migrations.package = packageVersion;
+  saveConfig(config);
+  return { success: true };
+}
 
 // src/lib/skills.ts
 var DROID_SKILLS_START = "<!-- droid-skills-start -->";
@@ -861,6 +954,13 @@ function installSkill(skillName) {
       message: `Invalid skill manifest for '${skillName}'`
     };
   }
+  const toolManifest = loadToolManifest(toolDir);
+  if (!toolManifest) {
+    return {
+      success: false,
+      message: `Invalid tool manifest for tool containing '${skillName}'`
+    };
+  }
   if (manifest.dependencies) {
     for (const dep of manifest.dependencies) {
       if (!isToolInstalled(dep)) {
@@ -875,31 +975,39 @@ function installSkill(skillName) {
   const targetSkillDir = join7(skillsPath, skillName);
   const commandsPath = getCommandsInstallPath(config.platform);
   const tools = getPlatformTools(config);
-  if (skillName.startsWith("droid-")) {
-    const oldSkillName2 = skillName.replace(/^droid-/, "");
-    const oldSkillDir = join7(skillsPath, oldSkillName2);
-    if (existsSync5(oldSkillDir)) {
+  const renamedSkills = [
+    "comments",
+    "brain",
+    "project",
+    "coach",
+    "code-review",
+    "codex",
+    "tech-design",
+    "brain-obsidian"
+  ];
+  if (renamedSkills.includes(skillName)) {
+    const droidPrefixedName = `droid-${skillName}`;
+    const droidPrefixedDir = join7(skillsPath, droidPrefixedName);
+    if (existsSync5(droidPrefixedDir)) {
       try {
-        rmSync2(oldSkillDir, { recursive: true });
+        rmSync2(droidPrefixedDir, { recursive: true });
       } catch (error) {
         console.warn(
-          `Warning: Could not remove old skill directory ${oldSkillDir}: ${error}`
+          `Warning: Could not remove old skill directory ${droidPrefixedDir}: ${error}`
         );
       }
     }
-    if (tools[oldSkillName2]) {
-      delete tools[oldSkillName2];
+    if (tools[droidPrefixedName]) {
+      delete tools[droidPrefixedName];
       setPlatformTools(config, tools);
       saveConfig(config);
     }
   }
   const commandsSource = join7(toolDir, "commands");
   const agentsSource = join7(toolDir, "agents");
-  const oldSkillName = skillName.startsWith("droid-") ? skillName.replace(/^droid-/, "") : null;
-  const isAlreadyInstalled = tools[skillName] || oldSkillName && tools[oldSkillName];
+  const isAlreadyInstalled = tools[skillName];
   if (!isAlreadyInstalled) {
     const toolName2 = basename(toolDir);
-    const normalizedToolName = toolName2.replace(/^droid-/, "");
     if (existsSync5(commandsSource)) {
       const commandFiles = readdirSync4(commandsSource).filter(
         (f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md"
@@ -908,7 +1016,7 @@ function installSkill(skillName) {
         const targetCommandPath = join7(commandsPath, file);
         if (existsSync5(targetCommandPath)) {
           const commandName = file.replace(".md", "");
-          if (commandName === toolName2 || commandName === normalizedToolName) {
+          if (commandName === toolName2) {
             continue;
           }
           return {
@@ -982,10 +1090,18 @@ function installSkill(skillName) {
       (f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md"
     );
     for (const file of commandFiles) {
-      const sourcePath = join7(commandsSource, file);
-      const targetPath = join7(commandsPath, file);
-      const content = readFileSync5(sourcePath, "utf-8");
-      writeFileSync3(targetPath, content);
+      const commandName = file.replace(".md", "");
+      const commandMeta = toolManifest.includes.commands.find(
+        (cmd) => (typeof cmd === "string" ? cmd : cmd.name) === commandName
+      );
+      const isAlias = typeof commandMeta === "object" && commandMeta.is_alias;
+      const shouldInstall = config.platform === "opencode" /* OpenCode */ || isAlias;
+      if (shouldInstall) {
+        const sourcePath = join7(commandsSource, file);
+        const targetPath = join7(commandsPath, file);
+        const content = readFileSync5(sourcePath, "utf-8");
+        writeFileSync3(targetPath, content);
+      }
     }
   }
   const installedAgents = [];
@@ -2985,8 +3101,8 @@ function App() {
     }
   });
   useEffect(() => {
-    const droidVersion = getVersion();
-    runToolMigrations("droid", droidVersion);
+    const packageVersion = getVersion();
+    runPackageMigrations(packageVersion);
   }, []);
   useEffect(() => {
     const autoUpdateConfig = getAutoUpdateConfig();