@harborppm/cli 0.7.1 → 0.9.0

package/README.md

@@ -63,12 +63,12 @@ It runs on the same engine as the website: health, task keys, limits and undo wo
 
 ```
 harbor harbors                              the harbors you belong to
-harbor use HARBOR|none                      the harbor commands mean when you're in several
+harbor use HARBOR|none                      the harbor to work in when you're in several
 harbor mine                                 what's on you, late first
 harbor tasks [words] [--project P] [--assignee me|none|NAME] [--late] [--status S,S]
 harbor show TASK                            one task in full
 
-harbor add "TITLE" --project P [--assignee me|NAME] [--due YYYY-MM-DD]
+harbor add "TITLE" --project P [--assignee me|NAME] [--due DATE]
                    [--priority low|medium|high|urgent] [--status S] [--over-limit]
 harbor start TASK | review TASK | done TASK [--confirm] [--over-limit]
 harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|none]
@@ -76,14 +76,14 @@ harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|none]
 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]
-                   [--owner NAME] [--due YYYY-MM-DD]
+                   [--owner NAME] [--due DATE]
 harbor issue "TITLE" --project P|--program P [--impact 1-5] [--owner NAME]
-                    [--due YYYY-MM-DD]
+                    [--due DATE]
 ```
 
-Every command takes `--json` for the raw result, and `harbor COMMAND --help` shows just that command. Statuses are backlog, todo, doing, review and done.
+Every command takes `--json` for the raw result, 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.
 
