@bli-cockpit/cli 0.2.242 → 0.2.244

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

@@ -14,6 +14,8 @@
  * behaves the way it looks, without demanding quotes.
  */
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, } from "./local-arg-values.js";
+import { DOC_SEARCH_BOOLEAN_FLAGS, DOC_SEARCH_VALUE_FLAGS, hasDocSearchFlags, readDocSearchFilters } from "./docs-search-args.js";
+import { hasMsgSearchFilterFlags, MSG_SEARCH_BOOLEAN_FLAGS, MSG_SEARCH_VALUE_FLAGS, readMsgSearchFilters } from "./msg-search-args.js";
 /**
  * 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
@@ -23,14 +25,11 @@ import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs,
  */
 export function parseSearchArgs(args) {
     const values = parseNamedArgs(args, {
-        allowedFlags: ["--home", "--dashboard-url", "--kind", "--limit", "--json", "--categories"],
-        valueFlags: ["--home", "--dashboard-url", "--kind", "--limit"],
+        allowedFlags: ["--home", "--dashboard-url", "--kind", "--limit", "--json", "--categories", "--from", "--timezone", ...MSG_SEARCH_VALUE_FLAGS, ...MSG_SEARCH_BOOLEAN_FLAGS, ...DOC_SEARCH_VALUE_FLAGS, ...DOC_SEARCH_BOOLEAN_FLAGS],
+        valueFlags: ["--home", "--dashboard-url", "--kind", "--limit", "--from", "--timezone", ...MSG_SEARCH_VALUE_FLAGS, ...DOC_SEARCH_VALUE_FLAGS],
     });
     const query = values.positionals.join(" ").trim();
     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) {
@@ -42,11 +41,39 @@ export function parseSearchArgs(args) {
         if (kinds.length === 0)
             kinds = undefined;
     }
+    const only = (kind) => Boolean(kinds && kinds.length === 1 && kinds[0] === kind);
+    // BLI-21697: with --kind doc, --by --under --since --until --timezone --sort --title-only --word filter documents.
+    const docFilters = readDocSearchFilters(values);
+    const docFiltered = hasDocSearchFlags(docFilters);
+    // BLI-21658: message filters, the same flags as `cockpit msg search`; only meaningful with --kind msg.
+    const msgFilters = readMsgSearchFilters(values);
+    const filtered = !only("doc") && hasMsgSearchFilterFlags(msgFilters);
+    const usedZone = values.flags.has("--timezone");
+    if (query.length === 0 && !categories && !filtered && !(only("doc") && docFiltered)) {
+        throw new Error('search needs something to search for, e.g. `cockpit search "storage ceiling"`.');
+    }
+    if (only("doc")) {
+        // Message-only flags have no meaning for documents.
+        if (values.flags.has("--in") || values.flags.has("--from") || values.booleans.has("--replies") || values.booleans.has("--top-level") || values.booleans.has("--has-file")) {
+            throw new Error("--in, --from, --replies, --top-level and --has-file filter messages; with --kind doc use --by, --under, --since, --until, --timezone, --sort, --title-only and --word.");
+        }
+    }
+    else {
+        const docOnly = ["--by", "--under", "--sort"].some((flag) => values.flags.has(flag)) || values.booleans.has("--title-only") || values.booleans.has("--word");
+        if (docOnly) {
+            throw new Error("--by, --under, --sort, --title-only and --word filter documents and need --kind doc, e.g. `cockpit search runbook --kind doc --by me`.");
+        }
+        if ((filtered || usedZone) && !only("msg")) {
+            throw new Error("--from, --in, --since, --until, --timezone, --replies, --top-level and --has-file filter messages and need --kind msg, e.g. `cockpit search deploy --kind msg --from me`. (Documents take --by, --under and --since with --kind doc.)");
+        }
+    }
     return {
         kind: "search",
         query,
         ...(categories ? { categories: true } : {}),
         ...(kinds ? { kinds } : {}),
+        ...(filtered ? { msgFilters } : {}),
+        ...(only("doc") && (docFiltered || usedZone) ? { docFilters } : {}),
         limit: optionalPositiveInteger(values.flags.get("--limit"), "--limit"),
         homeDir: optionalNonEmpty(values.flags.get("--home")),
         dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),

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

@@ -16,7 +16,13 @@
  * shared machine and lands in shell history).
  */
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, } from "./local-arg-values.js";
+import { RELATION_VALUE_FLAGS, readRelationFlags } from "./issue-relations.js";
 import { estimateForSize } from "./issue-contracts.js";
