@harborppm/cli 0.68.0 → 0.70.0

package/dist/app.mjs

@@ -4858,9 +4858,216 @@ var init_board = __esmMin((() => {
 	];
 }));
 
+//#endregion
+//#region src/lib/first-voyage.ts
+function isVoyageProject(projectId) {
+	return projectId === VOYAGE_PROJECT_ID;
+}
+/** The harbor's projects without First voyage: the work people brought. */
+function ownProjects(projects) {
+	return projects.filter((p) => !isVoyageProject(p.id));
+}
+var VOYAGE_PROJECT_ID, STEPS, voyageTaskId, VOYAGE_NO_FORECAST, SEEDED;
+var init_first_voyage = __esmMin((() => {
+	VOYAGE_PROJECT_ID = "voyage";
+	STEPS = [
+		{
+			step: "task",
+			title: "Add a task of your own",
+			description: "Press New, or the + at the top of a column on any board. Anything real will do. This ticks itself off when you add one."
+		},
+		{
+			step: "move",
+			title: "Move a task to In progress",
+			description: "Open Board above and drag a card along, or change its status in the task's panel. This one counts too. It ticks itself off."
+		},
+		{
+			step: "crew",
+			title: "Bring someone aboard, or tick this to skip",
+			description: "Invite from your menu or from People. Harbor is $49 a month for the whole crew, not per seat. Ticks itself off when someone's in People."
+		},
+		{
+			step: "terminal",
+			title: "Try Harbor in your terminal",
+			description: "Run `npx @harborppm/cli mine` (Node 22 or later) and sign in when your browser asks. `harbor` on its own opens the whole harbor full screen. Ticks itself off once the terminal is connected; skip it if a terminal isn't your thing."
+		},
+		{
+			step: "agent",
+			title: "Ask an AI app to add a task for you",
+			description: "Connect Claude, or any app that speaks MCP, at harborppm.com/ai, then ask it to add a task here. Harbor asks you first and History names the app. Ticks itself off once an app is connected."
+		},
+		{
+			step: "wrap",
+			title: "Mark this project Done, or delete it",
+			description: "That's the voyage. Set its health to Done to put it away, or delete it from Details. Your own work stays."
+		}
+	];
+	voyageTaskId = (step) => `voyage-${step}`;
+	VOYAGE_NO_FORECAST = "It's practice, not the crew's pace, so there's nothing to forecast.";
+	SEEDED = new Set(STEPS.map((s) => voyageTaskId(s.step)));
+}));
+
+//#endregion
+//#region src/lib/passage.ts
+/** Hours as a person would say them: "2h", "1.5h", "30m". */
+function hoursText(h) {
+	if (h > 0 && h < 1) return `${Math.round(h * 60)}m`;
+	return `${Math.round(h * 10) / 10}h`;
+}
+/** Hours kept to the half hour, within what one day can take. */
+function clampHours(h) {
+	if (!Number.isFinite(h)) return 2;
+	return Math.min(12, Math.max(MIN_HOURS, Math.round(h * 2) / 2));
+}
+function dayHoursOf(person) {
+	const h = person?.dayHours;
+	return typeof h === "number" && h > 0 ? Math.min(16, h) : 7;
+}
+/** The Monday of the week a day falls in (a Saturday or Sunday looks ahead to the next week). */
+function weekOf(day = todayISO()) {
+	const d = at$1(day);
+	const wd = d.getDay();
+	const back = wd === 0 ? -1 : wd === 6 ? -2 : wd - 1;
+	return iso$3(addDays(d, -back));
+}
+/** Monday to Friday of the week starting `monday`. */
+function weekDays(monday) {
+	const d = at$1(monday);
+	return [
+		0,
+		1,
+		2,
+		3,
+		4
+	].map((i) => iso$3(addDays(d, i)));
+}
+function shiftWeek(monday, weeks) {
+	return iso$3(addDays(at$1(monday), weeks * 7));
+}
+/** Whether a week should read back how it went: from its Friday on. */
+function isReviewTime(monday, today = todayISO()) {
+	return today >= weekDays(monday)[4];
+}
+/** One person's placements, every week. */
+function placementsOf(data, personId) {
+	return (data.reflections ?? []).filter((r) => isPassage(r) && r.authorId === personId);
+}
+/** The week as its owner plans it. Placements whose task is gone are left out. */
+function weekPlan(data, personId, monday) {
+	const tasks = byId(data.tasks);
+	const dates = weekDays(monday);
+	const dayHours = dayHoursOf(data.people.find((p) => p.id === personId));
+	const inWeek = placementsOf(data, personId).filter((r) => r.date && dates.includes(r.date) && r.taskId && tasks.has(r.taskId));
+	const days = dates.map((date) => {
+		const items = inWeek.filter((r) => r.date === date).sort((a, b) => a.createdAt.localeCompare(b.createdAt)).map((r) => ({
+			id: r.id,
+			task: tasks.get(r.taskId),
+			date,
+			hours: clampHours(r.hours ?? 2)
+		}));
+		const hours = items.reduce((sum, i) => sum + i.hours, 0);
+		return {
+			date,
+			items,
+			hours,
+			over: hours > dayHours
+		};
+	});
+	const placed = new Set(inWeek.map((r) => r.taskId));
+	const open = data.tasks.filter((t) => t.assigneeId === personId && t.status !== "done" && !placed.has(t.id) && !isVoyageProject(t.projectId));
+	const unplanned = open.filter((t) => t.status !== "review").sort(byDue);
+	const inReview = open.filter((t) => t.status === "review").sort(byDue);
+	return {
+		monday,
+		days,
+		dayHours,
+		planned: days.reduce((sum, d) => sum + d.hours, 0),
+		capacity: dayHours * 5,
+		unplanned,
+		inReview
+	};
+}
+/** Planned against done for a week: what was on the plan, what got finished, and what came in besides. */
+function weekReview(data, personId, monday) {
+	const plan = weekPlan(data, personId, monday);
+	const first = plan.days[0].date;
+	const sunday = iso$3(addDays(at$1(monday), 6));
+	const doneInWeek = (t) => t.status === "done" && Boolean(t.completedAt) && todayISO(new Date(t.completedAt)) >= first && todayISO(new Date(t.completedAt)) <= sunday;
+	const hoursBy = /* @__PURE__ */ new Map();
+	for (const d of plan.days) for (const i of d.items) {
+		const had = hoursBy.get(i.task.id);
+		hoursBy.set(i.task.id, {
+			task: i.task,
+			hours: (had?.hours ?? 0) + i.hours
+		});
+	}
+	const planned = [...hoursBy.values()].map(({ task, hours }) => ({
+		task,
+		hours,
+		done: task.status === "done" && (!task.completedAt || todayISO(new Date(task.completedAt)) <= sunday)
+	}));
+	const alsoDone = data.tasks.filter((t) => t.assigneeId === personId && doneInWeek(t) && !hoursBy.has(t.id) && !isVoyageProject(t.projectId)).sort((a, b) => (a.completedAt ?? "").localeCompare(b.completedAt ?? ""));
+	return {
+		monday,
+		planned,
+		doneCount: planned.filter((p) => p.done).length,
+		alsoDone,
+		plannedHours: plan.planned,
+		doneHours: planned.filter((p) => p.done).reduce((sum, p) => sum + p.hours, 0)
+	};
+}
+/** A line for the week's header: "32h of 35h planned", or how full a day is. */
+function plannedText(planned, capacity) {
+	return `${hoursText(planned)} of ${hoursText(capacity)} planned`;
+}
+/** The one line the Friday view leads with. */
+function reviewText(r) {
+	if (r.planned.length === 0) return r.alsoDone.length ? `Nothing was planned, and you finished ${r.alsoDone.length}.` : "Nothing was planned this week.";
+	const also = r.alsoDone.length ? `, and ${r.alsoDone.length} more besides` : "";
+	return `You finished ${r.doneCount} of the ${r.planned.length} you planned${also}.`;
+}
+/** Placements of this person's from before the weeks kept, which a new plan clears. */
+function stalePlacements(data, personId, today = todayISO()) {
+	const cutoff = shiftWeek(weekOf(today), -12);
+	return new Set(placementsOf(data, personId).filter((r) => (r.date ?? "") < cutoff).map((r) => r.id));
+}
+var DAY_HOURS, DEFAULT_HOURS$1, MIN_HOURS, MAX_HOURS, HOUR_CHOICES, isPassage, iso$3, at$1, byDue, DAY_WORDS;
+var init_passage = __esmMin((() => {
+	init_date_fns();
+	init_date_text();
+	init_format();
+	init_indexes();
+	init_first_voyage();
+	DAY_HOURS = 7;
+	DEFAULT_HOURS$1 = 2;
+	MIN_HOURS = .5;
+	MAX_HOURS = 12;
+	HOUR_CHOICES = [
+		.5,
+		1,
+		2,
+		3,
+		4,
+		6,
+		8
+	];
+	isPassage = (r) => r.kind === "passage";
+	iso$3 = (d) => todayISO(d);
+	at$1 = (day) => parseIso(`${day}T12:00:00`);
+	byDue = (a, b) => (a.dueDate ?? "9999").localeCompare(b.dueDate ?? "9999");
+	DAY_WORDS = [
+		"mon",
+		"tue",
+		"wed",
+		"thu",
+		"fri"
+	];
+}));
+
 //#endregion
 //#region src/lib/keep.ts
 init_board();