-When you belong to more than one harbor, say which: `--harbor NAME` on the command, or `harbor use NAME` once (it's saved with your sign-in; `harbor use none` forgets it). With neither, the commands ask rather than guess, so nothing lands in the wrong harbor. The full-screen app opens the one `harbor use` set too.
+When you belong to more than one harbor, say which: `--harbor NAME` on the command, or `harbor use NAME` once (it's saved with your sign-in; `harbor use none` forgets it). With neither, the commands ask rather than guess, so nothing lands in the wrong harbor. The full-screen app shares the same choice: it opens the harbor `harbor use` set, asks which one the first time if none is set, and a harbor you switch to in the app becomes the one the commands use.
 
 Harbor holds back what it would hold back in the app: finishing a task that still waits on another, or going past a column's limit. The CLI says so and names the flag that goes ahead (`--confirm`, `--over-limit`).
 

package/dist/app.mjs

@@ -2298,12 +2298,21 @@ function PriorityMark({ priority }) {
 function Heading({ children, right }) {
 	return /* @__PURE__ */ jsxs(Box, {
 		justifyContent: "space-between",
-		children: [/* @__PURE__ */ jsx(Text, {
-			bold: true,
-			children
-		}), right ? /* @__PURE__ */ jsx(Text, {
-			color: theme.muted,
-			children: right
+		columnGap: 2,
+		children: [/* @__PURE__ */ jsx(Box, {
+			flexShrink: 1,
+			children: /* @__PURE__ */ jsx(Text, {
+				bold: true,
+				wrap: "truncate-end",
+				children
+			})
+		}), right ? /* @__PURE__ */ jsx(Box, {
+			flexShrink: 2,
+			children: /* @__PURE__ */ jsx(Text, {
+				color: theme.muted,
+				wrap: "truncate-end",
+				children: right
+			})
 		}) : null]
 	});
 }
@@ -2917,7 +2926,7 @@ function HistoryView({ active, width, height, go }) {
 						on ? "› " : "  ",
 						/* @__PURE__ */ jsx(Text, {
 							color: theme.muted,
-							children: timeAgo(parseIso(row.at)).padEnd(10)
+							children: `${timeAgo(parseIso(row.at))} `.padEnd(16)
 						}),
 						/* @__PURE__ */ jsx(Text, {
 							bold: true,
@@ -2972,7 +2981,9 @@ function constraintIdle(data, constraint) {
 	if (constraint.status !== "active" || !constraint.ownerId) return false;
 	const tasks = tasksInProgramOf(data, constraint.programId);
 	if (!tasks.some((t) => t.status !== "done")) return false;
-	return !tasks.some((t) => t.assigneeId === constraint.ownerId && t.status === "doing");
+	if (tasks.some((t) => t.assigneeId === constraint.ownerId && t.status === "doing")) return false;
+	const here = new Set(tasks.map((t) => t.id));
+	return data.tasks.some((t) => t.assigneeId === constraint.ownerId && t.status === "doing" && !here.has(t.id));
 }
 
 //#endregion
@@ -3041,7 +3052,7 @@ function inboxOf(data, personId, now = clockNow()) {
 		});
 	}
 	for (const blocker of mine) {
-		const waiting = (waitersByBlocker(data.tasks).get(blocker.id) ?? []).filter((t) => t.status !== "done" && t.id !== blocker.id);
+		const waiting = (waitersByBlocker(data.tasks).get(blocker.id) ?? []).filter((t) => t.status !== "done" && t.id !== blocker.id && t.assigneeId !== blocker.assigneeId);
 		if (waiting.length === 0) continue;
 		const project = projectOf(data, blocker);
 		const names = [...new Set(waiting.map((t) => {
@@ -3267,6 +3278,7 @@ function weeklyLoad(tasks, personId, now, weeks = 6) {
 
 //#endregion
 //#region src/tui/views/lists.tsx
+const count = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
 function RowList({ title, right, rows, empty, active, width, height, onOpen, keys = {} }) {
 	const [at, setAt] = useState(0);
 	const row = rows[Math.min(at, rows.length - 1)];
@@ -3368,7 +3380,7 @@ function ProjectsView({ active, width, height, go }) {
 	]);
 	return /* @__PURE__ */ jsx(RowList, {
 		title: "Portfolios, programs and projects",
-		right: `${projects.length} projects · n new project · e edit`,
+		right: `${count(projects.length, "project")} · n new project · e edit`,
 		rows,
 		empty: "No projects yet. n adds one.",
 		active,
@@ -3413,7 +3425,7 @@ function ProgramsView({ active, width, height, go }) {
 	]);
 	return /* @__PURE__ */ jsx(RowList, {
 		title: "Programs",
-		right: `${programs.length} programs · n new · e edit`,
+		right: `${count(programs.length, "program")} · n new · e edit`,
 		rows,
 		empty: "No programs yet. n adds one.",
 		active,
@@ -3502,7 +3514,7 @@ function PeopleView({ active, width, height, go }) {
 	]);
 	return /* @__PURE__ */ jsx(RowList, {
 		title: "People",
-		right: `${people.length} people · Enter to change`,
+		right: `${people.length === 1 ? "1 person" : `${people.length} people`} · Enter to change`,
 		rows,
 		empty: "Nobody here yet. Invite people from the website.",
 		active,
@@ -3801,7 +3813,7 @@ function NewTask({ projectId, status, width, onDone, onFull }) {
 	if (!chosen) return /* @__PURE__ */ jsx(Box, {
 		width,
 		children: /* @__PURE__ */ jsx(Picker, {
-			title: "New task in which project?",
+			title: projects.length ? "New task in which project?" : "No projects yet. Esc, then 3 for Projects and n to start one.",
 			choices: projects.map((p) => ({
 				label: p.name,
 				value: p.id,
@@ -3816,7 +3828,7 @@ function NewTask({ projectId, status, width, onDone, onFull }) {
 		children: /* @__PURE__ */ jsx(TextField, {
 			label: `New task in ${chosen.name}${status ? ` · ${STATUS_LABEL[status]}` : ""}`,
 			placeholder: "What needs doing?",
-			hint: "Enter adds it (yours, to do) · Esc leaves it",
+			hint: `Enter adds it (yours, ${STATUS_LABEL[status ?? "todo"].toLowerCase()}) · Esc leaves it`,
 			onCancel: () => onDone(null),
 			onSubmit: (title) => {
 				if (!title.trim()) return onDone(null);
@@ -3853,24 +3865,21 @@ function HarborSwitch({ harbors, current, width, onPick, onClose }) {
 	});
 }
 const HELP = [
-	["1–8", "Today, Inbox, Projects, Programs, Risks, People, Roadmap, History"],
-	[":", "anything: a screen, something new, a project or program by name"],
+	["1–8", "the screens, as the sidebar lists them"],
+	[":", "anything: a screen, something new, a name"],
 	["/", "find a task by key or words"],
 	["H", "switch harbor"],
 	["Tab", "between the sidebar and the screen"],
-	["↑↓ or j k", "move; ←→ or h l across board columns and lists"],
-	["Enter", "open"],
-	["Esc", "back"],
-	["n", "new: a task, or what the screen lists (project, program, risk)"],
-	["e", "change what's open: its health, lead, dates, budget"],
+	["↑↓ or j k", "move; ←→ or h l across columns and lists"],
+	["Enter / Esc", "open / back"],
+	["n", "new: a task, or what the screen lists"],
+	["e", "change what's open (health, lead, dates)"],
 	["[ ]", "move a card one column left or right"],
-	["x", "mark done"],
-	["d", "delete (asks first)"],
-	["u", "undo your last change"],
+	["x / d", "mark done / delete (asks first)"],
+	["u / r", "undo your last change / retry saving"],
 	["v", "on a project: board, list, budget"],
-	["m / R", "on a program: new milestone; anywhere: log a risk"],
+	["m / R", "new milestone on a program / log a risk"],
 	["c / a", "on a task: comment / add a checklist step"],
-	["r", "retry saving now"],
 	["q", "quit (saves first)"]
 ];
 /**
@@ -3878,7 +3887,7 @@ const HELP = [
 * the 16-pixel mark, and the box's border and padding. Narrower, the lines
 * would wrap and split the mark.
 */
-const HELP_WITH_MARK = 11 + Math.max(...HELP.map(([, what]) => what.length)) + 2 + LOGO_SMALL[0].length + 4;
+const HELP_WITH_MARK = 13 + Math.max(...HELP.map(([, what]) => what.length)) + 2 + LOGO_SMALL[0].length + 4;
 function Help({ width, onClose }) {
 	useInput((input, key) => {
 		if (key.escape || key.return || input === "?" || input === "q") onClose();
@@ -3899,11 +3908,11 @@ function Help({ width, onClose }) {
 				}),
 				HELP.map(([k, what]) => /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
 					bold: true,
-					children: k.padEnd(11)
+					children: k.padEnd(13)
 				}), what] }, k)),
 				/* @__PURE__ */ jsx(Text, {
 					color: theme.muted,
-					children: "Everything saves as you go, and shows on the website for everyone."
+					children: "Everything saves as you go and shows on the website."
 				})
 			]
 		}), width >= HELP_WITH_MARK ? /* @__PURE__ */ jsxs(Box, {
@@ -4911,7 +4920,7 @@ function PortfolioView({ portfolioId, active, width, height, go, onBack }) {
 			}),
 			/* @__PURE__ */ jsx(Text, { children: " " }),
 			/* @__PURE__ */ jsx(Heading, {
-				right: `${list.length} programs`,
+				right: `${list.length} program${list.length === 1 ? "" : "s"}`,
 				children: "Programs"
 			}),
 			list.length === 0 ? /* @__PURE__ */ jsx(Text, {
@@ -5047,6 +5056,9 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 	const { done, total } = projectSummary(data, project);
 	const lead = people.find((p) => p.id === project.ownerId);
 	const body = height - 3;
+	const fit = Math.max(1, Math.floor((width - 2) / 14));
+	const firstColumn = Math.min(Math.max(0, col - Math.floor(fit / 2)), Math.max(0, columns.length - fit));
+	const shownColumns = columns.slice(firstColumn, firstColumn + fit);
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		width,
@@ -5055,36 +5067,44 @@ function ProjectView({ projectId, 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: project.name
-						}),
-						" ",
-						/* @__PURE__ */ jsx(Text, {
-							color: theme.muted,
-							children: project.key
-						}),
-						" ",
-						/* @__PURE__ */ jsx(HealthMark, {
-							health: project.health,
-							label: true
-						})
-					]
-				}), /* @__PURE__ */ jsxs(Text, {
-					color: theme.muted,
-					children: [
-						done,
-						" of ",
-						total,
-						" done",
-						lead ? ` · ${lead.name}` : "",
-						" · ",
-						mode,
-						" · v next · e details"
-					]
+				columnGap: 2,
+				children: [/* @__PURE__ */ jsx(Box, {
+					flexShrink: 1,
+					children: /* @__PURE__ */ jsxs(Text, {
+						wrap: "truncate-end",
+						children: [
+							/* @__PURE__ */ jsx(Text, {
+								bold: true,
+								children: project.name
+							}),
+							" ",
+							/* @__PURE__ */ jsx(Text, {
+								color: theme.muted,
+								children: project.key
+							}),
+							" ",
+							/* @__PURE__ */ jsx(HealthMark, {
+								health: project.health,
+								label: true
+							})
+						]
+					})
+				}), /* @__PURE__ */ jsx(Box, {
+					flexShrink: 2,
+					children: /* @__PURE__ */ jsxs(Text, {
+						color: theme.muted,
+						wrap: "truncate-end",
+						children: [
+							done,
+							" of ",
+							total,
+							" done",
+							lead ? ` · ${lead.name}` : "",
+							" · ",
+							mode,
+							" · v next · e details"
+						]
+					})
 				})]
 			}),
 			/* @__PURE__ */ jsx(Text, {
@@ -5100,8 +5120,9 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 				today: day
 			}) : mode === "board" ? /* @__PURE__ */ jsx(Box, {
 				height: body,
-				children: columns.map((c, ci) => {
-					const w = Math.max(14, Math.floor((width - 2) / columns.length));
+				children: shownColumns.map((c, i) => {
+					const ci = firstColumn + i;
+					const w = Math.floor((width - 2) / shownColumns.length);
 					const on = active && ci === col;
 					const r = Math.min(rowByCol[ci] ?? 0, Math.max(0, c.tasks.length - 1));
 					const view = windowOf(c.tasks, r, Math.max(1, Math.floor((body - 3) / 3)));
@@ -5113,19 +5134,33 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 						borderColor: on ? theme.accent : theme.border,
 						paddingX: 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.limit != null ? `/${c.limit}` : ""]
+							/* @__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.limit != null ? `/${c.limit}` : ""]
+											})
+										]
 									})
-								]
-							}),
+								}),
+								i === shownColumns.length - 1 && ci < columns.length - 1 ? /* @__PURE__ */ jsx(Text, {
+									color: theme.muted,
+									children: " ›"
+								}) : null
+							] }),
 							c.tasks.length === 0 ? /* @__PURE__ */ jsx(Text, {
 								color: theme.muted,
 								children: "—"
@@ -5883,7 +5918,7 @@ const SAVE_LABEL = {
 	offline: ["● offline, will save", "bad"]
 };
 function App({ ui }) {
-	const { store, sync, account, harbors, today } = useDeps();
+	const { store, sync, account, harbors, today, remember } = useDeps();
 	const { exit } = useApp();
 	const { columns, rows } = useWindowSize();
 	const harborName = useHarbor((s) => s.harborName);
@@ -5976,7 +6011,10 @@ function App({ ui }) {
 	const switchHarbor = (id) => {
 		goScreen("today");
 		notify("Opening…");
-		sync.flush().then(() => sync.open(id)).then((h) => notify(`Opened ${h.name}.`)).catch((e) => notify(`Couldn't open it: ${e.message}`));
+		sync.flush().then(() => sync.open(id)).then(async (h) => {
+			const saved = remember ? await remember(h).then(() => true, () => false) : false;
+			notify(saved ? `Opened ${h.name}. Commands use it too.` : `Opened ${h.name}.`);
+		}).catch((e) => notify(`Couldn't open it: ${e.message}`));
 	};
 	const quit = async () => {
 		setQuitting(true);
@@ -7209,6 +7247,104 @@ function normalizeRules(rules) {
 	};
 }
 
+//#endregion
+//#region src/lib/sample-project.ts
+/**
+* A small project a new harbor can add to try things on: a few cards in each
+* column, one that waits on another, a checklist and a risk. Nothing is late,
+* so it doesn't turn a fresh harbor red, and every card says what to try.
+*/
+const SAMPLE_PROJECT_NAME = "Website refresh (sample)";
+function sampleProject(opts) {
+	const { ownerId, today, now, makeId } = opts;
+	const day = (n) => todayISO(addDays(parseDate$1(today), n));
+	const end = opts.programEnd && opts.programEnd < day(30) ? opts.programEnd : day(30);
+	const projectId = makeId("pj");
+	const project = {
+		id: projectId,
+		programId: opts.programId,
+		name: SAMPLE_PROJECT_NAME,
+		description: "A project to try things on. Move cards, add tasks, change dates. Delete it from Details when you’re done.",
+		swatch: "sea",
+		ownerId,
+		health: "on-track",
+		startDate: today,
+		endDate: end,
+		budget: 0,
+		spent: 0
+	};
+	const task = (title, status, o = {}) => ({
+		id: makeId("t"),
+		projectId,
+		title,
+		description: o.description ?? "",
+		status,
+		priority: o.priority ?? "medium",
+		assigneeId: ownerId,
+		dueDate: o.due == null ? null : day(o.due),
+		createdAt: now,
+		completedAt: status === "done" ? now : null,
+		checklist: (o.checklist ?? []).map(([t, done]) => ({
+			id: makeId("ck"),
+			title: t,
+			done
+		})),
+		blockedById: o.waitsOn ?? null,
+		blockedByIds: o.waitsOn ? [o.waitsOn] : []
+	});
+	const draft = task("Draft the new home page", "doing", {
+		description: "A sample card. Tick the checklist, leave a comment, or drag it to Review on the board.",
+		due: 3,
+		priority: "high",
+		checklist: [
+			["Headline and one line under it", true],
+			["Three reasons to stay", false],
+			["One clear button", false]
+		]
+	});
+	return {
+		project,
+		tasks: [
+			task("Agree what the refresh is for", "done", { description: "Finished. Move it back if it turns out it wasn’t." }),
+			task("List the pages people actually use", "done"),
+			draft,
+			task("Write the pricing page copy", "review", {
+				description: "Waiting for a second pair of eyes. Move it to Done when it reads well.",
+				due: 5
+			}),
+			task("Pick the photos", "todo", {
+				description: "Hand this one to someone else from the card’s Owner field.",
+				due: 7
+			}),
+			task("Check every page on a phone", "todo", {
+				description: "Waits on the home page draft, so it shows as waiting until that card is done.",
+				due: 10,
+				waitsOn: draft.id
+			}),
+			task("Send old links to the new pages", "backlog", { description: "No date yet. Backlog is for what isn’t planned." }),
+			task("Tell customers what changed", "backlog", { priority: "low" })
+		],
+		raidItems: [{
+			id: makeId("r"),
+			kind: "risk",
+			projectId,
+			title: "Photos may not be cleared in time",
+			description: "A sample risk. If the photos aren’t licensed before launch, the home page ships with placeholders.",
+			severity: "medium",
+			status: "open",
+			ownerId,
+			dueDate: day(7),
+			probability: 3,
+			impact: 3,
+			mitigation: "Shortlist stock photos we already own as a fallback.",
+			createdById: ownerId,
+			createdAt: now,
+			updatedAt: now,
+			updates: []
+		}]
+	};
+}
+
 //#endregion
 //#region src/lib/slices/hierarchy.ts
 /** Portfolios, programs and projects: create, edit, custom fields, automations, health overrides, boards and cascading delete. */
@@ -7256,6 +7392,31 @@ function hierarchySlice({ get, write }) {
 			get().log(`opened project ${row.name}`, `/projects/${id}`);
 			return id;
 		},
+		addSampleProject: () => {
+			const state = get();
+			const program = state.programs[0];
+			if (!program) return null;
+			const rows = sampleProject({
+				programId: program.id,
+				ownerId: state.currentUserId,
+				today: todayISO(),
+				programEnd: program.endDate,
+				now: stamp(),
+				makeId: uid
+			});
+			const id = rows.project.id;
+			write({
+				projects: [...state.projects, rows.project],
+				tasks: [...state.tasks, ...rows.tasks],
+				raidItems: [...state.raidItems, ...rows.raidItems],
+				boardConfigs: {
+					...state.boardConfigs ?? {},
+					[id]: defaultBoardConfig()
+				}
+			});
+			get().log(`added the sample project`, `/projects/${id}`);
+			return id;
+		},
 		updatePortfolio: (id, patch) => {
 			write({ portfolios: get().portfolios.map((p) => p.id === id ? {
 				...p,
@@ -8729,6 +8890,7 @@ function httpTransport(source, fetcher = fetch) {
 			}
 		} catch (error) {
 			if (error instanceof TransportError) throw error;
+			if (error?.signedOut) throw error;
 			throw new TransportError("Can't reach Harbor.", 0, true);
 		}
 		const answer = await res.json().catch(() => ({}));
@@ -9076,6 +9238,26 @@ function addFirstProject(store, name, accountId, today) {
 		ownerId: me?.id ?? ""
 	}, { programId: program.id }, today);
 }
+/**
+* Someone in several harbors with none picked: ask which, as the commands
+* would refuse to guess. A number from the list or a name answers; anything
+* else asks again.
+*/
+async function pickHarbor(deps) {
+	deps.say(`You're in ${deps.harbors.length} harbors. Which one should harbor open?`);
+	deps.harbors.forEach((h, i) => deps.say(`  ${i + 1}. ${h.name}`));
+	for (;;) {
+		const answer = (await deps.ask(`Number or name (1-${deps.harbors.length}): `)).trim();
+		if (!answer) continue;
+		const n = Number(answer);
+		if (Number.isInteger(n) && n >= 1 && n <= deps.harbors.length) return deps.harbors[n - 1];
+		try {
+			return deps.named(answer);
+		} catch (error) {
+			deps.say(error.message);
+		}
+	}
+}
 
 //#endregion
 //#region src/tui/main.tsx
@@ -9131,7 +9313,8 @@ async function startApp(deps, options = {}) {
 			transport,
 			account,
 			harbors,
-			today
+			today,
+			remember: deps.remember
 		},
 		children: /* @__PURE__ */ jsx(App, { ui })
 	}));
@@ -9186,6 +9369,22 @@ async function runApp(opts) {
 			terminal.close();
 		}
 	} else if (opts.harbor) workspaceId = harborNamed(harbors, opts.harbor).id;
+	else if (opts.saved && harbors.some((h) => h.id === opts.saved)) workspaceId = opts.saved;
+	else if (harbors.length > 1) {
+		const terminal = terminalAsk();
+		try {
+			const picked = await pickHarbor({
+				ask: terminal.ask,
+				say: (line) => process.stdout.write(`${plain(line)}\n`),
+				harbors,
+				named: (key) => harborNamed(harbors, key)
+			});
+			workspaceId = picked.id;
+			await opts.remember?.(picked);
+		} finally {
+			terminal.close();
+		}
+	}
 	const { instance } = await startApp({
 		transport,
 		account,
@@ -9193,7 +9392,8 @@ async function runApp(opts) {
 		workspaceId,
 		splashMs: SPLASH_MS,
 		theme,
-		firstRun
+		firstRun,
+		remember: opts.remember
 	}, { alternateScreen: true });
 	await instance.waitUntilExit();
 }

package/lib/auth.mjs

@@ -67,7 +67,7 @@ export async function listenForCode(state, { timeoutMs = 5 * 60_000 } = {}) {
     if (ok) settle.resolve(url.searchParams.get("code"));
     else
       settle.reject(
-        new Error(
+        new HarborError(
           error === "access_denied"
             ? "You declined in the browser."
             : "The sign-in didn't come back as expected.",
@@ -77,7 +77,7 @@ export async function listenForCode(state, { timeoutMs = 5 * 60_000 } = {}) {
   await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
   const { port } = server.address();
   const timer = setTimeout(
-    () => settle.reject(new Error("No answer from the browser in 5 minutes.")),
+    () => settle.reject(new HarborError("No answer from the browser in 5 minutes. Run harbor login to try again.")),
     timeoutMs,
   );
   const done = code.finally(() => {
@@ -178,7 +178,10 @@ export async function refresh(creds, { fetcher = fetch, now = Date.now } = {}) {
   // Refused: the sign-in was disconnected in Harbor, or renewed by another
   // copy of these credentials (a refresh token is good once).
   if (res.status === 400 || res.status === 401) {
-    throw new HarborError("Your sign-in on this machine has ended. Run harbor login.");
+    const ended = new HarborError("Your sign-in on this machine has ended. Run harbor login.");
+    // The full-screen app says this rather than "Can't reach Harbor".
+    Object.assign(ended, { signedOut: true });
+    throw ended;
   }
   const tokens = await json(res, "Refreshing your sign-in");
   return toCredentials(creds.server, creds.tokenEndpoint, creds.clientId, tokens, now());

package/lib/cli.mjs

@@ -23,36 +23,39 @@ import { jsonText, plain } from "./plain.mjs";
 
 export const HELP = `harbor: Harbor from the terminal
 
-  harbor                                      the full-screen app: everything, with the keyboard
-  harbor signup [--server URL]                new to Harbor: make an account (opens your browser)
+  harbor                                      the full-screen app, by keyboard
+  harbor signup [--server URL]                new to Harbor: make an account
   harbor login [--server URL] [--read-only]   sign in (opens your browser once)
   harbor logout                               forget the sign-in on this machine
   harbor harbors                              the harbors you belong to
-  harbor use HARBOR|none                      the harbor commands mean when you're in several
-  harbor theme [auto|light|dark]              the app's colours (auto asks the terminal)
+  harbor use HARBOR|none                      the harbor to work in
+  harbor theme [auto|light|dark]              the app's colours
   harbor --version                            which version this is
 
   harbor mine                                 what's on you, late first
-  harbor tasks [words] [--project P] [--assignee me|none|NAME] [--late] [--status S,S]
-  harbor show TASK                            one task in full (TASK: its key, RR-42, or id)
+  harbor tasks [words] [--project P] [--assignee me|none|NAME]
+                     [--late] [--status S,S]
+  harbor show TASK                            one task (TASK: a key like RR-42)
 
-  harbor add "TITLE" --project P [--assignee me|NAME] [--due YYYY-MM-DD]
-                     [--priority low|medium|high|urgent] [--status S] [--over-limit]
+  harbor add "TITLE" --project P [--assignee me|NAME] [--due DATE]
+                     [--priority low|medium|high|urgent] [--status S]
+                     [--over-limit]
   harbor start TASK | review TASK | done TASK [--confirm] [--over-limit]
   harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|none]
                    [--priority P] [--status S] [--confirm] [--over-limit]
   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]
-                     [--owner NAME] [--due YYYY-MM-DD]
+                     [--owner NAME] [--due DATE]
   harbor issue "TITLE" --project P|--program P [--impact 1-5] [--owner NAME]
-                       [--due YYYY-MM-DD]
+                       [--due DATE]
 
-  Every command takes --json, and --harbor NAME when you're in more than one harbor
-  (or set one with harbor use). harbor COMMAND --help shows just that command.
+  Every command takes --json, and --harbor NAME when you're in more than one
+  harbor (or set one with harbor use). harbor help COMMAND shows just that one.
   Statuses: backlog, todo, doing, review, done.
-  Changes show in Harbor's History as yours, "via Harbor CLI". These commands never
-  delete; the full-screen app can, as the website can, and asks first.
+  DATE: YYYY-MM-DD, today, tomorrow, or +N for N days from today.
+  Changes show in Harbor's History as yours, "via Harbor CLI". These commands
+  never delete; the full-screen app can, as the website can, and asks first.
 `;
 
 export const VERSION = JSON.parse(
@@ -125,6 +128,16 @@ const level = (v, name) => {
 };
 const nullable = (v) => (v === "none" ? null : v);
 
+/** --due as people say it: today, tomorrow, +3, or a date. Anything else goes to Harbor to judge. */
+export function dueDate(v, today = new Date()) {
+  if (v === undefined || v === null) return v;
+  const words = { today: 0, tomorrow: 1 };
+  const days = v in words ? words[v] : /^\+\d{1,3}$/.test(v) ? Number(v.slice(1)) : null;
+  if (days === null) return v;
+  const d = new Date(today.getFullYear(), today.getMonth(), today.getDate() + days);
+  return todayLocal(d);
+}
+
 /** Harbor's tool fields, as the CLI's flags. */
 const FLAG = {
   due: "--due",
@@ -158,7 +171,13 @@ export function hint(message) {
       const [path, ...why] = issue.split(": ");
       const field = path.replace(/\.\d+$/, "");
       const flag = FLAG[field] ?? `--${field}`;
-      if (!seen.has(flag)) seen.set(flag, why.join(": "));
+      // zod's "Invalid option: expected one of "low"|"high"" reads as the choices.
+      const said = why
+        .join(": ")
+        .replace(/^Invalid option: expected one of (.*)$/, (_, list) =>
+          `pick one of ${list.replace(/"/g, "").split("|").join(", ")}`,
+        );
+      if (!seen.has(flag)) seen.set(flag, said);
     }
     return [...seen].map(([flag, why]) => `${flag}: ${why}`).join("\n");
   }
@@ -168,6 +187,10 @@ 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(
+      /^Nothing to change: pass a field to update\.$/,
+      "Nothing to change. Say what with --title, --assignee, --due, --priority or --status.",
+    )
     .replace(
       /^This connection was allowed to read only\..*$/s,
       "This sign-in can only read. To make changes, run harbor login again.",
@@ -233,6 +256,13 @@ export async function run(argv, io = {}) {
   const [command, ...rest] = commandFirst(argv);
 
   if (command === "help" || command === "--help" || command === "-h") {
+    // `harbor help mine`: that command's help, as `harbor mine --help` gives it.
+    if (rest[0]) {
+      const help = commandHelp(rest[0]);
+      if (help === null) throw new HarborError(`No command "${rest[0]}". Run harbor help.`);
+      out(help);
+      return 0;
+    }
     const top = banner(io, env, ({ bold, dim }) => [
       bold("Harbor"),
       "Portfolios, programs and projects,",
@@ -296,10 +326,26 @@ export async function run(argv, io = {}) {
       }
     }
     const { runApp } = await loadApp();
+    // The app and the commands share one harbor choice: what harbor use set,
+    // or what's picked or switched to in the app. Each write reads the file
+    // first, so a renewed token and a new choice don't undo each other.
+    const keepHarbor = async (c) => {
+      const now = await readCredentials(env);
+      return now ? { ...c, harbor: now.harbor ?? null, harborName: now.harborName ?? null } : c;
+    };
     await runApp({
-      source: tokenSource({ creds, save: (c) => writeCredentials(c, env), fetcher }),
+      source: tokenSource({
+        creds,
+        save: async (c) => writeCredentials(await keepHarbor(c), env),
+        fetcher,
+      }),
       fetcher,
-      harbor: values.harbor ?? creds.harbor ?? undefined,
+      harbor: values.harbor,
+      saved: creds.harbor ?? null,
+      remember: async (h) => {
+        const now = (await readCredentials(env)) ?? creds;
+        await writeCredentials({ ...now, harbor: h.id, harborName: h.name }, env);
+      },
       theme: (await readSettings(env)).theme,
     });
     return 0;
@@ -382,6 +428,10 @@ export async function run(argv, io = {}) {
     return 0;
   }
 
+  // A mistyped command says so, signed in or not.
+  if (commandHelp(command) === null) {
+    throw new HarborError(`No command "${command}". Run harbor help.`);
+  }
   const creds = await readCredentials(env);
   if (!creds)
     throw new HarborError("Not signed in. Run harbor login, or harbor signup if you're new.");
@@ -419,7 +469,7 @@ export async function run(argv, io = {}) {
         out(
           creds.harbor
             ? plain(`Commands use ${creds.harborName ?? creds.harbor}.`)
-            : "No harbor set: commands use your only harbor, or the one --harbor names.",
+            : "No harbor set. In one harbor, commands use it; in several, set one with harbor use NAME or say --harbor NAME.",
         );
         return 0;
       }
@@ -518,7 +568,7 @@ export async function run(argv, io = {}) {
           project: values.project,
           title: text(positionals, "the task"),
           assignee: values.assignee,
-          due: values.due,
+          due: dueDate(values.due),
           priority: values.priority,
           status: values.status,
           overLimit: values["over-limit"] || undefined,
@@ -560,7 +610,7 @@ export async function run(argv, io = {}) {
           task: one(positionals, "task id"),
           title: values.title,
           assignee: values.assignee,
-          due: values.due === undefined ? undefined : nullable(values.due),
+          due: values.due === undefined ? undefined : nullable(dueDate(values.due)),
           priority: values.priority,
           status: values.status,
           confirmed: values.confirm || undefined,
@@ -616,9 +666,9 @@ export async function run(argv, io = {}) {
           owner: values.owner,
           impact: level(values.impact, "impact"),
           probability: level(values.probability, "probability"),
-          due: values.due,
+          due: dueDate(values.due),
         },
-        (r) => `Logged the ${command} (${r.raised.id}).`,
+        (r) => `Logged the ${command} “${r.raised.title}”.`,
       );
     }
     default:

package/lib/format.mjs

@@ -36,7 +36,8 @@ export function myWork(w, opts) {
   if (w.raid?.length) {
     out.push("", "Yours in the register:");
     for (const r of w.raid)
-      out.push(`  ${r.id}  ${r.kind}: ${r.title}${r.due ? ` (review by ${r.due})` : ""}`);
+      // No command takes a risk's id, so it isn't shown.
+      out.push(`  ${r.kind}: ${r.title}${r.due ? ` (review by ${r.due})` : ""}`);
   }
   return out.join("\n");
 }
@@ -53,7 +54,14 @@ export function taskList(r, opts) {
 export function harbors(r) {
   const list = r.harbors ?? [];
   if (!list.length) return "You aren't in any harbor yet. Run harbor to make one.";
-  return list.map((h) => `${h.id}  ${h.name}${h.role ? `  (${h.role})` : ""}`).join("\n");
+  // The website's words for a role, not the stored ones; names, not ids
+  // (harbor use and --harbor take a name).
+  const label = (role) =>
+    role === "owner" ? "Owner" : role === "viewer" ? "Can view" : role ? "Can edit" : "";
+  const width = Math.min(40, Math.max(...list.map((h) => h.name.length)));
+  return list
+    .map((h) => (h.role ? `${h.name.padEnd(width)}  ${label(h.role)}` : h.name))
+    .join("\n");
 }
 
 export function todayLocal(d = new Date()) {

package/package.json

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