bmad-module-skill-forge 0.2.0

package/tools/cli/lib/version-check.js

@@ -0,0 +1,86 @@
+/**
+ * SKF Version Check
+ * Async, non-blocking check against the npm registry.
+ * Returns a promise that resolves to an update notice string (or null).
+ */
+
+const https = require('node:https');
+const chalk = require('chalk');
+
+const PACKAGE_NAME = 'bmad-module-skill-forge';
+const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+const TIMEOUT_MS = 3000;
+
+function fetchLatestVersion() {
+  return new Promise((resolve) => {
+    const req = https.get(REGISTRY_URL, { timeout: TIMEOUT_MS }, (res) => {
+      if (res.statusCode !== 200) {
+        resolve(null);
+        res.resume();
+        return;
+      }
+
+      let data = '';
+      res.on('data', (chunk) => {
+        data += chunk;
+      });
+      res.on('end', () => {
+        try {
+          const json = JSON.parse(data);
+          resolve(json.version || null);
+        } catch {
+          resolve(null);
+        }
+      });
+    });
+
+    req.on('error', () => resolve(null));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve(null);
+    });
+  });
+}
+
+function compareVersions(current, latest) {
+  const parse = (v) => v.replace(/^v/, '').split('.').map(Number);
+  const [cMajor, cMinor, cPatch] = parse(current);
+  const [lMajor, lMinor, lPatch] = parse(latest);
+
+  if (lMajor > cMajor) return true;
+  if (lMajor === cMajor && lMinor > cMinor) return true;
+  if (lMajor === cMajor && lMinor === cMinor && lPatch > cPatch) return true;
+  return false;
+}
+
+/**
+ * Start an async version check. Call the returned function after your
+ * command finishes to print the update notice (if any).
+ */
+function startVersionCheck(currentVersion) {
+  const checkPromise = fetchLatestVersion().then((latestVersion) => {
+    if (!latestVersion || !compareVersions(currentVersion, latestVersion)) {
+      return null;
+    }
+    return (
+      '\n' +
+      chalk.yellow(`  Update available: ${chalk.dim(currentVersion)} → ${chalk.green(latestVersion)}`) +
+      '\n' +
+      chalk.dim(`  Run: npx skill-forge@latest install`) +
+      '\n'
+    );
+  });
+
+  return async function printIfReady() {
+    try {
+      const notice = await checkPromise;
+      if (notice) {
+        process.stderr.write(notice);
+      }
+    } catch {
+      // Never block or fail the CLI for a version check
+    }
+  };
+}
+
+module.exports = { startVersionCheck, compareVersions };

package/tools/cli/skf-cli.js

@@ -0,0 +1,45 @@
+const { program } = require('commander');
+const installCommand = require('./commands/install');
+const statusCommand = require('./commands/status');
+const uninstallCommand = require('./commands/uninstall');
+const updateCommand = require('./commands/update');
+const { startVersionCheck } = require('./lib/version-check');
+
+// Fix for stdin issues when running through npm on Windows
+if (process.stdin.isTTY) {
+  try {
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    if (process.platform === 'win32') {
+      process.stdin.on('error', () => {});
+    }
+  } catch {
+    // Silently ignore - some environments may not support these operations
+  }
+}
+
+const packageJson = require('../../package.json');
+
+// Start async version check (non-blocking)
+const printUpdateNotice = startVersionCheck(packageJson.version);
+
+program.version(packageJson.version).description('Skill Forge — Evidence-Based Agent Skills Compiler');
+
+for (const command of [installCommand, updateCommand, statusCommand, uninstallCommand]) {
+  const cmd = program.command(command.command).description(command.description);
+  for (const option of command.options || []) {
+    cmd.option(...option);
+  }
+  // Wrap action to print update notice after command completes
+  const originalAction = command.action;
+  cmd.action(async (...args) => {
+    await originalAction(...args);
+    await printUpdateNotice();
+  });
+}
+
+program.parse(process.argv);
+
+if (process.argv.slice(2).length === 0) {
+  program.outputHelp();
+}

package/tools/skf-npx-wrapper.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+/**
+ * SKF CLI - Direct execution wrapper for npx
+ * Ensures proper execution when run via npx from npm registry.
+ */
+
+const { execSync } = require('node:child_process');
+const path = require('node:path');
+const fs = require('node:fs');
+
+// Check if we're running in an npx temporary directory
+const isNpxExecution = __dirname.includes('_npx') || __dirname.includes('.npm');
+
+if (isNpxExecution) {
+  // Running via npx - spawn child process to preserve user's working directory
+  const args = process.argv.slice(2);
+  const cliPath = path.join(__dirname, 'cli', 'skf-cli.js');
+
+  if (!fs.existsSync(cliPath)) {
+    console.error('Error: Could not find skf-cli.js at', cliPath);
+    process.exit(1);
+  }
+
+  try {
+    execSync(`node "${cliPath}" ${args.join(' ')}`, {
+      stdio: 'inherit',
+      cwd: process.cwd(),
+    });
+  } catch (error) {
+    process.exit(error.status || 1);
+  }
+} else {
+  // Local execution - use require
+  require('./cli/skf-cli.js');
+}