+init_passage();
 /** Whole days left in the trial, rounded up: 30 on the first day, 1 on the last. 0 once it's over. */
 function trialDaysLeft(trialEndsAt, now = /* @__PURE__ */ new Date()) {
 	if (!trialEndsAt) return 0;
@@ -5295,7 +5502,7 @@ function roadmapWindow(zoom, today, shift = 0) {
 	};
 }
 /** Where a day falls in the window, 0–1, or null outside it. */
-function at$1(iso, w) {
+function at(iso, w) {
 	if (!iso) return null;
 	if (iso < w.start || iso >= w.end) return null;
 	return differenceInCalendarDays(day$4(iso), day$4(w.start)) / w.days;
@@ -5582,6 +5789,7 @@ var init_work = __esmMin((() => {
 //#region src/tui/model.ts
 init_date_fns();
 init_date_text();
+init_first_voyage();
 init_indexes();
 init_tide();
 init_format();
@@ -5762,7 +5970,7 @@ function roadmapCells(start, end, milestones, w, width) {
 		if (s.clippedEnd) cells[b - 1] = "›";
 	}
 	for (const m of milestones) {
-		const pos = at$1(m.due, w);
+		const pos = at(m.due, w);
 		if (pos == null) continue;
 		cells[Math.min(width - 1, Math.floor(pos * width))] = m.done ? "◇" : "◆";
 	}
@@ -5805,6 +6013,7 @@ function filterTasks(tasks, f) {
 * there's no forecast (all done, paused, or nothing finished lately).
 */
 function tideLine(data, project, today) {
+	if (isVoyageProject(project.id)) return null;
 	const tasks = tasksOf(data.tasks, project.id);
 	const tide = tideForecast(project, tasks, parseIso(`${today}T12:00:00`), tideOptions(data));
 	if (tide.kind === "no-pace") return {
@@ -6218,6 +6427,59 @@ function slipLine(data, project, today) {
 	if (!cost?.likely || cost.likely.daysLate <= 0) return null;
 	return slipHeadline(cost);
 }
+/**
+* Your week as the website lays it out (passage.ts): each day with what's on
+* it against the hours you work, then what's yours still to place.
+*/
+function weekLines(data, me, monday, today) {
+	const plan = weekPlan(data, me, monday);
+	const lines = [];
+	for (const d of plan.days) {
+		lines.push({
+			kind: "day",
+			date: d.date,
+			label: format(parseIso(`${d.date}T12:00:00`), "EEE MMM d"),
+			load: d.items.length ? `${hoursText(d.hours)} of ${hoursText(plan.dayHours)}${d.over ? ` · too full by ${hoursText(d.hours - plan.dayHours)}` : ""}` : "nothing planned",
+			over: d.over,
+			today: d.date === today
+		});
+		for (const placement of d.items) lines.push({
+			kind: "placed",
+			placement
+		});
+	}
+	lines.push({
+		kind: "head",
+		text: `Yours to place · ${plan.unplanned.length}`
+	});
+	if (plan.unplanned.length === 0) lines.push({
+		kind: "note",
+		text: "Everything of yours is on a day."
+	});
+	for (const task of plan.unplanned) lines.push({
+		kind: "open",
+		task
+	});
+	if (plan.inReview.length) lines.push({
+		kind: "note",
+		text: `${plan.inReview.length} in review, waiting on someone else, left out.`
+	});
+	return {
+		plan,
+		lines
+	};
+}
+/** How the week went, as lines to read: the website's Friday view. */
+function weekReviewLines(data, me, monday) {
+	const r = weekReview(data, me, monday);
+	const out = [reviewText(r)];
+	if (r.planned.length) out.push(`${hoursText(r.doneHours)} of the ${hoursText(r.plannedHours)} you planned is done.`);
+	if (r.planned.length) out.push("", "Planned");
+	for (const p of r.planned) out.push(`  ${p.done ? "✓" : "○"} ${keyOf$1(data, p.task).padEnd(7)}${p.task.title}  ${hoursText(p.hours)}`);
+	if (r.alsoDone.length) out.push("", "Also done");
+	for (const t of r.alsoDone) out.push(`  ✓ ${keyOf$1(data, t).padEnd(7)}${t.title}`);
+	return out;
+}
 
 //#endregion
 //#region src/tui/theme.ts
@@ -6439,20 +6701,23 @@ function PriorityMark({ priority }) {
 		children: priority === "urgent" ? "!!" : priority === "high" ? "!" : "↓"
 	});
 }
+/** A heading keeps its own width, up to this much of the row; the hints beside it shorten first. */
+const HEADING_MAX = "70%";
 /** A section heading inside a screen. */
 function Heading({ children, right }) {
 	return /* @__PURE__ */ jsxs(Box, {
 		justifyContent: "space-between",
 		columnGap: 2,
 		children: [/* @__PURE__ */ jsx(Box, {
-			flexShrink: 1,
+			flexShrink: 0,
+			maxWidth: "70%",
 			children: /* @__PURE__ */ jsx(Text, {
 				bold: true,
 				wrap: "truncate-end",
 				children
 			})
 		}), right ? /* @__PURE__ */ jsx(Box, {
-			flexShrink: 2,
+			flexShrink: 1,
 			children: /* @__PURE__ */ jsx(Text, {
 				color: theme.muted,
 				wrap: "truncate-end",
@@ -6746,7 +7011,7 @@ function programIsBlocked(data, program) {
 }
 function daysOverdue(dueDate, now) {
 	if (!dueDate) return 0;
-	const today = iso$3(now);
+	const today = iso$2(now);
 	if (today !== overdueDay) {
 		overdueDay = today;
 		overdueByDue.clear();
@@ -6765,7 +7030,7 @@ function daysOverdue(dueDate, now) {
 }
 function daysUntil$1(date, now) {
 	if (!date) return null;
-	const today = iso$3(now);
+	const today = iso$2(now);
 	if (today !== untilDay) {
 		untilDay = today;
 		untilByDate.clear();
@@ -6830,7 +7095,7 @@ function effectiveProjectHealth(project, data, now) {
 }
 /** Milestones past their date and still open. */
 function lateMilestonesOf(milestones, now) {
-	const today = iso$3(now);
+	const today = iso$2(now);
 	return milestones.filter((m) => !m.done && m.dueDate < today);
 }
 /**
@@ -6935,7 +7200,7 @@ function programLateCount(programId, data, now) {
 	for (const p of data.projects) if (p.programId === programId) late += lateTasksOf([...tasksOf(data.tasks, p.id)], now).length;
 	return late;
 }
-var iso$3, overdueDay, overdueByDue, untilDay, untilByDate;
+var iso$2, overdueDay, overdueByDue, untilDay, untilByDate;
 var init_derived_health = __esmMin((() => {
 	init_date_fns();
 	init_date_text();
@@ -6943,7 +7208,7 @@ var init_derived_health = __esmMin((() => {
 	init_indexes();
 	init_health_history();
 	init_clock();
-	iso$3 = (d) => {
+	iso$2 = (d) => {
 		return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 	};
 	overdueDay = "";
@@ -7414,7 +7679,7 @@ function briefOf(data, opts = {}) {
 	const portfolioId = opts.portfolioId ?? null;
 	const programs = portfolioId ? data.programs.filter((p) => p.portfolioId === portfolioId) : data.programs;
 	const programIds = new Set(programs.map((p) => p.id));
-	const projects = data.projects.filter((p) => programIds.has(p.programId));
+	const projects = ownProjects(data.projects.filter((p) => programIds.has(p.programId)));
 	const projectIds = new Set(projects.map((p) => p.id));
 	const tasks = data.tasks.filter((t) => projectIds.has(t.projectId));
 	const risks = data.raidItems.filter((r) => r.kind === "risk" && r.programId != null && programIds.has(r.programId));
@@ -7628,6 +7893,7 @@ var init_brief = __esmMin((() => {
 	init_decisions();
 	init_barnacles();
 	init_baseline();
+	init_first_voyage();
 	BRIEF_BARNACLES_SHOWN = 5;
 	BRIEF_QUIET = "Nothing late or at risk. Say what shipped — or enjoy the quiet week.";
 	BRIEF_LATE_SHOWN = 8;
@@ -7992,6 +8258,7 @@ init_raid();
 init_swatches();
 init_task_keys();
 init_format();
+init_first_voyage();
 /** How many items of one kind a slide lists before "and N more". */
 const LIST_CAP = 4;
 /** When a program's changes are counted from: its last meeting, else a week back. */
@@ -8102,7 +8369,7 @@ function bridgeSlides(doc, programs, now) {
 		if (program.health === "done") continue;
 		const since = bridgeSince(program, now);
 		const milestone = doc.milestones.filter((m) => m.programId === program.id && !m.done).sort((a, b) => a.dueDate.localeCompare(b.dueDate))[0] ?? null;
-		const projects = doc.projects.filter((p) => p.programId === program.id && p.health !== "done").sort((a, b) => rank[a.health] - rank[b.health] || a.endDate.localeCompare(b.endDate));
+		const projects = doc.projects.filter((p) => p.programId === program.id && p.health !== "done" && !isVoyageProject(p.id)).sort((a, b) => rank[a.health] - rank[b.health] || a.endDate.localeCompare(b.endDate));
 		for (const project of projects) {
 			const changes = projectChanges(doc, project, since, now);
 			if (changes.length === 0) {
@@ -9749,13 +10016,13 @@ function InboxView({ active, width, height, go }) {
 /** Open tasks for one person, bucketed by the week they are due, plus what is already late or has no date. */
 function weeklyLoad(tasks, personId, now, weeks = 6, calendar) {
 	const mine = tasks.filter((t) => t.assigneeId === personId && t.status !== "done");
-	const today = iso$2(now);
+	const today = iso$1(now);
 	const origin = startOfWeek(now, { weekStartsOn: 1 });
 	const buckets = Array.from({ length: weeks }, (_, i) => {
-		const start = iso$2(addDays(origin, i * 7));
+		const start = iso$1(addDays(origin, i * 7));
 		const off = [];
 		if (calendar?.active) for (let d = 0; d < 5; d++) {
-			const date = iso$2(addDays(origin, i * 7 + d));
+			const date = iso$1(addDays(origin, i * 7 + d));
 			const why = calendar.offOn(personId, date);
 			if (why) off.push({
 				date,
@@ -9790,58 +10057,14 @@ function weeklyLoad(tasks, personId, now, weeks = 6, calendar) {
 		weeks: buckets
 	};
 }
-var iso$2;
+var iso$1;
 var init_load = __esmMin((() => {
 	init_date_fns();
-	iso$2 = (d) => {
+	iso$1 = (d) => {
 		return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 	};
 }));
 
-//#endregion
-//#region src/lib/first-voyage.ts
-function isVoyageProject(projectId) {
-	return projectId === VOYAGE_PROJECT_ID;
-}
-var VOYAGE_PROJECT_ID, STEPS, voyageTaskId, SEEDED;
-var init_first_voyage = __esmMin((() => {
-	VOYAGE_PROJECT_ID = "voyage";
-	STEPS = [
-		{
-			step: "task",
-			title: "Add a task of your own",
-			description: "Press New, or the + at the top of a column on any board. Anything real will do. This ticks itself off when you add one."
-		},
-		{
-			step: "move",
-			title: "Move a task to In progress",
-			description: "Open Board above and drag a card along, or change its status in the task's panel. This one counts too. It ticks itself off."
-		},
-		{
-			step: "crew",
-			title: "Bring someone aboard, or tick this to skip",
-			description: "Invite from your menu or from People. Harbor is $49 a month for the whole crew, not per seat. Ticks itself off when someone's in People."
-		},
-		{
-			step: "terminal",
-			title: "Try Harbor in your terminal",
-			description: "Run `npx @harborppm/cli mine` (Node 22 or later) and sign in when your browser asks. `harbor` on its own opens the whole harbor full screen. Ticks itself off once the terminal is connected; skip it if a terminal isn't your thing."
-		},
-		{
-			step: "agent",
-			title: "Ask an AI app to add a task for you",
-			description: "Connect Claude, or any app that speaks MCP, at harborppm.com/ai, then ask it to add a task here. Harbor asks you first and History names the app. Ticks itself off once an app is connected."
-		},
-		{
-			step: "wrap",
-			title: "Mark this project Done, or delete it",
-			description: "That's the voyage. Set its health to Done to put it away, or delete it from Details. Your own work stays."
-		}
-	];
-	voyageTaskId = (step) => `voyage-${step}`;
-	SEEDED = new Set(STEPS.map((s) => voyageTaskId(s.step)));
-}));
-
 //#endregion
 //#region src/lib/handover.ts
 /** Everything a person carries that someone else would have to pick up, grouped in KIND_ORDER. */
@@ -18880,7 +19103,7 @@ function reviewCsv(data, programs, now) {
 //#endregion
 //#region src/lib/crew-clocks.ts
 /** Working hours when only a time zone is set. */
-const DEFAULT_HOURS$1 = {
+const DEFAULT_HOURS = {
 	start: "09:00",
 	end: "17:00"
 };
@@ -18954,8 +19177,8 @@ function clockOf(person, at) {
 	const zone = person?.timeZone;
 	if (!isZone(zone)) return null;
 	const wall = wallIn(zone, at);
-	const start = minutesOf(person?.workStart) ?? minutesOf(DEFAULT_HOURS$1.start);
-	let end = minutesOf(person?.workEnd) ?? minutesOf(DEFAULT_HOURS$1.end);
+	const start = minutesOf(person?.workStart) ?? minutesOf(DEFAULT_HOURS.start);
+	let end = minutesOf(person?.workEnd) ?? minutesOf(DEFAULT_HOURS.end);
 	if (end <= start) end = Math.min(1440, start + 480);
 	const weekday = wall.weekday >= 1 && wall.weekday <= 5;
 	const working = weekday && wall.minutes >= start && wall.minutes < end;
@@ -19437,150 +19660,12 @@ var init_fog = __esmMin((() => {
 	fileCache = /* @__PURE__ */ new WeakMap();
 }));
 
-//#endregion
-//#region src/lib/passage.ts
-/** Hours as a person would say them: "2h", "1.5h", "30m". */
-function hoursText(h) {
-	if (h > 0 && h < 1) return `${Math.round(h * 60)}m`;
-	return `${Math.round(h * 10) / 10}h`;
-}
-/** Hours kept to the half hour, within what one day can take. */
-function clampHours(h) {
-	if (!Number.isFinite(h)) return 2;
-	return Math.min(12, Math.max(MIN_HOURS, Math.round(h * 2) / 2));
-}
-function dayHoursOf(person) {
-	const h = person?.dayHours;
-	return typeof h === "number" && h > 0 ? Math.min(16, h) : 7;
-}
-/** The Monday of the week a day falls in (a Saturday or Sunday looks ahead to the next week). */
-function weekOf(day = todayISO()) {
-	const d = at(day);
-	const wd = d.getDay();
-	const back = wd === 0 ? -1 : wd === 6 ? -2 : wd - 1;
-	return iso$1(addDays(d, -back));
-}
-/** Monday to Friday of the week starting `monday`. */
-function weekDays(monday) {
-	const d = at(monday);
-	return [
-		0,
-		1,
-		2,
-		3,
-		4
-	].map((i) => iso$1(addDays(d, i)));
-}
-function shiftWeek(monday, weeks) {
-	return iso$1(addDays(at(monday), weeks * 7));
-}
-/** One person's placements, every week. */
-function placementsOf(data, personId) {
-	return (data.reflections ?? []).filter((r) => isPassage(r) && r.authorId === personId);
-}
-/** The week as its owner plans it. Placements whose task is gone are left out. */
-function weekPlan(data, personId, monday) {
-	const tasks = byId(data.tasks);
-	const dates = weekDays(monday);
-	const dayHours = dayHoursOf(data.people.find((p) => p.id === personId));
-	const inWeek = placementsOf(data, personId).filter((r) => r.date && dates.includes(r.date) && r.taskId && tasks.has(r.taskId));
-	const days = dates.map((date) => {
-		const items = inWeek.filter((r) => r.date === date).sort((a, b) => a.createdAt.localeCompare(b.createdAt)).map((r) => ({
-			id: r.id,
-			task: tasks.get(r.taskId),
-			date,
-			hours: clampHours(r.hours ?? 2)
-		}));
-		const hours = items.reduce((sum, i) => sum + i.hours, 0);
-		return {
-			date,
-			items,
-			hours,
-			over: hours > dayHours
-		};
-	});
-	const placed = new Set(inWeek.map((r) => r.taskId));
-	const open = data.tasks.filter((t) => t.assigneeId === personId && t.status !== "done" && !placed.has(t.id));
-	const unplanned = open.filter((t) => t.status !== "review").sort(byDue);
-	const inReview = open.filter((t) => t.status === "review").sort(byDue);
-	return {
-		monday,
-		days,
-		dayHours,
-		planned: days.reduce((sum, d) => sum + d.hours, 0),
-		capacity: dayHours * 5,
-		unplanned,
-		inReview
-	};
-}
-/** Planned against done for a week: what was on the plan, what got finished, and what came in besides. */
-function weekReview(data, personId, monday) {
-	const plan = weekPlan(data, personId, monday);
-	const first = plan.days[0].date;
-	const sunday = iso$1(addDays(at(monday), 6));
-	const doneInWeek = (t) => t.status === "done" && Boolean(t.completedAt) && todayISO(new Date(t.completedAt)) >= first && todayISO(new Date(t.completedAt)) <= sunday;
-	const hoursBy = /* @__PURE__ */ new Map();
-	for (const d of plan.days) for (const i of d.items) {
-		const had = hoursBy.get(i.task.id);
-		hoursBy.set(i.task.id, {
-			task: i.task,
-			hours: (had?.hours ?? 0) + i.hours
-		});
-	}
-	const planned = [...hoursBy.values()].map(({ task, hours }) => ({
-		task,
-		hours,
-		done: task.status === "done" && (!task.completedAt || todayISO(new Date(task.completedAt)) <= sunday)
-	}));
-	const alsoDone = data.tasks.filter((t) => t.assigneeId === personId && doneInWeek(t) && !hoursBy.has(t.id)).sort((a, b) => (a.completedAt ?? "").localeCompare(b.completedAt ?? ""));
-	return {
-		monday,
-		planned,
-		doneCount: planned.filter((p) => p.done).length,
-		alsoDone,
-		plannedHours: plan.planned,
-		doneHours: planned.filter((p) => p.done).reduce((sum, p) => sum + p.hours, 0)
-	};
-}
-/** The one line the Friday view leads with. */
-function reviewText(r) {
-	if (r.planned.length === 0) return r.alsoDone.length ? `Nothing was planned, and you finished ${r.alsoDone.length}.` : "Nothing was planned this week.";
-	const also = r.alsoDone.length ? `, and ${r.alsoDone.length} more besides` : "";
-	return `You finished ${r.doneCount} of the ${r.planned.length} you planned${also}.`;
-}
-/** Placements of this person's from before the weeks kept, which a new plan clears. */
-function stalePlacements(data, personId, today = todayISO()) {
-	const cutoff = shiftWeek(weekOf(today), -12);
-	return new Set(placementsOf(data, personId).filter((r) => (r.date ?? "") < cutoff).map((r) => r.id));
-}
-var DAY_HOURS, DEFAULT_HOURS, MIN_HOURS, MAX_HOURS, isPassage, iso$1, at, byDue, DAY_WORDS;
-var init_passage = __esmMin((() => {
-	init_date_fns();
-	init_date_text();
-	init_format();
-	init_indexes();
-	DAY_HOURS = 7;
-	DEFAULT_HOURS = 2;
-	MIN_HOURS = .5;
-	MAX_HOURS = 12;
-	isPassage = (r) => r.kind === "passage";
-	iso$1 = (d) => todayISO(d);
-	at = (day) => parseIso(`${day}T12:00:00`);
-	byDue = (a, b) => (a.dueDate ?? "9999").localeCompare(b.dueDate ?? "9999");
-	DAY_WORDS = [
-		"mon",
-		"tue",
-		"wed",
-		"thu",
-		"fri"
-	];
-}));
-
 //#endregion
 //#region src/lib/mcp/tools.ts
 init_thanks();
 init_task_keys();
 init_brief();
+init_first_voyage();
 init_indexes();
 init_tide();
 init_barnacles();
@@ -19682,6 +19767,7 @@ const STATUSES = [
 * Given the spend ledger, also what each week late costs (src/lib/slip-cost.ts).
 */
 function finishForecast(project, tasks, now, spend, data) {
+	if (isVoyageProject(project.id)) return { none: VOYAGE_NO_FORECAST };
 	const tide = tideForecast(project, tasks, now, data ? tideOptions(data) : {});
 	if (tide.kind !== "forecast") return { none: tideQuiet(tide) };
 	const lastDue = dueAfterFinish(tide);
@@ -27975,7 +28061,8 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 				justifyContent: "space-between",
 				columnGap: 2,
 				children: [/* @__PURE__ */ jsx(Box, {
-					flexShrink: 1,
+					flexShrink: 0,
+					maxWidth: "70%",
 					children: /* @__PURE__ */ jsxs(Text, {
 						wrap: "truncate-end",
 						children: [
@@ -27996,7 +28083,7 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 						]
 					})
 				}), /* @__PURE__ */ jsx(Box, {
-					flexShrink: 2,
+					flexShrink: 1,
 					children: /* @__PURE__ */ jsxs(Text, {
 						color: theme.muted,
 						wrap: "truncate-end",
@@ -28090,7 +28177,9 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 					const w = Math.floor((width - 2) / shownColumns.length);
 					const on = active && ci === col;
 					const r = Math.min(rowByCol[ci] ?? 0, Math.max(0, c.tasks.length - 1));
-					const view = windowOf(c.tasks, r, Math.max(1, Math.floor((body - 3) / 3)));
+					const room = body - 3;
+					const fits = Math.floor(room / 3) >= c.tasks.length;
+					const view = windowOf(c.tasks, r, Math.max(1, Math.floor((fits ? room : room - 2) / 3)));
 					const over = c.limit != null && c.all > c.limit;
 					return /* @__PURE__ */ jsxs(Box, {
 						flexDirection: "column",
@@ -29725,6 +29814,189 @@ function TodayView({ active, width, height, go }) {
 	});
 }
 
+//#endregion
+//#region src/tui/views/week.tsx
+init_date_text();
+init_passage();
+const dayName = (date) => format(parseIso(`${date}T12:00:00`), "EEEE");
+/**
+* Your week, as on the website: your tasks laid on the five working days
+* against the hours you work, and from Friday how it went. Only you see it.
+* p puts a task on a day (or moves it), h sets its hours, d takes it off,
+* [ and ] step through the weeks, v swaps plan and how it went.
+*/
+function WeekView({ active, width, height, go }) {
+	const { store, today } = useDeps();
+	const tasks = useHarbor((s) => s.tasks);
+	const projects = useHarbor((s) => s.projects);
+	const people = useHarbor((s) => s.people);
+	const reflections = useHarbor((s) => s.reflections);
+	const me = useHarbor((s) => s.currentUserId);
+	const day = today();
+	const [monday, setMonday] = useState(() => weekOf(day));
+	const [review, setReview] = useState(() => isReviewTime(weekOf(day), day));
+	const [at, setAt] = useState(0);
+	const data = useMemo(() => ({
+		tasks,
+		projects,
+		people,
+		reflections
+	}), [
+		tasks,
+		projects,
+		people,
+		reflections
+	]);
+	const { plan, lines } = useMemo(() => weekLines(data, me, monday, day), [
+		data,
+		me,
+		monday,
+		day
+	]);
+	const read = useMemo(() => weekReviewLines(data, me, monday), [
+		data,
+		me,
+		monday
+	]);
+	const picks = lines.flatMap((l, i) => l.kind === "placed" || l.kind === "open" ? [i] : []);
+	const sel = Math.min(at, Math.max(0, picks.length - 1));
+	const line = picks.length ? lines[picks[sel]] : void 0;
+	const task = line?.kind === "placed" ? line.placement.task : line?.kind === "open" ? line.task : void 0;
+	const dates = weekDays(monday);
+	const dayChoices = (except) => dates.filter((d) => d !== except).map((d) => ({
+		label: `${dayName(d)}${d === day ? " (today)" : ""}`,
+		value: d
+	}));
+	const goWeek = (weeks) => {
+		const next = weeks === 0 ? weekOf(day) : shiftWeek(monday, weeks);
+		setMonday(next);
+		setReview(isReviewTime(next, day) && next <= weekOf(day));
+		setAt(0);
+	};
+	useInput((input, key) => {
+		if (input === "[") return goWeek(-1);
+		if (input === "]") return goWeek(1);
+		if (input === "t") return goWeek(0);
+		if (input === "v") return setReview((v) => !v);
+		if (review) return;
+		if (key.upArrow || input === "k") setAt(step(sel, -1, picks.length));
+		else if (key.downArrow || input === "j") setAt(step(sel, 1, picks.length));
+		else if (key.return && task) go.openTask(task.id);
+		else if (input === "p" && line?.kind === "open") go.pick(`Plan “${line.task.title}” on`, dayChoices(), (d) => {
+			if (store.getState().planTask(line.task.id, d)) go.notify(`On ${dayName(d)}. h changes its hours.`);
+		});
+		else if (input === "p" && line?.kind === "placed") go.pick(`Move “${line.placement.task.title}” to`, dayChoices(line.placement.date), (d) => store.getState().movePlacement(line.placement.id, d));
+		else if (input === "h" && line?.kind === "placed") go.pick(`Hours for “${line.placement.task.title}” on ${dayName(line.placement.date)}`, HOUR_CHOICES.map((h) => ({
+			label: hoursText(h),
+			value: h
+		})), (h) => store.getState().setPlacementHours(line.placement.id, h));
+		else if ((input === "d" || key.delete) && line?.kind === "placed") {
+			store.getState().unplan(line.placement.id);
+			go.notify(`Took ${keyOf$1({ projects }, line.placement.task)} off ${dayName(line.placement.date)}.`);
+		}
+	}, { isActive: active });
+	const title = `Your week · ${format(parseIso(`${dates[0]}T12:00:00`), "MMM d")} to ${format(parseIso(`${dates[4]}T12:00:00`), "MMM d")}`;
+	const rows = Math.max(3, height - 4);
+	if (review) return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		width,
+		height,
+		paddingX: 1,
+		children: [
+			/* @__PURE__ */ jsx(Heading, { children: `${title} · How it went` }),
+			read.slice(0, rows).map((l, i) => /* @__PURE__ */ jsx(Text, {
+				wrap: "truncate-end",
+				color: i === 0 ? void 0 : theme.muted,
+				children: l || " "
+			}, i)),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					color: theme.muted,
+					wrap: "truncate-end",
+					children: "Only you see this · v the plan · [ ] other weeks · t this week"
+				})
+			})
+		]
+	});
+	const view = windowOf(lines, picks[sel] ?? 0, rows);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		width,
+		height,
+		paddingX: 1,
+		children: [
+			/* @__PURE__ */ jsx(Heading, {
+				right: plannedText(plan.planned, plan.capacity),
+				children: title
+			}),
+			view.items.map((l, i) => {
+				const selected = active && view.start + i === picks[sel];
+				if (l.kind === "day") return /* @__PURE__ */ jsxs(Text, {
+					wrap: "truncate-end",
+					children: [/* @__PURE__ */ jsx(Text, {
+						bold: true,
+						children: l.label
+					}), /* @__PURE__ */ jsxs(Text, {
+						color: l.over ? theme.warn : theme.muted,
+						children: [
+							"  ",
+							l.load,
+							l.today ? " · today" : ""
+						]
+					})]
+				}, l.date);
+				if (l.kind === "placed") return /* @__PURE__ */ jsxs(Box, {
+					width: width - 2,
+					children: [/* @__PURE__ */ jsx(Box, {
+						flexGrow: 1,
+						flexShrink: 1,
+						children: /* @__PURE__ */ jsx(TaskLine, {
+							task: l.placement.task,
+							projects,
+							today: day,
+							selected,
+							width: width - 8,
+							showProject: false
+						})
+					}), /* @__PURE__ */ jsxs(Text, {
+						color: theme.muted,
+						children: [" ", hoursText(l.placement.hours).padStart(4)]
+					})]
+				}, l.placement.id);
+				if (l.kind === "open") return /* @__PURE__ */ jsx(TaskLine, {
+					task: l.task,
+					projects,
+					today: day,
+					selected,
+					width: width - 2
+				}, `open-${l.task.id}`);
+				if (l.kind === "head") return /* @__PURE__ */ jsx(Box, {
+					marginTop: view.start + i === 0 ? 0 : 1,
+					children: /* @__PURE__ */ jsx(Text, {
+						bold: true,
+						wrap: "truncate-end",
+						children: l.text
+					})
+				}, `head-${i}`);
+				return /* @__PURE__ */ jsxs(Text, {
+					color: theme.muted,
+					wrap: "truncate-end",
+					children: ["  ", l.text]
+				}, `note-${i}`);
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					color: theme.muted,
+					wrap: "truncate-end",
+					children: "Only you see this · p plan · h hours · d off · v how it went · [ ] weeks"
+				})
+			})
+		]
+	});
+}
+
 //#endregion
 //#region src/tui/app.tsx
 /**
@@ -29778,10 +30050,14 @@ const NAV = [
 	{
 		screen: "crew",
 		label: "Crew"
+	},
+	{
+		screen: "week",
+		label: "Your week"
 	}
 ];
-/** The key that opens a sidebar screen: 1 to 9, 0 for the tenth, C for the crew. */
-const navKey = (i) => i < 10 ? String((i + 1) % 10) : "C";
+/** The key that opens a sidebar screen: 1 to 9, 0 for the tenth, C for the crew, W for your week. */
+const navKey = (i) => i < 10 ? String((i + 1) % 10) : i === 10 ? "C" : "W";
 /** The sidebar's width: its longest line ("9 Calendar", ": Anything") with room either side. */
 const NAV_WIDTH = 15;
 /** Every open program, in the review's order: what a meeting started from the palette covers. */
@@ -30002,6 +30278,7 @@ function App({ ui, startIn }) {
 		if (input === "?") return setOverlay({ kind: "help" });
 		if (input === "H") return setOverlay({ kind: "harbors" });
 		if (input === "C") return goScreen("crew");
+		if (input === "W") return goScreen("week");
 		if (input === "r" && page?.kind !== "bridge") {
 			sync.retryNow();
 			return notify("Saving now.");
@@ -30295,6 +30572,7 @@ function App({ ui, startIn }) {
 	else if (screen === "calendar") screenNode = /* @__PURE__ */ jsx(CalendarView, { ...viewProps });
 	else if (screen === "brief") screenNode = /* @__PURE__ */ jsx(BriefView, { ...viewProps });
 	else if (screen === "crew") screenNode = /* @__PURE__ */ jsx(CrewView, { ...viewProps });
+	else if (screen === "week") screenNode = /* @__PURE__ */ jsx(WeekView, { ...viewProps });
 	else screenNode = /* @__PURE__ */ jsx(HistoryView, { ...viewProps });
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",

package/lib/cli.mjs

@@ -440,11 +440,28 @@ const level = (v, name) => {
 const nullable = (v) => (v === "none" ? null : v);
 const REPEAT_WORD = { weekly: "every week", biweekly: "every two weeks", monthly: "every month" };
 
-/** --due as people say it: today, tomorrow, +3, or a date. Anything else goes to Harbor to judge. */
+const WEEKDAYS = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+
+/** "fri", "Friday": how many days until that weekday comes round (today counts). */
+function daysToWeekday(v, today) {
+  const w = v.toLowerCase();
+  if (w.length < 3) return null;
+  const i = WEEKDAYS.findIndex((d) => d.startsWith(w));
+  return i < 0 ? null : (i - today.getDay() + 7) % 7;
+}
+
+/** --due as people say it: today, tomorrow, friday, +3, or a date. Anything else goes to Harbor to judge. */
 export function dueDate(v, today = new Date()) {
   if (v === undefined || v === null) return v;
   const words = { today: 0, tomorrow: 1 };
-  const days = v in words ? words[v] : /^\+\d{1,3}$/.test(v) ? Number(v.slice(1)) : null;
+  const days =
+    v in words
+      ? words[v]
+      : /^\+\d{1,3}$/.test(v)
+        ? Number(v.slice(1))
+        : /^[a-z]+$/i.test(v)
+          ? daysToWeekday(v, today)
+          : null;
   if (days === null) return v;
   const d = new Date(today.getFullYear(), today.getMonth(), today.getDate() + days);
   return todayLocal(d);
@@ -538,7 +555,7 @@ export function hint(message, project) {
           (_, list) => `pick one of ${list.replace(/"/g, "").split("|").join(", ")}`,
         )
         // The CLI reads today, tomorrow and +N before Harbor sees the date.
-        .replace(/^a date as YYYY-MM-DD$/, "a date like 2026-11-30, today, tomorrow or +N days");
+        .replace(/^a date as YYYY-MM-DD$/, "a date like 2026-11-30, today, tomorrow, friday or +N days");
       if (!seen.has(flag)) seen.set(flag, said);
     }
     return [...seen].map(([flag, why]) => `${flag}: ${why}`).join("\n");
@@ -1226,12 +1243,28 @@ function distance(a, b) {
   return d[a.length][b.length];
 }
 
+/** What someone who knows the website, or a feature's name, might type. */
+const OTHER_NAMES = {
+  today: "harbor mine lists what's on you, late first; harbor week plans your days.",
+  inbox: "harbor catchup says what was handed to you and what moved.",
+  people: "harbor lifeboats, harbor clock and harbor ashore cover the crew; the app's People screen (harbor, then 6) shows everyone's load.",
+  crew: "harbor invite EMAIL brings someone aboard; the app's Crew screen (harbor, then C) lists who's on it.",
+  longpole: "harbor why PROJECT shows what's holding it up.",
+  "long-pole": "harbor why PROJECT shows what's holding it up.",
+  pilot: "harbor show TASK says the date its owner's queue suggests; --due pilot on add or edit takes it.",
+  dock: "harbor try PROJECT is the dry dock.",
+  "dry-dock": "harbor try PROJECT is the dry dock.",
+};
+
 /** A mistyped command, with the one it was probably meant to be. */
 export function noCommand(name) {
   if (name.startsWith("-")) return `${name} goes after a command, like harbor mine ${name}.`;
   // A plural kind reads the register, not the command that writes one.
   if (["decisions", "issues"].includes(name))
     return `No command "${name}". harbor risks --kind ${name.slice(0, -1)} lists them.`;
+  // Words for things the website has a page for, or that go by another name here.
+  const other = OTHER_NAMES[name.toLowerCase()];
+  if (other) return `No command "${name}". ${other}`;
   const near = COMMANDS.filter((c) => distance(name, c) <= (c.length > 4 ? 2 : 1));
   const guess = near.length === 1 ? ` Did you mean harbor ${near[0]}?` : "";
   return `No command "${name}".${guess} Run harbor help.`;

package/lib/format.mjs

@@ -581,7 +581,7 @@ export function bridgeText(r) {
   );
   for (const p of r.projects ?? []) {
     const facts = [
-      p.health,
+      p.health?.replace(/-/g, " "),
       p.lead,
       p.ends ? `ends ${p.ends}` : null,
       `${p.late} late of ${p.open} open`,
@@ -756,7 +756,8 @@ export function importText(r) {
   if (r.alreadyThere) lines.push(`${n(r.alreadyThere, "task")} already there, left alone.`);
   if (r.leftOut) lines.push(`${n(r.leftOut, "row")} left out (canceled, won't do or duplicate).`);
   if (r.waitsOnLinks) lines.push(`${n(r.waitsOnLinks, "link")} between tasks became "waits on".`);
-  for (const p of r.problems ?? []) lines.push(`Row ${p.row}: ${p.message}`);
+  for (const p of r.problems ?? [])
+    lines.push(`${p.card ? `Card “${p.card}”` : `Row ${p.row}`}: ${p.message}`);
   return lines.join("\n");
 }
 

package/package.json

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