@orderful/droid 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @orderful/droid
 
+## 0.14.0
+
+### Minor Changes
+
+- [#77](https://github.com/Orderful/droid/pull/77) [`3c1fed8`](https://github.com/Orderful/droid/commit/3c1fed80b7fc3eafcc5e31e55e99c41477b9a5d3) Thanks [@frytyler](https://github.com/frytyler)! - feat(droid): add tool catalog for discovery (v0.2.0)
+  - Add Tool Catalog section to droid skill for answering "what tools do I have?"
+  - Dynamic version checking via TOOL.yaml files instead of hardcoded versions
+  - Example responses for common discovery questions
+  - Bump droid skill to v0.2.0
+
 ## 0.13.0
 
 ### Minor Changes

package/dist/bin/droid.js

@@ -7,7 +7,7 @@ import { installCommand } from '../commands/install.js';
 import { uninstallCommand } from '../commands/uninstall.js';
 import { updateCommand } from '../commands/update.js';
 import { tuiCommand } from '../commands/tui.js';
-import { getVersion, checkForUpdates } from '../lib/version.js';
+import { getVersion } from '../lib/version.js';
 const version = getVersion();
 program
     .name('droid')
@@ -47,8 +47,6 @@ program
     .command('tui')
     .description('Launch interactive TUI dashboard')
     .action(tuiCommand);
-// Check for updates on any command (non-blocking)
-checkForUpdates().catch(() => { });
 // If no command provided, launch TUI
 if (process.argv.length === 2) {
     tuiCommand();

package/dist/bin/droid.js.map

@@ -1 +1 @@
-{"version":3,"file":"droid.js","sourceRoot":"","sources":["../../src/bin/droid.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AAE7B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,YAAY,EAAE,uBAAuB,CAAC;KAC7C,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;KACxD,MAAM,CAAC,uBAAuB,EAAE,oBAAoB,CAAC;KACrD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,kBAAkB,CAAC;KAC/B,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAE5B,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC;KACtC,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC;KACtC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC5C,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,kDAAkD;AAClD,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAElC,qCAAqC;AACrC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC9B,UAAU,EAAE,CAAC;AACf,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}
+{"version":3,"file":"droid.js","sourceRoot":"","sources":["../../src/bin/droid.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AAE7B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,YAAY,EAAE,uBAAuB,CAAC;KAC7C,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;KACxD,MAAM,CAAC,uBAAuB,EAAE,oBAAoB,CAAC;KACrD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,kBAAkB,CAAC;KAC/B,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAE5B,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC;KACtC,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC;KACtC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC5C,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,qCAAqC;AACrC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC9B,UAAU,EAAE,CAAC;AACf,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
-description: "Core droid meta-skill for update awareness and discovery. Notifies about droid updates from within Claude Code."
-version: 0.1.0
+description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
+version: 0.2.0
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

package/dist/tools/droid/skills/droid/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: droid
-description: "Core droid meta-skill for update awareness. Checks for droid updates and notifies users from within Claude Code."
+description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
 globs:
   - "**/*"
 alwaysApply: false
@@ -8,11 +8,12 @@ alwaysApply: false
 
 # Droid
 
-Core meta-skill for droid update awareness.
+Core meta-skill for droid update awareness and tool discovery.
 
 ## Purpose
 
-Notify users about droid CLI updates from within Claude Code. Users who don't run `droid` often may miss updates - this skill proactively nudges them.
+1. **Update awareness** - Notify users about droid CLI updates from within Claude Code
+2. **Tool discovery** - Help users find the right tools for their workflow
 
 ## Update Checking
 
@@ -115,3 +116,118 @@ Run `droid` when you're ready to update.
 - If the npm check fails (network issues), silently skip - don't error
 - The droid eyes `[● ●]` and Star Wars quote are intentional branding - always include them
 - Be helpful but not annoying - one nudge per session is enough
+
+---
+
+## Tool Catalog
+
+When users ask about droid tools ("what tools do I have?", "what's available?", "what can droid do?"), use this catalog.
+
+### Checking Installed Tools
+
+```bash
+cat ~/.droid/config.yaml
+```
+
+Look for the `tools:` section under the current platform (e.g., `claude_code:`).
+
+### Available Tools
+
+To get tool info (version, status, description), read TOOL.yaml from the droid package:
+
+```bash
+for f in $(npm root -g)/@orderful/droid/dist/tools/*/TOOL.yaml; do echo "---"; cat "$f"; done
+```
+
+**Tools:**
+
+| Tool | Description |
+|------|-------------|
+| **brain** | Collaborative scratchpad for planning and research |
+| **coach** | Learning-mode AI - scaffolds don't implement, questions don't fix |
+| **code-review** | Code review with specialized agents and confidence scoring |
+| **comments** | Inline conversations using @droid/@user markers |
+| **project** | Project context for persistent AI memory across sessions |
+
+### Tool Details
+
+#### brain
+Collaborative scratchpad for planning and research. Create docs with `/brain plan`, `/brain research`, or `/brain review`. Use @mentions for async discussion. Docs persist across sessions.
+
+**Commands:** `/brain`, `/scratchpad`
+**Optional extension:** brain-obsidian (Obsidian vault integration with YAML frontmatter and wikilinks)
+
+#### coach
+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.
+
+**Commands:** `/coach`
+**Requires:** comments tool
+
+#### code-review
+Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring.
+
+**Commands:** `/code-review`
+**Agents:** edi-standards-reviewer, error-handling-reviewer, test-coverage-analyzer, type-reviewer
+
+#### comments
+Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Ideal for code review notes and async collaboration.
+
+**Commands:** `/comments check`, `/comments cleanup`
+
+#### project
+Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features.
+
+**Commands:** `/project`, `/project update`, `/project create`
+
+### Installing Tools
+
+To install a tool:
+```bash
+droid install <tool-name>
+```
+
+Or run `droid` to open the TUI and browse available tools.
+
+### Example Responses
+
+**User:** "What droid tools do I have installed?"
+
+```
+Let me check your installed tools...
+
+[● ●] You have these droid tools installed:
+
+- **comments** (v0.2.3) - Inline @droid/@user conversations
+- **brain** (v0.2.0) - Planning and research scratchpad
+- **project** (v0.1.2) - Project context management
+
+Run `droid` to see all available tools or install new ones.
+```
+
+**User:** "What tools are available?"
+
+```
+[● ●] Here are the droid tools you can install:
+
+| Tool | What it does |
+|------|--------------|
+| brain | Planning and research scratchpad with `/brain` commands |
+| coach | Learning-mode AI that asks questions instead of giving answers |
+| code-review | PR review with specialized agents |
+| comments | Inline @droid/@user conversations in any file |
+| project | Persistent project context across sessions |
+
+Run `droid install <tool>` or just `droid` to browse and install.
+```
+
+**User:** "What's the difference between brain and project?"
+
+```
+[● ●] Good question!
+
+**brain** - For ephemeral thinking: plans, research, reviews. Use `/brain plan auth-refactor` to start a planning doc, iterate with @mentions, then archive when done.
+
+**project** - For persistent context: what the project is, key decisions, current work. Load with `/project myapp` at the start of a session so I have context.
+
+They work well together: research in brain docs, capture decisions in project files.
+```

package/dist/tools/droid/skills/droid/SKILL.yaml

@@ -1,6 +1,6 @@
 name: droid
-description: "Core droid meta-skill for update awareness. Checks for droid updates and notifies users from within Claude Code."
-version: 0.1.0
+description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
+version: 0.2.0
 status: beta
 dependencies: []
 provides_output: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/bin/droid.ts

@@ -8,7 +8,7 @@ import { installCommand } from '../commands/install.js';
 import { uninstallCommand } from '../commands/uninstall.js';
 import { updateCommand } from '../commands/update.js';
 import { tuiCommand } from '../commands/tui.js';
-import { getVersion, checkForUpdates } from '../lib/version.js';
+import { getVersion } from '../lib/version.js';
 
 const version = getVersion();
 
@@ -58,9 +58,6 @@ program
   .description('Launch interactive TUI dashboard')
   .action(tuiCommand);
 
-// Check for updates on any command (non-blocking)
-checkForUpdates().catch(() => {});
-
 // If no command provided, launch TUI
 if (process.argv.length === 2) {
   tuiCommand();

package/src/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
-description: "Core droid meta-skill for update awareness and discovery. Notifies about droid updates from within Claude Code."
-version: 0.1.0
+description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
+version: 0.2.0
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

package/src/tools/droid/skills/droid/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: droid
-description: "Core droid meta-skill for update awareness. Checks for droid updates and notifies users from within Claude Code."
+description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
 globs:
   - "**/*"
 alwaysApply: false
@@ -8,11 +8,12 @@ alwaysApply: false
 
 # Droid
 
-Core meta-skill for droid update awareness.
+Core meta-skill for droid update awareness and tool discovery.
 
 ## Purpose
 
-Notify users about droid CLI updates from within Claude Code. Users who don't run `droid` often may miss updates - this skill proactively nudges them.
+1. **Update awareness** - Notify users about droid CLI updates from within Claude Code
+2. **Tool discovery** - Help users find the right tools for their workflow
 
 ## Update Checking
 
@@ -115,3 +116,118 @@ Run `droid` when you're ready to update.
 - If the npm check fails (network issues), silently skip - don't error
 - The droid eyes `[● ●]` and Star Wars quote are intentional branding - always include them
 - Be helpful but not annoying - one nudge per session is enough
+
+---
+
+## Tool Catalog
+
+When users ask about droid tools ("what tools do I have?", "what's available?", "what can droid do?"), use this catalog.
+
+### Checking Installed Tools
+
+```bash
+cat ~/.droid/config.yaml
+```
+
+Look for the `tools:` section under the current platform (e.g., `claude_code:`).
+
+### Available Tools
+
+To get tool info (version, status, description), read TOOL.yaml from the droid package:
+
+```bash
+for f in $(npm root -g)/@orderful/droid/dist/tools/*/TOOL.yaml; do echo "---"; cat "$f"; done
+```
+
+**Tools:**
+
+| Tool | Description |
+|------|-------------|
+| **brain** | Collaborative scratchpad for planning and research |
+| **coach** | Learning-mode AI - scaffolds don't implement, questions don't fix |
+| **code-review** | Code review with specialized agents and confidence scoring |
+| **comments** | Inline conversations using @droid/@user markers |
+| **project** | Project context for persistent AI memory across sessions |
+
+### Tool Details
+
+#### brain
+Collaborative scratchpad for planning and research. Create docs with `/brain plan`, `/brain research`, or `/brain review`. Use @mentions for async discussion. Docs persist across sessions.
+
+**Commands:** `/brain`, `/scratchpad`
+**Optional extension:** brain-obsidian (Obsidian vault integration with YAML frontmatter and wikilinks)
+
+#### coach
+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.
+
+**Commands:** `/coach`
+**Requires:** comments tool
+
+#### code-review
+Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring.
+
+**Commands:** `/code-review`
+**Agents:** edi-standards-reviewer, error-handling-reviewer, test-coverage-analyzer, type-reviewer
+
+#### comments
+Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Ideal for code review notes and async collaboration.
+
+**Commands:** `/comments check`, `/comments cleanup`
+
+#### project
+Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features.
+
+**Commands:** `/project`, `/project update`, `/project create`
+
+### Installing Tools
+
+To install a tool:
+```bash
+droid install <tool-name>
+```
+
+Or run `droid` to open the TUI and browse available tools.
+
+### Example Responses
+
+**User:** "What droid tools do I have installed?"
+
+```
+Let me check your installed tools...
+
+[● ●] You have these droid tools installed:
+
+- **comments** (v0.2.3) - Inline @droid/@user conversations
+- **brain** (v0.2.0) - Planning and research scratchpad
+- **project** (v0.1.2) - Project context management
+
+Run `droid` to see all available tools or install new ones.
+```
+
+**User:** "What tools are available?"
+
+```
+[● ●] Here are the droid tools you can install:
+
+| Tool | What it does |
+|------|--------------|
+| brain | Planning and research scratchpad with `/brain` commands |
+| coach | Learning-mode AI that asks questions instead of giving answers |
+| code-review | PR review with specialized agents |
+| comments | Inline @droid/@user conversations in any file |
+| project | Persistent project context across sessions |
+
+Run `droid install <tool>` or just `droid` to browse and install.
+```
+
+**User:** "What's the difference between brain and project?"
+
+```
+[● ●] Good question!
+
+**brain** - For ephemeral thinking: plans, research, reviews. Use `/brain plan auth-refactor` to start a planning doc, iterate with @mentions, then archive when done.
+
+**project** - For persistent context: what the project is, key decisions, current work. Load with `/project myapp` at the start of a session so I have context.
+
+They work well together: research in brain docs, capture decisions in project files.
+```

package/src/tools/droid/skills/droid/SKILL.yaml

@@ -1,6 +1,6 @@
 name: droid
-description: "Core droid meta-skill for update awareness. Checks for droid updates and notifies users from within Claude Code."
-version: 0.1.0
+description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
+version: 0.2.0
 status: beta
 dependencies: []
 provides_output: false