kushi-agents 5.9.2 → 5.9.4

package/bin/cli.mjs

@@ -5,20 +5,30 @@ import { runMultiHost } from '../src/multi-host.mjs';
 
 const args = process.argv.slice(2);
 
-// ── bare invocation (v5.4.0+) ────────────────────────────────────────────────
-// v5.4.1: on an interactive TTY, auto-launch the setup wizard (matches the
-// ergonomics of `npx create-*`). Non-TTY (CI, scripts, piped stdin) and the
-// explicit KUSHI_SKIP_WELCOME=1 still print the welcome card and exit 0, so
-// nothing is installed by side-effect.
+// ── bare invocation ──────────────────────────────────────────────────────────
+// Two bins share this cli (via thin wrappers in bin/kushi.mjs and
+// bin/kushi-agents.mjs that set KUSHI_BIN_NAME). Behavior diverges on no-args:
+//   - `kushi-agents` (no args) on a TTY  → setup wizard (first-install ergonomics)
+//   - `kushi`        (no args) on a TTY  → Docker-style help (post-install verb)
+//   - Either, non-TTY                    → welcome card (no side effects)
+// Override env vars: KUSHI_FORCE_WIZARD=1 forces wizard; KUSHI_SKIP_WELCOME=1
+// forces the welcome card.
 if (args.length === 0) {
+  const isInstallerBin = process.env.KUSHI_BIN_NAME === 'kushi-agents';
   const forceWelcome = process.env.KUSHI_SKIP_WELCOME === '1';
   const forceWizard  = process.env.KUSHI_FORCE_WIZARD === '1';
-  const interactive  = forceWizard || (process.stdin.isTTY && !forceWelcome);
-  if (interactive) {
+  const tty          = process.stdin.isTTY && !forceWelcome;
+
+  if (forceWizard || (tty && isInstallerBin)) {
     const { runSetupWizard } = await import('../src/setup-wizard.mjs');
     await runSetupWizard({ args: [] });
     process.exit(0);
   }
+  if (tty) {
+    // Bare `kushi` on a TTY — Docker-style help (no side effects).
+    await printHelp();
+    process.exit(0);
+  }
   await printWelcome();
   process.exit(0);
 }
@@ -347,6 +357,36 @@ if (args.length > 0 && args[0] === 'upgrade') {
   }
 }
 
+// ── chat-verb guard (v5.9.4+) ───────────────────────────────────────────────
+// These verbs are dispatched by Copilot Chat (`@Kushi <verb>`), not the CLI.
+// If a user types e.g. `kushi ask HCA "..."` in PowerShell, fall through to
+// installer used to silently run. Now we print a friendly redirect.
+const CHAT_ONLY_VERBS = new Set([
+  'ask', 'bootstrap', 'refresh', 'status', 'consolidate', 'tour', 'dashboard',
+  'aggregate', 'fde-intake', 'fde-report', 'fde-triage', 'link-entities',
+  'migrate-files', 'pull', 'schema-evolve', 'teach', 'vertex-link',
+  'emit-vertex',
+]);
+if (args.length > 0 && CHAT_ONLY_VERBS.has(args[0])) {
+  const verb = args[0];
+  const rest = args.slice(1).map(a => a.includes(' ') ? `"${a}"` : a).join(' ');
+  console.log(`
+  '${verb}' is a chat verb — run it from Copilot Chat, not PowerShell.
+
+  In VS Code Copilot Chat:
+      @Kushi ${verb}${rest ? ' ' + rest : ' <project> [args]'}
+
+  In Clawpilot:
+      kushi ${verb}${rest ? ' ' + rest : ' <project> [args]'}
+
+  CLI verbs (run from PowerShell): kushi help, kushi wiki, kushi doctor,
+                                   kushi upgrade, kushi uninstall, kushi setup,
+                                   kushi state, kushi promote, kushi global, kushi lint
+  See:  kushi help
+`);
+  process.exit(2);
+}
+
 // ── multi-host mode (v5.0.2+) ───────────────────────────────────────────────
 // Trigger when the user passes any of: --vscode, --all-hosts, --uninstall.
 // --clawpilot ALONE continues to route through the legacy main.mjs path so

package/bin/kushi-agents.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// Installer entry point — `npx kushi-agents` lands here. Bare invocation on a
+// TTY launches the setup wizard for first-install ergonomics.
+process.env.KUSHI_BIN_NAME = 'kushi-agents';
+await import('./cli.mjs');

package/bin/kushi.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+// Post-install user verb. Bare `kushi` → grouped help. Unknown verbs → friendly redirect.
+process.env.KUSHI_BIN_NAME = 'kushi';
+await import('./cli.mjs');

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "kushi-agents",
-  "version": "5.9.2",
+  "version": "5.9.4",
   "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": {
-    "kushi": "./bin/cli.mjs",
-    "kushi-agents": "./bin/cli.mjs"
+    "kushi": "./bin/kushi.mjs",
+    "kushi-agents": "./bin/kushi-agents.mjs"
   },
   "files": [
     "bin/",