@harborppm/cli 0.42.0 → 0.43.0

package/dist/app.mjs

@@ -3009,10 +3009,18 @@ function tideForecast(project, tasks, now) {
 		remaining
 	};
 	const today = todayISO(now);
-	const runs = simulate(remaining, weekly, hash(`${project.id}|${remaining}|${today}`));
 	const base = noon(today);
+	const paced = simulate(remaining, weekly, hash(`${project.id}|${remaining}|${today}`));
+	const at = (share, list = runs) => list[Math.min(list.length - 1, Math.ceil(share * list.length) - 1)];
+	let lastDue = null;
+	for (const t of tasks) {
+		if (t.status === "done" || !t.dueDate) continue;
+		if (!lastDue || t.dueDate > lastDue.dueDate) lastDue = t;
+	}
+	const floor = lastDue ? differenceInCalendarDays(noon(lastDue.dueDate), base) : 0;
+	const runs = floor > 0 ? paced.map((d) => Math.max(d, floor)) : paced;
+	const heldBy = lastDue && floor > at(.5, paced) ? lastDue : null;
 	const dayOf = (days) => Number.isFinite(days) ? todayISO(addDays(base, days)) : null;
-	const at = (share) => runs[Math.min(runs.length - 1, Math.ceil(share * runs.length) - 1)];
 	const toEnd = differenceInCalendarDays(noon(project.endDate), base);
 	const byEnd = runs.filter((d) => d <= toEnd).length / runs.length;
 	const last = Math.max(Number.isFinite(at(.99)) ? at(.99) : 728, toEnd + 14, 7);
@@ -3037,7 +3045,8 @@ function tideForecast(project, tasks, now) {
 		almostCertain: dayOf(at(.95)),
 		chanceByEnd: Math.round(byEnd * 100) / 100,
 		curve,
-		rough: finished < ROUGH_BELOW
+		rough: finished < ROUGH_BELOW,
+		heldBy
 	};
 }
 /** "15%", with "under 5%" and "over 95%" at the ends, where a thousand runs can't be that sure. */
@@ -3047,18 +3056,11 @@ function chanceText(chance) {
 	return `${Math.round(chance * 20) * 5}%`;
 }
 /**
-* The open task due last, when it's due after the likely finish. The pace
-* knows nothing of due dates, so a task due later means the plan runs
-* longer than the pace says.
+* The open task whose due date sets the finish, when the crew's pace alone
+* would be done sooner; null otherwise.
 */
