@harborppm/cli 0.90.0 → 0.92.0

package/README.md

@@ -166,7 +166,8 @@ harbor project "NAME" --program P [--lead me|NAME] [--starts DATE]
                                             they really finished in that project
 harbor add "TITLE" --project P [--assignee me|NAME] [--also "NAME, NAME"] [--due DATE|pilot]
                    [--priority low|medium|high|urgent] [--status S] [--comment TEXT]
-                   [--over-limit] [--literal]   no TITLE: one title a line from stdin
+                   [--starts DATE] [--over-limit] [--literal]
+                                            no TITLE: one title a line from stdin
                                             --due pilot takes the earliest day the owner's queue
                                             suggests (their open work due first, weekly pace, time
                                             away, what it waits on, how long their similar tasks
@@ -174,7 +175,7 @@ harbor add "TITLE" --project P [--assignee me|NAME] [--also "NAME, NAME"] [--due
                                             their next working day. A date that won't hold says so
 harbor start TASK | submit TASK | done TASK [--confirm] [--over-limit]
 harbor edit TASK [--title T] [--assignee me|none|NAME] [--also "NAME, NAME"|none]
-                 [--due DATE|pilot|none]
+                 [--due DATE|pilot|none] [--starts DATE|none]
                  [--priority P] [--status S] [--notes TEXT]
                  [--repeat weekly|biweekly|monthly|never]
                  [--waits-on TASK,TASK|none] [--confirm] [--over-limit]

package/dist/app.mjs

@@ -3670,8 +3670,8 @@ init_date_text();
 init_format();
 init_indexes();
 init_premortem();
-const DAY = (iso) => parseIso(iso.slice(0, 10));
-const span$1 = (a, b) => differenceInCalendarDays(DAY(b), DAY(a));
+const DAY$1 = (iso) => parseIso(iso.slice(0, 10));
+const span$1 = (a, b) => differenceInCalendarDays(DAY$1(b), DAY$1(a));
 /** Projects marked Done that have tasks to copy, most recently finished first. */
 function finishedProjects(data) {
 	return data.projects.filter((p) => p.health === "done" && tasksOf(data.tasks, p.id).length > 0).map((p) => ({
@@ -3762,7 +3762,7 @@ function reckoningLine(r) {
 }
 /** The new project's end date, as long after its start as the old one really ran. */
 function reckonedEnd(r, startDate) {
-	return todayISO(addDays(DAY(startDate), r.took));
+	return todayISO(addDays(DAY$1(startDate), r.took));
 }
 /** Puts the reckoning's tasks and risks into the new project, dated from its start. */
 function applyReckoning(actions, projectId, r, startDate) {
@@ -3773,7 +3773,7 @@ function applyReckoning(actions, projectId, r, startDate) {
 		status: "todo",
 		priority: t.priority,
 		assigneeId: null,
-		dueDate: todayISO(addDays(DAY(startDate), t.dueIn))
+		dueDate: todayISO(addDays(DAY$1(startDate), t.dueIn))
 	}, {
 		allowOverCap: true,
 		allowBlocked: true
@@ -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",
@@ -13990,6 +14068,33 @@ function linkedProjects(kr, projects) {
 	if (ids.size === 0) return [];
 	return projects.filter((p) => ids.has(p.id) || ids.has(p.programId));
 }
+/**
+* The tasks a work key result counts: every task in the projects it names
+* (directly or through their program), and each task it names on its own,
+* each counted once however many ways it's linked.
+*/
+function workCount(kr, work) {
+	let done = 0;
+	let all = 0;
+	const seen = /* @__PURE__ */ new Set();
+	const count = (t) => {
+		if (seen.has(t.id)) return;
+		seen.add(t.id);
+		all++;
+		if (t.status === "done") done++;
+	};
+	const projects = linkedProjects(kr, work.projects);
+	for (const p of projects) for (const t of tasksOf(work.tasks, p.id)) count(t);
+	const tasks = byId(work.tasks);
+	for (const id of kr.linkIds ?? []) {
+		const t = tasks.get(id);
+		if (t) count(t);
+	}
+	return {
+		done,
+		all
+	};
+}
 /** How far along one key result is, 0 to 1. */
 function keyResultProgress(kr, work) {
 	if (kr.kind === "number") {
@@ -13998,12 +14103,7 @@ function keyResultProgress(kr, work) {
 		if (span === 0) return (kr.current ?? start) >= (kr.target ?? 0) ? 1 : 0;
 		return clamp(((kr.current ?? start) - start) / span);
 	}
-	let done = 0;
-	let all = 0;
-	for (const p of linkedProjects(kr, work.projects)) for (const t of tasksOf(work.tasks, p.id)) {
-		all++;
-		if (t.status === "done") done++;
-	}
+	const { done, all } = workCount(kr, work);
 	return all === 0 ? 0 : done / all;
 }
 /** How far along a goal is: the average of its key results, 0 to 1. */
@@ -14012,10 +14112,12 @@ function goalProgress(goal, work) {
 	if (krs.length === 0) return 0;
 	return krs.reduce((sum, kr) => sum + keyResultProgress(kr, work), 0) / krs.length;
 }
-/** How much of the goal's time has gone by, 0 to 1, from when it was set to its due day. */
+/** The day a goal's clock starts: its start day, or the day it was set. */
+const goalStart = (goal) => goal.start || goal.createdAt.slice(0, 10);
+/** How much of the goal's time has gone by, 0 to 1, from its start day to its due day. */
 function timeGone(goal, today) {
 	if (!goal.due) return null;
-	const start = Date.parse(`${goal.createdAt.slice(0, 10)}T00:00:00Z`);
+	const start = Date.parse(`${goalStart(goal)}T00:00:00Z`);
 	const end = Date.parse(`${goal.due}T00:00:00Z`);
 	const now = Date.parse(`${today}T00:00:00Z`);
 	if (!Number.isFinite(start) || !Number.isFinite(end)) return null;
@@ -14033,6 +14135,7 @@ function goalStatus(progress, goal, today) {
 	const gone = timeGone(goal, today);
 	if (gone == null) return progress > 0 ? "on-track" : "not-started";
 	if (goal.due && today > goal.due) return "off-track";
+	if (today < goalStart(goal)) return "not-started";
 	if (progress === 0 && gone < .1) return "not-started";
 	const behind = gone - progress;
 	if (behind <= .1) return "on-track";
@@ -14045,18 +14148,94 @@ function keyResultText(kr, work) {
 		const unit = kr.unit ? ` ${kr.unit}` : "";
 		return `${fmt(kr.current ?? kr.start ?? 0)} of ${fmt(kr.target ?? 0)}${unit}`;
 	}
-	let done = 0;
-	let all = 0;
-	for (const p of linkedProjects(kr, work.projects)) for (const t of tasksOf(work.tasks, p.id)) {
-		all++;
-		if (t.status === "done") done++;
-	}
+	if (!kr.linkIds?.length) return "Nothing linked yet";
+	const { done, all } = workCount(kr, work);
 	return all === 0 ? "No tasks yet" : `${done} of ${all} tasks done`;
 }
 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();
@@ -14065,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",
@@ -14086,16 +14274,72 @@ const GROUP_LABEL = {
 	priority: "Priority",
 	project: "Project",
 	program: "Program",
-	week: "Week"
+	week: "Week",
+	severity: "Severity",
+	field: "A project field"
 };
-/** The splits a measure can take: hours have no status or priority of their own. */
+/** 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"
+};
+/** 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"
-	] : GROUPS;
+	];
+	if (isRaidMeasure(measure)) return [
+		"severity",
+		"owner",
+		"project",
+		"program",
+		"week"
+	];
+	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)",
@@ -14116,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",
@@ -14137,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
 	};
@@ -14153,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
 		};
@@ -14163,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,
@@ -14229,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`);
@@ -14244,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;
@@ -14268,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])
@@ -14298,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
@@ -19897,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();
@@ -20013,6 +20447,7 @@ function tasksCsv(data, projectId) {
 		"Blocked by",
 		"Description",
 		"Subtask of",
+		"Starts",
 		...fields.map((f) => f.name)
 	], tasks.map((t) => [
 		taskKey(t, project) ?? "",
@@ -20025,6 +20460,7 @@ function tasksCsv(data, projectId) {
 		blockerIds(t).map((id) => here.get(id)).filter((b) => Boolean(b)).map(name).join("; "),
 		t.description,
 		((p) => p ? name(p) : "")(parentOf(t, data.tasks)),
+		t.startDate ?? "",
 		...fields.map((f) => f.type === "url" ? safeLink(t.customFieldValues?.[f.id]) ?? "" : fieldValueText(f, t.customFieldValues?.[f.id], nameOf))
 	]));
 }
@@ -21449,6 +21885,7 @@ const HARBOR_TOOLS = [
 				position: boardPositions(data.tasks).get(t.id) ?? null,
 				priority: t.priority,
 				due: dayOf(t.dueDate),
+				...t.startDate ? { starts: dayOf(t.startDate) } : {},
 				assignee: nameOf$2(people, t.assigneeId),
 				...alsoOnOf(t, people),
 				project: project?.name ?? null,
@@ -22105,6 +22542,7 @@ const HARBOR_TOOLS = [
 			const today = todayISO(ctx.now);
 			const people = byId(data.people);
 			const named = byId([...data.programs, ...data.projects]);
+			const tasksById = byId(data.tasks);
 			return { portfolios: (input.portfolio ? [findOne(data.portfolios, input.portfolio, "portfolio")] : data.portfolios).map((pf) => ({
 				id: pf.id,
 				name: pf.name,
@@ -22115,6 +22553,7 @@ const HARBOR_TOOLS = [
 						id: g.id,
 						title: g.title,
 						owner: g.ownerId ? people.get(g.ownerId)?.name ?? null : null,
+						...g.start ? { start: g.start } : {},
 						due: g.due,
 						...g.why ? { why: g.why } : {},
 						progress: Math.round(progress * 100),
@@ -22131,7 +22570,7 @@ const HARBOR_TOOLS = [
 								target: kr.target,
 								current: kr.current ?? kr.start ?? 0
 							} : {
-								counts: (kr.linkIds ?? []).map((id) => named.get(id)?.name ?? id),
+								counts: (kr.linkIds ?? []).map((id) => named.get(id)?.name ?? tasksById.get(id)?.title ?? id),
 								projects: linkedProjects(kr, data.projects).length
 							}
 						}))
@@ -22143,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.")
@@ -22161,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,
@@ -23935,11 +24375,13 @@ function nextOccurrence(task, id, today, createdAt, siblings = []) {
 	if (!task.repeat) return null;
 	const dueDate = task.dueDate ? nextSeriesDate(task.dueDate, task.repeat, today) : nextDueDate(today, task.repeat);
 	if (siblings.some((t) => t.status !== "done" && t.repeat === task.repeat && t.title === task.title && (t.dueDate ?? "") >= dueDate)) return null;
+	const lead = task.startDate && task.dueDate ? differenceInCalendarDays(/* @__PURE__ */ new Date(`${task.dueDate.slice(0, 10)}T12:00:00`), /* @__PURE__ */ new Date(`${task.startDate.slice(0, 10)}T12:00:00`)) : null;
 	return {
 		...task,
 		id,
 		status: "todo",
 		dueDate,
+		...task.startDate ? { startDate: lead != null && lead >= 0 ? format(addDays(/* @__PURE__ */ new Date(`${dueDate}T12:00:00`), -lead), "yyyy-MM-dd") : null } : {},
 		createdAt,
 		completedAt: null,
 		blockedById: null,
@@ -23953,6 +24395,7 @@ function nextOccurrence(task, id, today, createdAt, siblings = []) {
 var REPEAT_LABEL, iso, step;
 var init_recurrence = __esmMin((() => {
 	init_date_fns();
+	init_date_text();
 	REPEAT_LABEL = {
 		weekly: "Every week",
 		biweekly: "Every two weeks",
@@ -24018,6 +24461,18 @@ var init_bulk = __esmMin((() => {
 	plural$2 = (n) => `${n} ${n === 1 ? "task" : "tasks"}`;
 }));
 
+// src/lib/task-start.ts
+function fitStart(start, due) {
+	const s = start ? start.slice(0, 10) : "";
+	if (!DAY.test(s)) return null;
+	const d = due ? due.slice(0, 10) : "";
+	return DAY.test(d) && s > d ? d : s;
+}
+var DAY;
+var init_task_start = __esmMin((() => {
+	DAY = /^\d{4}-\d{2}-\d{2}$/;
+}));
+
 // src/lib/slices/tasks.ts
 function tasksSlice({ set, get, write }) {
 	return {
@@ -24054,6 +24509,7 @@ function tasksSlice({ set, get, write }) {
 				completedAt: t.status === "done" ? t.completedAt ?? stamp() : null,
 				checklist: t.checklist ?? [],
 				..."parentTaskId" in t ? { parentTaskId } : {},
+				...t.startDate ? { startDate: fitStart(t.startDate, t.dueDate) } : {},
 				...blockersPatch(blockerIds({
 					id,
 					blockedById: t.blockedById,
@@ -24119,6 +24575,7 @@ function tasksSlice({ set, get, write }) {
 					...patch,
 					touchedAt: stamp()
 				};
+				if (next.startDate) next.startDate = fitStart(next.startDate, next.dueDate);
 				if (next.assigneeId && next.followerIds?.includes(next.assigneeId)) next.followerIds = alsoOnIds(next);
 				if (patch.status && patch.status !== row.status) {
 					if (patch.status === "done" && !patch.completedAt) next.completedAt = stamp();
@@ -24583,6 +25040,7 @@ var init_tasks = __esmMin((() => {
 	init_bulk();
 	init_task_people();
 	init_subtasks();
+	init_task_start();
 }));
 
 // src/lib/raid-history.ts
@@ -24608,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;
@@ -24640,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");
@@ -24656,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/lib/cli.mjs

@@ -165,7 +165,7 @@ export const HELP = `harbor: Harbor from the terminal
                                               --from: plan it from a finished
                                               project as that one really ran
   harbor add "TITLE" [--project P] [--assignee me|none|NAME]
-                     [--also "NAME, NAME"] [--due DATE|pilot]
+                     [--also "NAME, NAME"] [--due DATE|pilot] [--starts DATE]
                      [--priority low|medium|high|urgent]
                      [--status S] [--comment TEXT] [--over-limit] [--dry-run]
                      [--literal] [--template NAME] [--parent TASK]
@@ -181,6 +181,7 @@ export const HELP = `harbor: Harbor from the terminal
                                               or Done
   harbor edit TASK [--title T] [--assignee me|none|NAME]
                    [--also "NAME, NAME"|none] [--due DATE|pilot|none]
+                   [--starts DATE|none]
                    [--priority P] [--status S] [--notes TEXT]
                    [--repeat weekly|biweekly|monthly|never]
                    [--waits-on TASK,TASK|none] [--parent TASK|none]
@@ -705,7 +706,7 @@ export function hint(message, project) {
     )
     .replace(
       /^Nothing to change: pass a field to update\.$/,
-      "Nothing to change. Say what with --title, --assignee, --also, --due, --priority, --status, --notes, --repeat, --waits-on or --parent.",
+      "Nothing to change. Say what with --title, --assignee, --also, --due, --starts, --priority, --status, --notes, --repeat, --waits-on or --parent.",
     )
     .replace(
       /^This connection was allowed to read only\..*$/s,
@@ -790,6 +791,10 @@ const DETAIL = {
     "  own owner and date, shown in the parent's details rather than on the",
     "  board. It goes in the parent's project; subtasks go one level deep.",
     "",
+    "  --starts DATE gives it a start day as well as a due day, so the project's",
+    "  timeline draws it as a bar from one to the other; a start after the due",
+    "  day comes to the due day. harbor edit TASK --starts DATE|none moves it.",
+    "",
     "  --due pilot takes the earliest day the owner's queue suggests: their open",
     "  work due first, their weekly pace, time away, what it waits on and how",
     "  long their similar tasks took. It needs an owner (--assignee none is",
@@ -2293,6 +2298,7 @@ export async function run(argv, io = {}) {
           ),
         ];
         if (t.alsoOn?.length) lines.push(`Also on it: ${t.alsoOn.join(", ")}.`);
+        if (t.starts) lines.push(`Starts ${t.starts}${t.due ? `, due ${t.due}` : ""}.`);
         if (t.subtaskOf) lines.push(`Subtask of ${t.subtaskOf.key ?? t.subtaskOf.id}  ${t.subtaskOf.title}.`);
         if (t.repeats) lines.push(`Repeats ${REPEAT_WORD[t.repeats] ?? t.repeats}.`);
         for (const [name, v] of Object.entries(t.fields ?? {}))
@@ -2546,7 +2552,7 @@ export async function run(argv, io = {}) {
       const { positionals, values, harbor } = parse(
         spec(
           ["over-limit", "dry-run", "literal"],
-          ["project", "assignee", "also", "due", "priority", "status", "comment", "template", "parent"],
+          ["project", "assignee", "also", "due", "starts", "priority", "status", "comment", "template", "parent"],
         ),
       );
       // A subtask goes in its parent's project.
@@ -2652,6 +2658,7 @@ export async function run(argv, io = {}) {
             also: values.also === undefined ? undefined : alsoList(values.also),
             due: duePilot(values.due) ? undefined : (dueDate(values.due) ?? words.due?.value),
             suggestedDue: duePilot(values.due),
+            starts: dueDate(values.starts),
             priority: values.priority ?? words.priority?.value,
             status: values.status === undefined ? undefined : statusWord(values.status),
             parent: values.parent,
@@ -2775,6 +2782,7 @@ export async function run(argv, io = {}) {
             "assignee",
             "also",
             "due",
+            "starts",
             "priority",
             "status",
             "notes",
@@ -2798,6 +2806,7 @@ export async function run(argv, io = {}) {
               ? undefined
               : nullable(dueDate(values.due)),
           suggestedDue: duePilot(values.due),
+          starts: values.starts === undefined ? undefined : nullable(dueDate(values.starts)),
           priority: values.priority,
           status: values.status === undefined ? undefined : statusWord(values.status),
           description: values.notes,
@@ -2818,6 +2827,11 @@ export async function run(argv, io = {}) {
         (r) =>
           [
             `Updated: ${taskLine(r.updated, opts)}`,
+            values.starts !== undefined
+              ? r.updated.starts
+                ? `Starts ${r.updated.starts}${r.updated.due ? `, due ${r.updated.due}` : ""}.`
+                : "No start day now."
+              : null,
             values.parent !== undefined
               ? r.updated.subtaskOf
                 ? `A subtask of ${r.updated.subtaskOf}.`

package/package.json

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