@harborppm/cli 0.91.0 → 0.92.0

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)}`
@@ -11070,6 +11080,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 +11476,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 +11615,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 +14154,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 +14244,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 +14274,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 +14360,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 +14396,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 +14419,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 +14431,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();
 /**
-* 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.
+* 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,
+* 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 +14680,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 +14699,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 +14750,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 +14798,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 +20410,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();
@@ -22169,7 +22582,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 +22600,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 +25066,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 +25098,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 +25115,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");

package/package.json

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