@harborppm/cli 0.20.1 → 0.21.0

package/dist/app.mjs

@@ -4230,6 +4230,262 @@ function Palette({ width, base, open, onClose }) {
 	});
 }
 
+//#endregion
+//#region src/lib/health-history.ts
+/** The history with one more line when `health` differs from the last recorded one. Same array otherwise. */
+function recordHealth(history, health, at, override, note) {
+	const last = history?.[history.length - 1];
+	if (last && last.health === health && last.override === override && (last.note ?? null) === (note ?? null)) return history;
+	return [...history ?? [], {
+		at,
+		health,
+		override,
+		note: note ?? null
+	}].slice(-30);
+}
+
+//#endregion
+//#region src/lib/derived-health.ts
+const iso$1 = (d) => {
+	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+};
+function parseDate(value) {
+	return parseIso(value.length === 10 ? `${value}T12:00:00` : value);
+}
+function isBlocked(task, tasks) {
+	return blockersIn(task, tasks).some((b) => b.status !== "done");
+}
+/** A project with no tasks yet, or any task still open, hasn't cleared. */
+function projectHasOpenWork(data, projectId) {
+	const tasks = tasksOf(data.tasks, projectId);
+	return tasks.length === 0 || tasks.some((t) => t.status !== "done");
+}
+/** Every task finished (and at least one): the project reads as ready to be marked Done. */
+function allTasksDone(allTasks, projectId) {
+	const tasks = tasksOf(allTasks, projectId);
+	return tasks.length > 0 && tasks.every((t) => t.status === "done");
+}
+/** A project whose work is all done but isn't marked Done yet: offer to finish it. */
+function suggestsDone(project, tasks) {
+	return project.health !== "done" && allTasksDone(tasks, project.id);
+}
+/**
+* A hand-set health that overrules the rules: On track, At risk or Off track.
+* Paused and Done are states someone puts a project in, so they don't read
+* as an override.
+*/
+function overridesTrack(item) {
+	const h = item.healthOverride;
+	return h === "on-track" || h === "at-risk" || h === "off-track";
+}
+/** Every project this one waits on that still exists. */
+function projectBlockersOf(data, project) {
+	return blockersIn(project, data.projects);
+}
+/** The blockers with open work left: the ones actually holding it up. */
+function projectOpenBlockers(data, project) {
+	return projectBlockersOf(data, project).filter((b) => projectHasOpenWork(data, b.id));
+}
+function projectIsBlocked(data, project) {
+	return projectOpenBlockers(data, project).length > 0;
+}
+/** A program with no projects yet, or any project still open, hasn't cleared. */
+function programHasOpenWork(data, programId) {
+	const projects = data.projects.filter((p) => p.programId === programId);
+	return projects.length === 0 || projects.some((p) => projectHasOpenWork(data, p.id));
+}
+function programBlockersOf(data, program) {
+	return blockersIn(program, data.programs);
+}
+function programOpenBlockers(data, program) {
+	return programBlockersOf(data, program).filter((b) => programHasOpenWork(data, b.id));
+}
+function programIsBlocked(data, program) {
+	return programOpenBlockers(data, program).length > 0;
+}
+let overdueDay = "";
+const overdueByDue = /* @__PURE__ */ new Map();
+function daysOverdue(dueDate, now) {
+	if (!dueDate) return 0;
+	const today = iso$1(now);
+	if (today !== overdueDay) {
+		overdueDay = today;
+		overdueByDue.clear();
+	}
+	const hit = overdueByDue.get(dueDate);
+	if (hit !== void 0) return hit;
+	let days = 0;
+	try {
+		const n = differenceInCalendarDays(startOfDay(now), startOfDay(parseDate(dueDate)));
+		days = n > 0 ? n : 0;
+	} catch {
+		days = 0;
+	}
+	overdueByDue.set(dueDate, days);
+	return days;
+}
+let untilDay = "";
+const untilByDate = /* @__PURE__ */ new Map();
+function daysUntil(date, now) {
+	if (!date) return null;
+	const today = iso$1(now);
+	if (today !== untilDay) {
+		untilDay = today;
+		untilByDate.clear();
+	}
+	const hit = untilByDate.get(date);
+	if (hit !== void 0) return hit;
+	let days;
+	try {
+		days = differenceInCalendarDays(startOfDay(parseDate(date)), startOfDay(now));
+	} catch {
+		days = null;
+	}
+	untilByDate.set(date, days);
+	return days;
+}
+function incomplete(task) {
+	return task.status !== "done";
+}
+function wipLimitOf(status, stored, uncapped) {
+	if (stored != null) return stored;
+	if (uncapped === true) return null;
+	if (status === "doing") return 3;
+	if (status === "review") return 2;
+	return null;
+}
+function wipOverflowing(data, projectId) {
+	const cols = data.boardConfigs?.[projectId]?.columns;
+	if (cols?.length) return cols.some((c) => {
+		if (c.visible === false) return false;
+		const limit = wipLimitOf(c.status, c.wipLimit, c.uncapped);
+		if (limit == null) return false;
+		return tasksOf(data.tasks, projectId).filter((t) => t.status === c.status).length > limit;
+	});
+	const mine = tasksOf(data.tasks, projectId);
+	const doing = mine.filter((t) => t.status === "doing").length;
+	const review = mine.filter((t) => t.status === "review").length;
+	return doing > 3 || review > 2;
+}
+function deriveProjectHealth(project, data, now) {
+	const tasks = tasksOf(data.tasks, project.id);
+	const open = tasks.filter(incomplete);
+	const maxOverdue = open.map((t) => daysOverdue(t.dueDate, now)).reduce((a, b) => Math.max(a, b), 0);
+	const until = daysUntil(project.endDate, now);
+	const unfinished = open.length > 0 || tasks.length === 0 && until != null && until < 0;
+	if (maxOverdue > 3 || until != null && until < 0 && unfinished) return "off-track";
+	const blockers = open.some((t) => isBlocked(t, data.tasks)) || projectIsBlocked(data, project);
+	const wip = wipOverflowing(data, project.id);
+	if (maxOverdue >= 1 || until != null && until >= 0 && until <= 7 && (blockers || wip)) return "at-risk";
+	return "on-track";
+}
+function worstTrack(healths) {
+	if (healths.some((h) => h === "off-track")) return "off-track";
+	if (healths.some((h) => h === "at-risk")) return "at-risk";
+	return "on-track";
+}
+/** The override wins when set; Paused and Done are overrides too, and stay until reset. */
+function effectiveProjectHealth(project, data, now) {
+	return project.healthOverride ?? deriveProjectHealth(project, data, now);
+}
+/** Milestones past their date and still open. */
+function lateMilestonesOf(milestones, now) {
+	const today = iso$1(now);
+	return milestones.filter((m) => !m.done && m.dueDate < today);
+}
+/**
+* The projects an open milestone waits on that put its date in doubt: one
+* scheduled to end after the milestone is due, or one off track with work
+* still open. Finished projects and a reached milestone carry no risk.
+*/
+function milestoneRisks(milestone, data) {
+	if (milestone.done) return [];
+	return blockersIn(milestone, data.projects).flatMap((project) => {
+		if (!projectHasOpenWork(data, project.id)) return [];
+		if (project.endDate > milestone.dueDate) return [{
+			project,
+			reason: "ends-after"
+		}];
+		if (project.health === "off-track") return [{
+			project,
+			reason: "off-track"
+		}];
+		return [];
+	});
+}
+/**
+* `projectHealth` defaults to working each project out afresh; stampHealth
+* passes the health it has just stamped, so no project is derived twice.
+*/
+function deriveProgramHealth(program, data, now, projectHealth = (p) => effectiveProjectHealth(p, data, now)) {
+	const kids = data.projects.filter((p) => p.programId === program.id);
+	const blocked = programIsBlocked(data, program) ? "at-risk" : "on-track";
+	const ownMilestones = (data.milestones ?? []).filter((m) => m.programId === program.id);
+	const lateMilestone = lateMilestonesOf(ownMilestones, now).length > 0 || ownMilestones.some((m) => milestoneRisks(m, data).length > 0) ? "at-risk" : "on-track";
+	if (kids.length === 0) return worstTrack([blocked, lateMilestone]);
+	return worstTrack([
+		...kids.map(projectHealth),
+		blocked,
+		lateMilestone
+	]);
+}
+function effectiveProgramHealth(program, data, now, projectHealth) {
+	return program.healthOverride ?? deriveProgramHealth(program, data, now, projectHealth);
+}
+/** A paused or done program neither helps nor hurts the portfolio. */
+function derivePortfolioHealth(portfolioId, data, now, programHealth = (p) => effectiveProgramHealth(p, data, now)) {
+	const kids = data.programs.filter((p) => p.portfolioId === portfolioId);
+	if (kids.length === 0) return "on-track";
+	return worstTrack(kids.map(programHealth));
+}
+function effectivePortfolioHealth(portfolio, data, now, programHealth) {
+	return portfolio.healthOverride ?? derivePortfolioHealth(portfolio.id, data, now, programHealth);
+}
+/**
+* Re-derive every project, program and portfolio health.
+*
+* Reference-stable: an entity whose health did not change is returned as the
+* same object, and a collection with no changed entity as the same array, so
+* selectors that pick `projects`, `programs` or `portfolios` only re-render
+* when a health really moved.
+*/
+function stampHealth(data, now = clockNow()) {
+	const at = now.toISOString();
+	const projects = restamp(data.projects, (p) => effectiveProjectHealth(p, data, now), at);
+	const mid = projects === data.projects ? data : {
+		...data,
+		projects
+	};
+	const programs = restamp(data.programs, (p) => effectiveProgramHealth(p, mid, now, (project) => project.health), at);
+	const withPrograms = programs === mid.programs ? mid : {
+		...mid,
+		programs
+	};
+	const portfolios = restamp(data.portfolios, (p) => effectivePortfolioHealth(p, withPrograms, now, (program) => program.health), at);
+	if (projects === data.projects && programs === data.programs && portfolios === data.portfolios) return data;
+	return {
+		...data,
+		projects,
+		programs,
+		portfolios
+	};
+}
+/** Every row whose health moved gets the new value and a line of history. */
+function restamp(rows, healthOf, at) {
+	let changed = false;
+	const next = rows.map((row) => {
+		const health = healthOf(row);
+		if (health === row.health) return row;
+		changed = true;
+		return {
+			...row,
+			health,
+			healthHistory: recordHealth(row.healthHistory, health, at, Boolean(row.healthOverride), row.healthOverride ? row.healthNote : null)
+		};
+	});
+	return changed ? next : rows;
+}
+
 //#endregion
 //#region src/tui/views/panels.tsx
 /**
@@ -4250,7 +4506,7 @@ function peopleChoices(people, allowNone) {
 	}, ...list] : list;
 }
 /** Health with its override: picking one asks why (the note shows with it); "worked out" clears it. */
