@harborppm/cli 0.51.0 → 0.53.0

package/lib/cli.mjs

@@ -37,6 +37,7 @@ import {
   soundingText,
   soundingsText,
   voyageText,
+  whyText,
   handoverText,
   fogText,
   agentWorkText,
@@ -89,6 +90,8 @@ export const HELP = `harbor: Harbor from the terminal
                                               dry dock: the forecast with plan
                                               changes tried on a copy; nothing
                                               changes without --apply
+  harbor why PROJECT|TASK|MILESTONE           what's holding it up: the line of
+                                              task waits that sets its date
   harbor hill [--program P]                   where each project is on its hill
   harbor hill PROJECT --at 0-100|top|done     move it: up to 50 is figuring it
                                               out, past 50 is getting it done
@@ -158,6 +161,10 @@ export const HELP = `harbor: Harbor from the terminal
                                               the review: programs worst first,
                                               each with its next move (reads
                                               only; harbor submit moves a task)
+  harbor bridge [--harbor H]                  run the review as a meeting: one
+                                              project a screen, what changed
+                                              since the last one, decisions,
+                                              actions and risks logged live
   harbor next-move PROGRAM "TEXT"             write a program's next move
   harbor health --program P|--project P|--portfolio P STATE [--note WHY]
                                               set its health by hand, or auto
@@ -721,6 +728,20 @@ const DETAIL = {
     "  never marks its own work Done; a person does, on the website or in the",
     "  terminal app.",
   ],
+  why: [
+    "  harbor why PROJECT                     the line of task waits that sets a",
+    "                                         project's date, against its end",
+    "  harbor why TASK                        the waits behind one task (a key",
+    "                                         like RR-42), against its due date",
+    "  harbor why MILESTONE                   the project a milestone waits on",
+    "                                         that finishes last, and its line",
+    "",
+    "  Tasks have due dates, not lengths, so a task can finish on its due date",
+    "  at the soonest, never before what it waits on, and never in the past.",
+    "  Each link's slack is the days it can slip before it moves the next one",
+    "  (or the end); a negative one already does. PROJECT is a name, a key",
+    "  like RR, or an id.",
+  ],
   voyage: [
     "  harbor voyage PROJECT                  reads a Done project's voyage log",
     '  harbor voyage PROJECT "YOUR LINE"      writes: adds or changes your line in it',
@@ -750,6 +771,20 @@ const DETAIL = {
     "  enough of it to pick one out; harbor risks lists them. Changes several",
     "  at once, as one change.",
   ],
+  bridge: [
+    "  harbor bridge                          opens the full-screen app on the",
+    "                                         review meeting (b on the Programs",
+    "                                         screen, or : Run the review meeting)",
+    "",
+    "  One open project a screen, with only what changed since its program was",
+    "  last reviewed (a week back the first time): health moves, work finished,",
+    "  newly late or added, risks raised, decisions made. ←→ move between",
+    "  projects; d logs a decision, a an action (who takes it, due in a week),",
+    "  r a risk, m the program's next move; e ends it. The summary lists what",
+    "  was logged; p posts it to each program's chat channel where one is set",
+    "  (Ship to shore, set on the website), y copies it. The next meeting",
+    "  counts from when this one ended.",
+  ],
   review: [
     "  harbor review                          reads the review: every program,",
     "                                         worst health first, then soonest end,",
@@ -973,7 +1008,7 @@ export async function run(argv, io = {}) {
   }
 
   // On its own in a terminal: the full-screen app. Piped or scripted: the help.
-  if (!command || command === "app") {
+  if (!command || command === "app" || command === "bridge") {
     const terminal = io.terminal ?? Boolean(process.stdout.isTTY && process.stdin.isTTY);
     if (!command && !terminal) {
       out(HELP);
@@ -982,7 +1017,7 @@ export async function run(argv, io = {}) {
     if (!terminal) throw new HarborError("The full-screen app needs a terminal.");
     const { values } = parseArgs(rest, { flags: [], options: ["harbor", "server"] });
     // In a folder with a local plan (harbor init --local), the app opens on it.
-    if (!values.harbor && !values.server) {
+    if (!values.harbor && !values.server && command !== "bridge") {
       const bundled = await loadApp();
       const dir = await bundled.localPlanAt(io.cwd ?? process.cwd());
       if (dir) {
@@ -1039,6 +1074,7 @@ export async function run(argv, io = {}) {
       },
       theme: (await readSettings(env)).theme,
       browse: io.browse ?? openBrowser,
+      ...(command === "bridge" ? { startIn: "bridge" } : {}),
     });
     return 0;
   }
@@ -2173,6 +2209,12 @@ export async function run(argv, io = {}) {
         soundingsText(r),
       );
     }
+    case "why": {
+      const { positionals, harbor } = parse(spec());
+      const of = positionals.join(" ").trim();
+      if (!of) throw new HarborError("Say what: a project, a task key like RR-42, or a milestone.");
+      return call("long_pole", { harbor, of }, whyText);
+    }
     case "voyage": {
       const { positionals, harbor } = parse(spec());
       const [project, ...words] = positionals;

package/lib/format.mjs

@@ -487,6 +487,35 @@ export function voyageText(r) {
   );
 }
 
+/** What's holding something up, as long_pole answers it: the headline, then the line of waits, first blocker at the top. */
+export function whyText(r) {
+  const what = r.of.kind === "task" ? r.of.name : `${r.of.name}${r.of.kind === "milestone" ? " (milestone)" : ""}`;
+  if (r.none) return `What's holding up ${what}: ${r.none.replace(/^\w/, (c) => c.toLowerCase())}`;
+  const head = [`What's holding up ${what}`];
+  if (r.headline) head.push(r.headline);
+  const chain = r.chain ?? [];
+  const width = Math.min(12, Math.max(0, ...chain.map((l) => (l.key ?? "").length)));
+  const lines = chain.flatMap((l, i) => {
+    const due = l.due ? (l.late ? `was due ${l.due}` : `due ${l.due}`) : "no due date";
+    const finish = l.canFinish !== l.due ? ` · can finish ${l.canFinish}` : "";
+    const row = [
+      `  ${(l.key ?? "").padEnd(width)}${width ? "  " : ""}${l.title}`,
+      `  ${" ".repeat(width)}${width ? "  " : ""}${l.assignee ?? "nobody yet"} · ${due}${finish} · ${l.slackText}`,
+    ];
+    return i < chain.length - 1 ? [...row, `  ${" ".repeat(width ? Math.floor(width / 2) : 0)}│`] : row;
+  });
+  const via = r.via ? [`It waits longest on ${r.via.project}; inside it:`] : [];
+  const others = (r.others ?? []).length
+    ? [
+        "",
+        `Also waits on ${r.others
+          .map((o) => `${o.project} (finishes ${o.finish}, ${o.slack >= 0 ? `${o.slack} day${o.slack === 1 ? "" : "s"} spare` : `${-o.slack} day${o.slack === -1 ? "" : "s"} over`})`)
+          .join(", ")}.`,
+      ]
+    : [];
+  return [...head, "", ...via, ...lines, ...others].join("\n");
+}
+
 /** A position on a 21-wide track, the top of the hill marked in the middle. */
 function hillTrack(at) {
   const cells = Array.from({ length: 21 }, (_, i) => (i === 10 ? "┼" : "─"));

package/package.json

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