@bli-cockpit/cli 0.2.242 → 0.2.243

package/dist/commands/template-args.js

@@ -0,0 +1,122 @@
+/**
+ * `cockpit ticket templates [list|show|versions|save|update|apply]` argument parsing (BLI-21779, P11).
+ * `templates` is an `issue` action; its flags are read here so `local-args-tower-work.ts` only dispatches,
+ * the way `view-args.ts` does for views.
+ *
+ * Property flags mean the same on save, update and apply: `--description <text|->` (`-` reads stdin),
+ * `--state`, `--priority 0-4`, `--size S|M|L`, `--project <name|id>`, `--label <name>` (repeatable).
+ * On save and update, the value `none` clears a preset; on apply, `none` clears what the template would
+ * have copied. Nothing here carries a title except `apply`, and nothing stores one.
+ */
+import { estimateForSize } from "./issue-contracts.js";
+import { optionalNonEmpty, optionalUrl } from "./local-arg-values.js";
+export const TEMPLATE_VERBS = ["list", "show", "versions", "save", "update", "apply"];
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const STATES = ["backlog", "todo", "in_progress", "in_review", "done", "canceled"];
+const NONE = (value) => value.trim().toLowerCase() === "none";
+export function parseTemplateArgs(values, rest) {
+    const first = rest[0];
+    const verb = (first === undefined ? "list" : first);
+    if (!TEMPLATE_VERBS.includes(verb)) {
+        throw new Error(`Unknown templates command: ${first}. Try list, show, versions, save, update or apply.`);
+    }
+    const positional = rest.slice(first === undefined ? 0 : 1);
+    const needsRef = verb !== "list" && verb !== "save";
+    if (needsRef && positional.length !== 1)
+        throw new Error(`ticket templates ${verb} takes exactly one template id or name.`);
+    if (!needsRef && positional.length > 0)
+        throw new Error(`ticket templates ${verb} does not take "${positional[0]}".`);
+    const given = (flag) => values.flags.has(flag) || values.booleans.has(flag);
+    const writes = verb === "save" || verb === "update" || verb === "apply";
+    for (const flag of ["--description", "--state", "--priority", "--size", "--project", "--label"]) {
+        if (given(flag) && !writes)
+            throw new Error(`${flag} belongs to \`cockpit ticket templates save\`, \`update\` and \`apply\`.`);
+    }
+    if (given("--name") && verb !== "save" && verb !== "update")
+        throw new Error("--name belongs to `cockpit ticket templates save` and `update`.");
+    if (verb !== "update" && (given("--archive") || given("--restore") || given("--expected-updated-at"))) {
+        throw new Error("--archive, --restore and --expected-updated-at belong to `cockpit ticket templates update`.");
+    }
+    if (verb !== "apply" && (given("--title") || given("--assignee") || given("--parent") || given("--due"))) {
+        throw new Error("--title, --assignee, --parent and --due belong to `cockpit ticket templates apply`; a template never stores them.");
+    }
+    if (verb !== "list" && given("--include-archived"))
+        throw new Error("--include-archived belongs to `cockpit ticket templates list`.");
+    if (given("--archive") && given("--restore"))
+        throw new Error("Give --archive or --restore, not both.");
+    if ((verb === "save" || verb === "apply") === false && given("--request-id")) {
+        throw new Error("--request-id belongs to `cockpit ticket templates save` and `apply`.");
+    }
+    if (given("--expected-revision") || given("--limit") || given("--shared") || given("--private")) {
+        throw new Error("That flag does not belong to ticket templates.");
+    }
+    const name = optionalNonEmpty(values.flags.get("--name"));
+    if (verb === "save" && !name)
+        throw new Error('ticket templates save needs --name "<name>".');
+    const rawDescription = values.flags.get("--description");
+    const rawState = optionalNonEmpty(values.flags.get("--state"));
+    if (rawState && !NONE(rawState) && !STATES.includes(rawState))
+        throw new Error(`--state must be one of: ${STATES.join(", ")} (or none).`);
+    const rawPriority = optionalNonEmpty(values.flags.get("--priority"));
+    let priority;
+    if (rawPriority !== undefined) {
+        if (NONE(rawPriority))
+            priority = null;
+        else {
+            priority = Number(rawPriority);
+            if (!Number.isInteger(priority) || priority < 0 || priority > 4) {
+                throw new Error("--priority must be 0-4 (0 none, 1 urgent, 2 high, 3 medium, 4 low), or the word none to clear it.");
+            }
+        }
+    }
+    const rawSize = optionalNonEmpty(values.flags.get("--size"));
+    const estimate = rawSize === undefined ? undefined : NONE(rawSize) ? null : estimateForSize(rawSize);
+    const rawProject = optionalNonEmpty(values.flags.get("--project"));
+    const labelValues = (values.flagValues.get("--label") ?? []).map((v) => v.trim()).filter(Boolean);
+    const labels = labelValues.length === 1 && NONE(labelValues[0]) ? [] : labelValues;
+    const assignee = optionalNonEmpty(values.flags.get("--assignee"));
+    if (assignee !== undefined && assignee !== "me" && !UUID.test(assignee))
+        throw new Error('--assignee must be "me" or a person\'s uuid.');
+    const due = optionalNonEmpty(values.flags.get("--due"));
+    if (due && !NONE(due) && !/^\d{4}-\d{2}-\d{2}$/.test(due))
+        throw new Error("--due must be YYYY-MM-DD (or none).");
+    const expectedUpdatedAt = optionalNonEmpty(values.flags.get("--expected-updated-at"));
+    if (expectedUpdatedAt && Number.isNaN(Date.parse(expectedUpdatedAt))) {
+        throw new Error("--expected-updated-at must be the updated_at timestamp you last read.");
+    }
+    const requestId = optionalNonEmpty(values.flags.get("--request-id"));
+    if (requestId && !UUID.test(requestId))
+        throw new Error("--request-id must be a UUID.");
+    const changes = rawDescription !== undefined || rawState !== undefined || priority !== undefined || estimate !== undefined
+        || rawProject !== undefined || labelValues.length > 0 || name !== undefined;
+    if (verb === "update" && !changes && !given("--archive") && !given("--restore")) {
+        throw new Error("ticket templates update needs a field to change: --name, --description, --state, --priority, --size, --project, --label, --archive or --restore.");
+    }
+    const templates = {
+        verb,
+        ...(needsRef ? { ref: positional[0] } : {}),
+        ...(name ? { name } : {}),
+        ...(rawDescription === undefined ? {} : { description: NONE(rawDescription) ? null : rawDescription }),
+        ...(rawState === undefined ? {} : { state: NONE(rawState) ? null : rawState }),
+        ...(priority === undefined ? {} : { priority }),
+        ...(estimate === undefined ? {} : { estimate }),
+        ...(rawProject === undefined ? {} : { project: NONE(rawProject) ? null : rawProject }),
+        ...(labelValues.length > 0 ? { labels } : {}),
+        ...(optionalNonEmpty(values.flags.get("--title")) ? { title: optionalNonEmpty(values.flags.get("--title")) } : {}),
+        ...(assignee ? { assignee } : {}),
+        ...(optionalNonEmpty(values.flags.get("--parent")) ? { parentRef: optionalNonEmpty(values.flags.get("--parent")) } : {}),
+        ...(due === undefined ? {} : { due: NONE(due) ? null : due }),
+        ...(given("--archive") ? { archived: true } : given("--restore") ? { archived: false } : {}),
+        ...(given("--include-archived") ? { includeArchived: true } : {}),
+        ...(expectedUpdatedAt ? { expectedUpdatedAt } : {}),
+    };
+    return {
+        kind: "issue",
+        action: "templates",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        ...(requestId ? { requestId } : {}),
+        json: values.booleans.has("--json"),
+        templates,
+    };
+}

