@codihaus/claude-skills 1.6.28 → 1.6.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codihaus/claude-skills",
-  "version": "1.6.28",
+  "version": "1.6.30",
   "description": "Claude Code skills for software development workflow",
   "main": "src/index.js",
   "bin": {

package/skills/debrief/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: debrief
 description: Customer requirements → questionnaire (default) or BRD (with --answers flag)
-version: 5.3.1
+version: 5.3.2
 ---
 
 # /debrief - Business Requirements Document
@@ -92,10 +92,14 @@ version: 5.3.1
 ### 4. Questionnaire = Decision Tool
 
 **How to generate**:
+1. Write JSON to temp file: `/tmp/debrief-questions-{timestamp}.json`
+2. Call Python script with file path:
 ```bash
-python .claude/skills/debrief/scripts/generate_questionnaire.py questionnaire-{YYYY-MM-DD}.xlsx -
+python .claude/skills/debrief/scripts/generate_questionnaire.py \
+  plans/brd/use-cases/{feature-name}/questionnaire-{YYYY-MM-DD}.xlsx \
+  /tmp/debrief-questions-{timestamp}.json
 ```
-Pipe JSON to stdin with research data (see `references/workflow.md` for full JSON format).
+(See `references/workflow.md` for full JSON format)
 
 **CRITICAL: Populate with real data**:
 - **questions array**: 2-5 questions per feature (validation + open questions)
@@ -168,6 +172,11 @@ AskUserQuestion, WebSearch, Glob, Read, Write, Bash
 
 ## Scripts
 
+**Generate questionnaire from JSON file**:
 ```bash
-python .claude/skills/debrief/scripts/generate_questionnaire.py output.xlsx questions.json
+python .claude/skills/debrief/scripts/generate_questionnaire.py \
+  plans/brd/use-cases/{feature}/questionnaire-{date}.xlsx \
+  /tmp/debrief-questions.json
 ```
+
+**JSON file should be written to `/tmp/` first**, then passed to script.

package/skills/debrief/references/workflow.md

@@ -82,8 +82,14 @@
 
 **How to generate**:
 1. Create JSON with research data (see format below)
-2. Call Python script: `python .claude/skills/debrief/scripts/generate_questionnaire.py questionnaire-{YYYY-MM-DD}.xlsx -`
-3. Pipe JSON to stdin or save as file
+2. **Write JSON to temp file**: `/tmp/debrief-questions-{timestamp}.json`
+3. **Call Python script with file path**:
+   ```bash
+   python .claude/skills/debrief/scripts/generate_questionnaire.py \
+     plans/brd/use-cases/{feature-name}/questionnaire-{YYYY-MM-DD}.xlsx \
+     /tmp/debrief-questions-{timestamp}.json
+   ```
+4. Python reads JSON from temp file and creates Excel in correct BRD location
 
 **CRITICAL: Populate questions array with TWO types:**
 

package/src/commands/init.js

@@ -9,6 +9,7 @@ import ora from 'ora';
 import inquirer from 'inquirer';
 import path from 'path';
 import fs from 'fs-extra';
+import { execSync } from 'child_process';
 
 import {
   checkGlobalDeps,
@@ -24,7 +25,9 @@ import {
   getInstalledSkills,
   copySkillsToProject,
   copyKnowledgeToProject,
-  copyScriptsToProject
+  copyScriptsToProject,
+  checkForUpdates,
+  cleanupOldSkills
 } from '../utils/skills.js';
 import {
   setupSettings,
@@ -124,8 +127,88 @@ export async function init(options) {
     }
 
     if (action === 'update') {
-      // TODO: Implement update logic
-      console.log(chalk.cyan('Updating skills...'));
+      console.log('');
+
+      // Check for CLI package updates first
+      const packageSpinner = ora('Checking npm for latest CLI version...').start();
+      try {
+        const currentVersion = await getCurrentPackageVersion();
+        const latestVersion = await getLatestNpmVersion();
+
+        if (currentVersion !== latestVersion) {
+          packageSpinner.info(`CLI update available: ${currentVersion} → ${latestVersion}`);
+
+          // Auto-update the CLI package
+          const updateSpinner = ora('Updating CLI package...').start();
+          try {
+            execSync('npm install -g @codihaus/claude-skills@latest', {
+              encoding: 'utf8',
+              stdio: 'pipe'
+            });
+            updateSpinner.succeed(`CLI package updated to ${latestVersion}`);
+            console.log(chalk.green(`\n✅ Please re-run init to update skills with the new CLI version.\n`));
+            process.exit(0);
+          } catch (updateErr) {
+            updateSpinner.fail('Failed to update CLI package');
+            console.log(chalk.yellow(`\nTo update manually, run:\n  npm install -g @codihaus/claude-skills@latest\n`));
+          }
+        } else {
+          packageSpinner.succeed(`CLI package is up to date (${currentVersion})`);
+        }
+      } catch (e) {
+        packageSpinner.warn('Could not check for CLI updates');
+      }
+
+      console.log('');
+
+      // Check for skill updates
+      const skillSpinner = ora('Checking for skill updates...').start();
+      const updates = await checkForUpdates(projectPath);
+      skillSpinner.stop();
+
+      if (updates.length === 0) {
+        console.log(chalk.green('✅ All skills are up to date!\n'));
+        process.exit(0);
+      }
+
+      console.log(chalk.cyan(`Found ${updates.length} skill update(s) available:\n`));
+
+      for (const update of updates) {
+        console.log(`  ${update.name}`);
+        console.log(chalk.gray(`    ${update.current} → ${update.available}`));
+        console.log('');
+      }
+
+      // Apply skill updates
+      const updateSkillsSpinner = ora('Updating skills...').start();
+
+      try {
+        const skillNames = updates.map(u => u.name);
+
+        // Clean up old files first
+        updateSkillsSpinner.text = 'Cleaning up old skill files...';
+        await cleanupOldSkills(projectPath, skillNames);
+
+        // Copy new versions
+        updateSkillsSpinner.text = 'Installing updated skills...';
+        const { copied, errors } = await copySkillsToProject(projectPath, skillNames);
+
+        if (errors.length > 0) {
+          updateSkillsSpinner.warn(`Updated ${copied.length} skills with ${errors.length} errors`);
+          for (const err of errors) {
+            console.log(chalk.red(`  ✗ ${err.name}: ${err.error}`));
+          }
+        } else {
+          updateSkillsSpinner.succeed(`Updated ${copied.length} skills`);
+        }
+      } catch (e) {
+        updateSkillsSpinner.fail('Update failed');
+        console.error(chalk.red(e.message));
+        process.exit(1);
+      }
+
+      console.log(chalk.green('\n✅ Update complete!\n'));
+      process.exit(0);
     }
   }
 
@@ -409,3 +492,30 @@ export async function init(options) {
     console.log('');
   }
 }
+
+/**
+ * Get current package version
+ */
+async function getCurrentPackageVersion() {
+  try {
+    const packageJson = await fs.readJson(path.join(import.meta.dirname, '../../package.json'));
+    return packageJson.version;
+  } catch (e) {
+    return 'unknown';
+  }
+}
+
+/**
+ * Get latest version from npm
+ */
+async function getLatestNpmVersion() {
+  try {
+    const result = execSync('npm view @codihaus/claude-skills version', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'ignore']
+    });
+    return result.trim();
+  } catch (e) {
+    throw new Error('Could not fetch latest version from npm');
+  }
+}

package/src/commands/update.js

@@ -25,7 +25,21 @@ export async function update(options) {
 
     if (currentVersion !== latestVersion) {
       packageSpinner.info(`Package update available: ${currentVersion} → ${latestVersion}`);
-      console.log(chalk.yellow(`\nTo update the CLI package, run:\n  npm install -g @codihaus/claude-skills@latest\n`));
+
+      // Auto-update the CLI package
+      const updateSpinner = ora('Updating CLI package...').start();
+      try {
+        execSync('npm install -g @codihaus/claude-skills@latest', {
+          encoding: 'utf8',
+          stdio: 'pipe'
+        });
+        updateSpinner.succeed(`CLI package updated to ${latestVersion}`);
+        console.log(chalk.green(`\n✅ Please re-run this command to update skills with the new CLI version.\n`));
+        process.exit(0);
+      } catch (updateErr) {
+        updateSpinner.fail('Failed to update CLI package');
+        console.log(chalk.yellow(`\nTo update manually, run:\n  npm install -g @codihaus/claude-skills@latest\n`));
+      }
     } else {
       packageSpinner.succeed(`CLI package is up to date (${currentVersion})`);
     }