@harborppm/cli 0.63.0 → 0.65.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]

package/dist/app.mjs

@@ -3275,6 +3275,13 @@ function barnaclesOf(project, tasks, people, now, slip = null) {
 	const weekly = weeklyFinished(tasks, project.startDate, now);
 	const finished = weekly.reduce((a, b) => a + b, 0);
 	const perWeek = finished > 0 ? Math.round(finished / weekly.length * 10) / 10 : null;
+	const byDay = /* @__PURE__ */ new Map();
+	for (const t of added) byDay.set(t.createdAt.slice(0, 10), (byDay.get(t.createdAt.slice(0, 10)) ?? 0) + 1);
+	const [bulkDay, bulk] = [...byDay].sort((a, b) => b[1] - a[1])[0] ?? [null, 0];
+	const age = differenceInCalendarDays(noon$2(today), addDays(noon$2(since), -7)) / 7;
+	let caveat = null;
+	if (added.length && bulkDay && bulk >= 5 && bulk >= added.length * .5) caveat = `${bulk} of the ${added.length} came in on ${shortDate(bulkDay)}, which looks like the plan being loaded rather than growth, so treat this as rough. Setting a baseline counts from then on.`;
+	else if (added.length && from === "start" && (planned < 5 || age < 3)) caveat = "There's no baseline yet and the plan is young, so its first weeks may be the plan being written: treat this as rough. Setting a baseline counts from then on.";
 	return {
 		since,
 		from,
@@ -3286,7 +3293,8 @@ function barnaclesOf(project, tasks, people, now, slip = null) {
 		adders,
 		perWeek,
 		days: perWeek ? Math.round(added.length / perWeek * 7) : null,
-		slip
+		slip,
+		caveat
 	};
 }
 /**
@@ -3305,12 +3313,12 @@ function slipAgainstPlan(project, tasks, now, tide = tideForecast(project, tasks
 function barnaclesHeadline(b) {
 	if (b.added === 0) return null;
 	const when = b.from === "baseline" ? "since the baseline" : "since its first week";
-	const pct = b.share != null ? `, ${Math.round(b.share * 100)}% more than planned` : "";
+	const pct = b.share != null && !b.caveat ? `, ${Math.round(b.share * 100)}% more than planned` : "";
 	return `+${plural$7(b.added, "task")} ${when}${pct}`;
 }
 /** What the added work costs in days, and how much of the slip it explains. */
 function barnaclesDaysLine(b) {
-	if (b.added === 0 || b.days == null || b.perWeek == null) return null;
+	if (b.added === 0 || b.days == null || b.perWeek == null || b.caveat) return null;
 	const work = `At the crew's pace (about ${b.perWeek} a week) that's about ${plural$7(b.days, "day")} of work`;
 	if (b.slip == null || b.slip <= 0) return `${work}.`;
 	if (b.days >= b.slip) return `${work}: enough to explain all ${plural$7(b.slip, "day")} of the slip.`;
@@ -3318,24 +3326,28 @@ function barnaclesDaysLine(b) {
 }
 /** One line for the brief or a list: "+14 tasks (38%) since the baseline, 3 this week, about 65 days of work". */
 function barnaclesShort(b) {
-	const pct = b.share != null ? ` (${Math.round(b.share * 100)}%)` : "";
+	const pct = b.share != null && !b.caveat ? ` (${Math.round(b.share * 100)}%)` : "";
 	const when = b.from === "baseline" ? "since the baseline" : "since its first week";
 	const week = b.thisWeek ? `, ${b.thisWeek} this week` : "";
-	const days = b.days != null ? `, about ${plural$7(b.days, "day")} of work` : "";
+	const days = b.days != null && !b.caveat ? `, about ${plural$7(b.days, "day")} of work` : "";
 	const top = b.adders.find((a) => a.personId);
 	const who = top && top.added * 2 > b.added ? `, mostly from ${top.name}` : "";
 	return `+${plural$7(b.added, "task")}${pct} ${when}${week}${days}${who}`;
 }
 /** Whether the brief names it: measured from a baseline, enough added, and enough of the plan. */
 function briefWorthy(b) {
-	return b.from === "baseline" && b.added >= 3 && (b.share == null || b.share >= .15);
+	return b.from === "baseline" && !b.caveat && b.added >= 3 && (b.share == null || b.share >= .15);
 }
-var SETTLE_DAYS, BRIEF_MIN_ADDED, BRIEF_MIN_SHARE, noon$2, isoDay$3, plural$7;
+var SETTLE_DAYS, THIN_PLANNED, THIN_WEEKS, BULK_SHARE, BULK_MIN, BRIEF_MIN_ADDED, BRIEF_MIN_SHARE, noon$2, isoDay$3, plural$7;
 var init_barnacles = __esmMin((() => {
 	init_date_fns();
 	init_format();
 	init_tide();
 	SETTLE_DAYS = 7;
+	THIN_PLANNED = 5;
+	THIN_WEEKS = 3;
+	BULK_SHARE = .5;
+	BULK_MIN = 5;
 	BRIEF_MIN_ADDED = 3;
 	BRIEF_MIN_SHARE = .15;
 	noon$2 = (iso) => /* @__PURE__ */ new Date(`${iso.slice(0, 10)}T12:00:00`);
@@ -3358,7 +3370,7 @@ function projectKeyFor(name, taken) {
 	for (let n = 2;; n++) if (!taken.has(`${base}${n}`)) return `${base}${n}`;
 }
 /** Whether `a` has the better claim to the number both hold. */
-function first$2(a, b, stored) {
+function first$3(a, b, stored) {
 	const ka = kept(a, stored);
 	if (ka !== kept(b, stored)) return ka;
 	return made(a, b) <= 0;
@@ -3406,7 +3418,7 @@ function settleKeys(data, stored) {
 			}
 			const other = holder.get(n);
 			if (other) {
-				const [keep, move] = first$2(other, t, stored) ? [other, t] : [t, other];
+				const [keep, move] = first$3(other, t, stored) ? [other, t] : [t, other];
 				holder.set(n, keep);
 				loose.push(move);
 			} else holder.set(n, t);
@@ -3570,8 +3582,8 @@ function thanksSince(doc, since, keep = () => true) {
 		if (!target || !keep(target)) continue;
 		out.push({
 			thanks: r,
-			from: first$1(doc, r.authorId),
-			to: first$1(doc, r.toId),
+			from: first$2(doc, r.authorId),
+			to: first$2(doc, r.toId),
 			for: target.title
 		});
 	}
@@ -3581,12 +3593,12 @@ function thanksSince(doc, since, keep = () => true) {
 function thanksText(line) {
 	return `${line.from} to ${line.to} for ${line.for}: “${line.thanks.body.trim()}”`;
 }
-var isThanks, first$1;
+var isThanks, first$2;
 var init_thanks = __esmMin((() => {
 	init_indexes();
 	init_task_keys();
 	isThanks = (r) => r.kind === "thanks" && !!r.thanksFor && !!r.toId;
-	first$1 = (doc, id) => doc.people.find((p) => p.id === id)?.name.split(" ")[0] ?? "Someone";
+	first$2 = (doc, id) => doc.people.find((p) => p.id === id)?.name.split(" ")[0] ?? "Someone";
 }));
 
 //#endregion
@@ -3672,9 +3684,13 @@ function charterOverdue(project, today) {
 	const days = differenceInCalendarDays(parseIso(today), parseIso(project.startDate.slice(0, 10)));
 	return days >= 7 ? days : null;
 }
-/** The items of an In or Out line: split on commas, semicolons, "and" lists and new lines. */
+/**
+* The items of an In or Out line: split on commas, semicolons, "and" lists and
+* new lines. A line that starts with a bullet (-, * or •) is one item whole,
+* commas and all, which is how `harbor charter --in A --in B` writes them.
+*/
 function charterItems(text) {
-	return (text ?? "").split(/[\n,;•]+/).map((s) => s.replace(/^\s*(?:and|or|-|\*)\s+/i, "").trim()).filter((s) => contentWords(s).size > 0);
+	return (text ?? "").split(/\n+/).flatMap((line) => /^\s*[-*•]\s+/.test(line) ? [line] : line.split(/[,;•]+/)).map((s) => s.replace(/^\s*(?:and|or|-|\*|•)\s+/i, "").trim()).filter((s) => contentWords(s).size > 0);
 }
 /** True when a task's title names an item: every meaningful word of a short item, or two of a longer one. */
 function names(item, title) {
@@ -3746,8 +3762,8 @@ init_date_fns();
 init_blockers();
 init_date_text();
 init_premortem();
-const day$7 = (iso) => parseIso(iso.slice(0, 10));
-const between = (a, b) => differenceInCalendarDays(day$7(b), day$7(a));
+const day$8 = (iso) => parseIso(iso.slice(0, 10));
+const between = (a, b) => differenceInCalendarDays(day$8(b), day$8(a));
 /** When the project was marked Done: its last move to Done in its health history. */
 function finishedOn(project, tasks) {
 	const marked = [...project.healthHistory ?? []].reverse().find((h) => h.health === "done");
@@ -3820,7 +3836,7 @@ function voyageLog(data, projectId) {
 	};
 }
 const plural$6 = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
-const md$2 = (iso) => format(day$7(iso), "MMM d");
+const md$2 = (iso) => format(day$8(iso), "MMM d");
 /** The three numbers at the top: how late, how much work, how many risks came true. */
 function voyageStats(log) {
 	const happened = log.risks.filter((r) => r.happened).length;
@@ -4914,7 +4930,7 @@ var init_cascade = __esmMin((() => {
 //#region src/lib/forecast.ts
 init_cascade();
 init_date_fns();
-const day$6 = (iso) => /* @__PURE__ */ new Date(`${iso}T12:00:00`);
+const day$7 = (iso) => /* @__PURE__ */ new Date(`${iso}T12:00:00`);
 /**
 * A straight-line estimate at completion from the burn so far: spend divided
 * by the share of the schedule elapsed. Null before anything is spent or
@@ -4923,8 +4939,8 @@ const day$6 = (iso) => /* @__PURE__ */ new Date(`${iso}T12:00:00`);
 */
 function forecastAtCompletion(item, now) {
 	if (item.spent <= 0) return null;
-	const total = differenceInCalendarDays(day$6(item.endDate), day$6(item.startDate)) + 1;
-	const gone = differenceInCalendarDays(now, day$6(item.startDate)) + 1;
+	const total = differenceInCalendarDays(day$7(item.endDate), day$7(item.startDate)) + 1;
+	const gone = differenceInCalendarDays(now, day$7(item.startDate)) + 1;
 	if (total <= 0 || gone <= 0) return null;
 	const elapsed = Math.min(1, gone / total);
 	const eac = Math.round(item.spent / elapsed);
@@ -5047,7 +5063,7 @@ var init_flow = __esmMin((() => {
 //#region src/lib/phasing.ts
 init_flow();
 init_date_fns();
-const day$5 = (iso) => /* @__PURE__ */ new Date(`${iso}T12:00:00`);
+const day$6 = (iso) => /* @__PURE__ */ new Date(`${iso}T12:00:00`);
 function monthKey(iso) {
 	return iso.slice(0, 7);
 }
@@ -5063,7 +5079,7 @@ function monthsBetween(from, to) {
 	return out;
 }
 function daysIn(key) {
-	return getDaysInMonth(day$5(`${key}-01`));
+	return getDaysInMonth(day$6(`${key}-01`));
 }
 /** How many of the schedule's days fall in `key`. */
 function overlapDays(key, start, end) {
@@ -5071,7 +5087,7 @@ function overlapDays(key, start, end) {
 	const lastDay = `${key}-${String(daysIn(key)).padStart(2, "0")}`;
 	const from = start > first ? start : first;
 	const to = end < lastDay ? end : lastDay;
-	return to < from ? 0 : differenceInCalendarDays(day$5(to), day$5(from)) + 1;
+	return to < from ? 0 : differenceInCalendarDays(day$6(to), day$6(from)) + 1;
 }
 /**
 * The budget spread straight across the schedule: each month gets the share
@@ -5081,7 +5097,7 @@ function overlapDays(key, start, end) {
 function evenPhasing(project) {
 	const end = project.endDate < project.startDate ? project.startDate : project.endDate;
 	const months = monthsBetween(project.startDate, end);
-	const total = differenceInCalendarDays(day$5(end), day$5(project.startDate)) + 1;
+	const total = differenceInCalendarDays(day$6(end), day$6(project.startDate)) + 1;
 	const out = {};
 	let placed = 0;
 	months.forEach((k, i) => {
@@ -5191,7 +5207,7 @@ function hasBaseline(p) {
 /** Days the end has moved past the baseline end; negative when it came in. Null without a baseline. */
 function slipDays(p) {
 	if (!p.baselineEnd) return null;
-	return differenceInCalendarDays(day$4(p.endDate), day$4(p.baselineEnd));
+	return differenceInCalendarDays(day$5(p.endDate), day$5(p.baselineEnd));
 }
 /**
 * The projects with the current dates committed as their baseline; ones that
@@ -5213,10 +5229,10 @@ function slipLabel(p) {
 	const n = Math.abs(slip);
 	return slip > 0 ? `slipped ${n} day${n === 1 ? "" : "s"}` : `${n} day${n === 1 ? "" : "s"} early`;
 }
-var day$4;
+var day$5;
 var init_baseline = __esmMin((() => {
 	init_date_fns();
-	day$4 = (iso) => /* @__PURE__ */ new Date(`${iso}T12:00:00`);
+	day$5 = (iso) => /* @__PURE__ */ new Date(`${iso}T12:00:00`);
 }));
 
 //#endregion
@@ -5245,7 +5261,7 @@ const ZOOMS = [
 		step: 3
 	}
 ];
-const day$3 = (iso) => /* @__PURE__ */ new Date(`${iso.slice(0, 10)}T12:00:00`);
+const day$4 = (iso) => /* @__PURE__ */ new Date(`${iso.slice(0, 10)}T12:00:00`);
 /** Names in the order people expect: "Phase 2" before "Phase 10". */
 const byName = (a, b) => a.localeCompare(b, void 0, { numeric: true });
 const isoDay$2 = (d) => format(d, "yyyy-MM-dd");
@@ -5255,7 +5271,7 @@ const isoDay$2 = (d) => format(d, "yyyy-MM-dd");
 */
 function roadmapWindow(zoom, today, shift = 0) {
 	const z = ZOOMS.find((x) => x.id === zoom) ?? ZOOMS[1];
-	const first = addMonths$1(startOfMonth(day$3(today)), -1 + shift * z.step);
+	const first = addMonths$1(startOfMonth(day$4(today)), -1 + shift * z.step);
 	const after = addMonths$1(first, z.months);
 	const days = differenceInCalendarDays(after, first);
 	const months = Array.from({ length: z.months }, (_, i) => {
@@ -5279,15 +5295,15 @@ function roadmapWindow(zoom, today, shift = 0) {
 function at$1(iso, w) {
 	if (!iso) return null;
 	if (iso < w.start || iso >= w.end) return null;
-	return differenceInCalendarDays(day$3(iso), day$3(w.start)) / w.days;
+	return differenceInCalendarDays(day$4(iso), day$4(w.start)) / w.days;
 }
 /** A bar for a start–end span, clipped to the window; null when it's wholly outside. */
 function span(start, end, w) {
 	if (!start || !end || end < w.start || start >= w.end) return null;
 	const from = start < w.start ? w.start : start;
-	const until = end >= w.end ? w.end : isoDay$2(new Date(day$3(end).getTime() + 864e5));
-	const left = differenceInCalendarDays(day$3(from), day$3(w.start)) / w.days;
-	const right = differenceInCalendarDays(day$3(until), day$3(w.start)) / w.days;
+	const until = end >= w.end ? w.end : isoDay$2(new Date(day$4(end).getTime() + 864e5));
+	const left = differenceInCalendarDays(day$4(from), day$4(w.start)) / w.days;
+	const right = differenceInCalendarDays(day$4(until), day$4(w.start)) / w.days;
 	return {
 		left,
 		width: Math.max(right - left, 1 / w.days),
@@ -7009,7 +7025,7 @@ function bottleState(note, ctx) {
 /** "opens on Nov 14", "opens when Factory buy-off is reached", "opens if Ridge Runner launch turns Off track" */
 function opensText(opens, ctx) {
 	if (!opens) return "open now";
-	if (opens.on === "date") return `opens on ${day$2(opens.date)}`;
+	if (opens.on === "date") return `opens on ${day$3(opens.date)}`;
 	if (opens.on === "milestone") {
 		const m = ctx.milestones.find((x) => x.id === opens.milestoneId);
 		return m ? `opens when ${m.name} is reached` : "opens when its milestone is reached";
@@ -7043,7 +7059,7 @@ function freshlyOpened(data, projects, now) {
 	}
 	return out.sort((a, b) => (b.state.openedOn ?? "").localeCompare(a.state.openedOn ?? ""));
 }
-var BOTTLE_FRESH_DAYS, isBottle, sealed, day$2;
+var BOTTLE_FRESH_DAYS, isBottle, sealed, day$3;
 var init_bottle = __esmMin((() => {
 	init_date_fns();
 	init_date_text();
@@ -7055,7 +7071,7 @@ var init_bottle = __esmMin((() => {
 		open: false,
 		openedOn: null
 	};
-	day$2 = (iso) => format(parseIso(iso.slice(0, 10)), "MMM d");
+	day$3 = (iso) => format(parseIso(iso.slice(0, 10)), "MMM d");
 }));
 
 //#endregion
@@ -7981,11 +7997,11 @@ function bridgeSince(program, now) {
 	return addDays(now, -7).toISOString();
 }
 const after = (at, since) => !!at && !Number.isNaN(Date.parse(at)) && Date.parse(at) > Date.parse(since);
-const first = (name) => name?.split(" ")[0] ?? null;
+const first$1 = (name) => name?.split(" ")[0] ?? null;
 /** "RR-4 Draft the copy (Sam)", with the key when it has one. */
 function taskLine$1(t, project, doc) {
 	const key = taskKey(t, project);
-	const who = t.assigneeId ? first(byId(doc.people).get(t.assigneeId)?.name) : null;
+	const who = t.assigneeId ? first$1(byId(doc.people).get(t.assigneeId)?.name) : null;
 	return `${key ? `${key} ` : ""}${t.title}${who ? ` (${who})` : ""}`;
 }
 function listed(prefix, items) {
@@ -8141,7 +8157,7 @@ function meetingSummary(doc, slides, logged) {
 			const project = t ? projects.get(t.projectId) : void 0;
 			const program = project ? doc.programs.find((p) => p.id === project.programId) : void 0;
 			if (!t || !project || !program) continue;
-			const who = t.assigneeId ? first(people.get(t.assigneeId)?.name) : null;
+			const who = t.assigneeId ? first$1(people.get(t.assigneeId)?.name) : null;
 			const key = taskKey(t, project);
 			partOf(program).lines.push({
 				kind: "action",
@@ -9077,11 +9093,11 @@ function dollars(value) {
 	const n = Number(value ?? 0);
 	return whole.format(Number.isFinite(n) ? n : 0);
 }
-function day$1(value) {
+function day$2(value) {
 	return value ? shortDate(value) : "no date";
 }
 /** Whole days from one ISO day to another. */
-function daysBetween(from, to) {
+function daysBetween$1(from, to) {
 	const a = Date.parse(`${from.slice(0, 10)}T12:00:00Z`);
 	const b = Date.parse(`${to.slice(0, 10)}T12:00:00Z`);
 	if (Number.isNaN(a) || Number.isNaN(b)) return 0;
@@ -9089,7 +9105,7 @@ function daysBetween(from, to) {
 }
 function slip(from, to) {
 	if (!from || !to) return "";
-	const d = daysBetween(from, to);
+	const d = daysBetween$1(from, to);
 	if (d === 0) return "";
 	const n = Math.abs(d);
 	return ` (${n} day${n === 1 ? "" : "s"} ${d > 0 ? "later" : "earlier"})`;
@@ -9157,15 +9173,15 @@ function describeEvent(e, names) {
 		};
 		case "dueDate": return {
 			action: "moved the due date of",
-			detail: `from ${day$1(from)} to ${day$1(to)}${slip(from, to)}`
+			detail: `from ${day$2(from)} to ${day$2(to)}${slip(from, to)}`
 		};
 		case "startDate": return {
 			action: "moved the start of",
-			detail: `from ${day$1(from)} to ${day$1(to)}${slip(from, to)}`
+			detail: `from ${day$2(from)} to ${day$2(to)}${slip(from, to)}`
 		};
 		case "endDate": return {
 			action: "moved the end of",
-			detail: `from ${day$1(from)} to ${day$1(to)}${slip(from, to)}`
+			detail: `from ${day$2(from)} to ${day$2(to)}${slip(from, to)}`
 		};
 		case "budget": return {
 			action: "changed the budget of",
@@ -18956,7 +18972,7 @@ const SIMILAR_MIN = 3;
 /** A finished task that took longer than this sat somewhere; it counts as this long. */
 const SIMILAR_CAP = 15;
 const firstName$1 = (name) => name.trim().split(/\s+/)[0] || name;
-const day = (iso) => iso ? iso.slice(0, 10) : null;
+const day$1 = (iso) => iso ? iso.slice(0, 10) : null;
 function quantile(sorted, q) {
 	const at = (sorted.length - 1) * q;
 	const lo = Math.floor(at);
@@ -18972,7 +18988,7 @@ function pilotDate(task, data, localToday, at) {
 	const owner = byId(data.people).get(task.assigneeId);
 	if (!owner || owner.kind === "agent") return null;
 	const today = at ? todayFor(owner, at, localToday) : localToday;
-	const chosen = day(task.dueDate);
+	const chosen = day$1(task.dueDate);
 	let underWay = 0;
 	const dated = [];
 	const finished = [];
@@ -18982,14 +18998,14 @@ function pilotDate(task, data, localToday, at) {
 			if (t.projectId === task.projectId && t.completedAt) finished.push(t);
 			continue;
 		}
-		const due = day(t.dueDate);
+		const due = day$1(t.dueDate);
 		if (t.status === "doing" || t.status === "review") underWay += 1;
 		else if (due) dated.push(due);
 	}
 	const perDay = Math.max(.2, (owner.weeklyCapacity ?? 5) / 5);
 	let similar = null;
 	if (finished.length >= SIMILAR_MIN) {
-		const took = finished.sort((a, b) => b.completedAt < a.completedAt ? -1 : 1).slice(0, SIMILAR).map((t) => Math.min(SIMILAR_CAP, Math.max(1, workingDaysBetween(day(t.createdAt), day(t.completedAt))))).sort((a, b) => a - b);
+		const took = finished.sort((a, b) => b.completedAt < a.completedAt ? -1 : 1).slice(0, SIMILAR).map((t) => Math.min(SIMILAR_CAP, Math.max(1, workingDaysBetween(day$1(t.createdAt), day$1(t.completedAt))))).sort((a, b) => a - b);
 		similar = {
 			low: Math.round(quantile(took, .25)),
 			high: Math.round(quantile(took, .75)),
@@ -18997,7 +19013,7 @@ function pilotDate(task, data, localToday, at) {
 		};
 	}
 	const ownDays = Math.min(5, Math.max(1, similar?.low ?? 1));
-	const backOn = isAway(owner, today) ? day(owner.away.until) : null;
+	const backOn = isAway(owner, today) ? day$1(owner.away.until) : null;
 	const start = backOn && backOn > today ? dayBefore(backOn) : today;
 	const tasks = byId(data.tasks);
 	const projects = byId(data.projects);
@@ -19008,7 +19024,7 @@ function pilotDate(task, data, localToday, at) {
 	for (const id of blockers) {
 		const b = tasks.get(id);
 		if (!b || b.status === "done") continue;
-		const due = day(b.dueDate);
+		const due = day$1(b.dueDate);
 		if (!due) {
 			undated ??= b;
 			continue;
@@ -19077,7 +19093,7 @@ const plural$3 = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
 /** The line under the date: "Dana's queue says Nov 12 at the earliest", or, with no date yet, "Dana could likely have this by Nov 12". */
 function pilotHeadline(p, chosen, you = false) {
 	const who = you ? "You" : firstName$1(p.owner.name);
-	if (!day(chosen)) return `${who} could likely have this by ${shortDate(p.earliest)}`;
+	if (!day$1(chosen)) return `${who} could likely have this by ${shortDate(p.earliest)}`;
 	return `${you ? "Your" : `${who}'s`} queue says ${shortDate(p.earliest)} at the earliest`;
 }
 /** Why: the queue, time away, what it waits on, and how long similar tasks took. */
@@ -19094,6 +19110,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";
@@ -19367,6 +19546,7 @@ init_search();
 init_derived_health();
 init_format();
 init_date_text();
+init_date_fns();
 init_shipping_forecast();
 init_handover();
 init_work();
@@ -19410,6 +19590,7 @@ function barnaclesData(b) {
 		daysOfWork: b.days,
 		slipDays: b.slip,
 		daysLine: barnaclesDaysLine(b),
+		caveat: b.caveat,
 		byWeek: b.weeks.filter((w) => w.added > 0).map((w) => ({
 			weekOf: w.week,
 			added: w.added
@@ -19982,7 +20163,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,
@@ -20184,6 +20367,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",
@@ -22098,6 +22342,14 @@ function hierarchySlice({ get, write }) {
 			const program = get().programs.find((p) => p.id === programId);
 			get().log(`${reset ? "reset" : "set"} the baseline on ${program?.name ?? "a program"}`, `/programs/${programId}`);
 		},
+		setProjectBaseline: (projectId, reset = false) => {
+			const project = get().projects.find((p) => p.id === projectId);
+			if (!project) return;
+			const [stamped] = withBaseline([project], reset, stamp());
+			if (stamped === project) return;
+			write({ projects: get().projects.map((p) => p.id === projectId ? stamped : p) });
+			get().log(`${reset ? "reset" : "set"} the baseline on ${project.name}`, `/projects/${projectId}`);
+		},
 		setPriorityRules: (rules) => {
 			write({ priorityRules: rules ? normalizeRules(rules) : null });
 		},
@@ -26597,6 +26849,129 @@ function ShorePanel({ id, width, height, go, active, onClose }) {
 	});
 }
 
+//#endregion
+//#region src/tui/views/welcome.tsx
+init_swatches();
+const TAG = {
+	handed: "Handed to you",
+	late: "Late",
+	due: "Due soon",
+	decision: "Decided"
+};
+/**
+* While you were away, the app's first screen after time off or days
+* unseen: the three to look at first (Enter opens one), the calls made
+* without you and what moved. g or Esc says got it and goes on to Today.
+*/
+function WelcomeView({ when, active, width, height, go, onDone }) {
+	const { today } = useDeps();
+	const tasks = useHarbor((s) => s.tasks);
+	const projects = useHarbor((s) => s.projects);
+	const programs = useHarbor((s) => s.programs);
+	const people = useHarbor((s) => s.people);
+	const raidItems = useHarbor((s) => s.raidItems);
+	const me = useHarbor((s) => s.currentUserId);
+	const day = today();
+	const w = useMemo(() => welcomeBack({
+		tasks,
+		projects,
+		programs,
+		people,
+		raidItems
+	}, me, when, day), [
+		tasks,
+		projects,
+		programs,
+		people,
+		raidItems,
+		me,
+		when,
+		day
+	]);
+	const name = people.find((p) => p.id === me)?.name.split(" ")[0] ?? null;
+	const [at, setAt] = useState(0);
+	const look = w.lookFirst;
+	useInput((input, key) => {
+		if (key.escape || input === "g") return onDone();
+		if (key.upArrow || input === "k") setAt((i) => step(i, -1, look.length));
+		else if (key.downArrow || input === "j") setAt((i) => step(i, 1, look.length));
+		else if (key.return) {
+			const l = look[at];
+			if (!l) return onDone();
+			if (l.taskId) go.openTask(l.taskId);
+			else if (l.raidId) go.openPanel("raid", l.raidId);
+		}
+	}, { isActive: active });
+	const [hello, ...rest] = welcomeTitle(w, name, day).split(" · ");
+	const label = (h) => HEALTH_LABEL$1[h];
+	const room = Math.max(0, height - 6 - look.length);
+	const lines = [
+		...w.decisions.length ? [{
+			head: true,
+			text: "Decided without you"
+		}] : [],
+		...w.decisions.slice(0, 3).map(({ item, by }) => ({
+			head: false,
+			text: `${item.title}${by ? ` · ${by.name.split(" ")[0]}` : ""}`
+		})),
+		...w.moved.length ? [{
+			head: true,
+			text: "What moved"
+		}] : [],
+		...w.moved.map((m) => ({
+			head: false,
+			text: movedText(m, label)
+		}))
+	].slice(0, room);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		width,
+		height,
+		paddingX: 1,
+		children: [
+			/* @__PURE__ */ jsx(Heading, {
+				right: rest.join(" · "),
+				children: hello
+			}),
+			w.quiet ? /* @__PURE__ */ jsx(Text, {
+				color: theme.muted,
+				children: "Nothing moved on your projects while you were gone."
+			}) : null,
+			look.map((l, i) => {
+				const on = active && i === at;
+				return /* @__PURE__ */ jsxs(Text, {
+					color: on ? theme.selected : void 0,
+					bold: on,
+					wrap: "truncate-end",
+					children: [
+						on ? "› " : "  ",
+						/* @__PURE__ */ jsx(Text, {
+							color: l.kind === "due" || l.kind === "decision" ? theme.muted : theme.warn,
+							children: TAG[l.kind].padEnd(14)
+						}),
+						l.text
+					]
+				}, l.taskId ?? l.raidId ?? l.text);
+			}),
+			lines.map((l, i) => l.head ? /* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					color: theme.muted,
+					children: l.text
+				})
+			}, i) : /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: ["  ", l.text]
+			}, i)),
+			/* @__PURE__ */ jsx(Box, { flexGrow: 1 }),
+			/* @__PURE__ */ jsxs(Text, {
+				color: theme.muted,
+				children: [look.length ? "↑↓ pick · Enter opens · " : "", "g or Esc: got it, on to Today"]
+			})
+		]
+	});
+}
+
 //#endregion
 //#region src/tui/views/bands.tsx
 /**
@@ -29469,7 +29844,7 @@ const SAVE_LABEL = {
 	offline: ["● offline, will save", "bad"]
 };
 function App({ ui, startIn }) {
-	const { store, sync, account, harbors, today, remember } = useDeps();
+	const { store, sync, account, harbors, today, remember, seen } = useDeps();
 	const { exit } = useApp();
 	const { columns, rows } = useWindowSize();
 	const harborName = useHarbor((s) => s.harborName);
@@ -29490,6 +29865,21 @@ function App({ ui, startIn }) {
 	const [overlay, setOverlay] = useState(null);
 	const [focus, setFocus] = useState("main");
 	const [quitting, setQuitting] = useState(false);
+	const [welcome, setWelcome] = useState(() => {
+		const s = store.getState();
+		const me = s.people.find((p) => p.id === s.currentUserId);
+		if (!seen || !me || !s.workspaceId || s.workspaceId === "local") return null;
+		return welcomeWhen(me, seen.last(s.workspaceId), today());
+	});
+	useEffect(() => {
+		const id = store.getState().workspaceId;
+		if (!welcome && seen && id && id !== "local") seen.mark(id, (/* @__PURE__ */ new Date()).toISOString());
+	}, []);
+	const doneWelcome = () => {
+		const id = store.getState().workspaceId;
+		if (seen && id) seen.mark(id, (/* @__PURE__ */ new Date()).toISOString());
+		setWelcome(null);
+	};
 	useEffect(() => {
 		if (!notice) return;
 		const t = setTimeout(() => ui.setState({ notice: null }), 5e3);
@@ -29939,6 +30329,11 @@ function App({ ui, startIn }) {
 		portfolioId: page.id,
 		onBack: back
 	}, page.id);
+	else if (screen === "today" && welcome) screenNode = /* @__PURE__ */ jsx(WelcomeView, {
+		...viewProps,
+		when: welcome,
+		onDone: doneWelcome
+	});
 	else if (screen === "today") screenNode = /* @__PURE__ */ jsx(TodayView, { ...viewProps });
 	else if (screen === "inbox") screenNode = /* @__PURE__ */ jsx(InboxView, { ...viewProps });
 	else if (screen === "projects") screenNode = /* @__PURE__ */ jsx(ProjectsView, { ...viewProps });
@@ -30807,7 +31202,8 @@ async function startApp(deps, options = {}) {
 			harbors,
 			today,
 			remember: deps.remember,
-			browse: deps.browse
+			browse: deps.browse,
+			seen: deps.seen
 		},
 		children: /* @__PURE__ */ jsx(App, {
 			ui,
@@ -30891,7 +31287,8 @@ async function runApp(opts) {
 		firstRun,
 		remember: opts.remember,
 		browse: opts.browse,
-		startIn: opts.startIn
+		startIn: opts.startIn,
+		seen: opts.seen
 	}, { alternateScreen: true });
 	await instance.waitUntilExit();
 }

package/lib/args.mjs

@@ -1,9 +1,10 @@
 /**
  * A small argument reader: positionals, `--flag`, `--key value` and
- * `--key=value`. Unknown flags are an error, so a typo doesn't quietly do
+ * `--key=value`. An option named in `repeat` may be given more than once and
+ * reads as a list. Unknown flags are an error, so a typo doesn't quietly do
  * something else.
  */
-export function parseArgs(argv, { flags = [], options = [] } = {}) {
+export function parseArgs(argv, { flags = [], options = [], repeat = [] } = {}) {
   const positionals = [];
   const values = {};
   for (let i = 0; i < argv.length; i++) {
@@ -20,7 +21,7 @@ export function parseArgs(argv, { flags = [], options = [] } = {}) {
     if (flags.includes(key)) {
       if (inline !== undefined) throw new Error(`--${key} takes no value.`);
       values[key] = true;
-    } else if (options.includes(key)) {
+    } else if (options.includes(key) || repeat.includes(key)) {
       const value = inline ?? argv[++i];
       if (
         value === undefined ||
@@ -29,7 +30,7 @@ export function parseArgs(argv, { flags = [], options = [] } = {}) {
       ) {
         throw new Error(`--${key} needs a value.`);
       }
-      values[key] = value;
+      values[key] = repeat.includes(key) ? [...(values[key] ?? []), value] : value;
     } else {
       throw new Error(`Unknown option --${key}.`);
     }

package/lib/cli.mjs

@@ -45,6 +45,9 @@ import {
   whyText,
   bridgeText,
   barnaclesText,
+  baselineData,
+  baselineText,
+  catchupText,
   handoverText,
   fogText,
   agentWorkText,
@@ -103,10 +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                     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
@@ -228,9 +236,10 @@ export const HELP = `harbor: Harbor from the terminal
   harbor voyage PROJECT ["YOUR LINE"]         a Done project's voyage log, and
                                               your line in it
   harbor charter PROJECT [--why T] [--in T] [--out T] [--done-when T]
-                         [--calls T]
-                                              a project's five-line charter:
-                                              read it, or write some lines
+                         [--calls NAME]
+                                              a project's five-line charter
+                                              (why, in, out, done when, who
+                                              makes the calls): read or set
   harbor note PROJECT ["NOTE"] [--opens DATE|--milestone NAME|--off-track]
                                               a note for later: sealed until
                                               its day, milestone, or Off track
@@ -293,9 +302,10 @@ function banner(io, env, words) {
 const THEMES = ["auto", "light", "dark"];
 
 const COMMON = { flags: ["json", "help"], options: ["harbor"] };
-const spec = (flags = [], options = []) => ({
+const spec = (flags = [], options = [], repeat = []) => ({
   flags: [...COMMON.flags, ...flags],
   options: [...COMMON.options, ...options],
+  repeat,
 });
 
 /**
@@ -778,14 +788,21 @@ const DETAIL = {
   charter: [
     "  harbor charter PROJECT                 reads its charter, and any open task",
     "                                         that names something it leaves out",
-    '  harbor charter PROJECT --why "TEXT"    writes: that line; give any of',
-    "                                         --why, --in, --out, --done-when and",
-    "                                         --calls at once",
+    "  Set any line, or all at once:",
+    '    --why "TEXT"         why the project exists',
+    '    --in "A, B"          what it covers (the voyage log counts the',
+    "                         finished tasks naming these)",
+    '    --out "C, D"         what it leaves out (tasks naming these show as',
+    "                         Out of scope?)",
+    '    --done-when "TEXT"   what finished looks like',
+    '    --calls "NAME"       who makes the calls when scope is in question',
     "",
-    "  none clears a line: --out none. Separate items in --in and --out",
-    "  with commas, so Harbor can spot a task that names one. The review lists",
-    "  running projects still without a charter a week after they started.",
-    "  PROJECT is a name, a key like RR, or an id.",
+    "  Items in --in and --out are split on commas; give --in or --out again",
+    '  for an item that has a comma in it: --out "Coupons" --out "Gift cards,',
+    '  vouchers". none clears a line: --out none. The review lists running',
+    "  projects still without a charter a week after they started. A charter",
+    "  is for the harbor's members: share links and public roadmaps never show",
+    "  it. PROJECT is a name, a key like RR, or an id.",
   ],
   sound: [
     "  harbor sound TASK                      reads its sounding: who hasn't answered,",
@@ -944,6 +961,43 @@ const DETAIL = {
     "  days before it (negative: that many over). PROJECT is a name, a key",
     "  like RR, or an id.",
   ],
+  clock: [
+    "  harbor clock                           reads everyone's local time, and",
+    "                                         who's working now",
+    "  harbor clock NAME                      reads one person's",
+    "  harbor clock [NAME] --zone ZONE        writes: sets a time zone (yours",
+    "                                         without NAME)",
+    "  harbor clock [NAME] --hours 9-17       writes: sets working hours",
+    "",
+    "  ZONE is an IANA name like America/New_York or Europe/London, here for",
+    "  this machine's zone, or none to clear the zone and hours. --hours is",
+    "  one start and end in that zone, like 9-17, 8:30-16:30 or 9am-5:30pm,",
+    "  Monday to Friday: one span a day that ends after it starts, so no split",
+    "  day or overnight shift. Without --hours a day runs 9 to 17. Agents",
+    "  don't keep hours.",
+  ],
+  baseline: [
+    "  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",
     "",
@@ -1303,6 +1357,7 @@ export async function run(argv, io = {}) {
       const now = await readCredentials(env);
       return now ? { ...c, harbor: now.harbor ?? null, harborName: now.harborName ?? null } : c;
     };
+    const settings = await readSettings(env);
     await runApp({
       source: tokenSource({
         creds,
@@ -1316,9 +1371,20 @@ export async function run(argv, io = {}) {
         const now = (await readCredentials(env)) ?? creds;
         await writeCredentials({ ...now, harbor: h.id, harborName: h.name }, env);
       },
-      theme: (await readSettings(env)).theme,
+      theme: settings.theme,
       browse: io.browse ?? openBrowser,
       ...(command === "bridge" ? { startIn: "bridge" } : {}),
+      // When this machine last saw you in each harbor: the app opens on a
+      // catch-up after a few days away (src/lib/welcome-back.ts).
+      seen: {
+        last: (id) => settings.seen?.[id] ?? null,
+        mark: (id, at) => {
+          settings.seen = { ...settings.seen, [id]: at };
+          void readSettings(env)
+            .then((now) => writeSettings({ ...now, seen: { ...now.seen, [id]: at } }, env))
+            .catch(() => {});
+        },
+      },
     });
     return 0;
   }
@@ -2680,11 +2746,15 @@ export async function run(argv, io = {}) {
     }
     case "charter": {
       const { positionals, values, harbor } = parse(
-        spec([], ["why", "in", "out", "done-when", "calls"]),
+        spec([], ["why", "done-when", "calls"], ["in", "out"]),
       );
       const project = one(positionals, 'project: harbor charter "NAME"');
-      // none clears a line, as --due none does.
-      const line = (v) => (v.trim().toLowerCase() === "none" ? "" : v);
+      // none clears a line, as --due none does. --in and --out given more than
+      // once write one item each, as a bulleted list, so an item keeps its commas.
+      const line = (v) => {
+        if (Array.isArray(v)) v = v.length > 1 ? v.map((x) => `- ${x.trim()}`).join("\n") : v[0];
+        return v.trim().toLowerCase() === "none" ? "" : v;
+      };
       const lines = Object.fromEntries(
         [
           ["why", values.why],
@@ -2821,12 +2891,41 @@ 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();
       if (!project) throw new HarborError("Say which project: harbor barnacles PROJECT.");
       return call("scope_growth", { harbor, project }, barnaclesText);
     }
+    case "baseline": {
+      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 } : {}) },
+        (r) =>
+          r.changed
+            ? `Set ${r.project}'s baseline: ${r.baselineStart} to ${r.baselineEnd}. harbor barnacles counts tasks added from now on.`
+            : `${r.project} already has a baseline (${r.baselineStart} to ${r.baselineEnd}); --reset replaces it.`,
+      );
+    }
     case "voyage": {
       const { positionals, harbor } = parse(spec());
       const [project, ...words] = positionals;

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,
   };
 }
 
@@ -635,6 +649,7 @@ export function barnaclesText(r) {
   }
   head.push(`${r.headline} (${r.planned} planned, ${r.addedThisWeek} added this week).`);
   if (r.daysLine) head.push(r.daysLine);
+  if (r.caveat) head.push(r.caveat);
   const top = Math.max(1, ...r.byWeek.map((w) => w.added));
   const weeks = r.byWeek.map(
     (w) => `  w/c ${w.weekOf}  ${"█".repeat(Math.max(1, Math.round((w.added / top) * 20)))} ${w.added}`,
@@ -643,7 +658,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)}; setting a baseline 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");
 }
 
@@ -751,12 +766,16 @@ const CHARTER_LINES = [
 export function charterText(r) {
   const project = r.name ?? r.project;
   if (!r.charter) {
-    return `${project} has no charter yet. Write one, a line at a time:\n  harbor charter "${project}" --why "…" --in "…, …" --out "…, …" --done-when "…" --calls "…"`;
+    return `${project} has no charter yet. Set any line, or all at once:\n  harbor charter "${project}" --why "…" --in "…, …" --out "…, …" --done-when "…" --calls "…"`;
   }
   const lines = [`Charter · ${project}`];
   const width = Math.max(...CHARTER_LINES.map(([, label]) => label.length));
   for (const [key, label] of CHARTER_LINES) {
-    if (r.charter[key]) lines.push(`  ${label.padEnd(width)}  ${r.charter[key]}`);
+    // A bulleted In or Out (--in given more than once) keeps its lines lined up.
+    if (r.charter[key])
+      lines.push(
+        `  ${label.padEnd(width)}  ${String(r.charter[key]).replace(/\n/g, `\n  ${" ".repeat(width)}  `)}`,
+      );
   }
   if (r.outOfScope?.length) {
     lines.push("", "Out of scope?");
@@ -1105,3 +1124,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.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.63.0",
+  "version": "0.65.0",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",