package/dist/commands/templates.js

@@ -0,0 +1,162 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor } from "./agent-door.js";
+import { isInteractiveStdin, readPipedText, writeLine } from "./cli-io.js";
+import { BODY_MAX_CHARS, READ_DEADLINE_MS, WRITE_DEADLINE_MS, resolveRefs, sizeForEstimate } from "./issue-contracts.js";
+const TAG = "[ticket templates cli]";
+const presetText = (t) => {
+    const parts = [];
+    if (t.state)
+        parts.push(`state ${t.state}`);
+    if (t.priority !== null)
+        parts.push(`priority ${t.priority}`);
+    if (t.estimate !== null)
+        parts.push(`size ${sizeForEstimate(t.estimate) ?? t.estimate}`);
+    if (t.project_id)
+        parts.push(`project ${t.project_id}`);
+    if (t.label_names.length > 0)
+        parts.push(`labels ${t.label_names.join(", ")}`);
+    return parts.length === 0 ? "no presets" : parts.join(", ");
+};
+const templateLine = (t) => `${t.id}  ${t.name}  [v${t.version}${t.archived_at ? ", archived" : ""}${t.mine ? ", yours" : ""}]  ${presetText(t)}`;
+/** `--json` rows get a `size` letter beside the raw estimate, like every ticket read. */
+const withSize = (row) => ({ ...row, size: sizeForEstimate(row.estimate ?? null) });
+export async function runTemplates(command, io, door) {
+    const t = command.templates;
+    const ref = t.ref ? encodeURIComponent(t.ref) : "";
+    switch (t.verb) {
+        case "list": {
+            const answer = await askAgentDoor(door, {
+                path: `/api/work/templates${t.includeArchived ? "?include_archived=true" : ""}`,
+                method: "GET", label: "ticket templates list", timeoutMs: READ_DEADLINE_MS,
+            });
+            if (!answer.ok)
+                return failAgentDoor(door, TAG, answer.reason, answer.detail);
+            const body = answer.body;
+            const templates = body.templates ?? [];
+            if (door.json)
+                return emitAgentDoor(door, { ok: true, ...body, templates: templates.map(withSize) });
+            if (templates.length === 0)
+                writeLine(door.io.stdout, "No templates yet. Save one with `cockpit ticket templates save --name <name>`.");
+            for (const row of templates)
+                writeLine(door.io.stdout, templateLine(row));
+            if (body.archived_hidden)
+                writeLine(door.io.stdout, `\n${body.archived_hidden} archived template(s) not shown (--include-archived).`);
+            return 0;
+        }
+        case "show": {
+            const answer = await askAgentDoor(door, { path: `/api/work/templates/${ref}`, method: "GET", label: "ticket templates show", 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, { ok: true, template: withSize(body.template) });
+            const row = body.template;
+            writeLine(door.io.stdout, templateLine(row));
+            writeLine(door.io.stdout, row.description ? `\n${row.description}` : "\n(no description)");
+            return 0;
+        }
+        case "versions": {
+            const answer = await askAgentDoor(door, { path: `/api/work/templates/${ref}/versions`, method: "GET", label: "ticket templates versions", 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, { ok: true, ...body, template: withSize(body.template), versions: (body.versions ?? []).map((v) => withSize(v)) });
+            writeLine(door.io.stdout, `${body.template.name}: ${body.versions?.length ?? 0} version(s), current v${body.template.version}.`);
+            for (const v of body.versions ?? [])
+                writeLine(door.io.stdout, `v${v.version}  ${v.created_at}  ${v.name}${v.archived ? "  (archived)" : ""}`);
+            return 0;
+        }
+        case "save":
+        case "update":
+            return writeTemplate(command, io, door, ref);
+        case "apply":
+            return applyTemplate(command, io, door, ref);
+    }
+}
+/** `--description -` reads the text from stdin; anything else is the text itself. */
+async function readDescription(value, io) {
+    if (value !== "-")
+        return { ok: true, text: value };
+    if (isInteractiveStdin(io))
+        return { ok: false, detail: "--description - reads the text from stdin, and nothing is piped in." };
+    try {
+        return { ok: true, text: await readPipedText(io.stdin, { maxChars: BODY_MAX_CHARS, overflowMessage: `A template description is limited to ${BODY_MAX_CHARS} characters.` }) };
+    }
+    catch (error) {
+        return { ok: false, detail: error instanceof Error ? error.message : String(error) };
+    }
+}
+async function writeTemplate(command, io, door, ref) {
+    const t = command.templates;
+    const description = await readDescription(t.description, io);
+    if (!description.ok)
+        return failAgentDoor(door, TAG, "invalid_body", description.detail);
+    const payload = {
+        ...(t.verb === "save" && command.requestId ? { request_id: command.requestId } : {}),
+        ...(t.verb === "update" && t.expectedUpdatedAt ? { expected_updated_at: t.expectedUpdatedAt } : {}),
+        ...(t.name === undefined ? {} : { name: t.name }),
+        ...(description.text === undefined ? {} : { description: description.text }),
+        ...(t.state === undefined ? {} : { state: t.state }),
+        ...(t.priority === undefined ? {} : { priority: t.priority }),
+        ...(t.estimate === undefined ? {} : { estimate: t.estimate }),
+        ...(t.project === undefined ? {} : { project: t.project }),
+        ...(t.labels ? { label_names: t.labels } : {}),
+        ...(t.archived === undefined ? {} : { archived: t.archived }),
+    };
+    const answer = await askAgentDoor(door, {
+        path: t.verb === "save" ? "/api/work/templates" : `/api/work/templates/${ref}`,
+        method: t.verb === "save" ? "POST" : "PATCH",
+        label: `ticket templates ${t.verb}`,
+        timeoutMs: WRITE_DEADLINE_MS,
+        body: payload,
+    });
+    if (!answer.ok) {
+        const mutation = answer.body?.mutation;
+        return failAgentDoor(door, TAG, answer.reason, answer.detail, mutation ? { mutation } : {});
+    }
+    const body = answer.body;
+    console.error(`${TAG} ${t.verb} done`, JSON.stringify({ template_id: body.template.id, version: body.template.version, replayed: Boolean(body.replayed) }));
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...body, template: withSize(body.template) });
+    writeLine(door.io.stdout, `${t.verb === "save" ? (body.replayed ? "Already saved" : "Saved") : "Updated"}: ${body.template.name} (${body.template.id}), version ${body.template.version}${body.template.archived_at ? ", archived" : ""}.`);
+    return 0;
+}
+async function applyTemplate(command, io, door, ref) {
+    const t = command.templates;
+    const description = await readDescription(t.description, io);
+    if (!description.ok)
+        return failAgentDoor(door, TAG, "invalid_body", description.detail);
+    // A project name or a parent identifier is resolved to ids here, the way `ticket create` does.
+    const refs = await resolveRefs({ project: t.project ?? undefined, parentRef: t.parentRef }, door);
+    if (!refs.ok)
+        return failAgentDoor(door, TAG, refs.reason, refs.detail);
+    const payload = {
+        ...(command.requestId ? { request_id: command.requestId } : {}),
+        ...(t.title ? { title: t.title } : {}),
+        ...(description.text === undefined ? {} : { description: description.text }),
+        ...(t.state === undefined ? {} : { state: t.state }),
+        ...(t.priority === undefined ? {} : { priority: t.priority }),
+        ...(t.estimate === undefined ? {} : { estimate: t.estimate }),
+        ...(t.project === null ? { project_id: null } : refs.projectId ? { project_id: refs.projectId } : {}),
+        ...(t.labels ? { labels: t.labels } : {}),
+        ...(t.assignee ? { assignee_id: t.assignee } : {}),
+        ...(refs.parentId ? { parent_id: refs.parentId } : {}),
+        ...(t.due === undefined ? {} : { due_date: t.due }),
+    };
+    const answer = await askAgentDoor(door, {
+        path: `/api/work/templates/${ref}/apply`, method: "POST", label: "ticket templates apply", timeoutMs: WRITE_DEADLINE_MS, body: payload,
+    });
+    if (!answer.ok) {
+        const mutation = answer.body?.mutation;
+        return failAgentDoor(door, TAG, answer.reason, answer.detail, mutation ? { mutation } : {});
+    }
+    const body = answer.body;
+    console.error(`${TAG} apply done`, JSON.stringify({ template_id: body.template?.id, version: body.template?.version, labels: body.labels?.status }));
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...body, issue: withSize(body.issue) });
+    writeLine(door.io.stdout, `Created ${body.issue.identifier ?? ""} from template v${body.template?.version ?? "?"}: ${body.issue.title ?? ""}`);
+    if (body.labels?.status === "failed") {
+        writeLine(door.io.stderr, `The ticket exists but its labels (${(body.labels.names ?? []).join(", ")}) were not applied: ${body.labels.reason}. Add them with \`cockpit ticket label\`.`);
+    }
+    return 0;
+}

