@bli-cockpit/cli 0.2.243 → 0.2.245

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

@@ -18,6 +18,7 @@ import { DOCS_FORMATTING_HELP } from "./local-help-docs-formatting.js";
 import { DOCS_INBOX_HELP } from "./local-help-docs-inbox.js";
 import { DOCS_RECOVERY_HELP } from "./local-help-docs-recovery.js";
 import { PROJECT_HELP } from "./local-help-project.js";
+import { MILESTONE_HELP } from "./local-help-milestone.js";
 import { INBOX_HELP_LINES } from "./local-help-inbox.js";
 import { WORK_NOTIFY_HELP_LINES } from "./local-help-work-notify.js";
 import { VIEWS_HELP_LINES } from "./local-help-views.js";
@@ -122,7 +123,7 @@ export const TOWER_COMMAND_HELP = [
     [
         "issue",
         [
-            "Usage: cockpit issue [board|list|show <id> [<id>...]|create|update <id>|move <id> <state>|comment <id>|label <id>|relations <id>|relate <id>|unrelate <id>|views [list|show|save|update|favorite|unfavorite|settings]|templates [list|show|versions|save|update|apply]|cycles [list|show|create|update|map]|inbox|read <notification-id>...|unread <notification-id>...|subscribe <id>|unsubscribe <id>|notifications [set|receipts]|history <id>|versions <id>|restore <id> --version <n>|batch|mutation-status <request-uuid>] [flags]",
+            "Usage: cockpit issue [board|list|show <id> [<id>...]|create|update <id>|move <id> <state>|comment <id>|label <id>|archive <id>|unarchive <id>|relations <id>|relate <id>|unrelate <id>|views [list|show|save|update|favorite|unfavorite|settings]|templates [list|show|versions|save|update|apply]|cycles [list|show|create|update|map]|inbox|read <notification-id>...|unread <notification-id>...|subscribe <id>|unsubscribe <id>|notifications [set|receipts]|history <id>|versions <id>|restore <id> --version <n>|batch|mutation-status <request-uuid>] [flags]",
             "",
             "Tower's issue tracker. <id> is a BLI-#### identifier (BLI-3654) or an issue's uuid — both work everywhere an issue is named.",
             "list [--state <s>] [--assignee me|unassigned|<uuid>] [--project <name|id>] [--label <name>] [--q <text>] [--created-after|--created-before|--updated-after|--updated-before <utc instant|date>] [--sort updated_at|created_at] [--dir desc|asc] [--limit <n>] [--cursor <c>] [--all] — the issues you may see, most recently updated first. A page is 100 by default and at most 500. Filters run in the database BEFORE the page, so a label or title match deep in the set is found. --q is a case-insensitive title contains (% and _ are literal); *-after is inclusive, *-before is exclusive. --json adds next_cursor, has_more, coverage (complete|capped|failed_partial), requested, returned, unique: pass next_cursor back as --cursor with the same other flags. --all walks every page and streams ONE JSON OBJECT PER LINE (NDJSON; rows carry assignee_id, no names), then a final {\"type\":\"coverage\",...} line naming the coverage; an interrupted walk ends with coverage failed_partial, the reason and the resume cursor, and exits 1. Each row carries assignee_name/assignee_email alongside the bare assignee_id (BLI-10450, one extra `cockpit team members` call for the whole page, never per row), and a `size` label (S/M/L) alongside the raw `estimate` when it matches Tower's own scale (BLI-10575). --json shape: { issues: [{ id, identifier, title, state, priority, estimate, size, assignee_id, assignee_name, assignee_email, project_id, parent_id, updated_at }] }.",
@@ -130,14 +131,15 @@ export const TOWER_COMMAND_HELP = [
             "show <id> [<id>...] — one or more issues: title, state, priority, size, assignee (name and email, not just its id), description, and every comment on each. Several ids read in one call — one bad id never loses the rest.",
             "  --json shape: one id answers { issue, comments }, unchanged from before BLI-10450 (plus `estimate`/`size`, BLI-10575). Several ids answer { issues: [{ ref, ok, issue, comments } | { ref, ok: false, error, detail }] }.",
             "create --title \"<title>\" [--project <name|id>] [--priority 0-4] [--size S|M|L] [--assignee me|<uuid>] [--parent <id>] [--state <state>] [--due YYYY-MM-DD] [--file <path>] — --state is the starting state (default backlog); --due sets a due date. The DESCRIPTION comes from --file or stdin (`cat plan.md | cockpit issue create --title \"...\"`); neither means no description. --size maps onto the existing `estimate` column, Tower's own scale: S=1, M=3, L=5 (BLI-10575) — an estimate outside that scale (an imported Linear point value, say) just has no size label on a read. --json shape: { issue }.",
-            "update <id> [--title \"<t>\"] [--priority 0-4] [--size S|M|L] [--assignee me|<uuid>] [--project <name|id>] [--parent <id>] [--due YYYY-MM-DD|none] [--file <path>|--body-stdin] — only the fields you pass change: a field you leave off is never touched. --due none clears the due date; --assignee none clears the owner. A size already on the ticket that is not S, M or L (an imported estimate such as 8) stays as it is until you pass --size. State does NOT move here; use move. --json shape: { issue }.",
+            "update <id> [--title \"<t>\"] [--priority 0-4] [--size S|M|L|none] [--assignee me|<uuid>|none] [--project <name|id>|none] [--parent <id>|none] [--cycle <name|id>|none] [--due YYYY-MM-DD|none] [--file <path>|--body-stdin] — only the fields you pass change: a field you leave off is never touched. `none` is the ONE spelling that clears: --size none, --assignee none, --project none, --parent none (top-level again), --cycle none and --due none (BLI-22367). A committed write prints \"Saved in Tower (revision N). Linear copy: pending|delivered|failed|not mirrored (reason)\"; a refusal says \"not committed: nothing changed\" unless the answer was genuinely lost (then check mutation-status). A size already on the ticket that is not S, M or L (an imported estimate such as 8) stays as it is until you pass --size. State does NOT move here; use move. --json shape: { issue }.",
             "label <id> [--add <label>]... [--remove <label>]... [--request-id <uuid>] [--expected-revision <n>] — adds and removes EXISTING labels (names match exactly, ignoring case; a uuid also works) in one receipt, one history row and one revision step. An unknown name is refused by name and nothing changes; labels are never created here. Any member may detach. --json shape: { issue, labels, mutation }. relations <id> [--json] — what blocks what: Blocks, Blocked by, Related, Duplicate of, Duplicates, and Not in Tower (an imported Linear edge to a ticket Tower does not have, shown as text). A sub-ticket is NOT a blocker and is not listed here. Edges to a deleted or unreadable ticket are left out and counted (coverage.hidden). --json shape: { relations: { blocks, blocked_by, related, duplicates, duplicate_of, unmapped, coverage } }, each item { relation_id, kind, source: native|linear, issue: { id, identifier, title, state } }. relate <id> --blocks <id> | --blocked-by <id> | --related <id> | --duplicate-of <id> [--request-id <uuid>] [--expected-revision <n>] — exactly one kind flag; records one edge as one receipt, one history row and one revision step (--blocked-by stores the edge from the other ticket). Refusals by name: relation_exists, relation_inverse_blocks, relation_self, relation_target_not_found_or_unreadable. unrelate <id> --relation <relation-id> | the same kind flag plus the other ticket — removes the edge (kept as removed, never re-imported). Refusal: relation_not_found. Setting --parent so a ticket would sit under its own sub-ticket is refused as circular_parent, a chain deeper than 200 as hierarchy_too_deep. --json shape: { issue, relation_id, mutation }. Also: move <id> <state> — moves an issue and records the move. States: backlog, todo, in_progress, in_review, done, canceled.",
+            "archive <id> | unarchive <id> [--request-id <uuid>] [--expected-revision <n>] — archive HIDES a ticket from lists, the board and counts; nothing is deleted, `show` still reads it (marked ARCHIVED), and unarchive brings it back with every field, comment and history row (BLI-22367). One receipt, one history row, one revision step. Tower-only: the Linear copy (if any) is not touched, so the receipt says not mirrored (archive_is_tower_only). Refusals: issue_already_archived, issue_not_archived, revision_conflict, request_id_reused. `list --archived [--q <text>] [--project <name|id>] [--limit <n>] [--cursor <c>] [--all]` lists archived tickets only, most recently archived first. --json shape: { issue, mutation }.",
             "comment <id> — posts a comment. The body is never taken on the command line: `echo \"shipped\" | cockpit issue comment BLI-3654`.",
             "Writes accept --request-id <uuid> and --expected-revision <n>. Keep the UUID and identical fields across retries; JSON includes mutation receipt and mirror delivery separately.",
             "mutation-status <request-uuid> — check your own local commit and mirror delivery after a lost response; no receipt means unknown_check_again.",
             "history <id> [--limit <n>] [--cursor <c>] — every recorded state move and reassignment, oldest first; --json carries the same page fields as list.",
             "versions <id> [--limit <n>] — every saved description, newest first, each with its number, id, author, source and time (BLI-21300). --json shape: { versions: [{ id, version, markdown, author_id, source, restored_from_version, created_at }] }.",
-            "restore <id> --version <n> [--request-id <uuid>] [--expected-revision <n>] — writes version <n>'s text back as a NEW version; nothing is rewritten, so the restore can itself be undone. A stale revision conflicts and changes nothing. --json shape: { issue, mutation }. batch [--file <path>] [--request-id <uuid>] — changes up to 50 tickets in one call (BLI-21551). Reads { \"items\": [...] } (or a bare array) from stdin or --file, never argv. Each item is { issue, expected_revision?, request_id?, state? | priority? | assignee? | size? | project? | due_date? }: a state move OR field changes, not both, and one item per ticket. It is NOT all-or-nothing: every item is its own change with its own receipt, one stderr line each. Exit 0 only when every item committed, 1 otherwise; the batch request id is printed, and a retry with --request-id writes nothing twice. --json shape: { ok, request_id, requested, committed, refused, unknown, items: [{ index, issue, outcome, reason?, message?, request_id, revision?, row? }] }. Example: echo '{\"items\":[{\"issue\":\"BLI-1\",\"priority\":2},{\"issue\":\"BLI-2\",\"state\":\"done\"}]}' | cockpit ticket batch --json.",
+            "restore <id> --version <n> [--request-id <uuid>] [--expected-revision <n>] — writes version <n>'s text back as a NEW version; nothing is rewritten, so the restore can itself be undone. A stale revision conflicts and changes nothing. --json shape: { issue, mutation }. batch [--file <path>] [--request-id <uuid>] — changes up to 50 tickets in one call (BLI-21551). Reads { \"items\": [...] } (or a bare array) from stdin or --file, never argv. Each item is { issue, expected_revision?, request_id?, state? | priority? | assignee? | size? | project? | parent? | cycle? | due_date? } (\"none\" or null clears assignee, size, project, parent, cycle and due_date): a state move OR field changes, not both, and one item per ticket. It is NOT all-or-nothing: every item is its own change with its own receipt, one stderr line each. Exit 0 only when every item committed, 1 otherwise; the batch request id is printed, and a retry with --request-id writes nothing twice. --json shape: { ok, request_id, requested, committed, refused, unknown, items: [{ index, issue, outcome, reason?, message?, request_id, revision?, row? }] }. Example: echo '{\"items\":[{\"issue\":\"BLI-1\",\"priority\":2},{\"issue\":\"BLI-2\",\"state\":\"done\"}]}' | cockpit ticket batch --json.",
             ...VIEWS_HELP_LINES,
             ...TEMPLATES_HELP_LINES,
             ...CYCLES_HELP_LINES,
@@ -216,6 +218,7 @@ export const TOWER_COMMAND_HELP = [
         ],
     ],
     PROJECT_HELP,
+    MILESTONE_HELP,
     [
         "speed",
         [

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

@@ -386,7 +386,9 @@ const COMMAND_HELP = new Map([
     [
         "sources",
         [
-            "Usage: cockpit sources check [--older-than <days>] [--dashboard-url <url>] [--json]",
+            "Usage: cockpit sources check [--reconcile] [--older-than <days>] [--dashboard-url <url>] [--json]",
+            "",
+            "--reconcile adds read-only source-row, pointer and revision metadata checks; never collects or repairs.",
             "",
             "Answers, for every Codex and Claude transcript on this machine, whether Tower",
             "holds it: stored in full, stored in part, or not stored, with the reason.",

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

@@ -0,0 +1,23 @@
+/** `cockpit milestone` help (BLI-22360), kept beside the parser in local-args-tower-milestone.ts. */
+export const MILESTONE_HELP = [
+    "milestone",
+    [
+        "Usage: cockpit milestone [list] [--project <id|name>] [--archived] [--json]",
+        "       cockpit milestone show <id|name> [--project <id|name>] [--limit <n>] [--cursor <c>] [--json]",
+        '       cockpit milestone create --project <id|name> --name "<name>" [--description <text|->] [--target YYYY-MM-DD] [--request-id <uuid>] [--json]',
+        "       cockpit milestone update <id|name> [--project <p>] [--name <n>] [--description <text|-|none>] [--target <day|none>] [--expected-updated-at <ts>] [--request-id <uuid>] [--json]",
+        "       cockpit milestone archive|restore <id|name> [--project <p>] [--expected-updated-at <ts>] [--request-id <uuid>] [--json]",
+        "       cockpit milestone add|remove <id|name> <ticket> [<ticket> ...] [--project <p>] [--request-id <uuid>] [--json]",
+        "",
+        "Project milestones: a dated goal inside ONE project, with the tickets that make it up. Not Tower Manager's timeline milestones.",
+        "list — a project's milestones (every project's without --project), target date first, each with its progress. --archived includes archived ones.",
+        "show <ref> — the milestone, its progress and a page of its tickets. <ref> is an id or an exact name (case-folded, never fuzzy); --project narrows a name to one project; two milestones with one name are milestone_ref_ambiguous and the message lists their ids.",
+        "Progress is a count: done of (done + open) tickets. Canceled tickets are shown but left out of the total; estimates never weight it. Points (estimate sum over the estimated tickets only) and how many tickets carry an estimate are printed beside it. A milestone with more than 5,000 tickets says its counts are a floor.",
+        "create / update — name 1 to 120 characters, unique among the project's active milestones; `--description -` reads stdin, `--description none` and `--target none` clear (update). A milestone never moves to another project.",
+        "archive / restore — soft: tickets keep their milestone, nothing is deleted, there is no delete verb. An archived milestone refuses new tickets (milestone_archived).",
+        "add / remove <milestone> <tickets...> — up to 50 ticket ids or identifiers, one receipt each; one refusal never stops the others. A ticket must already be in the milestone's project (milestone_project_mismatch); a ticket is in at most one milestone, so add moves it from another. remove only takes out tickets that are in this milestone. Moving a ticket to another project takes it out of its milestone.",
+        "Milestones are Tower-only during the Linear dual run: a milestone write is delivery tower_only, and a ticket's milestone change says Linear copy not_mirrored (milestone_not_mirrored). The same --request-id replays the first receipts.",
+        "Refusals keep Tower's label: milestone_not_found_or_unreadable, milestone_ref_ambiguous, milestone_name_required, milestone_name_taken, milestone_date_invalid, milestone_already_archived, milestone_not_archived, milestone_archived, milestone_project_mismatch, project_archived, project_not_found_or_unreadable, revision_conflict, request_id_reused, invalid_body.",
+        "--json writes one machine-readable object to stdout; every reason and receipt line stays on stderr.",
+    ],
+];

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

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

package/dist/commands/local-help.js

@@ -79,6 +79,7 @@ export const rootCommandNames = new Set([
     "mail",
     "cal",
     "project",
+    "milestone",
     "search",
     "github",
     "release",
@@ -140,13 +141,14 @@ const COMMAND_SUMMARY_LINES = [
     "  cockpit agent-rules [install|uninstall|status] [--host codex|claude|all] [--workspace <path>] [--json]",
     "  cockpit memory [search \"<question>\"|save|update <id>|forget <id>|profile|install|status|log <win|loss|noise> --store <bli|supermemory|both> \"<reason>\"] [--container <tag>] [--limit <n>] [--no-recent] [--include-originals|--no-originals] [--include-source|--no-source] [--custom-id <id>] [--extract] [--content-stdin] [--reason <label>] [--file <path>] [--dashboard-url <url>] [--dry-run] [--json]",
     "  cockpit clean [--dry-run] [--all-committed] [--reconcile] [--dashboard-url <url>] [--json]",
-    "  cockpit sources check [--older-than <days>] [--dashboard-url <url>] [--json]",
+    "  cockpit sources check [--reconcile] [--older-than <days>] [--dashboard-url <url>] [--json]",
     "  cockpit docs [list|tree|read <id|slug>|create --title <t>|update <id>|delete <id|slug>|trash|versions <id|slug>|restore <id>] [--parent <id>|root|--clear-parent] [--query <text> [--word]] [--limit <n>] [--visibility org|private] [--file <path>|--body-stdin] [--allow-empty] [--dashboard-url <url>] [--json]",
     "  cockpit msg [channels|create <name>|dm <email>|read <channel>|send <channel>|thread <id> --channel <channel>|show <message-id>] [--private] [--members a@x,b@y] [--description <text>] [--thread <id>] [--limit <n>] [--before <cursor>] [--dashboard-url <url>] [--json]",
     "  cockpit issue [list|show <BLI-id>|create --title <t>|update <BLI-id>|move <BLI-id> <state>|comment <BLI-id>|history <BLI-id>] [--state <s>] [--assignee me|unassigned|<uuid>] [--project <name|id>] [--limit <n>] [--priority 0-4] [--size S|M|L] [--parent <BLI-id>] [--file <path>|--body-stdin] [--dashboard-url <url>] [--json]",
     "  cockpit mail [accounts|add-imap --address <a>|inbox|read <thread>|search \"<words>\"|send --account <id> --to <a> --subject <s>|draft --account <id> --to <a> --subject <s> [--reply-to <message id>]|attachment <id> --out <path>|sync <account>|detach <account>] [--account <id>] [--limit <n>] [--unread] [--label <l>] [--file <path>] [--attach <path>]... [--dashboard-url <url>] [--json]",
     "  cockpit cal [event <id> [--occurrence-start <iso>]|export <id> [--occurrence-start <iso>]|today|week|conflicts|calendar-change <id> --color <hex-or-provider>|view-settings|view-settings-change|people <label>|availability --with <label|email> --from <d> --to <d>|overlays [--pin <label|email>|--remove <email>]|next|find \"<words>\"|calendars|add-ical|create --calendar <id> --title <t> --at <iso> --until <iso>|duplicate <event id> [--keep-invitees]|batch|undo [<change id>]|share <id> --org-visible|--private|sync <id> [--full]|detach <id>] [--tz <zone>] [--offset <n>] [--hours <n>] [--from <d> --to <d>] [--calendar <id>] [--limit <n>] [--all] [--dashboard-url <url>] [--json]",
     "  cockpit project [list] [--archived] [--dashboard-url <url>] [--json]",
+    "  cockpit milestone [list|show|create|update|archive|restore|add|remove] [--project <p>] [--json]",
     "  cockpit github <pr|merge|retitle|rerun> <owner/repo> <n> [--claim <state>] [--method squash|merge|rebase] [--title \"<text>\"] [--run <id>] [--confirm <code>] [--dashboard-url <url>] [--json]",
     `  cockpit search "<words>" [--kind <category,...>] [--limit <n>] [--dashboard-url <url>] [--json]`,
     "  cockpit search --categories [--dashboard-url <url>] [--json]",

package/dist/commands/local.js

@@ -47,6 +47,7 @@ import { runIssue } from "./issue.js";
 import { runCal } from "./cal.js";
 import { runMail } from "./mail.js";
 import { runProject } from "./project.js";
+import { runMilestone } from "./milestone.js";
 import { runGithub } from "./github.js";
 import { runSearch } from "./search.js";
 import { runCareers } from "./careers.js";
@@ -203,6 +204,7 @@ async function runTowerCommand(command, io) {
         case "issue": return await runIssue(command, io);
         case "mail": return await runMail(command, io);
         case "project": return await runProject(command, io);
+        case "milestone": return await runMilestone(command, io);
         case "search": return await runSearch(command, io);
         case "github": return await runGithub(command, io);
         case "careers": return await runCareers(command, io);

package/dist/commands/manager-hints.js

@@ -20,7 +20,7 @@ const L = MANAGER_LIMITS_COPY;
 export const SUMMARY_REFUSAL_NAMES = [
     "summary_changed", "summary_empty", "summary_incomplete", "summary_health_invalid", "summary_headline_empty", "summary_headline_too_long",
     "summary_bullets_count", "summary_bullet_empty", "summary_bullet_too_long", "summary_bullet_date_invalid", "summary_next_too_long",
-    "summary_blocker_too_long", "summary_blocked_needs_blocker", "summary_blocker_needs_blocked",
+    "summary_blocker_too_long", "summary_blocked_needs_blocker", "summary_blocker_needs_blocked", "summary_hr_tagged",
 ];
 /** The way forward after each named refusal of a "Where we are" edit; `home` is the ready-to-run `cockpit manager home <client> --json`. */
 export function summaryHints(home) {
@@ -40,11 +40,12 @@ export function summaryHints(home) {
         summary_blocker_too_long: `Shorten --blocker (the limit is ${L.blockerMax}).`,
         summary_blocked_needs_blocker: "Add --blocker <what blocks it>, or pass another --health.",
         summary_blocker_needs_blocked: "Add --health blocked, or leave --blocker out (`--blocker none` clears the stored one).",
+        summary_hr_tagged: "Run the summary again without the tagged text; that part stays out of Tower.",
     };
 }
 export const ITEM_REFUSAL_NAMES = [
     "item_changed", "item_busy", "item_archived", "item_not_archived", "item_dismissed", "person_item_not_dismissable",
-    "no_proposal", "proposal_replaced", "timeline_not_live", "request_reused", "proposal_decided", "proposal_not_addable",
+    "no_proposal", "proposal_replaced", "timeline_not_live", "request_reused", "proposal_decided", "proposal_not_addable", "item_hr_tagged",
 ];
 /** Refusals that mean "the item is not as you last saw it": reading it again is the way forward. */
 export const RESEEN_REFUSALS = new Set(["item_changed", "item_busy", "proposal_decided", "no_proposal"]);
@@ -65,6 +66,7 @@ export function itemHints(id, flag) {
         person_item_not_dismissable: `Run \`cockpit manager archive ${id}${flag} --version <v>\`.`,
         timeline_not_live: "`cockpit manager list <client> --timeline` lists the client's live timeline items.",
         item_not_archived: "Nothing to bring back: it is in the lists already.",
+        item_hr_tagged: "Run the add or edit again without the tagged text; that part stays out of Tower.",
     };
 }
 /**

package/dist/commands/manager-limits.json

@@ -146,13 +146,15 @@
       "summary_next_too_long",
       "summary_blocker_too_long",
       "summary_blocked_needs_blocker",
-      "summary_blocker_needs_blocked"
+      "summary_blocker_needs_blocked",
+      "summary_hr_tagged"
     ],
     "item": [
       "item_archived",
       "item_busy",
       "item_changed",
       "item_dismissed",
+      "item_hr_tagged",
       "item_not_archived",
       "no_proposal",
       "person_item_not_dismissable",

package/dist/commands/manager-read-reasons.js

@@ -51,6 +51,7 @@ export const SUMMARY_REFUSAL_WORDS = {
     summary_blocker_too_long: "the blocker was over 200 characters",
     summary_blocked_needs_blocker: "blocked with no blocker",
     summary_blocker_needs_blocked: "a blocker on a card that is not blocked",
+    summary_hr_tagged: "text tagged [HR]",
 };
 /** Why a summary check kept the card that was there instead of writing one (the receipt's `kept_reason`), in words. */
 export const SUMMARY_KEPT_WORDS = {

package/dist/commands/manager-render-home.js

@@ -83,13 +83,14 @@ export function withTodayLine(rows, dates, today) {
     const line = [todayLine(today)];
     return at === -1 ? [...rows, line] : [...rows.slice(0, at), line, ...rows.slice(at)];
 }
-/** Who wrote the card, by its `source`: the credit's opening words (the day follows; a person's name comes after "Edited by"). */
+/** Who wrote the card, by its `source`: the credit's opening words (the day follows; a person's name comes after "Edited by" and "Written by", then "'s agent" for the agent's card). */
 export const SUMMARY_SOURCE_WORDS = {
     model: "Written by AI",
     computed: "AI unavailable · computed from counts",
     person: "Edited by",
+    agent: "Written by",
 };
-/** Who wrote the card and when: "written by AI", "computed from counts", or "edited by" a person. */
+/** Who wrote the card and when: "written by AI", "computed from counts", "edited by" a person, or "written by" a person's agent. */
 function authorLine(summary, now) {
     // The server's own Vancouver day when it sends one; never worked out here when it did.
     const at = summary.writtenOn ? `${dayWords(summary.writtenOn)} (${ageText(summary.writtenAt, now)})` : when(summary.writtenAt, now);
@@ -98,6 +99,8 @@ function authorLine(summary, now) {
     if (summary.source === "computed")
         return `${SUMMARY_SOURCE_WORDS.computed}, ${at}.`;
     // Never a user id in a person's terminal: the door fills the name, or says "a teammate".
+    if (summary.source === "agent")
+        return `${SUMMARY_SOURCE_WORDS.agent} ${summary.editedByName ?? "a teammate"}'s agent, ${at}.`;
     return `${SUMMARY_SOURCE_WORDS.person} ${summary.editedByName ?? "a teammate"}, ${at}.`;
 }
 const CAP_WORDS = {
@@ -169,8 +172,11 @@ function summaryLines(home, now, color) {
         if (checked !== null && Number.isFinite(new Date(checked).getTime()))
             lines.push(`  Last checked ${ageText(checked, now)}.`);
     }
-    if (summary.inputsChanged && !summary.lastCheckFailed)
-        lines.push("  Inputs changed since: the client's data changed, an action went overdue or an open action passed 14 days overdue (for an AI-written card, also a meeting or milestone came within a week or passed) after this was written; the next check writes it again.");
+    if (summary.inputsChanged && !summary.lastCheckFailed) {
+        lines.push(summary.source === "agent"
+            ? "  Inputs changed since: the client's data changed, an action went overdue or an open action passed 14 days overdue after this was written; Tower's check leaves the agent's card, so the agent or a person writes it again."
+            : "  Inputs changed since: the client's data changed, an action went overdue or an open action passed 14 days overdue (for an AI-written card, also a meeting or milestone came within a week or passed) after this was written; the next check writes it again.");
+    }
     lines.push(counts, dim(`  version ${summary.updatedAt} (what \`summary --version\` takes)`, color));
     return lines;
 }
@@ -378,7 +384,9 @@ export function summaryWrittenLines(summary, color, now = new Date()) {
         lines.push(`  Next: ${summary.next}`);
     if (summary.blocker)
         lines.push(`  Blocker: ${summary.blocker}`);
-    lines.push(`  ${authorLine(summary, now)} It 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 it again.`);
+    lines.push(summary.source === "agent"
+        ? `  ${authorLine(summary, now)} Tower's check never rewrites it; your agent's next edit, or a person's on the page, replaces it.`
+        : `  ${authorLine(summary, now)} It 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 it again.`);
     lines.push(dim(`  version ${summary.updatedAt}`, color));
     return lines;
 }

package/dist/commands/manager-render.js

@@ -149,6 +149,9 @@ export function handledByLines(item, timeline) {
     const human = item.origin === "human";
     if (human && item.createdBy)
         lines.push(`Added by ${person(item.createdByName)}${onDay(item.createdAt)}.`);
+    // An AI item with a creator is a person's agent's add through the door (BLI-21947); the model's own have none.
+    if (!human && item.createdBy)
+        lines.push(`Added by ${person(item.createdByName)}'s agent${onDay(item.createdAt)}${item.reviewStatus === "unreviewed" ? "; not checked yet" : ""}.`);
     if (item.reviewStatus === "rejected" && item.reviewedBy)
         lines.push(`Dismissed by ${person(item.reviewedByName)}${onDay(item.reviewedAt)}.`);
     else if (item.reviewedBy && item.reviewStatus === "reviewed") {

package/dist/commands/manager.js

@@ -144,6 +144,8 @@ function renderAnswer(command, body, color) {
 }
 /** An add answered `created: false`: the same request id came back, so the item that already existed is returned. */
 const ALREADY_ADDED = "Already added earlier under this request id; nothing new was written.";
+/** An add the server stored as the caller's agent's, unchecked (BLI-21947); an older server's reviewed add says nothing more. */
+const addedUnchecked = (body) => body.item?.reviewStatus === "unreviewed" ? " Stored as added by your agent, not yet checked: a person approves or dismisses it." : "";
 /** What a write did, in one sentence a person reads; the item's new version follows on its row. */
 function writeSentence(command, body) {
     const as = "as you";
@@ -152,7 +154,7 @@ function writeSentence(command, body) {
     const queue = waiting === 0 ? "It leaves the review queue." : `${waiting === 1 ? "Its other suggested change still waits" : `Its ${waiting} other suggested changes still wait`} in the review queue.`;
     switch (command.action) {
         // Only an explicit `created: false` is "not created": an older server sends no field, and that add did write.
-        case "add": return body.created === false ? [ALREADY_ADDED] : [command.timeline && !command.occurredAt ? "Added. It has no date, so it sits in \"Needs a date\"." : "Added."];
+        case "add": return body.created === false ? [ALREADY_ADDED] : [`${command.timeline && !command.occurredAt ? "Added. It has no date, so it sits in \"Needs a date\"." : "Added."}${addedUnchecked(body)}`];
         // Railway writes nothing when every field already equals the stored one: no new version, no reviewed mark.
         case "edit": return [body.unchanged === true ? "No change; nothing was written." : "Saved your changes."];
         // Railway writes nothing when the action already has that status, so its version comes back unchanged.

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"),
     };
 }