@bli-cockpit/cli 0.2.249 → 0.2.251

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

@@ -18,6 +18,10 @@
  *   cockpit manager approve <id> --version <v> [--timeline] [--restore]   (--restore brings a dismissed item back)
  *   cockpit manager dismiss|archive|unarchive <id> --version <v> [--timeline]
  *   cockpit manager proposal <id> <proposal-id> accept|dismiss|add-new --version <v> [--timeline]
+ *   cockpit manager meetings | tie | decide-tie ...   (meetings tied to clients: usage in `manager-meetings.ts`)
+ *   cockpit manager decisions <client> [--status open|approved|dismissed|all]                       (BLI-22187, `manager-decisions.ts`)
+ *   cockpit manager add-decision <client> --title <t> [--why <t>] [--owners 'A, B'] [--due YYYY-MM-DD] [--request-id <uuid>]
+ *   cockpit manager decide <decision-id> approve|dismiss|reopen --version <v> [--note <t>]
  *
  * Free text goes in a JSON file or on stdin with `--fields-file <path>|-` on add, edit and summary (no shell quoting at all,
  * `manager-fields-file.ts`); on a flag it goes in SINGLE quotes (the shell leaves `$` alone) and the help says how to write
@@ -27,33 +31,35 @@
  * `help` and `--help` are the help, never a list and never another command.
  */
 import { optionalNonEmpty, optionalUrl, parseNamedArgs, rejectSecretLikeValue } from "./local-arg-values.js";
+import { readDecisionFields } from "./manager-decisions.js";
 import { mergeFieldsFile } from "./manager-fields-file.js";
 import { runIdRefusal } from "./manager-hints.js";
+import { readMeetingTieArgs, readTieId } from "./manager-meetings.js";
 export const MANAGER_VERBS = [
     "clients", "client", "home", "summary", "run", "list", "queue", "show", "add", "edit", "done", "drop", "reopen", "link",
-    "approve", "dismiss", "proposal", "archive", "unarchive",
+    "approve", "dismiss", "proposal", "archive", "unarchive", "meetings", "tie", "decide-tie", "decisions", "add-decision", "decide",
 ];
 export const MANAGER_ACTION_STATUSES = ["open", "done", "dropped", "closed", "all"];
 export const MANAGER_TIMELINE_KINDS = ["meeting", "document", "milestone", "internal"];
 export const MANAGER_SUMMARY_HEALTHS = ["on_track", "at_risk", "blocked"];
 /** The verbs whose one positional word is a client (its id or its exact name). */
-const CLIENT_VERBS = new Set(["client", "home", "summary", "list", "queue", "add"]);
+const CLIENT_VERBS = new Set(["client", "home", "summary", "list", "queue", "add", "tie", "decisions", "add-decision"]);
 const ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const VERSION = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
 const ONE_VERB = `manager takes one verb: ${MANAGER_VERBS.join(", ")}. Example: \`cockpit manager clients\` or \`cockpit manager list <client>\`.`;
 const OWN_FLAGS = [
     "--timeline", "--needs-review", "--status", "--owner", "--owners", "--no-owner", "--kind", "--search", "--archived", "--review",
     "--title", "--detail", "--due", "--date", "--meeting", "--none", "--version", "--request-id", "--restore", "--overdue", "--source-url", "--source-note",
-    "--health", "--headline", "--bullet", "--next", "--blocker", "--fields-file",
+    "--health", "--headline", "--bullet", "--next", "--blocker", "--fields-file", "--client", "--event", "--note", "--occurrence", "--cursor", "--page-size", "--why",
 ];
 const COMMON_FLAGS = ["--home", "--dashboard-url", "--json", "--help"];
 const VALUE_FLAGS = [
     "--status", "--owner", "--owners", "--kind", "--search", "--review", "--title", "--detail", "--due", "--date", "--meeting",
     "--version", "--request-id", "--source-url", "--source-note", "--home", "--dashboard-url",
-    "--health", "--headline", "--bullet", "--next", "--blocker", "--fields-file",
+    "--health", "--headline", "--bullet", "--next", "--blocker", "--fields-file", "--client", "--event", "--note", "--occurrence", "--cursor", "--page-size", "--why",
 ];
 /** The flags whose value is a person's own words (not an id, a version or a choice). */
-const TEXT_FLAGS = ["--title", "--detail", "--headline", "--bullet", "--next", "--blocker", "--owners", "--owner", "--source-note", "--source-url"];
+const TEXT_FLAGS = ["--title", "--detail", "--headline", "--bullet", "--next", "--blocker", "--owners", "--owner", "--source-note", "--source-url", "--why", "--note"];
 /** `summary --bullet` is given once per bullet: the one value flag that may repeat. */
 const REPEATABLE_FLAGS = new Set(["--bullet"]);
 /** Which flags each verb owns, so a flag on the wrong verb is refused by name rather than ignored. */
