@harborppm/cli 0.21.0 → 0.24.0

package/lib/cli.mjs

@@ -17,6 +17,8 @@ import {
   writeSettings,
 } from "./config.mjs";
 import {
+  forecastList,
+  forecastOne,
   STATUS,
   harbors,
   limitsText,
@@ -61,6 +63,7 @@ export const HELP = `harbor: Harbor from the terminal
   harbor projects [words] [--program P] [--done]
                                               projects with health and open work
                                               (--json adds each board's limits)
+  harbor forecast [PROJECT] [--program P]     when projects will likely finish
   harbor mine                                 what's on you, late first
   harbor tasks [words] [--project P] [--assignee me|none|NAME]
                      [--late] [--status S,S]
@@ -97,6 +100,7 @@ export const HELP = `harbor: Harbor from the terminal
   harbor risks [words] [--kind risk,issue,decision] [--project P] [--closed]
                                               the register, worst first
                                               (--closed adds closed ones)
+  harbor brief [--portfolio P]                the weekly brief, ready to send
   harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
                                               a project's pre-mortem: start,
                                               answer or read it
@@ -824,6 +828,12 @@ export async function run(argv, io = {}) {
           `Opened the project ${r.created.name} in ${r.created.program} (${r.created.starts} to ${r.created.ends}, lead ${r.created.lead ?? "nobody"}). Add work with harbor add "TITLE" --project "${r.created.name}".`,
       );
     }
+    case "forecast": {
+      const { positionals, values, harbor } = parse(spec([], ["program"]));
+      const project = positionals.join(" ").trim();
+      if (project) return call("get_project", { harbor, project }, forecastOne);
+      return call("list_projects", { harbor, program: values.program, limit: 100 }, forecastList);
+    }
     case "mine": {
       const { positionals, harbor } = parse(spec());
       none(positionals);
@@ -1107,6 +1117,11 @@ export async function run(argv, io = {}) {
         (r) => raidList(r, positionals.join(" ")),
       );
     }
+    case "brief": {
+      const { positionals, values, harbor } = parse(spec([], ["portfolio"]));
+      none(positionals);
+      return call("weekly_brief", { harbor, portfolio: values.portfolio }, (r) => r.text);
+    }
     case "premortem": {
       const { positionals, values, harbor } = parse(spec(["start"]));
       const [project, ...words] = positionals;

package/lib/format.mjs

@@ -199,6 +199,55 @@ export function raidList(r, words = "") {
   return lines.join("\n") + more;
 }
 
+/** "over 95%", in steps of five, as the website says it (src/lib/tide.ts chanceText). */
+function chance(c) {
+  if (c < 0.05) return "under 5%";
+  if (c > 0.95) return "over 95%";
+  return `${Math.round(c * 20) * 5}%`;
+}
+
+function finishRange(f) {
+  if (!f.likely) return "not in the next two years at this pace";
+  return `probably ${f.likely}${f.veryLikely ? `, very likely by ${f.veryLikely}` : ""}`;
+}
+
+/** When each open project will likely finish at its crew's recent pace. */
+export function forecastList(r) {
+  const projects = (r.projects ?? []).filter((p) => p.health !== "done");
+  if (!projects.length) return "No open projects match.";
+  const width = Math.min(32, Math.max(...projects.map((p) => p.name.length)));
+  return projects
+    .map((p) => {
+      const f = p.finish ?? {};
+      const name = p.name.length > width ? `${p.name.slice(0, width - 1)}…` : p.name.padEnd(width);
+      if (f.none) return `${name}  no forecast: ${f.none.replace(/^\w/, (c) => c.toLowerCase())}`;
+      const end = p.ends ? ` · ${chance(f.chanceByEnd)} by its end, ${p.ends}` : "";
+      return `${name}  ${finishRange(f)}${end}${f.rough ? " · rough" : ""}`;
+    })
+    .join("\n");
+}
+
+/** One project's forecast, in a few sentences. */
+export function forecastOne(p) {
+  const f = p.finish ?? {};
+  if (f.none) return `${p.name}: ${f.none}`;
+  const range = finishRange(f);
+  const lines = [
+    f.likely
+      ? `${p.name} will ${range.replace(/^probably/, "probably finish")}${f.almostCertain ? `, almost certainly by ${f.almostCertain}` : ""}.`
+      : `${p.name} won't finish in the next two years at this pace.`,
+  ];
+  if (p.ends) {
+    const c = chance(f.chanceByEnd);
+    lines.push(`${c[0].toUpperCase()}${c.slice(1)} chance of making its end date, ${p.ends}.`);
+  }
+  lines.push(
+    `${f.openTasks} task${f.openTasks === 1 ? "" : "s"} open; the crew finishes about ${f.finishedPerWeek} a week (${f.basedOn}).`,
+  );
+  if (f.rough) lines.push("Only a few tasks have finished, so treat this as rough.");
+  return lines.join("\n");
+}
+
 /** A project's pre-mortem, as get_premortem answers it. */
 export function premortemText(r) {
   if (!r.running) {

package/package.json

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