@orderful/droid 0.11.1 → 0.13.0

package/src/lib/config.ts

@@ -2,11 +2,16 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 import YAML from 'yaml';
-import { Platform, BuiltInOutput, type DroidConfig, type LegacyDroidConfig, type SkillOverrides } from './types.js';
+import { Platform, BuiltInOutput, type DroidConfig, type LegacyDroidConfig, type SkillOverrides, type AutoUpdateConfig } from './types.js';
 
 const CONFIG_DIR = join(homedir(), '.droid');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.yaml');
 
+const DEFAULT_AUTO_UPDATE: AutoUpdateConfig = {
+  app: false,   // Opt-in: user must enable
+  tools: true,  // Opt-out: enabled by default (tools only update when app updates)
+};
+
 const DEFAULT_CONFIG: DroidConfig = {
   platform: Platform.ClaudeCode,
   user_mention: '@user',
@@ -194,3 +199,27 @@ export function saveSkillOverrides(skillName: string, overrides: SkillOverrides)
   const content = YAML.stringify(overrides, { indent: 2 });
   writeFileSync(overridesPath, content, 'utf-8');
 }
+
+/**
+ * Get auto-update config with defaults applied
+ */
+export function getAutoUpdateConfig(): AutoUpdateConfig {
+  const config = loadConfig();
+  return {
+    ...DEFAULT_AUTO_UPDATE,
+    ...config.auto_update,
+  };
+}
+
+/**
+ * Update auto-update config
+ */
+export function setAutoUpdateConfig(updates: Partial<AutoUpdateConfig>): void {
+  const config = loadConfig();
+  config.auto_update = {
+    ...DEFAULT_AUTO_UPDATE,
+    ...config.auto_update,
+    ...updates,
+  };
+  saveConfig(config);
+}

package/src/lib/tools.ts

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'url';
 import YAML from 'yaml';
 import { loadConfig } from './config.js';
 import { type ToolManifest, type ToolIncludes, getPlatformTools } from './types.js';
+import { compareSemver } from './version.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const BUNDLED_TOOLS_DIR = join(__dirname, '../tools');
@@ -112,29 +113,67 @@ export function getInstalledToolVersion(toolName: string): string | null {
   return null;
 }
 
