@harborppm/cli 0.64.0 → 0.66.0

package/README.md

@@ -117,7 +117,8 @@ Task titles, names and notes can come from an intake form, a GitHub pull request
 
 ```
 harbor harbors                              the harbors you belong to
-harbor whoami                               who you're signed in as, and where
+harbor whoami                               who you're signed in as, where, and which
+                                            build of the site answers
 harbor use HARBOR|none                      the harbor to work in when you're in several
 harbor programs                             programs and their projects
 harbor projects [words] [--program P]       projects with health and open work
@@ -131,10 +132,14 @@ harbor why PROJECT|TASK|MILESTONE           what's holding it up: the line of ta
                                             waits that sets its date, slack per link
 harbor barnacles PROJECT                    work added since the plan was set: by
                                             week, by who, and the slip it explains
+harbor baseline PROJECT [--set|--reset]     reads a project's baseline; --set commits
+                                            its dates now (--dry-run says what)
 harbor hill [--program P]                   where each project is on its hill
 harbor hill PROJECT --at 0-100|top|done     move it: up to 50 is figuring it out,
                                             past 50 is getting it done
 harbor mine                                 what's on you, late first
+harbor catchup [--since DATE]               while you were away: handed to you,
+                                            decided without you, what moved
 harbor clock [NAME] [--zone ZONE|here|none] [--hours 9-17]
                                             who's working now; set your (or NAME's) time zone and hours
 harbor tasks [words] [--project P] [--assignee me|none|NAME] [--late] [--status S,S] [--all]
@@ -184,7 +189,7 @@ harbor review [WORDS] [--mine|--owner NAME] [--portfolio P] [--done]
                                             the review: programs worst first, with next moves
                                             (reads only; harbor submit moves a task to In review)
 harbor thanks [TASK "LINE"] [--to NAME]     a one-line thanks for a task (--milestone, --decision);
-                                            on its own, the thanks you were given this month
+                                            on its own, the thanks you were given in the last 30 days
 harbor bridge                               run the review as a meeting: one project a screen,
                                             what changed since the last one, log decisions,
                                             actions and risks live, post the summary to chat

package/dist/app.mjs

@@ -3285,6 +3285,7 @@ function barnaclesOf(project, tasks, people, now, slip = null) {
 	return {
 		since,
 		from,
+		settling: from === "start" && since.slice(0, 10) > today,
 		planned,
 		added: added.length,
 		share: planned > 0 ? added.length / planned : null,
@@ -19110,6 +19111,169 @@ function pilotReasons(p, you = false) {
 	return out;
 }
 
+//#endregion
+//#region src/lib/seen-mark.ts
+/** Days without opening Harbor before the catch-up shows. */
+const UNSEEN_DAYS = 3;
+/** Calendar days from one ISO day (or moment) to another, by their dates alone. */
+function dayGap(from, to) {
+	const utc = (iso) => {
+		const [y, m, d] = iso.slice(0, 10).split("-").map(Number);
+		return Date.UTC(y, m - 1, d);
+	};
+	return Math.round((utc(to) - utc(from)) / 864e5);
+}
+/**
+* Whether to catch someone up, and from when: back from time away they were
+* marked for (a handover with a return date that has come, until this device
+* has caught them up once since), or `UNSEEN_DAYS` or more since this device
+* last saw them. Null otherwise, and the first time a device sees them:
+* there's nothing to compare with.
+*/
+function welcomeWhen(person, lastSeen, today) {
+	const away = person?.away;
+	if (away?.since && away.until && away.until.slice(0, 10) <= today) {
+		if (!lastSeen || lastSeen.slice(0, 10) < away.until.slice(0, 10)) return {
+			since: away.since,
+			why: "away",
+			days: dayGap(away.since, today)
+		};
+	}
+	if (!lastSeen) return null;
+	const days = dayGap(lastSeen, today);
+	return days >= 3 ? {
+		since: lastSeen,
+		why: "unseen",
+		days
+	} : null;
+}
+
+//#endregion
+//#region src/lib/welcome-back.ts
+init_date_text();
+init_indexes();
+init_task_keys();
+const day = (iso) => parseIso(iso.slice(0, 10));
+const daysBetween = dayGap;
+/** Their projects: ones they lead, in a program they lead, or with a task of theirs. */
+function projectsOf(data, personId) {
+	const programs = new Set(data.programs.filter((p) => p.ownerId === personId).map((p) => p.id));
+	return data.projects.filter((p) => p.ownerId === personId || programs.has(p.programId) || tasksOf(data.tasks, p.id).some((t) => t.assigneeId === personId));
+}
+const first = (p) => p?.name.split(" ")[0] ?? null;
+/** "due Thu, Oct 23", "3 days late", "due today". */
+function dueText(task, today) {
+	if (!task.dueDate) return "no due date";
+	const d = daysBetween(today, task.dueDate);
+	if (d === 0) return "due today";
+	if (d < 0) return `${-d} day${d === -1 ? "" : "s"} late`;
+	if (d === 1) return "due tomorrow";
+	return `due ${format(day(task.dueDate), "EEE, MMM d")}`;
+}
+/** What a person needs to hear about since `when.since`, as of `today` (YYYY-MM-DD). */
+function welcomeBack(data, personId, when, today) {
+	const since = when.since;
+	const people = byId(data.people);
+	const projects = projectsOf(data, personId);
+	const projectIds = new Set(projects.map((p) => p.id));
+	const programIds = new Set(projects.map((p) => p.programId));
+	const projectById = byId(data.projects);
+	const label = (t) => {
+		const p = projectById.get(t.projectId);
+		const key = p ? taskKey(t, p) : null;
+		return key ? `${key} ${t.title}` : t.title;
+	};
+	const mine = data.tasks.filter((t) => t.assigneeId === personId && t.status !== "done");
+	const handed = mine.filter((t) => t.assignedAt && t.assignedAt >= since && t.assignedBy && t.assignedBy !== personId).sort((a, b) => (a.dueDate ?? "9999").localeCompare(b.dueDate ?? "9999")).map((task) => ({
+		task,
+		by: people.get(task.assignedBy) ?? null
+	}));
+	const decisions = data.raidItems.filter((r) => r.kind === "decision" && r.status !== "proposed" && Boolean(r.decidedAt) && r.decidedAt >= since && r.decidedById !== personId && (r.projectId ? projectIds.has(r.projectId) : Boolean(r.programId && programIds.has(r.programId)))).sort((a, b) => b.decidedAt.localeCompare(a.decidedAt)).map((item) => ({
+		item,
+		by: item.decidedById ? people.get(item.decidedById) ?? null : null
+	}));
+	const moved = [];
+	for (const project of projects) {
+		const tasks = tasksOf(data.tasks, project.id);
+		const done = tasks.filter((t) => t.completedAt && t.completedAt >= since).length;
+		const added = tasks.filter((t) => t.createdAt >= since).length;
+		const history = project.healthHistory ?? [];
+		const before = [...history].reverse().find((h) => h.at < since)?.health;
+		const health = history.some((h) => h.at >= since) && before && before !== project.health ? {
+			from: before,
+			to: project.health
+		} : null;
+		if (done || added || health) moved.push({
+			project,
+			done,
+			added,
+			health
+		});
+	}
+	moved.sort((a, b) => Number(Boolean(b.health)) - Number(Boolean(a.health)) || b.done - a.done);
+	const look = [];
+	const seen = /* @__PURE__ */ new Set();
+	const push = (item) => {
+		const id = item.taskId ?? item.raidId ?? item.text;
+		if (look.length >= 3 || seen.has(id)) return;
+		seen.add(id);
+		look.push(item);
+	};
+	for (const h of handed) {
+		const by = first(h.by);
+		push({
+			kind: "handed",
+			taskId: h.task.id,
+			text: `${label(h.task)}: handed to you${by ? ` by ${by}` : ""}, ${dueText(h.task, today)}`
+		});
+	}
+	const dated = mine.filter((t) => t.dueDate).sort((a, b) => a.dueDate.localeCompare(b.dueDate));
+	for (const t of dated) if (t.dueDate.slice(0, 10) < today) push({
+		kind: "late",
+		taskId: t.id,
+		text: `${label(t)}: ${dueText(t, today)}`
+	});
+	for (const t of dated) {
+		const d = daysBetween(today, t.dueDate);
+		if (d >= 0 && d <= 3) push({
+			kind: "due",
+			taskId: t.id,
+			text: `${label(t)}: ${dueText(t, today)}`
+		});
+	}
+	for (const d of decisions) {
+		const by = first(d.by);
+		push({
+			kind: "decision",
+			raidId: d.item.id,
+			text: `Decided without you: ${d.item.title}${by ? ` (${by})` : ""}`
+		});
+	}
+	return {
+		when,
+		handed,
+		decisions,
+		moved: moved.slice(0, 6),
+		lookFirst: look,
+		quiet: !handed.length && !decisions.length && !moved.length && !look.length
+	};
+}
+/** "Welcome back, Priya · away Oct 3 to Oct 17", or "· 5 days since you last looked". */
+function welcomeTitle(w, name, today) {
+	const hi = name ? `Welcome back, ${name}` : "Welcome back";
+	if (w.when.why === "away") return `${hi} · away ${format(day(w.when.since), "MMM d")} to ${format(day(today), "MMM d")}`;
+	return `${hi} · ${w.when.days} days since you last looked`;
+}
+/** "Checkout v3: 4 done, 2 added, now At risk (was On track)". */
+function movedText(m, healthLabel) {
+	const bits = [
+		m.done ? `${m.done} done` : null,
+		m.added ? `${m.added} added` : null,
+		m.health ? `now ${healthLabel(m.health.to)} (was ${healthLabel(m.health.from)})` : null
+	].filter(Boolean);
+	return `${m.project.name}: ${bits.join(", ")}`;
+}
+
 //#endregion
 //#region src/lib/agents.ts
 const isAgent = (p) => p?.kind === "agent";
@@ -19383,6 +19547,7 @@ init_search();
 init_derived_health();
 init_format();
 init_date_text();
+init_date_fns();
 init_shipping_forecast();
 init_handover();
 init_work();
@@ -19417,6 +19582,7 @@ function barnaclesData(b) {
 	return {
 		measuredFrom: b.from === "baseline" ? "when the baseline was set" : "a week after its first task was made",
 		since: b.since,
+		settling: b.settling,
 		planned: b.planned,
 		added: b.added,
 		addedPercent: b.share == null ? null : Math.round(b.share * 100),
@@ -19999,7 +20165,9 @@ const HARBOR_TOOLS = [
 				} : {},
 				starts: dayOf(p.startDate),
 				ends: dayOf(p.endDate),
+				...p.baselineStart ? { baselineStarts: dayOf(p.baselineStart) } : {},
 				...p.baselineEnd ? { baselineEnds: dayOf(p.baselineEnd) } : {},
+				...p.baselineAt ? { baselineSetAt: p.baselineAt } : {},
 				budget: p.budget,
 				spent: p.spent,
 				tasks: byStatus,
@@ -20201,6 +20369,67 @@ const HARBOR_TOOLS = [
 			return weekOut(ctx.data, mine.id, weekOf(input.week ?? todayISO(ctx.now)));
 		}
 	}),
+	tool({
+		name: "catch_up",
+		title: "While you were away",
+		description: "The catch-up the website and the terminal app open on after time away or a few days unseen (while you were away): tasks handed to the person since then and by whom, decisions made on their projects without them, what moved on their projects (done, added, health changes), and the three to look at first. It counts from the start of time away they were marked for once its return date has come, else from since (when they last looked; any ISO date or moment), else the last 7 days. Reading it doesn't clear the catch-up anywhere." + DATA_NOTE,
+		input: object({
+			harbor: harborArg,
+			since: string().regex(/^\d{4}-\d{2}-\d{2}/, "a date as YYYY-MM-DD, or an ISO moment").max(40).optional().describe("When the person last looked, YYYY-MM-DD or an ISO moment.")
+		}),
+		run: (ctx, input) => {
+			const { data } = ctx;
+			const mine = me(ctx);
+			if (!mine) return {
+				you: null,
+				note: "You aren't one of this harbor's people yet, so there's nothing to catch up on."
+			};
+			const today = todayFor(mine, ctx.now, todayISO(ctx.now));
+			const since = input.since ?? subDays(ctx.now, 7).toISOString();
+			const away = welcomeWhen(mine, input.since ?? null, today);
+			const when = away?.why === "away" ? away : {
+				since,
+				why: "unseen",
+				days: dayGap(since, today)
+			};
+			const w = welcomeBack(data, mine.id, when, today);
+			const projects = byId(data.projects);
+			const keyOf = (t) => taskKey(t, projects.get(t.projectId));
+			return {
+				you: mine.name,
+				from: when.why === "away" ? "time away" : input.since ? "when you last looked" : "the last 7 days",
+				since: dayOf(when.since),
+				days: when.days,
+				quiet: w.quiet,
+				lookFirst: w.lookFirst.map((l) => ({
+					kind: l.kind,
+					text: l.text,
+					...l.taskId ? { taskId: l.taskId } : {},
+					...l.raidId ? { raidId: l.raidId } : {}
+				})),
+				handed: w.handed.map(({ task, by }) => ({
+					id: task.id,
+					...keyOf(task) ? { key: keyOf(task) } : {},
+					title: task.title,
+					due: dayOf(task.dueDate),
+					by: by?.name ?? null
+				})),
+				decisions: w.decisions.map(({ item, by }) => ({
+					id: item.id,
+					title: item.title,
+					decidedAt: dayOf(item.decidedAt),
+					by: by?.name ?? null
+				})),
+				moved: w.moved.map((m) => ({
+					project: m.project.name,
+					...m.project.key ? { key: m.project.key } : {},
+					done: m.done,
+					added: m.added,
+					health: m.health
+				}))
+			};
+		}
+	}),
 	tool({
 		name: "weekly_brief",
 		title: "Weekly brief",
@@ -20723,7 +20952,7 @@ const HARBOR_TOOLS = [
 	tool({
 		name: "scope_growth",
 		title: "Barnacles: work added since the plan was set",
-		description: "How much a project's plan has grown since it was set (barnacles): tasks made after the baseline was set (or, without a baseline time, after the project's first week of tasks), as a count and a percent of what was planned, by week (weekOf is a Monday) and by who added them (who is null for tasks made before Harbor kept track, or by a form). daysOfWork puts them at the crew's pace (tasks finished a week over the last six); slipDays is how late the project runs against its planned end (the likely finish at that pace, or the end date's move from the baseline), and daysLine says how much of it the added work explains." + DATA_NOTE,
+		description: "How much a project's plan has grown since it was set (barnacles): tasks made after the baseline was set (or, without a baseline time, after the project's first week of tasks), as a count and a percent of what was planned, by week (weekOf is a Monday) and by who added them (who is null for tasks made before Harbor kept track, or by a form). daysOfWork puts them at the crew's pace (tasks finished a week over the last six); slipDays is how late the project runs against its planned end (the likely finish at that pace, or the end date's move from the baseline), and daysLine says how much of it the added work explains. settling is true while a project without a baseline is still in its first week (since is in the future): nothing counts as added yet, and setting a baseline counts from now." + DATA_NOTE,
 		input: object({
 			harbor: harborArg,
 			project: string().min(1).max(200).describe("Project id, name or key.")
@@ -26622,169 +26851,6 @@ function ShorePanel({ id, width, height, go, active, onClose }) {
 	});
 }
 
-//#endregion
-//#region src/lib/seen-mark.ts
-/** Days without opening Harbor before the catch-up shows. */
-const UNSEEN_DAYS = 3;
-/** Calendar days from one ISO day (or moment) to another, by their dates alone. */
-function dayGap(from, to) {
-	const utc = (iso) => {
-		const [y, m, d] = iso.slice(0, 10).split("-").map(Number);
-		return Date.UTC(y, m - 1, d);
-	};
-	return Math.round((utc(to) - utc(from)) / 864e5);
-}
-/**
-* Whether to catch someone up, and from when: back from time away they were
-* marked for (a handover with a return date that has come, until this device
-* has caught them up once since), or `UNSEEN_DAYS` or more since this device
-* last saw them. Null otherwise, and the first time a device sees them:
-* there's nothing to compare with.
-*/
-function welcomeWhen(person, lastSeen, today) {
-	const away = person?.away;
-	if (away?.since && away.until && away.until.slice(0, 10) <= today) {
-		if (!lastSeen || lastSeen.slice(0, 10) < away.until.slice(0, 10)) return {
-			since: away.since,
-			why: "away",
-			days: dayGap(away.since, today)
-		};
-	}
-	if (!lastSeen) return null;
-	const days = dayGap(lastSeen, today);
-	return days >= 3 ? {
-		since: lastSeen,
-		why: "unseen",
-		days
-	} : null;
-}
-
-//#endregion
-//#region src/lib/welcome-back.ts
-init_date_text();
-init_indexes();
-init_task_keys();
-const day = (iso) => parseIso(iso.slice(0, 10));
-const daysBetween = dayGap;
-/** Their projects: ones they lead, in a program they lead, or with a task of theirs. */
-function projectsOf(data, personId) {
-	const programs = new Set(data.programs.filter((p) => p.ownerId === personId).map((p) => p.id));
-	return data.projects.filter((p) => p.ownerId === personId || programs.has(p.programId) || tasksOf(data.tasks, p.id).some((t) => t.assigneeId === personId));
-}
-const first = (p) => p?.name.split(" ")[0] ?? null;
-/** "due Thu, Oct 23", "3 days late", "due today". */
-function dueText(task, today) {
-	if (!task.dueDate) return "no due date";
-	const d = daysBetween(today, task.dueDate);
-	if (d === 0) return "due today";
-	if (d < 0) return `${-d} day${d === -1 ? "" : "s"} late`;
-	if (d === 1) return "due tomorrow";
-	return `due ${format(day(task.dueDate), "EEE, MMM d")}`;
-}
-/** What a person needs to hear about since `when.since`, as of `today` (YYYY-MM-DD). */
-function welcomeBack(data, personId, when, today) {
-	const since = when.since;
-	const people = byId(data.people);
-	const projects = projectsOf(data, personId);
-	const projectIds = new Set(projects.map((p) => p.id));
-	const programIds = new Set(projects.map((p) => p.programId));
-	const projectById = byId(data.projects);
-	const label = (t) => {
-		const p = projectById.get(t.projectId);
-		const key = p ? taskKey(t, p) : null;
-		return key ? `${key} ${t.title}` : t.title;
-	};
-	const mine = data.tasks.filter((t) => t.assigneeId === personId && t.status !== "done");
-	const handed = mine.filter((t) => t.assignedAt && t.assignedAt >= since && t.assignedBy && t.assignedBy !== personId).sort((a, b) => (a.dueDate ?? "9999").localeCompare(b.dueDate ?? "9999")).map((task) => ({
-		task,
-		by: people.get(task.assignedBy) ?? null
-	}));
-	const decisions = data.raidItems.filter((r) => r.kind === "decision" && r.status !== "proposed" && Boolean(r.decidedAt) && r.decidedAt >= since && r.decidedById !== personId && (r.projectId ? projectIds.has(r.projectId) : Boolean(r.programId && programIds.has(r.programId)))).sort((a, b) => b.decidedAt.localeCompare(a.decidedAt)).map((item) => ({
-		item,
-		by: item.decidedById ? people.get(item.decidedById) ?? null : null
-	}));
-	const moved = [];
-	for (const project of projects) {
-		const tasks = tasksOf(data.tasks, project.id);
-		const done = tasks.filter((t) => t.completedAt && t.completedAt >= since).length;
-		const added = tasks.filter((t) => t.createdAt >= since).length;
-		const history = project.healthHistory ?? [];
-		const before = [...history].reverse().find((h) => h.at < since)?.health;
-		const health = history.some((h) => h.at >= since) && before && before !== project.health ? {
-			from: before,
-			to: project.health
-		} : null;
-		if (done || added || health) moved.push({
-			project,
-			done,
-			added,
-			health
-		});
-	}
-	moved.sort((a, b) => Number(Boolean(b.health)) - Number(Boolean(a.health)) || b.done - a.done);
-	const look = [];
-	const seen = /* @__PURE__ */ new Set();
-	const push = (item) => {
-		const id = item.taskId ?? item.raidId ?? item.text;
-		if (look.length >= 3 || seen.has(id)) return;
-		seen.add(id);
-		look.push(item);
-	};
-	for (const h of handed) {
-		const by = first(h.by);
-		push({
-			kind: "handed",
-			taskId: h.task.id,
-			text: `${label(h.task)}: handed to you${by ? ` by ${by}` : ""}, ${dueText(h.task, today)}`
-		});
-	}
-	const dated = mine.filter((t) => t.dueDate).sort((a, b) => a.dueDate.localeCompare(b.dueDate));
-	for (const t of dated) if (t.dueDate.slice(0, 10) < today) push({
-		kind: "late",
-		taskId: t.id,
-		text: `${label(t)}: ${dueText(t, today)}`
-	});
-	for (const t of dated) {
-		const d = daysBetween(today, t.dueDate);
-		if (d >= 0 && d <= 3) push({
-			kind: "due",
-			taskId: t.id,
-			text: `${label(t)}: ${dueText(t, today)}`
-		});
-	}
-	for (const d of decisions) {
-		const by = first(d.by);
-		push({
-			kind: "decision",
-			raidId: d.item.id,
-			text: `Decided without you: ${d.item.title}${by ? ` (${by})` : ""}`
-		});
-	}
-	return {
-		when,
-		handed,
-		decisions,
-		moved: moved.slice(0, 6),
-		lookFirst: look,
-		quiet: !handed.length && !decisions.length && !moved.length && !look.length
-	};
-}
-/** "Welcome back, Priya · away Oct 3 to Oct 17", or "· 5 days since you last looked". */
-function welcomeTitle(w, name, today) {
-	const hi = name ? `Welcome back, ${name}` : "Welcome back";
-	if (w.when.why === "away") return `${hi} · away ${format(day(w.when.since), "MMM d")} to ${format(day(today), "MMM d")}`;
-	return `${hi} · ${w.when.days} days since you last looked`;
-}
-/** "Checkout v3: 4 done, 2 added, now At risk (was On track)". */
-function movedText(m, healthLabel) {
-	const bits = [
-		m.done ? `${m.done} done` : null,
-		m.added ? `${m.added} added` : null,
-		m.health ? `now ${healthLabel(m.health.to)} (was ${healthLabel(m.health.from)})` : null
-	].filter(Boolean);
-	return `${m.project.name}: ${bits.join(", ")}`;
-}
-
 //#endregion
 //#region src/tui/views/welcome.tsx
 init_swatches();

package/lib/cli.mjs

@@ -45,6 +45,9 @@ import {
   whyText,
   bridgeText,
   barnaclesText,
+  baselineData,
+  baselineText,
+  catchupText,
   handoverText,
   fogText,
   agentWorkText,
@@ -103,13 +106,15 @@ export const HELP = `harbor: Harbor from the terminal
   harbor barnacles PROJECT                    work added since the plan was set:
                                               by week, by who, and the days of
                                               slip it explains