+import { INBOX_ACTIONS, INBOX_BOOLEAN_FLAGS, INBOX_VALUE_FLAGS, isInboxAction, parseInboxArgs } from "./inbox-args.js";
+import { NOTIFY_ACTIONS, NOTIFY_VALUE_FLAGS, isNotifyAction, parseNotifyArgs } from "./work-notify-args.js";
+import { VIEW_BOOLEAN_FLAGS, VIEW_VALUE_FLAGS, parseViewArgs } from "./view-args.js";
+import { parseTemplateArgs } from "./template-args.js";
+import { CYCLE_BOOLEAN_FLAGS, CYCLE_VALUE_FLAGS, parseCycleArgs, readCycleField } from "./cycle-args.js";
 const ISSUE_ACTIONS = new Set([
     "mutation-status",
     "board",
@@ -29,6 +35,15 @@ const ISSUE_ACTIONS = new Set([
     "history",
     "versions",
     "restore",
+    "label",
+    "batch",
+    "relations",
+    "relate",
+    "unrelate",
+    "views",
+    "templates", "cycles",
+    ...INBOX_ACTIONS,
+    ...NOTIFY_ACTIONS,
 ]);
 /** Every verb except `list` and `create` names ONE issue first. */
 const ISSUE_ACTIONS_NEEDING_AN_ISSUE = new Set([
@@ -40,6 +55,10 @@ const ISSUE_ACTIONS_NEEDING_AN_ISSUE = new Set([
     "history",
     "versions",
     "restore",
+    "label",
+    "relations",
+    "relate",
+    "unrelate",
 ]);
 /**
  * The closed state vocabulary, copied verbatim from
@@ -66,6 +85,9 @@ const ISSUE_ALLOWED_FLAGS = [
     "--priority",
     "--size",
     "--parent",
+    "--due",
+    "--add",
+    "--remove",
     "--file",
     "--version",
     "--cursor",
@@ -79,8 +101,15 @@ const ISSUE_ALLOWED_FLAGS = [
     "--all",
     "--body-stdin",
     "--json",
+    ...VIEW_BOOLEAN_FLAGS,
+    ...VIEW_VALUE_FLAGS,
+    ...INBOX_BOOLEAN_FLAGS,
+    ...INBOX_VALUE_FLAGS,
+    ...NOTIFY_VALUE_FLAGS,
+    ...RELATION_VALUE_FLAGS, ...CYCLE_VALUE_FLAGS, ...CYCLE_BOOLEAN_FLAGS,
 ];
 const ISSUE_VALUE_FLAGS = [
+    "--cycle",
     "--request-id",
     "--expected-revision",
     "--home",
@@ -95,6 +124,9 @@ const ISSUE_VALUE_FLAGS = [
     "--priority",
     "--size",
     "--parent",
+    "--due",
+    "--add",
+    "--remove",
     "--file",
     "--version",
     "--cursor",
@@ -105,6 +137,10 @@ const ISSUE_VALUE_FLAGS = [
     "--updated-before",
     "--sort",
     "--dir",
+    ...VIEW_VALUE_FLAGS,
+    ...INBOX_VALUE_FLAGS,
+    ...NOTIFY_VALUE_FLAGS,
+    ...RELATION_VALUE_FLAGS, ...CYCLE_VALUE_FLAGS,
 ];
 export function parseIssueArgs(args) {
     const values = parseNamedArgs(args, {
@@ -112,6 +148,25 @@ export function parseIssueArgs(args) {
         valueFlags: ISSUE_VALUE_FLAGS,
     });
     const { action, rest } = readIssueAction(values);
+    if (action === "views")
+        return parseViewArgs(values, rest);
+    if (action === "templates")
+        return parseTemplateArgs(values, rest);
+    if (action === "cycles")
+        return parseCycleArgs(values, rest);
+    if (isNotifyAction(action))
+        return parseNotifyArgs(values, rest);
+    if (isInboxAction(action))
+        return parseInboxArgs(values, action, rest);
+    const strayNotify = NOTIFY_VALUE_FLAGS.find((flag) => values.flags.has(flag));
+    if (strayNotify)
+        throw new Error(`${strayNotify} belongs to \`cockpit ticket notifications\`.`);
+    const strayInbox = [...INBOX_VALUE_FLAGS, ...INBOX_BOOLEAN_FLAGS].find((flag) => values.flags.has(flag) || values.booleans.has(flag));
+    if (strayInbox)
+        throw new Error(`${strayInbox} belongs to \`cockpit ticket inbox\`.`);
+    const stray = [...VIEW_VALUE_FLAGS, ...VIEW_BOOLEAN_FLAGS].find((flag) => values.flags.has(flag) || values.booleans.has(flag));
+    if (stray)
+        throw new Error(`${stray} belongs to \`cockpit ticket views\`.`);
     const { issueRef, issueRefs, moveState } = readIssueReference(action, rest);
     const requestId = optionalNonEmpty(values.flags.get("--request-id"));
     const expectedRevision = optionalPositiveInteger(values.flags.get("--expected-revision"), "--expected-revision");
@@ -119,11 +174,12 @@ export function parseIssueArgs(args) {
         throw new Error("--request-id must be a UUID.");
     if (action === "mutation-status" && !UUID_PATTERN.test(issueRef ?? ""))
         throw new Error("mutation-status needs a request UUID.");
-    if ((requestId || expectedRevision !== undefined) && !["create", "update", "move", "comment", "restore"].includes(action)) {
-        throw new Error("Write-safety flags belong to create, update, move, comment or restore.");
+    if ((requestId || expectedRevision !== undefined) && !["create", "update", "move", "comment", "restore", "label", "batch", "relate", "unrelate"].includes(action)) {
+        throw new Error("Write-safety flags belong to create, update, move, comment, restore, label, relate, unrelate or batch.");
     }
     validateIssueState(moveState, "issue move state must be one of: ");
     const stateFilter = readIssueStateFilter(action, values);
+    const fields = readIssueFields(action, values);
     const title = readIssueTitle(action, values);
     if (action !== "board" && values.flags.has("--rows")) {
         throw new Error("--rows widens cockpit tickets board only.");
@@ -140,7 +196,7 @@ export function parseIssueArgs(args) {
     const assignee = readIssueAssignee(action, values);
     const limit = readIssueLimit(action, values);
     const versionNumber = readIssueVersion(action, values);
-    return buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, estimate, assignee, limit, versionNumber, page);
+    return { ...buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, estimate, assignee, limit, versionNumber, page, fields), ...readRelationFlags(action, values) };
 }
 const INSTANT = /^\d{4}-\d\d-\d\d(?:T\d\d:\d\d:\d\d(?:\.\d{1,6})?(?:Z|[+-]\d\d:\d\d))?$/;
 /** BLI-21315: the cursor contract's flags. Filters and sort belong to `list`; `--cursor` also to `history`. */
@@ -190,7 +246,7 @@ function readIssueAction(values) {
     const first = values.positionals[0];
     const action = (first === undefined ? "list" : first);
     if (!ISSUE_ACTIONS.has(action)) {
-        throw new Error(`Unknown issue command: ${first}. Try board, list, show, create, update, move, comment, history, versions, restore, or mutation-status.`);
+        throw new Error(`Unknown issue command: ${first}. Try board, list, show, create, update, move, comment, label, relations, relate, unrelate, views, templates, cycles, inbox, read, unread, subscribe, unsubscribe, notifications, history, versions, restore, batch, or mutation-status.`);
     }
     return { action, rest: values.positionals.slice(first === undefined ? 0 : 1) };
 }
@@ -237,10 +293,11 @@ function validateIssueState(state, errorPrefix) {
 function readIssueStateFilter(action, values) {
     const stateFilter = optionalNonEmpty(values.flags.get("--state"));
     validateIssueState(stateFilter, "--state must be one of: ");
-    if (stateFilter !== undefined && action !== "list" && action !== "board") {
-        throw new Error("--state filters `cockpit issue list`; to move an issue use `cockpit issue move <id> <state>`.");
+    if (stateFilter !== undefined && action !== "list" && action !== "board" && action !== "create") {
+        throw new Error("--state filters `cockpit issue list` and sets the starting state on `create`; to move an issue use `cockpit issue move <id> <state>`.");
     }
-    return stateFilter;
+    // On create the same flag is the starting state; it is returned separately in readIssueFields.
+    return action === "create" ? undefined : stateFilter;
 }
 function readIssueTitle(action, values) {
     const title = optionalNonEmpty(values.flags.get("--title"));
@@ -270,14 +327,54 @@ function readIssueAssignee(action, values) {
     // email is refused HERE rather than travelling to Postgres as a malformed
     // uuid, which would come back as a 500 that names nothing useful.
     const assignee = optionalNonEmpty(values.flags.get("--assignee"));
-    if (assignee !== undefined && assignee !== "me" && assignee !== "unassigned" && !UUID_PATTERN.test(assignee)) {
-        throw new Error('--assignee must be "me", "unassigned", or a person\'s uuid (see `cockpit team`).');
+    if (assignee !== undefined && assignee !== "me" && assignee !== "unassigned" && assignee !== "none" && !UUID_PATTERN.test(assignee)) {
+        throw new Error('--assignee must be "me", "unassigned" (list), "none" (update), or a person\'s uuid (see `cockpit team`).');
     }
     if (assignee === "unassigned" && action !== "list" && action !== "board") {
-        throw new Error('--assignee unassigned filters `cockpit issue list`; to clear an assignee pass --assignee "" is not supported yet.');
+        throw new Error("--assignee unassigned filters `cockpit ticket list`; to clear an owner on update pass --assignee none.");
     }
+    if (assignee === "none" && action !== "update")
+        throw new Error("--assignee none clears the owner on `cockpit ticket update`.");
     return assignee;
 }
+const CALENDAR_DAY = /^\d{4}-\d{2}-\d{2}$/;
+/** BLI-21422: starting state, due date and label names. Omitted stays omitted; `none` is the only way to clear. */
+function readIssueFields(action, values) {
+    const out = {};
+    const startState = optionalNonEmpty(values.flags.get("--state"));
+    if (action === "create" && startState)
+        out.startState = startState;
+    const due = optionalNonEmpty(values.flags.get("--due"));
+    if (due !== undefined) {
+        if (action !== "create" && action !== "update")
+            throw new Error("--due belongs to `cockpit ticket create` and `update`.");
+        if (due === "none") {
+            if (action === "create")
+                throw new Error("--due none clears a date on `cockpit ticket update`; leave --due off to create without one.");
+            out.due = null;
+        }
+        else {
+            if (!CALENDAR_DAY.test(due) || new Date(`${due}T12:00:00Z`).toISOString().slice(0, 10) !== due) {
+                throw new Error("--due must be a calendar date as YYYY-MM-DD, or none to clear it (update).");
+            }
+            out.due = due;
+        }
+    }
+    const add = (values.flagValues.get("--add") ?? []).map((v) => v.trim()).filter(Boolean);
+    const remove = (values.flagValues.get("--remove") ?? []).map((v) => v.trim()).filter(Boolean);
+    if ((add.length > 0 || remove.length > 0) && action !== "label") {
+        throw new Error("--add and --remove belong to `cockpit ticket label <id>`.");
+    }
+    if (action === "label") {
+        if (add.length === 0 && remove.length === 0)
+            throw new Error("ticket label needs --add <name> and/or --remove <name> (repeat the flag for several).");
+        if (add.length > 50 || remove.length > 50)
+            throw new Error("ticket label changes at most 50 labels per side.");
+        out.addLabels = add;
+        out.removeLabels = remove;
+    }
+    return out;
+}
 /** `restore` names the version it wants; there is no "restore the previous one" (BLI-21300). */
 function readIssueVersion(action, values) {
     const version = optionalPositiveInteger(values.flags.get("--version"), "--version");
@@ -295,7 +392,7 @@ function readIssueLimit(action, values) {
     }
     return limit;
 }
-function buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, estimate, assignee, limit, versionNumber, page) {
+function buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, estimate, assignee, limit, versionNumber, page, fields) {
     return {
         kind: "issue",
         requestId: optionalNonEmpty(values.flags.get("--request-id")),
@@ -313,6 +410,7 @@ function buildIssueCommand(values, action, issueRef, issueRefs, moveState, state
         project: optionalNonEmpty(values.flags.get("--project")),
         ...(limit === undefined ? {} : { limit }),
         ...page,
+        ...fields, ...readCycleField(action, values),
         ...(versionNumber === undefined ? {} : { versionNumber }),
         title,
         ...(priority === undefined ? {} : { priority }),
@@ -323,26 +421,4 @@ function buildIssueCommand(values, action, issueRef, issueRefs, moveState, state
         json: values.booleans.has("--json"),
     };
 }
-export function parseProjectArgs(args) {
-    const values = parseNamedArgs(args, {
-        allowedFlags: ["--home", "--dashboard-url", "--archived", "--cursor", "--limit", "--json"],
-        valueFlags: ["--home", "--dashboard-url", "--cursor", "--limit"],
-    });
-    const first = values.positionals[0];
-    const action = (first === undefined ? "list" : first);
-    if (action !== "list")
-        throw new Error(`Unknown project command: ${first}. The only verb is list.`);
-    const rest = values.positionals.slice(first === undefined ? 0 : 1);
-    if (rest.length > 0)
-        throw new Error(`project list does not take "${rest[0]}".`);
-    return {
-        kind: "project",
-        action,
-        homeDir: optionalNonEmpty(values.flags.get("--home")),
-        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
-        includeArchived: values.booleans.has("--archived"),
-        ...(optionalNonEmpty(values.flags.get("--cursor")) ? { cursor: optionalNonEmpty(values.flags.get("--cursor")) } : {}),
-        ...(values.flags.has("--limit") ? { limit: optionalPositiveInteger(values.flags.get("--limit"), "--limit") } : {}),
-        json: values.booleans.has("--json"),
-    };
-}
+export { parseProjectArgs } from "./project-args.js";

package/dist/commands/local-auth.js

@@ -235,7 +235,7 @@ async function inferUniqueGitEmail(roots) {
 }
 async function readGitConfigEmail(root) {
     return new Promise((resolve) => {
-        execFile("git", ["config", "user.email"], { cwd: root, encoding: "utf8" }, (error, stdout) => {
+        execFile("git", ["config", "user.email"], { cwd: root, encoding: "utf8", windowsHide: true }, (error, stdout) => {
             if (error) {
                 resolve(null);
                 return;

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

@@ -174,6 +174,8 @@ export const TOWER_OPS_COMMAND_HELP = [
             "  cockpit approvals show <id>                 the card in full: who, why, the exact content, every receipt",
             "  cockpit approvals create                    prepare a card; the POST /api/approvals body as JSON on stdin",
             "  cockpit approvals approve <id> [--edit]     let the guarded act run; --edit reads {\"subject\":...,\"text\":...} or {\"content\":...} on stdin",
+            "      --checked-sent sent|not-sent              on a card whose delivery is unknown or stuck sending, what you found where it was going",
+            "                                                (your Sent folder for mail.send, the channel for msg.send): sent closes it, not-sent sends or posts it now",
             "  cockpit approvals edit <id> [--approve]     save an edit (JSON on stdin), the card stays waiting; --approve then approves it",
             "  cockpit approvals reject <id>               decline it; nothing is sent",
             "  cockpit approvals rules [--active true|false] [--limit <n>]",
@@ -224,10 +226,10 @@ export const TOWER_OPS_COMMAND_HELP = [
             "                                               \"YYYY-MM-DD: \" dates a bullet, without it the bullet is undated. none clears --next or --blocker. blocked needs a blocker (given, or already on the card),",
             "                                               and a blocker goes only on a Blocked card: sent with any other health it is refused (summary_blocker_needs_blocked); sending only a new health drops the stored one.",
             "                                               --version is summary.updatedAt from `home <client> --json`, or none when the client has no card yet (then --health, --headline and at least one --bullet are all needed).",
-            "                                               Limits: headline 140 characters, each bullet 160, next and blocker 200; a longer text is refused here with its length. A day spelled with a month name at the start of a bullet (\"Oct 3: x\") is refused, never saved undated. --version none is for a client with no card: on one that has a card the write is refused with \"This client already has a card: pass its version\". The edit is marked as yours and stands until the client's",
-            "                                               data changes, an action goes overdue or an open action passes 14 days overdue; the next check after that writes the card again (newest wins).",
+            "                                               Limits: headline 140 characters, each bullet 160, next and blocker 200; a longer text is refused here with its length. A day spelled with a month name at the start of a bullet (\"Oct 3: x\") is refused, never saved undated. --version none is for a client with no card: on one that has a card the write is refused with \"This client already has a card: pass its version\". The edit is stored as written by your agent",
+            "                                               (source agent, \"Written by <you>'s agent\"): Tower's check never rewrites it, whatever changes; your agent's next edit, or a person's on the page, replaces it.",
             "                                               A saved card that says On track while an open action is more than 14 days overdue is saved anyway and prints a \"Warning: ...\" line naming the action overdue longest.",
-            "                                               Write the card after your item writes: your own later item writes count as data changes, and the next check rewrites the card.",
+            "                                               Write the card after your item writes: the check will not rewrite it to take them in.",
             "                                               Health rule: an open action more than 14 days overdue, as `cockpit manager home` shows it (Tower's today, America/Vancouver), means the card is at_risk (or blocked, with a named blocker).",
             "                                               Do not set on_track over one; tell the person instead. The headline or a bullet must name the action overdue longest, with the day it was due.",
             "  cockpit manager list <client> [--timeline] [--needs-review] [--status open|done|dropped|closed|all] [--owner <name>|--no-owner] [--overdue] [--kind <kind>] [--search <text>] [--archived] [--review dismissed|all]",
@@ -259,7 +261,7 @@ export const TOWER_OPS_COMMAND_HELP = [
             "                                               --version and --timeline stay flags. A field given as a flag and in the file is refused, so is an unknown key. The file gets the flags' own checks. Example:  cat fields.json | cockpit manager summary Acme --version none --fields-file -",
             "Free text (the flags above and every value in a fields file) that holds a provider key (an sk-, rk_, sb_secret_, ghp_, github_pat_, AKIA/ASIA, xoxb- key, any JWT, a PEM private key) or a password given a value (\"password: x\") is refused, naming the flag or key; ordinary words, a commit sha, a URL and the words \"service-role key\" are plain text.",
             "On a flag, free text (--headline, --bullet, --title, --detail, --next, --blocker, --owners, --source-note) goes in SINGLE quotes so the shell leaves $ alone: \"$12k\" in double quotes loses the $12k (zsh and bash read it as a variable). In bash and zsh write an apostrophe inside single quotes as '\\'' (end the quote, a backslash-escaped apostrophe, reopen); in PowerShell double the apostrophe ('Rowan''s deck'). The command prints what it saved: check it is your words.",
-            "<client> is the client's id, or its exact name (any case; `clients` lists them); a name that matches no client, or several, is refused with the names. Ids and versions are printed by list, queue and show. Items you add are reviewed already.",
+            "<client> is the client's id, or its exact name (any case; `clients` lists them); a name that matches no client, or several, is refused with the names. Ids and versions are printed by list, queue and show. Items you add here are stored as added by your agent, not yet checked (they count in needs review until a person approves or dismisses them), never as you having checked them; text tagged [HR] is refused (item_hr_tagged, summary_hr_tagged).",
             "--version is the item's version exactly as list or show prints it, copied as it is. Every change to an existing item names it: if someone or a sync changed the item",
             "since, the write is refused with a sentence saying so and nothing is written; run show again for the new version and retry.",
             "--owners on an action takes, as the web form says, \"One or more people, separated by commas\" (\"Rowan Ash, Juniper Twig\"), and it REPLACES the whole list. Leave it out and the owners stay;",