@harborppm/cli 0.84.0 → 0.85.0

package/dist/app.mjs

@@ -19695,6 +19695,85 @@ 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
 /**
 * The spreadsheets Harbor hands out: a project's tasks, the risk register and
@@ -19723,6 +19802,8 @@ function tasksCsv(data, projectId) {
 	const here = byId(tasks);
 	const people = byId(data.people);
 	const name = (t) => taskKey(t, project) ?? t.title;
+	const fields = project?.customFields ?? [];
+	const nameOf = (id) => people.get(id)?.name;
 	return toCsv([
 		"Key",
 		"Title",
@@ -19732,7 +19813,8 @@ function tasksCsv(data, projectId) {
 		"Due",
 		"Done",
 		"Blocked by",
-		"Description"
+		"Description",
+		...fields.map((f) => f.name)
 	], tasks.map((t) => [
 		taskKey(t, project) ?? "",
 		t.title,
@@ -19742,7 +19824,8 @@ function tasksCsv(data, projectId) {
 		t.dueDate ?? "",
 		t.status === "done" ? "yes" : "no",
 		blockerIds(t).map((id) => here.get(id)).filter((b) => Boolean(b)).map(name).join("; "),
-		t.description
+		t.description,
+		...fields.map((f) => f.type === "url" ? safeLink(t.customFieldValues?.[f.id]) ?? "" : fieldValueText(f, t.customFieldValues?.[f.id], nameOf))
 	]));
 }
 /** Where a risk, issue or decision lives, by name; null for the whole harbor. */
@@ -20631,6 +20714,26 @@ function soundingOut(data, t, meId, now) {
 	};
 }
 const dayOf = (iso) => iso ? iso.slice(0, 10) : null;
