@harborppm/cli 0.18.1 → 0.20.0

package/README.md

@@ -118,8 +118,11 @@ harbor decision "TITLE" --project P|--program P [--owner NAME] [--due DATE]
 harbor risks [words] [--kind risk,issue,decision] [--project P] [--closed]
 harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
 harbor voyage PROJECT ["YOUR LINE"]
+harbor limit PROJECT [COLUMN N|none]
 ```
 
+`harbor limit RR` prints how many tasks each of a board's columns takes at once; `harbor limit RR doing 8` changes one (1 to 20, or `none` for no limit), if you own the harbor. `harbor projects --json` carries each board's `limits` too.
+
 `harbor premortem` runs a pre-mortem with your crew: `--start` asks everyone "it's after the end date and this project failed: what happened?", each person adds answers alone for five minutes, and then the answers show together on the project's Risks & issues tab, where each becomes a risk in one click. On its own it prints the question and the answers you can see. Once a project is Done, `harbor voyage` prints its voyage log (planned against actual dates, the biggest slips, the risks that came true, who closed the most, and the crew's lines) and adds yours.
 
 Every command takes `--json` for the raw result (a refusal then comes out as `{"error": "…"}` on standard output, still with exit code 1), and `harbor COMMAND --help` shows just that command. Statuses are backlog, todo, doing, review and done. A `DATE` is YYYY-MM-DD, `today`, `tomorrow`, or `+N` for N days from today.

package/dist/app.mjs

@@ -113,17 +113,16 @@ const MINUTE = 6e4;
 /**
 * How long ago (or until) `date` is, in the one unit that fits: "5 minutes
 * ago", "in 2 days", "1 year ago". Rounds to the nearest whole unit, and
-* matches date-fns's formatDistanceToNowStrict with addSuffix.
+* matches date-fns's formatDistanceToNowStrict with addSuffix, except that
+* anything under a minute either way is "just now", never "0 seconds ago".
 */
 function timeAgo(date, now = clockNow()) {
 	const diff = date.getTime() - now.getTime();
 	const minutes = Math.abs(diff) / MINUTE;
 	let n;
 	let unit;
-	if (minutes < 1) {
-		n = Math.round(Math.abs(diff) / 1e3);
-		unit = "second";
-	} else if (minutes < 60) {
+	if (minutes < 1) return "just now";
+	else if (minutes < 60) {
 		n = Math.round(minutes);
 		unit = "minute";
 	} else if (minutes < 1440) {
@@ -826,7 +825,7 @@ function scoreBand(score) {
 function normalizeRaidItem(r) {
 	const kind = r.kind === "issue" || r.kind === "decision" ? r.kind : "risk";
 	const now = (/* @__PURE__ */ new Date()).toISOString();
-	const impact = kind === "decision" ? null : clampScale(r.impact) ?? (r.severity ? impactFromSeverity(r.severity) : 3);
+	const impact = kind === "decision" ? null : clampScale(r.impact) ?? (r.impact === void 0 && r.severity ? impactFromSeverity(r.severity) : null);
 	const probability = kind === "risk" ? clampScale(r.probability) : null;
 	const allowed = STATUSES[kind];
 	const status = r.status && allowed.includes(r.status) ? r.status : allowed[0];
@@ -964,7 +963,9 @@ function stepsFor(kind, data, ctx, me) {
 			{
 				key: "endDate",
 				label: "Ends",
-				kind: "date"
+				kind: "date",
+				optional: true,
+				skipSays: "for 60 days from today"
 			},
 			{
 				key: "budget",
@@ -1263,6 +1264,18 @@ const ALL_FIELDS = {
 };
 const DEFAULT_DOING_WIP = 3;
 const DEFAULT_REVIEW_WIP = 2;
+/** The column's cap after "No cap" (`uncapped`) or a number is picked. */
+function withWipLimit(col, limit) {
+	const { uncapped: _drop, ...rest } = col;
+	return limit == null ? {
+		...rest,
+		wipLimit: null,
+		uncapped: true
+	} : {
+		...rest,
+		wipLimit: limit
+	};
+}
 function defaultWipFor(status) {
 	if (status === "doing") return 3;
 	if (status === "review") return 2;
@@ -1336,6 +1349,15 @@ function clampWip(value) {
 	if (!Number.isFinite(n) || n <= 0) return null;
 	return Math.min(20, Math.round(n));
 }
+function capOf(c) {
+	const n = clampWip(c.wipLimit);
+	if (n != null) return { wipLimit: n };
+	if (c.uncapped === true) return {
+		wipLimit: null,
+		uncapped: true
+	};
+	return { wipLimit: defaultWipFor(c.status) };
+}
 function normalizeBoardConfig(raw) {
 	const base = defaultBoardConfig();
 	if (!raw) return base;
@@ -1349,7 +1371,7 @@ function normalizeBoardConfig(raw) {
 			status: c.status,
 			label: typeof c.label === "string" && c.label.trim() ? c.label.trim() : TASK_STATUS_LABEL[c.status],
 			visible: c.visible !== false,
-			wipLimit: clampWip(c.wipLimit) ?? defaultWipFor(c.status)
+			...capOf(c)
 		});
 	}
 	for (const status of TASK_COLUMNS) if (!order.includes(status)) order.push(status);
@@ -2333,15 +2355,22 @@ function TextField({ label, initial = "", placeholder, hint, onSubmit, onCancel
 				bold: true,
 				children: label
 			}),
-			/* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, { children: [value || /* @__PURE__ */ jsx(Text, {
-				color: theme.muted,
-				children: placeholder ?? ""
-			}), /* @__PURE__ */ jsx(Text, {
+			/* @__PURE__ */ jsx(Box, { children: value ? /* @__PURE__ */ jsxs(Text, { children: [value, /* @__PURE__ */ jsx(Text, {
 				inverse: true,
 				children: " "
-			})] }) }),
+			})] }) : /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: [/* @__PURE__ */ jsx(Text, {
+					inverse: true,
+					children: " "
+				}), /* @__PURE__ */ jsx(Text, {
+					color: theme.muted,
+					children: placeholder ?? ""
+				})]
+			}) }),
 			/* @__PURE__ */ jsx(Text, {
 				color: theme.muted,
+				wrap: "truncate-end",
 				children: hint ?? "Enter to keep · Esc to leave it"
 			})
 		]
@@ -2654,7 +2683,7 @@ function Stepper({ title, steps, width, onDone, onCancel }) {
 		}, step.key) : /* @__PURE__ */ jsx(TextField, {
 			label,
 			placeholder: step.kind === "date" ? "YYYY-MM-DD, today, +30" : step.kind === "text" ? step.placeholder : void 0,
-			hint: error ?? (step.optional ? "Enter to skip · Esc to leave it" : void 0),
+			hint: error ?? (step.optional ? `Enter ${step.kind === "date" && step.skipSays ? step.skipSays : "to skip"} · Esc to leave it` : void 0),
 			onCancel,
 			onSubmit: (text) => {
 				const t = text.trim();
@@ -5204,37 +5233,45 @@ function ProgramView({ programId, active, width, height, go, onBack }) {
 		children: [
 			/* @__PURE__ */ jsxs(Box, {
 				justifyContent: "space-between",
-				children: [/* @__PURE__ */ jsxs(Text, {
-					wrap: "truncate-end",
-					children: [
-						/* @__PURE__ */ jsx(Text, {
-							bold: true,
-							children: program.name
-						}),
-						" ",
-						/* @__PURE__ */ jsx(HealthMark, {
-							health: program.health,
-							label: true
-						}),
-						program.healthOverride ? /* @__PURE__ */ jsxs(Text, {
-							color: theme.muted,
-							children: [
-								" (by hand: ",
-								program.healthNote || "no note",
-								")"
-							]
-						}) : null
-					]
-				}), /* @__PURE__ */ jsxs(Text, {
-					color: theme.muted,
-					children: [
-						portfolio?.name,
-						lead ? ` · ${lead.name}` : "",
-						" · ",
-						shortDay(program.startDate, today()),
-						"–",
-						shortDay(program.endDate, today())
-					]
+				columnGap: 2,
+				children: [/* @__PURE__ */ jsx(Box, {
+					flexShrink: 1,
+					children: /* @__PURE__ */ jsxs(Text, {
+						wrap: "truncate-end",
+						children: [
+							/* @__PURE__ */ jsx(Text, {
+								bold: true,
+								children: program.name
+							}),
+							" ",
+							/* @__PURE__ */ jsx(HealthMark, {
+								health: program.health,
+								label: true
+							}),
+							program.healthOverride ? /* @__PURE__ */ jsxs(Text, {
+								color: theme.muted,
+								children: [
+									" (by hand: ",
+									program.healthNote || "no note",
+									")"
+								]
+							}) : null
+						]
+					})
+				}), /* @__PURE__ */ jsx(Box, {
+					flexShrink: 2,
+					children: /* @__PURE__ */ jsxs(Text, {
+						color: theme.muted,
+						wrap: "truncate-end",
+						children: [
+							portfolio?.name,
+							lead ? ` · ${lead.name}` : "",
+							" · ",
+							shortDay(program.startDate, today()),
+							"–",
+							shortDay(program.endDate, today())
+						]
+					})
 				})]
 			}),
 			/* @__PURE__ */ jsxs(Text, {
@@ -5798,37 +5835,47 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 						borderColor: on ? theme.accent : theme.border,
 						paddingX: 1,
 						children: [
-							/* @__PURE__ */ jsxs(Box, { children: [
-								i === 0 && firstColumn > 0 ? /* @__PURE__ */ jsx(Text, {
-									color: theme.muted,
-									children: "‹ "
-								}) : null,
-								/* @__PURE__ */ jsx(Box, {
-									flexGrow: 1,
-									flexShrink: 1,
-									children: /* @__PURE__ */ jsxs(Text, {
-										bold: true,
-										color: on ? theme.accent : void 0,
-										wrap: "truncate-end",
-										children: [
-											c.label.toUpperCase(),
-											" ",
-											/* @__PURE__ */ jsxs(Text, {
-												color: over ? theme.bad : theme.muted,
-												children: [
-													c.tasks.length < c.all ? `${c.tasks.length} of ` : "",
-													c.all,
-													c.limit != null ? `/${c.limit}` : ""
-												]
-											})
-										]
-									})
-								}),
-								i === shownColumns.length - 1 && ci < columns.length - 1 ? /* @__PURE__ */ jsx(Text, {
-									color: theme.muted,
-									children: " ›"
-								}) : null
-							] }),
+							/* @__PURE__ */ jsxs(Box, {
+								height: 1,
+								overflow: "hidden",
+								children: [
+									i === 0 && firstColumn > 0 ? /* @__PURE__ */ jsx(Box, {
+										flexShrink: 0,
+										children: /* @__PURE__ */ jsx(Text, {
+											color: theme.muted,
+											children: "‹ "
+										})
+									}) : null,
+									/* @__PURE__ */ jsx(Box, {
+										flexGrow: 1,
+										flexShrink: 1,
+										children: /* @__PURE__ */ jsxs(Text, {
+											bold: true,
+											color: on ? theme.accent : void 0,
+											wrap: "truncate-end",
+											children: [
+												c.label.toUpperCase(),
+												" ",
+												/* @__PURE__ */ jsxs(Text, {
+													color: over ? theme.bad : theme.muted,
+													children: [
+														c.tasks.length < c.all ? `${c.tasks.length} of ` : "",
+														c.all,
+														c.limit != null ? `/${c.limit}` : ""
+													]
+												})
+											]
+										})
+									}),
+									i === shownColumns.length - 1 && ci < columns.length - 1 ? /* @__PURE__ */ jsx(Box, {
+										flexShrink: 0,
+										children: /* @__PURE__ */ jsx(Text, {
+											color: theme.muted,
+											children: " ›"
+										})
+									}) : null
+								]
+							}),
 							c.tasks.length === 0 ? /* @__PURE__ */ jsx(Text, {
 								color: theme.muted,
 								children: "—"
@@ -6743,6 +6790,7 @@ function TodayView({ active, width, height, go }) {
 		else if (key.pageUp) setAt((i) => step(i, -10, mine.length));
 		else if (key.return && selected) go.openTask(selected.id);
 		else if (input === "x" && selected) moveTask(store, go, selected, "done");
+		else if (input === "n" && projects.length === 0) go.create("project");
 		else if (input === "n") go.newTask(selected?.projectId ?? null);
 		else if (input === "f" && selected) {
 			if (store.getState().toggleFocus(selected.id) === "full") go.notify(`Today's focus holds ${3}. f on one of them takes it off first.`);