-function healthField(kind, item, go, set, clear) {
+function healthField(kind, item, go, set, clear, finished = false) {
 	const choices = [{
 		label: `Worked out from what's under it`,
 		value: "derived"
@@ -4261,7 +4517,7 @@ function healthField(kind, item, go, set, clear) {
 	}))];
 	return {
 		label: "Health",
-		value: `${HEALTH_LABEL[item.health]}${item.healthOverride ? ` (set by hand: ${item.healthNote || "no note"})` : ""}`,
+		value: `${HEALTH_LABEL[item.health]}${overridesTrack(item) ? ` (set by hand: ${item.healthNote || "no note"})` : item.healthNote && item.healthOverride ? ` (${item.healthNote})` : ""}${finished ? " · every task done, mark it Done?" : ""}`,
 		color: HEALTH_COLOR[item.health],
 		edit: {
 			kind: "pick",
@@ -4270,6 +4526,7 @@ function healthField(kind, item, go, set, clear) {
 			initial: item.healthOverride ? HEALTHS.indexOf(item.healthOverride) + 1 : 0,
 			onPick: (value) => {
 				if (value === "derived") return clear();
+				if (value === "done") return go.ask(`What shipped? (optional, shows with the health)`, (note) => set("done", note.trim()));
 				go.ask(`Why is it ${HEALTH_LABEL[value].toLowerCase()}? (shows with the health)`, (note) => set(value, note.trim()));
 			}
 		}
@@ -4446,6 +4703,7 @@ function PortfolioPanel({ id, width, height, go, active, onClose }) {
 function ProjectPanel({ id, width, height, go, active, onClose }) {
 	const { store, today } = useDeps();
 	const project = useHarbor((s) => s.projects.find((p) => p.id === id));
+	const tasks = useHarbor((s) => s.tasks);
 	const people = useHarbor((s) => s.people);
 	const programs = useHarbor((s) => s.programs);
 	if (!project) return null;
@@ -4460,7 +4718,7 @@ function ProjectPanel({ id, width, height, go, active, onClose }) {
 				onSave: (v) => v.trim() && up({ name: v.trim() })
 			}
 		},
-		healthField("project", project, go, (h, n) => store.getState().setHealthOverride("project", id, h, n), () => store.getState().clearHealthOverride("project", id)),
+		healthField("project", project, go, (h, n) => store.getState().setHealthOverride("project", id, h, n), () => store.getState().clearHealthOverride("project", id), suggestsDone(project, tasks)),
 		{
 			label: "Lead",
 			value: people.find((p) => p.id === project.ownerId)?.name ?? "",
@@ -5248,7 +5506,7 @@ function ProgramView({ programId, active, width, height, go, onBack }) {
 								health: program.health,
 								label: true
 							}),
-							program.healthOverride ? /* @__PURE__ */ jsxs(Text, {
+							overridesTrack(program) ? /* @__PURE__ */ jsxs(Text, {
 								color: theme.muted,
 								children: [
 									" (by hand: ",
@@ -5463,7 +5721,7 @@ function PortfolioView({ portfolioId, active, width, height, go, onBack }) {
 						health: portfolio.health,
 						label: true
 					}),
-					portfolio.healthOverride ? /* @__PURE__ */ jsxs(Text, {
+					overridesTrack(portfolio) ? /* @__PURE__ */ jsxs(Text, {
 						color: theme.muted,
 						children: [
 							" (by hand: ",
@@ -5854,7 +6112,7 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 											color: on ? theme.accent : void 0,
 											wrap: "truncate-end",
 											children: [
-												c.label.toUpperCase(),
+												c.label,
 												" ",
 												/* @__PURE__ */ jsxs(Text, {
 													color: over ? theme.bad : theme.muted,
@@ -6195,15 +6453,15 @@ const REPEAT_LABEL = {
 	biweekly: "Every two weeks",
 	monthly: "Every month"
 };
-const iso$1 = (d) => {
+const iso = (d) => {
 	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 };
 /** The due date one interval after `from`. */
 function nextDueDate(from, repeat) {
 	const d = /* @__PURE__ */ new Date(`${from}T12:00:00`);
-	if (repeat === "weekly") return iso$1(addDays(d, 7));
-	if (repeat === "biweekly") return iso$1(addDays(d, 14));
-	return iso$1(addMonths(d, 1));
+	if (repeat === "weekly") return iso(addDays(d, 7));
+	if (repeat === "biweekly") return iso(addDays(d, 14));
+	return iso(addMonths(d, 1));
 }
 /**
 * The next occurrence of a repeating task once this one is done: same
@@ -7454,244 +7712,6 @@ function App({ ui }) {
 	});
 }
 
-//#endregion
-//#region src/lib/health-history.ts
-/** The history with one more line when `health` differs from the last recorded one. Same array otherwise. */
-function recordHealth(history, health, at, override, note) {
-	const last = history?.[history.length - 1];
-	if (last && last.health === health && last.override === override && (last.note ?? null) === (note ?? null)) return history;
-	return [...history ?? [], {
-		at,
-		health,
-		override,
-		note: note ?? null
-	}].slice(-30);
-}
-
-//#endregion
-//#region src/lib/derived-health.ts
-const iso = (d) => {
-	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
-};
-function parseDate(value) {
-	return parseIso(value.length === 10 ? `${value}T12:00:00` : value);
-}
-function isBlocked(task, tasks) {
-	return blockersIn(task, tasks).some((b) => b.status !== "done");
-}
-/** A project with no tasks yet, or any task still open, hasn't cleared. */
-function projectHasOpenWork(data, projectId) {
-	const tasks = tasksOf(data.tasks, projectId);
-	return tasks.length === 0 || tasks.some((t) => t.status !== "done");
-}
-/** Every project this one waits on that still exists. */
-function projectBlockersOf(data, project) {
-	return blockersIn(project, data.projects);
-}
-/** The blockers with open work left: the ones actually holding it up. */
-function projectOpenBlockers(data, project) {
-	return projectBlockersOf(data, project).filter((b) => projectHasOpenWork(data, b.id));
-}
-function projectIsBlocked(data, project) {
-	return projectOpenBlockers(data, project).length > 0;
-}
-/** A program with no projects yet, or any project still open, hasn't cleared. */
-function programHasOpenWork(data, programId) {
-	const projects = data.projects.filter((p) => p.programId === programId);
-	return projects.length === 0 || projects.some((p) => projectHasOpenWork(data, p.id));
-}
-function programBlockersOf(data, program) {
-	return blockersIn(program, data.programs);
-}
-function programOpenBlockers(data, program) {
-	return programBlockersOf(data, program).filter((b) => programHasOpenWork(data, b.id));
-}
-function programIsBlocked(data, program) {
-	return programOpenBlockers(data, program).length > 0;
-}
-let overdueDay = "";
-const overdueByDue = /* @__PURE__ */ new Map();
-function daysOverdue(dueDate, now) {
-	if (!dueDate) return 0;
-	const today = iso(now);
-	if (today !== overdueDay) {
-		overdueDay = today;
-		overdueByDue.clear();
-	}
-	const hit = overdueByDue.get(dueDate);
-	if (hit !== void 0) return hit;
-	let days = 0;
-	try {
-		const n = differenceInCalendarDays(startOfDay(now), startOfDay(parseDate(dueDate)));
-		days = n > 0 ? n : 0;
-	} catch {
-		days = 0;
-	}
-	overdueByDue.set(dueDate, days);
-	return days;
-}
-let untilDay = "";
-const untilByDate = /* @__PURE__ */ new Map();
-function daysUntil(date, now) {
-	if (!date) return null;
-	const today = iso(now);
-	if (today !== untilDay) {
-		untilDay = today;
-		untilByDate.clear();
-	}
-	const hit = untilByDate.get(date);
-	if (hit !== void 0) return hit;
-	let days;
-	try {
-		days = differenceInCalendarDays(startOfDay(parseDate(date)), startOfDay(now));
-	} catch {
-		days = null;
-	}
-	untilByDate.set(date, days);
-	return days;
-}
-function incomplete(task) {
-	return task.status !== "done";
-}
-function wipLimitOf(status, stored, uncapped) {
-	if (stored != null) return stored;
-	if (uncapped === true) return null;
-	if (status === "doing") return 3;
-	if (status === "review") return 2;
-	return null;
-}
-function wipOverflowing(data, projectId) {
-	const cols = data.boardConfigs?.[projectId]?.columns;
-	if (cols?.length) return cols.some((c) => {
-		if (c.visible === false) return false;
-		const limit = wipLimitOf(c.status, c.wipLimit, c.uncapped);
-		if (limit == null) return false;
-		return tasksOf(data.tasks, projectId).filter((t) => t.status === c.status).length > limit;
-	});
-	const mine = tasksOf(data.tasks, projectId);
-	const doing = mine.filter((t) => t.status === "doing").length;
-	const review = mine.filter((t) => t.status === "review").length;
-	return doing > 3 || review > 2;
-}
-function deriveProjectHealth(project, data, now) {
-	const tasks = tasksOf(data.tasks, project.id);
-	const open = tasks.filter(incomplete);
-	const maxOverdue = open.map((t) => daysOverdue(t.dueDate, now)).reduce((a, b) => Math.max(a, b), 0);
-	const until = daysUntil(project.endDate, now);
-	const unfinished = open.length > 0 || tasks.length === 0 && until != null && until < 0;
-	if (maxOverdue > 3 || until != null && until < 0 && unfinished) return "off-track";
-	const blockers = open.some((t) => isBlocked(t, data.tasks)) || projectIsBlocked(data, project);
-	const wip = wipOverflowing(data, project.id);
-	if (maxOverdue >= 1 || until != null && until >= 0 && until <= 7 && (blockers || wip)) return "at-risk";
-	return "on-track";
-}
-function worstTrack(healths) {
-	if (healths.some((h) => h === "off-track")) return "off-track";
-	if (healths.some((h) => h === "at-risk")) return "at-risk";
-	return "on-track";
-}
-/** The override wins when set; Paused and Done are overrides too, and stay until reset. */
-function effectiveProjectHealth(project, data, now) {
-	return project.healthOverride ?? deriveProjectHealth(project, data, now);
-}
-/** Milestones past their date and still open. */
-function lateMilestonesOf(milestones, now) {
-	const today = iso(now);
-	return milestones.filter((m) => !m.done && m.dueDate < today);
-}
-/**
-* The projects an open milestone waits on that put its date in doubt: one
-* scheduled to end after the milestone is due, or one off track with work
-* still open. Finished projects and a reached milestone carry no risk.
-*/
-function milestoneRisks(milestone, data) {
-	if (milestone.done) return [];
-	return blockersIn(milestone, data.projects).flatMap((project) => {
-		if (!projectHasOpenWork(data, project.id)) return [];
-		if (project.endDate > milestone.dueDate) return [{
-			project,
-			reason: "ends-after"
-		}];
-		if (project.health === "off-track") return [{
-			project,
-			reason: "off-track"
-		}];
-		return [];
-	});
-}
-/**
-* `projectHealth` defaults to working each project out afresh; stampHealth
-* passes the health it has just stamped, so no project is derived twice.
-*/
-function deriveProgramHealth(program, data, now, projectHealth = (p) => effectiveProjectHealth(p, data, now)) {
-	const kids = data.projects.filter((p) => p.programId === program.id);
-	const blocked = programIsBlocked(data, program) ? "at-risk" : "on-track";
-	const ownMilestones = (data.milestones ?? []).filter((m) => m.programId === program.id);
-	const lateMilestone = lateMilestonesOf(ownMilestones, now).length > 0 || ownMilestones.some((m) => milestoneRisks(m, data).length > 0) ? "at-risk" : "on-track";
-	if (kids.length === 0) return worstTrack([blocked, lateMilestone]);
-	return worstTrack([
-		...kids.map(projectHealth),
-		blocked,
-		lateMilestone
-	]);
-}
-function effectiveProgramHealth(program, data, now, projectHealth) {
-	return program.healthOverride ?? deriveProgramHealth(program, data, now, projectHealth);
-}
-/** A paused or done program neither helps nor hurts the portfolio. */
-function derivePortfolioHealth(portfolioId, data, now, programHealth = (p) => effectiveProgramHealth(p, data, now)) {
-	const kids = data.programs.filter((p) => p.portfolioId === portfolioId);
-	if (kids.length === 0) return "on-track";
-	return worstTrack(kids.map(programHealth));
-}
-function effectivePortfolioHealth(portfolio, data, now, programHealth) {
-	return portfolio.healthOverride ?? derivePortfolioHealth(portfolio.id, data, now, programHealth);
-}
-/**
-* Re-derive every project, program and portfolio health.
-*
-* Reference-stable: an entity whose health did not change is returned as the
-* same object, and a collection with no changed entity as the same array, so
-* selectors that pick `projects`, `programs` or `portfolios` only re-render
-* when a health really moved.
-*/
-function stampHealth(data, now = clockNow()) {
-	const at = now.toISOString();
-	const projects = restamp(data.projects, (p) => effectiveProjectHealth(p, data, now), at);
-	const mid = projects === data.projects ? data : {
-		...data,
-		projects
-	};
-	const programs = restamp(data.programs, (p) => effectiveProgramHealth(p, mid, now, (project) => project.health), at);
-	const withPrograms = programs === mid.programs ? mid : {
-		...mid,
-		programs
-	};
-	const portfolios = restamp(data.portfolios, (p) => effectivePortfolioHealth(p, withPrograms, now, (program) => program.health), at);
-	if (projects === data.projects && programs === data.programs && portfolios === data.portfolios) return data;
-	return {
-		...data,
-		projects,
-		programs,
-		portfolios
-	};
-}
-/** Every row whose health moved gets the new value and a line of history. */
-function restamp(rows, healthOf, at) {
-	let changed = false;
-	const next = rows.map((row) => {
-		const health = healthOf(row);
-		if (health === row.health) return row;
-		changed = true;
-		return {
-			...row,
-			health,
-			healthHistory: recordHealth(row.healthHistory, health, at, Boolean(row.healthOverride), row.healthOverride ? row.healthNote : null)
-		};
-	});
-	return changed ? next : rows;
-}
-
 //#endregion
 //#region src/lib/payload.ts
 const NONE = [];
@@ -8392,6 +8412,36 @@ function sampleProject(opts) {
 	};
 }
 
+//#endregion
+//#region src/lib/empty.ts
+/**
+* A name worth offering in the harbor-name field: "Sam's harbor", or "" when
+* nobody is known yet, so the field stays empty and shows its placeholder.
+*/
+function harborNameFor(displayName, email) {
+	const first = (displayName || email || "").split(/[\s@]/)[0]?.trim();
+	return first ? `${first}'s harbor` : "";
+}
+/** What a new harbor is called until its owner names it: "Sam's harbor", else "My harbor". */
+function suggestedHarborName(displayName, email) {
+	return harborNameFor(displayName, email) || "My harbor";
+}
+/** What a new harbor calls its first program until someone names it. */
+const STARTER_PROGRAM = "The work";
+
+//#endregion
+//#region src/lib/first-week.ts
+/**
+* The few things a new harbor needs in its first week, in the order they
+* matter: a real name on the account, a name for the program launch made up,
+* a first project, and someone else aboard. Today lists the ones not done.
+* Someone who joined is asked only for their name.
+*/
+/** The program launch named for you, when nobody has renamed it yet. */
+function starterProgram(data) {
+	return data.programs.find((p) => p.name.trim() === "The work") ?? null;
+}
+
 //#endregion
 //#region src/lib/slices/hierarchy.ts
 /** Portfolios, programs and projects: create, edit, custom fields, automations, health overrides, boards and cascading delete. */
@@ -8409,6 +8459,18 @@ function hierarchySlice({ get, write }) {
 			return id;
 		},
 		addProgram: (p) => {
+			const starter = p.name.trim() === "The work" ? null : starterProgram(get());
+			if (starter) {
+				const row = {
+					...starter,
+					...p,
+					id: starter.id,
+					health: starter.health
+				};
+				write({ programs: get().programs.map((g) => g.id === starter.id ? row : g) });
+				get().log(`opened program ${row.name}`, `/programs/${starter.id}`);
+				return starter.id;
+			}
 			const id = uid("pg");
 			const row = {
 				health: "on-track",
@@ -10373,21 +10435,6 @@ function createUiStore() {
 	}));
 }
 
-//#endregion
-//#region src/lib/empty.ts
-/**
-* A name worth offering in the harbor-name field: "Sam's harbor", or "" when
-* nobody is known yet, so the field stays empty and shows its placeholder.
-*/
-function harborNameFor(displayName, email) {
-	const first = (displayName || email || "").split(/[\s@]/)[0]?.trim();
-	return first ? `${first}'s harbor` : "";
-}
-/** What a new harbor is called until its owner names it: "Sam's harbor", else "My harbor". */
-function suggestedHarborName(displayName, email) {
-	return harborNameFor(displayName, email) || "My harbor";
-}
-
 //#endregion
 //#region src/tui/first-run.ts
 /**

package/lib/cli.mjs

@@ -77,7 +77,7 @@ export const HELP = `harbor: Harbor from the terminal
                        [--ends DATE]
   harbor project "NAME" --program P [--lead me|NAME] [--starts DATE]
                        [--ends DATE] [--budget N]
-  harbor add "TITLE" --project P [--assignee me|NAME] [--due DATE]
+  harbor add "TITLE" --project P [--assignee me|none|NAME] [--due DATE]
                      [--priority low|medium|high|urgent] [--status S]
                      [--over-limit]
   harbor start TASK | review TASK | done TASK [--confirm] [--over-limit]
@@ -490,7 +490,7 @@ export async function run(argv, io = {}) {
     if (!hasFullAccess(creds)) {
       out(
         creds
-          ? "The full-screen app needs full access, as on the website. Signing in again…"
+          ? "This sign-in can only read, and the full-screen app needs full access, as on the website. Signing in again with full access; the commands will have it too (harbor login --read-only goes back to reading only)…"
           : "Signing in first…",
       );
       const code = await run(
@@ -934,11 +934,15 @@ export async function run(argv, io = {}) {
         return 0;
       }
       const as = r.role === "viewer" ? "someone who can view (not change)" : "crew who can edit";
+      const again = r.again
+        ? `${r.email} was already invited; the earlier link has stopped working and this one replaces it.\n`
+        : "";
       out(
         plain(
-          r.sent
-            ? `Invited ${r.email} to ${r.harbor} as ${as}. Harbor emailed them the invite; they join on the website or with harbor login.`
-            : `Made an invite for ${r.email} to ${r.harbor} as ${as}, but Harbor didn't email it (it sends invites once your own email address is confirmed). Send them this link yourself:\n\n  ${r.link}`,
+          again +
+            (r.sent
+              ? `Invited ${r.email} to ${r.harbor} as ${as}. Harbor emailed them the invite; they join on the website or with harbor login.`
+              : `Made an invite for ${r.email} to ${r.harbor} as ${as}, but Harbor didn't email it (it sends invites once your own email address is confirmed). Send them this link yourself:\n\n  ${r.link}`),
         ),
       );
       return 0;
@@ -966,7 +970,7 @@ export async function run(argv, io = {}) {
       }
       out(
         plain(
-          `${values.new ? "A new calendar link" : "Your calendar link"} for ${what}${values.new ? " (the old one has stopped working)" : ""}:\n\n  ${r.url}\n\nAdd it to Google, Apple or Outlook calendar as a calendar from a URL. Anyone with the link can see these dates; harbor calendar --new swaps it for a fresh one.`,
+          `${values.new ? "A new calendar link" : r.fresh ? "A new calendar link (none was on)" : "Your calendar link"} for ${what}${values.new ? " (the old one has stopped working)" : ""}:\n\n  ${r.url}\n\nAdd it to Google, Apple or Outlook calendar as a calendar from a URL. Anyone with the link can see these dates; harbor calendar --new swaps it for a fresh one.`,
         ),
       );
       return 0;
@@ -982,7 +986,8 @@ export async function run(argv, io = {}) {
           harbor,
           project: values.project,
           title: text(positionals, "the task"),
-          assignee: values.assignee,
+          // Yours unless you say otherwise, as with n in the app.
+          assignee: values.assignee ?? "me",
           due: dueDate(values.due),
           priority: values.priority,
           status: values.status,
@@ -1009,6 +1014,9 @@ export async function run(argv, io = {}) {
           [
             `${r.updated.title}: ${{ doing: "started", review: "in review", done: "done" }[status]}.`,
             r.queuedNext ? `Next one: ${taskLine(r.queuedNext, opts)}` : "",
+            r.projectFinished
+              ? `That was the last open task in ${r.projectFinished}. Mark the project Done in the app (harbor) or on the website.`
+              : "",
           ]
             .filter(Boolean)
             .join("\n"),

package/package.json

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