+/** A project's own fields, as set_field takes them (custom-field-text.ts). */
+function fieldDefsOut(p) {
+	return (p.customFields ?? []).map((f) => ({
+		name: f.name,
+		type: FIELD_TYPE_LABEL[f.type].toLowerCase(),
+		...hasOptions(f.type) ? { options: f.options ?? [] } : {}
+	}));
+}
+/** A task's values for its project's own fields, by field name: { Size: "L" }. */
+function fieldValuesOut(data, p, t) {
+	if (!p?.customFields?.length || !t.customFieldValues) return null;
+	const people = byId(data.people);
+	const out = {};
+	for (const f of p.customFields) {
+		const v = t.customFieldValues[f.id];
+		if (!hasFieldValue(f, v)) continue;
+		out[f.name] = f.type === "multi" ? tagsOf(v) : f.type === "person" ? nameOf$2(people, String(v)) ?? "someone no longer here" : f.type === "number" || f.type === "checkbox" ? v : f.type === "url" ? safeLink(v) ?? "" : String(v);
+	}
+	return Object.keys(out).length ? out : null;
+}
 /** A task's approval (src/lib/task-approval.ts), as an agent reads it. */
 function approvalOut(data, a) {
 	const people = byId(data.people);
@@ -20993,7 +21096,7 @@ const HARBOR_TOOLS = [
 	tool({
 		name: "get_project",
 		title: "Project details",
-		description: "One project: health and why, dates, budget, task counts, late tasks, what it waits on, milestones and open risks, when it will likely finish at the crew's recent pace (finish: shortHistory when there's under two weeks of it; lastDue names the open task whose due date the dates wait for, when the pace alone would finish sooner), notes the crew left for later (notesForLater: a sealed one shows only who left it and what opens it, unless it's the person's own), its charter (why, in, out, doneWhen, callsBy; null until someone writes one, and outOfScope lists open tasks whose titles name something it leaves out), and its url on the website." + DATA_NOTE,
+		description: "One project: health and why, dates, budget, task counts, late tasks, what it waits on, milestones and open risks, when it will likely finish at the crew's recent pace (finish: shortHistory when there's under two weeks of it; lastDue names the open task whose due date the dates wait for, when the pace alone would finish sooner), notes the crew left for later (notesForLater: a sealed one shows only who left it and what opens it, unless it's the person's own), its charter (why, in, out, doneWhen, callsBy; null until someone writes one, and outOfScope lists open tasks whose titles name something it leaves out), the project's own task fields (fields: name, type and options, when it has any), and its url on the website." + DATA_NOTE,
 		input: object({
 			harbor: harborArg,
 			project: string().min(1).max(200).describe("Project id or name.")
@@ -21054,6 +21157,7 @@ const HARBOR_TOOLS = [
 				waitsOn,
 				milestones,
 				openRaid: raid,
+				...p.customFields?.length ? { fields: fieldDefsOut(p) } : {},
 				finish: finishForecast(p, tasks, ctx.now, spendEntriesOf(data, p.id), data),
 				...charterOf(p, tasks),
 				...notesOf(ctx, p),
@@ -21115,7 +21219,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), time logged on it (timeLogged: the total and the latest entries, when there is any), 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), its values for the project's own fields by name (fields, when it has any; set them with set_field), 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.")
@@ -21169,6 +21273,7 @@ const HARBOR_TOOLS = [
 				waitedOnBy: waiters.map(brief),
 				...t.sounding ? { sounding: soundingOut(data, t, me(ctx)?.id ?? null, ctx.now) } : {},
 				...t.approval ? { approval: approvalOut(data, t.approval) } : {},
+				...((v) => v ? { fields: v } : {})(fieldValuesOut(data, project, t)),
 				...pilot ? { pilotDue: {
 					earliest: pilot.earliest,
 					fits: pilot.fits,
@@ -24251,6 +24356,7 @@ var init_raid_history = __esmMin((() => {}));
 function milestonesRaidSlice({ set, get, write }) {
 	return {
 		toggleMilestone: (id) => {
+			if (get().milestones.find((m) => m.id === id)?.approverId) return;
 			write({ milestones: get().milestones.map((m) => m.id === id ? {
 				...m,
 				done: !m.done
@@ -26371,7 +26477,7 @@ function fieldsOf(data, task) {
 	};
 }
 /** The person a file's owner names: their whole name, else a first name or initials only they have. */
-function personNamed$1(people, name) {
+function personNamed$2(people, name) {
 	const want = name.trim().toLowerCase();
 	if (!want) return null;
 	const exact = people.filter((p) => p.name.trim().toLowerCase() === want);
@@ -26413,7 +26519,7 @@ function taskPatch(data, fields, say, label) {
 	if (fields.repeat !== void 0) patch.repeat = fields.repeat;
 	if (fields.notes !== void 0) patch.description = fields.notes;
 	if (fields.owner !== void 0) {
-		const person = fields.owner ? personNamed$1(data.people, fields.owner) : null;
+		const person = fields.owner ? personNamed$2(data.people, fields.owner) : null;
 		if (fields.owner && !person) say(`${label}: nobody called "${fields.owner}" is in the harbor, so it has no owner.`);
 		patch.assigneeId = person?.id ?? null;
 	}
@@ -26574,7 +26680,7 @@ function applyFolder(store, projectId, files, base, opts) {
 	let fresh = 0;
 	if (opts.fileWins) for (const text of files.values()) {
 		const owner = parseTask(text).fields?.owner;
-		if (owner && !personNamed$1(get().people, owner)) {
+		if (owner && !personNamed$2(get().people, owner)) {
 			const { id: _id, ...person } = localPerson(owner, "");
 			get().addPerson(person);
 		}
@@ -26836,7 +26942,7 @@ async function moveLocalTasks(folder, store, projectId, say) {
 	};
 	for (const t of local.tasks) {
 		const owner = t.assigneeId ? local.people.find((p) => p.id === t.assigneeId)?.name : null;
-		const person = owner ? personNamed$1(get().people, owner) : null;
+		const person = owner ? personNamed$2(get().people, owner) : null;
 		if (owner && !person) say(`${t.title}: nobody called "${owner}" is in the harbor, so it has no owner.`);
 		const id = get().addTask({
 			projectId,
@@ -27062,7 +27168,7 @@ function taskIn(data, project, key) {
 	if (!task || task.projectId !== project.id) throw new HarborError(`No task ${key} in ${project.name}. Use its key, like ${project.key ?? "RR"}-4.`);
 	return task;
 }
-const personNamed = (data, name) => {
+const personNamed$1 = (data, name) => {
 	try {
 		return findOne(data.people, name, "person");
 	} catch (e) {
@@ -27103,7 +27209,7 @@ function changesFrom(data, project, flags, now) {
 	for (const [key, who] of pairs(flags.give, "give", "KEY=NAME (RL-4=Sam, RL-5=none)")) add({
 		kind: "assign",
 		taskId: taskIn(data, project, key).id,
-		assigneeId: who === "none" ? null : personNamed(data, who).id
+		assigneeId: who === "none" ? null : personNamed$1(data, who).id
 	});
 	if (flags.end) add({
 		kind: "end",
@@ -27115,13 +27221,13 @@ function changesFrom(data, project, flags, now) {
 		if (!Number.isInteger(days) || days < 1 || days > 5) throw new HarborError("--borrow takes NAME or NAME=DAYS, days a week from 1 to 5.");
 		add({
 			kind: "borrow",
-			personId: personNamed(data, name.trim()).id,
+			personId: personNamed$1(data, name.trim()).id,
 			days
 		});
 	}
 	for (const name of list(flags.release)) add({
 		kind: "release",
-		personId: personNamed(data, name).id
+		personId: personNamed$1(data, name).id
 	});
 	return changes;
 }
@@ -28305,8 +28411,12 @@ function ProgramView({ programId, active, width, height, go, onBack }) {
 		} else if (key.upArrow || input === "k") setMAt((i) => step$1(i, -1, marks.length));
 		else if (key.downArrow || input === "j") setMAt((i) => step$1(i, 1, marks.length));
 		else if (key.return && mark) go.openPanel("milestone", mark.id);
-		else if (input === " " && mark) store.getState().toggleMilestone(mark.id);
-		else if (input === "d" && mark) go.confirm(`Delete the milestone “${mark.name}”? u undoes it.`, () => store.getState().deleteMilestone(mark.id), "Delete");
+		else if (input === " " && mark) {
+			if (mark.approverId) {
+				const approver = people.find((p) => p.id === mark.approverId);
+				go.notify(`${approver?.name ?? "The approver"} ticks this off by signing it off.`);
+			} else store.getState().toggleMilestone(mark.id);
+		} else if (input === "d" && mark) go.confirm(`Delete the milestone “${mark.name}”? u undoes it.`, () => store.getState().deleteMilestone(mark.id), "Delete");
 	}, { isActive: active });
 	if (!program) return /* @__PURE__ */ jsx(Text, {
 		color: theme.muted,
@@ -29660,33 +29770,6 @@ function defaultAction(type) {
 	};
 }
 
-// src/lib/custom-field-text.ts
-const FIELD_TYPE_LABEL = {
-	text: "Text",
-	number: "Number",
-	select: "Dropdown",
-	checkbox: "Checkbox"
-};
-const FIELD_TYPES = Object.keys(FIELD_TYPE_LABEL);
-/** A dropdown's options from "S, M, L". */
-function optionsOf(value) {
-	return value.split(",").map((o) => o.trim()).filter(Boolean);
-}
-/** A task's value for a field as one line: "" when it has none. */
-function fieldValueText(def, value) {
-	if (value == null || value === "") return "";
-	if (def.type === "checkbox") return value ? "Yes" : "";
-	return String(value);
-}
-/** What someone typed for a text or number field; undefined when a number can't be read. */
-function readFieldValue(def, text) {
-	const t = text.trim();
-	if (!t) return null;
-	if (def.type !== "number") return t;
-	const n = Number(t.replace(/,/g, ""));
-	return Number.isFinite(n) ? n : void 0;
-}
-
 // src/tui/views/setup.tsx
 /**
 * A project's board setup, as the website's board settings have it: where it
@@ -29743,7 +29826,8 @@ function columnValue(c) {
 }
 function fieldValue(f) {
 	const kind = FIELD_TYPE_LABEL[f.type];
-	return f.type === "select" && f.options?.length ? `${kind}: ${f.options.join(", ")}` : kind;
+	const head = hasOptions(f.type) && f.options?.length ? `${kind}: ${f.options.join(", ")}` : kind;
+	return f.onCards ? `${head} · on cards` : head;
 }
 function BoardPanel({ id, width, height, go, active, onClose }) {
 	const { store } = useDeps();
@@ -29892,10 +29976,14 @@ function BoardPanel({ id, width, height, go, active, onClose }) {
 						label: "Rename it",
 						value: "rename"
 					},
-					...f.type === "select" ? [{
+					...hasOptions(f.type) ? [{
 						label: "Change its options",
 						value: "options"
 					}] : [],
+					{
+						label: f.onCards ? "Stop showing it on cards" : "Show it on board cards",
+						value: "cards"
+					},
 					{
 						label: "Take it out",
 						value: "remove"
@@ -29904,6 +29992,7 @@ function BoardPanel({ id, width, height, go, active, onClose }) {
 				onPick: (what) => {
 					const s = store.getState();
 					if (what === "rename") return go.ask("Field name", (text) => text.trim() && s.updateCustomField(id, f.id, { name: text.trim() }), f.name);
+					if (what === "cards") return s.updateCustomField(id, f.id, { onCards: f.onCards ? void 0 : true });
 					if (what === "options") return go.ask("Options, split by commas", (text) => s.updateCustomField(id, f.id, { options: optionsOf(text) }), (f.options ?? []).join(", "));
 					go.confirm(`Take out the field “${f.name}” and every task's value for it? u undoes it.`, () => s.removeCustomField(id, f.id), "Take it out");
 				}
@@ -29924,7 +30013,7 @@ function BoardPanel({ id, width, height, go, active, onClose }) {
 						value: t
 					})), (t) => {
 						const type = t;
-						if (type !== "select") return void store.getState().addCustomField(id, {
+						if (!hasOptions(type)) return void store.getState().addCustomField(id, {
 							name: trimmed,
 							type
 						});
@@ -30058,6 +30147,113 @@ function BoardPanel({ id, width, height, go, active, onClose }) {
 	});
 }
 
+// src/lib/date-picker.ts
+/**
+* The date picker's rules: the days a month's grid shows (always six weeks,
+* so the calendar keeps one height and stops jumping as you flip months),
+* the years its year list offers, and what a typed date means. Pure.
+*/
+/**
+* The day a typed date names, as an ISO day, or null when it names none.
+* Reads what the task composer reads ("Mar 14", "14 March 2027", "3/14",
+* "2027-03-14", "next friday", "in 2 weeks", "tomorrow"), plus a year after
+* a slash date in full ("3/14/2027"), and full stops or dashes for slashes.
+*/
+function typedDate(text, today) {
+	const t = text.trim().replace(/\s+/g, " ").replace(/^(\d{1,2})[.-](\d{1,2})(?:[.-](\d{2,4}))?$/, (_, m, d, y) => y ? `${m}/${d}/${y}` : `${m}/${d}`);
+	if (!t) return null;
+	return dayFromWords(t, today);
+}
+
+// src/lib/custom-field-read.ts
+/**
+* What someone typed for one of a project's own fields, as the value kept on
+* the task: in the terminal, the CLI and AI apps (the website's drawer has a
+* control per type). Pure.
+*/
+const YES = /* @__PURE__ */ new Set([
+	"yes",
+	"y",
+	"true",
+	"on",
+	"1",
+	"x",
+	"✓"
+]);
+const NO = /* @__PURE__ */ new Set([
+	"no",
+	"n",
+	"false",
+	"off",
+	"0"
+]);
+function option(def, text) {
+	const t = text.trim().toLowerCase();
+	return (def.options ?? []).find((o) => o.toLowerCase() === t);
+}
+/** The person a name names: their whole name, first name, or id; one match only. */
+function personNamed(people, text) {
+	const t = text.trim().replace(/^@/, "").toLowerCase();
+	if (!t) return void 0;
+	const exact = people.filter((p) => p.id === t || p.name.toLowerCase() === t);
+	if (exact.length === 1) return exact[0];
+	const first = people.filter((p) => p.name.toLowerCase().split(/\s+/)[0] === t);
+	if (first.length === 1) return first[0];
+	return first.length > 1 ? "many" : void 0;
+}
+/**
+* A typed value for a field: an empty string clears it. Says what's wrong
+* when it can't be read (an option the field doesn't have, a name that
+* matches nobody, a day it can't read).
+*/
+function readFieldValue(def, text, ctx) {
+	const t = text.trim();
+	if (!t) return { value: def.type === "multi" ? [] : null };
+	switch (def.type) {
+		case "number": {
+			const n = Number(t.replace(/,/g, ""));
+			return Number.isFinite(n) ? { value: n } : { error: `“${t}” isn't a number.` };
+		}
+		case "checkbox": {
+			const l = t.toLowerCase();
+			if (YES.has(l)) return { value: true };
+			if (NO.has(l)) return { value: false };
+			return { error: "Say yes or no." };
+		}
+		case "select": {
+			const o = option(def, t);
+			return o ? { value: o } : { error: offer(def, t) };
+		}
+		case "multi": {
+			const picked = [];
+			for (const part of t.split(",").map((p) => p.trim()).filter(Boolean)) {
+				const o = option(def, part);
+				if (!o) return { error: offer(def, part) };
+				if (!picked.includes(o)) picked.push(o);
+			}
+			return { value: picked };
+		}
+		case "date": {
+			const day = typedDate(t, ctx.today);
+			return day ? { value: day } : { error: `Couldn't read “${t}” as a day.` };
+		}
+		case "person": {
+			const p = personNamed(ctx.people, t);
+			if (p === "many") return { error: `More than one person is called “${t}”; use the full name.` };
+			return p ? { value: p.id } : { error: `Nobody here is called “${t}”.` };
+		}
+		case "url": {
+			const href = readLink(t);
+			return href ? { value: href } : { error: `“${t}” isn't a web address.` };
+		}
+		default: return { value: t.slice(0, 500) };
+	}
+}
+function offer(def, t) {
+	const opts = def.options ?? [];
+	return opts.length ? `“${t}” isn't one of ${def.name}'s options: ${opts.join(", ")}.` : `${def.name} has no options yet.`;
+}
+
 // src/tui/views/sounding.ts
 init_soundings();
 const nameOf = (people, id) => people.find((p) => p.id === id)?.name ?? "someone";
@@ -30310,6 +30506,7 @@ function TaskPanel({ taskId, width, height, go, active = true, onClose }) {
 	const mine = comments.filter((c) => c.taskId === task.id && c.authorId === me);
 	const blockers = blockersOf(task, tasks);
 	const done = () => setEditing(null);
+	const nameOf = (id) => people.find((p) => p.id === id)?.name;
 	const setCustom = (fieldId, value) => store.getState().setTaskCustomFieldValue(task.id, fieldId, value);
 	function editCustom(f) {
 		if (!task) return;
@@ -30322,6 +30519,13 @@ function TaskPanel({ taskId, width, height, go, active = true, onClose }) {
 			label: o,
 			value: o
 		}))], (v) => setCustom(f.id, v));
+		if (f.type === "person") return go.pick(f.name, [{
+			label: "Nobody",
+			value: null
+		}, ...people.filter((p) => p.kind !== "agent").map((p) => ({
+			label: p.name,
+			value: p.id
+		}))], (v) => setCustom(f.id, v));
 		setEditing({
 			kind: "custom",
 			fieldId: f.id
@@ -30409,7 +30613,9 @@ function TaskPanel({ taskId, width, height, go, active = true, onClose }) {
 		const f = own.find((x) => x.id === editing.fieldId);
 		if (f) editor = /* @__PURE__ */ jsx(CustomField, {
 			def: f,
-			initial: fieldValueText(f, task.customFieldValues?.[f.id]),
+			initial: typedText(f, task.customFieldValues?.[f.id]),
+			today: day,
+			people,
 			onCancel: done,
 			onSubmit: (v) => {
 				setCustom(f.id, v);
@@ -30605,7 +30811,7 @@ function TaskPanel({ taskId, width, height, go, active = true, onClose }) {
 							color: theme.muted,
 							children: f.name.slice(0, 8).padEnd(9)
 						}),
-						fieldValueText(f, task.customFieldValues?.[f.id]) || "—"
+						fieldValueText(f, task.customFieldValues?.[f.id], nameOf) || "—"
 					]
 				}, f.id);
 			}),
@@ -30696,18 +30902,34 @@ function TaskPanel({ taskId, width, height, go, active = true, onClose }) {
 		]
 	});
 }
-/** A text or number field of the project's own; a number that can't be read says so. */
-function CustomField({ def, initial, onSubmit, onCancel }) {
+/** What a field's value reads as when it's typed again: the day or link as kept. */
+function typedText(def, value) {
+	if (value == null || value === false) return "";
+	if (def.type === "multi") return tagsOf(value).join(", ");
+	if (def.type === "checkbox") return "yes";
+	return String(value);
+}
+const FIELD_HINT = {
+	number: "A number, or empty for none",
+	date: "A day (2026-12-01, friday, in 2 weeks), or empty for none",
+	url: "A web address, or empty for none"
+};
+/** A typed field of the project's own; a value that can't be read says why. */
+function CustomField({ def, initial, today, people, onSubmit, onCancel }) {
 	const [error, setError] = useState(null);
+	const hint = def.type === "multi" ? `Any of ${(def.options ?? []).join(", ") || "(no tags yet)"}, split by commas` : FIELD_HINT[def.type] ?? `${FIELD_TYPE_LABEL[def.type]}, or empty for none`;
 	return /* @__PURE__ */ jsx(TextField, {
 		label: def.name,
 		initial,
-		hint: error ?? (def.type === "number" ? "A number, or empty for none" : "Empty for none"),
+		hint: error ?? hint,
 		onCancel,
 		onSubmit: (text) => {
-			const v = readFieldValue(def, text);
-			if (v === void 0) return setError(`“${text}” isn't a number.`);
-			onSubmit(v);
+			const read = readFieldValue(def, text, {
+				today,
+				people
+			});
+			if ("error" in read) return setError(read.error);
+			onSubmit(read.value);
 		}
 	});
 }

package/lib/cli.mjs

@@ -273,6 +273,8 @@ export const HELP = `harbor: Harbor from the terminal
                                               approve a task (finishes it), send
                                               it back, or ask someone to approve
   harbor approvals                            tasks waiting on your approval
+  harbor field TASK NAME VALUE                set one of the project's own
+                                              fields on a task ("" clears it)
   harbor ashore [--weeks N] [--country CODES|none] [--person NAME]
                                               public holidays and time away
                                               coming up, and whose holidays
@@ -1067,6 +1069,14 @@ const DETAIL = {
     "                                         oldest ask first",
     "  harbor approve TASK [--changes NOTE]   writes: approve it or send it back",
   ],
+  field: [
+    "  harbor field TASK NAME VALUE           writes: sets one of the project's own",
+    "                                         fields on a task",
+    "",
+    "  Type the value as you would say it: a dropdown's option, tags split by",
+    '  commas, a person\'s name ("me" for you), a day (2026-12-01, friday), a',
+    '  web address, or yes or no. "" clears it. harbor show TASK lists them.',
+  ],
   goals: [
     "  harbor goals [PORTFOLIO]               reads: each portfolio's goals (all when",
     "                                         left out), off track first, with how far",
@@ -2279,6 +2289,8 @@ export async function run(argv, io = {}) {
         ];
         if (t.alsoOn?.length) lines.push(`Also on it: ${t.alsoOn.join(", ")}.`);
         if (t.repeats) lines.push(`Repeats ${REPEAT_WORD[t.repeats] ?? t.repeats}.`);
+        for (const [name, v] of Object.entries(t.fields ?? {}))
+          lines.push(`${name}: ${Array.isArray(v) ? v.join(", ") : v === true ? "yes" : v}`);
         if (t.pilotDue?.fits) lines.push(`${t.pilotDue.says}, so the due date holds.`);
         else if (t.pilotDue) lines.push(...pilotLines({ pilot: t.pilotDue }, t));
         if (t.description) lines.push("", t.description);
@@ -3272,7 +3284,27 @@ export async function run(argv, io = {}) {
     case "approvals": {
       const { positionals, harbor } = parse(spec());
       if (positionals.length) throw new HarborError(`Unexpected "${positionals.join(" ")}".`);
-      return call("my_work", { harbor, limit: 1 }, (r) => approvalsText(r));
+      return call(
+        "my_work",
+        { harbor, limit: 1 },
+        (r) => approvalsText(r),
+        (r) => ({ approvalsToGive: r.approvalsToGive ?? [] }),
+      );
+    }
+    case "field": {
+      const { positionals, harbor } = parse(spec());
+      const [task, field, ...value] = positionals;
+      if (!task || !field)
+        throw new HarborError('Give a task, a field and a value, like harbor field RR-4 Size L (or "" to clear).');
+      return call("set_field", { harbor, task, field, value: value.join(" ") }, (r) => {
+        const name = r.set.key ?? r.set.title;
+        const said = Object.entries(r.set.fields ?? {}).find(
+          ([n]) => n.toLowerCase() === field.trim().toLowerCase(),
+        );
+        if (!said) return `Cleared ${field} on ${name}.`;
+        const v = said[1];
+        return `${name}: ${said[0]} is ${Array.isArray(v) ? v.join(", ") : v === true ? "yes" : v}.`;
+      });
     }
     case "templates": {
       const { positionals, harbor } = parse(spec());

package/package.json

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