@@ -6800,7 +6848,7 @@ function TodayView({ active, width, height, go }) {
 			}),
 			mine.length === 0 ? /* @__PURE__ */ jsx(Text, {
 				color: theme.muted,
-				children: "Nothing open is yours. n adds a task."
+				children: projects.length ? "Nothing open is yours. n adds a task." : "Nothing open is yours. n starts your first project."
 			}) : view.items.map((t, i) => /* @__PURE__ */ jsx(TaskLine, {
 				task: t,
 				projects,
@@ -7505,8 +7553,9 @@ function daysUntil(date, now) {
 function incomplete(task) {
 	return task.status !== "done";
 }
-function wipLimitOf(status, stored) {
+function wipLimitOf(status, stored, uncapped) {
 	if (stored != null) return stored;
+	if (uncapped === true) return null;
 	if (status === "doing") return 3;
 	if (status === "review") return 2;
 	return null;
@@ -7515,7 +7564,7 @@ function wipOverflowing(data, projectId) {
 	const cols = data.boardConfigs?.[projectId]?.columns;
 	if (cols?.length) return cols.some((c) => {
 		if (c.visible === false) return false;
-		const limit = wipLimitOf(c.status, c.wipLimit);
+		const limit = wipLimitOf(c.status, c.wipLimit, c.uncapped);
 		if (limit == null) return false;
 		return tasksOf(data.tasks, projectId).filter((t) => t.status === c.status).length > limit;
 	});
@@ -8677,10 +8726,7 @@ function hierarchySlice({ get, write }) {
 			const columns = config.columns.map((c) => {
 				if (c.status !== status) return c;
 				const floor = Math.max(c.wipLimit ?? 0, current);
-				return {
-					...c,
-					wipLimit: Math.min(20, floor + 1)
-				};
+				return withWipLimit(c, Math.min(20, floor + 1));
 			});
 			get().setBoardConfig(projectId, {
 				...config,
@@ -9090,15 +9136,17 @@ function riskTitle(answer) {
 	title = title.replace(/\.$/, "");
 	return title;
 }
-/** The risk an answer becomes: on its project, open, unrated, with the whole answer as what could happen. */
-function riskFromAnswer(answer, project, portfolioId) {
+/**
+* The risk an answer becomes: on its project, open, unrated, with the whole
+* answer as what could happen. Scoped to the project alone, like a risk
+* logged on the project page; the program and portfolio roll it up from there.
+*/
+function riskFromAnswer(answer, project) {
 	return {
 		kind: "risk",
 		title: riskTitle(answer.body),
 		description: `${answer.body.trim()}\n\nRaised in the pre-mortem.`,
 		projectId: project.id,
-		programId: project.programId,
-		portfolioId,
 		status: "open",
 		ownerId: null,
 		dueDate: null
@@ -9304,8 +9352,7 @@ function milestonesRaidSlice({ set, get, write }) {
 			if (!answer || answer.raidId) return answer?.raidId ?? null;
 			const project = get().projects.find((p) => p.id === answer.projectId);
 			if (!project) return null;
-			const program = get().programs.find((p) => p.id === project.programId);
-			const raidId = get().addRaidItem(riskFromAnswer(answer, project, program?.portfolioId ?? null));
+			const raidId = get().addRaidItem(riskFromAnswer(answer, project));
 			write({ reflections: (get().reflections ?? []).map((r) => r.id === id ? {
 				...r,
 				raidId,
@@ -10328,11 +10375,17 @@ function createUiStore() {
 
 //#endregion
 //#region src/lib/empty.ts
-/** What a new harbor is called until its owner names it: "Sam's harbor". */
-function suggestedHarborName(displayName, email) {
+/**
+* A name worth offering in the harbor-name field: "Sam's harbor", or "" when
+* nobody is known yet, so the field stays empty and shows its placeholder.
+*/
+function harborNameFor(displayName, email) {
 	const first = (displayName || email || "").split(/[\s@]/)[0]?.trim();
-	if (!first) return "My harbor";
-	return `${first}'s harbor`;
+	return first ? `${first}'s harbor` : "";
+}
+/** What a new harbor is called until its owner names it: "Sam's harbor", else "My harbor". */
+function suggestedHarborName(displayName, email) {
+	return harborNameFor(displayName, email) || "My harbor";
 }
 
 //#endregion

package/lib/cli.mjs

@@ -17,7 +17,9 @@ import {
   writeSettings,
 } from "./config.mjs";
 import {
+  STATUS,
   harbors,
+  limitsText,
   myWork,
   premortemText,
   voyageText,
@@ -58,6 +60,7 @@ export const HELP = `harbor: Harbor from the terminal
   harbor programs [--done]                    programs and their projects
   harbor projects [words] [--program P] [--done]
                                               projects with health and open work
+                                              (--json adds each board's limits)
   harbor mine                                 what's on you, late first
   harbor tasks [words] [--project P] [--assignee me|none|NAME]
                      [--late] [--status S,S]
@@ -82,6 +85,8 @@ export const HELP = `harbor: Harbor from the terminal
                    [--priority P] [--status S] [--notes TEXT]
                    [--repeat weekly|biweekly|monthly|never]
                    [--waits-on TASK,TASK|none] [--confirm] [--over-limit]
+  harbor limit PROJECT [COLUMN N|none]        how many tasks a board column
+                                              takes at once; the owner sets it
   harbor comment TASK "TEXT"
   harbor checkin "WHAT YOU'RE DOING" [--on-blocker]
   harbor risk "TITLE" --project P|--program P [--impact 1-5] [--probability 1-5]
@@ -91,10 +96,11 @@ export const HELP = `harbor: Harbor from the terminal
   harbor decision "TITLE" --project P|--program P [--owner NAME] [--due DATE]
   harbor risks [words] [--kind risk,issue,decision] [--project P] [--closed]
                                               the register, worst first
+                                              (--closed adds closed ones)
   harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
                                               a project's pre-mortem: start,
                                               answer or read it
-  harbor voyage PROJECT ["YOUR LINE"]           a Done project's voyage log, and
+  harbor voyage PROJECT ["YOUR LINE"]         a Done project's voyage log, and
                                               your line in it
 
   Every command takes --json, and --harbor NAME when you're in more than one
@@ -211,6 +217,8 @@ const FLAG = {
   repeat: "--repeat",
   description: "--notes",
   body: "the comment",
+  column: "the column",
+  limit: "the limit",
 };
 
 /** Harbor's refusals are worded for agents; say them as the commands and flags that answer them. */
@@ -234,7 +242,9 @@ export function hint(message) {
         .replace(
           /^Invalid option: expected one of (.*)$/,
           (_, list) => `pick one of ${list.replace(/"/g, "").split("|").join(", ")}`,
-        );
+        )
+        // The CLI reads today, tomorrow and +N before Harbor sees the date.
+        .replace(/^a date as YYYY-MM-DD$/, "a date like 2026-11-30, today, tomorrow or +N days");
       if (!seen.has(flag)) seen.set(flag, said);
     }
     return [...seen].map(([flag, why]) => `${flag}: ${why}`).join("\n");
@@ -279,6 +289,17 @@ export function premortemForTerminal(r) {
 
 /** Commands whose forms do different things: one line each, saying which read and which write. */
 const DETAIL = {
+  limit: [
+    "  harbor limit PROJECT                   reads its board's column limits",
+    "  harbor limit PROJECT COLUMN N          writes: COLUMN takes at most N tasks",
+    "                                         at once (1 to 20; the website offers",
+    "                                         1-5, 8, 10 and 15)",
+    "  harbor limit PROJECT COLUMN none       writes: no limit on COLUMN",
+    "",
+    "  COLUMN is a status: doing or review usually, or backlog, todo, done.",
+    "  Only the harbor's owner can change a limit. A move past a limit is",
+    "  refused until you run it again with --over-limit.",
+  ],
   premortem: [
     "  harbor premortem PROJECT               reads it: the question, the time left,",
     "                                         and the answers you may see",
@@ -288,13 +309,15 @@ const DETAIL = {
     '  harbor premortem PROJECT "ANSWER" --start',
     "                                         writes: starts one and adds your answer",
     "",
-    "  PROJECT is a name or an id. When two projects share a name, give the id.",
+    "  PROJECT is a name, a key like RR, or an id. When two projects share a",
+    "  name, give the key.",
   ],
   voyage: [
     "  harbor voyage PROJECT                  reads a Done project's voyage log",
     '  harbor voyage PROJECT "YOUR LINE"      writes: adds or changes your line in it',
     "",
-    "  PROJECT is a name or an id. When two projects share a name, give the id.",
+    "  PROJECT is a name, a key like RR, or an id. When two projects share a",
+    "  name, give the key.",
   ],
 };
 
@@ -307,11 +330,12 @@ export function commandHelp(command) {
     const names = words.filter(
       (_, j) => j > 0 && (words[j - 1] === "harbor" || words[j - 1] === "|"),
     );
-    if (words[0] !== "harbor" || !names.includes(command)) continue;
+    // A command line names one (the footer's "harbor (or set one…" doesn't).
+    if (words[0] !== "harbor" || !/^[a-z-]+$/.test(words[1] ?? "") || !names.includes(command))
+      continue;
     picked.push(lines[i]);
-    // Its options carry on below it, further in.
-    while (lines[i + 1]?.startsWith("                  ") && /^\s+\[|^\s+--/.test(lines[i + 1]))
-      picked.push(lines[++i]);
+    // Its options and the rest of its description carry on below it, further in.
+    while (/^ {6,}\S/.test(lines[i + 1] ?? "")) picked.push(lines[++i]);
   }
   if (DETAIL[command]) picked.splice(0, picked.length, ...DETAIL[command]);
   if (picked.length === 0) return null;
@@ -321,6 +345,40 @@ export function commandHelp(command) {
   return [...picked, ...common].join("\n");
 }
 
+/** Every command the help names, for spotting a typo. */
+/** "zsh, bash or fish". */
+const either = (list) => `${list.slice(0, -1).join(", ")} or ${list.at(-1)}`;
+
+const COMMANDS = [
+  ...new Set(
+    HELP.split("\n").flatMap((line) =>
+      [...line.matchAll(/(?:^\s+harbor|\|) ([a-z][a-z-]+)/g)].map((m) => m[1]),
+    ),
+  ),
+];
+
+/** How many single-letter changes (or swaps of neighbours) turn a into b. */
+function distance(a, b) {
+  const d = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
+  for (let j = 1; j <= b.length; j++) d[0][j] = j;
+  for (let i = 1; i <= a.length; i++)
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
+      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1])
+        d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
+    }
+  return d[a.length][b.length];
+}
+
+/** A mistyped command, with the one it was probably meant to be. */
+export function noCommand(name) {
+  if (name.startsWith("-")) return `${name} goes after a command, like harbor mine ${name}.`;
+  const near = COMMANDS.filter((c) => distance(name, c) <= (c.length > 4 ? 2 : 1));
+  const guess = near.length === 1 ? ` Did you mean harbor ${near[0]}?` : "";
+  return `No command "${name}".${guess} Run harbor help.`;
+}
+
 /** Room for --json and --harbor before the command too: `harbor --json mine`. */
 function commandFirst(argv) {
   const front = [];
@@ -386,9 +444,9 @@ export async function run(argv, io = {}) {
 
   if (command === "help" || command === "--help" || command === "-h") {
     // `harbor help mine`: that command's help, as `harbor mine --help` gives it.
-    if (rest[0]) {
+    if (rest[0] && rest[0] !== "help") {
       const help = commandHelp(rest[0]);
-      if (help === null) throw new HarborError(`No command "${rest[0]}". Run harbor help.`);
+      if (help === null) throw new HarborError(noCommand(rest[0]));
       out(help);
       return 0;
     }
@@ -413,7 +471,7 @@ export async function run(argv, io = {}) {
   if (command && asksHelp(rest)) {
     const help = commandHelp(command === "app" ? "" : command);
     if (help === null && command !== "app") {
-      throw new HarborError(`No command "${command}". Run harbor help.`);
+      throw new HarborError(noCommand(command));
     }
     out(help ?? HELP);
     return 0;
@@ -515,7 +573,20 @@ export async function run(argv, io = {}) {
     await writeCredentials(creds, env);
     const canWrite = creds.scope.split(" ").includes("harbor:write");
     const said = `Signed in to ${server}${canWrite ? "." : ", reading only."}`;
-    const next = signUp ? "Next: run harbor, and it helps you make your first harbor." : null;
+    // Someone who made their account on the sign-in page has no harbor yet either.
+    const fresh =
+      signUp ||
+      (await createClient({
+        creds,
+        // A renewed sign-in keeps the harbor set with harbor use.
+        save: (c) =>
+          writeCredentials({ ...c, harbor: creds.harbor, harborName: creds.harborName }, env),
+        fetcher,
+      })
+        .call("list_harbors", {})
+        .then((r) => (r.harbors ?? []).length === 0)
+        .catch(() => false));
+    const next = fresh ? "Next: run harbor, and it helps you make your first harbor." : null;
     const welcome = banner(io, env, ({ bold, dim }) => [
       bold("Welcome aboard."),
       said,
@@ -565,7 +636,7 @@ export async function run(argv, io = {}) {
     none(positionals);
     if (values.init !== undefined) {
       const snippet = initSnippet(values.init);
-      if (!snippet) throw new HarborError(`Pick ${SHELLS.join(", ")} (not "${values.init}").`);
+      if (!snippet) throw new HarborError(`Pick ${either(SHELLS)} (not "${values.init}").`);
       out(
         // Comments, so the whole of it can be appended straight to the file.
         `${snippet}\n# Shows what's due today and late, from the prompt after next;\n# nothing when you're clear. harbor prompt --refresh checks now.`,
@@ -574,7 +645,7 @@ export async function run(argv, io = {}) {
     }
     const shell = values.shell;
     if (shell !== undefined && !SHELLS.includes(shell))
-      throw new HarborError(`--shell is ${SHELLS.join(", ")} (not "${shell}").`);
+      throw new HarborError(`--shell is ${either(SHELLS)} (not "${shell}").`);
     const creds = await readCredentials(env);
     const harbor = values.harbor ?? creds?.harbor ?? null;
     const today = todayLocal(io.now ? new Date(io.now()) : new Date());
@@ -615,7 +686,7 @@ export async function run(argv, io = {}) {
 
   // A mistyped command says so, signed in or not.
   if (commandHelp(command) === null) {
-    throw new HarborError(`No command "${command}". Run harbor help.`);
+    throw new HarborError(noCommand(command));
   }
   const creds = await readCredentials(env);
   if (!creds)
@@ -782,13 +853,14 @@ export async function run(argv, io = {}) {
     }
     case "show": {
       const { positionals, harbor } = parse(spec());
-      return call("get_task", { harbor, task: one(positionals, "task id") }, (t) => {
+      return call("get_task", { harbor, task: one(positionals, "task key, like RR-42") }, (t) => {
         const lines = [
           taskLine(
             { ...t, waitingOn: t.waitingOn.filter((w) => w.status !== "done").length },
             { ...opts, width: undefined },
           ),
         ];
+        if (t.repeats) lines.push(`Repeats ${REPEAT_WORD[t.repeats] ?? t.repeats}.`);
         if (t.description) lines.push("", t.description);
         if (t.checklist.length)
           lines.push("", ...t.checklist.map((c) => `  [${c.done ? "x" : " "}] ${c.step}`));
@@ -796,13 +868,17 @@ export async function run(argv, io = {}) {
           lines.push(
             "",
             "Waits on:",
-            ...t.waitingOn.map((w) => `  ${w.key ?? w.id}  ${w.title} (${w.status})`),
+            ...t.waitingOn.map(
+              (w) => `  ${w.key ?? w.id}  ${w.title} (${STATUS[w.status] ?? w.status})`,
+            ),
           );
         if (t.waitedOnBy.length)
           lines.push(
             "",
             "Holds up:",
-            ...t.waitedOnBy.map((w) => `  ${w.key ?? w.id}  ${w.title} (${w.status})`),
+            ...t.waitedOnBy.map(
+              (w) => `  ${w.key ?? w.id}  ${w.title} (${STATUS[w.status] ?? w.status})`,
+            ),
           );
         if (t.comments.length)
           lines.push(
@@ -857,7 +933,7 @@ export async function run(argv, io = {}) {
         out(jsonText(r));
         return 0;
       }
-      const as = r.role === "viewer" ? "a viewer (they can look, not change)" : "a member";
+      const as = r.role === "viewer" ? "someone who can view (not change)" : "crew who can edit";
       out(
         plain(
           r.sent
@@ -924,7 +1000,7 @@ export async function run(argv, io = {}) {
         "update_task",
         {
           harbor,
-          task: one(positionals, "task id"),
+          task: one(positionals, "task key, like RR-42"),
           status,
           confirmed: values.confirm || undefined,
           overLimit: values["over-limit"] || undefined,
@@ -950,7 +1026,7 @@ export async function run(argv, io = {}) {
         "update_task",
         {
           harbor,
-          task: one(positionals, "task id"),
+          task: one(positionals, "task key, like RR-42"),
           title: values.title,
           assignee: values.assignee,
           due: values.due === undefined ? undefined : nullable(dueDate(values.due)),
@@ -983,7 +1059,7 @@ export async function run(argv, io = {}) {
     case "comment": {
       const { positionals, harbor } = parse(spec());
       const [task, ...words] = positionals;
-      if (!task) throw new HarborError("Give a task id, then the comment.");
+      if (!task) throw new HarborError("Give a task key, like RR-42, then the comment.");
       return call(
         "add_comment",
         { harbor, task, body: text(words, "the comment") },
@@ -1056,6 +1132,24 @@ export async function run(argv, io = {}) {
       }
       return call("get_premortem", { harbor, project }, premortemText, premortemForTerminal);
     }
+    case "limit": {
+      const { positionals, harbor } = parse(spec());
+      const [project, column, value, ...extra] = positionals;
+      if (!project) throw new HarborError("Give a project, like harbor limit RR doing 5.");
+      if (!column) {
+        return call("get_project", { harbor, project }, (r) => limitsText(r.name, r.limits));
+      }
+      if (value === undefined || extra.length) {
+        throw new HarborError(`Give one limit for ${column}: a number like 5, or none.`);
+      }
+      const limit = /^(none|no|off|0)$/i.test(value) ? null : Number(value);
+      if (limit !== null && !(Number.isInteger(limit) && limit >= 1 && limit <= 20)) {
+        throw new HarborError("A limit is a whole number from 1 to 20, or none.");
+      }
+      return call("set_column_limit", { harbor, project, column, limit }, (r) =>
+        limitsText(r.set.project, r.limits),
+      );
+    }
     case "voyage": {
       const { positionals, harbor } = parse(spec());
       const [project, ...words] = positionals;

package/lib/format.mjs

@@ -1,6 +1,6 @@
 /** Plain text for a terminal: one task per line, its key (or id) first so it can be copied. */
 
-const STATUS = {
+export const STATUS = {
   backlog: "backlog",
   todo: "to do",
   doing: "doing",
@@ -55,7 +55,9 @@ export function myWork(w, opts) {
     out.push("", "Yours in the register:");
     for (const r of w.raid)
       // No command takes a risk's id, so it isn't shown.
-      out.push(`  ${r.kind}: ${r.title}${r.due ? ` (review by ${r.due})` : ""}`);
+      out.push(
+        `  ${r.kind}: ${r.title}${r.due ? ` (${r.kind === "Decision" ? "decide" : "review"} by ${r.due})` : ""}`,
+      );
   }
   return out.join("\n");
 }
@@ -127,6 +129,7 @@ export function projectList(r, { done = false } = {}) {
       .map((p) => {
         const late = p.tasks.late ? `, ${p.tasks.late} late` : "";
         const bits = [
+          p.key,
           p.program,
           health(p.health),
           `${p.tasks.total - p.tasks.done} open${late}`,
@@ -141,6 +144,14 @@ export function projectList(r, { done = false } = {}) {
   );
 }
 
+/** A project's column limits: "doing 5, review no limit". */
+export function limitsText(name, limits) {
+  const bits = Object.entries(limits ?? {}).map(
+    ([status, n]) => `${STATUS[status] ?? status} ${n == null ? "no limit" : n}`,
+  );
+  return bits.length ? `${name}: ${bits.join(", ")}.` : `${name}'s board has no column limits.`;
+}
+
 export function harbors(r) {
   const list = r.harbors ?? [];
   if (!list.length) return "You aren't in any harbor yet. Run harbor to make one.";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harborppm/cli",
-  "version": "0.18.1",
+  "version": "0.20.0",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",