package/dist/commands/view-args.js

@@ -0,0 +1,131 @@
+/**
+ * `cockpit ticket views [list|show|save|update|favorite|unfavorite|settings]` argument parsing
+ * (BLI-21686, P8). `views` is an `issue` action; its flags are read here so `local-args-tower-work.ts`
+ * only lists their names, the way `issue-relations.ts` does for relations.
+ */
+import { optionalNonEmpty, optionalUrl } from "./local-arg-values.js";
+export const VIEW_VALUE_FLAGS = ["--name", "--layout", "--hide", "--show", "--expected-updated-at", "--description"];
+export const VIEW_BOOLEAN_FLAGS = ["--shared", "--private", "--archive", "--restore", "--include-archived"];
+export const VIEW_FIELDS = ["priority", "labels", "project", "assignee", "updated"];
+const VIEW_VERBS = ["list", "show", "save", "update", "favorite", "unfavorite", "settings"];
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const STATES = ["backlog", "todo", "in_progress", "in_review", "done", "canceled"];
+function listOf(values, flag) {
+    return (values.flagValues.get(flag) ?? []).map((v) => v.trim()).filter(Boolean);
+}
+export function parseViewArgs(values, rest) {
+    const first = rest[0];
+    const verb = (first === undefined ? "list" : first);
+    if (!VIEW_VERBS.includes(verb)) {
+        throw new Error(`Unknown views command: ${first}. Try list, show, save, update, favorite, unfavorite or settings.`);
+    }
+    const positional = rest.slice(first === undefined ? 0 : 1);
+    const needsRef = verb === "show" || verb === "update" || verb === "favorite" || verb === "unfavorite";
+    if (needsRef && positional.length !== 1)
+        throw new Error(`ticket views ${verb} takes exactly one view id or name.`);
+    if (!needsRef && positional.length > 0)
+        throw new Error(`ticket views ${verb} does not take "${positional[0]}".`);
+    const given = (flag) => values.flags.has(flag) || values.booleans.has(flag);
+    const definitionFlags = ["--name", "--description", "--state", "--assignee", "--project", "--label", "--q", "--layout", "--sort", "--dir", "--shared", "--private"];
+    const writes = verb === "save" || verb === "update";
+    for (const flag of definitionFlags) {
+        if (given(flag) && !writes)
+            throw new Error(`${flag} belongs to \`cockpit ticket views save\` and \`update\`.`);
+    }
+    if (!writes && (given("--archive") || given("--restore") || given("--expected-updated-at"))) {
+        throw new Error("--archive, --restore and --expected-updated-at belong to `cockpit ticket views update`.");
+    }
+    if (verb === "save" && (given("--archive") || given("--restore") || given("--expected-updated-at"))) {
+        throw new Error("save takes --shared (or nothing for private); --archive, --restore and --expected-updated-at belong to `update`.");
+    }
+    if (given("--include-archived"))
+        throw new Error("--include-archived belongs to `cockpit ticket templates list`.");
+    if (verb !== "save" && given("--request-id"))
+        throw new Error("--request-id belongs to `cockpit ticket views save`.");
+    if (given("--private") && given("--shared"))
+        throw new Error("Give --shared or --private, not both.");
+    if (given("--archive") && given("--restore"))
+        throw new Error("Give --archive or --restore, not both.");
+    if (verb !== "settings" && (given("--hide") || given("--show")))
+        throw new Error("--hide and --show belong to `cockpit ticket views settings`.");
+    if (verb === "list" || verb === "show" || verb === "favorite" || verb === "unfavorite" || verb === "settings") {
+        if (given("--expected-revision") || given("--limit"))
+            throw new Error("That flag does not belong to ticket views.");
+    }
+    const name = optionalNonEmpty(values.flags.get("--name"));
+    if (verb === "save" && !name)
+        throw new Error('ticket views save needs --name "<name>".');
+    const filters = {};
+    const state = optionalNonEmpty(values.flags.get("--state"));
+    if (state) {
+        if (!STATES.includes(state))
+            throw new Error(`--state must be one of: ${STATES.join(", ")}.`);
+        filters["state"] = state;
+    }
+    const assignee = optionalNonEmpty(values.flags.get("--assignee"));
+    if (assignee) {
+        if (assignee !== "me" && assignee !== "unassigned" && !UUID.test(assignee)) {
+            throw new Error('--assignee must be "me", "unassigned" or a person\'s uuid. "me" stays "me" and means whoever opens the view.');
+        }
+        filters["assignee"] = assignee;
+    }
+    for (const [flag, key] of [["--project", "project"], ["--label", "label"], ["--q", "q"]]) {
+        const value = optionalNonEmpty(values.flags.get(flag));
+        if (value)
+            filters[key] = value;
+    }
+    const layout = optionalNonEmpty(values.flags.get("--layout"));
+    if (layout && layout !== "list" && layout !== "board")
+        throw new Error("--layout must be list or board.");
+    const sort = optionalNonEmpty(values.flags.get("--sort"));
+    if (sort && sort !== "updated_at" && sort !== "created_at")
+        throw new Error("--sort must be updated_at or created_at.");
+    const dir = optionalNonEmpty(values.flags.get("--dir"));
+    if (dir && dir !== "asc" && dir !== "desc")
+        throw new Error("--dir must be asc or desc.");
+    const expectedUpdatedAt = optionalNonEmpty(values.flags.get("--expected-updated-at"));
+    if (expectedUpdatedAt && Number.isNaN(Date.parse(expectedUpdatedAt))) {
+        throw new Error("--expected-updated-at must be the updated_at timestamp you last read.");
+    }
+    const requestId = optionalNonEmpty(values.flags.get("--request-id"));
+    if (requestId && !UUID.test(requestId))
+        throw new Error("--request-id must be a UUID.");
+    const rawDescription = values.flags.get("--description");
+    const hide = listOf(values, "--hide");
+    const show = listOf(values, "--show");
+    for (const field of [...hide, ...show]) {
+        if (!VIEW_FIELDS.includes(field))
+            throw new Error(`"${field}" is not a field. Use ${VIEW_FIELDS.join(", ")}.`);
+    }
+    if (verb === "settings" && (hide.length === 0 && show.length === 0) === false && hide.some((f) => show.includes(f))) {
+        throw new Error("A field cannot be in both --hide and --show.");
+    }
+    if (verb === "update" && !name && rawDescription === undefined && Object.keys(filters).length === 0 && !layout && !sort && !dir
+        && !given("--shared") && !given("--private") && !given("--archive") && !given("--restore")) {
+        throw new Error("ticket views update needs a field to change: --name, a filter, --layout, --sort, --dir, --shared, --private, --archive or --restore.");
+    }
+    const views = {
+        verb,
+        ...(needsRef ? { ref: positional[0] } : {}),
+        ...(name ? { name } : {}),
+        ...(rawDescription === undefined ? {} : { description: rawDescription.trim().toLowerCase() === "none" ? null : rawDescription }),
+        ...(Object.keys(filters).length > 0 ? { filters } : {}),
+        ...(layout ? { layout } : {}),
+        ...(sort ? { sort } : {}),
+        ...(dir ? { dir } : {}),
+        ...(given("--shared") ? { visibility: "shared" } : given("--private") ? { visibility: "private" } : {}),
+        ...(given("--archive") ? { archived: true } : given("--restore") ? { archived: false } : {}),
+        ...(expectedUpdatedAt ? { expectedUpdatedAt } : {}),
+        ...(hide.length > 0 ? { hide } : {}),
+        ...(show.length > 0 ? { show } : {}),
+    };
+    return {
+        kind: "issue",
+        action: "views",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        ...(requestId ? { requestId } : {}),
+        json: values.booleans.has("--json"),
+        views,
+    };
+}

