@bli-cockpit/cli 0.2.244 → 0.2.246

package/dist/commands/milestone.js

@@ -0,0 +1,157 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor } from "./agent-door.js";
+import { isInteractiveStdin, readPipedText, writeLine } from "./cli-io.js";
+import { BODY_MAX_CHARS, READ_DEADLINE_MS, WRITE_DEADLINE_MS } from "./issue-contracts.js";
+const TAG = "[milestone cli]";
+export const milestoneLine = (m) => `${m.id}  ${m.name}  target ${m.target_date ?? "none"}${m.archived_at ? "  [archived]" : ""}  ${m.progress?.summary ?? ""}`.trimEnd();
+function refuse(door, answer) {
+    const mutation = answer.body?.mutation;
+    return failAgentDoor(door, TAG, answer.reason, answer.detail, mutation ? { mutation } : {});
+}
+function projectQuery(command) {
+    return command.project ? `?project=${encodeURIComponent(command.project)}` : "";
+}
+/** `--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 milestone description is limited to ${BODY_MAX_CHARS} characters.` }) };
+    }
+    catch (error) {
+        return { ok: false, detail: error instanceof Error ? error.message : String(error) };
+    }
+}
+export async function runMilestone(command, io) {
+    const door = await openAgentDoor("milestone", command, io);
+    const ref = command.ref ? encodeURIComponent(command.ref) : "";
+    const writeIds = command.requestId ? { request_id: command.requestId } : {};
+    switch (command.action) {
+        case "list": {
+            const query = new URLSearchParams();
+            if (command.project)
+                query.set("project", command.project);
+            if (command.includeArchived)
+                query.set("include_archived", "true");
+            const answer = await askAgentDoor(door, {
+                path: `/api/work/milestones${query.size > 0 ? `?${query}` : ""}`, method: "GET", label: "milestone list", timeoutMs: READ_DEADLINE_MS,
+            });
+            if (!answer.ok)
+                return refuse(door, answer);
+            const body = answer.body;
+            const rows = body.milestones ?? [];
+            console.error(`${TAG} list done`, JSON.stringify({ returned: rows.length, coverage: body.coverage ?? null }));
+            if (door.json)
+                return emitAgentDoor(door, { ok: true, ...body });
+            if (rows.length === 0)
+                writeLine(door.io.stdout, "No milestones here. Create one with `cockpit milestone create --project <p> --name <n>`.");
+            for (const row of rows)
+                writeLine(door.io.stdout, milestoneLine(row));
+            if (body.coverage === "capped")
+                writeLine(door.io.stdout, "\nOnly the first 500 milestones are listed.");
+            return 0;
+        }
+        case "show": {
+            const query = new URLSearchParams();
+            if (command.project)
+                query.set("project", command.project);
+            if (command.limit !== undefined)
+                query.set("limit", String(command.limit));
+            if (command.cursor)
+                query.set("cursor", command.cursor);
+            const answer = await askAgentDoor(door, {
+                path: `/api/work/milestones/${ref}${query.size > 0 ? `?${query}` : ""}`, method: "GET", label: "milestone show", timeoutMs: READ_DEADLINE_MS,
+            });
+            if (!answer.ok)
+                return refuse(door, answer);
+            const body = answer.body;
+            console.error(`${TAG} show done`, JSON.stringify({ milestone_id: body.milestone.id, members: body.issues?.length ?? 0, has_more: Boolean(body.has_more) }));
+            if (door.json)
+                return emitAgentDoor(door, { ok: true, ...body });
+            const out = door.io.stdout;
+            writeLine(out, milestoneLine(body.milestone));
+            writeLine(out, `project ${body.project?.name ?? body.milestone.project_id}  updated ${body.milestone.updated_at ?? ""}`);
+            if (body.milestone.description)
+                writeLine(out, `\n${body.milestone.description}`);
+            writeLine(out, `\nProgress: ${body.progress?.summary ?? "no progress summary"}`);
+            for (const issue of body.issues ?? [])
+                writeLine(out, `${(issue.identifier ?? "").padEnd(9)}  ${(issue.state ?? "").padEnd(11)}  ${issue.title ?? ""}`);
+            if (body.has_more && body.next_cursor)
+                writeLine(out, `More tickets: --cursor ${body.next_cursor}`);
+            return 0;
+        }
+        case "create":
+        case "update": {
+            const description = await readDescription(command.description, io);
+            if (!description.ok)
+                return failAgentDoor(door, TAG, "invalid_body", description.detail);
+            const payload = {
+                ...writeIds,
+                ...(command.action === "create" ? { project: command.project } : {}),
+                ...(command.action === "update" && command.expectedUpdatedAt ? { expected_updated_at: command.expectedUpdatedAt } : {}),
+                ...(command.name === undefined ? {} : { name: command.name }),
+                ...(description.text === undefined ? {} : { description: description.text }),
+                ...(command.targetDate === undefined ? {} : { target_date: command.targetDate }),
+            };
+            return await write(command, door, command.action === "create"
+                ? { path: "/api/work/milestones", method: "POST", body: payload }
+                : { path: `/api/work/milestones/${ref}${projectQuery(command)}`, method: "PATCH", body: payload });
+        }
+        case "archive":
+        case "restore":
+            return await write(command, door, {
+                path: `/api/work/milestones/${ref}${projectQuery(command)}`,
+                method: "PATCH",
+                body: { ...writeIds, ...(command.expectedUpdatedAt ? { expected_updated_at: command.expectedUpdatedAt } : {}), archived: command.action === "archive" },
+            });
+        case "add":
+        case "remove":
+            return await membership(command, door, ref, writeIds);
+    }
+}
+async function write(command, door, req) {
+    const answer = await askAgentDoor(door, { ...req, label: `milestone ${command.action}`, timeoutMs: WRITE_DEADLINE_MS });
+    if (!answer.ok)
+        return refuse(door, answer);
+    const body = answer.body;
+    console.error(`${TAG} ${command.action} committed`, JSON.stringify({ milestone_id: body.milestone.id, request_id: body.mutation?.request_id ?? null, delivery: body.mutation?.delivery?.status ?? null }));
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...body });
+    const label = { create: "Created", update: "Updated", archive: "Archived", restore: "Restored" }[command.action] ?? "Saved";
+    writeLine(door.io.stdout, `${label}: ${milestoneLine(body.milestone)}`);
+    writeLine(door.io.stdout, `Request ID ${body.mutation?.request_id ?? "?"}, delivery ${body.mutation?.delivery?.status ?? "tower_only"} (milestones never reach Linear).`);
+    return 0;
+}
+async function membership(command, door, ref, writeIds) {
+    const answer = await askAgentDoor(door, {
+        path: `/api/work/milestones/${ref}/issues${projectQuery(command)}`,
+        method: "POST",
+        label: `milestone ${command.action}`,
+        timeoutMs: WRITE_DEADLINE_MS,
+        body: { ...writeIds, [command.action]: command.tickets },
+    });
+    // 207 means some items were refused: still a readable answer with every receipt.
+    const body = (("body" in answer ? answer.body : undefined) ?? {});
+    if (!answer.ok && !Array.isArray(body.items))
+        return refuse(door, answer);
+    const items = body.items ?? [];
+    console.error(`${TAG} ${command.action} done`, JSON.stringify({
+        request_id: body.request_id ?? null, asked: items.length, committed: body.committed ?? 0, refused: body.refused ?? 0, skipped: body.skipped ?? 0, unknown: body.unknown ?? 0,
+    }));
+    const failed = (body.refused ?? 0) + (body.unknown ?? 0) > 0;
+    if (door.json) {
+        emitAgentDoor(door, { ok: !failed, ...body });
+        return failed ? 1 : 0;
+    }
+    for (const item of items) {
+        const linear = item.delivery?.status ? `  Linear copy: ${item.delivery.status}${item.delivery.reason ? ` (${item.delivery.reason})` : ""}` : "";
+        writeLine(door.io.stdout, `${(item.identifier ?? item.ref).padEnd(9)}  ${item.action} ${item.outcome}${item.reason ? ` ${item.reason}` : ""}${linear}`);
+        if (item.message && item.outcome !== "committed")
+            writeLine(door.io.stdout, `           ${item.message}`);
+    }
+    writeLine(door.io.stdout, `\n${body.committed ?? 0} committed, ${body.refused ?? 0} refused, ${body.skipped ?? 0} skipped, ${body.unknown ?? 0} unknown. Request ID ${body.request_id ?? "?"} (retry with it to replay).`);
+    if (body.progress?.summary)
+        writeLine(door.io.stdout, `Progress: ${body.progress.summary}`);
+    return failed ? 1 : 0;
+}

package/dist/commands/project-args.js

@@ -4,20 +4,94 @@
  * A description never travels on argv by default: `--file <path>` reads it from a local file (safest on Windows);
  * `--description <text>` is the short form and `--description none` clears it. Write-safety flags
  * (`--request-id`, `--expected-updated-at`) belong to the four write verbs.
+ * BLI-22360: create/update also take the planning flags (`--lead`, `--member`, `--add-member`, `--remove-member`,
+ * `--status`, `--priority`, `--start`, `--target`, their `--*-resolution`, `--content-file` / `--content`); `none` clears.
  */
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const ACTIONS = ["list", "show", "create", "update", "archive", "restore"];
 const WRITES = ["create", "update", "archive", "restore"];