-  harbor baseline PROJECT [--reset]           sets a project's baseline: its
-                                              dates now, and growth counted
-                                              from now
+  harbor baseline PROJECT                     reads a project's baseline
+  harbor baseline PROJECT --set|--reset       sets it: its dates now, and
+                     [--dry-run]              growth counted from now
   harbor hill [--program P]                   where each project is on its hill
   harbor hill PROJECT --at 0-100|top|done     move it: up to 50 is figuring it
                                               out, past 50 is getting it done
   harbor mine                                 what's on you, late first
+  harbor catchup [--since DATE]               while you were away: handed to
+                                              you, decided, what moved
   harbor clock [NAME] [--zone ZONE|here|none] [--hours 9-17]
                                               who's working now, or set your
                                               (or NAME's) time zone and hours
@@ -200,7 +205,7 @@ export const HELP = `harbor: Harbor from the terminal
                                               the review: programs worst first,
                                               each with its next move (reads
                                               only; harbor submit moves a task)
-  harbor thanks [--all] [--given]             thanks you were given this month
+  harbor thanks [--all] [--given]             your thanks, last 30 days
   harbor thanks TASK "LINE" [--to NAME]       a one-line thanks for a task
   harbor thanks --milestone NAME|--decision TITLE "LINE" [--to NAME]
                                               the same for a milestone or a
@@ -972,14 +977,27 @@ const DETAIL = {
     "  don't keep hours.",
   ],
   baseline: [
-    "  harbor baseline PROJECT                writes: commits its start and end",
+    "  harbor baseline PROJECT                reads its baseline and when it was set",
+    "  harbor baseline PROJECT --set          writes: commits its start and end",
     "                                         dates as its baseline",
     "  harbor baseline PROJECT --reset        writes: replaces one already set",
+    "  harbor baseline PROJECT --set --dry-run",
+    "                                         reads: says what it would set",
     "",
     "  The timeline then shows slips against those dates, and harbor barnacles",
     "  counts tasks added from now on as growth. On the website a program's",
     "  Set baseline does the same for all its projects.",
   ],
+  catchup: [
+    "  harbor catchup                         reads the catch-up the app opens on",
+    "  harbor catchup --since DATE            reads it from a day (YYYY-MM-DD)",
+    "",
+    "  What was handed to you and by whom, the calls made on your projects",
+    "  without you, what moved on them, and the three to look at first. It",
+    "  counts from your time away once you're back, else from when the app on",
+    "  this machine last saw you, else the last 7 days. Reading it here",
+    "  doesn't clear the app's or the website's catch-up.",
+  ],
   barnacles: [
     "  harbor barnacles PROJECT               reads how much the plan has grown",
     "",
@@ -2873,6 +2891,15 @@ export async function run(argv, io = {}) {
       if (!of) throw new HarborError("Say what: a project, a task key like RR-42, or a milestone.");
       return call("long_pole", { harbor, of }, whyText);
     }
+    case "catchup": {
+      const { positionals, values, harbor } = parse(spec([], ["since"]));
+      none(positionals);
+      if (values.since && !/^\d{4}-\d{2}-\d{2}$/.test(values.since))
+        throw new HarborError("--since takes a date like 2026-10-14.");
+      // When the app on this machine last saw you in this harbor (it keeps the mark by id).
+      const seen = values.since ?? (harbor ? (await readSettings(env)).seen?.[harbor] : null);
+      return call("catch_up", { harbor, ...(seen ? { since: seen } : {}) }, catchupText);
+    }
     case "barnacles": {
       const { positionals, harbor } = parse(spec());
       const project = positionals.join(" ").trim();
@@ -2880,9 +2907,16 @@ export async function run(argv, io = {}) {
       return call("scope_growth", { harbor, project }, barnaclesText);
     }
     case "baseline": {
-      const { positionals, values, harbor } = parse(spec(["reset"]));
+      const { positionals, values, harbor } = parse(spec(["set", "reset", "dry-run"]));
       const project = positionals.join(" ").trim();
       if (!project) throw new HarborError("Say which project: harbor baseline PROJECT.");
+      const dryRun = Boolean(values["dry-run"]);
+      // Reading is the default: only --set or --reset writes.
+      if (dryRun || !(values.set || values.reset)) {
+        return call("get_project", { harbor, project }, baselineText, (r) =>
+          baselineData(r, { dryRun, reset: Boolean(values.reset) }),
+        );
+      }
       return call(
         "set_baseline",
         { harbor, project, ...(values.reset ? { reset: true } : {}) },

package/lib/format.mjs

@@ -205,9 +205,21 @@ export function whoami(r, creds) {
   else if (list.length)
     lines.push("No harbor set: say --harbor NAME, or set one with harbor use NAME.");
   else lines.push("You aren't in any harbor yet. Run harbor to make one.");
+  // Shown from whoamiData (build), or straight from list_harbors (server).
+  lines.push(serverLine(r.build ?? (typeof r.server === "object" ? r.server : null)));
   return lines.join("\n");
 }
 
+/**
+ * "Server: built Oct 22 03:14 UTC from 5e1c6d4." A site from before the stamp
+ * says nothing about itself, which means it's older than this CLI's whoami.
+ */
+export function serverLine(server) {
+  if (!server?.builtAt) return "Server: an older build that doesn't say which; some commands may not be there yet.";
+  const at = `${monthDay(server.builtAt)} ${server.builtAt.slice(11, 16)} UTC`;
+  return `Server: built ${at}${server.commit ? ` from ${server.commit.slice(0, 7)}` : ""}.`;
+}
+
 /** whoami --json: the account and its harbors, with where it signed in and the harbor commands use. */
 export function whoamiData(r, creds) {
   const list = r.harbors ?? [];
@@ -224,6 +236,8 @@ export function whoamiData(r, creds) {
     server: creds.server,
     readOnly: !creds.scope?.split(" ").includes("harbor:write"),
     harbor: using,
+    // The site's build (commit and when), or null from a site too old to say.
+    build: r.server ?? null,
   };
 }
 
@@ -629,6 +643,13 @@ export function whyText(r) {
 /** A project's barnacles, as scope_growth answers it: the growth, its cost in days, by week and by who. */
 export function barnaclesText(r) {
   const head = [`Barnacles · ${r.project}`];
+  if (r.settling) {
+    head.push(
+      `The plan is still being written: ${r.planned} task${r.planned === 1 ? "" : "s"} so far, and nothing counts as added until ${monthDay(r.since)}, a week after its first task.`,
+      `harbor baseline "${r.key ?? r.project}" --set counts from now instead.`,
+    );
+    return head.join("\n");
+  }
   if (!r.added) {
     head.push(`Nothing added since the plan was set (${r.since.slice(0, 10)}): ${r.planned} task${r.planned === 1 ? "" : "s"}, as planned.`);
     return head.join("\n");
@@ -644,7 +665,7 @@ export function barnaclesText(r) {
   const from =
     r.measuredFrom === "when the baseline was set"
       ? `Counted from when the baseline was set, ${r.since.slice(0, 10)}.`
-      : `Counted from a week after its first task was made, ${r.since.slice(0, 10)}; harbor baseline "${r.project}" counts from then instead.`;
+      : `Counted from a week after its first task was made, ${r.since.slice(0, 10)}; harbor baseline "${r.project}" --set counts from then instead.`;
   return [...head, "", "Added by week:", ...weeks, "", `By who: ${who}`, "", from].join("\n");
 }
 
@@ -1110,3 +1131,84 @@ export function followedText(r) {
   const f = r.followed;
   return `${f.person} is a second pair of hands on ${f.what}: they follow it now, and it stays with whoever has it.`;
 }
+
+/** A project's baseline from get_project, as harbor baseline reads it (or would set it, with --dry-run). */
+export function baselineData(p, { dryRun = false, reset = false } = {}) {
+  const has = Boolean(p.baselineEnds);
+  return {
+    project: p.name,
+    ...(p.key ? { key: p.key } : {}),
+    baselineStart: p.baselineStarts ?? null,
+    baselineEnd: p.baselineEnds ?? null,
+    setAt: p.baselineSetAt ?? null,
+    starts: p.starts ?? null,
+    ends: p.ends ?? null,
+    ...(dryRun
+      ? {
+          dryRun: true,
+          wouldSet: !has || reset ? { baselineStart: p.starts ?? null, baselineEnd: p.ends ?? null } : null,
+        }
+      : {}),
+  };
+}
+
+const span = (from, to) => (from ? `${monthDay(from)} – ${monthDay(to)}` : `ending ${monthDay(to)}`);
+
+export function baselineText(b) {
+  const name = b.project;
+  const now = b.starts && b.ends ? span(b.starts, b.ends) : null;
+  const had = b.baselineEnd
+    ? `${b.setAt ? `Baseline set ${monthDay(b.setAt)}` : "Baseline"}: ${span(b.baselineStart, b.baselineEnd)}.`
+    : null;
+  if (b.dryRun) {
+    if (!b.wouldSet) {
+      return `${name} already has a baseline (${span(b.baselineStart, b.baselineEnd)}); --reset would replace it${now ? ` with ${now}` : ""}. Nothing changed.`;
+    }
+    if (!now) return `${name} has no start and end dates yet, so there's nothing to set as its baseline.`;
+    return `Would set ${name}'s baseline: ${now}${had ? `, replacing ${span(b.baselineStart, b.baselineEnd)}` : ""}. Nothing changed; leave out --dry-run to set it.`;
+  }
+  if (!had) {
+    return now
+      ? `${name}: no baseline yet. harbor baseline "${name}" --set commits its dates now (${now}).`
+      : `${name}: no baseline yet, and no start and end dates to set one from.`;
+  }
+  const moved = now && (b.starts !== b.baselineStart || b.ends !== b.baselineEnd) && b.baselineStart;
+  return [`${name}: ${had}`, ...(moved ? [`Its dates now: ${now}. --reset makes those the baseline.`] : [])].join("\n");
+}
+
+
+/** catch_up as the terminal shows it: the three to look at first, the calls made without you, what moved. */
+export function catchupText(r) {
+  if (!r.you) return r.note ?? "Nothing to catch up on.";
+  const first = r.you.split(" ")[0];
+  const head =
+    r.from === "time away"
+      ? `While you were away, ${first} · since ${monthDay(r.since)}`
+      : r.from === "when you last looked"
+        ? `Since you last looked, ${first} · ${monthDay(r.since)}, ${r.days} day${r.days === 1 ? "" : "s"} ago`
+        : `The last 7 days, ${first} · since ${monthDay(r.since)}`;
+  if (r.quiet) return `${head}\n\nNothing moved on your projects since then.`;
+  const out = [head];
+  if (r.lookFirst.length) {
+    out.push("", "Look at first:");
+    for (const l of r.lookFirst) out.push(`  ${l.text}`);
+  }
+  if (r.decisions.length) {
+    out.push("", "Decided without you:");
+    for (const d of r.decisions) out.push(`  ${d.title}${d.by ? ` · ${d.by.split(" ")[0]}` : ""} (${monthDay(d.decidedAt)})`);
+  }
+  if (r.moved.length) {
+    out.push("", "What moved:");
+    for (const m of r.moved) {
+      const bits = [
+        m.done ? `${m.done} done` : null,
+        m.added ? `${m.added} added` : null,
+        m.health ? `now ${HEALTH[m.health.to] ?? m.health.to} (was ${HEALTH[m.health.from] ?? m.health.from})` : null,
+      ].filter(Boolean);
+      out.push(`  ${m.key ? `${m.key} ` : ""}${m.project}: ${bits.join(", ")}`);
+    }
+  }
+  const more = r.handed.length > r.lookFirst.filter((l) => l.kind === "handed").length;
+  if (more) out.push("", `${r.handed.length} handed to you in all; harbor catchup --json lists them.`);
+  return out.join("\n");
+}

package/package.json

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