squadrant 0.26.0 → 0.26.1

package/dist/index.js

@@ -10216,8 +10216,12 @@ var init_paths = __esm({
 
 // packages/core/dist/knowledge/store.js
 import fs15 from "fs";
+import os7 from "os";
 import path15 from "path";
 import matter2 from "gray-matter";
+function duplicateIdProblem(id, ignored, used) {
+  return `duplicate id ${id}: ${ignored} is ignored, ${used} is used (live files win over _proposed, then path order). Fix: rename the id in one file, or delete or move one of them.`;
+}
 function splitStatement(body) {
   const first = body.trim().split(/\n\s*\n/)[0] ?? "";
   return first.replace(/\s+/g, " ").trim();
@@ -10262,7 +10266,7 @@ function loadRulesDir(dir, layer, opts = {}) {
     const fm = parsed.data;
     const prior = seen.get(fm.id);
     if (prior) {
-      errors.push({ file, problems: [`duplicate id ${fm.id} (also in ${prior})`] });
+      errors.push({ file, problems: [duplicateIdProblem(fm.id, file, prior)] });
       continue;
     }
     seen.set(fm.id, file);
@@ -10270,7 +10274,65 @@ function loadRulesDir(dir, layer, opts = {}) {
   }
   return { rules, errors };
 }
-var NO_JS_FRONTMATTER;
+function resolveSourceRef(ref, kbRoot, sources) {
+  const bases = /* @__PURE__ */ new Set([kbRoot]);
+  for (const s of sources) {
+    let d = path15.resolve(kbRoot, expandHome(s.path.split(/[*?[{]/)[0]));
+    for (let i = 0; i < 6 && d !== path15.dirname(d); i++) {
+      d = path15.dirname(d);
+      bases.add(d);
+    }
+  }
+  const cands = [path15.resolve(kbRoot, expandHome(ref)), ...[...bases].map((b) => path15.join(b, ref))];
+  return cands.find((c) => fs15.existsSync(c) && fs15.statSync(c).isFile());
+}
+function validateKb(opts) {
+  const { rules, errors } = loadRulesDir(opts.rulesDir, "kb", { includeProposed: true });
+  const checks = [];
+  const dups = errors.filter((e) => e.problems.some((p) => p.startsWith("duplicate id")));
+  const invalid = errors.filter((e) => !dups.includes(e));
+  const proposed = rules.filter((r) => path15.relative(opts.rulesDir, r.file).split(path15.sep).includes(PROPOSED_DIR)).length;
+  checks.push({ level: "ok", message: `${rules.length + errors.length} rule files read (${rules.length - proposed} live, ${proposed} proposed parsed OK)` });
+  if (invalid.length)
+    for (const e of invalid)
+      checks.push({ level: "fail", message: `invalid ${e.file}: ${e.problems.join("; ")}` });
+  else
+    checks.push({ level: "ok", message: "no invalid rule files" });
+  if (dups.length)
+    for (const e of dups)
+      checks.push({ level: "fail", message: e.problems.join("; ") });
+  else
+    checks.push({ level: "ok", message: "no duplicate ids" });
+  const cache = /* @__PURE__ */ new Map();
+  let verified = 0, unresolved = 0;
+  for (const r of rules) {
+    r.sources.forEach((src, i) => {
+      const file = resolveSourceRef(src.ref, opts.kbRoot, opts.sources);
+      if (!file) {
+        unresolved++;
+        return;
+      }
+      if (!cache.has(file))
+        cache.set(file, fs15.readFileSync(file, "utf8"));
+      if (cache.get(file).includes(src.quote))
+        verified++;
+      else
+        checks.push({ level: "fail", message: `quote not found in ${file}: ${r.id} sources[${i}] (${r.file})` });
+    });
+  }
+  if (!checks.some((c) => c.message.startsWith("quote not found")))
+    checks.push({ level: "ok", message: `${verified} source quotes found in their source files` });
+  if (unresolved)
+    checks.push({ level: "skip", message: `${unresolved} source refs not resolvable on this machine, quote not checked` });
+  if (opts.domains) {
+    for (const r of rules) {
+      if (!opts.domains.includes(r.domain))
+        checks.push({ level: "warn", message: `${r.id}: domain '${r.domain}' not in allowed domains [${opts.domains.join(", ")}] (${r.file})` });
+    }
+  }
+  return { checks, ok: !checks.some((c) => c.level === "fail") };
+}
+var NO_JS_FRONTMATTER, expandHome;
 var init_store2 = __esm({
   "packages/core/dist/knowledge/store.js"() {
     init_dist();
@@ -10280,6 +10342,7 @@ var init_store2 = __esm({
         throw new Error("only YAML front matter is allowed");
       } } }
     };
+    expandHome = (p) => p === "~" || p.startsWith("~/") ? path15.join(os7.homedir(), p.slice(1)) : p;
   }
 });
 
@@ -10368,7 +10431,7 @@ var init_index_file = __esm({
 
 // packages/core/dist/knowledge/search.js
 function searchRules(rules, query, opts = {}) {
-  const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+  const terms = [...new Set(query.toLowerCase().split(/\s+/).filter(Boolean))];
   if (terms.length === 0)
     return [];
   const statuses = opts.statuses ?? DEFAULT_SEARCH_STATUSES;
@@ -10380,30 +10443,45 @@ function searchRules(rules, query, opts = {}) {
     const expanded = lower(rule2.triggers?.expanded);
     const when = (rule2.triggers?.when ?? "").toLowerCase();
     const statement = rule2.statement.toLowerCase();
+    const rationale = rationaleOf(rule2);
     const id = rule2.id.toLowerCase();
     let score = 0;
+    let matched = 0;
+    let curated = false;
     for (const t of terms) {
+      let s = 0;
       if (id.includes(t))
-        score += 3;
+        s += 3;
+      if (keywords.includes(t) || expanded.includes(t))
+        curated = true;
       if (keywords.includes(t))
-        score += 3;
+        s += 3;
       if (expanded.includes(t))
-        score += 2;
+        s += 3;
       if (when.includes(t))
-        score += 2;
+        s += 2;
       if (statement.includes(t))
-        score += 1;
+        s += 2;
+      if (rationale.includes(t))
+        s += 1;
+      if (s > 0) {
+        matched++;
+        score += s;
+      }
     }
     if (score > 0)
-      hits.push({ rule: rule2, score });
+      hits.push({ rule: rule2, score, matched, curated });
   }
-  return hits.sort((a, b) => b.score - a.score || a.rule.id.localeCompare(b.rule.id));
+  const strong = terms.length >= 2 ? hits.filter((h) => h.matched >= 2 || h.curated) : hits;
+  const out = strong.length ? strong : hits;
+  return out.sort((a, b) => b.score - a.score || a.rule.id.localeCompare(b.rule.id));
 }
-var DEFAULT_SEARCH_STATUSES, lower;
+var DEFAULT_SEARCH_STATUSES, lower, rationaleOf;
 var init_search = __esm({
   "packages/core/dist/knowledge/search.js"() {
     DEFAULT_SEARCH_STATUSES = ["active", "stale"];
     lower = (xs) => (xs ?? []).map((x) => x.toLowerCase());
+    rationaleOf = (rule2) => rule2.body.slice(rule2.statement.length).toLowerCase();
   }
 });
 
@@ -13626,6 +13704,7 @@ __export(dist_exports2, {
   discoverCaptainSurface: () => discoverCaptainSurface,
   discoverLiveOpencodeServer: () => discoverLiveOpencodeServer,
   dispatchToSibling: () => dispatchToSibling,
+  duplicateIdProblem: () => duplicateIdProblem,
   encodeFrame: () => encodeFrame,
   encodeMsg: () => encodeMsg,
   ensureDaemon: () => ensureDaemon,
@@ -13813,6 +13892,7 @@ __export(dist_exports2, {
   topicName: () => topicName,
   tryAcquireDaemonLock: () => tryAcquireDaemonLock,
   usageFromJson: () => usageFromJson,
+  validateKb: () => validateKb,
   waitForCaptainDelivery: () => waitForCaptainDelivery,
   waitForWarmup: () => waitForWarmup,
   writeCaptainAddress: () => writeCaptainAddress,
@@ -14464,7 +14544,7 @@ var init_drivers = __esm({
 // packages/agents/dist/projection/cursor.js
 import { mkdir, readFile, writeFile } from "fs/promises";
 import path19 from "path";
-import os7 from "os";
+import os8 from "os";
 function renderMdc(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -14512,7 +14592,7 @@ function createCursorEmitter() {
       if (scope === "user") {
         return [
           {
-            path: path19.join(os7.homedir(), ".cursor/rules/squadrant-global.mdc"),
+            path: path19.join(os8.homedir(), ".cursor/rules/squadrant-global.mdc"),
             shared: false,
             format: "mdc"
           }
@@ -14591,7 +14671,7 @@ var init_marker = __esm({
 // packages/agents/dist/projection/codex.js
 import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import path20 from "path";
-import os8 from "os";
+import os9 from "os";
 function renderMarkdown(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -14615,7 +14695,7 @@ function createCodexEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path20.join(os8.homedir(), ".codex/AGENTS.md"),
+          path: path20.join(os9.homedir(), ".codex/AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -14663,7 +14743,7 @@ var init_codex2 = __esm({
 // packages/agents/dist/projection/gemini.js
 import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
 import path21 from "path";
-import os9 from "os";
+import os10 from "os";
 function renderMarkdown2(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -14687,7 +14767,7 @@ function createGeminiEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path21.join(os9.homedir(), ".gemini/GEMINI.md"),
+          path: path21.join(os10.homedir(), ".gemini/GEMINI.md"),
           shared: true,
           format: "markdown"
         }];
@@ -14735,7 +14815,7 @@ var init_gemini2 = __esm({
 // packages/agents/dist/projection/opencode.js
 import { mkdir as mkdir4, readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
 import path22 from "path";
-import os10 from "os";
+import os11 from "os";
 function renderMarkdown3(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -14759,7 +14839,7 @@ function createOpencodeEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path22.join(os10.homedir(), ".config", "opencode", "AGENTS.md"),
+          path: path22.join(os11.homedir(), ".config", "opencode", "AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -14806,10 +14886,10 @@ var init_opencode2 = __esm({
 
 // packages/agents/dist/projection/opencode-skills.js
 import fs21 from "fs";
-import os11 from "os";
+import os12 from "os";
 import path23 from "path";
 function defaultOpencodeSkillsRoot(env = process.env) {
-  const configHome = env.XDG_CONFIG_HOME || path23.join(os11.homedir(), ".config");
+  const configHome = env.XDG_CONFIG_HOME || path23.join(os12.homedir(), ".config");
   return path23.join(configHome, "opencode", "skills");
 }
 function parseSkillName(raw) {
@@ -14904,7 +14984,7 @@ var init_opencode_skills = __esm({
 // packages/agents/dist/projection/claude.js
 import { mkdir as mkdir5, readFile as readFile5, writeFile as writeFile5 } from "fs/promises";
 import path24 from "path";
-import os12 from "os";
+import os13 from "os";
 function renderMarkdown4(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -14928,7 +15008,7 @@ function createClaudeEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path24.join(os12.homedir(), ".claude/CLAUDE.md"),
+          path: path24.join(os13.homedir(), ".claude/CLAUDE.md"),
           shared: true,
           format: "markdown"
         }];
@@ -16883,13 +16963,13 @@ var init_receipt_listener = __esm({
 
 // packages/agents/dist/claude/api-key-approval.js
 import fs22 from "fs";
-import os13 from "os";
+import os14 from "os";
 import path25 from "path";
 function ensureClaudeApiKeyApproved(apiKey, opts = {}) {
   const suffix = apiKey.slice(-20);
   if (!suffix)
     return { changed: false, reason: "empty api key" };
-  const file = opts.claudeJsonPath ?? path25.join(os13.homedir(), ".claude.json");
+  const file = opts.claudeJsonPath ?? path25.join(os14.homedir(), ".claude.json");
   const log = opts.log ?? (() => {
   });
   if (!fs22.existsSync(file)) {
@@ -19483,6 +19563,20 @@ var init_runtime2 = __esm({
   }
 });
 
+// packages/cli/src/lib/suppress-sqlite-warning.ts
+function isSqliteExperimentalWarning(warning, type2) {
+  const name = typeof warning === "object" && warning !== null ? warning.name : typeof type2 === "string" ? type2 : void 0;
+  const message = typeof warning === "string" ? warning : warning?.message;
+  return name === "ExperimentalWarning" && typeof message === "string" && /SQLite is an experimental feature/i.test(message);
+}
+var original = process.emitWarning.bind(process);
+process.emitWarning = ((warning, ...rest) => {
+  const first = rest[0];
+  const type2 = typeof first === "string" ? first : first?.type;
+  if (isSqliteExperimentalWarning(warning, type2)) return;
+  original(warning, ...rest);
+});
+
 // packages/cli/src/index.ts
 init_dist();
 init_dist2();
@@ -19931,7 +20025,7 @@ init_dist();
 import { Command as Command2 } from "commander";
 import fs25 from "fs";
 import path28 from "path";
-import os14 from "os";
+import os15 from "os";
 import readline from "readline";
 import chalk4 from "chalk";
 
@@ -20238,7 +20332,7 @@ function warnIfNoAnthropic(preset, auth) {
 var initCommand = new Command2("init").description("Guided first-time setup: provider, hub vault, agents, plugins, projects (re-run-safe)").option("--hub <path>", "Hub vault path", "~/squadrant-hub").option("--preset <id>", "provider preset: a|b|c (non-interactive; d accepted as a deprecated alias for c)").action(async (opts) => {
   const hubPath = resolveHome(opts.hub);
   const pkgRoot = findPackageRoot();
-  const configDir = path28.join(os14.homedir(), ".config", "squadrant");
+  const configDir = path28.join(os15.homedir(), ".config", "squadrant");
   const isTTY = process.stdin.isTTY === true;
   console.log(chalk4.bold("\nSquadrant Init\n"));
   let explicitPreset;
@@ -20343,7 +20437,7 @@ var initCommand = new Command2("init").description("Guided first-time setup: pro
   ensureRuntimeSynced({ sourceRoot: pkgRoot, runtimeRoot: configDir });
   console.log(chalk4.green(`    \u2714 Runtime assets synced to ${configDir}`));
   stepHeader(2, 5, "Agent + projection setup");
-  const settingsPath = path28.join(os14.homedir(), ".claude", "settings.json");
+  const settingsPath = path28.join(os15.homedir(), ".claude", "settings.json");
   try {
     let settings = {};
     if (fs25.existsSync(settingsPath)) {
@@ -20649,9 +20743,9 @@ init_dist();
 import { Command as Command5 } from "commander";
 import { execSync as execSync9 } from "child_process";
 import path30 from "path";
-import os15 from "os";
+import os16 from "os";
 import chalk7 from "chalk";
-var TEMPLATES_DIR2 = path30.join(os15.homedir(), ".config", "squadrant", "templates");
+var TEMPLATES_DIR2 = path30.join(os16.homedir(), ".config", "squadrant", "templates");
 var TASK_PROMPTS = {
   briefing: "Run your daily briefing using the squadrant:command-ops skill. Read all spoke handoffs, yesterday's logs, current status; produce a concise cross-project briefing; save to {hubVault}/daily-logs/YYYY-MM-DD.md; then exit.",
   "learnings-review": "Run a learnings review using the squadrant:command-ops skill. Scan {spokeVault}/learnings across all projects, identify cross-project patterns, propose captured-skill or fix actions, and exit when done.",
@@ -21982,9 +22076,9 @@ init_dist2();
 import { Command as Command12 } from "commander";
 import fs27 from "fs";
 import path31 from "path";
-import os16 from "os";
+import os17 from "os";
 import chalk12 from "chalk";
-var TEMPLATES_DIR3 = path31.join(os16.homedir(), ".config", "squadrant", "templates");
+var TEMPLATES_DIR3 = path31.join(os17.homedir(), ".config", "squadrant", "templates");
 async function runSideSpawn2(input) {
   const config = loadConfig();
   const proj = config.projects[input.project];
@@ -23631,7 +23725,7 @@ import { Command as Command14 } from "commander";
 import { execSync as execSync11, execFileSync as execFileSync11 } from "child_process";
 import fs29 from "fs";
 import path33 from "path";
-import os17 from "os";
+import os18 from "os";
 import chalk15 from "chalk";
 
 // packages/cli/src/commands/launch-interactive.ts
@@ -23723,8 +23817,8 @@ function resolveLaunchBackend(o) {
 // packages/cli/src/commands/launch.ts
 init_dist2();
 var CMUX_APP = "/Applications/cmux.app";
-var TEMPLATES_DIR4 = path33.join(os17.homedir(), ".config", "squadrant", "templates");
-var SESSIONS_PATH2 = path33.join(os17.homedir(), ".config", "squadrant", "sessions.json");
+var TEMPLATES_DIR4 = path33.join(os18.homedir(), ".config", "squadrant", "templates");
+var SESSIONS_PATH2 = path33.join(os18.homedir(), ".config", "squadrant", "sessions.json");
 function shouldWireCaptainChannel(agentName, config) {
   return agentName === "claude" && resolveCaptainChannelMode(config.defaults) !== "off";
 }
@@ -23821,7 +23915,7 @@ var launchCommand = new Command14("launch").description(
       initialPrompt = "Run your startup checklist: use the squadrant:command-ops skill, complete your daily briefing, then report ready.";
     }
     const runtime = projectName ? runtimes.forProject(projectName, config) : runtimes.global(config);
-    const stateRoot = path33.join(os17.homedir(), ".config", "squadrant", "state");
+    const stateRoot = path33.join(os18.homedir(), ".config", "squadrant", "state");
     const isOpencodeCaptain = role === "captain" && agentName === "opencode" && !!projectName;
     if (isOpencodeCaptain && !isOpencodeCaptainDir(cwd)) {
       console.error(chalk15.red(`
@@ -24178,7 +24272,7 @@ Shutting down captain workspace for '${project}'...
 init_dist();
 import { Command as Command16 } from "commander";
 import fs30 from "fs";
-import os18 from "os";
+import os19 from "os";
 import path34 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { execSync as execSync12 } from "child_process";
@@ -24232,7 +24326,7 @@ function buildIssueUrl(metrics, squadrantVersion) {
 }
 var feedbackCommand = new Command16("feedback").description("Open a pre-filled GitHub issue for feedback or bug reports").action(() => {
   const config = loadConfig();
-  const metricsPath = config.metrics?.path || path34.join(os18.homedir(), ".config", "squadrant", "metrics.json");
+  const metricsPath = config.metrics?.path || path34.join(os19.homedir(), ".config", "squadrant", "metrics.json");
   const metrics = readMetrics(metricsPath);
   const version = readStamp(config) ?? readPkgVersion();
   const issueUrl = buildIssueUrl(metrics, version);
@@ -25638,11 +25732,11 @@ var effortCommand = new Command29("effort").description("Get or set the crew tok
 init_dist();
 import fs35 from "fs";
 import path37 from "path";
-import os19 from "os";
+import os20 from "os";
 import readline3 from "readline";
 import { Command as Command30 } from "commander";
 import chalk31 from "chalk";
-var CLAUDE_PROJECTS_DIR = path37.join(os19.homedir(), ".claude", "projects");
+var CLAUDE_PROJECTS_DIR = path37.join(os20.homedir(), ".claude", "projects");
 function parseTranscriptLine(rawLine) {
   const line = rawLine.trim();
   if (!line) return { timestamp: null, usage: null };
@@ -26846,7 +26940,7 @@ var workCommand = new Command34("work").description("Track your own in-flight wo
 init_dist();
 import { Command as Command35 } from "commander";
 import path42 from "path";
-import os20 from "os";
+import os21 from "os";
 
 // packages/cli/src/lib/handoff-live-repo.ts
 init_dist();
@@ -27258,7 +27352,7 @@ function readNewestArchivedHandoff(spokeVault, now) {
 }
 
 // packages/cli/src/commands/handoff.ts
-var CLAUDE_MEM_DB_PATH = path42.join(os20.homedir(), ".claude-mem", "claude-mem.db");
+var CLAUDE_MEM_DB_PATH = path42.join(os21.homedir(), ".claude-mem", "claude-mem.db");
 async function defaultFetchTasks(project) {
   return await squadrantdCall({ kind: "list", project });
 }
@@ -27418,7 +27512,7 @@ var sessionsCommand = new Command36("sessions").description("List live agent ses
 init_dist();
 init_dist2();
 init_dist3();
-import os21 from "os";
+import os22 from "os";
 import path43 from "path";
 import { Command as Command37 } from "commander";
 import chalk36 from "chalk";
@@ -27537,7 +27631,7 @@ function buildWhoamiDeps(opts = {}) {
   const projects = Object.fromEntries(
     Object.entries(config.projects).map(([n, p]) => [n, resolveHome(p.path)])
   );
-  const root = stateRoot ?? path43.join(os21.homedir(), ".config", "squadrant", "state");
+  const root = stateRoot ?? path43.join(os22.homedir(), ".config", "squadrant", "state");
   const store = createStore(root);
   const merged = {
     env: process.env,
@@ -27668,13 +27762,33 @@ function runKnowledgeReindex(kb, configPath = DEFAULT_CONFIG_PATH) {
   const cfg = loadConfig(configPath);
   const hub = resolveHome(cfg.hubVault);
   if (!fs41.existsSync(kbDir(hub, kb))) throw new Error(`Knowledge base '${kb}' does not exist. Run: squadrant knowledge init ${kb}`);
-  const { rules, errors } = loadKbRules(cfg, kb);
-  const file = writeIndex(hub, kb, compileIndex(kb, rules));
-  return { file, count: rules.length, errors: errors.length };
+  const { rules: all, errors } = loadKbRules(cfg, kb, { includeProposed: true });
+  const proposedRoot = path44.join(kbRulesDir(hub, kb), PROPOSED_DIR) + path44.sep;
+  const live = all.filter((r) => !r.file.startsWith(proposedRoot));
+  const file = writeIndex(hub, kb, compileIndex(kb, live));
+  return { file, count: live.length, proposed: all.length - live.length, errors: errors.length, invalid: errors };
+}
+function runKnowledgeValidate(kb, configPath = DEFAULT_CONFIG_PATH) {
+  assertKbName(kb);
+  const cfg = loadConfig(configPath);
+  const hub = resolveHome(cfg.hubVault);
+  if (!fs41.existsSync(kbDir(hub, kb))) throw new Error(`Knowledge base '${kb}' does not exist. Run: squadrant knowledge init ${kb}`);
+  const { sources, errors } = loadSources(hub, kb);
+  const res = validateKb({ rulesDir: kbRulesDir(hub, kb), kbRoot: kbDir(hub, kb), sources, domains: cfg.knowledge?.[kb]?.domains });
+  const srcChecks = errors.map((e) => ({ level: "fail", message: `sources.yaml: ${e}` }));
+  return { checks: [...srcChecks, ...res.checks], ok: res.ok && !errors.length };
 }
 knowledgeCommand.command("reindex <kb>").description("Recompile index.json from the KB's rule files").action((kb) => {
   const r = runKnowledgeReindex(kb);
-  console.log(`${r.file}: ${r.count} rules${r.errors ? chalk37.red(`, ${r.errors} invalid files skipped`) : ""}`);
+  console.log(`${r.file}: ${r.count} active${r.proposed ? ` (+${r.proposed} proposed)` : ""}${r.errors ? chalk37.red(`, ${r.errors} invalid files skipped`) : ""}`);
+  for (const e of r.invalid) console.log(chalk37.red(`  \u2718 ${e.file}: ${e.problems.join("; ")}`));
+});
+knowledgeCommand.command("validate <kb>").description("CI-style check: invalid files, duplicate ids, quotes present in sources; exits non-zero on failure").action((kb) => {
+  const { checks, ok: ok2 } = runKnowledgeValidate(kb);
+  const mark2 = { ok: chalk37.green("\u2714"), fail: chalk37.red("\u2718"), warn: chalk37.yellow("!"), skip: chalk37.dim("-") };
+  for (const c of checks) console.log(`${mark2[c.level]} ${c.message}`);
+  console.log(ok2 ? chalk37.green("valid") : chalk37.red("invalid"));
+  if (!ok2) process.exitCode = 1;
 });
 
 // packages/cli/src/commands/rules.ts
@@ -27682,6 +27796,7 @@ init_dist();
 init_dist2();
 import { Command as Command39 } from "commander";
 import chalk38 from "chalk";
+var DEFAULT_SEARCH_LIMIT = 5;
 function resolveRulesProject(cfg, opts) {
   const env = opts.env ?? process.env;
   const name = opts.project ?? env.SQUADRANT_CREW_PROJECT ?? detectCurrentProject(cfg, opts.cwd ?? process.cwd());
@@ -27697,6 +27812,32 @@ function formatRule(rule2) {
     `  source: ${src}`
   ].join("\n");
 }
+function formatBrief(rule2) {
+  return `${rule2.modality.toUpperCase()} ${rule2.id}: ${rule2.statement}`;
+}
+function parseLimit(raw) {
+  if (raw === void 0) return DEFAULT_SEARCH_LIMIT;
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n < 1) throw new Error(`--limit must be a positive integer, got '${raw}'`);
+  return n;
+}
+function renderSearch(hits, opts) {
+  if (!hits.length) return ["(no matching rules)"];
+  const limit = parseLimit(opts.limit);
+  const shown = hits.slice(0, limit);
+  const lines = shown.map((h) => opts.idsOnly ? h.rule.id : opts.brief ? `[${h.score}] ${formatBrief(h.rule)}` : `${formatRule(h.rule)}
+  score: ${h.score}
+`);
+  const more = hits.length - shown.length;
+  if (more > 0) lines.push(`(+${more} more; use --limit)`);
+  return lines;
+}
+function renderList2(rules, opts) {
+  if (!rules.length) return ["(no rules)"];
+  const sorted = [...rules].sort((a, b) => a.id.localeCompare(b.id));
+  return sorted.map((r) => opts.brief ? formatBrief(r) : `${formatBrief(r)}
+  ${r.status} \xB7 ${r.layer}`);
+}
 function loadFor(opts, configPath) {
   const cfg = loadConfig(configPath);
   const project = resolveRulesProject(cfg, opts);
@@ -27709,6 +27850,10 @@ function runRulesSearch(query, opts, configPath = DEFAULT_CONFIG_PATH) {
   const rules = loadFor(opts, configPath);
   return searchRules(rules, query, { statuses: opts.all ? [...RULE_STATUSES] : DEFAULT_SEARCH_STATUSES });
 }
+function runRulesList(opts, configPath = DEFAULT_CONFIG_PATH) {
+  const statuses = opts.all ? RULE_STATUSES : DEFAULT_SEARCH_STATUSES;
+  return loadFor(opts, configPath).filter((r) => statuses.includes(r.status));
+}
 function runRulesShow(id, opts, configPath = DEFAULT_CONFIG_PATH) {
   const rules = loadFor(opts, configPath);
   const statuses = opts.all ? RULE_STATUSES : DEFAULT_SEARCH_STATUSES;
@@ -27717,13 +27862,12 @@ function runRulesShow(id, opts, configPath = DEFAULT_CONFIG_PATH) {
   return rule2;
 }
 var rulesCommand = new Command39("rules").description("Look up rules from subscribed knowledge bases (#893)");
-rulesCommand.command("search <query...>").description("Search rules by keyword").option("--project <name>", "project (default: from cwd or SQUADRANT_CREW_PROJECT)").option("--all", "include proposed and retired rules").action((query, opts) => {
+rulesCommand.command("search <query...>").description("Search rules by keyword (ranked; best match first)").option("--project <name>", "project (default: from cwd or SQUADRANT_CREW_PROJECT)").option("--all", "include proposed and retired rules").option("--limit <n>", `max results (default ${DEFAULT_SEARCH_LIMIT})`).option("--brief", "one line per rule: [score] MODALITY id: statement").option("--ids-only", "print only rule ids").action((query, opts) => {
   const hits = runRulesSearch(query.join(" "), opts);
-  if (!hits.length) {
-    console.log("(no matching rules)");
-    return;
-  }
-  for (const h of hits) console.log(formatRule(h.rule) + "\n");
+  for (const line of renderSearch(hits, opts)) console.log(line);
+});
+rulesCommand.command("list").description("List every resolved rule for the project").option("--project <name>", "project (default: from cwd or SQUADRANT_CREW_PROJECT)").option("--all", "include proposed and retired rules").option("--brief", "one line per rule: MODALITY id: statement").action((opts) => {
+  for (const line of renderList2(runRulesList(opts), opts)) console.log(line);
 });
 rulesCommand.command("show <ids...>").description("Show one or more rules in full").option("--project <name>", "project (default: from cwd or SQUADRANT_CREW_PROJECT)").option("--all", "include proposed and retired rules").action((ids, opts) => {
   for (const id of ids) {