package/dist/commands/views.js

@@ -0,0 +1,138 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+import { pageFieldsOf, pageFooter } from "./issue-list-page.js";
+import { READ_DEADLINE_MS, WRITE_DEADLINE_MS } from "./issue-contracts.js";
+const TAG = "[ticket views cli]";
+const filterText = (filters) => {
+    const parts = Object.entries(filters).map(([key, value]) => `${key}=${value}`);
+    return parts.length === 0 ? "no filters" : parts.join(" ");
+};
+const viewLine = (view) => `${view.id}  ${view.name}  [${view.preset ? "built in" : view.visibility}${view.archived_at ? ", archived" : ""}${view.favorite ? ", favorite" : ""}]  ${filterText(view.filters)}`;
+export async function runViews(command, io, door) {
+    void io;
+    const views = command.views;
+    const ref = views.ref ? encodeURIComponent(views.ref) : "";
+    switch (views.verb) {
+        case "list":
+            return listViews(door, command);
+        case "show":
+            return showView(door, ref, views.ref ?? "");
+        case "favorite":
+        case "unfavorite": {
+            const answer = await askAgentDoor(door, {
+                path: `/api/work/views/${ref}/favorite`,
+                method: views.verb === "favorite" ? "POST" : "DELETE",
+                label: `ticket views ${views.verb}`,
+                timeoutMs: WRITE_DEADLINE_MS,
+            });
+            if (!answer.ok)
+                return failAgentDoor(door, TAG, answer.reason, answer.detail);
+            const body = answer.body;
+            console.error(`${TAG} ${views.verb} done`, JSON.stringify({ view_id: body.view?.id ?? views.ref, count: body.favorite_view_ids?.length ?? 0 }));
+            if (door.json)
+                return emitAgentDoor(door, { ok: true, ...body });
+            writeLine(door.io.stdout, `${views.verb === "favorite" ? "Favorited" : "Removed from favorites"}: ${body.view?.name ?? views.ref}. ${body.favorite_view_ids?.length ?? 0} favorite(s).`);
+            return 0;
+        }
+        case "settings":
+            return settings(door, command);
+        case "save":
+        case "update":
+            return writeView(door, command, ref);
+    }
+}
+async function listViews(door, command) {
+    void command;
+    const answer = await askAgentDoor(door, { path: "/api/work/views", method: "GET", label: "ticket views list", 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, { ok: true, ...body });
+    const out = door.io.stdout;
+    if (body.my_work)
+        writeLine(out, viewLine(body.my_work));
+    for (const [title, rows] of [["Favorites", body.favorites], ["Mine", body.mine], ["Shared", body.shared]]) {
+        if (!rows || rows.length === 0)
+            continue;
+        writeLine(out, "");
+        writeLine(out, `${title}:`);
+        for (const view of rows)
+            writeLine(out, viewLine(view));
+    }
+    if (body.favorites_hidden)
+        writeLine(out, `\n${body.favorites_hidden} favorite(s) are not shown: archived, private to someone else or gone.`);
+    return 0;
+}
+async function showView(door, ref, label) {
+    const answer = await askAgentDoor(door, { path: `/api/work/views/${ref}`, method: "GET", label: "ticket views show", 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, { ok: true, ...body, ...pageFieldsOf(body) });
+    const out = door.io.stdout;
+    const view = body.view;
+    writeLine(out, `${view?.name ?? label}  (${view?.preset ? "built in" : view?.visibility}, ${view?.layout}, ${view?.sort} ${view?.dir})`);
+    writeLine(out, `Filters: ${filterText(view?.filters ?? {})}${view?.filters?.["assignee"] === "me" ? "  (me is you)" : ""}`);
+    for (const issue of body.issues ?? [])
+        writeLine(out, `${(issue.identifier ?? "").padEnd(9)}  ${(issue.state ?? "").padEnd(11)}  ${issue.title ?? ""}`);
+    const footer = pageFooter(body, "tickets");
+    if (footer)
+        writeLine(out, footer);
+    if (body.href)
+        writeLine(out, `Open on the web: ${body.href}`);
+    return 0;
+}
+async function settings(door, command) {
+    const { hide, show } = command.views;
+    const changing = Boolean(hide?.length || show?.length);
+    const answer = await askAgentDoor(door, {
+        path: "/api/work/view-settings",
+        method: changing ? "PATCH" : "GET",
+        label: "ticket views settings",
+        timeoutMs: changing ? WRITE_DEADLINE_MS : READ_DEADLINE_MS,
+        ...(changing ? { body: { ...(hide?.length ? { hide } : {}), ...(show?.length ? { show } : {}) } } : {}),
+    });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    const body = answer.body;
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...body });
+    writeLine(door.io.stdout, `Hidden fields on your ticket rows: ${body.hidden_fields?.length ? body.hidden_fields.join(", ") : "none"}. Fields: ${(body.available_fields ?? []).join(", ")}.`);
+    return 0;
+}
+async function writeView(door, command, ref) {
+    const v = command.views;
+    const payload = {
+        ...(v.verb === "save" && command.requestId ? { request_id: command.requestId } : {}),
+        ...(v.verb === "update" && v.expectedUpdatedAt ? { expected_updated_at: v.expectedUpdatedAt } : {}),
+        ...(v.name === undefined ? {} : { name: v.name }),
+        ...(v.description === undefined ? {} : { description: v.description }),
+        ...(v.filters ? { filters: v.filters } : {}),
+        ...(v.layout ? { layout: v.layout } : {}),
+        ...(v.sort ? { sort: v.sort } : {}),
+        ...(v.dir ? { dir: v.dir } : {}),
+        ...(v.visibility ? { visibility: v.visibility } : {}),
+        ...(v.archived === undefined ? {} : { archived: v.archived }),
+    };
+    const answer = await askAgentDoor(door, {
+        path: v.verb === "save" ? "/api/work/views" : `/api/work/views/${ref}`,
+        method: v.verb === "save" ? "POST" : "PATCH",
+        label: `ticket views ${v.verb}`,
+        timeoutMs: WRITE_DEADLINE_MS,
+        body: payload,
+    });
+    if (!answer.ok) {
+        const mutation = answer.body?.mutation;
+        return failAgentDoor(door, TAG, answer.reason, answer.detail, mutation ? { mutation } : {});
+    }
+    const body = answer.body;
+    console.error(`${TAG} ${v.verb} done`, JSON.stringify({ view_id: body.view?.id, replayed: Boolean(body.replayed) }));
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...body });
+    writeLine(door.io.stdout, `${v.verb === "save" ? (body.replayed ? "Already saved" : "Saved") : "Updated"}: ${body.view?.name ?? ""} (${body.view?.id ?? ""}), ${body.view?.visibility ?? ""}${body.view?.archived_at ? ", archived" : ""}.`);
+    if (body.view?.href)
+        writeLine(door.io.stdout, `Open on the web: ${body.view.href}`);
+    return 0;
+}

