@harborppm/cli 0.89.0 → 0.91.0

package/README.md

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

package/bin/harbor.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { VERSION, run } from "../lib/cli.mjs";
+import { exitWhenWritten } from "../lib/exit.mjs";
 import { HarborError } from "../lib/mcp.mjs";
 import { jsonText, plain } from "../lib/plain.mjs";
 import { updateNotice } from "../lib/update.mjs";
@@ -19,7 +20,7 @@ const tell = async () => {
 run(argv).then(
   async (code) => {
     await tell();
-    process.exit(code);
+    await exitWhenWritten(code);
   },
   async (err) => {
     const known =
@@ -33,6 +34,6 @@ run(argv).then(
     if (argv.includes("--json")) process.stdout.write(`${jsonText({ error: message })}\n`);
     else process.stderr.write(`${plain(message)}\n`);
     await tell();
-    process.exit(1);
+    await exitWhenWritten(1);
   },
 );

package/dist/app.mjs

@@ -3670,8 +3670,8 @@ init_date_text();
 init_format();
 init_indexes();
 init_premortem();
-const DAY = (iso) => parseIso(iso.slice(0, 10));
-const span$1 = (a, b) => differenceInCalendarDays(DAY(b), DAY(a));
+const DAY$1 = (iso) => parseIso(iso.slice(0, 10));
+const span$1 = (a, b) => differenceInCalendarDays(DAY$1(b), DAY$1(a));
 /** Projects marked Done that have tasks to copy, most recently finished first. */
 function finishedProjects(data) {
 	return data.projects.filter((p) => p.health === "done" && tasksOf(data.tasks, p.id).length > 0).map((p) => ({
@@ -3762,7 +3762,7 @@ function reckoningLine(r) {
 }
 /** The new project's end date, as long after its start as the old one really ran. */
 function reckonedEnd(r, startDate) {
-	return todayISO(addDays(DAY(startDate), r.took));
+	return todayISO(addDays(DAY$1(startDate), r.took));
 }
 /** Puts the reckoning's tasks and risks into the new project, dated from its start. */
 function applyReckoning(actions, projectId, r, startDate) {
@@ -3773,7 +3773,7 @@ function applyReckoning(actions, projectId, r, startDate) {
 		status: "todo",
 		priority: t.priority,
 		assigneeId: null,
-		dueDate: todayISO(addDays(DAY(startDate), t.dueIn))
+		dueDate: todayISO(addDays(DAY$1(startDate), t.dueIn))
 	}, {
 		allowOverCap: true,
 		allowBlocked: true
@@ -13990,6 +13990,33 @@ function linkedProjects(kr, projects) {
 	if (ids.size === 0) return [];
 	return projects.filter((p) => ids.has(p.id) || ids.has(p.programId));
 }
+/**
+* The tasks a work key result counts: every task in the projects it names
+* (directly or through their program), and each task it names on its own,
+* each counted once however many ways it's linked.
+*/
+function workCount(kr, work) {
+	let done = 0;
+	let all = 0;
+	const seen = /* @__PURE__ */ new Set();
+	const count = (t) => {
+		if (seen.has(t.id)) return;
+		seen.add(t.id);
+		all++;
+		if (t.status === "done") done++;
+	};
+	const projects = linkedProjects(kr, work.projects);
+	for (const p of projects) for (const t of tasksOf(work.tasks, p.id)) count(t);
+	const tasks = byId(work.tasks);
+	for (const id of kr.linkIds ?? []) {
+		const t = tasks.get(id);
+		if (t) count(t);
+	}
+	return {
+		done,
+		all
+	};
+}
 /** How far along one key result is, 0 to 1. */
 function keyResultProgress(kr, work) {
 	if (kr.kind === "number") {
@@ -13998,12 +14025,7 @@ function keyResultProgress(kr, work) {
 		if (span === 0) return (kr.current ?? start) >= (kr.target ?? 0) ? 1 : 0;
 		return clamp(((kr.current ?? start) - start) / span);
 	}
-	let done = 0;
-	let all = 0;
-	for (const p of linkedProjects(kr, work.projects)) for (const t of tasksOf(work.tasks, p.id)) {
-		all++;
-		if (t.status === "done") done++;
-	}
+	const { done, all } = workCount(kr, work);
 	return all === 0 ? 0 : done / all;
 }
 /** How far along a goal is: the average of its key results, 0 to 1. */
@@ -14012,10 +14034,12 @@ function goalProgress(goal, work) {
 	if (krs.length === 0) return 0;
 	return krs.reduce((sum, kr) => sum + keyResultProgress(kr, work), 0) / krs.length;
 }
-/** How much of the goal's time has gone by, 0 to 1, from when it was set to its due day. */
+/** The day a goal's clock starts: its start day, or the day it was set. */
+const goalStart = (goal) => goal.start || goal.createdAt.slice(0, 10);
+/** How much of the goal's time has gone by, 0 to 1, from its start day to its due day. */
 function timeGone(goal, today) {
 	if (!goal.due) return null;
-	const start = Date.parse(`${goal.createdAt.slice(0, 10)}T00:00:00Z`);
+	const start = Date.parse(`${goalStart(goal)}T00:00:00Z`);
 	const end = Date.parse(`${goal.due}T00:00:00Z`);
 	const now = Date.parse(`${today}T00:00:00Z`);
 	if (!Number.isFinite(start) || !Number.isFinite(end)) return null;
@@ -14033,6 +14057,7 @@ function goalStatus(progress, goal, today) {
 	const gone = timeGone(goal, today);
 	if (gone == null) return progress > 0 ? "on-track" : "not-started";
 	if (goal.due && today > goal.due) return "off-track";
+	if (today < goalStart(goal)) return "not-started";
 	if (progress === 0 && gone < .1) return "not-started";
 	const behind = gone - progress;
 	if (behind <= .1) return "on-track";
@@ -14045,12 +14070,8 @@ function keyResultText(kr, work) {
 		const unit = kr.unit ? ` ${kr.unit}` : "";
 		return `${fmt(kr.current ?? kr.start ?? 0)} of ${fmt(kr.target ?? 0)}${unit}`;
 	}
-	let done = 0;
-	let all = 0;
-	for (const p of linkedProjects(kr, work.projects)) for (const t of tasksOf(work.tasks, p.id)) {
-		all++;
-		if (t.status === "done") done++;
-	}
+	if (!kr.linkIds?.length) return "Nothing linked yet";
+	const { done, all } = workCount(kr, work);
 	return all === 0 ? "No tasks yet" : `${done} of ${all} tasks done`;
 }
 const fmt = (n) => Number.isInteger(n) ? n.toLocaleString("en-US") : String(Math.round(n * 100) / 100);
@@ -19723,6 +19744,18 @@ function undatedText(pole) {
 	return n === 1 ? "1 open task has no due date, so it can't hold the date." : `${n} open tasks have no due date, so they can't hold the date.`;
 }
 
+// src/lib/raid-register.ts
+init_raid();
+/**
+* What agents and `harbor risks` list unless asked for everything: anything
+* still needing attention, plus decisions that stand. A decision is decided
+* once and then holds, so leaving it out the moment it's settled read as the
+* decision vanishing. Only one replaced by a newer decision drops out.
+*/
+function onLiveRegister(item) {
+	return isActive(item) || item.kind === "decision" && item.status === "decided";
+}
+
 // src/lib/csv.ts
 /**
 * Text a spreadsheet would run as a formula: a title from an intake form
@@ -20001,6 +20034,7 @@ function tasksCsv(data, projectId) {
 		"Blocked by",
 		"Description",
 		"Subtask of",
+		"Starts",
 		...fields.map((f) => f.name)
 	], tasks.map((t) => [
 		taskKey(t, project) ?? "",
@@ -20013,6 +20047,7 @@ function tasksCsv(data, projectId) {
 		blockerIds(t).map((id) => here.get(id)).filter((b) => Boolean(b)).map(name).join("; "),
 		t.description,
 		((p) => p ? name(p) : "")(parentOf(t, data.tasks)),
+		t.startDate ?? "",
 		...fields.map((f) => f.type === "url" ? safeLink(t.customFieldValues?.[f.id]) ?? "" : fieldValueText(f, t.customFieldValues?.[f.id], nameOf))
 	]));
 }
@@ -21437,6 +21472,7 @@ const HARBOR_TOOLS = [
 				position: boardPositions(data.tasks).get(t.id) ?? null,
 				priority: t.priority,
 				due: dayOf(t.dueDate),
+				...t.startDate ? { starts: dayOf(t.startDate) } : {},
 				assignee: nameOf$2(people, t.assigneeId),
 				...alsoOnOf(t, people),
 				project: project?.name ?? null,
@@ -21756,7 +21792,7 @@ const HARBOR_TOOLS = [
 	tool({
 		name: "list_risks",
 		title: "Risks, issues and decisions",
-		description: "The RAID register, highest score first: open risks, issues and pending decisions unless asked for all." + DATA_NOTE,
+		description: "The RAID register, highest score first: open risks and issues, and decisions still to make or standing, unless asked for all (closed, resolved and replaced ones too). Each item says when it was logged and last changed." + DATA_NOTE,
 		input: object({
 			harbor: harborArg,
 			kind: array(_enum([
@@ -21773,7 +21809,7 @@ const HARBOR_TOOLS = [
 			const { data } = ctx;
 			const people = byId(data.people);
 			const project = input.project ? findOne(data.projects, input.project, "project") : null;
-			const list = data.raidItems.filter((r) => (input.includeClosed || isActive(r)) && (!input.kind?.length || input.kind.includes(r.kind)) && (!project || r.projectId === project.id)).sort((a, b) => raidScore(b) - raidScore(a));
+			const list = data.raidItems.filter((r) => (input.includeClosed || onLiveRegister(r)) && (!input.kind?.length || input.kind.includes(r.kind)) && (!project || r.projectId === project.id)).sort((a, b) => raidScore(b) - raidScore(a));
 			return {
 				total: list.length,
 				items: list.slice(input.offset, input.offset + input.limit).map((r) => ({
@@ -21789,7 +21825,9 @@ const HARBOR_TOOLS = [
 					due: dayOf(r.dueDate),
 					...raidScope(data, r),
 					...r.mitigation ? { mitigation: r.mitigation } : {},
-					...r.resolution ? { resolution: r.resolution } : {}
+					...r.resolution ? { resolution: r.resolution } : {},
+					createdAt: r.createdAt,
+					updatedAt: r.updatedAt
 				}))
 			};
 		}
@@ -22091,6 +22129,7 @@ const HARBOR_TOOLS = [
 			const today = todayISO(ctx.now);
 			const people = byId(data.people);
 			const named = byId([...data.programs, ...data.projects]);
+			const tasksById = byId(data.tasks);
 			return { portfolios: (input.portfolio ? [findOne(data.portfolios, input.portfolio, "portfolio")] : data.portfolios).map((pf) => ({
 				id: pf.id,
 				name: pf.name,
@@ -22101,6 +22140,7 @@ const HARBOR_TOOLS = [
 						id: g.id,
 						title: g.title,
 						owner: g.ownerId ? people.get(g.ownerId)?.name ?? null : null,
+						...g.start ? { start: g.start } : {},
 						due: g.due,
 						...g.why ? { why: g.why } : {},
 						progress: Math.round(progress * 100),
@@ -22117,7 +22157,7 @@ const HARBOR_TOOLS = [
 								target: kr.target,
 								current: kr.current ?? kr.start ?? 0
 							} : {
-								counts: (kr.linkIds ?? []).map((id) => named.get(id)?.name ?? id),
+								counts: (kr.linkIds ?? []).map((id) => named.get(id)?.name ?? tasksById.get(id)?.title ?? id),
 								projects: linkedProjects(kr, data.projects).length
 							}
 						}))
@@ -23921,11 +23961,13 @@ function nextOccurrence(task, id, today, createdAt, siblings = []) {
 	if (!task.repeat) return null;
 	const dueDate = task.dueDate ? nextSeriesDate(task.dueDate, task.repeat, today) : nextDueDate(today, task.repeat);
 	if (siblings.some((t) => t.status !== "done" && t.repeat === task.repeat && t.title === task.title && (t.dueDate ?? "") >= dueDate)) return null;
+	const lead = task.startDate && task.dueDate ? differenceInCalendarDays(/* @__PURE__ */ new Date(`${task.dueDate.slice(0, 10)}T12:00:00`), /* @__PURE__ */ new Date(`${task.startDate.slice(0, 10)}T12:00:00`)) : null;
 	return {
 		...task,
 		id,
 		status: "todo",
 		dueDate,
+		...task.startDate ? { startDate: lead != null && lead >= 0 ? format(addDays(/* @__PURE__ */ new Date(`${dueDate}T12:00:00`), -lead), "yyyy-MM-dd") : null } : {},
 		createdAt,
 		completedAt: null,
 		blockedById: null,
@@ -23939,6 +23981,7 @@ function nextOccurrence(task, id, today, createdAt, siblings = []) {
 var REPEAT_LABEL, iso, step;
 var init_recurrence = __esmMin((() => {
 	init_date_fns();
+	init_date_text();
 	REPEAT_LABEL = {
 		weekly: "Every week",
 		biweekly: "Every two weeks",
@@ -24004,6 +24047,18 @@ var init_bulk = __esmMin((() => {
 	plural$2 = (n) => `${n} ${n === 1 ? "task" : "tasks"}`;
 }));
 
+// src/lib/task-start.ts
+function fitStart(start, due) {
+	const s = start ? start.slice(0, 10) : "";
+	if (!DAY.test(s)) return null;
+	const d = due ? due.slice(0, 10) : "";
+	return DAY.test(d) && s > d ? d : s;
+}
+var DAY;
+var init_task_start = __esmMin((() => {
+	DAY = /^\d{4}-\d{2}-\d{2}$/;
+}));
+
 // src/lib/slices/tasks.ts
 function tasksSlice({ set, get, write }) {
 	return {
@@ -24040,6 +24095,7 @@ function tasksSlice({ set, get, write }) {
 				completedAt: t.status === "done" ? t.completedAt ?? stamp() : null,
 				checklist: t.checklist ?? [],
 				..."parentTaskId" in t ? { parentTaskId } : {},
+				...t.startDate ? { startDate: fitStart(t.startDate, t.dueDate) } : {},
 				...blockersPatch(blockerIds({
 					id,
 					blockedById: t.blockedById,
@@ -24105,6 +24161,7 @@ function tasksSlice({ set, get, write }) {
 					...patch,
 					touchedAt: stamp()
 				};
+				if (next.startDate) next.startDate = fitStart(next.startDate, next.dueDate);
 				if (next.assigneeId && next.followerIds?.includes(next.assigneeId)) next.followerIds = alsoOnIds(next);
 				if (patch.status && patch.status !== row.status) {
 					if (patch.status === "done" && !patch.completedAt) next.completedAt = stamp();
@@ -24569,6 +24626,7 @@ var init_tasks = __esmMin((() => {
 	init_bulk();
 	init_task_people();
 	init_subtasks();
+	init_task_start();
 }));
 
 // src/lib/raid-history.ts

package/lib/cli.mjs

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

package/lib/exit.mjs

@@ -0,0 +1,18 @@
+/**
+ * Leaving once what was written has left. Into a pipe, stdout is written
+ * asynchronously, so `process.exit()` straight after a big write cut
+ * `harbor export harbor | jq` off at 64 KB with no error. A zero-length
+ * write's callback runs after every write before it, so waiting on one per
+ * stream is enough; the exit after it still stops anything left running.
+ */
+const flushed = (stream) =>
+  new Promise((resolve) => {
+    if (!stream.writableLength) resolve();
+    else stream.write("", () => resolve());
+  });
+
+export async function exitWhenWritten(code, streams = [process.stdout, process.stderr]) {
+  process.exitCode = code;
+  await Promise.all(streams.map(flushed));
+  process.exit(code);
+}

package/package.json

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