@harborppm/cli 0.18.0 → 0.19.0

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",
@@ -2333,15 +2334,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 +2662,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 +5212,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 +5814,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 +6769,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 +6827,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,
@@ -9090,15 +9117,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 +9333,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 +10356,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,6 +17,7 @@ import {
   writeSettings,
 } from "./config.mjs";
 import {
+  STATUS,
   harbors,
   myWork,
   premortemText,
@@ -91,10 +92,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
@@ -234,7 +236,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");
@@ -245,6 +249,11 @@ export function hint(message) {
       "Say which with --harbor NAME, or set one with harbor use NAME.",
     )
     .replace(/Find it with search_tasks\.$/, "Find it with harbor tasks.")
+    .replace(
+      /^(.+) has no pre-mortem running\. Start one with start_premortem first\.$/s,
+      (_, name) =>
+        `${name} has no pre-mortem running. Start one with harbor premortem "${name}" --start.`,
+    )
     .replace(
       /^Nothing to change: pass a field to update\.$/,
       "Nothing to change. Say what with --title, --assignee, --due, --priority, --status, --notes, --repeat or --waits-on.",
@@ -263,6 +272,38 @@ export function hint(message) {
     );
 }
 
+/** get_premortem's answer with its note naming the command, not the agent tool, since --json shows it. */
+export function premortemForTerminal(r) {
+  if (r.running || !r.note) return r;
+  return {
+    ...r,
+    note: `No pre-mortem on ${r.project} yet. Start one with harbor premortem "${r.project}" --start.`,
+  };
+}
+
+/** Commands whose forms do different things: one line each, saying which read and which write. */
+const DETAIL = {
+  premortem: [
+    "  harbor premortem PROJECT               reads it: the question, the time left,",
+    "                                         and the answers you may see",
+    "  harbor premortem PROJECT --start       writes: starts one (five minutes of",
+    "                                         answering alone, then they show)",
+    '  harbor premortem PROJECT "ANSWER"      writes: adds your answer',
+    '  harbor premortem PROJECT "ANSWER" --start',
+    "                                         writes: starts one and adds your answer",
+    "",
+    "  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, a key like RR, or an id. When two projects share a",
+    "  name, give the key.",
+  ],
+};
+
 /** The lines of the help about one command, or null when it has none. */
 export function commandHelp(command) {
   const lines = HELP.split("\n");
@@ -272,12 +313,14 @@ 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;
   const common = ["signup", "login", "logout", "use", "theme", "help", "app"].includes(command)
     ? []
@@ -285,6 +328,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 = [];
@@ -350,9 +427,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;
     }
@@ -377,7 +454,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;
@@ -479,7 +556,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,
@@ -529,7 +619,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.`,
@@ -538,7 +628,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());
@@ -579,7 +669,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)
@@ -591,11 +681,13 @@ export async function run(argv, io = {}) {
     width: process.stdout.isTTY ? process.stdout.columns : undefined,
   };
 
-  const call = async (name, args, show) => {
-    const result = await client.call(name, args).catch((err) => {
-      if (err instanceof HarborError) throw new HarborError(hint(err.message));
-      throw err;
-    });
+  const call = async (name, args, show, forTerminal = (r) => r) => {
+    const result = forTerminal(
+      await client.call(name, args).catch((err) => {
+        if (err instanceof HarborError) throw new HarborError(hint(err.message));
+        throw err;
+      }),
+    );
     // The prompt's counts are behind now; its next draw fetches new ones.
     if (name === "create_task" || name === "update_task") await stalePromptCache(env);
     out(asJson ? jsonText(result) : plain(show(result)));
@@ -744,13 +836,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}`));
@@ -758,13 +851,13 @@ 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(
@@ -819,7 +912,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
@@ -886,7 +979,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,
@@ -912,7 +1005,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)),
@@ -945,7 +1038,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") },
@@ -1016,7 +1109,7 @@ export async function run(argv, io = {}) {
             : `Added your answer (${r.answered.yourAnswers} so far).`,
         );
       }
-      return call("get_premortem", { harbor, project }, premortemText);
+      return call("get_premortem", { harbor, project }, premortemText, premortemForTerminal);
     }
     case "voyage": {
       const { positionals, harbor } = parse(spec());

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}`,
@@ -214,7 +217,7 @@ export function premortemText(r) {
 
 /** A project's voyage log, as get_voyage_log answers it. */
 export function voyageText(r) {
-  const head = [`Voyage log · ${r.project}${r.done ? ` · Done ${r.finished}` : ""}`];
+  const head = [`Voyage log · ${r.project}${r.done ? ` · Done ${r.finished}` : " · not Done yet"}`];
   if (r.note) head.push(r.note);
   head.push((r.stats ?? []).join(" · "));
   const story = (r.story ?? []).map((s) => `  - ${s}`);

package/package.json

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