@harborppm/cli 0.78.0 → 0.80.0

package/dist/app.mjs

@@ -5913,7 +5913,7 @@ const STATUS_ORDER = [
 	"review",
 	"done"
 ];
-const PRIORITIES$1 = [
+const PRIORITIES$2 = [
 	"low",
 	"medium",
 	"high",
@@ -5938,7 +5938,7 @@ function isLate(task, today) {
 function myOpenTasks(data, personId, today) {
 	const mine = data.tasks.filter((t) => t.assigneeId === personId && t.status !== "done");
 	const rank = (t) => isLate(t, today) ? 0 : t.dueDate ? 1 : 2;
-	return mine.sort((a, b) => rank(a) - rank(b) || (a.dueDate ?? "").localeCompare(b.dueDate ?? "") || PRIORITIES$1.indexOf(b.priority) - PRIORITIES$1.indexOf(a.priority));
+	return mine.sort((a, b) => rank(a) - rank(b) || (a.dueDate ?? "").localeCompare(b.dueDate ?? "") || PRIORITIES$2.indexOf(b.priority) - PRIORITIES$2.indexOf(a.priority));
 }
 /** Others' open tasks that wait on one of this person's. */
 function waitingOnMe(data, personId) {
@@ -9834,6 +9834,7 @@ init_work();
 init_clock();
 init_soundings();
 const KIND_RANK = {
+	harbor: -1,
 	waiting: 0,
 	approval: 1,
 	review: 2,
@@ -9843,6 +9844,7 @@ const KIND_RANK = {
 	mention: 6
 };
 const PING_KIND_LABEL = {
+	harbor: "Your harbor",
 	waiting: "Waiting on you",
 	approval: "Sign-offs",
 	review: "Reviews due",
@@ -9882,6 +9884,19 @@ function inboxOf(data, personId, now = clockNow()) {
 	const pings = [];
 	const mine = data.tasks.filter((t) => t.assigneeId === personId && t.status !== "done");
 	const since = subDays(now, ASSIGNED_DAYS).toISOString();
+	const me = data.people.find((p) => p.id === personId);
+	if (me?.harborHandedAt && me.harborHandedAt >= since && me.harborHandedById !== personId) {
+		const by = data.people.find((p) => p.id === me.harborHandedById);
+		pings.push({
+			id: `harbor:${me.harborHandedAt}`,
+			kind: "harbor",
+			title: `${by ? firstName$3(by.name) : "The owner"} handed this harbor to you`,
+			detail: "You own it now: invites, roles, billing, webhooks and the whole-harbor download. Settings has them all.",
+			at: me.harborHandedAt,
+			personId: by?.id ?? null,
+			href: "/settings"
+		});
+	}
 	for (const task of mine) {
 		if (!task.assignedBy || task.assignedBy === personId || !task.assignedAt) continue;
 		if (task.assignedAt < since) continue;
@@ -13220,6 +13235,7 @@ const PAGES = {
 	projects: "/projects",
 	risks: "/risks",
 	goals: "/goals",
+	reports: "/reports",
 	calendar: "/calendar",
 	people: "/people"
 };
@@ -13744,6 +13760,269 @@ function keyResultText(kr, work) {
 }
 const fmt = (n) => Number.isInteger(n) ? n.toLocaleString("en-US") : String(Math.round(n * 100) / 100);
 
+// src/lib/reports.ts
+init_date_fns();
+init_date_text();
+init_indexes();
+init_swatches();
+/** Weeks a "by week" chart shows: back from this week, or ahead for due dates. */
+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 MEASURE_LABEL = {
+	open: "Open tasks",
+	done: "Finished tasks",
+	all: "All tasks",
+	overdue: "Overdue tasks",
+	hours: "Hours logged"
+};
+const GROUP_LABEL = {
+	status: "Status",
+	owner: "Owner",
+	priority: "Priority",
+	project: "Project",
+	program: "Program",
+	week: "Week"
+};
+/** The splits a measure can take: hours have no status or priority of their own. */
+function groupsFor(measure) {
+	return measure === "hours" ? [
+		"owner",
+		"project",
+		"program",
+		"week"
+	] : GROUPS;
+}
+const STATUS_FILL = {
+	backlog: "var(--color-swatch-slate)",
+	todo: "var(--color-swatch-sand)",
+	doing: "var(--color-swatch-sea)",
+	review: "var(--color-swatch-rust)",
+	done: "var(--color-swatch-moss)"
+};
+const PRIORITY_FILL = {
+	low: "var(--color-swatch-slate)",
+	medium: "var(--color-swatch-sea)",
+	high: "var(--color-swatch-sand)",
+	urgent: "var(--color-swatch-coral)"
+};
+const PRIORITIES$1 = [
+	"urgent",
+	"high",
+	"medium",
+	"low"
+];
+/** Colours handed out in turn where a slice has none of its own. */
+const CYCLE = [
+	"sea",
+	"sand",
+	"moss",
+	"rust",
+	"slate",
+	"pine",
+	"clay",
+	"sage"
+];
+const swatchFill = (s) => `var(--color-swatch-${s})`;
+/** The Monday on or before a day or moment (ISO, read in local time), or "" when it isn't a date. */
+function mondayOf(day) {
+	const d = parseIso(day.length > 10 ? day : `${day}T12:00:00`);
+	if (Number.isNaN(d.getTime())) return "";
+	const back = (d.getDay() + 6) % 7;
+	return format(addDays(d, -back), "yyyy-MM-dd");
+}
+/** The projects a chart reads: everything, or what sits under its scope. */
+function scopeOf(data, scopeId) {
+	if (!scopeId) return {
+		projectIds: null,
+		name: "Whole harbor",
+		found: true
+	};
+	const project = byId(data.projects).get(scopeId);
+	if (project) return {
+		projectIds: /* @__PURE__ */ new Set([project.id]),
+		name: project.name,
+		found: true
+	};
+	const program = byId(data.programs).get(scopeId);
+	if (program) {
+		const ids = data.projects.filter((p) => p.programId === program.id).map((p) => p.id);
+		return {
+			projectIds: new Set(ids),
+			name: program.name,
+			found: true
+		};
+	}
+	const portfolio = byId(data.portfolios).get(scopeId);
+	if (portfolio) {
+		const programIds = new Set(data.programs.filter((p) => p.portfolioId === portfolio.id).map((p) => p.id));
+		const ids = data.projects.filter((p) => programIds.has(p.programId)).map((p) => p.id);
+		return {
+			projectIds: new Set(ids),
+			name: portfolio.name,
+			found: true
+		};
+	}
+	return {
+		projectIds: /* @__PURE__ */ new Set(),
+		name: "Deleted",
+		found: false
+	};
+}
+/**
+* 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.
+*/
+function chartData(chart, data, today) {
+	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 items = [];
+	for (const task of data.tasks) {
+		if (!inScope(task)) continue;
+		const done = task.status === "done";
+		switch (chart.measure) {
+			case "open":
+				if (!done) items.push({
+					task,
+					amount: 1,
+					day: task.dueDate
+				});
+				break;
+			case "done":
+				if (done) items.push({
+					task,
+					amount: 1,
+					day: task.completedAt
+				});
+				break;
+			case "all":
+				items.push({
+					task,
+					amount: 1,
+					day: task.createdAt
+				});
+				break;
+			case "overdue":
+				if (!done && task.dueDate && task.dueDate.slice(0, 10) < today) items.push({
+					task,
+					amount: 1,
+					day: task.dueDate
+				});
+				break;
+			case "hours": for (const entry of task.time ?? []) items.push({
+				task,
+				amount: entry.minutes / 60,
+				day: entry.on,
+				personId: entry.personId
+			});
+		}
+	}
+	const projects = byId(data.projects);
+	const programs = byId(data.programs);
+	const people = byId(data.people);
+	const sums = /* @__PURE__ */ new Map();
+	const add = (key, amount) => sums.set(key, (sums.get(key) ?? 0) + amount);
+	let weeks = [];
+	if (groupBy === "week") {
+		const thisWeek = mondayOf(today);
+		const ahead = chart.measure === "open";
+		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`);
+		weeks = Array.from({ length: count }, (_, i) => format(addDays(start, 7 * i), "yyyy-MM-dd"));
+		const known = new Set(weeks);
+		for (const item of items) {
+			if (!item.day) continue;
+			const week = mondayOf(item.day);
+			if (known.has(week)) add(week, item.amount);
+			else if (ahead && week < first) add(first, 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 round = (n) => unit === "hours" ? Math.round(n * 10) / 10 : n;
+	let slices;
+	if (groupBy === "week") slices = weeks.map((w) => ({
+		key: w,
+		label: format(parseIso(`${w}T12:00:00`), "MMM d"),
+		value: round(sums.get(w) ?? 0),
+		fill: "var(--color-primary)"
+	}));
+	else if (groupBy === "status") slices = TASK_COLUMNS.filter((s) => sums.has(s)).map((s) => ({
+		key: s,
+		label: TASK_STATUS_LABEL[s],
+		value: round(sums.get(s)),
+		fill: STATUS_FILL[s]
+	}));
+	else if (groupBy === "priority") slices = PRIORITIES$1.filter((p) => sums.has(p)).map((p) => ({
+		key: p,
+		label: PRIORITY_LABEL[p],
+		value: round(sums.get(p)),
+		fill: PRIORITY_FILL[p]
+	}));
+	else {
+		const named = [...sums.entries()].map(([key, value], i) => {
+			if (groupBy === "owner") {
+				const person = key ? people.get(key) : void 0;
+				return {
+					key: key || "nobody",
+					label: key ? person?.name ?? "Former member" : "Nobody",
+					value: round(value),
+					fill: key ? swatchFill(CYCLE[i % CYCLE.length]) : "var(--color-swatch-slate)"
+				};
+			}
+			const thing = groupBy === "project" ? projects.get(key) : programs.get(key);
+			return {
+				key: key || "none",
+				label: thing?.name ?? "Deleted",
+				value: round(value),
+				fill: thing?.swatch ? swatchFill(thing.swatch) : swatchFill(CYCLE[i % CYCLE.length])
+			};
+		});
+		named.sort((a, b) => b.value - a.value || a.label.localeCompare(b.label));
+		if (named.length > 12) {
+			const rest = named.slice(11);
+			slices = [...named.slice(0, 11), {
+				key: "rest",
+				label: `Everything else (${rest.length})`,
+				value: round(rest.reduce((n, s) => n + s.value, 0)),
+				fill: "var(--color-swatch-slate)"
+			}];
+		} else slices = named;
+	}
+	const total = round(slices.reduce((n, s) => n + s.value, 0));
+	return {
+		slices,
+		total,
+		unit,
+		scopeName: scope.name,
+		scopeFound: scope.found
+	};
+}
+/** "12 tasks", "1 task", "7.5 hours". */
+function amountText(value, unit) {
+	if (unit === "hours") return `${value} ${value === 1 ? "hour" : "hours"}`;
+	return `${value} ${value === 1 ? "task" : "tasks"}`;
+}
+/** 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)})`;
+}
+
 // node_modules/zod/v4/core/util.js
 function getEnumValues(entries) {
 	const numericValues = Object.values(entries).filter((v) => typeof v === "number");
@@ -18941,7 +19220,7 @@ init_blockers();
 init_format();
 init_indexes();
 const noon = (iso) => /* @__PURE__ */ new Date(`${iso.slice(0, 10)}T12:00:00`);
-const days$1 = (from, to) => differenceInCalendarDays(noon(to), noon(from));
+const days$2 = (from, to) => differenceInCalendarDays(noon(to), noon(from));
 const later = (a, b) => !a ? b : !b ? a : a >= b ? a : b;
 const open = (t) => t.status !== "done";
 /** True when `a` finishes later than `b`, or as late behind a longer line. */
@@ -19008,7 +19287,7 @@ function linksOf(line, walk, target, today) {
 			task,
 			finish,
 			late: Boolean(task.dueDate && task.dueDate.slice(0, 10) < today),
-			slack: against ? days$1(finish, against) : null
+			slack: against ? days$2(finish, against) : null
 		};
 	});
 }
@@ -19020,7 +19299,7 @@ function chainOf(line, walk, target, today) {
 		links,
 		finish,
 		target,
-		over: target ? days$1(target, finish) : null,
+		over: target ? days$2(target, finish) : null,
 		undated: 0
 	};
 }
@@ -19101,17 +19380,17 @@ function milestonePole(milestone, data, now) {
 	const others = runs.slice(1).map((r) => ({
 		project: r.project,
 		finish: r.finish,
-		slack: days$1(r.finish, due)
+		slack: days$2(r.finish, due)
 	}));
 	return {
 		kind: "chain",
 		links: first.pole.kind === "chain" ? first.pole.links.map((l, i, all) => i === all.length - 1 ? {
 			...l,
-			slack: days$1(l.finish, due)
+			slack: days$2(l.finish, due)
 		} : l) : [],
 		finish: first.finish,
 		target: due,
-		over: days$1(due, first.finish),
+		over: days$2(due, first.finish),
 		via: {
 			project: first.project,
 			finish: first.finish
@@ -19194,7 +19473,8 @@ function pickData(s) {
 		spendEntries: s.spendEntries ?? NONE,
 		reflections: s.reflections ?? NONE,
 		priorityRules: s.priorityRules ?? null,
-		workCalendar: s.workCalendar ?? null
+		workCalendar: s.workCalendar ?? null,
+		dashboards: s.dashboards ?? NONE
 	};
 }
 /** The document as sent to the server: normalized and without inline file data. */
@@ -21420,6 +21700,67 @@ 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,
+		input: object({
+			harbor: harborArg,
+			dashboard: string().max(200).optional().describe("Dashboard id or name. Default: all.")
+		}),
+		run: (ctx, input) => {
+			const { data } = ctx;
+			const today = todayISO(ctx.now);
+			const all = data.dashboards ?? [];
+			return { dashboards: (input.dashboard ? [findOne(all, input.dashboard, "dashboard")] : all).map((d) => ({
+				id: d.id,
+				name: d.name,
+				charts: d.charts.map((c) => {
+					const result = chartData(c, data, today);
+					return {
+						id: c.id,
+						title: c.title,
+						counts: MEASURE_LABEL[c.measure],
+						splitBy: GROUP_LABEL[c.groupBy],
+						view: c.view,
+						from: result.scopeName,
+						total: amountText(result.total, result.unit),
+						values: result.slices.map((s) => ({
+							label: s.label,
+							value: s.value
+						})),
+						text: chartText(c.title, result)
+					};
+				})
+			})) };
+		}
+	}),
+	tool({
+		name: "list_task_templates",
+		title: "Task templates",
+		description: "A project's task templates (or every project's), to start new tasks from with create_task's template: each one's name, the title and notes it gives, its priority, owner, checklist and how many days after it's made the task is due." + DATA_NOTE,
+		input: object({
+			harbor: harborArg,
+			project: string().max(200).optional().describe("Project id or name. Default: all.")
+		}),
+		run: (ctx, input) => {
+			const { data } = ctx;
+			const projects = input.project ? [findOne(data.projects, input.project, "project")] : data.projects.filter((p) => p.taskTemplates?.length);
+			const name = (id) => id ? data.people.find((p) => p.id === id)?.name ?? null : null;
+			return { templates: projects.flatMap((p) => (p.taskTemplates ?? []).map((t) => ({
+				id: t.id,
+				name: t.name,
+				project: p.name,
+				title: t.title,
+				notes: t.description || void 0,
+				priority: t.priority,
+				owner: name(t.assigneeId),
+				alsoOn: (t.followerIds ?? []).map(name).filter(Boolean),
+				checklist: t.checklist,
+				dueInDays: t.dueInDays
+			}))) };
+		}
+	}),
 	tool({
 		name: "long_pole",
 		title: "What's holding this up",
@@ -22231,7 +22572,8 @@ var init_undo = __esmMin((() => {
 		"attachments",
 		"checkIns",
 		"spendEntries",
-		"reflections"
+		"reflections",
+		"dashboards"
 	];
 	FOLD_MS = 5e3;
 	LEAD = [
@@ -22598,6 +22940,9 @@ function hierarchySlice({ get, write }) {
 				...patch
 			} : p) });
 		},
+		setDashboards: (dashboards) => {
+			write({ dashboards });
+		},
 		updateProgram: (id, patch) => {
 			write({ programs: get().programs.map((p) => p.id === id ? {
 				...p,
@@ -22927,6 +23272,16 @@ var init_github_refs = __esmMin((() => {
 }));
 
 // src/lib/automations.ts
+/** Whether a task meets the rule's "only if" line. */
+function meetsCondition(rule, task) {
+	const c = rule.onlyIf;
+	if (!c) return true;
+	if (c.priority && task.priority !== c.priority) return false;
+	if (c.assignee) {
+		if (c.assignee === "nobody" ? task.assigneeId != null : task.assigneeId !== c.assignee) return false;
+	}
+	return true;
+}
 /**
 * Checked once, against the (before, after) pair of a single user-driven
 * mutation — never re-checked against an automation's own effect. That's the
@@ -22944,6 +23299,64 @@ function matches(rule, prev, next, created) {
 		default: return false;
 	}
 }
+/** One rule's actions on one task, in order. */
+function runActions(actions, start, ctx) {
+	let task = start;
+	const comments = [];
+	for (const action of actions) switch (action.type) {
+		case "set_status": {
+			if (!action.status) break;
+			const wasDone = task.status === "done";
+			const completedAt = action.status === "done" ? task.completedAt ?? ctx.now : wasDone ? null : task.completedAt;
+			task = {
+				...task,
+				status: action.status,
+				completedAt
+			};
+			break;
+		}
+		case "set_priority":
+			if (action.priority) task = {
+				...task,
+				priority: action.priority
+			};
+			break;
+		case "set_assignee":
+			task = {
+				...task,
+				assigneeId: action.assigneeId ?? null
+			};
+			break;
+		case "set_due": {
+			const n = Math.min(365, Math.max(0, Math.round(action.inDays ?? 0)));
+			task = {
+				...task,
+				dueDate: dayAfter(ctx.today, n)
+			};
+			break;
+		}
+		case "add_follower": {
+			const id = action.personId;
+			if (!id || id === task.assigneeId || task.followerIds?.includes(id)) break;
+			task = {
+				...task,
+				followerIds: [...task.followerIds ?? [], id]
+			};
+			break;
+		}
+		case "add_comment": if (action.commentBody?.trim()) comments.push({
+			taskId: task.id,
+			authorId: ctx.authorId,
+			body: action.commentBody.trim(),
+			createdAt: ctx.now,
+			mentionedIds: []
+		});
+	}
+	return {
+		task,
+		comments
+	};
+}
 /**
 * Applies every enabled rule on `project` whose trigger matches this one
 * mutation (`prev` -> `next`, or `prev` undefined for a brand-new task) and
@@ -22954,49 +23367,32 @@ function matches(rule, prev, next, created) {
 function applyAutomations(project, prev, next, opts) {
 	const rules = project?.automations ?? [];
 	const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+	const today = opts.now ? opts.now.slice(0, 10) : todayISO();
+	const ctx = {
+		authorId: opts.currentUserId,
+		now,
+		today
+	};
 	let task = next;
 	const comments = [];
 	for (const rule of rules) {
-		if (!matches(rule, prev, next, opts.created)) continue;
-		for (const action of rule.actions) switch (action.type) {
-			case "set_status": {
-				if (!action.status) break;
-				const wasDone = task.status === "done";
-				const completedAt = action.status === "done" ? task.completedAt ?? now : wasDone ? null : task.completedAt;
-				task = {
-					...task,
-					status: action.status,
-					completedAt
-				};
-				break;
-			}
-			case "set_priority":
-				if (action.priority) task = {
-					...task,
-					priority: action.priority
-				};
-				break;
-			case "set_assignee":
-				task = {
-					...task,
-					assigneeId: action.assigneeId ?? null
-				};
-				break;
-			case "add_comment": if (action.commentBody?.trim()) comments.push({
-				taskId: task.id,
-				authorId: opts.currentUserId,
-				body: action.commentBody.trim(),
-				createdAt: now,
-				mentionedIds: []
-			});
-		}
+		if (!matches(rule, prev, next, opts.created) || !meetsCondition(rule, next)) continue;
+		const ran = runActions(rule.actions, task, ctx);
+		task = ran.task;
+		comments.push(...ran.comments);
 	}
 	return {
 		task,
 		comments
 	};
 }
-var init_automations = __esmMin((() => {}));
+var dayAfter;
+var init_automations = __esmMin((() => {
+	init_date_fns();
+	init_date_text();
+	init_format();
+	dayAfter = (day, n) => format(addDays(parseIso(day), n), "yyyy-MM-dd");
+}));
 
 // src/lib/focus.ts
 function focusIdsOf(data, personId, date = todayISO()) {
@@ -24484,7 +24880,7 @@ function pickCollections(doc, keys) {
 function emptyRows() {
 	return Object.fromEntries(ROW_COLLECTIONS.map((k) => [k, []]));
 }
-/** A collection as rows; `spendEntries`, `reflections`, `priorityRules` and `workCalendar` may be missing from older documents. */
+/** A collection as rows; `spendEntries`, `reflections`, `priorityRules`, `workCalendar` and `dashboards` may be missing from older documents. */
 function rowsOf(doc, key) {
 	if (isKeyed(key)) return KEYED[key].rows(doc[key]);
 	return doc[key] ?? [];
@@ -24569,7 +24965,8 @@ var init_changes = __esmMin((() => {
 		"spendEntries",
 		"reflections",
 		"priorityRules",
-		"workCalendar"
+		"workCalendar",
+		"dashboards"
 	];
 	ROW_COLLECTIONS = [
 		"tasks",
@@ -24590,7 +24987,8 @@ var init_changes = __esmMin((() => {
 		"ropes",
 		"readPingIds",
 		"priorityRules",
-		"workCalendar"
+		"workCalendar",
+		"dashboards"
 	];
 	KEYED = {
 		boardConfigs: {
@@ -28389,7 +28787,7 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 		if (input === "p" && mode !== "budget") return go.pick("Show cards of priority", [{
 			label: "Any priority",
 			value: "any"
-		}, ...PRIORITIES$1.map((p) => ({
+		}, ...PRIORITIES$2.map((p) => ({
 			label: PRIORITY_LABEL[p],
 			value: p
 		}))], (priority) => setFilter((f) => ({
@@ -29009,13 +29407,18 @@ const TRIGGER_LABEL = {
 	task_created: "A task is created",
 	status_changed_to: "Status is set to…",
 	priority_changed_to: "Priority is set to…",
-	assigned: "A task is assigned to anyone"
+	assigned: "A task is assigned to anyone",
+	due_soon: "A task is due soon",
+	overdue: "A task becomes overdue",
+	untouched: "A task sits untouched"
 };
 const ACTION_LABEL = {
 	set_status: "Set status to…",
 	set_priority: "Set priority to…",
 	set_assignee: "Assign to…",
-	add_comment: "Post a comment"
+	add_comment: "Post a comment",
+	set_due: "Move the due date",
+	add_follower: "Add a follower"
 };
 function describeAction(a, peopleName) {
 	switch (a.type) {
@@ -29023,18 +29426,36 @@ function describeAction(a, peopleName) {
 		case "set_priority": return `set priority to ${a.priority ? PRIORITY_LABEL[a.priority] : "…"}`;
 		case "set_assignee": return `assign to ${peopleName(a.assigneeId)}`;
 		case "add_comment": return `post “${a.commentBody ?? ""}”`;
+		case "set_due": {
+			const n = a.inDays ?? 0;
+			return n === 0 ? "set the due date to that day" : `set the due date ${n} ${n === 1 ? "day" : "days"} out`;
+		}
+		case "add_follower": return `add ${peopleName(a.personId)} as a follower`;
 	}
 }
+const days$1 = (n) => `${n} ${n === 1 ? "day" : "days"}`;
 function describeTrigger(rule) {
 	const t = rule.trigger;
 	if (t.type === "status_changed_to") return `When status is set to ${t.status ? TASK_STATUS_LABEL[t.status] : "…"}`;
 	if (t.type === "priority_changed_to") return `When priority is set to ${t.priority ? PRIORITY_LABEL[t.priority] : "…"}`;
+	if (t.type === "due_soon") return `When a task is due within ${days$1(t.days ?? 2)}`;
+	if (t.type === "untouched") return `When nobody touches a task for ${days$1(t.days ?? 7)}`;
 	return `When ${TRIGGER_LABEL[t.type].toLowerCase()}`;
 }
+/** The "only if" line: "only High priority, owned by Ana", or "" when there's none. */
+function describeCondition(rule, peopleName) {
+	const c = rule.onlyIf;
+	if (!c) return "";
+	const parts = [];
+	if (c.priority) parts.push(`${PRIORITY_LABEL[c.priority]} priority`);
+	if (c.assignee) parts.push(c.assignee === "nobody" ? "with no owner" : `owned by ${peopleName(c.assignee)}`);
+	return parts.length ? `only ${parts.join(", ")}` : "";
+}
 /** "When status is set to Done: set priority to Low, post “Shipped”". */
 function describeRule(rule, peopleName) {
 	const did = rule.actions.map((a) => describeAction(a, peopleName)).join(", ");
-	return `${describeTrigger(rule)}: ${did || "no actions"}`;
+	const only = describeCondition(rule, peopleName);
+	return `${describeTrigger(rule)}${only ? ` (${only})` : ""}: ${did || "no actions"}`;
 }
 function defaultAction(type) {
 	if (type === "set_status") return {
@@ -29049,6 +29470,14 @@ function defaultAction(type) {
 		type,
 		assigneeId: null
 	};
+	if (type === "set_due") return {
+		type,
+		inDays: 3
+	};
+	if (type === "add_follower") return {
+		type,
+		personId: null
+	};
 	return {
 		type,
 		commentBody: ""
@@ -29088,6 +29517,7 @@ function readFieldValue(def, text) {
 * starts from, each column (name, shown, cap, place), lanes and what cards
 * show, the project's own fields and its automations. b on a project opens it.
 */
+init_automations();
 init_board();
 init_swatches();
 const LANES = [
@@ -29122,7 +29552,7 @@ const statusChoices = () => TASK_COLUMNS.map((s) => ({
 	label: TASK_STATUS_LABEL[s],
 	value: s
 }));
-const priorityChoices = () => PRIORITIES$1.map((p) => ({
+const priorityChoices = () => PRIORITIES$2.map((p) => ({
 	label: PRIORITY_LABEL[p],
 	value: p
 }));
@@ -29376,6 +29806,14 @@ function BoardPanel({ id, width, height, go, active, onClose }) {
 			type,
 			priority: p
 		}));
+		if (type === "due_soon" || type === "untouched") return go.ask(type === "due_soon" ? "Due within how many days?" : "Untouched for how many days?", (text) => {
+			const n = Math.round(Number(text.trim()));
+			if (!Number.isFinite(n) || n < 1) return;
+			askAction({
+				type,
+				days: Math.min(60, n)
+			});
+		});
 		askAction({ type });
 	}
 	function askAction(trigger) {
@@ -29409,6 +29847,21 @@ function BoardPanel({ id, width, height, go, active, onClose }) {
 				...defaultAction(type),
 				assigneeId: pid
 			}));
+			if (type === "set_due") return go.ask("Set the due date how many days out?", (text) => {
+				const n = Math.round(Number(text.trim()));
+				if (Number.isFinite(n) && n >= 0) add({
+					type,
+					inDays: Math.min(365, n)
+				});
+			});
+			if (type === "add_follower") return go.pick("Add as a follower", people.map((p) => ({
+				label: p.name,
+				value: p.id,
+				hint: p.role
+			})), (pid) => add({
+				type,
+				personId: pid
+			}));
 			go.ask("Comment to post", (text) => text.trim() && add({
 				type,
 				commentBody: text.trim()
@@ -29807,11 +30260,11 @@ function TaskPanel({ taskId, width, height, go, active = true, onClose }) {
 			});
 		} else if (f === "priority") editor = /* @__PURE__ */ jsx(Picker, {
 			title: "Priority",
-			choices: PRIORITIES$1.map((p) => ({
+			choices: PRIORITIES$2.map((p) => ({
 				label: PRIORITY_LABEL[p],
 				value: p
 			})),
-			initial: PRIORITIES$1.indexOf(task.priority),
+			initial: PRIORITIES$2.indexOf(task.priority),
 			onCancel: done,
 			onPick: (p) => {
 				store.getState().updateTask(task.id, { priority: p });

package/lib/cli.mjs

@@ -40,6 +40,7 @@ import {
   followedText,
   soundingsText,
   goalsText,
+  templatesText,
   thanksText,
   ashoreText,
   voyageText,
@@ -166,7 +167,7 @@ export const HELP = `harbor: Harbor from the terminal
                      [--also "NAME, NAME"] [--due DATE|pilot]
                      [--priority low|medium|high|urgent]
                      [--status S] [--comment TEXT] [--over-limit] [--dry-run]
-                     [--literal]
+                     [--literal] [--template NAME]
                                               reads plain words in TITLE as the
                                               website does: @name, by friday,
                                               !high, #project (--literal: keep
@@ -263,6 +264,10 @@ export const HELP = `harbor: Harbor from the terminal
                                               the ones waiting on your answer
   harbor goals [PORTFOLIO]                    each portfolio's goals, how far
                                               along and whether on track
+  harbor templates [PROJECT]                  the task templates new tasks
+                                              start from (harbor add --template)
+  harbor template TASK [--name NAME]          save a task as a template in its
+                                              project
   harbor ashore [--weeks N] [--country CODES|none] [--person NAME]
                                               public holidays and time away
                                               coming up, and whose holidays
@@ -557,17 +562,30 @@ async function readTitles(client, harbor, titles, values, today = todayLocal())
   });
 }
 
-/** What a title's words said, in a line: "Quinn (@Quinn), due 2026-11-06 (by Friday)". */
+/** "Fri 2026-11-13": a day with its weekday, so "next friday" shows which Friday it became. */
+export function dayWithWeekday(iso) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(iso)) return iso;
+  const day = WEEKDAYS[new Date(`${iso}T12:00:00`).getDay()];
+  return day ? `${day.charAt(0).toUpperCase()}${day.slice(1, 3)} ${iso}` : iso;
+}
+
+/** What a title's words said, in a line: "Quinn (@Quinn), due Fri 2026-11-06 (by Friday)". */
 function wordsLine(r) {
   const bits = [
     r.owner && `${r.owner.value} (${r.owner.text})`,
-    r.due && `due ${r.due.value} (${r.due.text})`,
+    r.due && `due ${dayWithWeekday(r.due.value)} (${r.due.text})`,
     r.priority && `${r.priority.value} priority (${r.priority.text})`,
     r.project && `in ${r.project.value} (${r.project.text})`,
   ].filter(Boolean);
   return bits.length ? `Read from your words: ${bits.join(", ")}.` : null;
 }
 
+/** --due given in words rather than as a date or +N, when it reads as a day. */
+function dueWords(v) {
+  if (typeof v !== "string" || /^(\d{4}-\d{2}-\d{2}|\+\d{1,3})$/.test(v) || PILOT.has(v.toLowerCase())) return false;
+  return /^\d{4}-\d{2}-\d{2}$/.test(dueDate(v));
+}
+
 /** --due pilot: the date the owner's queue suggests, set by Harbor. */
 const PILOT = new Set(["pilot", "suggested"]);
 const duePilot = (v) => (v !== undefined && PILOT.has(v.toLowerCase()) ? true : undefined);
@@ -755,6 +773,11 @@ const DETAIL = {
     "  ten lines with --comment add the same comment to all ten. More than 100",
     "  lines is harbor import's job.",
     "",
+    "  --template NAME starts from one of the project's task templates (save one",
+    "  with Save as template on a task, or harbor template TASK): its title,",
+    "  notes, priority, owner, others on it, checklist and due offset fill what",
+    "  the flags don't. Leave out TITLE to take the template's.",
+    "",
     "  --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",
@@ -1013,6 +1036,16 @@ const DETAIL = {
     "  these as days nobody works. Countries: AU BR CA DE ES FR GB IE IT MX NL",
     "  NZ US (national holidays only).",
   ],
+  templates: [
+    "  harbor templates [PROJECT]             reads: each project's task templates",
+    "                                         (all projects when left out)",
+    "  harbor template TASK [--name NAME]     writes: saves the task as a template",
+    "                                         in its project, named after it unless",
+    "                                         --name says otherwise",
+    "",
+    "  harbor add --project P --template NAME starts a task from one: its title,",
+    "  notes, priority, owner, others on it, checklist and due offset.",
+  ],
   goals: [
     "  harbor goals [PORTFOLIO]               reads: each portfolio's goals (all when",
     "                                         left out), off track first, with how far",
@@ -2465,12 +2498,15 @@ export async function run(argv, io = {}) {
       const { positionals, values, harbor } = parse(
         spec(
           ["over-limit", "dry-run", "literal"],
-          ["project", "assignee", "also", "due", "priority", "status", "comment"],
+          ["project", "assignee", "also", "due", "priority", "status", "comment", "template"],
         ),
       );
+      // --template with no title: the template's own title.
+      const fromTemplate = values.template !== undefined && positionals.length === 0;
       // Several at once: one title a line on stdin, with no title (or -) after add.
       const piped =
-        positionals.length === 0 || (positionals.length === 1 && positionals[0] === "-");
+        !fromTemplate &&
+        (positionals.length === 0 || (positionals.length === 1 && positionals[0] === "-"));
       const stdin = io.stdin ?? process.stdin;
       const titles =
         piped && (io.stdin || !process.stdin.isTTY)
@@ -2478,7 +2514,9 @@ export async function run(argv, io = {}) {
               .split(/\r?\n/)
               .map((l) => l.trim())
               .filter(Boolean)
-          : [text(positionals, "the task")];
+          : fromTemplate
+            ? [""]
+            : [text(positionals, "the task")];
       if (titles.length === 0)
         throw new HarborError("Say the task, or give one title a line on stdin.");
       if (titles.length > 100)
@@ -2487,7 +2525,7 @@ export async function run(argv, io = {}) {
         );
       // Plain words, as on the website: @person, by Friday, !high, #Project.
       // --literal keeps every title exactly as typed.
-      const reads = values.literal
+      const reads = values.literal || fromTemplate
         ? titles.map((title) => ({ title, owner: null, due: null, priority: null, project: null }))
         : await readTitles(client, harbor, titles, values);
       // No --project and no #Project: the harbor's one open project, if that's all there is.
@@ -2537,7 +2575,7 @@ export async function run(argv, io = {}) {
               [
                 `Would add ${n} to ${where.join(" and ")}:`,
                 ...reads.flatMap((r, i) => [
-                  `  ${r.title}${pilot ? `  (due ${pilot[i].earliest})` : values.due ? `  (due ${dueDate(values.due)})` : ""}`,
+                  `  ${r.title}${pilot ? `  (due ${pilot[i].earliest})` : values.due ? `  (due ${dueWords(values.due) ? dayWithWeekday(dueDate(values.due)) : dueDate(values.due)})` : ""}`,
                   ...(wordsLine(r) ? [`    ${wordsLine(r)}`] : []),
                 ]),
                 ...(pilot
@@ -2556,9 +2594,10 @@ export async function run(argv, io = {}) {
           .call("create_task", {
             harbor,
             project: projectOf(words),
-            title: words.title,
-            // Yours unless you say otherwise, as with n in the app.
-            assignee: values.assignee ?? words.owner?.value ?? "me",
+            title: words.title || undefined,
+            template: values.template,
+            // Yours unless you say otherwise, as with n in the app (a template keeps its own owner).
+            assignee: values.assignee ?? words.owner?.value ?? (values.template ? undefined : "me"),
             also: values.also === undefined ? undefined : alsoList(values.also),
             due: duePilot(values.due) ? undefined : (dueDate(values.due) ?? words.due?.value),
             suggestedDue: duePilot(values.due),
@@ -2598,6 +2637,8 @@ export async function run(argv, io = {}) {
                   `Added: ${taskLine(r.created, opts)}${r.comment ? ", with your comment" : ""}`,
                   // What the title's words said, so nothing is read without being seen.
                   ...(r.read ? [`${r.read} --literal keeps the words in the title.`] : []),
+                  // --due in words ("next friday"): the day it became, weekday and all.
+                  ...(dueWords(values.due) ? [`--due ${values.due}: ${dayWithWeekday(dueDate(values.due))}.`] : []),
                   // Pilot speaks up only when a date was given that the queue says won't hold.
                   ...(values.due ? pilotLines(r, r.created) : []),
                 ].join("\n"),
@@ -3175,6 +3216,23 @@ export async function run(argv, io = {}) {
         soundingsText(r),
       );
     }
+    case "templates": {
+      const { positionals, harbor } = parse(spec());
+      const project = positionals.join(" ").trim();
+      return call("list_task_templates", { harbor, ...(project ? { project } : {}) }, (r) =>
+        templatesText(r),
+      );
+    }
+    case "template": {
+      const { positionals, values, harbor } = parse(spec([], ["name"]));
+      const task = text(positionals, "the task");
+      return call(
+        "save_task_template",
+        { harbor, task, ...(values.name ? { name: values.name } : {}) },
+        (r) =>
+          `Saved “${r.template.name}” as a template in ${r.template.project}. harbor add --project "${r.template.project}" --template "${r.template.name}" starts a task from it.`,
+      );
+    }
     case "goals": {
       const { positionals, harbor } = parse(spec());
       const portfolio = positionals.join(" ").trim();

package/lib/format.mjs

@@ -1231,6 +1231,30 @@ export function catchupText(r) {
 }
 
 /** list_goals as text: each portfolio's goals, what needs attention first, with their key results. */
+/** harbor templates: each project's task templates, with what a new task takes from them. */
+export function templatesText(r) {
+  const list = r.templates ?? [];
+  if (!list.length)
+    return "No task templates yet. harbor template TASK saves one, or Save as template on a task on the website.";
+  const lines = [];
+  let project = null;
+  for (const t of list) {
+    if (t.project !== project) {
+      if (project !== null) lines.push("");
+      lines.push(t.project);
+      project = t.project;
+    }
+    const bits = [];
+    if (t.priority && t.priority !== "medium") bits.push(`${t.priority} priority`);
+    if (t.owner) bits.push(t.owner);
+    if (t.dueInDays != null)
+      bits.push(t.dueInDays === 0 ? "due the day it's made" : `due in ${t.dueInDays} ${t.dueInDays === 1 ? "day" : "days"}`);
+    if (t.checklist?.length) bits.push(`${t.checklist.length} checklist ${t.checklist.length === 1 ? "item" : "items"}`);
+    lines.push(`  ${t.name}${t.title !== t.name ? `: ${t.title}` : ""}${bits.length ? `  (${bits.join(", ")})` : ""}`);
+  }
+  return lines.join("\n");
+}
+
 export function goalsText(r) {
   const order = ["off-track", "at-risk", "not-started", "on-track", "achieved"];
   const withGoals = (r.portfolios ?? []).filter((p) => p.goals?.length);

package/package.json

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