-/**
- * Check if a tool has an update available
- */
-export function getToolUpdateStatus(toolName: string): {
+export interface ToolUpdateInfo {
+  name: string;
   hasUpdate: boolean;
   installedVersion: string | null;
   bundledVersion: string | null;
-} {
+}
+
+/**
+ * Check if a tool has an update available
+ */
+export function getToolUpdateStatus(toolName: string): ToolUpdateInfo {
   const installedVersion = getInstalledToolVersion(toolName);
   const tool = getBundledTools().find(t => t.name === toolName);
   const bundledVersion = tool?.version || null;
 
   if (!installedVersion || !bundledVersion) {
     return {
+      name: toolName,
       hasUpdate: false,
       installedVersion,
       bundledVersion,
     };
   }
 
+  // Use semver comparison: bundled > installed means update available
+  const hasUpdate = compareSemver(bundledVersion, installedVersion) > 0;
+
   return {
-    hasUpdate: bundledVersion !== installedVersion,
+    name: toolName,
+    hasUpdate,
     installedVersion,
     bundledVersion,
   };
 }
+
+/**
+ * Get all installed tools that have updates available
+ */
+export function getToolsWithUpdates(): ToolUpdateInfo[] {
+  const config = loadConfig();
+  const installedTools = getPlatformTools(config);
+  const bundledTools = getBundledTools();
+
+  const toolsWithUpdates: ToolUpdateInfo[] = [];
+
+  // Check each bundled tool to see if it's installed and has an update
+  for (const tool of bundledTools) {
+    // Find if any of the tool's required skills are installed
+    const requiredSkills = tool.includes.skills
+      .filter(s => s.required)
+      .map(s => s.name);
+
+    const isInstalled = requiredSkills.some(skillName => skillName in installedTools);
+
+    if (isInstalled) {
+      const updateStatus = getToolUpdateStatus(tool.name);
+      if (updateStatus.hasUpdate) {
+        toolsWithUpdates.push(updateStatus);
+      }
+    }
+  }
+
+  return toolsWithUpdates;
+}

package/src/lib/types.ts

@@ -42,12 +42,18 @@ export interface PlatformConfig {
   tools: Record<string, InstalledSkill>;
 }
 
+export interface AutoUpdateConfig {
+  app: boolean;   // Auto-update droid CLI (default: false)
+  tools: boolean; // Auto-update installed tools (default: true)
+}
+
 export interface DroidConfig {
   platform: Platform;
   user_mention: string;
   output_preference: OutputPreference;
   git_username: string;
   platforms: Record<string, PlatformConfig>;
+  auto_update?: AutoUpdateConfig;
 }
 
 // Legacy config structure for migration

package/src/tools/droid/TOOL.yaml

@@ -0,0 +1,18 @@
+name: droid
+description: "Core droid meta-skill for update awareness and discovery. Notifies about droid updates from within Claude Code."
+version: 0.1.0
+status: beta
+
+# System tool - always stays current regardless of auto-update settings
+system: true
+
+includes:
+  skills:
+    - name: droid
+      required: true
+  commands: []
+  agents: []
+
+dependencies: []
+
+config_schema: {}

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

@@ -0,0 +1,117 @@
+---
+name: droid
+description: "Core droid meta-skill for update awareness. Checks for droid updates and notifies users from within Claude Code."
+globs:
+  - "**/*"
+alwaysApply: false
+---
+
+# Droid
+
+Core meta-skill for droid update awareness.
+
+## 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.
+
+## Update Checking
+
+### When to Check
+
+1. **Proactively** - Check for **droid CLI updates** once near the start of each session. This is specifically about the `@orderful/droid` npm package, not general software updates.
+2. **On request** - When user explicitly asks about droid updates ("any droid updates?", "is droid up to date?", "check droid version")
+
+### How to Check
+
+Run this command to get the latest published version:
+
+```bash
+npm view @orderful/droid version 2>/dev/null
+```
+
+Compare against the installed version. To find the installed version, check:
+
+```bash
+cat ~/.droid/config.yaml | grep -A1 "droid:" | grep "version:" | awk '{print $2}'
+```
+
+Or if droid skill isn't in config yet, check the npm global:
+
+```bash
+npm list -g @orderful/droid --depth=0 2>/dev/null | grep @orderful/droid | awk -F@ '{print $NF}'
+```
+
+### Update Notification Format
+
+When an update is available, output this notification:
+
+```
+[● ●] "I suggest a new strategy: let the Wookiee update."
+
+Droid v{latest} is available (you have v{current}).
+Run `droid` to update, then restart Claude Code.
+```
+
+Replace `{latest}` with the npm version and `{current}` with the installed version.
+
+### Session Tracking
+
+**Important:** Only show the update notification ONCE per session. After showing it:
+- Do not show it again in the same conversation
+- Do not repeat it even if user continues chatting
+
+If the user explicitly asks about updates again, you can confirm whether they're up to date.
+
+## Examples
+
+### Proactive Check (Session Start)
+
+User: "Help me refactor this function"
+
+*[Claude checks for droid updates as part of initial response]*
+
+```
+[● ●] "I suggest a new strategy: let the Wookiee update."
+
+Droid v0.12.0 is available (you have v0.11.0).
+Run `droid` to update, then restart Claude Code.
+
+---
+
+Now, let me help you refactor that function...
+```
+
+### User Request
+
+User: "Is droid up to date?"
+
+```
+Let me check...
+
+[● ●] "I suggest a new strategy: let the Wookiee update."
+
+Droid v0.12.0 is available (you have v0.11.0).
+Run `droid` to update, then restart Claude Code.
+```
+
+Or if already up to date:
+
+```
+[● ●] Droid is up to date (v0.12.0).
+```
+
+### Already Notified This Session
+
+User: "Any other updates?"
+
+```
+I already mentioned the droid update earlier. You're on v0.11.0, latest is v0.12.0.
+Run `droid` when you're ready to update.
+```
+
+## Behaviour Notes
+
+- Keep the check quick (timeout after 3 seconds)
+- 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

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

@@ -0,0 +1,7 @@
+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
+status: beta
+dependencies: []
+provides_output: false
+config_schema: {}