@bli-cockpit/cli 0.2.191 → 0.2.193

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

@@ -15,38 +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 = [];
-        for (const part of kindFlag.split(",").map((entry) => entry.trim()).filter(Boolean)) {
-            if (!SEARCH_KINDS.includes(part)) {
-                throw new Error(`search --kind must be one or more of ${SEARCH_KINDS.join(", ")} — not "${part}".`);
-            }
-            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;
@@ -54,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-commands.js

@@ -400,13 +400,13 @@ export function localSubcommandHelp(command) {
     ]);
     // BLI-10431: a Tower page name answers with its own usage line first, then
     // the manual of the noun it routes to, so `cockpit work --help` names every
-    // Work verb instead of `Unknown command: work`.
+    // ticket verb instead of `Unknown command: work`.
     const aliasTarget = SURFACE_ALIASES.get(command);
     if (aliasTarget) {
         return [
             `Usage: cockpit ${command} [same verbs and flags as cockpit ${aliasTarget}]`,
             `\`cockpit ${command}\` is the Tower page's name for \`cockpit ${aliasTarget}\`; both spellings run the same command.`,
-            ...(command === "work" ? ["Projects the issues are filed under: `cockpit project list`."] : []),
+            ...(aliasTarget === "issue" ? ["Projects the Tower tickets are filed under: `cockpit project list`."] : []),
             "",
             ...(helpByCommand.get(aliasTarget) ?? [localCommandHelp()]),
         ].join("\n");

package/dist/commands/local-help.js

@@ -8,23 +8,26 @@
  * 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
  * that already serves that page (BLI-10431).
  *
- * The rail says WORK, CALENDAR, MESSAGES and MEETING NOTES; the MCP server
+ * The rail says TICKETS, CALENDAR, MESSAGES and MEETING NOTES; the MCP server
  * says `work_list_issues`; the CLI spelled the same doors `issue`, `cal`,
  * `msg` and `notes`. `cockpit work --help` answered `Unknown command: work` on
- * 0.2.133 while every Work verb existed one word away. An alias here is a
- * second spelling of the same parser, never a second parser: `cockpit work
- * list` IS `cockpit issue list`, byte for byte.
+ * 0.2.133 while every verb existed one word away. An alias here is a
+ * second spelling of the same parser, never a second parser: `cockpit ticket
+ * list` IS `cockpit issue list`, byte for byte. BLI-12947 renamed the Work
+ * page to Tickets and added `ticket` and `tickets`; `work` stays for every
+ * agent and doc that already says it.
  *
  * `surface-doors.test.ts` reads the rail and the MCP tool names and fails when
  * a page or a tool family has no spelling here or in `rootCommandNames`.
  */
 export const SURFACE_ALIASES = new Map([
+    ["ticket", "issue"],
+    ["tickets", "issue"],
     ["work", "issue"],
     ["calendar", "cal"],
     ["messages", "msg"],
@@ -132,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]",
@@ -143,7 +147,9 @@ export function localCommandHelp(command) {
         "  cockpit usage sessions [--task <BLI-NNNN> | --subject <name>] [--repo <label>] [--since <window>] [--json]",
         "  cockpit usage sessions --session <id> [--from-window <n>] [--json]",
         "  --by-topic groups work types; --by-subject groups open subjects from session summaries.",
-        "  cockpit work [same verbs and flags as cockpit issue]   (the Work page; projects: `cockpit project list`)",
+        "  cockpit ticket [same verbs and flags as cockpit issue]   (the Tickets page; projects: `cockpit project list`)",
+        "  cockpit tickets ...   same as cockpit ticket",
+        "  cockpit work ...      same as cockpit ticket (the older name)",
         "  cockpit calendar [same verbs and flags as cockpit cal]",
         "  cockpit messages [same verbs and flags as cockpit msg]",
         "  cockpit meeting-notes [same verbs and flags as cockpit notes]",

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.191");
+    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
@@ -37,15 +37,20 @@ const READ_DEADLINE_MS = 30_000;
 const KIND_LABELS = {
     doc: "DOCUMENTS",
     msg: "MESSAGES",
-    issue: "ISSUES",
+    issue: "TICKETS",
     note: "MEETING NOTES",
     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.191",
+  "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.103",
+    "@bli-cockpit/mcp": "0.1.105",
     "@bli-cockpit/telemetry-core": "0.1.66"
   },
   "repository": {