@harborppm/cli 0.91.0 → 0.93.0

package/README.md

@@ -213,6 +213,7 @@ harbor import FILE [--project P] [--portfolio P] [--no-people]
                                             add tasks from a CSV file
 harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
 harbor voyage PROJECT ["YOUR LINE"]
+harbor messages PROJECT ["TEXT"] [--limit N]
 harbor note PROJECT ["NOTE"] [--opens DATE|--milestone NAME|--off-track]
 harbor sound TASK [--answer DAYS|--ask NAMES|--settle DAYS] [--why TEXT]
 harbor soundings [PROJECT]
@@ -258,7 +259,7 @@ A task has one owner (`--assignee`), who answers for it and whose load it counts
 
 `harbor limit RR` prints how many tasks each of a board's columns takes at once; `harbor limit RR doing 8` changes one (1 to 20, or `none` for no limit), if you own the harbor. `harbor projects --json` carries each board's `limits` too.
 
-`harbor premortem` runs a pre-mortem with your crew: `--start` asks everyone "it's after the end date and this project failed: what happened?", each person adds answers alone for five minutes, and then the answers show together on the project's Risks & issues tab, where each becomes a risk in one click. On its own it prints the question and the answers you can see. Once a project is Done, `harbor voyage` prints its voyage log (planned against actual dates, the biggest slips, the risks that came true, who closed the most, and the crew's lines) and adds yours. `harbor note` leaves a note for later on a project: it stays sealed (the crew sees only that it's there and who left it) until its day, until one of the program's milestones is reached, or until the project turns Off track, and then it opens at the top of the project and in the brief. `harbor sound TASK --ask crew` takes a sounding: it asks you, the task's owner and whoever has open work on its project how many working days the task will take (`--ask "Sam,Priya"` picks who). Each person answers alone with `harbor sound TASK --answer 4 --why "…"`, and nobody sees the others' numbers until everyone has; then `harbor sound TASK` shows the spread, an estimate when the guesses are close, or "talk about this first" when they're far apart, and `--settle DAYS` records what you agreed. `harbor soundings` lists them, the ones waiting on your answer first. `harbor goals` lists each portfolio's goals (set on the portfolio's page on the website), off track first, with each key result's progress. `harbor ashore` lists the public holidays and time away in the next eight weeks; `--country US,GB` sets whose holidays the harbor takes and `--person NAME --country DE` one person's own, which the forecast and the weekly load then count as days off.
+`harbor premortem` runs a pre-mortem with your crew: `--start` asks everyone "it's after the end date and this project failed: what happened?", each person adds answers alone for five minutes, and then the answers show together on the project's Risks & issues tab, where each becomes a risk in one click. On its own it prints the question and the answers you can see. Once a project is Done, `harbor voyage` prints its voyage log (planned against actual dates, the biggest slips, the risks that came true, who closed the most, and the crew's lines) and adds yours. `harbor messages PROJECT` reads a project's Messages tab, one conversation for the whole project, and `harbor messages PROJECT "TEXT"` writes to it; `@Name` sends it to that person's Inbox. `harbor note` leaves a note for later on a project: it stays sealed (the crew sees only that it's there and who left it) until its day, until one of the program's milestones is reached, or until the project turns Off track, and then it opens at the top of the project and in the brief. `harbor sound TASK --ask crew` takes a sounding: it asks you, the task's owner and whoever has open work on its project how many working days the task will take (`--ask "Sam,Priya"` picks who). Each person answers alone with `harbor sound TASK --answer 4 --why "…"`, and nobody sees the others' numbers until everyone has; then `harbor sound TASK` shows the spread, an estimate when the guesses are close, or "talk about this first" when they're far apart, and `--settle DAYS` records what you agreed. `harbor soundings` lists them, the ones waiting on your answer first. `harbor goals` lists each portfolio's goals (set on the portfolio's page on the website), off track first, with each key result's progress. `harbor ashore` lists the public holidays and time away in the next eight weeks; `--country US,GB` sets whose holidays the harbor takes and `--person NAME --country DE` one person's own, which the forecast and the weekly load then count as days off.
 
 `harbor brief --say` turns the brief into the BBC's Shipping Forecast: each program an area, wind for late work, visibility for health, gale warnings for anything off track. It prints the forecast and speaks it with your computer's own voice (`say` on a Mac, Windows' speech, or `espeak-ng` on Linux, which you may need to install). With `--json` it prints the forecast and stays quiet.
 

package/dist/app.mjs

@@ -9604,12 +9604,14 @@ const NOUN$1 = {
 	milestone: "milestone",
 	risk: "risk",
 	issue: "issue",
-	decision: "decision"
+	decision: "decision",
+	hold: ""
 };
 const CREATED = {
 	risk: "raised risk",
 	issue: "logged issue",
-	decision: "recorded decision"
+	decision: "recorded decision",
+	hold: "named what's holding it back:"
 };
 const whole = new Intl.NumberFormat("en-US", {
 	style: "currency",
@@ -9667,23 +9669,31 @@ function describeEvent(e, names) {
 		detail: null
 	};
 	if (e.kind === "deleted") return {
-		action: `deleted ${noun}`,
+		action: `deleted ${noun}`.trim(),
 		detail: null
 	};
 	const { from, to } = e;
 	switch (e.field) {
 		case "name":
 		case "title": return {
-			action: `renamed ${noun}`,
+			action: `renamed ${noun}`.trim(),
 			detail: from ? `from “${from}”` : null
 		};
-		case "status": return e.entity === "task" ? {
-			action: "moved",
-			detail: `from ${statusLabel(e.entity, from)} to ${statusLabel(e.entity, to)}`
-		} : {
-			action: "set",
-			detail: `to ${statusLabel(e.entity, to)}`
-		};
+		case "status":
+			if (e.entity === "hold") return to === "resolved" ? {
+				action: "cleared",
+				detail: "from what's holding it back"
+			} : {
+				action: "brought back",
+				detail: "as what's holding it back"
+			};
+			return e.entity === "task" ? {
+				action: "moved",
+				detail: `from ${statusLabel(e.entity, from)} to ${statusLabel(e.entity, to)}`
+			} : {
+				action: "set",
+				detail: `to ${statusLabel(e.entity, to)}`
+			};
 		case "assigneeId": return to ? {
 			action: "assigned",
 			detail: `to ${nameOf$3(names, to)}`
@@ -9993,7 +10003,83 @@ function HistoryView({ active, width, height, go }) {
 	});
 }
 
+// src/lib/project-messages.ts
+/** This project's messages, oldest first. */
+function messagesOf(reflections, projectId) {
+	return (reflections ?? []).filter((r) => r.projectId === projectId && isMessage(r)).sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+}
+/** Why a message can't be posted, or null. */
+function messageProblem(body) {
+	const t = body.trim();
+	if (!t) return "Write something first.";
+	if (t.length > 4e3) return `Keep it under ${MESSAGE_MAX.toLocaleString("en")} characters.`;
+	return null;
+}
+/** Who a message @mentions, leaving out its writer. */
+function messageMentions(body, people, authorId) {
+	return parseMentions(body, people).filter((id) => id !== authorId);
+}
+/** Whether someone may change or delete a message: its writer, or the harbor's owner (delete only). */
+function mayChangeMessage(message, personId, role, action) {
+	if (message.authorId === personId) return true;
+	return action === "delete" && role === "owner";
+}
+/**
+* What a person's Inbox says about project messages since `since`: each
+* message that @mentions them, and for each project they've written in, the
+* messages others posted after their last one (a mention among them is
+* already its own line). Projects that are finished are left out.
+*/
+function messageLines(data, personId, since) {
+	const done = new Set(data.projects.filter((p) => p.health === "done").map((p) => p.id));
+	const byProject = /* @__PURE__ */ new Map();
+	for (const r of data.reflections ?? []) {
+		if (!isMessage(r) || done.has(r.projectId)) continue;
+		const list = byProject.get(r.projectId);
+		if (list) list.push(r);
+		else byProject.set(r.projectId, [r]);
+	}
+	const out = [];
+	for (const list of byProject.values()) {
+		list.sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+		let joined = false;
+		let replies = [];
+		for (const m of list) {
+			if (m.authorId === personId) {
+				joined = true;
+				replies = [];
+				continue;
+			}
+			if (m.createdAt < since) continue;
+			if ((m.mentionedIds ?? []).includes(personId)) {
+				out.push({
+					kind: "mention",
+					message: m,
+					authorIds: [m.authorId]
+				});
+				continue;
+			}
+			if (joined) replies.push(m);
+		}
+		const latest = replies.at(-1);
+		if (latest) out.push({
+			kind: "reply",
+			message: latest,
+			authorIds: [...new Set(replies.map((m) => m.authorId))]
+		});
+	}
+	return out;
+}
+var MESSAGE_MAX, isMessage, messageText;
+var init_project_messages = __esmMin((() => {
+	init_work();
+	MESSAGE_MAX = 4e3;
+	isMessage = (r) => r.kind === "message";
+	messageText = (body) => body.trim().slice(0, MESSAGE_MAX);
+}));
+
 // src/lib/read-marks.ts
+init_project_messages();
 /**
 * Inbox read marks. A harbor keeps one list of them (`readPingIds`), shared
 * by everyone in it, so each mark names whose it is: reading a mention that
@@ -10303,6 +10389,25 @@ function inboxOf(data, personId, now = clockNow()) {
 			href: `/projects/${task.projectId}`
 		});
 	}
+	for (const line of messageLines(data, personId, since)) {
+		const project = data.projects.find((p) => p.id === line.message.projectId);
+		if (!project) continue;
+		const names = line.authorIds.map((id) => {
+			const who = data.people.find((p) => p.id === id);
+			return who ? firstName$3(who.name) : "Someone";
+		});
+		const snippet = excerpt(line.message.body);
+		const where = `in ${project.name}’s messages`;
+		pings.push({
+			id: `message-${line.kind}:${line.message.id}`,
+			kind: line.kind,
+			title: line.kind === "mention" ? `${names[0]} mentioned you` : `${listNames(names)} wrote back`,
+			detail: snippet ? `${where} — ${snippet}` : where,
+			at: line.message.createdAt,
+			personId: line.message.authorId,
+			href: `/projects/${project.id}?view=messages`
+		});
+	}
 	for (const task of data.tasks) {
 		if (task.assignedBy !== personId || !task.assigneeId || task.assigneeId === personId) continue;
 		if (task.status !== "done" || !task.completedAt || task.completedAt < since) continue;
@@ -11070,6 +11175,46 @@ function blockerOptions(items, id) {
 	return items.filter((n) => n.id !== id && !loops.has(n.id));
 }
 
+// src/lib/constraint-history.ts
+const RETIRED = "retired the constraint on ";
+function clearedConstraints(data, programId) {
+	const rows = (data.constraints ?? []).filter((c) => c.programId === programId && c.status === "resolved");
+	const unstamped = rows.filter((c) => !c.resolvedAt);
+	let guess;
+	if (unstamped.length === 1) guess = (data.activity ?? []).find((a) => a.text.startsWith(RETIRED) && a.href === `/programs/${programId}`);
+	const out = rows.map((c, i) => {
+		if (c.resolvedAt) return {
+			constraint: c,
+			at: c.resolvedAt,
+			byId: c.resolvedById ?? null,
+			order: i
+		};
+		if (guess) return {
+			constraint: c,
+			at: guess.at,
+			byId: guess.personId || null,
+			order: i
+		};
+		return {
+			constraint: c,
+			at: null,
+			byId: null,
+			order: i
+		};
+	});
+	out.sort((a, b) => {
+		if (a.at && b.at) return a.at < b.at ? 1 : a.at > b.at ? -1 : b.order - a.order;
+		if (a.at) return -1;
+		if (b.at) return 1;
+		return b.order - a.order;
+	});
+	return out.map(({ constraint, at, byId }) => ({
+		constraint,
+		at,
+		byId
+	}));
+}
+
 // src/lib/status-report.ts
 init_derived_health();
 init_flow();
@@ -11426,7 +11571,19 @@ function ProgramPanel({ id, width, height, go, active, onClose }) {
 	const programs = useHarbor((s) => s.programs);
 	const projects = useHarbor((s) => s.projects);
 	const constraint = useHarbor((s) => s.constraints.find((c) => c.programId === id && c.status === "active"));
+	const constraints = useHarbor((s) => s.constraints);
+	const activity = useHarbor((s) => s.activity);
 	if (!program) return null;
+	const cleared = clearedConstraints({
+		constraints,
+		activity
+	}, id);
+	const clearedHint = (at, byId) => {
+		const when = at ? parseIso(at) : null;
+		const by = byId ? people.find((p) => p.id === byId)?.name : void 0;
+		const ago = when && !Number.isNaN(when.getTime()) ? `cleared ${timeAgo(when)}` : "cleared, date not kept";
+		return by ? `${ago} by ${by}` : ago;
+	};
 	const s = store.getState();
 	const inProgram = projects.filter((p) => p.programId === id);
 	const baselined = inProgram.filter(hasBaseline);
@@ -11553,6 +11710,22 @@ function ProgramPanel({ id, width, height, go, active, onClose }) {
 				onPick: (v) => holding({ ownerId: v })
 			}
 		}] : [],
+		...cleared.length ? [{
+			label: "Cleared before",
+			value: `${cleared[0].constraint.title} (${clearedHint(cleared[0].at, cleared[0].byId)})${cleared.length > 1 ? ` and ${cleared.length - 1} more` : ""}`,
+			color: theme.muted,
+			edit: constraint ? void 0 : {
+				kind: "pick",
+				title: "Bring one back as what's holding it back",
+				choices: cleared.map((c) => ({
+					label: c.constraint.title,
+					value: c.constraint.id,
+					hint: clearedHint(c.at, c.byId)
+				})),
+				initial: 0,
+				onPick: (v) => store.getState().reopenConstraint(v)
+			}
+		}] : [],
 		waitsField("Waits on", program, programs, go, (patch) => store.getState().updateProgram(id, patch)),
 		{
 			label: "Baseline",
@@ -14076,8 +14249,88 @@ function keyResultText(kr, work) {
 }
 const fmt = (n) => Number.isInteger(n) ? n.toLocaleString("en-US") : String(Math.round(n * 100) / 100);
 
+// src/lib/custom-field-text.ts
+init_date_text();
+const FIELD_TYPE_LABEL = {
+	text: "Text",
+	number: "Number",
+	select: "Dropdown",
+	multi: "Tags",
+	checkbox: "Checkbox",
+	date: "Date",
+	person: "Person",
+	url: "Link"
+};
+const FIELD_TYPES = Object.keys(FIELD_TYPE_LABEL);
+/** A dropdown or tags field: one with a list of options. */
+function hasOptions(type) {
+	return type === "select" || type === "multi";
+}
+/** A dropdown's options from "S, M, L". */
+function optionsOf(value) {
+	return [...new Set(value.split(",").map((o) => o.trim()).filter(Boolean))];
+}
+/** The link a value names when it's an http(s) address, else null (never javascript: and the like). */
+function safeLink(value) {
+	if (typeof value !== "string") return null;
+	try {
+		const u = new URL(value.trim());
+		return u.protocol === "https:" || u.protocol === "http:" ? u.href : null;
+	} catch {
+		return null;
+	}
+}
+/** A link from "example.com/x" or "https://…"; null when it isn't a web address. */
+function readLink(text) {
+	const t = text.trim();
+	if (!t || /\s/.test(t)) return null;
+	const href = safeLink(/^[a-z][a-z0-9+.-]*:/i.test(t) ? t : `https://${t}`);
+	return href && /\./.test(new URL(href).hostname) ? href : null;
+}
+/** "example.com/docs/plan" from a link: what a short chip says. */
+function linkLabel(href) {
+	try {
+		const u = new URL(href);
+		const path = u.pathname === "/" ? "" : u.pathname.replace(/\/$/, "");
+		const text = u.host.replace(/^www\./, "") + path;
+		return text.length > 40 ? `${text.slice(0, 39)}…` : text;
+	} catch {
+		return href;
+	}
+}
+/** A tags field's value as a list, whatever was stored. */
+function tagsOf(value) {
+	if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
+	return typeof value === "string" && value ? [value] : [];
+}
+/** Whether a task carries a value for the field. */
+function hasFieldValue(def, value) {
+	if (value == null || value === "" || value === false) return false;
+	if (def.type === "multi") return tagsOf(value).length > 0;
+	return true;
+}
+/** A task's value for a field as one line: "" when it has none. */
+function fieldValueText(def, value, nameOf) {
+	if (!hasFieldValue(def, value)) return "";
+	switch (def.type) {
+		case "checkbox": return value ? "Yes" : "";
+		case "multi": return tagsOf(value).join(", ");
+		case "date": {
+			const d = parseIso(String(value));
+			return Number.isNaN(d.getTime()) ? String(value) : format(d, "MMM d, yyyy");
+		}
+		case "person": return nameOf?.(String(value)) ?? "Someone no longer here";
+		case "url": {
+			const href = safeLink(value);
+			return href ? linkLabel(href) : "";
+		}
+		default: return Array.isArray(value) ? value.join(", ") : String(value);
+	}
+}
+
 // src/lib/reports.ts
 init_date_fns();
+init_blockers();
 init_date_text();
 init_indexes();
 init_swatches();
@@ -14086,20 +14339,29 @@ const WEEKS_BACK = 12;
 const WEEKS_AHEAD = 8;
 /** Bars past this many are summed into "Everything else". */
 const MAX_BARS = 12;
-const GROUPS = [
-	"status",
-	"owner",
-	"priority",
-	"project",
-	"program",
-	"week"
+const MEASURES = [
+	"open",
+	"done",
+	"all",
+	"overdue",
+	"blocked",
+	"approval",
+	"hours",
+	"risks",
+	"issues",
+	"decisions"
 ];
 const MEASURE_LABEL = {
 	open: "Open tasks",
 	done: "Finished tasks",
 	all: "All tasks",
 	overdue: "Overdue tasks",
-	hours: "Hours logged"
+	blocked: "Blocked tasks",
+	approval: "Tasks waiting for approval",
+	hours: "Hours logged",
+	risks: "Open risks",
+	issues: "Open issues",
+	decisions: "Decisions to make"
 };
 const GROUP_LABEL = {
 	status: "Status",
@@ -14107,16 +14369,72 @@ const GROUP_LABEL = {
 	priority: "Priority",
 	project: "Project",
 	program: "Program",
-	week: "Week"
+	week: "Week",
+	severity: "Severity",
+	field: "A project field"
+};
+/** Still open: raid.ts's `isActive`, kept here so a chart doesn't load the register's code. */
+const ACTIVE_RAID = /* @__PURE__ */ new Set([
+	"open",
+	"watching",
+	"mitigated",
+	"proposed"
+]);
+const RAID_KIND = {
+	risks: "risk",
+	issues: "issue",
+	decisions: "decision"
 };
-/** The splits a measure can take: hours have no status or priority of their own. */
+/** True for the measures that count risks, issues or decisions rather than tasks. */
+const isRaidMeasure = (m) => m in RAID_KIND;
+/** The splits a measure can take: hours have no status or priority of their own, risks no project fields. */
 function groupsFor(measure) {
-	return measure === "hours" ? [
+	if (measure === "hours") return [
+		"owner",
+		"project",
+		"program",
+		"week",
+		"field"
+	];
+	if (measure === "decisions") return [
+		"owner",
+		"project",
+		"program",
+		"week"
+	];
+	if (isRaidMeasure(measure)) return [
+		"severity",
 		"owner",
 		"project",
 		"program",
 		"week"
-	] : GROUPS;
+	];
+	return [
+		"status",
+		"owner",
+		"priority",
+		"project",
+		"program",
+		"week",
+		"field"
+	];
+}
+/** What a chart can be kept to. Hours read the task they were logged on, so they take its priority and status. */
+function filtersFor(measure) {
+	if (measure === "decisions") return ["owner"];
+	if (isRaidMeasure(measure)) return ["severity", "owner"];
+	return [
+		"priority",
+		"owner",
+		"status",
+		"field"
+	];
+}
+/** "Owner" means who logged the hours, and who's asked to approve; the editor says so. */
+function groupLabel(measure, group) {
+	if (group === "owner" && measure === "hours") return "Who logged it";
+	if (group === "owner" && measure === "approval") return "Approver";
+	return GROUP_LABEL[group];
 }
 const STATUS_FILL = {
 	backlog: "var(--color-swatch-slate)",
@@ -14137,6 +14455,21 @@ const PRIORITIES$1 = [
 	"medium",
 	"low"
 ];
+const SEVERITIES = [
+	"high",
+	"medium",
+	"low"
+];
+const SEVERITY_LABEL = {
+	high: "High",
+	medium: "Medium",
+	low: "Low"
+};
+const SEVERITY_FILL = {
+	high: "var(--color-swatch-coral)",
+	medium: "var(--color-swatch-sand)",
+	low: "var(--color-swatch-slate)"
+};
 /** Colours handed out in turn where a slice has none of its own. */
 const CYCLE = [
 	"sea",
@@ -14158,14 +14491,21 @@ function mondayOf(day) {
 }
 /** The projects a chart reads: everything, or what sits under its scope. */
 function scopeOf(data, scopeId) {
+	const none = {
+		programIds: null,
+		portfolioId: null
+	};
 	if (!scopeId) return {
 		projectIds: null,
+		...none,
 		name: "Whole harbor",
 		found: true
 	};
 	const project = byId(data.projects).get(scopeId);
 	if (project) return {
 		projectIds: /* @__PURE__ */ new Set([project.id]),
+		programIds: /* @__PURE__ */ new Set(),
+		portfolioId: null,
 		name: project.name,
 		found: true
 	};
@@ -14174,6 +14514,8 @@ function scopeOf(data, scopeId) {
 		const ids = data.projects.filter((p) => p.programId === program.id).map((p) => p.id);
 		return {
 			projectIds: new Set(ids),
+			programIds: /* @__PURE__ */ new Set([program.id]),
+			portfolioId: null,
 			name: program.name,
 			found: true
 		};
@@ -14184,60 +14526,243 @@ function scopeOf(data, scopeId) {
 		const ids = data.projects.filter((p) => programIds.has(p.programId)).map((p) => p.id);
 		return {
 			projectIds: new Set(ids),
+			programIds,
+			portfolioId: portfolio.id,
 			name: portfolio.name,
 			found: true
 		};
 	}
 	return {
 		projectIds: /* @__PURE__ */ new Set(),
+		programIds: /* @__PURE__ */ new Set(),
+		portfolioId: null,
 		name: "Deleted",
 		found: false
 	};
 }
+/** A risk, issue or decision belongs to a scope when it was raised in it or anywhere under it. */
+function raidInScope(item, scope) {
+	if (!scope.projectIds) return true;
+	if (item.projectId) return scope.projectIds.has(item.projectId);
+	if (item.programId) return scope.programIds?.has(item.programId) ?? false;
+	return !!item.portfolioId && item.portfolioId === scope.portfolioId;
+}
+const isGroupable = (def) => def.type === "select" || def.type === "multi" || def.type === "person" || def.type === "checkbox";
+function matchesFilter(def, value, want) {
+	if (!want) return !hasFieldValue(def, value);
+	if (def.type === "checkbox") return value === true;
+	if (def.type === "multi") return tagsOf(value).includes(want);
+	return value === want;
+}
+const sameName = (a, b) => a.trim().toLowerCase() === b.trim().toLowerCase();
+/**
+* Each project's field of this name, where a chart can split or filter by it:
+* the kind of field that has a short list of values (choice, tags, person,
+* checkbox), and the same kind as the first project that has one, so "Team"
+* as a choice in one project and a person in another doesn't mix the two.
+*/
+function fieldDefs(projects, name) {
+	const defs = /* @__PURE__ */ new Map();
+	if (!name?.trim()) return defs;
+	let type = null;
+	for (const p of projects) {
+		const def = (p.customFields ?? []).find((d) => sameName(d.name, name) && isGroupable(d));
+		if (!def) continue;
+		type ??= def.type;
+		if (def.type === type) defs.set(p.id, def);
+	}
+	return defs;
+}
+/** The fields a chart over this scope can split or filter by, by name, in the projects' own order. */
+function chartFields(data, scopeId) {
+	const scope = scopeOf(data, scopeId);
+	const out = [];
+	for (const p of data.projects) {
+		if (scope.projectIds && !scope.projectIds.has(p.id)) continue;
+		for (const def of p.customFields ?? []) {
+			if (!isGroupable(def) || out.some((f) => sameName(f.name, def.name))) continue;
+			out.push({
+				name: def.name.trim(),
+				def
+			});
+		}
+	}
+	return out;
+}
+/** The values a filter can keep to, with "" meaning none ("Nobody", "No Size"). */
+function filterValues(measure, filter, data, scopeId) {
+	switch (filter.by) {
+		case "priority": return PRIORITIES$1.map((p) => ({
+			value: p,
+			label: PRIORITY_LABEL[p]
+		}));
+		case "status": return TASK_COLUMNS.map((s) => ({
+			value: s,
+			label: TASK_STATUS_LABEL[s]
+		}));
+		case "severity": return SEVERITIES.map((s) => ({
+			value: s,
+			label: SEVERITY_LABEL[s]
+		}));
+		case "owner": return [...data.people.map((p) => ({
+			value: p.id,
+			label: p.name
+		})), {
+			value: "",
+			label: measure === "approval" ? "No approver" : "Nobody"
+		}];
+		case "field": {
+			const found = chartFields(data, scopeId).find((f) => sameName(f.name, filter.field ?? ""));
+			if (!found) return [];
+			const def = {
+				...found.def,
+				name: found.name
+			};
+			if (def.type === "select" || def.type === "multi") {
+				const scope = scopeOf(data, scopeId);
+				const inScope = data.projects.filter((p) => !scope.projectIds || scope.projectIds.has(p.id));
+				const options = /* @__PURE__ */ new Set();
+				for (const d of fieldDefs(inScope, def.name).values()) for (const o of d.options ?? []) options.add(o);
+				return [...[...options].map((o) => ({
+					value: o,
+					label: o
+				})), {
+					value: "",
+					label: `No ${def.name}`
+				}];
+			}
+			return def.type === "checkbox" ? [{
+				value: "yes",
+				label: def.name
+			}, {
+				value: "",
+				label: `Not ${def.name}`
+			}] : [...data.people.map((p) => ({
+				value: p.id,
+				label: p.name
+			})), {
+				value: "",
+				label: `No ${def.name}`
+			}];
+		}
+	}
+}
+/** "Only urgent", "Only Ana's", "Only Size: L", "Only no owner". */
+function filterText(measure, filter, data, scopeId) {
+	const personField = filter.by === "field" && chartFields(data, scopeId).find((f) => sameName(f.name, filter.field ?? ""))?.def.type === "person";
+	const label = filterValues(measure, filter, data, scopeId).find((c) => c.value === filter.value)?.label ?? (filter.by === "owner" ? "Former member" : personField ? "Someone no longer here" : filter.value);
+	if (filter.by === "field") {
+		const name = filter.field?.trim() ?? "";
+		if (!filter.value) return `Only ${label.charAt(0).toLowerCase()}${label.slice(1)}`;
+		return sameName(label, name) ? `Only ${label}` : `Only ${name}: ${label}`;
+	}
+	if (filter.by === "owner") {
+		if (!filter.value) return measure === "approval" ? "Only with no approver" : "Only with no owner";
+		if (measure === "hours") return `Only logged by ${label}`;
+		if (measure === "approval") return `Only for ${label} to approve`;
+		return `Only ${label}'s`;
+	}
+	if (filter.by === "severity") return `Only ${label.toLowerCase()} severity`;
+	return `Only ${label.toLowerCase()}`;
+}
 /**
-* What a chart shows today: its slices in a fixed order (statuses and
-* priorities in board order, weeks in time order, the rest largest first,
-* past MAX_BARS summed into "Everything else"), with their total.
+* What a chart shows today: its slices in a fixed order (statuses,
+* priorities and severities in their own order, weeks in time order, the
+* rest largest first, past MAX_BARS summed into "Everything else"), with
+* their total.
 */
 function chartData(chart, data, today) {
+	const measure = MEASURES.includes(chart.measure) ? chart.measure : "open";
 	const scope = scopeOf(data, chart.scopeId);
 	const inScope = (t) => !scope.projectIds || scope.projectIds.has(t.projectId);
-	const unit = chart.measure === "hours" ? "hours" : "tasks";
-	const groupBy = groupsFor(chart.measure).includes(chart.groupBy) ? chart.groupBy : "owner";
+	const kind = RAID_KIND[measure];
+	const unit = kind ? measure : measure === "hours" ? "hours" : "tasks";
+	const groupBy = groupsFor(measure).includes(chart.groupBy) ? chart.groupBy : "owner";
+	const filter = chart.filter && filtersFor(measure).includes(chart.filter.by) ? chart.filter : null;
+	const projectsInScope = scope.projectIds ? data.projects.filter((p) => scope.projectIds.has(p.id)) : data.projects;
+	const splitDefs = groupBy === "field" ? fieldDefs(projectsInScope, chart.field) : null;
+	const filterDefs = filter?.by === "field" ? fieldDefs(projectsInScope, filter.field) : null;
+	const tasksById = measure === "blocked" ? byId(data.tasks) : null;
+	const keep = (item) => {
+		if (!filter) return true;
+		const t = item.task;
+		switch (filter.by) {
+			case "owner": return (item.personId ?? "") === filter.value;
+			case "priority": return !!t && t.priority === filter.value;
+			case "status": return !!t && t.status === filter.value;
+			case "severity": return !!item.raid && item.raid.severity === filter.value;
+			case "field": {
+				if (!t) return false;
+				const def = filterDefs.get(t.projectId);
+				if (!def) return filter.value === "";
+				return matchesFilter(def, t.customFieldValues?.[def.id], filter.value);
+			}
+		}
+	};
 	const items = [];
-	for (const task of data.tasks) {
+	const push = (item) => {
+		if (keep(item)) items.push(item);
+	};
+	if (kind) for (const r of data.raidItems ?? []) {
+		if (r.kind !== kind || !ACTIVE_RAID.has(r.status) || !raidInScope(r, scope)) continue;
+		push({
+			raid: r,
+			amount: 1,
+			day: r.dueDate,
+			personId: r.ownerId
+		});
+	}
+	else for (const task of data.tasks) {
 		if (!inScope(task)) continue;
 		const done = task.status === "done";
-		switch (chart.measure) {
+		const mine = {
+			task,
+			amount: 1,
+			personId: task.assigneeId
+		};
+		switch (measure) {
 			case "open":
-				if (!done) items.push({
-					task,
-					amount: 1,
+				if (!done) push({
+					...mine,
 					day: task.dueDate
 				});
 				break;
 			case "done":
-				if (done) items.push({
-					task,
-					amount: 1,
+				if (done) push({
+					...mine,
 					day: task.completedAt
 				});
 				break;
 			case "all":
-				items.push({
-					task,
-					amount: 1,
+				push({
+					...mine,
 					day: task.createdAt
 				});
 				break;
 			case "overdue":
-				if (!done && task.dueDate && task.dueDate.slice(0, 10) < today) items.push({
+				if (!done && task.dueDate && task.dueDate.slice(0, 10) < today) push({
+					...mine,
+					day: task.dueDate
+				});
+				break;
+			case "blocked":
+				if (!done && blockerIds(task).some((id) => {
+					const b = tasksById.get(id);
+					return !!b && b.status !== "done";
+				})) push({
+					...mine,
+					day: task.dueDate
+				});
+				break;
+			case "approval":
+				if (task.approval?.status === "pending") push({
 					task,
 					amount: 1,
-					day: task.dueDate
+					day: task.approval.askedAt,
+					personId: task.approval.approverId
 				});
 				break;
-			case "hours": for (const entry of task.time ?? []) items.push({
+			case "hours": for (const entry of task.time ?? []) push({
 				task,
 				amount: entry.minutes / 60,
 				day: entry.on,
@@ -14250,10 +14775,14 @@ function chartData(chart, data, today) {
 	const people = byId(data.people);
 	const sums = /* @__PURE__ */ new Map();
 	const add = (key, amount) => sums.set(key, (sums.get(key) ?? 0) + amount);
+	/** Field values in the order the field lists them, for a field split. */
+	const fieldLabels = /* @__PURE__ */ new Map();
+	let fieldNone = "";
+	let overlaps = false;
 	let weeks = [];
 	if (groupBy === "week") {
 		const thisWeek = mondayOf(today);
-		const ahead = chart.measure === "open";
+		const ahead = measure !== "done" && measure !== "all" && measure !== "overdue" && measure !== "approval" && measure !== "hours";
 		const first = ahead ? thisWeek : format(addDays(parseIso(`${thisWeek}T12:00:00`), -77), "yyyy-MM-dd");
 		const count = ahead ? 8 : 12;
 		const start = parseIso(`${first}T12:00:00`);
@@ -14265,9 +14794,36 @@ function chartData(chart, data, today) {
 			if (known.has(week)) add(week, item.amount);
 			else if (ahead && week < first) add(first, item.amount);
 		}
+	} else if (groupBy === "field") {
+		const name = chart.field?.trim() || "field";
+		const first = splitDefs.values().next().value;
+		const shown = first?.name.trim() || name;
+		fieldNone = first?.type === "checkbox" ? `Not ${shown}` : `No ${shown}`;
+		for (const item of items) {
+			const t = item.task;
+			const def = splitDefs.get(t.projectId);
+			const v = def ? t.customFieldValues?.[def.id] : void 0;
+			if (!def || !hasFieldValue(def, v)) add("", item.amount);
+			else if (def.type === "multi") {
+				const tags = [...new Set(tagsOf(v))];
+				if (tags.length > 1) overlaps = true;
+				for (const tag of tags) {
+					fieldLabels.set(tag, tag);
+					add(tag, item.amount);
+				}
+			} else if (def.type === "checkbox") {
+				fieldLabels.set("yes", def.name.trim());
+				add("yes", item.amount);
+			} else {
+				const key = String(v);
+				fieldLabels.set(key, fieldValueText(def, v, (id) => people.get(id)?.name) || key);
+				add(key, item.amount);
+			}
+		}
 	} else for (const item of items) {
 		const t = item.task;
-		add(groupBy === "status" ? t.status : groupBy === "priority" ? t.priority : groupBy === "project" ? t.projectId : groupBy === "program" ? projects.get(t.projectId)?.programId ?? "" : (chart.measure === "hours" ? item.personId : t.assigneeId) ?? "", item.amount);
+		const r = item.raid;
+		add(groupBy === "status" ? t?.status ?? "" : groupBy === "priority" ? t?.priority ?? "" : groupBy === "severity" ? r?.severity ?? "" : groupBy === "project" ? (t ? t.projectId : r?.projectId) ?? "" : groupBy === "program" ? t ? projects.get(t.projectId)?.programId ?? "" : r?.programId ?? (r?.projectId ? projects.get(r.projectId)?.programId : null) ?? "" : item.personId ?? "", item.amount);
 	}
 	const round = (n) => unit === "hours" ? Math.round(n * 10) / 10 : n;
 	let slices;
@@ -14289,20 +14845,38 @@ function chartData(chart, data, today) {
 		value: round(sums.get(p)),
 		fill: PRIORITY_FILL[p]
 	}));
+	else if (groupBy === "severity") slices = SEVERITIES.filter((s) => sums.has(s)).map((s) => ({
+		key: s,
+		label: SEVERITY_LABEL[s],
+		value: round(sums.get(s)),
+		fill: SEVERITY_FILL[s]
+	}));
 	else {
 		const named = [...sums.entries()].map(([key, value], i) => {
+			if (groupBy === "field") return {
+				key: key || "none",
+				label: key ? fieldLabels.get(key) ?? key : fieldNone,
+				value: round(value),
+				fill: key ? swatchFill(CYCLE[i % CYCLE.length]) : "var(--color-swatch-slate)"
+			};
 			if (groupBy === "owner") {
 				const person = key ? people.get(key) : void 0;
 				return {
 					key: key || "nobody",
-					label: key ? person?.name ?? "Former member" : "Nobody",
+					label: key ? person?.name ?? "Former member" : measure === "approval" ? "No approver" : "Nobody",
 					value: round(value),
 					fill: key ? swatchFill(CYCLE[i % CYCLE.length]) : "var(--color-swatch-slate)"
 				};
 			}
+			if (!key) return {
+				key: "none",
+				label: groupBy === "project" ? "Not on a project" : "Not in a program",
+				value: round(value),
+				fill: "var(--color-swatch-slate)"
+			};
 			const thing = groupBy === "project" ? projects.get(key) : programs.get(key);
 			return {
-				key: key || "none",
+				key,
 				label: thing?.name ?? "Deleted",
 				value: round(value),
 				fill: thing?.swatch ? swatchFill(thing.swatch) : swatchFill(CYCLE[i % CYCLE.length])
@@ -14319,24 +14893,37 @@ function chartData(chart, data, today) {
 			}];
 		} else slices = named;
 	}
-	const total = round(slices.reduce((n, s) => n + s.value, 0));
+	const total = overlaps ? round(items.reduce((n, i) => n + i.amount, 0)) : round(slices.reduce((n, s) => n + s.value, 0));
 	return {
 		slices,
 		total,
 		unit,
 		scopeName: scope.name,
-		scopeFound: scope.found
+		scopeFound: scope.found,
+		filterText: filter ? filterText(measure, filter, data, chart.scopeId) : null,
+		overlaps
 	};
 }
-/** "12 tasks", "1 task", "7.5 hours". */
+const UNIT_WORDS = {
+	tasks: ["task", "tasks"],
+	hours: ["hour", "hours"],
+	risks: ["risk", "risks"],
+	issues: ["issue", "issues"],
+	decisions: ["decision", "decisions"]
+};
+/** "task" or "tasks", "risk" or "risks". */
+function unitWord(value, unit) {
+	return UNIT_WORDS[unit][value === 1 ? 0 : 1];
+}
+/** "12 tasks", "1 task", "7.5 hours", "3 risks". */
 function amountText(value, unit) {
-	if (unit === "hours") return `${value} ${value === 1 ? "hour" : "hours"}`;
-	return `${value} ${value === 1 ? "task" : "tasks"}`;
+	return `${value} ${unitWord(value, unit)}`;
 }
 /** A chart's text for screen readers, agents and the terminal: "Open tasks by owner: Sam 4, Ana 2 (6 tasks)". */
 function chartText(title, result) {
-	if (result.slices.length === 0) return `${title}: nothing yet`;
-	return `${title}: ${result.slices.map((s) => `${s.label} ${s.value}`).join(", ")} (${amountText(result.total, result.unit)})`;
+	const named = result.filterText ? `${title} (${result.filterText.toLowerCase()})` : title;
+	if (result.slices.length === 0) return `${named}: nothing yet`;
+	return `${named}: ${result.slices.map((s) => `${s.label} ${s.value}`).join(", ")} (${amountText(result.total, result.unit)})`;
 }
 
 // node_modules/zod/v4/core/util.js
@@ -19918,85 +20505,6 @@ function exportName(harborName, now) {
 	return `${harborName.normalize("NFKD").replace(/\p{M}/gu, "").replace(/&/g, " and ").replace(/[^\w]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase() || "harbor"}-${now.toISOString().slice(0, 10)}`;
 }
 
-// src/lib/custom-field-text.ts
-init_date_text();
-const FIELD_TYPE_LABEL = {
-	text: "Text",
-	number: "Number",
-	select: "Dropdown",
-	multi: "Tags",
-	checkbox: "Checkbox",
-	date: "Date",
-	person: "Person",
-	url: "Link"
-};
-const FIELD_TYPES = Object.keys(FIELD_TYPE_LABEL);
-/** A dropdown or tags field: one with a list of options. */
-function hasOptions(type) {
-	return type === "select" || type === "multi";
-}
-/** A dropdown's options from "S, M, L". */
-function optionsOf(value) {
-	return [...new Set(value.split(",").map((o) => o.trim()).filter(Boolean))];
-}
-/** The link a value names when it's an http(s) address, else null (never javascript: and the like). */
-function safeLink(value) {
-	if (typeof value !== "string") return null;
-	try {
-		const u = new URL(value.trim());
-		return u.protocol === "https:" || u.protocol === "http:" ? u.href : null;
-	} catch {
-		return null;
-	}
-}
-/** A link from "example.com/x" or "https://…"; null when it isn't a web address. */
-function readLink(text) {
-	const t = text.trim();
-	if (!t || /\s/.test(t)) return null;
-	const href = safeLink(/^[a-z][a-z0-9+.-]*:/i.test(t) ? t : `https://${t}`);
-	return href && /\./.test(new URL(href).hostname) ? href : null;
-}
-/** "example.com/docs/plan" from a link: what a short chip says. */
-function linkLabel(href) {
-	try {
-		const u = new URL(href);
-		const path = u.pathname === "/" ? "" : u.pathname.replace(/\/$/, "");
-		const text = u.host.replace(/^www\./, "") + path;
-		return text.length > 40 ? `${text.slice(0, 39)}…` : text;
-	} catch {
-		return href;
-	}
-}
-/** A tags field's value as a list, whatever was stored. */
-function tagsOf(value) {
-	if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
-	return typeof value === "string" && value ? [value] : [];
-}
-/** Whether a task carries a value for the field. */
-function hasFieldValue(def, value) {
-	if (value == null || value === "" || value === false) return false;
-	if (def.type === "multi") return tagsOf(value).length > 0;
-	return true;
-}
-/** A task's value for a field as one line: "" when it has none. */
-function fieldValueText(def, value, nameOf) {
-	if (!hasFieldValue(def, value)) return "";
-	switch (def.type) {
-		case "checkbox": return value ? "Yes" : "";
-		case "multi": return tagsOf(value).join(", ");
-		case "date": {
-			const d = parseIso(String(value));
-			return Number.isNaN(d.getTime()) ? String(value) : format(d, "MMM d, yyyy");
-		}
-		case "person": return nameOf?.(String(value)) ?? "Someone no longer here";
-		case "url": {
-			const href = safeLink(value);
-			return href ? linkLabel(href) : "";
-		}
-		default: return Array.isArray(value) ? value.join(", ") : String(value);
-	}
-}
-
 // src/lib/exports.ts
 init_subtasks();
 init_derived_health();
@@ -20658,6 +21166,7 @@ function approvalsWaitingOn(tasks, personId) {
 }
 
 // src/lib/mcp/tools.ts
+init_project_messages();
 init_subtasks();
 init_thanks();
 init_task_keys();
@@ -22053,6 +22562,36 @@ const HARBOR_TOOLS = [
 			};
 		}
 	}),
+	tool({
+		name: "list_messages",
+		title: "A project's messages",
+		description: "The conversation on a project's Messages tab, for what isn't about one task: each message with who wrote it, when, whether it was edited, and who it @mentions, oldest first (the newest `limit`, default 50; more says how many earlier ones were left out). post_message writes one." + DATA_NOTE,
+		input: object({
+			harbor: harborArg,
+			project: string().min(1).max(200).describe("Project id or name."),
+			limit: number().int().min(1).max(500).optional()
+		}),
+		run: (ctx, input) => {
+			const { data } = ctx;
+			const p = findOne(data.projects, input.project, "project");
+			const people = byId(data.people);
+			const all = messagesOf(data.reflections, p.id);
+			const limit = input.limit ?? 50;
+			const shown = all.slice(-limit);
+			return {
+				project: p.name,
+				messages: shown.map((m) => ({
+					id: m.id,
+					from: nameOf$2(people, m.authorId),
+					at: m.createdAt,
+					...m.editedAt ? { edited: m.editedAt } : {},
+					body: m.body,
+					...(m.mentionedIds ?? []).length ? { mentions: (m.mentionedIds ?? []).map((id) => nameOf$2(people, id)) } : {}
+				})),
+				...all.length > shown.length ? { more: all.length - shown.length } : {}
+			};
+		}
+	}),
 	tool({
 		name: "list_soundings",
 		title: "Soundings",
@@ -22169,7 +22708,7 @@ const HARBOR_TOOLS = [
 	tool({
 		name: "list_dashboards",
 		title: "Dashboards",
-		description: "The harbor's dashboards from the Reports page, each chart with what it counts (open, finished, overdue or all tasks, or hours logged), how it's split (status, owner, priority, project, program or week), the part of the harbor it reads, and its numbers as of today, with a one-line text of each." + DATA_NOTE,
+		description: "The harbor's dashboards from the Reports page, each chart with what it counts (open, finished, overdue, blocked, waiting-for-approval or all tasks, hours logged, open risks, open issues or decisions to make), how it's split (status, owner, priority, project, program, week, severity or one of the projects' own fields by name), what it's kept to (only: one priority, owner, status, severity or field value; absent when it counts everything), the part of the harbor it reads, and its numbers as of today, with a one-line text of each. Subtasks count as tasks of their own; with a tags field one task can sit under two values, so the values can add up to more than the total." + DATA_NOTE,
 		input: object({
 			harbor: harborArg,
 			dashboard: string().max(200).optional().describe("Dashboard id or name. Default: all.")
@@ -22187,9 +22726,10 @@ const HARBOR_TOOLS = [
 						id: c.id,
 						title: c.title,
 						counts: MEASURE_LABEL[c.measure],
-						splitBy: GROUP_LABEL[c.groupBy],
+						splitBy: c.groupBy === "field" ? c.field ?? "" : groupLabel(c.measure, c.groupBy),
 						view: c.view,
 						from: result.scopeName,
+						...result.filterText ? { only: result.filterText } : {},
 						total: amountText(result.total, result.unit),
 						values: result.slices.map((s) => ({
 							label: s.label,
@@ -24652,7 +25192,7 @@ function recordScoreChange(item, patch, at) {
 var init_raid_history = __esmMin((() => {}));
 
 // src/lib/slices/milestones-raid.ts
-function milestonesRaidSlice({ set, get, write }) {
+function milestonesRaidSlice({ get, write }) {
 	return {
 		toggleMilestone: (id) => {
 			if (get().milestones.find((m) => m.id === id)?.approverId) return;
@@ -24684,15 +25224,16 @@ function milestonesRaidSlice({ set, get, write }) {
 			write({ milestones: [...get().milestones, m] });
 		},
 		setConstraint: (programId, patch) => {
+			const program = get().programs.find((p) => p.id === programId);
+			const logNamed = () => get().log(`named the constraint on ${program?.name ?? "a program"}`, `/programs/${programId}`);
 			const existing = get().constraints.find((c) => c.programId === programId && c.status === "active");
 			if (existing) {
-				set({ constraints: get().constraints.map((c) => c.id === existing.id ? {
+				write({ constraints: get().constraints.map((c) => c.id === existing.id ? {
 					...c,
 					...patch,
 					status: "active"
 				} : c) });
-				const program = get().programs.find((p) => p.id === programId);
-				get().log(`named the constraint on ${program?.name ?? "a program"}`, `/programs/${programId}`);
+				logNamed();
 				return existing.id;
 			}
 			const id = uid("k");
@@ -24700,29 +25241,48 @@ function milestonesRaidSlice({ set, get, write }) {
 				...patch,
 				id,
 				programId,
-				status: "active"
+				status: "active",
+				createdAt: stamp(),
+				createdById: get().currentUserId || null
 			};
-			set({ constraints: [...get().constraints, row] });
-			const program = get().programs.find((p) => p.id === programId);
-			get().log(`named the constraint on ${program?.name ?? "a program"}`, `/programs/${programId}`);
+			write({ constraints: [...get().constraints, row] });
+			logNamed();
 			return id;
 		},
 		updateConstraint: (id, patch) => {
-			set({ constraints: get().constraints.map((c) => c.id === id ? {
+			write({ constraints: get().constraints.map((c) => c.id === id ? {
 				...c,
 				...patch
 			} : c) });
 		},
 		resolveConstraint: (id) => {
 			const row = get().constraints.find((c) => c.id === id);
-			set({ constraints: get().constraints.map((c) => c.id === id ? {
+			if (!row || row.status === "resolved") return;
+			write({ constraints: get().constraints.map((c) => c.id === id ? {
 				...c,
-				status: "resolved"
+				status: "resolved",
+				resolvedAt: stamp(),
+				resolvedById: get().currentUserId || null
 			} : c) });
-			if (row) {
-				const program = get().programs.find((p) => p.id === row.programId);
-				get().log(`retired the constraint on ${program?.name ?? "a program"}`, `/programs/${row.programId}`);
-			}
+			const program = get().programs.find((p) => p.id === row.programId);
+			get().log(`retired the constraint on ${program?.name ?? "a program"}`, `/programs/${row.programId}`);
+		},
+		reopenConstraint: (id) => {
+			const row = get().constraints.find((c) => c.id === id);
+			if (!row) return false;
+			if (row.status === "active") return true;
+			if (get().constraints.some((c) => c.programId === row.programId && c.status === "active")) return false;
+			write({ constraints: get().constraints.map((c) => {
+				if (c.id !== id) return c;
+				const { resolvedAt: _at, resolvedById: _by, ...rest } = c;
+				return {
+					...rest,
+					status: "active"
+				};
+			}) });
+			const program = get().programs.find((p) => p.id === row.programId);
+			get().log(`brought back the constraint on ${program?.name ?? "a program"}`, `/programs/${row.programId}`);
+			return true;
 		},
 		addRaidItem: (r) => {
 			const id = uid("raid");
@@ -24938,6 +25498,48 @@ function milestonesRaidSlice({ set, get, write }) {
 			write({ reflections: [...s.reflections ?? [], row] });
 			return row.id;
 		},
+		postMessage: (projectId, body) => {
+			const s = get();
+			if (messageProblem(body)) return null;
+			const project = s.projects.find((p) => p.id === projectId);
+			if (!project) return null;
+			const me = s.currentUserId;
+			const text = messageText(body);
+			const row = {
+				id: uid("msg"),
+				projectId,
+				kind: "message",
+				authorId: me,
+				body: text,
+				createdAt: stamp(),
+				mentionedIds: messageMentions(text, s.people, me)
+			};
+			write({ reflections: [...s.reflections ?? [], row] });
+			get().log(`wrote in ${project.name}’s messages`, `/projects/${projectId}?view=messages`);
+			return row.id;
+		},
+		editMessage: (id, body) => {
+			const s = get();
+			const all = s.reflections ?? [];
+			const row = all.find((r) => r.id === id && isMessage(r));
+			if (!row || !mayChangeMessage(row, s.currentUserId, s.myRole, "edit")) return;
+			if (messageProblem(body)) return;
+			const text = messageText(body);
+			if (text === row.body) return;
+			write({ reflections: all.map((r) => r.id === id ? {
+				...r,
+				body: text,
+				mentionedIds: messageMentions(text, s.people, r.authorId),
+				editedAt: stamp()
+			} : r) });
+		},
+		deleteMessage: (id) => {
+			const s = get();
+			const all = s.reflections ?? [];
+			const row = all.find((r) => r.id === id && isMessage(r));
+			if (!row || !mayChangeMessage(row, s.currentUserId, s.myRole, "delete")) return;
+			write({ reflections: all.filter((r) => r.id !== id) });
+		},
 		writeVoyageLine: (projectId, body) => {
 			const text = body.trim().slice(0, 600);
 			const me = get().currentUserId;
@@ -25031,6 +25633,7 @@ var init_milestones_raid = __esmMin((() => {
 	init_raid_history();
 	init_passage();
 	init_format();
+	init_project_messages();
 	init_utils();
 	init_shared();
 }));

package/lib/cli.mjs

@@ -33,6 +33,7 @@ import {
   myWork,
   premortemText,
   notesText,
+  messagesText,
   charterText,
   daysText,
   soundingText,
@@ -251,6 +252,9 @@ export const HELP = `harbor: Harbor from the terminal
                                               answer or read it
   harbor voyage PROJECT ["YOUR LINE"]         a Done project's voyage log, and
                                               your line in it
+  harbor messages PROJECT ["TEXT"] [--limit N]
+                                              a project's messages, or write
+                                              one (@Name tells them)
   harbor charter PROJECT [--why T] [--in T] [--out T] [--done-when T]
                          [--calls NAME]
                                               a project's five-line charter
@@ -1270,6 +1274,14 @@ const DETAIL = {
     "  it explains. The weekly brief names projects that grew a lot since",
     "  their baseline.",
   ],
+  messages: [
+    "  harbor messages PROJECT                reads a project's Messages tab",
+    '  harbor messages PROJECT "TEXT"         writes: posts to everyone on it',
+    "",
+    "  One conversation for the whole project, for what isn't about one task;",
+    "  harbor comment TASK is for that. @Name sends it to that person's Inbox.",
+    "  Reading shows the newest 50, oldest first; --limit N shows up to 500.",
+  ],
   voyage: [
     "  harbor voyage PROJECT                  reads a Done project's voyage log",
     '  harbor voyage PROJECT "YOUR LINE"      writes: adds or changes your line in it',
@@ -3458,6 +3470,29 @@ export async function run(argv, io = {}) {
       }
       return call("get_voyage_log", { harbor, project }, voyageText, voyageForTerminal);
     }
+    case "messages": {
+      const { positionals, values, harbor } = parse(spec([], ["limit"]));
+      const [project, ...words] = positionals;
+      if (!project)
+        throw new HarborError(
+          'Give a project, and a message if you\'re writing one: harbor messages "NAME" "TEXT".',
+        );
+      const body = words.join(" ").trim();
+      if (body) {
+        if (values.limit)
+          throw new HarborError("--limit is for reading; leave it off when you write.");
+        return call(
+          "post_message",
+          { harbor, project, body },
+          (r) =>
+            `Posted in ${r.posted.project}'s messages${r.mentioned?.length ? `; told ${r.mentioned.join(", ")}` : ""}.`,
+        );
+      }
+      const limit = values.limit ? Number(values.limit) : undefined;
+      if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 500))
+        throw new HarborError("--limit is a whole number from 1 to 500.");
+      return call("list_messages", { harbor, project, ...(limit ? { limit } : {}) }, messagesText);
+    }
     case "watch": {
       const { positionals, values, harbor } = parse(spec(["bell", "once"], ["project", "since"]));
       none(positionals);

package/lib/format.mjs

@@ -1295,3 +1295,22 @@ export function goalsText(r) {
   }
   return lines.join("\n");
 }
+
+/** A project's Messages tab, as list_messages answers it: oldest first, one block a message. */
+export function messagesText(r) {
+  const list = r.messages ?? [];
+  if (!list.length)
+    return `No messages on ${r.project} yet. harbor messages "${r.project}" "TEXT" writes the first.`;
+  const head = r.more
+    ? [
+        `${r.more} earlier ${r.more === 1 ? "message" : "messages"} left out (--limit N shows more).`,
+      ]
+    : [];
+  return [
+    ...head,
+    ...list.map(
+      (m) =>
+        `${m.from ?? "Someone"} · ${m.at.slice(0, 16).replace("T", " ")}${m.edited ? " (edited)" : ""}\n  ${m.body.replace(/\n/g, "\n  ")}`,
+    ),
+  ].join("\n\n");
+}

package/package.json

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