@bli-cockpit/cli 0.2.192 → 0.2.193

package/dist/commands/local-args-tower-search.js

@@ -15,40 +15,29 @@
  */
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, } from "./local-arg-values.js";
 /**
- * Every corpus. Kept here so an unknown kind is refused BEFORE a round trip,
- * and mirrors `SEARCH_KINDS` in the dashboard — nothing in the type system ties
- * the two lists together.
+ * What `--kind` names is the SERVER's to say (BLI-13027). This used to be a copy
+ * of the dashboard's kind list that refused anything it did not hold, so an
+ * installed CLI told a person that Scout did not exist the day Scout shipped.
+ * Now the CLI forwards the words, and the door answers `unknown_kind` with the
+ * list this account is offered. `cockpit search --categories` prints that list.
  */
-export const SEARCH_KINDS = [
-    "doc",
-    "msg",
-    "issue",
-    "note",
-    "mail",
-    "cal",
-    "memory",
-];
 export function parseSearchArgs(args) {
     const values = parseNamedArgs(args, {
-        allowedFlags: ["--home", "--dashboard-url", "--kind", "--limit", "--json"],
+        allowedFlags: ["--home", "--dashboard-url", "--kind", "--limit", "--json", "--categories"],
         valueFlags: ["--home", "--dashboard-url", "--kind", "--limit"],
     });
     const query = values.positionals.join(" ").trim();
-    if (query.length === 0) {
+    const categories = values.booleans.has("--categories");
+    if (query.length === 0 && !categories) {
         throw new Error('search needs something to search for, e.g. `cockpit search "storage ceiling"`.');
     }
     const kindFlag = optionalNonEmpty(values.flags.get("--kind"));
     let kinds;
     if (kindFlag) {
         kinds = [];
-        // BLI-12947: `ticket` is the new spelling of the `issue` kind (input only).
-        for (const raw of kindFlag.split(",").map((entry) => entry.trim()).filter(Boolean)) {
-            const part = raw === "ticket" ? "issue" : raw;
-            if (!SEARCH_KINDS.includes(part)) {
-                throw new Error(`search --kind must be one or more of ${SEARCH_KINDS.join(", ")} — not "${raw}".`);
-            }
-            if (!kinds.includes(part))
-                kinds.push(part);
+        for (const raw of kindFlag.split(",").map((entry) => entry.trim().toLowerCase()).filter(Boolean)) {
+            if (!kinds.includes(raw))
+                kinds.push(raw);
         }
         if (kinds.length === 0)
             kinds = undefined;
@@ -56,6 +45,7 @@ export function parseSearchArgs(args) {
     return {
         kind: "search",
         query,
+        ...(categories ? { categories: true } : {}),
         ...(kinds ? { kinds } : {}),
         limit: optionalPositiveInteger(values.flags.get("--limit"), "--limit"),
         homeDir: optionalNonEmpty(values.flags.get("--home")),

package/dist/commands/local-args-tower.js

@@ -33,7 +33,7 @@ export { SCOUT_MIN_PREFIX_LENGTH, parseScoutArgs, parseOpsArgs, SLACK_WORKSPACE_
 export { parseDocsArgs, parseMsgArgs, } from "./local-args-tower-docs-msg.js";
 export { ISSUE_STATES, parseIssueArgs, parseProjectArgs, } from "./local-args-tower-work.js";
 export { parseGithubArgs } from "./local-args-tower-github.js";
-export { SEARCH_KINDS, parseSearchArgs } from "./local-args-tower-search.js";
+export { parseSearchArgs } from "./local-args-tower-search.js";
 export { parseModelsArgs } from "./local-args-tower-models.js";
 export { parseMailArgs } from "./local-args-tower-mail.js";
 export { parseCalArgs } from "./local-args-tower-cal.js";

package/dist/commands/local-help-commands-tower.js

@@ -11,15 +11,6 @@
  * Every string moved verbatim. Help output is what an intern pastes back when
  * something breaks, so it is a user-visible contract like any other.
  */
-import { SEARCH_KINDS } from "./local-args-tower-search.js";
-/**
- * The corpora `cockpit search` can name, spelled the way `--kind` takes them.
- * Read off `SEARCH_KINDS` rather than typed out: the help string said five for
- * the two months `mail` and `cal` were searchable, so a person was told the
- * door was narrower than it is (BLI-4048).
- */
-const SEARCH_KIND_LIST = SEARCH_KINDS.join(",");
-const SEARCH_CORPORA_COUNT = SEARCH_KINDS.length;
 /** One entry per Tower noun, in the order `cockpit --help` lists them. */
 export const TOWER_COMMAND_HELP = [
     [
@@ -207,10 +198,11 @@ export const TOWER_COMMAND_HELP = [
     [
         "search",
         [
-            `Usage: cockpit search "<words>" [--kind ${SEARCH_KIND_LIST}] [--limit <n>] [--json]`,
+            'Usage: cockpit search "<words>" [--kind <category,...>] [--limit <n>] [--json]',
+            "       cockpit search --categories [--json]",
             "",
-            `One bar over ${SEARCH_CORPORA_COUNT} corpora: documents, messages, issues, meeting notes, mail, calendar`,
-            "events and memory.",
+            "One bar over every corpus Tower holds: tickets, documents, meeting notes, messages, mail,",
+            "calendar events, memory, Scout and (where you may read it) Careers.",
             "It presses the SAME door the browser's search bar presses (GET /api/search), so what you",
             "read here is the same row, the same ranking and the same snippet a person sees in Tower.",
             "",
@@ -219,14 +211,16 @@ export const TOWER_COMMAND_HELP = [
             "Quoted phrases and -word work inside the query itself — the query goes to Postgres's",
             "websearch parser, which shrugs at anything a person can type instead of raising.",
             "",
-            `--kind narrows to one or more corpora, comma separated: ${SEARCH_KIND_LIST}.`,
-            `Omit it and all ${SEARCH_CORPORA_COUNT} are searched.`,
+            "--kind narrows to one or more categories, comma separated (ticket works for issue).",
+            "--categories prints the list Tower offers THIS account, in the order the browser's Command-K",
+            "chips use, so the names are never a guess; an unknown --kind is refused by the door with that list.",
+            "Omit --kind and every category is searched.",
             "--limit caps the number of results (default 20, maximum 50).",
             "--json writes the door's whole answer to stdout, hits, per-kind counts, failures and all.",
             "",
-            `Every result is scoped by what YOU may read: ${SEARCH_CORPORA_COUNT - 1} of the ${SEARCH_CORPORA_COUNT} corpora are`,
-            "searched on your own database session, so a document or a channel you cannot open is not in",
-            "the list; memory runs on the service role behind the memory doors' own gate.",
+            "Every result is scoped by what YOU may read: most corpora (and Careers always) are searched on",
+            "your own database session, so a document, a channel or an applicant you cannot open is not in",
+            "the list; memory and Scout run on the service role behind their own gates.",
             "",
             "A corpus that could not ANSWER gets its own line, separately from \"nothing matched\" —",
             "those are different facts and folding them together would let a broken search read as silence.",

package/dist/commands/local-help.js

@@ -8,7 +8,6 @@
  * user-visible contract like any other.
  */
 import { DEFAULT_DASHBOARD_URL } from "../local-state.js";
-import { SEARCH_KINDS } from "./local-args-tower-search.js";
 import { localSubcommandHelp } from "./local-help-commands.js";
 /**
  * The Tower PAGE names a person reads in the rail, each routed to the CLI noun
@@ -136,7 +135,8 @@ export function localCommandHelp(command) {
         "  cockpit cal [today|week|next|find \"<words>\"|calendars|add-ical|create --calendar <id> --title <t> --at <iso> --until <iso>|share <id> --org-visible|--private|sync <id> [--full]|detach <id>] [--tz <zone>] [--offset <n>] [--hours <n>] [--from <d> --to <d>] [--calendar <id>] [--limit <n>] [--all] [--dashboard-url <url>] [--json]",
         "  cockpit project [list] [--archived] [--dashboard-url <url>] [--json]",
         "  cockpit github <pr|merge|retitle|rerun> <owner/repo> <n> [--claim <state>] [--method squash|merge|rebase] [--title \"<text>\"] [--run <id>] [--confirm <code>] [--dashboard-url <url>] [--json]",
-        `  cockpit search "<words>" [--kind ${SEARCH_KINDS.join(",")}] [--limit <n>] [--dashboard-url <url>] [--json]`,
+        `  cockpit search "<words>" [--kind <category,...>] [--limit <n>] [--dashboard-url <url>] [--json]`,
+        "  cockpit search --categories [--dashboard-url <url>] [--json]",
         "  cockpit release [--dry-run] [--skip-checks] [--no-floor] [--tag <tag>] [--access <public|restricted>] [--otp <code>]",
         "  cockpit careers [list|show <id>|rescreen <id>|send-takehome <id>|decide <id> --decision <passed_on|archived|reopen>|followup <id> [--record-sent-at <iso>]|interview <id> <--at <iso>|--clear>|grade <id> [--now]|resume <id> [--out <path>]|takehome show <role>|takehome set <role> --body-file <path>|settings show|settings set --enabled <true|false> --followup-enabled <true|false> --followup-after-days <n> --takehome-window-hours <n>] [--role <slug>] [--min-score <n>] [--since <date>] [--stage <s>] [--force] [--json]",
         "  cockpit glossary list|add <wrong> --to <name>|remove <wrong> [--dashboard-url <url>] [--json]",

package/dist/commands/public-root.js

@@ -21,7 +21,7 @@ export async function runCockpitCli(argv, io) {
   }
 
   if (command === "--version" || command === "-V" || command === "version") {
-    writeLine(io?.stdout ?? process.stdout, "0.2.192");
+    writeLine(io?.stdout ?? process.stdout, "0.2.193");
     return 0;
   }
 

package/dist/commands/search.js

@@ -1,5 +1,5 @@
 /**
- * `cockpit search` — one bar over five corpora, in a terminal (BLI-3728).
+ * `cockpit search` — one bar over every corpus, in a terminal (BLI-3728).
  *
  * The SAME door the browser's search bar presses: `GET /api/search`, opted
  * into the collector device token in `route-caller-census.test.ts`. So a
@@ -42,10 +42,15 @@ const KIND_LABELS = {
     mail: "MAIL",
     cal: "CALENDAR",
     memory: "MEMORY",
+    scout: "SCOUT",
+    careers: "CAREERS",
 };
-const KIND_ORDER = ["doc", "msg", "issue", "note", "mail", "cal", "memory"];
+const KIND_ORDER = ["doc", "msg", "issue", "note", "mail", "cal", "memory", "scout", "careers"];
 export async function runSearch(command, io) {
     const door = await openAgentDoor("search", command, io);
+    // BLI-13027: the list the browser's Command-K chips are drawn from.
+    if (command.categories)
+        return await runCategories(door);
     const params = new URLSearchParams({ q: command.query });
     if (command.kinds && command.kinds.length > 0)
         params.set("kinds", command.kinds.join(","));
@@ -64,6 +69,28 @@ export async function runSearch(command, io) {
         return emitAgentDoor(door, body);
     return render(door, body);
 }
+async function runCategories(door) {
+    const answer = await askAgentDoor(door, {
+        path: "/api/search?categories=1",
+        method: "GET",
+        label: "search categories",
+        timeoutMs: READ_DEADLINE_MS,
+    });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    const body = answer.body;
+    if (door.json)
+        return emitAgentDoor(door, body);
+    const categories = body.categories ?? [];
+    writeLine(door.io.stdout, `${body.everything?.label ?? "Everything"} (searched when --kind is left out)`);
+    for (const entry of categories) {
+        const aliases = (entry.aliases ?? []).length > 0 ? `  (also: ${(entry.aliases ?? []).join(", ")})` : "";
+        writeLine(door.io.stdout, `  ${entry.kind}  ${entry.label}${aliases}`);
+    }
+    writeLine(door.io.stdout, "");
+    writeLine(door.io.stdout, `${categories.length} categories. Name them with --kind, comma separated.`);
+    return 0;
+}
 function render(door, body) {
     const hits = body.hits ?? [];
     const failures = body.failures ?? {};
@@ -76,7 +103,10 @@ function render(door, body) {
             writeLine(door.io.stdout, "Nothing matched in the corpora that answered.");
         }
     }
-    for (const kind of KIND_ORDER) {
+    // Known kinds in the usual order, then any kind this CLI has never heard of
+    // (a newer door than this build): printed, not swallowed.
+    const unknownKinds = [...new Set(hits.map((hit) => hit.kind))].filter((kind) => !KIND_ORDER.includes(kind));
+    for (const kind of [...KIND_ORDER, ...unknownKinds]) {
         const group = hits.filter((hit) => hit.kind === kind);
         if (group.length === 0)
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.192",
+  "version": "0.2.193",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.57",
-    "@bli-cockpit/mcp": "0.1.104",
+    "@bli-cockpit/mcp": "0.1.105",
     "@bli-cockpit/telemetry-core": "0.1.66"
   },
   "repository": {