@harborppm/cli 0.90.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/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);
@@ -20013,6 +20034,7 @@ function tasksCsv(data, projectId) {
 		"Blocked by",
 		"Description",
 		"Subtask of",
+		"Starts",
 		...fields.map((f) => f.name)
 	], tasks.map((t) => [
 		taskKey(t, project) ?? "",
@@ -20025,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))
 	]));
 }
@@ -21449,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,
@@ -22105,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,
@@ -22115,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),
@@ -22131,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
 							}
 						}))
@@ -23935,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,
@@ -23953,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",
@@ -24018,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 {
@@ -24054,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,
@@ -24119,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();
@@ -24583,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/package.json

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