@@ -77,6 +83,8 @@ export const FLAGS_BY_VERB = {
     proposal: ["--timeline", "--version"],
     archive: ["--timeline", "--version"],
     unarchive: ["--timeline", "--version"],
+    meetings: ["--client", "--event", "--note", "--page-size", "--cursor"], tie: ["--event", "--note", "--occurrence", "--request-id"], "decide-tie": ["--version"],
+    decisions: ["--status"], "add-decision": ["--title", "--why", "--owners", "--due", "--request-id"], decide: ["--version", "--note"],
 };
 /** Positional words each verb takes, named for the refusal. */
 const POSITIONALS = {
@@ -90,15 +98,9 @@ const POSITIONALS = {
     show: ["id"],
     add: ["client"],
     edit: ["id"],
-    done: ["action id"],
-    drop: ["action id"],
-    reopen: ["action id"],
-    link: ["action id"],
-    approve: ["id"],
-    dismiss: ["id"],
-    proposal: ["id", "proposal id", "accept, dismiss or add-new"],
-    archive: ["id"],
-    unarchive: ["id"],
+    done: ["action id"], drop: ["action id"], reopen: ["action id"], link: ["action id"],
+    approve: ["id"], dismiss: ["id"], proposal: ["id", "proposal id", "accept, dismiss or add-new"], archive: ["id"], unarchive: ["id"],
+    meetings: [], tie: ["client"], "decide-tie": ["tie id", "accept, dismiss or remove"], decisions: ["client"], "add-decision": ["client"], decide: ["decision id", "approve, dismiss or reopen"],
 };
 /** A value flag given twice would silently keep only the last; say so instead. */
 function refuseRepeatedFlags(args) {
@@ -151,13 +153,20 @@ export function parseManagerArgs(args, options = {}) {
         shape.client = rest[0];
     else if (verb === "run")
         shape.runId = readRunId(rest[0]);
-    else if (verb !== "clients")
-        shape.id = readId(rest[0], verb === "done" || verb === "drop" || verb === "reopen" || verb === "link" ? "An action" : "An item");
+    else if (verb === "decide-tie")
+        shape.id = readTieId(rest[0]);
+    else if (verb !== "clients" && verb !== "meetings")
+        shape.id = readId(rest[0], verb === "done" || verb === "drop" || verb === "reopen" || verb === "link" ? "An action" : verb === "decide" ? "A decision" : "An item");
     if (verb === "proposal") {
         shape.proposalId = rest[1];
         shape.decision = readDecision(rest[2]);
     }
-    const needsVersion = !["clients", "client", "home", "summary", "run", "list", "queue", "show", "add"].includes(verb);
+    // BLI-22187: the decision verbs read their own flags (`manager-decisions.ts`); `decide`'s version comes from `decisions <client>`.
+    if (verb === "decisions" || verb === "add-decision" || verb === "decide") {
+        readDecisionFields(verb, values, shape, rest[1], { readId, readDate, readOwnersList, isBlank });
+        return shape;
+    }
+    const needsVersion = !["clients", "client", "home", "summary", "run", "list", "queue", "show", "add", "meetings", "tie"].includes(verb);
     if (needsVersion)
         shape.version = readVersion(flag("--version"), verb);
     let fileBullets;
@@ -172,6 +181,8 @@ export function parseManagerArgs(args, options = {}) {
         readSummaryFields(values, shape, fileBullets);
     if (verb === "list")
         readListFilters(values, shape);
+    if (verb === "meetings" || verb === "tie" || verb === "decide-tie")
+        readMeetingTieArgs(verb, values, rest, shape);
     if (verb === "add")
         readAddFields(values, shape);
     if (verb === "edit")

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

@@ -16,7 +16,7 @@ import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs,
  * `otter` and `granola` are deliberately absent: Otter's public API is
  * Enterprise-only and Granola still runs on its own server-side cron.
  */
-const CONNECTABLE_PROVIDERS = ["fellow", "circleback", "wisprflow"];
+const CONNECTABLE_PROVIDERS = ["fellow", "circleback", "wisprflow", "fireflies"];
 /**
  * BLI-12926. Providers with no API key at all: the person signs in through
  * their browser and `connect` runs that sign-in itself. `--key-stdin` is

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

@@ -27,7 +27,14 @@ const SETTINGS_ALLOWED_FLAGS = [
     "--id",
     "--content-stdin",
     "--yes",
+    "--clear",
 ];
+/**
+ * BLI-22344: the switches a person may set to EMPTY with `--clear`. Emptying the meeting bot's pilot list is the
+ * fail-closed "pause the bot" act, so it needs a spelling a shell cannot swallow (an empty `""` vanishes in some
+ * shells). Every other switch still needs a value; the server keeps its own validation either way.
+ */
+const CLEARABLE_SWITCH_KEYS = ["notes.review_gate.pilot_user_ids"];
 const SETTINGS_VALUE_FLAGS = [
     "--home",
     "--dashboard-url",
@@ -50,6 +57,10 @@ export function parseSettingsArgs(args) {
         yes: values.booleans.has("--yes"),
         json: values.booleans.has("--json"),
     };
+    const clear = values.booleans.has("--clear");
+    if (clear && rawSection !== "switches") {
+        throw new Error("--clear belongs to `settings switches set <key> --clear` only.");
+    }
     if (!rawSection) {
         if (rest.length > 0)
             throw new Error("settings does not accept that argument.");
@@ -62,7 +73,7 @@ export function parseSettingsArgs(args) {
         case "personal":
             return parsePersonalSection(rest, values.flags, common);
         case "switches":
-            return parseSwitchesSection(rest, common);
+            return parseSwitchesSection(rest, clear, common);
         case "cli-floor":
             return parseCliFloorSection(rest, common);
         case "models":
@@ -86,15 +97,25 @@ function parsePersonalSection(rest, flags, common) {
         ...common,
     };
 }
-/** `settings switches` or `settings switches set <key> <value>`. */
-function parseSwitchesSection(rest, common) {
+/** `settings switches`, `settings switches set <key> <value>`, or `settings switches set <key> --clear` for a list. */
+function parseSwitchesSection(rest, clear, common) {
     if (rest.length === 0) {
+        if (clear)
+            throw new Error("--clear belongs to `settings switches set <key> --clear` only.");
         return { kind: "settings", section: "switches", action: "show", ...common };
     }
     if (rest[0] !== "set") {
         throw new Error("settings switches takes no verb, or `set <key> <value>`.");
     }
     const [, key, value, ...extra] = rest;
+    if (clear) {
+        if (!key || value !== undefined)
+            throw new Error("settings switches set <key> --clear takes no value.");
+        if (!CLEARABLE_SWITCH_KEYS.includes(key)) {
+            throw new Error(`--clear only empties a list switch: ${CLEARABLE_SWITCH_KEYS.join(", ")}. Every other switch needs a value.`);
+        }
+        return { kind: "settings", section: "switches", action: "set", switchKey: key, switchValue: "", ...common };
+    }
     if (!key || !value || extra.length > 0) {
         throw new Error("settings switches set needs exactly a key and a value.");
     }

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

@@ -212,7 +212,7 @@ export const TOWER_OPS_COMMAND_HELP = [
     [
         "manager",
         [
-            "Usage: cockpit manager <clients|client|home|summary|run|list|queue|show|add|edit|done|drop|reopen|link|approve|dismiss|proposal|archive|unarchive> ... [--dashboard-url <url>] [--json]",
+            "Usage: cockpit manager <clients|client|home|summary|run|list|queue|show|add|edit|done|drop|reopen|link|approve|dismiss|proposal|archive|unarchive|meetings|tie|decide-tie|decisions|add-decision|decide> ... [--dashboard-url <url>] [--json]",
             "",
             "Tower Manager's clients, from the terminal: each client's Home and \"Where we are\", its actions and its timeline items, the same things the manager page does.",
             "  cockpit manager clients                      every client, with its id",
@@ -253,6 +253,24 @@ export const TOWER_OPS_COMMAND_HELP = [
             "  cockpit manager dismiss <id> --version <v> [--timeline]    the AI's item is wrong: dismiss it (kept, hidden from the lists)",
             "  cockpit manager proposal <id> <proposal-id> accept|dismiss|add-new --version <v> [--timeline]   decide one suggested change; add-new makes it an item of its own",
             "  cockpit manager archive <id> --version <v> [--timeline]    delete an item: it moves to the Deleted list (list --archived), kept;  unarchive <id> --version <v>  brings it back",
+            "  cockpit manager meetings [--client <client>] [--event <id> | --note <id>] [--page-size <n>] [--cursor <c>]",
+            "                                               meetings tied to clients, newest tie first: one client's (--client), the clients one meeting is tied to (--event or --note), or every client's.",
+            "                                               Each shows the meeting's title and time only if YOU can open that event or note in Tower; any other reads \"a meeting you cannot open\" (Tower never stores a meeting's title on the tie).",
+            "                                               Suggested and confirmed ties only; dismissed and removed ones are kept but not listed. Ties per page: 50 by default, up to 200 with --page-size; the next page is --cursor <nextCursor> with the same --client, --event or --note, and the command prints it.",
+            "  cockpit manager tie <client> --event <id> [--occurrence <timestamp>] | --note <id> [--request-id <uuid>]",
+            "                                               tie a calendar event (--occurrence: one occurrence of a recurring one, its start with an offset) or a meeting note to a client. A meeting can be tied to several clients.",
+            "                                               From the terminal or an agent a tie is a SUGGESTION, shown as waiting for a person until someone accepts or dismisses it (the manager page, or decide-tie); a meeting already tied there answers that tie and writes nothing.",
+            "                                               A suggestion a person dismissed is never suggested again (refused tie_dismissed). It sends a request id and prints it: rerun with that --request-id to retry without a duplicate.",
+            "  cockpit manager decide-tie <tie-id> accept|dismiss|remove --version <v>",
+            "                                               accept or dismiss a suggested tie, or remove a confirmed one (kept, no longer listed). --version is the tie's version as `meetings` prints it; a changed tie is refused (tie_changed) and nothing is written.",
+            "  cockpit manager decisions <client> [--status open|approved|dismissed|all]   the choices someone has to make for this client (its own kind, not timeline items), soonest due first, undated last,",
+            "                                               each with why it is asked, who decides, its id and its version; open (waiting) is the default, all lists the decided ones too. A list holds at most 500 decisions.",
+            "  cockpit manager add-decision <client> --title <text> [--why <text>] [--owners 'A, B'] [--due YYYY-MM-DD] [--request-id <uuid>]",
+            "                                               add a decision to make: --why says why it is asked, --owners who decides (kept as written), --due the day to decide by. It is stored as added by your agent and waits until someone decides it. Text tagged [HR] is refused.",
+            "                                               Limits: a title at most 300 characters, a why at most 2,000 characters, a note at most 500 characters. Like add, it always sends a request id and prints it, so a retry never makes a second one.",
+            "  cockpit manager decide <decision-id> approve|dismiss|reopen --version <v> [--note <text>]",
+            "                                               approve or dismiss a decision as YOUR AGENT (your name, marked as your agent, with the day), with --note saying in a line what was decided; reopen undoes either and clears the note. An approved decision is dismissed (or a dismissed one approved) only after a reopen.",
+            "                                               --version is the decision's version as `decisions <client>` prints it; a stale one is refused and nothing is written. Deciding it the same way again writes nothing.",
             "approve, dismiss and proposal decide the AI's suggestion as YOU: your name is recorded as the reviewer, and the item leaves the review queue unless a suggested change still waits on it.",
             "Marking reviewed sets the review state to reviewed, with you as the reviewer and the time of the write: link always does it, and edit does whenever it changes something, even a detail-only one (an edit whose fields all equal the stored ones prints \"No change; nothing was written.\", with no new version and no reviewed mark); done, drop and reopen do it only when the status changes (on an action already in that status nothing is written); approve and an accepted proposal do it too. Dismiss sets it to dismissed with you as the reviewer; archive, unarchive and a proposal you dismiss or add-new leave the item's review state as it was.",
             "Free text without shell quoting: add, edit and summary take --fields-file <path> (or - for stdin), one JSON object whose keys are the flags in snake_case, so a $12k, an apostrophe, a double quote or an = reaches Tower exactly as written. The file is UTF-8 (a UTF-16 file with a BOM is read too; any other encoding is refused): in Windows PowerShell write it with `-Encoding utf8` (a `>` redirect makes UTF-16 and Set-Content makes the ANSI code page, which breaks a ’), and for stdin on 5.1 set `$OutputEncoding = [System.Text.UTF8Encoding]::new()` first.",
@@ -272,7 +290,7 @@ export const TOWER_OPS_COMMAND_HELP = [
             "--json writes the door's body to stdout, verbatim, and nothing else (an add's body also carries requestId); a refusal is { ok: false, error, detail, refusal? } and exits 1.",
             "Progress lines on stderr start with [tag]; stdout is the answer (2>/dev/null hides them). Creating a client, syncing, Rebuild brief and merging owners are on the manager page only. Teaching: docs/architecture/tower-manager.md.",
             "The bli-tower MCP server has the twins: manager_clients, manager_client, manager_home, manager_set_summary (summary), manager_run, manager_list, manager_queue, manager_show, manager_add, manager_edit,",
-            "manager_done, manager_drop, manager_reopen, manager_link, manager_approve, manager_dismiss, manager_proposal, manager_archive, manager_unarchive.",
+            "manager_done, manager_drop, manager_reopen, manager_link, manager_approve, manager_dismiss, manager_proposal, manager_archive, manager_unarchive, manager_meetings, manager_tie, manager_decide_tie (decide-tie), manager_decisions, manager_add_decision, manager_decide.",
         ],
     ],
     [

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

@@ -426,14 +426,14 @@ export const TOWER_COMMAND_HELP = [
             "move <id> (--to \"<shelf>\"|--clear-shelf) — put it on a different shelf, or take the shelf off.",
             "place <id> [--apply] — say which shelf this note belongs on and why, from the meeting it is part of, who was in the room and its own name. Moves nothing without --apply, and never overrules a shelf somebody typed.",
             "",
-            "Your own notetaker (BLI-4383). Fellow, Circleback and Wispr Flow today; Otter needs an Enterprise plan and Granola still runs on its own cron.",
+            "Your own notetaker (BLI-4383). Fellow, Circleback, Fireflies and Wispr Flow today; Otter needs an Enterprise plan and Granola still runs on its own cron.",
             "accounts [--json] — the notetakers you have connected, with health and when each was last read, and under it who on the team feeds Tower with which notetaker (a member with none is named: that is the gap).",
             "recordings <note-id> [--json] — every recording of the meeting this note is. When several notetakers or people recorded one meeting, the library shows ONE note, the recording with the longest transcript; the others are alternates kept by id (BLI-12926).",
             "recording <recording-id> [--json] — one recording, text and all, shown or alternate.",
             "accounts --show-webhook <account-id> — that account's webhook URL, where to paste it at the vendor, and whether a signing secret is stored (BLI-4394). Until one is, every request to that URL is refused, which is the right way to be off.",
             "webhook <account-id> --secret-stdin — store the VENDOR's webhook signing secret. THE SECRET IS READ FROM STDIN, never a flag: printf \"%s\" \"<signing secret>\" | cockpit notes webhook <account-id> --secret-stdin",
             "connect --provider wisprflow — Wispr Flow has no API key: this asks Tower to start the sign-in (the same door the Settings button, the MCP tool notes_connect_wisprflow and JARVIS use), prints and opens Wispr's approval page (Google, Apple, Microsoft or company single sign-on), and waits up to 10 minutes for Tower to report it connected, then Tower reads your Notetaker meetings from then on. Needs Notetaker and MCP access on your Wispr account. Exits 1 with a reason if nothing connects (BLI-12926, BLI-17973).",
-            "connect --provider fellow|circleback [--workspace <subdomain>] --key-stdin [--name <n>] — connect one. Fellow needs --workspace, its API is per workspace. THE API KEY IS READ FROM STDIN, never a flag: printf \"%s\" \"<key>\" | cockpit notes connect --provider fellow --workspace <subdomain> --key-stdin",
+            "connect --provider fellow|circleback|fireflies [--workspace <subdomain>] --key-stdin [--name <n>] — connect one. Fellow needs --workspace, its API is per workspace. THE API KEY IS READ FROM STDIN, never a flag: printf \"%s\" \"<key>\" | cockpit notes connect --provider fellow --workspace <subdomain> --key-stdin",
             "detach <account-id> — take it off. The stored key goes with it; the meetings it already filed stay.",
             "sync <account-id> — read that notetaker now. Prints the run's own counts and reason label, and exits 1 when the pass failed.",
             "sync <account-id> --repair-truncated — re-read Wispr Flow notes that were stored with only the first part of a long transcript (the \"truncated, N chars remaining\" line), and rewrite them whole. Same door and the same bounded passes; prints found, fixed and failed with each failure's reason, and is safe to run again (BLI-18006).",

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

@@ -161,7 +161,7 @@ const COMMAND_HELP = new Map([
             "",
             "  cockpit settings personal [--chat-model <key>] [--brief-model <key>]",
             "      Your teams and your two model choices. No flags = show.",
-            "  cockpit settings switches [set <key> <value>]",
+            "  cockpit settings switches [set <key> <value> | set <key> --clear]",
             "      Access and feature switches. Everyone may look; only an admin may set.",
             "  cockpit settings models [set --chat <key>] [--memory <id>] [--note-reader <id>]",
             "      The ORG-WIDE model map. Admin only, in both directions.",

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

@@ -15,7 +15,7 @@ export const PROJECT_HELP = [
         "archive / restore — soft: tickets keep their project, the Linear mapping is untouched, nothing is deleted. There is no delete verb.",
         "Every write returns a receipt with delivery tower_only: a project write never reaches Linear and never queues a Linear change. The same --request-id replays the first receipt; with another body it is request_id_reused.",
         "--expected-updated-at is the updated_at you last read (shown by show and --json); a stale one is revision_conflict with the current project and changes nothing.",
-        "Refusals keep Tower's label: project_name_required, project_name_taken, project_owned_by_linear (a project imported from Linear is named there; archive and restore still work), project_already_archived, project_not_archived, project_not_found_or_unreadable, revision_conflict, request_id_reused, invalid_body.",
+        "Refusals keep Tower's label: project_name_required, project_name_taken, project_owned_by_linear (only a project still marked as named in Linear; projects imported from Linear are Tower's own), project_already_archived, project_not_archived, project_not_found_or_unreadable, revision_conflict, request_id_reused, invalid_body.",
         "BLI-22360 planning fields on create and update: --lead <email|me|none>, --member <email[,email]|none> (the whole set; repeatable), --add-member / --remove-member (update), --status backlog|planned|started|paused|completed|canceled|none, --priority none|urgent|high|medium|low (or 0-4), --start / --target <YYYY-MM-DD|none> with --start-resolution / --target-resolution month|quarter|halfYear|year|day (a date without one is an exact day), --content-file <path> or --content <text|none> (the long body; --description stays the short summary). People are matched by exact email, never by name. show prints them, the project's milestones and their progress (see `cockpit milestone`). Refusals: project_status_invalid, project_dates_invalid, project_person_not_found.",
         "--json writes one machine-readable object to stdout; every reason and receipt line stays on stderr.",
     ],

package/dist/commands/local-help.js

@@ -125,7 +125,7 @@ const COMMAND_SUMMARY_LINES = [
     "  cockpit delivery report [--days <1-30>] [--end <YYYY-MM-DD>] [--review-minutes <1-240>] [--json]",
     "  cockpit ops [status [--job <id>] [--skips] [--memory] [--models] | recompile --person <email|name|id> [--dry-run]] [--dashboard-url <url>] [--json]",
     "  cockpit slack [connect [--workspace bli|blue_pearl] | disconnect --workspace bli|blue_pearl | coverage [--workspace bli|blue_pearl] [--stale-only] [--list] | read [--person <p>] [--channel <c>] [--query <text> [--word]] [--since <YYYY-MM-DD>] [--until <YYYY-MM-DD>] [--limit <n>] [--format compact|full]] [--json]",
-    "  cockpit settings [personal [--chat-model <key>] [--brief-model <key>] | switches [set <key> <value>] | models [set --chat <key>] [--memory <id>] | cli-floor [<version>] | env list|set --project <p> --file <f> --content-stdin|delete --id <uuid> [--yes]] [--json]",
+    "  cockpit settings [personal [--chat-model <key>] [--brief-model <key>] | switches [set <key> <value> | set <key> --clear] | models [set --chat <key>] [--memory <id>] | cli-floor [<version>] | env list|set --project <p> --file <f> --content-stdin|delete --id <uuid> [--yes]] [--json]",
     "  cockpit team github-login add|remove <person> <login> | list <person> [--json]",
     "  cockpit team timezone set <person> <iana-zone|unknown> | list [--json]",
     "  cockpit team [members | invite <email> --role <role> [--team-id <uuid>] | role <userId> --role <role> [--yes] | device [list] | device revoke <id|name> --reason <label> [--note \"<text>\"] [--yes]] [--json]",

package/dist/commands/manager-decisions.js

@@ -0,0 +1,189 @@
+/**
+ * `cockpit manager decisions | add-decision | decide` (BLI-22187, Client Books data item 5): the choices someone has to
+ * make for a client, from the terminal. Decisions are their own kind on the manager server (`manager.decisions`), not
+ * timeline items: the timeline records what happened, a decision waits for someone.
+ *
+ *   cockpit manager decisions <client> [--status open|approved|dismissed|all]
+ *   cockpit manager add-decision <client> --title <t> [--why <t>] [--owners 'A, B'] [--due YYYY-MM-DD] [--request-id <uuid>]
+ *   cockpit manager decide <decision-id> approve|dismiss|reopen --version <v> [--note <t>]
+ *
+ * This file holds what only decisions need: their flags' readers, their request paths, their words and their next steps.
+ * The parser (`local-args-tower-manager.ts`), the planner (`manager-requests.ts`) and the runner (`manager.ts`) call in.
+ *
+ * Everything through the `/api/manager` door is an agent's write (BLI-21947): an add is stored as your agent's
+ * (`origin` ai, you as creator) and a decide as decided by your agent (`decidedByAgent`), never as you clicking it.
+ */
+import { dim } from "./cli-io.js";
+export const DECISION_VERBS = ["decisions", "add-decision", "decide"];
+export const isDecisionVerb = (verb) => DECISION_VERBS.includes(verb);
+/** The server's statuses and list filter (`TOWER_MANAGER_DECISION_STATUSES`, `_FILTERS`), copied: held to them by `manager-enum-words.test.ts`. */
+export const DECISION_FILTERS = ["open", "approved", "dismissed", "all"];
+export const DECISION_VERDICTS = ["approve", "dismiss", "reopen"];
+/** Words for each status, held to the server's list by `manager-enum-words.test.ts`. */
+export const DECISION_STATUS_WORDS = { open: "waiting", approved: "approved", dismissed: "dismissed" };
+/** The table's limits (`TOWER_MANAGER_DECISION_LIMITS`), checked here so a long text is refused in words before anything is sent. */
+export const DECISION_TEXT_LIMITS = { title: 300, why: 2000, note: 500 };
+const VERSION = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
+function refuseTooLong(flag, text, max) {
+    const length = [...text].length;
+    if (length > max)
+        throw new Error(`${flag} is ${length.toLocaleString("en-US")} characters; at most ${max.toLocaleString("en-US")}. Shorten it.`);
+}
+/**
+ * Reads the decision verbs' own flags into the shape. `readers` are the parser's own (ids, dates, owner lists and the
+ * blank test), passed in so a decision's flags get exactly the checks an action's do.
+ */
+export function readDecisionFields(verb, values, shape, word, readers) {
+    if (verb === "decisions") {
+        const status = values.flags.get("--status");
+        if (status !== undefined) {
+            if (!DECISION_FILTERS.includes(status))
+                throw new Error(`--status on decisions wants one of ${DECISION_FILTERS.join(", ")} (open is the default).`);
+            shape.decisionStatus = status;
+        }
+        return;
+    }
+    if (verb === "add-decision") {
+        const title = values.flags.get("--title");
+        if (title === undefined || readers.isBlank(title))
+            throw new Error("`cockpit manager add-decision` needs --title <the decision to make>, like --title 'Approve the phase 2 scope?'.");
+        refuseTooLong("--title", title.trim(), DECISION_TEXT_LIMITS.title);
+        shape.title = title.trim();
+        const why = values.flags.get("--why");
+        if (why !== undefined && !readers.isBlank(why)) {
+            refuseTooLong("--why", why.trim(), DECISION_TEXT_LIMITS.why);
+            shape.why = why.trim();
+        }
+        const owners = values.flags.get("--owners");
+        const list = owners === undefined ? [] : readers.readOwnersList(owners);
+        if (list.length > 0)
+            shape.owners = list;
+        const due = values.flags.get("--due");
+        if (due !== undefined && due.trim().toLowerCase() !== "none")
+            shape.dueAt = readers.readDate(due, "--due");
+        const requestId = values.flags.get("--request-id");
+        if (requestId !== undefined)
+            shape.requestId = readers.readId(requestId, "A request");
+        return;
+    }
+    // decide
+    if (!DECISION_VERDICTS.includes(word ?? ""))
+        throw new Error("The last word of `cockpit manager decide` is approve, dismiss or reopen.");
+    shape.verdict = word;
+    const version = values.flags.get("--version");
+    if (version === undefined) {
+        throw new Error("`cockpit manager decide` needs --version <version>: the decision's version exactly as `cockpit manager decisions <client>` prints it. It keeps you from deciding over a change someone else made.");
+    }
+    if (!VERSION.test(version))
+        throw new Error("--version is the decision's version exactly as `cockpit manager decisions <client>` prints it, like 2026-10-09T17:03:11.123456Z.");
+    shape.version = version;
+    const note = values.flags.get("--note");
+    if (note !== undefined) {
+        if (shape.verdict === "reopen")
+            throw new Error("--note goes with approve or dismiss; reopen clears the note.");
+        if (readers.isBlank(note))
+            throw new Error("--note is blank. Leave it out, or say in a line what was decided.");
+        refuseTooLong("--note", note.trim(), DECISION_TEXT_LIMITS.note);
+        shape.note = note.trim();
+    }
+}
+const BASE = "/api/manager";
+const enc = encodeURIComponent;
+/** The one request each decision verb sends: method, path and body (the planner's `ManagerPlan` minus its log). */
+export function decisionRequest(command, clientId, newRequestId) {
+    if (command.action === "decisions") {
+        const query = command.decisionStatus ? `?status=${enc(command.decisionStatus)}` : "";
+        return { method: "GET", path: `${BASE}/clients/${enc(clientId ?? "")}/decisions${query}` };
+    }
+    if (command.action === "add-decision") {
+        const requestId = command.requestId ?? newRequestId();
+        const body = {
+            title: command.title,
+            ...(command.why === undefined ? {} : { why: command.why }),
+            ...(command.owners ? { owners: command.owners } : {}),
+            ...(command.dueAt ? { dueAt: command.dueAt } : {}),
+            requestId,
+        };
+        return { method: "POST", path: `${BASE}/clients/${enc(clientId ?? "")}/decisions`, body, requestId };
+    }
+    return {
+        method: "POST",
+        path: `${BASE}/decisions/${enc(command.id ?? "")}/decide`,
+        body: { verdict: command.verdict, expectedUpdatedAt: command.version, ...(command.note === undefined ? {} : { note: command.note }) },
+    };
+}
+/** "Oct 1" for a `YYYY-MM-DD` day as written; "Oct 16" for an instant on Vancouver's calendar. */
+const day = (value) => {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    const at = match ? new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]), 12)) : new Date(value);
+    if (Number.isNaN(at.getTime()))
+        return value;
+    return new Intl.DateTimeFormat("en-US", { timeZone: match ? "UTC" : "America/Vancouver", month: "short", day: "numeric" }).format(at);
+};
+export function decisionRowLines(decision, color) {
+    const status = DECISION_STATUS_WORDS[decision.status] ?? decision.status;
+    const when = decision.status !== "open" ? "" : decision.dueAt ? `, ${decision.overdue ? "was due" : "decide by"} ${day(decision.dueAt)}` : ", no day set";
+    const lines = [`${decision.title}  [${status}${when}]`];
+    if (decision.why)
+        lines.push(`  Why: ${decision.why}`);
+    // An AI decision with a creator is a person's agent's add through the door (BLI-21947); the model's own would have none.
+    const added = decision.origin !== "ai" ? "" : decision.createdBy ? ` · added by ${decision.createdByName ?? "a teammate"}'s agent` : " · suggested by AI";
+    lines.push(`  ${decision.owners && decision.owners.length > 0 ? `Decides: ${decision.owners.join(", ")}` : "Nobody named to decide"}${added}`);
+    if (decision.status !== "open" && decision.decidedAt) {
+        const who = `${decision.decidedByName ?? "a teammate"}${decision.decidedByAgent ? "'s agent" : ""}`;
+        lines.push(`  ${status[0].toUpperCase()}${status.slice(1)} by ${who}, ${day(decision.decidedAt)}${decision.note ? `: "${decision.note}"` : ""}`);
+    }
+    lines.push(dim(`  id ${decision.id}  version ${decision.updatedAt}`, color));
+    return lines;
+}
+export function decisionListLines(list, color) {
+    const c = list.counts;
+    const shown = list.items.length;
+    const which = list.status && list.status !== "all" ? `${DECISION_STATUS_WORDS[list.status] ?? list.status} ` : "";
+    const head = shown < list.total ? `Showing ${shown} of ${list.total} ${which}decisions (a list holds at most 500).` : `${list.total} ${which}decision${list.total === 1 ? "" : "s"}.`;
+    const lines = [head];
+    if (c)
+        lines.push(`The client has ${c.open} waiting (${c.overdue} past their day), ${c.approved} approved and ${c.dismissed} dismissed.`);
+    if (shown === 0)
+        lines.push(list.status === "open" || list.status === undefined ? "Nothing is waiting for a decision. `--status all` lists the decided ones too." : "No decisions match.");
+    for (const decision of list.items)
+        lines.push("", ...decisionRowLines(decision, color));
+    return lines;
+}
+/** What a decision write did, in one sentence, then the decision as written. */
+export function decisionWriteLines(command, body, color) {
+    const sentence = command.action === "add-decision"
+        ? body.created === false ? "Already added earlier under this request id; nothing new was written." : "Added. It waits for a decision."
+        : body.unchanged === true ? "No change; nothing was written."
+            : command.verdict === "approve" ? "Approved, recorded as your agent's decision."
+                : command.verdict === "dismiss" ? "Dismissed, recorded as your agent's decision."
+                    : "Reopened; it waits for a decision again.";
+    return [sentence, ...decisionRowLines(body.item, color)];
+}
+/**
+ * The next step after a refused decision write or read, in the terminal's words (`undefined`: the generic step applies).
+ * `noAnswer`: Tower gave no answer or a server error, so a decide may or may not have landed.
+ */
+export function decisionNextStep(command, reason, refusal, noAnswer) {
+    if (!isDecisionVerb(command.action))
+        return undefined;
+    const list = "`cockpit manager decisions <client> --status all`";
+    if (command.action === "decide") {
+        if (noAnswer)
+            return ` It may or may not have been saved: list the client's decisions with ${list} to see, and use the version it prints if you try again.`;
+        if (refusal === "item_changed")
+            return ` List the client's decisions again with ${list} and use the version it prints.`;
+        if (refusal === "decision_decided")
+            return ` Run \`cockpit manager decide ${command.id ?? "<decision-id>"} reopen --version <v>\` with the version ${list} prints, then approve or dismiss it.`;
+        if (reason === "not_found")
+            return ` Check the id with ${list}.`;
+    }
+    if (refusal === "request_reused")
+        return " That request id already made something else. Leave --request-id out to add a new decision.";
+    if (refusal === "item_hr_tagged")
+        return " Run it again without the tagged text; that part stays out of Tower.";
+    // An add with no answer keeps the generic step: rerun it with the same --request-id.
+    if (reason === "manager_unavailable" && command.action === "decisions")
+        return " Try again in a minute; if it says decisions are not set up, Tower's update that adds them has not landed yet.";
+    return undefined;
+}

package/dist/commands/manager-hints.js

@@ -46,6 +46,7 @@ export function summaryHints(home) {
 export const ITEM_REFUSAL_NAMES = [
     "item_changed", "item_busy", "item_archived", "item_not_archived", "item_dismissed", "person_item_not_dismissable",
     "no_proposal", "proposal_replaced", "timeline_not_live", "request_reused", "proposal_decided", "proposal_not_addable", "item_hr_tagged",
+    "decision_decided",
 ];
 /** Refusals that mean "the item is not as you last saw it": reading it again is the way forward. */
 export const RESEEN_REFUSALS = new Set(["item_changed", "item_busy", "proposal_decided", "no_proposal"]);
@@ -67,6 +68,7 @@ export function itemHints(id, flag) {
         timeline_not_live: "`cockpit manager list <client> --timeline` lists the client's live timeline items.",
         item_not_archived: "Nothing to bring back: it is in the lists already.",
         item_hr_tagged: "Run the add or edit again without the tagged text; that part stays out of Tower.",
+        decision_decided: `Run \`cockpit manager decide ${id} reopen --version <v>\` (\`decisions <client> --status all\` prints its version), then approve or dismiss it.`,
     };
 }
 /**

package/dist/commands/manager-limits.json

@@ -44,6 +44,24 @@
       "unit": "items",
       "source": "TOWER_MANAGER_HOME_LIMITS.comingUp"
     },
+    {
+      "id": "decisionNoteMax",
+      "value": 500,
+      "unit": "characters",
+      "source": "TOWER_MANAGER_DECISION_LIMITS.noteMax"
+    },
+    {
+      "id": "decisionTitleMax",
+      "value": 300,
+      "unit": "characters",
+      "source": "TOWER_MANAGER_DECISION_LIMITS.titleMax"
+    },
+    {
+      "id": "decisionWhyMax",
+      "value": 2000,
+      "unit": "characters",
+      "source": "TOWER_MANAGER_DECISION_LIMITS.whyMax"
+    },
     {
       "id": "headlineMax",
       "value": 140,
@@ -110,6 +128,12 @@
       "unit": "characters",
       "source": "routes/validation.ts: sourceNote .max(1000, ...)"
     },
+    {
+      "id": "tiePageMax",
+      "value": 200,
+      "unit": "rows",
+      "source": "TOWER_MANAGER_MEETING_TIE_LIMITS.pageMax"
+    },
     {
       "id": "whatChanged",
       "value": 100,
@@ -150,6 +174,7 @@
       "summary_hr_tagged"
     ],
     "item": [
+      "decision_decided",
       "item_archived",
       "item_busy",
       "item_changed",
@@ -210,10 +235,13 @@
     "blocker",
     "bullets",
     "client_id",
+    "cursor",
     "date",
     "decision",
+    "decision_id",
     "detail",
     "due",
+    "event_id",
     "expected_updated_at",
     "headline",
     "health",
@@ -221,10 +249,14 @@
     "kind",
     "limit",
     "manager_add",
+    "manager_add_decision",
     "manager_approve",
     "manager_archive",
     "manager_client",
     "manager_clients",
+    "manager_decide",
+    "manager_decide_tie",
+    "manager_decisions",
     "manager_dismiss",
     "manager_done",
     "manager_drop",
@@ -232,21 +264,27 @@
     "manager_home",
     "manager_link",
     "manager_list",
+    "manager_meetings",
     "manager_proposal",
     "manager_queue",
     "manager_reopen",
     "manager_run",
     "manager_set_summary",
     "manager_show",
+    "manager_tie",
     "manager_unarchive",
     "meeting_id",
     "needs_review",
     "next",
     "no_owner",
+    "note",
+    "note_id",
+    "occurrence_start",
     "overdue",
     "owner",
     "owner_name",
     "owners",
+    "page_size",
     "proposal_id",
     "request_id",
     "restore",
@@ -256,9 +294,12 @@
     "source_note",
     "source_url",
     "status",
+    "tie_id",
     "timeline",
     "title",
-    "version"
+    "verdict",
+    "version",
+    "why"
   ],
   "doorRefusedOperations": [
     "create_client",