+/** BLI-22360: the planning fields of `project create|update`. `none` clears a value (update). */
+const PLANNING_FLAGS = [
+    "--lead", "--member", "--add-member", "--remove-member", "--status", "--priority",
+    "--start", "--start-resolution", "--target", "--target-resolution", "--content-file", "--content",
+];
+const DAY = /^\d{4}-\d{2}-\d{2}$/;
+const PRIORITIES = ["none", "urgent", "high", "medium", "low", "0", "1", "2", "3", "4"];
+const STATUSES = ["backlog", "planned", "started", "in-progress", "in_progress", "paused", "completed", "done", "canceled", "none"];
+const RESOLUTIONS = ["day", "month", "quarter", "halfYear", "year", "none"];
+/** `--member a@x --member b@x` or `--member a@x,b@x`; `none` alone clears (sent as an empty set). */
+function people(values, flag) {
+    const raw = values.flagValues.get(flag) ?? (values.flags.has(flag) ? [values.flags.get(flag)] : undefined);
+    if (raw === undefined)
+        return undefined;
+    const list = raw.flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
+    if (list.length === 0)
+        throw new Error(`${flag} needs an email, a user id or me.`);
+    return list;
+}
+function day(flag, value) {
+    if (value === undefined)
+        return undefined;
+    if (value.trim().toLowerCase() === "none")
+        return null;
+    if (!DAY.test(value) || new Date(`${value}T12:00:00Z`).toISOString().slice(0, 10) !== value) {
+        throw new Error(`${flag} must be a calendar date as YYYY-MM-DD, or none.`);
+    }
+    return value;
+}
+function oneOf(flag, value, allowed) {
+    if (value === undefined)
+        return undefined;
+    if (!allowed.includes(value.trim()))
+        throw new Error(`${flag} must be one of: ${allowed.join(", ")}.`);
+    return value.trim();
+}
+function readPlanning(values, action) {
+    const given = PLANNING_FLAGS.filter((flag) => values.flags.has(flag));
+    if (given.length === 0)
+        return {};
+    if (action !== "create" && action !== "update")
+        throw new Error(`${given[0]} belongs to project create and update.`);
+    if (values.flags.has("--content") && values.flags.has("--content-file"))
+        throw new Error("Give --content or --content-file, not both.");
+    const members = people(values, "--member");
+    const addMembers = people(values, "--add-member");
+    const removeMembers = people(values, "--remove-member");
+    if (members && (addMembers || removeMembers))
+        throw new Error("Give --member (the whole set) or --add-member / --remove-member, not both.");
+    if (action === "create" && (addMembers || removeMembers))
+        throw new Error("project create takes --member; --add-member and --remove-member belong to update.");
+    const lead = values.flags.get("--lead");
+    const content = values.flags.get("--content");
+    const status = oneOf("--status", values.flags.get("--status"), STATUSES);
+    const priority = oneOf("--priority", values.flags.get("--priority"), PRIORITIES);
+    return {
+        ...(lead === undefined ? {} : { lead: lead.trim().toLowerCase() === "none" ? null : lead.trim() }),
+        ...(members === undefined ? {} : { members }),
+        ...(addMembers === undefined ? {} : { addMembers }),
+        ...(removeMembers === undefined ? {} : { removeMembers }),
+        ...(status === undefined ? {} : { status: status === "none" ? null : status }),
+        ...(priority === undefined ? {} : { priority }),
+        ...(values.flags.has("--start") ? { startDate: day("--start", values.flags.get("--start")) } : {}),
+        ...(values.flags.has("--target") ? { targetDate: day("--target", values.flags.get("--target")) } : {}),
+        ...(values.flags.has("--start-resolution") ? { startDateResolution: oneOf("--start-resolution", values.flags.get("--start-resolution"), RESOLUTIONS) } : {}),
+        ...(values.flags.has("--target-resolution") ? { targetDateResolution: oneOf("--target-resolution", values.flags.get("--target-resolution"), RESOLUTIONS) } : {}),
+        ...(content === undefined ? {} : { content: content.trim().toLowerCase() === "none" ? null : content }),
+        ...(values.flags.has("--content-file") ? { contentFilePath: optionalNonEmpty(values.flags.get("--content-file")) } : {}),
+    };
+}
 export function parseProjectArgs(args) {
     const values = parseNamedArgs(args, {
         allowedFlags: [
             "--home", "--dashboard-url", "--archived", "--cursor", "--limit", "--json",
             "--name", "--description", "--file", "--color", "--request-id", "--expected-updated-at",
+            ...PLANNING_FLAGS,
         ],
         valueFlags: [
             "--home", "--dashboard-url", "--cursor", "--limit",
             "--name", "--description", "--file", "--color", "--request-id", "--expected-updated-at",
+            ...PLANNING_FLAGS,
         ],
     });
     const first = values.positionals[0];
@@ -59,8 +133,9 @@ export function parseProjectArgs(args) {
     const rawDescription = values.flags.get("--description");
     const description = rawDescription === undefined ? undefined : rawDescription.trim().toLowerCase() === "none" ? null : rawDescription;
     const filePath = optionalNonEmpty(values.flags.get("--file"));
-    if (action === "update" && name === undefined && description === undefined && filePath === undefined) {
-        throw new Error("project update needs --name, --description (or none) or --file.");
+    const planning = readPlanning(values, action);
+    if (action === "update" && name === undefined && description === undefined && filePath === undefined && Object.keys(planning).length === 0) {
+        throw new Error("project update needs --name, --description (or none), --file, or a planning flag (--lead, --member, --status, --priority, --start, --target, --content-file).");
     }
     return {
         kind: "project",
@@ -77,6 +152,7 @@ export function parseProjectArgs(args) {
         ...(optionalNonEmpty(values.flags.get("--color")) ? { color: optionalNonEmpty(values.flags.get("--color")) } : {}),
         ...(requestId ? { requestId } : {}),
         ...(expectedUpdatedAt ? { expectedUpdatedAt } : {}),
+        ...(Object.keys(planning).length > 0 ? { planning } : {}),
         json: values.booleans.has("--json"),
     };
 }

package/dist/commands/project.js

@@ -12,6 +12,22 @@ import { pageFieldsOf, pageFooter } from "./issue-list-page.js";
 import { readBody } from "./issue-contracts.js";
 const TAG = "[project cli]";
 const READ_DEADLINE_MS = 30_000;
+const PRIORITY_WORDS = ["none", "urgent", "high", "medium", "low"];
+const person = (p) => p.name && p.email ? `${p.name} <${p.email}>` : (p.email ?? p.name ?? p.user_id);
+/** "2026-06-01 (month)" for a period, the bare day for an exact date. */
+const dated = (day, resolution) => day ? `${day}${resolution ? ` (${resolution})` : ""}` : "none";
+/** The planning block `project show` prints (BLI-22360). */
+export function planningLines(body) {
+    const project = body.project;
+    if (!project)
+        return [];
+    return [
+        `status ${project.status ?? "none"}  priority ${PRIORITY_WORDS[project.priority ?? 0] ?? project.priority}  start ${dated(project.start_date, project.start_date_resolution)}  target ${dated(project.target_date, project.target_date_resolution)}`,
+        `lead ${body.lead ? person(body.lead) : "none"}`,
+        `members ${(body.members ?? []).length === 0 ? "none" : (body.members ?? []).map(person).join(", ")}`,
+        ...(body.milestones ?? []).map((m) => `milestone ${m.name}${m.archived_at ? " (archived)" : ""}  target ${m.target_date ?? "none"}  ${m.progress?.summary ?? ""}  ${m.id}`),
+    ];
+}
 export async function runProject(command, io) {
     const door = await openAgentDoor("project", command, io);
     if (command.action !== "list")
@@ -65,6 +81,10 @@ async function runProjectVerb(command, door) {
         writeLine(out, `id ${project?.id ?? ""}  updated ${project?.updated_at ?? ""}`);
         if (project?.description)
             writeLine(out, project.description);
+        for (const line of planningLines(body))
+            writeLine(out, line);
+        if (project?.content)
+            writeLine(out, `\n${project.content}\n`);
         for (const issue of body.issues ?? [])
             writeLine(out, `${issue.identifier ?? ""}  ${issue.state ?? ""}  ${issue.title ?? ""}`);
         const footer = pageFooter(body, "tickets");
@@ -92,6 +112,38 @@ async function runProjectVerb(command, door) {
         else if (command.description !== undefined) {
             payload["description"] = command.description;
         }
+        const planning = command.planning;
+        if (planning) {
+            if (planning.lead !== undefined)
+                payload["lead"] = planning.lead;
+            if (planning.members !== undefined)
+                payload["members"] = planning.members;
+            if (planning.addMembers !== undefined)
+                payload["add_members"] = planning.addMembers;
+            if (planning.removeMembers !== undefined)
+                payload["remove_members"] = planning.removeMembers;
+            if (planning.status !== undefined)
+                payload["status"] = planning.status;
+            if (planning.priority !== undefined)
+                payload["priority"] = planning.priority;
+            if (planning.startDate !== undefined)
+                payload["start_date"] = planning.startDate;
+            if (planning.targetDate !== undefined)
+                payload["target_date"] = planning.targetDate;
+            if (planning.startDateResolution !== undefined)
+                payload["start_date_resolution"] = planning.startDateResolution;
+            if (planning.targetDateResolution !== undefined)
+                payload["target_date_resolution"] = planning.targetDateResolution;
+            if (planning.contentFilePath) {
+                const read = await readBody({ filePath: planning.contentFilePath }, door.io);
+                if (!read.ok)
+                    return failAgentDoor(door, TAG, read.reason, read.detail);
+                payload["content"] = read.text;
+            }
+            else if (planning.content !== undefined) {
+                payload["content"] = planning.content;
+            }
+        }
     }
     const path = command.action === "create" ? base : command.action === "update" ? ref : `${ref}/${command.action}`;
     const answer = await askAgentDoor(door, {

package/dist/commands/public-root.js

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

package/dist/staging-gate.js

@@ -15,7 +15,8 @@
  *
  * Three reasons close the gate, most urgent first:
  *
- * - `low_disk`: the volume's free space is under max(5 GiB, 5% of the volume).
+ * - `low_disk`: the volume's free space is under max(5 GiB, 5% of the volume),
+ *   for a file bigger than 1% of the free space left (smaller files are admitted).
  * - `state_over_ceiling`: everything the collector writes under its state dir
  *   (staging, spool, logs, cursors, state; never the study folders
  *   `state-dir-audit.ts` recognises) would pass the hard ceiling, 512 MiB by
@@ -43,6 +44,12 @@ export const STATE_CEILING_ENV = "COCKPIT_STATE_CEILING_BYTES";
 export const MIN_FREE_ENV = "COCKPIT_MIN_FREE_BYTES";
 export const LOW_DISK_FLOOR_BYTES = 5 * 1024 * 1024 * 1024;
 export const LOW_DISK_FLOOR_FRACTION = 0.05;
+/**
+ * A file at most this fraction of the free space left is never refused for low
+ * disk: a 7 MB upload does not threaten a volume with gigabytes free, even one
+ * under the floor. Only a copy that would eat a real share of what is left waits.
+ */
+export const LOW_DISK_SMALL_FILE_FRACTION = 0.01;
 /**
  * Each pack's `manifest.json` is staged beside the payload and its size grows
  * with the gap ledger, so it is not known when a file is admitted. A tenth of
@@ -174,9 +181,22 @@ export function admitToStaging(allowance, byteLength, options = {}) {
     const spent = allowance.admitted_bytes;
     const stagedNow = snapshot.staging_bytes + spent;
     let reason = null;
-    if (snapshot.free_bytes !== null &&
+    const freeNow = snapshot.free_bytes === null ? null : snapshot.free_bytes - spent;
+    const belowFloor = freeNow !== null &&
         snapshot.floor_bytes !== null &&
-        snapshot.free_bytes - spent - byteLength < snapshot.floor_bytes) {
+        freeNow - byteLength < snapshot.floor_bytes;
+    const smallForFree = freeNow !== null && freeNow > 0 && byteLength <= freeNow * LOW_DISK_SMALL_FILE_FRACTION;
+    if (belowFloor && smallForFree) {
+        console.error("[staging-gate] low-disk floor waived, file is under 1% of free space", JSON.stringify({
+            event: STAGING_DEFERRED,
+            reason: "low_disk_waived_small_file",
+            kind: options.kind ?? null,
+            file_bytes: byteLength,
+            free_bytes: freeNow,
+            floor_bytes: snapshot.floor_bytes,
+        }));
+    }
+    if (belowFloor && !smallForFree) {
         reason = "low_disk";
     }
     else if (snapshot.collector_bytes + spent + byteLength > snapshot.ceiling_bytes) {
@@ -202,6 +222,7 @@ export function admitToStaging(allowance, byteLength, options = {}) {
             reason,
             kind: options.kind ?? null,
             file_bytes: byteLength,
+            needed_bytes: byteLength,
             staging_bytes: snapshot.staging_bytes,
             collector_bytes: snapshot.collector_bytes,
             free_bytes: snapshot.free_bytes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.244",
+  "version": "0.2.246",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.72",
-    "@bli-cockpit/mcp": "0.1.149",
+    "@bli-cockpit/mcp": "0.1.151",
     "@bli-cockpit/telemetry-core": "0.1.79"
   },
   "repository": {