kspec 1.0.14 → 1.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kspec",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Spec-driven development workflow for Kiro CLI",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -1,5 +1,6 @@
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const { execSync, spawn } = require('child_process');
 const readline = require('readline');
 
@@ -7,6 +8,7 @@ const KSPEC_DIR = '.kspec';
 const STEERING_DIR = '.kiro/steering';
 const AGENTS_DIR = '.kiro/agents';
 const CONFIG_FILE = path.join(KSPEC_DIR, 'config.json');
+const UPDATE_CHECK_FILE = path.join(os.homedir(), '.kspec-update-check');
 
 // Default config
 const defaultConfig = {
@@ -33,6 +35,62 @@ function saveConfig(cfg) {
 }
 
 const config = loadConfig();
+const pkg = require('../package.json');
+
+// Update check (non-blocking, cached for 24h)
+function shouldCheckUpdate() {
+  try {
+    if (fs.existsSync(UPDATE_CHECK_FILE)) {
+      const lastCheck = parseInt(fs.readFileSync(UPDATE_CHECK_FILE, 'utf8'), 10);
+      const hoursSinceCheck = (Date.now() - lastCheck) / (1000 * 60 * 60);
+      return hoursSinceCheck >= 24;
+    }
+  } catch {}
+  return true;
+}
+
+function saveUpdateCheck() {
+  try {
+    fs.writeFileSync(UPDATE_CHECK_FILE, Date.now().toString());
+  } catch {}
+}
+
+function compareVersions(v1, v2) {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((parts1[i] || 0) < (parts2[i] || 0)) return -1;
+    if ((parts1[i] || 0) > (parts2[i] || 0)) return 1;
+  }
+  return 0;
+}
+
+async function checkForUpdates() {
+  if (!shouldCheckUpdate()) return;
+
+  try {
+    const https = require('https');
+    const data = await new Promise((resolve, reject) => {
+      const req = https.get('https://registry.npmjs.org/kspec/latest', { timeout: 3000 }, res => {
+        let body = '';
+        res.on('data', chunk => body += chunk);
+        res.on('end', () => resolve(body));
+      });
+      req.on('error', reject);
+      req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+    });
+
+    const latest = JSON.parse(data).version;
+    saveUpdateCheck();
+
+    if (compareVersions(pkg.version, latest) < 0) {
+      console.log(`\n  Update available: ${pkg.version} → ${latest}`);
+      console.log(`  Run: npm install -g kspec\n`);
+    }
+  } catch {
+    // Silently fail - don't block user workflow
+  }
+}
 
 // Helpers
 function log(msg) { console.log(`[kspec] ${msg}`); }
@@ -334,7 +392,7 @@ Your job:
 4. Identify risks, tech debt, improvement areas
 
 Output a clear analysis report. Propose specific steering doc updates.`,
-    keyboardShortcut: 'ctrl+a',
+    keyboardShortcut: 'ctrl+shift+a',
     welcomeMessage: 'Analysing codebase...'
   },
 
@@ -368,7 +426,7 @@ WORKFLOW (do this autonomously):
 6. Update .kspec/CONTEXT.md with current state
 
 After completion, suggest: "Switch to kspec-tasks agent to generate implementation tasks"`,
-    keyboardShortcut: 'ctrl+s',
+    keyboardShortcut: 'ctrl+shift+s',
     welcomeMessage: 'Ready to create specification. Describe your feature.'
   },
 
@@ -400,7 +458,7 @@ WORKFLOW:
 Tasks must be atomic and independently verifiable.
 
 After completion, suggest: "Switch to kspec-build agent to start implementing tasks"`,
-    keyboardShortcut: 'ctrl+t',
+    keyboardShortcut: 'ctrl+shift+t',
     welcomeMessage: 'Reading current spec and generating tasks...'
   },
 
@@ -437,7 +495,7 @@ CRITICAL:
 - Use non-interactive flags for commands (--yes, -y)
 
 When all tasks complete, suggest: "Switch to kspec-verify agent to verify implementation"`,