package/dist/commands/work-notify-args.js

@@ -0,0 +1,67 @@
+/**
+ * `cockpit ticket notifications [set|receipts]` argument parsing (BLI-21736, P10). An `issue` action; its flags are
+ * read here so `local-args-tower-work.ts` only lists the names.
+ */
+import { optionalNonEmpty, optionalPositiveInteger, optionalUrl } from "./local-arg-values.js";
+export const NOTIFY_ACTIONS = ["notifications"];
+export const NOTIFY_VALUE_FLAGS = ["--slack", "--notification"];
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function isNotifyAction(action) {
+    return NOTIFY_ACTIONS.includes(action);
+}
+export function parseNotifyArgs(values, rest) {
+    const given = (flag) => values.flags.has(flag) || values.booleans.has(flag);
+    const word = rest[0];
+    if (word !== undefined && word !== "set" && word !== "receipts") {
+        throw new Error(`ticket notifications does not take "${word.slice(0, 40)}". Try: notifications, notifications set --slack on|off, notifications receipts.`);
+    }
+    if (rest.length > 1)
+        throw new Error(`ticket notifications ${word} takes no further arguments.`);
+    for (const flag of ["--request-id", "--expected-revision", "--all", "--kind", "--unread"]) {
+        if (given(flag))
+            throw new Error(`${flag} does not apply to \`cockpit ticket notifications\`.`);
+    }
+    const notify = { sub: word === "set" ? "set" : word === "receipts" ? "receipts" : "show" };
+    const onlyFor = (flags, sub) => {
+        for (const flag of flags)
+            if (given(flag))
+                throw new Error(`${flag} belongs to \`cockpit ticket notifications ${sub}\`.`);
+    };
+    if (notify.sub === "set") {
+        onlyFor(["--notification", "--before", "--limit"], "receipts");
+        const slack = optionalNonEmpty(values.flags.get("--slack"));
+        if (slack !== "on" && slack !== "off")
+            throw new Error("ticket notifications set needs --slack on or --slack off.");
+        notify.slackEnabled = slack === "on";
+    }
+    else if (notify.sub === "receipts") {
+        onlyFor(["--slack"], "set");
+        const notification = optionalNonEmpty(values.flags.get("--notification"));
+        if (notification) {
+            if (!UUID.test(notification))
+                throw new Error("--notification must be a notification id. Copy it from `cockpit ticket inbox --json`.");
+            notify.notification = notification;
+        }
+        const before = optionalNonEmpty(values.flags.get("--before"));
+        if (before)
+            notify.before = before;
+        const limit = optionalPositiveInteger(values.flags.get("--limit"), "--limit");
+        if (limit !== undefined) {
+            if (limit > 100)
+                throw new Error("--limit is at most 100.");
+            notify.limit = limit;
+        }
+    }
+    else {
+        onlyFor(["--slack"], "set");
+        onlyFor(["--notification", "--before", "--limit"], "receipts");
+    }
+    return {
+        kind: "issue",
+        action: "notifications",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        json: values.booleans.has("--json"),
+        notify,
+    };
+}