kushi-agents 5.9.4 → 5.9.5

package/bin/cli.mjs

@@ -33,6 +33,22 @@ if (args.length === 0) {
   process.exit(0);
 }
 
+// ── version flag (v5.9.5+) ──────────────────────────────────────────────────
+// `kushi --version` / `-v` / `version` → print version and exit. Previously
+// these fell through to the installer's main() which printed the banner and
+// started the install flow.
+if (args.length > 0 && (args[0] === '--version' || args[0] === '-v' || args[0] === 'version')) {
+  const pathMod = await import('node:path');
+  const urlMod = await import('node:url');
+  const fsMod = await import('node:fs');
+  const here = pathMod.dirname(urlMod.fileURLToPath(import.meta.url));
+  const repoRoot = pathMod.resolve(here, '..');
+  let version = 'unknown';
+  try { version = JSON.parse(fsMod.readFileSync(pathMod.join(repoRoot, 'package.json'), 'utf-8')).version; } catch {}
+  console.log(version);
+  process.exit(0);
+}
+
 // ── doctor verb (v5.4.0+) ───────────────────────────────────────────────────
 if (args.length > 0 && args[0] === 'doctor') {
   const { spawnSync } = await import('node:child_process');
@@ -276,6 +292,7 @@ Install (run via npx — first-time / host install):
   WorkIQ:    --with-workiq | --workiq-path <abs> | --skip-workiq-check
 
 Run 'kushi <command> --help' for more information on a command (where supported).
+Run 'kushi --version' to print the installed version.
 Docs: https://gim-home.github.io/kushi/
 
 In VS Code Chat the prefix is "@Kushi". In Clawpilot just say "kushi <verb>".
@@ -338,12 +355,43 @@ if (args.length > 0 && args[0] === 'uninstall' && !args.includes('--clawpilot')
 
 if (args.length > 0 && args[0] === 'upgrade') {
   // Upgrade: npm i -g @latest, then re-seed assets in cwd preserving config.
+  // v5.9.5: capture stderr so users see WHY npm failed; detect Windows
+  // self-replacement (kushi.cmd locked because it's the running shell) and
+  // print a clear "rerun from a fresh shell" hint.
   const { spawnSync } = await import('node:child_process');
   console.log('\n  Upgrading kushi-agents globally via npm...\n');
   const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  const r1 = spawnSync(npm, ['install', '-g', 'kushi-agents@latest'], { stdio: 'inherit' });
+  const r1 = spawnSync(npm, ['install', '-g', 'kushi-agents@latest'], {
+    stdio: ['inherit', 'inherit', 'pipe'],
+    encoding: 'utf-8',
+  });
   if (r1.status !== 0) {
-    console.error('\n  npm install failed.\n');
+    const stderr = (r1.stderr || '').toString();
+    if (stderr) {
+      console.error(stderr);
+    }
+    const looksLikeSelfReplace = process.platform === 'win32' && (
+      /EPERM|EBUSY|operation not permitted|kushi\.cmd|kushi-agents\.cmd|in use/i.test(stderr)
+    );
+    if (looksLikeSelfReplace) {
+      console.error([
+        '',
+        '  npm could not overwrite the running kushi.cmd shim.',
+        '  This is a known Windows limitation when `kushi upgrade` is launched from kushi itself.',
+        '',
+        '  Fix: open a NEW PowerShell window and run:',
+        '',
+        '      npm i -g kushi-agents@latest',
+        '',
+        '  Then re-seed your workspace:',
+        '',
+        '      cd ' + process.cwd(),
+        '      npx kushi-agents@latest --force',
+        '',
+      ].join('\n'));
+    } else if (!stderr) {
+      console.error('\n  npm install failed (no stderr captured). Try:\n      npm i -g kushi-agents@latest --foreground-scripts --loglevel=verbose\n');
+    }
     process.exit(r1.status ?? 1);
   }
   console.log('\n  Refreshing assets in cwd (config preserved)...\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kushi-agents",
-  "version": "5.9.4",
+  "version": "5.9.5",
   "description": "Install Kushi — multi-source project evidence agent with Comprehensive Structured Capture (CSC) into weekly-only files across Email, Teams, OneNote, Loop, SharePoint, Meetings, CRM, ADO. Meetings retain a sibling verbatim/ audit folder. WorkIQ-only for M365 sources (Graph / m365_* FORBIDDEN as fallbacks; user-paste is first-class). Host-agnostic.",
   "type": "module",
   "bin": {