@harborppm/cli 0.52.0 → 0.53.0

package/README.md

@@ -166,6 +166,9 @@ harbor raid "TITLE" [--status S] [--owner me|none|NAME] [--impact 1-5] [--probab
 harbor review [WORDS] [--mine|--owner NAME] [--portfolio P] [--done]
                                             the review: programs worst first, with next moves
                                             (reads only; harbor submit moves a task to In review)
+harbor bridge                               run the review as a meeting: one project a screen,
+                                            what changed since the last one, log decisions,
+                                            actions and risks live, post the summary to chat
 harbor next-move PROGRAM "TEXT"             write a program's next move
 harbor health --program P|--project P|--portfolio P STATE [--note WHY]
                                             set its health by hand (auto hands it back)

package/dist/app.mjs

@@ -3760,7 +3760,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(a, b, stored) {
+function first$1(a, b, stored) {
 	const ka = kept(a, stored);
 	if (ka !== kept(b, stored)) return ka;
 	return made(a, b) <= 0;
@@ -3808,7 +3808,7 @@ function settleKeys(data, stored) {
 			}
 			const other = holder.get(n);
 			if (other) {
-				const [keep, move] = first(other, t, stored) ? [other, t] : [t, other];
+				const [keep, move] = first$1(other, t, stored) ? [other, t] : [t, other];
 				holder.set(n, keep);
 				loose.push(move);
 			} else holder.set(n, t);
@@ -6485,6 +6485,493 @@ function BriefView({ active, width, height, go }) {
 	});
 }
 
+//#endregion
+//#region src/lib/bridge.ts
+init_date_fns();
+init_indexes();
+init_raid();
+init_swatches();
+init_task_keys();
+init_format();
+/** 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. */
+function bridgeSince(program, now) {
+	if (program.reviewedAt && !Number.isNaN(Date.parse(program.reviewedAt))) return program.reviewedAt;
+	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;
+/** "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;
+	return `${key ? `${key} ` : ""}${t.title}${who ? ` (${who})` : ""}`;
+}
+function listed(prefix, items) {
+	const shown = items.slice(0, 4);
+	const rest = items.length - shown.length;
+	return {
+		text: `${prefix}${shown.join("; ")}${rest > 0 ? `; and ${rest} more` : ""}`,
+		more: rest
+	};
+}
+const highRated = (r) => r.kind !== "decision" && isActive(r) && (r.severity === "high" || (r.impact ?? 0) >= 4);
+/** What changed on one project since `since`: health, work finished, late or added, the register, the hill. */
+function projectChanges(doc, project, since, now) {
+	const out = [];
+	const today = todayISO(now);
+	const sinceDay = since.slice(0, 10);
+	const history = project.healthHistory ?? [];
+	const moves = history.filter((h) => after(h.at, since));
+	if (moves.length > 0) {
+		const before = history[history.length - moves.length - 1]?.health ?? null;
+		const last = moves[moves.length - 1];
+		const note = last.note?.trim() ? ` “${last.note.trim()}”` : "";
+		const word = (h) => HEALTH_LABEL$1[h] ?? h;
+		out.push({
+			kind: "health",
+			text: before && before !== last.health ? `Went from ${word(before)} to ${word(last.health)}${note}` : `Now ${word(last.health)}${note}`,
+			more: 0
+		});
+	}
+	const tasks = tasksOf(doc.tasks, project.id);
+	const finished = tasks.filter((t) => t.status === "done" && after(t.completedAt, since)).sort((a, b) => (b.completedAt ?? "").localeCompare(a.completedAt ?? ""));
+	if (finished.length) out.push({
+		kind: "finished",
+		...listed("Finished: ", finished.map((t) => taskLine$1(t, project, doc)))
+	});
+	const late = tasks.filter((t) => t.status !== "done" && t.dueDate && t.dueDate >= sinceDay && t.dueDate < today).sort((a, b) => (a.dueDate ?? "").localeCompare(b.dueDate ?? ""));
+	if (late.length) out.push({
+		kind: "late",
+		...listed("Now late: ", late.map((t) => taskLine$1(t, project, doc)))
+	});
+	const added = tasks.filter((t) => after(t.createdAt, since) && !finished.includes(t));
+	if (added.length) out.push({
+		kind: "added",
+		...listed("Added: ", added.map((t) => taskLine$1(t, project, doc)))
+	});
+	const register = doc.raidItems.filter((r) => r.projectId === project.id);
+	const decisions = register.filter((r) => r.kind === "decision" && after(r.updatedAt, since));
+	const decided = decisions.filter((r) => r.status === "decided");
+	if (decided.length) out.push({
+		kind: "decided",
+		...listed("Decided: ", decided.map((r) => r.title))
+	});
+	const proposed = decisions.filter((r) => r.status === "proposed");
+	if (proposed.length) out.push({
+		kind: "decided",
+		...listed("To decide: ", proposed.map((r) => r.title))
+	});
+	const raised = register.filter((r) => r.kind !== "decision" && after(r.createdAt, since));
+	if (raised.length) out.push({
+		kind: "raised",
+		...listed("Raised: ", raised.map((r) => `${r.kind === "issue" ? "issue" : "risk"} ${r.title}`))
+	});
+	const updated = register.filter((r) => r.kind !== "decision" && !raised.includes(r) && after(r.updatedAt, since));
+	if (updated.length) out.push({
+		kind: "updated",
+		...listed("Updated: ", updated.map((r) => r.title))
+	});
+	if (after(project.hillMovedAt, since) && typeof project.hillAt === "number") out.push({
+		kind: "hill",
+		text: project.hillAt < 50 ? "Moved on the hill, still figuring it out" : "Moved on the hill, getting it done",
+		more: 0
+	});
+	return out;
+}
+/**
+* The meeting's slides: the open projects of the given programs (in the
+* review's order), each with what changed. Projects where nothing moved
+* come back as `quiet`, named on the summary rather than given a screen.
+*/
+function bridgeSlides(doc, programs, now) {
+	const today = todayISO(now);
+	const slides = [];
+	const quiet = [];
+	const rank = {
+		"off-track": 0,
+		"at-risk": 1,
+		"on-track": 2,
+		paused: 3,
+		done: 4
+	};
+	for (const program of programs) {
+		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));
+		for (const project of projects) {
+			const changes = projectChanges(doc, project, since, now);
+			if (changes.length === 0) {
+				quiet.push({
+					program,
+					project
+				});
+				continue;
+			}
+			const tasks = tasksOf(doc.tasks, project.id);
+			slides.push({
+				program,
+				project,
+				since,
+				changes,
+				late: tasks.filter((t) => t.status !== "done" && !!t.dueDate && t.dueDate < today).length,
+				open: tasks.filter((t) => t.status !== "done").length,
+				highRisks: doc.raidItems.filter((r) => r.projectId === project.id && highRated(r)).length,
+				milestone
+			});
+		}
+	}
+	return {
+		slides,
+		quiet
+	};
+}
+/**
+* The end summary, one part per program: projects covered and what was
+* logged on each, read back from the document (so an edit made since shows,
+* and an item since deleted drops out).
+*/
+function meetingSummary(doc, slides, logged) {
+	const projects = byId(doc.projects);
+	const people = byId(doc.people);
+	const tasks = byId(doc.tasks);
+	const raid = byId(doc.raidItems);
+	const parts = /* @__PURE__ */ new Map();
+	const partOf = (program) => {
+		let part = parts.get(program.id);
+		if (!part) {
+			part = {
+				program,
+				covered: [],
+				lines: []
+			};
+			parts.set(program.id, part);
+		}
+		return part;
+	};
+	for (const s of slides) partOf(s.program).covered.push(s.project);
+	for (const item of logged) {
+		if (item.kind === "action") {
+			const t = tasks.get(item.id);
+			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 key = taskKey(t, project);
+			partOf(program).lines.push({
+				kind: "action",
+				text: `${key ? `${key} ` : ""}${t.title}${who ? `, ${who}` : ""}${t.dueDate ? `, due ${t.dueDate}` : ""}`
+			});
+			continue;
+		}
+		const r = raid.get(item.id);
+		const project = r?.projectId ? projects.get(r.projectId) : void 0;
+		const program = project ? doc.programs.find((p) => p.id === project.programId) : void 0;
+		if (!r || !program) continue;
+		const said = r.kind === "decision" && r.resolution?.trim() ? `: ${r.resolution.trim()}` : "";
+		partOf(program).lines.push({
+			kind: item.kind,
+			text: `${r.title}${said}`
+		});
+	}
+	return [...parts.values()];
+}
+const LABEL = {
+	decision: "Decided",
+	action: "Action",
+	risk: "Risk"
+};
+/** One program's part as the post for its chat channel: plain lines, capped well under every service's limit. */
+function summaryText(part, minutes) {
+	const names = part.covered.map((p) => p.name);
+	const head = `Review of ${part.program.name}: ${names.length} project${names.length === 1 ? "" : "s"} covered${minutes > 0 ? ` in ${minutes} min` : ""}${names.length ? ` (${names.join(", ")})` : ""}.`;
+	const lines = part.lines.map((l) => `${LABEL[l.kind]}: ${l.text}`);
+	return `${head}\n${lines.length ? lines.join("\n") : "Nothing new logged."}`.slice(0, 2e3);
+}
+/** The ids of programs whose projects the meeting covered, to stamp `reviewedAt` on. */
+function reviewedPrograms(slides, quiet) {
+	return [.../* @__PURE__ */ new Set([...slides.map((s) => s.program.id), ...quiet.map((q) => q.program.id)])];
+}
+
+//#endregion
+//#region src/tui/views/bridge.tsx
+init_date_fns();
+init_date_text();
+const WORD = {
+	decision: "Decided",
+	action: "Action",
+	risk: "Risk"
+};
+/**
+* Bridge mode, as on the website's review: the meeting one project at a
+* time with only what changed since the program was last reviewed (←→ or
+* j k), d a decision, a an action, r a risk, m the program's next move, e
+* ends it. The summary lists what was logged; p posts it to each program's
+* chat channel where one is set, y copies it.
+*/
+function BridgeView({ active, width, height, go, programIds, onBack }) {
+	const { store, transport, today } = useDeps();
+	const workspaceId = useHarbor((s) => s.workspaceId);
+	const viewOnly = useHarbor((s) => s.myRole === "viewer" || s.keepPaused);
+	const programs = useHarbor((s) => s.programs);
+	const projects = useHarbor((s) => s.projects);
+	const tasks = useHarbor((s) => s.tasks);
+	const raidItems = useHarbor((s) => s.raidItems);
+	const people = useHarbor((s) => s.people);
+	const milestones = useHarbor((s) => s.milestones);
+	const me = useHarbor((s) => s.currentUserId);
+	const { stdout } = useStdout();
+	const data = useMemo(() => ({
+		programs,
+		projects,
+		tasks,
+		raidItems,
+		people,
+		milestones
+	}), [
+		programs,
+		projects,
+		tasks,
+		raidItems,
+		people,
+		milestones
+	]);
+	const [started] = useState(() => /* @__PURE__ */ new Date());
+	const [{ slides, quiet }] = useState(() => {
+		const picked = programIds.map((id) => store.getState().programs.find((p) => p.id === id)).filter((p) => p !== void 0);
+		return bridgeSlides(store.getState(), picked, started);
+	});
+	const [index, setIndex] = useState(0);
+	const [logged, setLogged] = useState([]);
+	const [ended, setEnded] = useState(slides.length === 0 ? started : null);
+	const [channels, setChannels] = useState({});
+	const parts = useMemo(() => meetingSummary(data, slides, logged), [
+		data,
+		slides,
+		logged
+	]);
+	const minutes = ended ? Math.round((ended.getTime() - started.getTime()) / 6e4) : 0;
+	useEffect(() => {
+		if (!ended || !transport.meetingPost || viewOnly || !workspaceId) return;
+		let live = true;
+		for (const part of parts) transport.meetingPost(workspaceId, part.program.id).then((a) => {
+			if (live && a.set && a.service) setChannels((c) => ({
+				...c,
+				[part.program.id]: a.service
+			}));
+		}).catch(() => {});
+		return () => {
+			live = false;
+		};
+	}, [ended]);
+	const end = () => {
+		const at = /* @__PURE__ */ new Date();
+		setEnded(at);
+		if (!viewOnly) store.getState().markReviewed(reviewedPrograms(slides, quiet), at.toISOString());
+	};
+	const slide = slides[index];
+	const program = slide ? programs.find((p) => p.id === slide.program.id) ?? slide.program : null;
+	const add = (kind, id) => setLogged((l) => [...l, {
+		kind,
+		id
+	}]);
+	const logDecision = () => {
+		if (!slide) return;
+		go.ask(`Decision on ${slide.project.name}: what was it about?`, (title) => {
+			if (!title.trim()) return;
+			go.ask("What was decided? (Enter to skip)", (said) => {
+				add("decision", store.getState().addRaidItem({
+					kind: "decision",
+					title: title.trim(),
+					projectId: slide.project.id,
+					ownerId: me,
+					status: "decided",
+					resolution: said.trim(),
+					decidedById: me,
+					decidedAt: today()
+				}));
+				go.notify("Decision logged.");
+			});
+		});
+	};
+	const logAction = () => {
+		if (!slide) return;
+		go.ask(`Action on ${slide.project.name}: what needs doing?`, (title) => {
+			if (!title.trim()) return;
+			const lead = people.find((p) => p.id === slide.project.ownerId);
+			go.pick("Who takes it?", [
+				...lead ? [{
+					label: lead.name,
+					value: lead.id,
+					hint: "leads it"
+				}] : [],
+				...people.filter((p) => p.id !== lead?.id && p.kind !== "agent").map((p) => ({
+					label: p.name,
+					value: p.id,
+					hint: p.role
+				})),
+				{
+					label: "Nobody yet",
+					value: null
+				}
+			], (who) => {
+				const due = addDays(/* @__PURE__ */ new Date(`${today()}T12:00:00`), 7).toISOString().slice(0, 10);
+				add("action", store.getState().addTask({
+					projectId: slide.project.id,
+					title: title.trim(),
+					description: "",
+					status: "todo",
+					priority: "medium",
+					assigneeId: who ?? null,
+					dueDate: due
+				}, { allowOverCap: true }));
+				go.notify(`Action added, due ${shortDay(due, today())}.`);
+			});
+		});
+	};
+	const logRisk = () => {
+		if (!slide) return;
+		go.ask(`Risk on ${slide.project.name}: what could go wrong?`, (title) => {
+			if (!title.trim()) return;
+			add("risk", store.getState().addRaidItem({
+				kind: "risk",
+				title: title.trim(),
+				projectId: slide.project.id,
+				ownerId: slide.project.ownerId || null,
+				status: "open"
+			}));
+			go.notify("Risk raised.");
+		});
+	};
+	const post = async () => {
+		const targets = parts.filter((p) => channels[p.program.id]);
+		if (!transport.meetingPost || !workspaceId || targets.length === 0) return go.notify("None of these programs has a chat channel. Set one on the website's program page.");
+		let ok = 0;
+		for (const part of targets) if ((await transport.meetingPost(workspaceId, part.program.id, summaryText(part, minutes)).catch((e) => {
+			go.notify(`Didn't post: ${e.message}`);
+			return null;
+		}))?.posted) ok++;
+		if (ok) go.notify(`Posted to ${ok} channel${ok === 1 ? "" : "s"}.`);
+	};
+	useInput((input, key) => {
+		if (ended) {
+			if (key.escape) return onBack();
+			if (input === "y") {
+				stdout.write(copySequence(parts.map((p) => summaryText(p, minutes)).join("\n\n")));
+				return go.notify("Copied the summary, if this terminal lets apps copy.");
+			}
+			if (input === "p" && !viewOnly) return void post();
+			return;
+		}
+		if (key.escape || input === "e") return end();
+		if (key.rightArrow || input === "j" || input === " ") return setIndex((i) => Math.min(slides.length - 1, i + 1));
+		if (key.leftArrow || input === "k") return setIndex((i) => Math.max(0, i - 1));
+		if (viewOnly) return;
+		if (input === "d") return logDecision();
+		if (input === "a") return logAction();
+		if (input === "r") return logRisk();
+		if (input === "m" && program) return go.ask(`Next move for ${program.name}`, (text) => store.getState().setNextMove(program.id, text.trim()), program.nextMove ?? "");
+	}, { isActive: active });
+	const w = width - 2;
+	if (ended) {
+		const text = [
+			parts.length ? `${parts.reduce((n, p) => n + p.covered.length, 0)} projects covered${minutes ? ` in ${minutes} min` : ""}. The next meeting shows what changes from here.` : "Nothing changed since the last review.",
+			...parts.flatMap((part) => [
+				"",
+				`${part.program.name}${channels[part.program.id] ? ` · ${channels[part.program.id]} channel` : ""}`,
+				`Covered: ${part.covered.map((p) => p.name).join(", ") || "none"}`,
+				...part.lines.length ? part.lines.map((l) => `• ${WORD[l.kind]}: ${l.text}`) : ["Nothing new logged."]
+			]),
+			...quiet.length ? ["", `No change on ${quiet.map((q) => q.project.name).join(", ")}.`] : []
+		].join("\n");
+		const lines = wrapLines(text, w).slice(0, Math.max(1, height - 2));
+		return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			paddingX: 1,
+			width,
+			children: [/* @__PURE__ */ jsx(Heading, {
+				right: `${Object.keys(channels).length && !viewOnly ? "p post · " : ""}y copy · Esc back`,
+				children: "Meeting summary"
+			}), lines.map((line, i) => /* @__PURE__ */ jsx(Text, {
+				wrap: "truncate-end",
+				children: line || " "
+			}, i))]
+		});
+	}
+	if (!slide || !program) return null;
+	const owner = people.find((p) => p.id === slide.project.ownerId);
+	const here = meetingSummary(data, [], logged.filter((l) => l.kind === "action" ? tasks.some((t) => t.id === l.id && t.projectId === slide.project.id) : raidItems.some((r) => r.id === l.id && r.projectId === slide.project.id))).flatMap((p) => p.lines);
+	const text = [
+		[
+			HEALTH_LABEL[slide.project.health],
+			owner?.name,
+			`ends ${shortDay(slide.project.endDate, today())}`,
+			`${slide.late} late of ${slide.open} open`,
+			slide.highRisks ? `${slide.highRisks} high risk${slide.highRisks === 1 ? "" : "s"}` : null
+		].filter(Boolean).join(" · "),
+		slide.milestone ? `Next milestone: ${slide.milestone.name}, ${shortDay(slide.milestone.dueDate, today())}` : "",
+		"",
+		`Since ${program.reviewedAt ? "the last review" : "last week"}, ${timeAgo(new Date(slide.since), started)}:`,
+		...slide.changes.map((c) => `• ${c.text}`),
+		...here.length ? [
+			"",
+			"Logged in this meeting:",
+			...here.map((l) => `• ${WORD[l.kind]}: ${l.text}`)
+		] : [],
+		"",
+		`Next move: ${program.nextMove?.trim() || "none yet"}`
+	].filter((l, i, all) => l !== "" || all[i - 1] !== "").join("\n");
+	const lines = wrapLines(text, w).slice(0, Math.max(1, height - 3));
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		paddingX: 1,
+		width,
+		children: [
+			/* @__PURE__ */ jsxs(Heading, {
+				right: `${index + 1} of ${slides.length} · ${program.name}`,
+				children: [/* @__PURE__ */ jsx(Text, {
+					color: theme.accent,
+					children: "Meeting ▸ "
+				}), slide.project.name]
+			}),
+			lines.map((line, i) => /* @__PURE__ */ jsx(Text, {
+				wrap: "truncate-end",
+				children: line || " "
+			}, i)),
+			/* @__PURE__ */ jsxs(Text, {
+				color: theme.muted,
+				wrap: "truncate-end",
+				children: [
+					"←→ projects",
+					viewOnly ? "" : " · d decision · a action · r risk · m next move",
+					" · e end"
+				]
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/lib/review.ts
+init_indexes();
+init_derived_health();
+/** A program is someone's when they lead it, lead one of its projects or hold a task in one. */
+function programTouches(program, data, personId) {
+	if (program.ownerId === personId) return true;
+	return data.projects.some((p) => p.programId === program.id && (p.ownerId === personId || tasksOf(data.tasks, p.id).some((t) => t.assigneeId === personId)));
+}
+/**
+* The review's programs: worst health first, then soonest end, narrowed to
+* one person's and one portfolio's when asked. Done ones are left in; the
+* website, the terminal and the agents' tool each tuck them away themselves.
+*/
+function reviewPrograms(data, opts = {}) {
+	const { ownerId, portfolioId } = opts;
+	return data.programs.filter((p) => (!portfolioId || p.portfolioId === portfolioId) && (!ownerId || programTouches(p, data, ownerId))).sort((a, b) => rankHealth(a.health) - rankHealth(b.health) || a.endDate.localeCompare(b.endDate));
+}
+
 //#endregion
 //#region src/tui/moves.ts
 init_board();
@@ -7747,26 +8234,6 @@ var init_load = __esmMin((() => {
 	};
 }));
 
-//#endregion
-//#region src/lib/review.ts
-init_load();
-init_indexes();
-init_derived_health();
-/** A program is someone's when they lead it, lead one of its projects or hold a task in one. */
-function programTouches(program, data, personId) {
-	if (program.ownerId === personId) return true;
-	return data.projects.some((p) => p.programId === program.id && (p.ownerId === personId || tasksOf(data.tasks, p.id).some((t) => t.assigneeId === personId)));
-}
-/**
-* The review's programs: worst health first, then soonest end, narrowed to
-* one person's and one portfolio's when asked. Done ones are left in; the
-* website, the terminal and the agents' tool each tuck them away themselves.
-*/
-function reviewPrograms(data, opts = {}) {
-	const { ownerId, portfolioId } = opts;
-	return data.programs.filter((p) => (!portfolioId || p.portfolioId === portfolioId) && (!ownerId || programTouches(p, data, ownerId))).sort((a, b) => rankHealth(a.health) - rankHealth(b.health) || a.endDate.localeCompare(b.endDate));
-}
-
 //#endregion
 //#region src/lib/priority.ts
 /** Rules with anything missing or out of range brought back to the defaults. */
@@ -7804,6 +8271,7 @@ var init_priority = __esmMin((() => {
 
 //#endregion
 //#region src/tui/views/heat.tsx
+init_load();
 init_priority();
 init_raid();
 const CELL = 7;
@@ -9242,7 +9710,7 @@ function ProgramsView({ active, width, height, go }) {
 	const where = portfolio ? ` in ${portfolios.find((p) => p.id === portfolio)?.name ?? "a portfolio"}` : "";
 	return /* @__PURE__ */ jsx(RowList, {
 		title: `${whose}${where}`,
-		right: `${count(listed.length, "program")}${done ? ` · ${done} done ${showDone ? "shown" : "hidden"} (D)` : ""} · m next move · h health · o p narrow`,
+		right: `${count(listed.length, "program")}${done ? ` · ${done} done ${showDone ? "shown" : "hidden"} (D)` : ""} · b run the meeting · m next move · h health · o p narrow`,
 		rows,
 		empty: done ? "Every program here is done. D shows them." : owner || portfolio ? "Nothing here. o and p change what's shown." : "No programs yet. n adds one.",
 		active,
@@ -9255,6 +9723,7 @@ function ProgramsView({ active, width, height, go }) {
 				go.create("program", portfolioId ? { portfolioId } : {});
 			},
 			e: (r) => r && go.openPanel("program", r.id),
+			b: () => split.open.length ? go.openBridge(split.open.map((p) => p.id)) : go.notify("No open programs here to review."),
 			m: (r) => {
 				const program = r && programs.find((p) => p.id === r.id);
 				if (!program) return;
@@ -12858,6 +13327,8 @@ const NAV = [
 const navKey = (i) => i < 10 ? String((i + 1) % 10) : "C";
 /** 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. */
+const openReviewIds = (data) => reviewPrograms(data).filter((p) => p.health !== "done").map((p) => p.id);
 /** What the corner says about saving, and in which of the theme's colours. */
 const SAVE_LABEL = {
 	saved: ["● saved", "good"],
@@ -12866,7 +13337,7 @@ const SAVE_LABEL = {
 	retrying: ["● not saved, retrying", "bad"],
 	offline: ["● offline, will save", "bad"]
 };
-function App({ ui }) {
+function App({ ui, startIn }) {
 	const { store, sync, account, harbors, today, remember } = useDeps();
 	const { exit } = useApp();
 	const { columns, rows } = useWindowSize();
@@ -12879,7 +13350,11 @@ function App({ ui }) {
 	const save = useStore(ui, (s) => s.save);
 	const notice = useStore(ui, (s) => s.notice);
 	const [screen, setScreen] = useState("today");
-	const [stack, setStack] = useState([]);
+	const [stack, setStack] = useState(() => startIn === "bridge" ? [{
+		kind: "bridge",
+		id: "bridge-start",
+		programIds: openReviewIds(store.getState())
+	}] : []);
 	const [panel, setPanel] = useState(null);
 	const [overlay, setOverlay] = useState(null);
 	const [focus, setFocus] = useState("main");
@@ -12916,6 +13391,11 @@ function App({ ui }) {
 			kind: "portfolio",
 			id
 		}),
+		openBridge: (programIds) => push({
+			kind: "bridge",
+			id: `bridge-${Date.now()}`,
+			programIds
+		}),
 		openPanel: (kind, id) => {
 			setPanel({
 				kind,
@@ -13009,6 +13489,11 @@ function App({ ui }) {
 			hint: "make",
 			run: () => go.create("raid")
 		},
+		{
+			label: "Run the review meeting",
+			hint: "bridge",
+			run: () => go.openBridge(openReviewIds(store.getState()))
+		},
 		{
 			label: "Find a task",
 			hint: "/",
@@ -13045,7 +13530,7 @@ function App({ ui }) {
 		if (input === "?") return setOverlay({ kind: "help" });
 		if (input === "H") return setOverlay({ kind: "harbors" });
 		if (input === "C") return goScreen("crew");
-		if (input === "r") {
+		if (input === "r" && page?.kind !== "bridge") {
 			sync.retryNow();
 			return notify("Saving now.");
 		}
@@ -13178,7 +13663,7 @@ function App({ ui }) {
 					close();
 					then(text);
 				}
-			})
+			}, `${label}\u0000${initial ?? ""}`)
 		});
 	} else if (overlay?.kind === "read") overlayNode = /* @__PURE__ */ jsx(Letter, {
 		title: overlay.title,
@@ -13248,7 +13733,12 @@ function App({ ui }) {
 		id: panel.id,
 		...panelProps
 	});
-	const hints = panel ? [["Esc", "back"], ["u", "undo"]] : page?.kind === "project" ? [
+	const hints = panel ? [["Esc", "back"], ["u", "undo"]] : page?.kind === "bridge" ? [
+		["←→", "projects"],
+		["d a r", "log"],
+		["e", "end"],
+		["Esc", "end/back"]
+	] : page?.kind === "project" ? [
 		["←→↑↓", "move"],
 		["Enter", "open"],
 		["n", "new"],
@@ -13279,7 +13769,12 @@ function App({ ui }) {
 		["q", "quit"]
 	];
 	let screenNode;
-	if (page?.kind === "project") screenNode = /* @__PURE__ */ jsx(ProjectView, {
+	if (page?.kind === "bridge") screenNode = /* @__PURE__ */ jsx(BridgeView, {
+		...viewProps,
+		programIds: page.programIds,
+		onBack: back
+	}, page.id);
+	else if (page?.kind === "project") screenNode = /* @__PURE__ */ jsx(ProjectView, {
 		...viewProps,
 		projectId: page.id,
 		onBack: back
@@ -14405,6 +14900,15 @@ function hierarchySlice({ get, write }) {
 				nextMove: text
 			} : p) });
 		},
+		markReviewed: (programIds, at) => {
+			const ids = new Set(programIds);
+			if (ids.size === 0) return;
+			const when = at ?? stamp();
+			write({ programs: get().programs.map((p) => ids.has(p.id) ? {
+				...p,
+				reviewedAt: when
+			} : p) });
+		},
 		setHealthOverride: (kind, id, health, note) => {
 			const at = stamp();
 			const body = {
@@ -16486,7 +16990,8 @@ function plainTransport(t) {
 		history: async (query) => plainDeep(await t.history(query)),
 		create: async (name) => plainDeep(await t.create(name)),
 		crew: async (workspaceId, act) => plainDeep(await t.crew(workspaceId, act)),
-		invite: async (workspaceId, email, role) => plainDeep(await t.invite(workspaceId, email, role))
+		invite: async (workspaceId, email, role) => plainDeep(await t.invite(workspaceId, email, role)),
+		...t.meetingPost ? { meetingPost: async (workspaceId, programId, text) => plainDeep(await t.meetingPost(workspaceId, programId, text)) } : {}
 	};
 }
 function httpTransport(source, fetcher = fetch) {
@@ -16550,6 +17055,12 @@ function httpTransport(source, fetcher = fetch) {
 			harbor: workspaceId,
 			email,
 			role
+		}),
+		meetingPost: (workspaceId, programId, text) => post({
+			op: "meeting-post",
+			workspaceId,
+			programId,
+			...text ? { text } : {}
 		})
 	};
 }
@@ -17274,6 +17785,7 @@ function memoryHarbor(start, opts) {
 		id,
 		name
 	});
+	const posts = [];
 	return {
 		transport: {
 			crew: opts.noCrew ? async () => Promise.reject(new TransportError(opts.noCrew, 404)) : crew.crew,
@@ -17317,6 +17829,23 @@ function memoryHarbor(start, opts) {
 				};
 				return save(sent);
 			},
+			async meetingPost(_id, programId, text) {
+				unreachable();
+				const service = opts.channels?.[programId] ?? null;
+				if (!text) return {
+					set: Boolean(service),
+					service
+				};
+				if (service) posts.push({
+					programId,
+					text
+				});
+				return {
+					set: Boolean(service),
+					service,
+					posted: Boolean(service)
+				};
+			},
 			async create(made) {
 				return { harbor: {
 					id,
@@ -17360,6 +17889,8 @@ function memoryHarbor(start, opts) {
 			}
 		},
 		now,
+		/** What was posted to the pretend chat channels, oldest first. */
+		posts,
 		/** How many versions this harbor has been through. */
 		get versions() {
 			return versions.length;
@@ -26047,7 +26578,10 @@ async function startApp(deps, options = {}) {
 			remember: deps.remember,
 			browse: deps.browse
 		},
-		children: /* @__PURE__ */ jsx(App, { ui })
+		children: /* @__PURE__ */ jsx(App, {
+			ui,
+			startIn: deps.startIn
+		})
 	}));
 	return {
 		instance,
@@ -26125,7 +26659,8 @@ async function runApp(opts) {
 		theme,
 		firstRun,
 		remember: opts.remember,
-		browse: opts.browse
+		browse: opts.browse,
+		startIn: opts.startIn
 	}, { alternateScreen: true });
 	await instance.waitUntilExit();
 }

package/lib/cli.mjs

@@ -161,6 +161,10 @@ export const HELP = `harbor: Harbor from the terminal
                                               the review: programs worst first,
                                               each with its next move (reads
                                               only; harbor submit moves a task)
+  harbor bridge [--harbor H]                  run the review as a meeting: one
+                                              project a screen, what changed
+                                              since the last one, decisions,
+                                              actions and risks logged live
   harbor next-move PROGRAM "TEXT"             write a program's next move
   harbor health --program P|--project P|--portfolio P STATE [--note WHY]
                                               set its health by hand, or auto
@@ -767,6 +771,20 @@ const DETAIL = {
     "  enough of it to pick one out; harbor risks lists them. Changes several",
     "  at once, as one change.",
   ],
+  bridge: [
+    "  harbor bridge                          opens the full-screen app on the",
+    "                                         review meeting (b on the Programs",
+    "                                         screen, or : Run the review meeting)",
+    "",
+    "  One open project a screen, with only what changed since its program was",
+    "  last reviewed (a week back the first time): health moves, work finished,",
+    "  newly late or added, risks raised, decisions made. ←→ move between",
+    "  projects; d logs a decision, a an action (who takes it, due in a week),",
+    "  r a risk, m the program's next move; e ends it. The summary lists what",
+    "  was logged; p posts it to each program's chat channel where one is set",
+    "  (Ship to shore, set on the website), y copies it. The next meeting",
+    "  counts from when this one ended.",
+  ],
   review: [
     "  harbor review                          reads the review: every program,",
     "                                         worst health first, then soonest end,",
@@ -990,7 +1008,7 @@ export async function run(argv, io = {}) {
   }
 
   // On its own in a terminal: the full-screen app. Piped or scripted: the help.
-  if (!command || command === "app") {
+  if (!command || command === "app" || command === "bridge") {
     const terminal = io.terminal ?? Boolean(process.stdout.isTTY && process.stdin.isTTY);
     if (!command && !terminal) {
       out(HELP);
@@ -999,7 +1017,7 @@ export async function run(argv, io = {}) {
     if (!terminal) throw new HarborError("The full-screen app needs a terminal.");
     const { values } = parseArgs(rest, { flags: [], options: ["harbor", "server"] });
     // In a folder with a local plan (harbor init --local), the app opens on it.
-    if (!values.harbor && !values.server) {
+    if (!values.harbor && !values.server && command !== "bridge") {
       const bundled = await loadApp();
       const dir = await bundled.localPlanAt(io.cwd ?? process.cwd());
       if (dir) {
@@ -1056,6 +1074,7 @@ export async function run(argv, io = {}) {
       },
       theme: (await readSettings(env)).theme,
       browse: io.browse ?? openBrowser,
+      ...(command === "bridge" ? { startIn: "bridge" } : {}),
     });
     return 0;
   }

package/package.json

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