-function dueAfterFinish(tide, tasks) {
-	if (tide.kind !== "forecast" || !tide.likely) return null;
-	let last = null;
-	for (const t of tasks) {
-		if (t.status === "done" || !t.dueDate) continue;
-		if (!last || t.dueDate > last.dueDate) last = t;
-	}
-	return last && last.dueDate.slice(0, 10) > tide.likely ? last : null;
+function dueAfterFinish(tide) {
+	return tide.kind === "forecast" ? tide.heldBy : null;
 }
 
 //#endregion
@@ -3970,8 +3972,8 @@ function filterTasks(tasks, f) {
 }
 /**
 * When the project will likely finish at its crew's recent pace, in one
-* line under its name, whether that misses the end date, and an open task
-* due after it, which the pace can't see. Empty when
+* line under its name, whether that misses the end date, and the open task
+* whose due date holds it later than the pace would. Empty when
 * there's no forecast (all done, paused, or nothing finished lately).
 */
 function tideLine(data, project, today) {
@@ -3988,8 +3990,8 @@ function tideLine(data, project, today) {
 	};
 	const very = tide.veryLikely ? `, very likely by ${shortDay(tide.veryLikely, today)}` : "";
 	const end = project.endDate >= today ? ` · ${chanceText(tide.chanceByEnd)} by its end, ${shortDay(project.endDate, today)}` : "";
-	const later = dueAfterFinish(tide, tasks);
-	const due = later ? ` · ${taskKey(later, project) ?? `“${later.title}”`} is due later, ${shortDay(later.dueDate.slice(0, 10), today)}` : "";
+	const later = dueAfterFinish(tide);
+	const due = later ? ` · ${taskKey(later, project) ?? `“${later.title}”`} is due ${shortDay(later.dueDate.slice(0, 10), today)}` : "";
 	return {
 		text: `Probably done ${shortDay(tide.likely, today)}${very}${end}${due}${tide.rough ? " · rough" : ""}`,
 		late: tide.chanceByEnd < .5
@@ -15657,9 +15659,12 @@ async function initLinked(opts) {
 			consumed: /* @__PURE__ */ new Set(),
 			skipped: /* @__PURE__ */ new Set()
 		}, report, true);
+		const mine = data.tasks.filter((t) => t.projectId === project.id);
+		const open = mine.filter((t) => t.status !== "done").length;
 		return {
 			config,
-			tasks: data.tasks.filter((t) => t.projectId === project.id).length,
+			tasks: mine.length,
+			open,
 			moved,
 			report
 		};
@@ -15956,12 +15961,13 @@ async function initHere(opts) {
 		dryRun: opts.dryRun
 	});
 	const { project, harbor } = made.config;
+	const counted = made.open === made.tasks ? plural(made.tasks, "task") : `${made.open} open and ${made.tasks - made.open} done ${made.tasks === 1 ? "task" : "tasks"}`;
 	if (opts.dryRun) {
-		opts.say(made.moved ? `Would move this folder's ${plural(made.moved, "task")} into ${project.name} (${project.key}) in ${harbor.name}.` : `Would make ${shownDir(opts.cwd, dir)} for ${project.name} (${project.key}) in ${harbor.name}, with ${plural(made.tasks, "task")}.`);
+		opts.say(made.moved ? `Would move this folder's ${plural(made.moved, "task")} into ${project.name} (${project.key}) in ${harbor.name}.` : `Would make ${shownDir(opts.cwd, dir)} for ${project.name} (${project.key}) in ${harbor.name}, with a file for each of its ${counted}.`);
 		opts.say("Dry run: nothing was written or sent. Run it again without --dry-run to do it.");
 		return made.config;
 	}
-	opts.say(made.moved ? `Moved this folder's ${plural(made.moved, "task")} into ${project.name} in ${harbor.name}.` : `Made ${shownDir(opts.cwd, dir)} for ${project.name} (${project.key}) in ${harbor.name}, with ${plural(made.tasks, "task")}. Commit it like any code.`);
+	opts.say(made.moved ? `Moved this folder's ${plural(made.moved, "task")} into ${project.name} in ${harbor.name}.` : `Made ${shownDir(opts.cwd, dir)} for ${project.name} (${project.key}) in ${harbor.name}, with a file for each of its ${counted}. Commit it like any code.`);
 	opts.say("Edit a file, or add one, then run harbor sync. Changes on the website come back the same way.");
 	if (opts.hook) opts.say(await addHook(home));
 	return made.config;

package/lib/cli.mjs

@@ -506,12 +506,13 @@ const DETAIL = {
     "  harbor forecast PROJECT                reads one project's forecast and what",
     "                                         it rests on",
     "",
-    "  Worked out from the crew's pace alone: how many tasks they finished each",
-    "  week over the last six (or the project's life, if shorter), replayed a",
+    "  Worked out from the crew's pace: how many tasks they finished each week",
+    "  over the last six (or the project's life, if shorter), replayed a",
     "  thousand times until its open tasks run out. Probably is half of those",
     "  runs, very likely 85%, almost certainly 95%. No estimates or points.",
-    "  It warns when under two weeks of pace is all there is, and when an open",
-    "  task is due after the likely finish, since the pace can't see due dates.",
+    "  No run finishes before the last open task is due, so a task due later",
+    "  than the pace would finish sets the dates, and the forecast names it. It",
+    "  warns when under two weeks of pace is all there is.",
   ],
   report: [
     "  harbor report PROGRAM                  reads the program's status report",

package/lib/format.mjs

@@ -346,7 +346,7 @@ export function forecastOne(p) {
   if (f.lastDue) {
     const which = f.lastDue.key ? `${f.lastDue.key} “${f.lastDue.title}”` : `“${f.lastDue.title}”`;
     lines.push(
-      `${which} is due ${f.lastDue.due}, after the likely finish, so the plan runs longer than the pace says.`,
+      `${which} is due ${f.lastDue.due}, later than the crew's pace alone would finish, so the dates wait for it.`,
     );
   }
   return lines.join("\n");

package/package.json

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