-    keyboardShortcut: 'ctrl+b',
+    keyboardShortcut: 'ctrl+shift+b',
     welcomeMessage: 'Reading current task and building...'
   },
 
@@ -477,7 +535,7 @@ VERIFY-IMPLEMENTATION:
 - List any gaps between spec and implementation
 
 Output a clear verification report with pass/fail status.`,
-    keyboardShortcut: 'ctrl+v',
+    keyboardShortcut: 'ctrl+shift+v',
     welcomeMessage: 'What should I verify?'
   },
 
@@ -507,7 +565,7 @@ Your job:
 4. Provide actionable feedback
 
 Output: APPROVE / REQUEST_CHANGES with specific issues.`,
-    keyboardShortcut: 'ctrl+r',
+    keyboardShortcut: 'ctrl+shift+r',
     welcomeMessage: 'Ready to review. What should I look at?'
   }
 };
@@ -807,17 +865,48 @@ kspec Agents
 
 Agent           Shortcut  Purpose
 ─────────────────────────────────────────────
-kspec-analyse   Ctrl+A    Analyse codebase, update steering
-kspec-spec      Ctrl+S    Create specifications
-kspec-tasks     Ctrl+T    Generate tasks from spec
-kspec-build     Ctrl+B    Execute tasks with TDD
-kspec-verify    Ctrl+V    Verify spec/tasks/implementation
-kspec-review    Ctrl+R    Code review
+kspec-analyse   Ctrl+Shift+A    Analyse codebase, update steering
+kspec-spec      Ctrl+Shift+S    Create specifications
+kspec-tasks     Ctrl+Shift+T    Generate tasks from spec
+kspec-build     Ctrl+Shift+B    Execute tasks with TDD
+kspec-verify    Ctrl+Shift+V    Verify spec/tasks/implementation
+kspec-review    Ctrl+Shift+R    Code review
 
 Switch: /agent swap or use keyboard shortcuts
 `);
   },
 
+  async update() {
+    console.log(`\nkspec v${pkg.version}\n`);
+    console.log('Checking for updates...');
+
+    try {
+      const https = require('https');
+      const data = await new Promise((resolve, reject) => {
+        const req = https.get('https://registry.npmjs.org/kspec/latest', { timeout: 5000 }, res => {
+          let body = '';
+          res.on('data', chunk => body += chunk);
+          res.on('end', () => resolve(body));
+        });
+        req.on('error', reject);
+        req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+      });
+
+      const latest = JSON.parse(data).version;
+      saveUpdateCheck();
+
+      if (compareVersions(pkg.version, latest) < 0) {
+        console.log(`\nUpdate available: ${pkg.version} → ${latest}`);
+        console.log('\nTo update, run:');
+        console.log('  npm install -g kspec\n');
+      } else {
+        console.log(`\nYou're on the latest version!\n`);
+      }
+    } catch (err) {
+      console.error('\nCould not check for updates. Check your internet connection.\n');
+    }
+  },
+
   help() {
     console.log(`
 kspec - Spec-driven development for Kiro CLI
@@ -847,6 +936,7 @@ Other:
   kspec list              List all specs
   kspec status            Current status
   kspec agents            List agents
+  kspec update            Check for updates
   kspec help              Show this help
 
 Examples:
@@ -858,14 +948,17 @@ Examples:
 };
 
 async function run(args) {
+  // Check for updates (non-blocking, cached for 24h)
+  checkForUpdates();
+
   // Handle standard CLI flags first
   if (args.includes('--help') || args.includes('-h')) {
     return commands.help();
   }
-  
+
   if (args.includes('--version') || args.includes('-v')) {
-    const pkg = require('../package.json');
-    console.log(pkg.version);
+    // Show version and check for updates
+    await commands.update();
     return;
   }
 
@@ -879,4 +972,4 @@ async function run(args) {
   }
 }
 
-module.exports = { run, commands, loadConfig, detectCli, requireCli, agentTemplates, getTaskStats, refreshContext, getCurrentTask };
+module.exports = { run, commands, loadConfig, detectCli, requireCli, agentTemplates, getTaskStats, refreshContext, getCurrentTask, checkForUpdates, compareVersions };