kushi-agents 5.2.0 → 5.4.0

package/README.md

@@ -154,6 +154,30 @@ Rules stored in `Evidence/<alias>/State/CLAUDE.md`. Read by `build-state`, `ask-
 
 ---
 
+## Global wiki (v5.3.0+)
+
+A per-user **global wiki** at `~/.kushi-global/State/` for cross-engagement knowledge — same Karpathy shape as a project `State/`, marked `scope: global`.
+
+```bash
+kushi global init                     # scaffold ~/.kushi-global/State/
+kushi global status                   # counts + last-modified summary
+kushi global ask "what's our confidence ladder pattern?"
+kushi global lint                     # privacy + structure pass
+
+# Project → global is explicit-only:
+kushi promote <project> <answer-page>          # refuses if identifiers detected
+kushi promote <project> <answer-page> --force  # redacts + writes target + back-link
+
+# Routing under ask-project:
+kushi ask <project> "..."                     # project-first (default)
+kushi ask <project> "..." --global            # global-first
+kushi ask <project> "..." --project-only      # suppress global
+```
+
+The global root honors `$KUSHI_GLOBAL_ROOT` (used by tests). There is no auto-promotion path — privacy is always your call. See `plugin/instructions/global-wiki.instructions.md` + `plugin/instructions/multi-wiki-routing.instructions.md`.
+
+---
+
 ## Three install profiles
 
 Kushi ships in three tiers. Pick how much you take — the default (`standard`) matches v2.x behavior end-to-end.

package/bin/cli.mjs

@@ -5,6 +5,63 @@ import { runMultiHost } from '../src/multi-host.mjs';
 
 const args = process.argv.slice(2);
 
+// ── bare invocation (v5.4.0+) → welcome screen ──────────────────────────────
+if (args.length === 0 && !process.env.KUSHI_SKIP_WELCOME) {
+  await printWelcome();
+  process.exit(0);
+}
+
+// ── doctor verb (v5.4.0+) ───────────────────────────────────────────────────
+if (args.length > 0 && args[0] === 'doctor') {
+  const { spawnSync } = await import('node:child_process');
+  const pathMod = await import('node:path');
+  const urlMod = await import('node:url');
+  const here = pathMod.dirname(urlMod.fileURLToPath(import.meta.url));
+  const script = pathMod.resolve(here, '..', 'plugin', 'skills', 'doctor', 'doctor.ps1');
+  const psArgs = ['-NoProfile', '-File', script];
+  if (args.includes('--json')) psArgs.push('-Json');
+  if (args.includes('--strict')) psArgs.push('-Strict');
+  const r = spawnSync('pwsh', psArgs, { stdio: 'inherit' });
+  process.exit(r.status ?? 1);
+}
+
+// ── setup-wizard flag (v5.4.0+) ─────────────────────────────────────────────
+if (args.includes('--setup-wizard')) {
+  const { runSetupWizard } = await import('../src/setup-wizard.mjs');
+  await runSetupWizard({ args });
+  process.exit(0);
+}
+
+async function printWelcome() {
+  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 {}
+  let skillCount = 0;
+  try {
+    const skillsDir = pathMod.join(repoRoot, 'plugin', 'skills');
+    skillCount = fsMod.readdirSync(skillsDir, { withFileTypes: true })
+      .filter((d) => d.isDirectory() && !d.name.startsWith('_'))
+      .length;
+  } catch {}
+  console.log(`
+  kushi v${version} — multi-source M365 project evidence agent
+
+  First time?         kushi doctor
+  Bootstrap a project: kushi setup <project>
+  Ask a question:      kushi ask <project> "..."
+  Wizard install:      npx kushi-agents --setup-wizard
+
+  Docs:   https://gim-home.github.io/kushi/
+  Skills: ${skillCount} installed in plugin/skills/
+
+  Run  kushi --help  for the full verb list.
+`);
+}
+
 // ── skill-authoring verbs (v5.0.4+) ─────────────────────────────────────────
 // Dispatch directly to the skill-creator / skill-checker pwsh scripts.
 const SKILL_VERBS = new Set(['create-skill', 'check-skill', 'optimize-description', 'review-evals']);
@@ -17,15 +74,55 @@ if (args.length > 0 && SKILL_VERBS.has(args[0])) {
 
 // ── lint verb (v5.1.0+) ──────────────────────────────────────────────────────
 if (args.length > 0 && args[0] === 'lint') {
+  if (args.includes('--global')) {
+    const { runGlobalLint } = await import('../src/global-wiki-cli.mjs');
+    await runGlobalLint();
+    process.exit(0);
+  }
   const project = args[1] || '';
   if (!project) {
-    console.error('\n  Usage: kushi lint <project>\n');
+    console.error('\n  Usage: kushi lint <project>\n         kushi lint --global\n');
     process.exit(1);
   }
   await dispatchLint(project);
   process.exit(0);
 }
 
+// ── global verb (v5.3.0+) ────────────────────────────────────────────────────
+if (args.length > 0 && args[0] === 'global') {
+  const sub = args[1] || '';
+  const validSubs = ['init', 'status', 'ask', 'lint'];
+  if (!validSubs.includes(sub)) {
+    console.error('\n  Usage: kushi global init           Scaffold ~/.kushi-global/State/');
+    console.error('         kushi global status         Show counts + freshness');
+    console.error('         kushi global ask <question> Ask the global wiki');
+    console.error('         kushi global lint           Lint the global wiki\n');
+    process.exit(1);
+  }
+  const { runGlobalInit, runGlobalStatus, runGlobalAsk, runGlobalLint } = await import('../src/global-wiki-cli.mjs');
+  if (sub === 'init') await runGlobalInit();
+  else if (sub === 'status') await runGlobalStatus();
+  else if (sub === 'ask') await runGlobalAsk(args.slice(2).join(' '));
+  else if (sub === 'lint') await runGlobalLint();
+  process.exit(0);
+}
+
+// ── promote verb (v5.3.0+) ───────────────────────────────────────────────────
+if (args.length > 0 && args[0] === 'promote') {
+  const project = args[1] || '';
+  const page = args[2] || '';
+  if (!project || !page) {
+    console.error('\n  Usage: kushi promote <project> <page-path>\n');
+    console.error('  Copies a project State page into the global wiki with provenance metadata.');
+    console.error('  Refuses by default if customer identifiers are detected; pass --force after review.\n');
+    process.exit(1);
+  }
+  const force = args.includes('--force');
+  const { runPromote } = await import('../src/global-wiki-cli.mjs');
+  await runPromote(project, page, { force });
+  process.exit(0);
+}
+
 // ── hooks verb (v5.2.0+) ─────────────────────────────────────────────────────
 if (args.length > 0 && args[0] === 'hooks') {
   const sub = args[1] || '';
@@ -108,6 +205,7 @@ if (args.includes('--help') || args.includes('-h')) {
 
   Wiki maintenance (v5.1.0+):
     lint <project>       Run wiki-lint checks on State/ (contradictions, stale claims, orphans).
+    lint --global        Lint the global wiki at ~/.kushi-global/State/.
 
   Hooks & observability (v5.2.0+):
     hooks list <project>           List configured hooks for a project.
@@ -115,6 +213,19 @@ if (args.includes('--help') || args.includes('-h')) {
     explain <topic>                Explain a kushi concept (pedagogical, read-only).
     remember <rule>                Persist a project convention to CLAUDE.md.
 
+  Global wiki (v5.3.0+):
+    global init                    Scaffold ~/.kushi-global/State/ (env: KUSHI_GLOBAL_ROOT)
+    global status                  Show page counts + freshness for the global wiki.
+    global ask <question>          Search the global wiki specifically.
+    global lint                    Lint the global wiki (alias for 'lint --global').
+    promote <project> <page>       Move a project State page into global with redaction + back-link.
+                                   Refuses if customer identifiers are detected; --force after review.
+
+  Stabilization (v5.4.0+):
+    doctor                         Aggregated health check (env, self-check, evals, skill-checker, drift, global).
+                                   --json for CI; --strict to fail on yellow.
+    --setup-wizard                 Interactive first-run flow (engagement root, hosts, global wiki).
+
   After install, talk to Kushi:
     bootstrap <project>     First-time setup
     refresh <project>       Incremental refresh + rebuild State/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kushi-agents",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "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": {
@@ -41,7 +41,7 @@
   },
   "license": "MIT",
   "scripts": {
-    "test": "node --test src/check-workiq.test.mjs src/seed-config.test.mjs src/sanitize-workiq-input.test.mjs src/detect-vertex-repo.test.mjs src/vertex-validate.test.mjs src/emit-vertex.e2e.test.mjs src/config-root-resolve.test.mjs src/forbidden-workiq-phrasings.test.mjs src/multi-host-install.test.mjs src/eval-aggregator.test.mjs src/eval-runner.test.mjs src/skill-creator.test.mjs src/skill-checker.test.mjs src/hooks-dispatcher.test.mjs src/parallel-refresh.test.mjs src/otel-emit.test.mjs src/teach.test.mjs src/schema-evolve.test.mjs",
+    "test": "node --test src/check-workiq.test.mjs src/seed-config.test.mjs src/sanitize-workiq-input.test.mjs src/detect-vertex-repo.test.mjs src/vertex-validate.test.mjs src/emit-vertex.e2e.test.mjs src/config-root-resolve.test.mjs src/forbidden-workiq-phrasings.test.mjs src/multi-host-install.test.mjs src/eval-aggregator.test.mjs src/eval-runner.test.mjs src/skill-creator.test.mjs src/skill-checker.test.mjs src/hooks-dispatcher.test.mjs src/parallel-refresh.test.mjs src/otel-emit.test.mjs src/teach.test.mjs src/schema-evolve.test.mjs src/global-wiki.test.mjs src/promote.test.mjs src/doctor.test.mjs src/setup-wizard.test.mjs src/cli-no-args.test.mjs",
     "test:integration:bootstrap": "node src/bootstrap-dryrun.integration.test.mjs",
     "smoke": "node scripts/smoke.mjs",
     "eval": "pwsh plugin/skills/eval/run-evals.ps1 -Skill",