@harborppm/cli 0.76.0 → 0.77.0

package/dist/app.mjs

@@ -128,10 +128,10 @@ function timeAgo(date, now = clockNow()) {
 	const words = `${n} ${unit}${n === 1 ? "" : "s"}`;
 	return diff > 0 ? `in ${words}` : `${words} ago`;
 }
-var MONTHS, DAYS$1, pad$1, TOKENS, TOKEN, ISO, MINUTE;
+var MONTHS$1, DAYS$2, pad$1, TOKENS, TOKEN, ISO, MINUTE;
 var init_date_text = __esmMin((() => {
 	init_clock();
-	MONTHS = [
+	MONTHS$1 = [
 		"January",
 		"February",
 		"March",
@@ -145,7 +145,7 @@ var init_date_text = __esmMin((() => {
 		"November",
 		"December"
 	];
-	DAYS$1 = [
+	DAYS$2 = [
 		"Sunday",
 		"Monday",
 		"Tuesday",
@@ -157,13 +157,13 @@ var init_date_text = __esmMin((() => {
 	pad$1 = (n, width = 2) => String(n).padStart(width, "0");
 	TOKENS = {
 		yyyy: (d) => pad$1(d.getFullYear(), 4),
-		MMMM: (d) => MONTHS[d.getMonth()],
-		MMM: (d) => MONTHS[d.getMonth()].slice(0, 3),
+		MMMM: (d) => MONTHS$1[d.getMonth()],
+		MMM: (d) => MONTHS$1[d.getMonth()].slice(0, 3),
 		MM: (d) => pad$1(d.getMonth() + 1),
 		dd: (d) => pad$1(d.getDate()),
 		d: (d) => String(d.getDate()),
-		EEEE: (d) => DAYS$1[d.getDay()],
-		EEE: (d) => DAYS$1[d.getDay()].slice(0, 3)
+		EEEE: (d) => DAYS$2[d.getDay()],
+		EEE: (d) => DAYS$2[d.getDay()].slice(0, 3)
 	};
 	TOKEN = /yyyy|MMMM|MMM|MM|dd|d|EEEE|EEE/g;
 	ISO = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:[.,](\d{1,9}))?)?(Z|[+-]\d{2}(?::?\d{2})?)?)?$/;
@@ -2270,11 +2270,11 @@ function easter(year) {
 function nth(year, month, dow, n) {
 	if (n > 0) {
 		const first = iso$4(year, month, 1);
-		const shift = (dow - weekday(first) + 7) % 7;
+		const shift = (dow - weekday$1(first) + 7) % 7;
 		return plus$1(first, shift + (n - 1) * 7);
 	}
 	const last = iso$4(year, month + 1, 0);
-	return plus$1(last, -((weekday(last) - dow + 7) % 7));
+	return plus$1(last, -((weekday$1(last) - dow + 7) % 7));
 }
 /** A country's public holidays in a year, by the day they're taken, oldest first. */
 function holidaysIn(country, year) {
@@ -2290,7 +2290,7 @@ function holidaysIn(country, year) {
 	const out = [];
 	for (const h of days) {
 		let date = h.date;
-		const wd = weekday(date);
+		const wd = weekday$1(date);
 		if (h.move === "us" && (wd === 0 || wd === 6)) date = plus$1(date, wd === 6 ? -1 : 1);
 		else if (h.move === "next" && (wd === 0 || wd === 6)) {
 			date = plus$1(date, 1);
@@ -2389,19 +2389,19 @@ function harborHolidays(data, from, to) {
 		};
 	});
 }
-var iso$4, weekday, plus$1, isWeekend, onOrBefore, fixed, fromEaster, MATARIKI, RULES, cache, PLAIN_CALENDAR;
+var iso$4, weekday$1, plus$1, isWeekend, onOrBefore, fixed, fromEaster, MATARIKI, RULES, cache, PLAIN_CALENDAR;
 var init_holidays = __esmMin((() => {
 	init_date_fns();
 	init_format();
 	init_countries();
 	iso$4 = (y, m, d) => todayISO(new Date(y, m - 1, d, 12));
-	weekday = (day) => (/* @__PURE__ */ new Date(`${day}T12:00:00`)).getDay();
+	weekday$1 = (day) => (/* @__PURE__ */ new Date(`${day}T12:00:00`)).getDay();
 	plus$1 = (day, n) => todayISO(addDays(/* @__PURE__ */ new Date(`${day}T12:00:00`), n));
 	isWeekend = (day) => {
-		const wd = weekday(day);
+		const wd = weekday$1(day);
 		return wd === 0 || wd === 6;
 	};
-	onOrBefore = (day, dow) => plus$1(day, -((weekday(day) - dow + 7) % 7));
+	onOrBefore = (day, dow) => plus$1(day, -((weekday$1(day) - dow + 7) % 7));
 	fixed = (m, d) => (y) => iso$4(y, m, d);
 	fromEaster = (n) => (y) => plus$1(easter(y), n);
 	MATARIKI = {
@@ -2499,7 +2499,7 @@ var init_holidays = __esmMin((() => {
 				fixed(1, 1),
 				"next"
 			],
-			["St Brigid's Day", (y) => weekday(iso$4(y, 2, 1)) === 5 ? iso$4(y, 2, 1) : nth(y, 2, 1, 1)],
+			["St Brigid's Day", (y) => weekday$1(iso$4(y, 2, 1)) === 5 ? iso$4(y, 2, 1) : nth(y, 2, 1, 1)],
 			[
 				"St Patrick's Day",
 				fixed(3, 17),
@@ -2611,7 +2611,7 @@ var init_holidays = __esmMin((() => {
 		NL: [
 			["Nieuwjaarsdag", fixed(1, 1)],
 			["Tweede paasdag", fromEaster(1)],
-			["Koningsdag", (y) => weekday(iso$4(y, 4, 27)) === 0 ? iso$4(y, 4, 26) : iso$4(y, 4, 27)],
+			["Koningsdag", (y) => weekday$1(iso$4(y, 4, 27)) === 0 ? iso$4(y, 4, 26) : iso$4(y, 4, 27)],
 			["Hemelvaartsdag", fromEaster(39)],
 			["Tweede pinksterdag", fromEaster(50)],
 			["Eerste kerstdag", fixed(12, 25)],
@@ -3753,6 +3753,359 @@ function applyReckoning(actions, projectId, r, startDate) {
 	};
 }
 
+// src/lib/plain-words.ts
+const DAYS$1 = [
+	"sunday",
+	"monday",
+	"tuesday",
+	"wednesday",
+	"thursday",
+	"friday",
+	"saturday"
+];
+const MONTHS = [
+	"january",
+	"february",
+	"march",
+	"april",
+	"may",
+	"june",
+	"july",
+	"august",
+	"september",
+	"october",
+	"november",
+	"december"
+];
+const NUMBER_WORDS = {
+	a: 1,
+	an: 1,
+	one: 1,
+	two: 2,
+	three: 3,
+	four: 4,
+	five: 5,
+	six: 6,
+	seven: 7,
+	eight: 8,
+	nine: 9,
+	ten: 10
+};
+const loose = (s) => s.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "");
+function shift(iso, days) {
+	const d = /* @__PURE__ */ new Date(`${iso}T12:00:00Z`);
+	d.setUTCDate(d.getUTCDate() + days);
+	return d.toISOString().slice(0, 10);
+}
+function weekday(iso) {
+	return (/* @__PURE__ */ new Date(`${iso}T12:00:00Z`)).getUTCDay();
+}
+function dayOf$1(y, m, d) {
+	const date = new Date(Date.UTC(y, m - 1, d, 12));
+	if (date.getUTCMonth() !== m - 1 || date.getUTCDate() !== d) return null;
+	return date.toISOString().slice(0, 10);
+}
+/** A month and day with no year: this year's, or next year's once it has passed. */
+function nextMonthDay(today, m, d) {
+	const year = Number(today.slice(0, 4));
+	const thisYear = dayOf$1(year, m, d);
+	if (!thisYear) return null;
+	return thisYear >= today ? thisYear : dayOf$1(year + 1, m, d);
+}
+const monthIndex = (word) => {
+	const w = word.toLowerCase().replace(/\.$/, "");
+	if (w.length < 3) return -1;
+	return MONTHS.findIndex((m) => m.startsWith(w) && (w.length >= 3 || m === w));
+};
+const DAY_WORD = "(?:sun|mon|tues?|wed(?:nes)?|thu(?:rs?)?|fri|sat(?:ur)?)(?:day)?";
+const MONTH_WORD = "(?:jan|feb|mar|apr|may|jun|jul|aug|sept?|oct|nov|dec)[a-z]*\\.?";
+/** Every way of saying a day, longest first so "next friday" wins over "friday". */
+const WHEN = [
+	"today",
+	"tonight",
+	"tomorrow",
+	"tmrw",
+	"the day after tomorrow",
+	"end of (?:the )?week",
+	"this week",
+	"next week",
+	"end of (?:the )?month",
+	"next month",
+	`in (?:\\d{1,2}|a|an|one|two|three|four|five|six|seven|eight|nine|ten) (?:days?|weeks?)`,
+	`(?:this |next |on )?${DAY_WORD}`,
+	`${MONTH_WORD} \\d{1,2}(?:st|nd|rd|th)?(?:,? \\d{4})?`,
+	`\\d{1,2}(?:st|nd|rd|th)? (?:of )?${MONTH_WORD}(?:,? \\d{4})?`,
+	"\\d{4}-\\d{1,2}-\\d{1,2}",
+	"\\d{1,2}/\\d{1,2}(?:/\\d{2,4})?"
+].join("|");
+const LEAD$1 = "(?:by|due|due on|due by|on|before|until|till)";
+/** The day a phrase names, or null when it names none. */
+function dayFromWords(phrase, today) {
+	const p = phrase.toLowerCase().replace(/\s+/g, " ").replace(/^on /, "").trim();
+	if (p === "today" || p === "tonight") return today;
+	if (p === "tomorrow" || p === "tmrw") return shift(today, 1);
+	if (p === "the day after tomorrow") return shift(today, 2);
+	const dow = weekday(today);
+	if (/^end of (the )?week$/.test(p) || p === "this week") return shift(today, (5 - dow + 7) % 7);
+	if (p === "next week") return shift(today, (1 - dow + 7) % 7 || 7);
+	if (p === "next month") {
+		const [y, m] = [Number(today.slice(0, 4)), Number(today.slice(5, 7))];
+		return m === 12 ? dayOf$1(y + 1, 1, 1) : dayOf$1(y, m + 1, 1);
+	}
+	if (/^end of (the )?month$/.test(p)) {
+		const [y, m] = [Number(today.slice(0, 4)), Number(today.slice(5, 7))];
+		return shift(m === 12 ? dayOf$1(y + 1, 1, 1) : dayOf$1(y, m + 1, 1), -1);
+	}
+	let m = p.match(/^in (\w+) (day|week)s?$/);
+	if (m) {
+		const n = /^\d+$/.test(m[1]) ? Number(m[1]) : NUMBER_WORDS[m[1]];
+		if (n == null || n > 366) return null;
+		return shift(today, m[2] === "week" ? n * 7 : n);
+	}
+	m = p.match(/^(this |next )?([a-z]+)$/);
+	if (m) {
+		const target = DAYS$1.findIndex((d) => d.startsWith(m[2].slice(0, 3)) && m[2].length >= 3);
+		if (target >= 0 && new RegExp(`^${DAY_WORD}$`).test(m[2])) {
+			const ahead = (target - dow + 7) % 7 || 7;
+			return shift(today, m[1] === "next " ? ahead + 7 : ahead);
+		}
+	}
+	m = p.match(/^([a-z]+\.?) (\d{1,2})(?:st|nd|rd|th)?(?:,? (\d{4}))?$/);
+	if (m && monthIndex(m[1]) >= 0) {
+		const month = monthIndex(m[1]) + 1;
+		return m[3] ? dayOf$1(Number(m[3]), month, Number(m[2])) : nextMonthDay(today, month, Number(m[2]));
+	}
+	m = p.match(/^(\d{1,2})(?:st|nd|rd|th)? (?:of )?([a-z]+\.?)(?:,? (\d{4}))?$/);
+	if (m && monthIndex(m[2]) >= 0) {
+		const month = monthIndex(m[2]) + 1;
+		return m[3] ? dayOf$1(Number(m[3]), month, Number(m[1])) : nextMonthDay(today, month, Number(m[1]));
+	}
+	m = p.match(/^(\d{4})-(\d{1,2})-(\d{1,2})$/);
+	if (m) return dayOf$1(Number(m[1]), Number(m[2]), Number(m[3]));
+	m = p.match(/^(\d{1,2})\/(\d{1,2})(?:\/(\d{2,4}))?$/);
+	if (m) {
+		if (!m[3]) return nextMonthDay(today, Number(m[1]), Number(m[2]));
+		return dayOf$1(Number(m[3]) < 100 ? 2e3 + Number(m[3]) : Number(m[3]), Number(m[1]), Number(m[2]));
+	}
+	return null;
+}
+const PRIORITY_WORDS = {
+	urgent: "urgent",
+	asap: "urgent",
+	top: "urgent",
+	p0: "urgent",
+	high: "high",
+	p1: "high",
+	medium: "medium",
+	normal: "medium",
+	p2: "medium",
+	low: "low",
+	p3: "low"
+};
+/** Removes found spans from the text, tidying the spaces and commas they leave. */
+function without(text, spans) {
+	let out = text;
+	for (const s of [...spans].sort((a, b) => b.start - a.start)) out = `${out.slice(0, s.start)} ${out.slice(s.end)}`;
+	return out.replace(/\s+([,.;:!?])/g, "$1").replace(/[,;:]+([,.;:!?])/g, "$1").replace(/\s{2,}/g, " ").replace(/(?:[\s,;:–—-]+)$/u, "").replace(/^[\s,;:]+/, "").trim();
+}
+/** What a new task's words say, and the title they leave. */
+function readTaskWords(input, ctx) {
+	const skip = ctx.skip ?? /* @__PURE__ */ new Set();
+	const text = input;
+	const taken = [];
+	const free = (start, end) => !taken.some((t) => start < t.end && end > t.start);
+	let priority = null;
+	if (!skip.has("priority")) for (const re of [
+		/(?:^|\s)!(urgent|asap|high|medium|normal|low|p[0-3])\b/gi,
+		/(?:^|[\s,])(urgent|top|high|medium|normal|low) priority\b/gi,
+		/(?:^|[\s,])priority (urgent|high|medium|normal|low|p[0-3])\b/gi,
+		/(?:^|[\s,])(urgent|asap)$/gi
+	]) {
+		const m = re.exec(text);
+		if (m) {
+			const lead = m[0].length - m[0].trimStart().length;
+			const start = m.index + lead + (m[0].trimStart().startsWith(",") ? 1 : 0);
+			priority = {
+				value: PRIORITY_WORDS[m[1].toLowerCase()],
+				start,
+				end: m.index + m[0].length
+			};
+			taken.push(priority);
+			break;
+		}
+	}
+	let project = null;
+	if (!skip.has("project")) for (const m of text.matchAll(/(?:^|\s)#([\p{L}\p{N}_-]+)/gu)) {
+		const key = loose(m[1]);
+		if (!key) continue;
+		const exact = ctx.projects.filter((p) => loose(p.name) === key);
+		const begins = ctx.projects.filter((p) => loose(p.name).startsWith(key));
+		const hit = exact.length === 1 ? exact[0] : begins.length === 1 ? begins[0] : null;
+		if (!hit) continue;
+		const start = m.index + (m[0].length - m[0].trimStart().length);
+		project = {
+			value: hit.id,
+			start,
+			end: m.index + m[0].length
+		};
+		taken.push(project);
+		break;
+	}
+	let owner = null;
+	if (!skip.has("owner")) {
+		const byKey = (key) => {
+			const full = ctx.people.filter((p) => loose(p.name) === key);
+			if (full.length === 1) return full[0];
+			const first = ctx.people.filter((p) => loose(p.name.split(/\s+/)[0] ?? "") === key);
+			if (first.length === 1) return first[0];
+			const begins = ctx.people.filter((p) => loose(p.name).startsWith(key));
+			return key.length >= 3 && begins.length === 1 ? begins[0] : null;
+		};
+		for (const m of text.matchAll(/(?:^|\s)@([\p{L}\p{N}._-]+)/gu)) {
+			const hit = byKey(loose(m[1]));
+			if (!hit) continue;
+			const start = m.index + (m[0].length - m[0].trimStart().length);
+			if (!free(start, m.index + m[0].length)) continue;
+			owner = {
+				value: hit.id,
+				start,
+				end: m.index + m[0].length
+			};
+			break;
+		}
+		if (!owner) for (const m of text.matchAll(/(?:^|[\s,])(?:assign(?:ed)? (?:it )?to|owner(?: is)?:?) (\p{L}+(?: \p{L}+)?)/giu)) {
+			const words = m[1].split(" ");
+			const two = words.length === 2 ? byKey(loose(m[1])) : null;
+			const one = byKey(loose(words[0]));
+			const hit = two ?? one;
+			if (!hit) continue;
+			const lead = m[0].length - m[0].replace(/^[\s,]+/, "").length;
+			const start = m.index + lead;
+			const end = two ? m.index + m[0].length : m.index + m[0].length - (words.length === 2 ? words[1].length + 1 : 0);
+			if (!free(start, end)) continue;
+			owner = {
+				value: hit.id,
+				start,
+				end
+			};
+			break;
+		}
+		if (owner) taken.push(owner);
+	}
+	let due = null;
+	if (!skip.has("due")) {
+		const led = new RegExp(`(?:^|[\\s,])(${LEAD$1} (${WHEN}))(?=$|[\\s,.;:!?])`, "gi");
+		for (const m of text.matchAll(led)) {
+			const day = dayFromWords(m[2], ctx.today);
+			if (!day) continue;
+			const start = m.index + m[0].indexOf(m[1]);
+			const end = start + m[1].length;
+			if (!free(start, end)) continue;
+			due = {
+				value: day,
+				start,
+				end
+			};
+			break;
+		}
+		if (!due) {
+			const rest = without(text, taken);
+			const tail = new RegExp(`(?:^|[\\s,])(${WHEN})[.!]?$`, "i").exec(rest);
+			const short = tail && /^(?:sun|mon|tue|wed|thu|fri|sat)$/i.test(tail[1]);
+			const said = tail && /\b(?:to|for|from|after|with|since)$/i.test(rest.slice(0, tail.index).trimEnd());
+			if (tail && !short && !said && rest.trim().length > tail[1].length) {
+				const day = dayFromWords(tail[1], ctx.today);
+				if (day) {
+					const at = text.toLowerCase().lastIndexOf(tail[1].toLowerCase());
+					if (at >= 0 && free(at, at + tail[1].length)) due = {
+						value: day,
+						start: at,
+						end: at + tail[1].length
+					};
+				}
+			}
+		}
+		if (due) taken.push(due);
+	}
+	const span = (f) => f ? text.slice(f.start, f.end).trim() : "";
+	let title = without(text, taken);
+	const first = text.search(/\S/);
+	if (taken.some((t) => t.start === first)) title = title.charAt(0).toUpperCase() + title.slice(1);
+	return {
+		title,
+		due: due ? {
+			value: due.value,
+			text: span(due)
+		} : null,
+		owner: owner ? {
+			value: owner.value,
+			text: span(owner)
+		} : null,
+		priority: priority ? {
+			value: priority.value,
+			text: span(priority)
+		} : null,
+		project: project ? {
+			value: project.value,
+			text: span(project)
+		} : null
+	};
+}
+
+// src/lib/swatches.ts
+var SWATCHES, HEALTH_LABEL$1, TASK_COLUMNS, TASK_STATUS_LABEL, PRIORITY_LABEL, CONSTRAINT_KIND_LABEL, CONSTRAINT_KIND_HINT;
+var init_swatches = __esmMin((() => {
+	SWATCHES = [
+		"pine",
+		"clay",
+		"sage",
+		"sand",
+		"slate",
+		"sea",
+		"rust",
+		"moss"
+	];
+	HEALTH_LABEL$1 = {
+		"on-track": "On track",
+		"at-risk": "At risk",
+		"off-track": "Off track",
+		paused: "Paused",
+		done: "Done"
+	};
+	TASK_COLUMNS = [
+		"backlog",
+		"todo",
+		"doing",
+		"review",
+		"done"
+	];
+	TASK_STATUS_LABEL = {
+		backlog: "Backlog",
+		todo: "To do",
+		doing: "In play",
+		review: "Review",
+		done: "Done"
+	};
+	PRIORITY_LABEL = {
+		low: "Low",
+		medium: "Medium",
+		high: "High",
+		urgent: "Urgent"
+	};
+	CONSTRAINT_KIND_LABEL = {
+		resource: "A person",
+		policy: "A policy",
+		external: "Outside the building",
+		collision: "A collision"
+	};
+	CONSTRAINT_KIND_HINT = {
+		resource: "Someone whose calendar sets the date.",
+		policy: "A rule that creates the wait.",
+		external: "A vendor, a city, a review board.",
+		collision: "Two things sharing one window."
+	};
+}));
+
 // src/lib/raid.ts
 /** Still needs someone's attention: not closed, resolved, decided or superseded. */
 function isActive(item) {
@@ -3963,67 +4316,13 @@ var init_raid = __esmMin((() => {
 	ids = (v) => Array.isArray(v) ? [...new Set(v.filter((x) => typeof x === "string" && !!x))] : [];
 }));
 
-// src/lib/swatches.ts
-var SWATCHES, HEALTH_LABEL$1, TASK_COLUMNS, TASK_STATUS_LABEL, PRIORITY_LABEL, CONSTRAINT_KIND_LABEL, CONSTRAINT_KIND_HINT;
-var init_swatches = __esmMin((() => {
-	SWATCHES = [
-		"pine",
-		"clay",
-		"sage",
-		"sand",
-		"slate",
-		"sea",
-		"rust",
-		"moss"
-	];
-	HEALTH_LABEL$1 = {
-		"on-track": "On track",
-		"at-risk": "At risk",
-		"off-track": "Off track",
-		paused: "Paused",
-		done: "Done"
-	};
-	TASK_COLUMNS = [
-		"backlog",
-		"todo",
-		"doing",
-		"review",
-		"done"
-	];
-	TASK_STATUS_LABEL = {
-		backlog: "Backlog",
-		todo: "To do",
-		doing: "In play",
-		review: "Review",
-		done: "Done"
-	};
-	PRIORITY_LABEL = {
-		low: "Low",
-		medium: "Medium",
-		high: "High",
-		urgent: "Urgent"
-	};
-	CONSTRAINT_KIND_LABEL = {
-		resource: "A person",
-		policy: "A policy",
-		external: "Outside the building",
-		collision: "A collision"
-	};
-	CONSTRAINT_KIND_HINT = {
-		resource: "Someone whose calendar sets the date.",
-		policy: "A rule that creates the wait.",
-		external: "A vendor, a city, a review board.",
-		collision: "Two things sharing one window."
-	};
-}));
-
 // src/tui/create.ts
 init_date_fns();
 init_format();
+init_swatches();
 init_indexes();
 init_date_text();
 init_raid();
-init_swatches();
 const scale = (labels) => [
 	1,
 	2,
@@ -4064,6 +4363,28 @@ function planFromChoices(data, finished, name, programId) {
 		...rest.map((p) => choice(p, false))
 	];
 }
+/**
+* The terminal's new task box reads its title as the website's does:
+* "Book the venue @Quinn by Friday !high #Website" adds “Book the venue”
+* for Quinn, due Friday, high priority, in Website.
+*/
+function readNewTask(text, data, today) {
+	const words = readTaskWords(text, {
+		today,
+		people: data.people,
+		projects: data.projects
+	});
+	const bits = [
+		words.owner && (data.people.find((p) => p.id === words.owner.value)?.name ?? "someone"),
+		words.due && `due ${longDate(words.due.value)}`,
+		words.priority && `${PRIORITY_LABEL[words.priority.value].toLowerCase()} priority`,
+		words.project && (data.projects.find((p) => p.id === words.project.value)?.name ?? "project")
+	].filter((b) => Boolean(b));
+	return {
+		words,
+		line: bits.length && words.title ? [`Adds “${words.title}”`, ...bits].join(" · ") : null
+	};
+}
 const CREATE_TITLE = {
 	portfolio: "New portfolio",
 	project: "New project",
@@ -6334,7 +6655,7 @@ applyTheme("dark");
 * from, the key hints along the bottom, health and priority marks.
 */
 /** One line of text. Enter keeps it, Esc leaves it as it was. */
-function TextField({ label, initial = "", placeholder, hint, onSubmit, onCancel }) {
+function TextField({ label, initial = "", placeholder, hint, hintFor, onSubmit, onCancel }) {
 	const [value, setShown] = useState(initial);
 	const typed = useRef(initial);
 	const setValue = (next) => {
@@ -6379,7 +6700,7 @@ function TextField({ label, initial = "", placeholder, hint, onSubmit, onCancel
 			/* @__PURE__ */ jsx(Text, {
 				color: theme.muted,
 				wrap: "truncate-end",
-				children: hint ?? "Enter to keep · Esc to leave it"
+				children: hintFor?.(value) ?? hint ?? "Enter to keep · Esc to leave it"
 			})
 		]
 	});
@@ -12355,6 +12676,8 @@ function Splash({ opening }) {
 
 // src/tui/views/overlays.tsx
 init_search();
+init_clock();
+init_format();
 /** Find a task by key or words; Enter opens it. */
 function SearchBox({ width, onOpen, onClose }) {
 	const tasks = useHarbor((s) => s.tasks);
@@ -12444,11 +12767,19 @@ function SearchBox({ width, onOpen, onClose }) {
 		]
 	});
 }
-/** Add a task: which project (when it isn't known), then its title. */
+/**
+* Add a task: which project (when it isn't known), then its title, read in
+* plain words as the website reads it (@name, by Friday, !high, #project).
+*/
 function NewTask({ projectId, status, width, onDone, onFull }) {
 	const { store } = useDeps();
 	const projects = useHarbor((s) => s.projects);
+	const people = useHarbor((s) => s.people);
 	const me = useHarbor((s) => s.currentUserId);
+	const read = (title) => readNewTask(title, {
+		people,
+		projects
+	}, todayISO(clockNow()));
 	const [project, setProject] = useState(() => projectId ?? soleOpenProject(projects));
 	const chosen = projects.find((p) => p.id === project);
 	if (!chosen) return /* @__PURE__ */ jsx(Box, {
@@ -12468,21 +12799,24 @@ function NewTask({ projectId, status, width, onDone, onFull }) {
 		width,
 		children: /* @__PURE__ */ jsx(TextField, {
 			label: `New task in ${chosen.name}${status ? ` · ${STATUS_LABEL[status]}` : ""}`,
-			placeholder: "What needs doing?",
+			placeholder: "What needs doing? Add @name, by Friday, #project",
 			hint: `Enter adds it (yours, ${STATUS_LABEL[status ?? "todo"].toLowerCase()}) · Esc leaves it`,
+			hintFor: (title) => read(title).line,
 			onCancel: () => onDone(null),
 			onSubmit: (title) => {
 				if (!title.trim()) return onDone(null);
-				const full = roomFor(store, chosen.id, status ?? "todo");
+				const { words } = read(title.trim());
+				const projectId = words.project?.value ?? chosen.id;
+				const full = roomFor(store, projectId, status ?? "todo");
 				if (full) return onFull(full);
 				onDone(store.getState().addTask({
-					projectId: chosen.id,
-					title: title.trim(),
+					projectId,
+					title: words.title || title.trim(),
 					description: "",
 					status: status ?? "todo",
-					priority: "medium",
-					assigneeId: me || null,
-					dueDate: null
+					priority: words.priority?.value ?? "medium",
+					assigneeId: words.owner?.value ?? (me || null),
+					dueDate: words.due?.value ?? null
 				}));
 			}
 		})
@@ -13298,6 +13632,36 @@ function applyDock(actions, projectId, changes) {
 	return made;
 }
 
+// src/lib/time-limits.ts
+var MAX_ENTRY_MINUTES;
+var init_time_limits = __esmMin((() => {
+	MAX_ENTRY_MINUTES = 1440;
+}));
+
+// src/lib/time-log.ts
+/** "1h 30m", "45m", "12h". */
+function formatMinutes(total) {
+	const n = Math.max(0, Math.round(total));
+	const h = Math.floor(n / 60);
+	const m = n % 60;
+	if (h === 0) return `${m}m`;
+	return m === 0 ? `${h}h` : `${h}h ${m}m`;
+}
+/** Hours with up to two decimals, for spreadsheets: 90 → 1.5. */
+function hours(minutes) {
+	return Math.round(minutes / 60 * 100) / 100;
+}
+/** All the time on one task. */
+function taskMinutes(task) {
+	let n = 0;
+	for (const e of task.time ?? []) n += e.minutes;
+	return n;
+}
+/** A task's entries, newest day first. */
+function entriesNewestFirst(task) {
+	return [...task.time ?? []].sort((a, b) => (b.on + b.at).localeCompare(a.on + a.at));
+}
+
 // node_modules/zod/v4/core/util.js
 function getEnumValues(entries) {
 	const numericValues = Object.values(entries).filter((v) => typeof v === "number");
@@ -18837,7 +19201,8 @@ function tasksSheetCsv(data, rows) {
 		"Done",
 		"Blocked by",
 		"Created",
-		"Description"
+		"Description",
+		"Hours logged"
 	], rows.map((t) => {
 		const project = projects.get(t.projectId);
 		const program = project ? programs.get(project.programId) : void 0;
@@ -18853,7 +19218,8 @@ function tasksSheetCsv(data, rows) {
 			t.status === "done" ? "yes" : "no",
 			blockerIds(t).map((id) => tasks.get(id)).filter((b) => Boolean(b)).map(keyOf).join("; "),
 			t.createdAt?.slice(0, 10) ?? "",
-			t.description
+			t.description,
+			t.time?.length ? hours(taskMinutes(t)) : ""
 		];
 	}));
 }
@@ -19508,6 +19874,16 @@ var init_fog = __esmMin((() => {
 }));
 
 // src/lib/mcp/tools.ts
+/**
+* What an agent can read about a harbor, as MCP tools. Each tool is a pure
+* function of one harbor's document (health already stamped) and who is
+* asking, so it is tested against the demo without a server. The route in
+* src/routes/api/mcp.ts signs the caller in, picks the harbor and loads it.
+*
+* Read only: nothing here changes a workspace. Answers carry ids so an agent
+* can ask about one thing next, and every list is capped and pageable, since
+* a harbor can hold thousands of tasks.
+*/
 init_thanks();
 init_task_keys();
 init_brief();
@@ -19537,6 +19913,20 @@ init_passage();
 init_board();
 init_holidays();
 init_soundings();
+/** A task's logged time for get_task: the total and the latest entries. */
+function timeOut(t, people) {
+	const entries = entriesNewestFirst(t);
+	return {
+		total: formatMinutes(taskMinutes(t)),
+		minutes: taskMinutes(t),
+		latest: entries.slice(0, 10).map((e) => ({
+			on: e.on,
+			by: nameOf$2(people, e.personId),
+			time: formatMinutes(e.minutes),
+			...e.note ? { note: e.note } : {}
+		}))
+	};
+}
 /**
 * Where the website opens one task or project, switching to its harbor
 * first (src/routes/open.tsx). Nothing without an origin.
@@ -20236,7 +20626,7 @@ const HARBOR_TOOLS = [
 	tool({
 		name: "get_task",
 		title: "Task details",
-		description: "One task: its owner (assignee) and anyone also on it (alsoOn), notes, checklist, its files, what it waits on, what waits on it, its latest comments, the earliest due date its owner's queue suggests (pilotDue: fits says whether the due date holds; absent with no owner, an agent owner, or once done), its place in its board column (`position`, from 1 at the top), and its url on the website." + DATA_NOTE,
+		description: "One task: its owner (assignee) and anyone also on it (alsoOn), notes, checklist, its files, what it waits on, what waits on it, its latest comments, the earliest due date its owner's queue suggests (pilotDue: fits says whether the due date holds; absent with no owner, an agent owner, or once done), its place in its board column (`position`, from 1 at the top), time logged on it (timeLogged: the total and the latest entries, when there is any), and its url on the website." + DATA_NOTE,
 		input: object({
 			harbor: harborArg,
 			task: string().min(1).max(100).describe("Task id or key (\"RR-42\"), from search_tasks or my_work.")
@@ -20285,6 +20675,7 @@ const HARBOR_TOOLS = [
 					step: i.title,
 					done: i.done
 				})),
+				...t.time?.length ? { timeLogged: timeOut(t, people) } : {},
 				waitingOn: blockersOf(t, data.tasks).map(brief),
 				waitedOnBy: waiters.map(brief),
 				...t.sounding ? { sounding: soundingOut(data, t, me(ctx)?.id ?? null, ctx.now) } : {},
@@ -22876,6 +23267,37 @@ function tasksSlice({ set, get, write }) {
 				checklist: (t.checklist ?? []).filter((i) => i.id !== itemId)
 			} : t) });
 		},
+		logTime: (taskId, entry) => {
+			const minutes = Math.round(entry.minutes);
+			if (!Number.isFinite(minutes) || minutes < 1 || minutes > 1440) return null;
+			const task = get().tasks.find((t) => t.id === taskId);
+			if (!task || (task.time?.length ?? 0) >= 500) return null;
+			const personId = entry.personId ?? get().currentUserId;
+			if (!personId) return null;
+			const id = uid("tm");
+			const note = entry.note?.trim().slice(0, 200);
+			const row = {
+				id,
+				personId,
+				minutes,
+				on: entry.on ?? todayISO(),
+				...note ? { note } : {},
+				at: stamp()
+			};
+			set({ tasks: get().tasks.map((t) => t.id === taskId ? {
+				...t,
+				touchedAt: stamp(),
+				time: [...t.time ?? [], row]
+			} : t) });
+			return id;
+		},
+		removeTime: (taskId, entryId) => {
+			set({ tasks: get().tasks.map((t) => t.id === taskId && t.time?.some((e) => e.id === entryId) ? {
+				...t,
+				touchedAt: stamp(),
+				time: t.time.filter((e) => e.id !== entryId)
+			} : t) });
+		},
 		addAttachment: (a) => {
 			const id = a.id ?? uid("f");
 			const row = {
@@ -23099,6 +23521,7 @@ var init_tasks = __esmMin((() => {
 	init_automations();
 	init_focus();
 	init_format();
+	init_time_limits();
 	init_soundings();
 	init_clock();
 	init_utils();