@bli-cockpit/cli 0.2.244 → 0.2.245

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.245");
     return 0;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.244",
+  "version": "0.2.245",
   "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.150",
     "@bli-cockpit/telemetry-core": "0.1.79"
   },
   "repository": {