@harborppm/cli 0.59.0 → 0.60.0

package/lib/cli.mjs

@@ -42,6 +42,7 @@ import {
   ashoreText,
   voyageText,
   whyText,
+  barnaclesText,
   handoverText,
   fogText,
   agentWorkText,
@@ -97,6 +98,9 @@ export const HELP = `harbor: Harbor from the terminal
                                               changes without --apply
   harbor why PROJECT|TASK|MILESTONE           what's holding it up: the line of
                                               task waits that sets its date
+  harbor barnacles PROJECT                    work added since the plan was set:
+                                              by week, by who, and the days of
+                                              slip it explains
   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
@@ -873,9 +877,23 @@ const DETAIL = {
     "  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",
+    "  (or the end); a negative one already does. Open tasks with no due date",
+    "  can't hold a date, so they're left out and counted. In --json, endDate",
+    "  (dueDate for a task or milestone) is the date held and daysSpare the",
+    "  days before it (negative: that many over). PROJECT is a name, a key",
     "  like RR, or an id.",
   ],
+  barnacles: [
+    "  harbor barnacles PROJECT               reads how much the plan has grown",
+    "",
+    "  Counts the tasks made after the baseline was set (without a baseline",
+    "  time, after the project's first week of tasks), as a",
+    "  share of what was planned, by week and by who added them. At the",
+    "  crew's pace (tasks finished a week over the last six) it says how many",
+    "  days of work that is, and how much of the slip against the planned end",
+    "  it explains. The weekly brief names projects that grew a lot since",
+    "  their baseline.",
+  ],
   voyage: [
     "  harbor voyage PROJECT                  reads a Done project's voyage log",
     '  harbor voyage PROJECT "YOUR LINE"      writes: adds or changes your line in it',
@@ -2624,6 +2642,12 @@ export async function run(argv, io = {}) {
       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 "barnacles": {
+      const { positionals, harbor } = parse(spec());
+      const project = positionals.join(" ").trim();
+      if (!project) throw new HarborError("Say which project: harbor barnacles PROJECT.");
+      return call("scope_growth", { harbor, project }, barnaclesText);
+    }
     case "voyage": {
       const { positionals, harbor } = parse(spec());
       const [project, ...words] = positionals;

package/lib/format.mjs

@@ -571,7 +571,29 @@ export function whyText(r) {
           .join(", ")}.`,
       ]
     : [];
-  return [...head, "", ...via, ...lines, ...others].join("\n");
+  const note = r.note ? ["", r.note] : [];
+  return [...head, "", ...via, ...lines, ...others, ...note].join("\n");
+}
+
+/** A project's barnacles, as scope_growth answers it: the growth, its cost in days, by week and by who. */
+export function barnaclesText(r) {
+  const head = [`Barnacles · ${r.project}`];
+  if (!r.added) {
+    head.push(`Nothing added since the plan was set (${r.since.slice(0, 10)}): ${r.planned} task${r.planned === 1 ? "" : "s"}, as planned.`);
+    return head.join("\n");
+  }
+  head.push(`${r.headline} (${r.planned} planned, ${r.addedThisWeek} added this week).`);
+  if (r.daysLine) head.push(r.daysLine);
+  const top = Math.max(1, ...r.byWeek.map((w) => w.added));
+  const weeks = r.byWeek.map(
+    (w) => `  w/c ${w.weekOf}  ${"█".repeat(Math.max(1, Math.round((w.added / top) * 20)))} ${w.added}`,
+  );
+  const who = r.byWho.map((w) => `${w.who ?? "not recorded"} ${w.added}`).join(", ");
+  const from =
+    r.measuredFrom === "when the baseline was set"
+      ? `Counted from when the baseline was set, ${r.since.slice(0, 10)}.`
+      : `Counted from a week after its first task was made, ${r.since.slice(0, 10)}; setting a baseline counts from then instead.`;
+  return [...head, "", "Added by week:", ...weeks, "", `By who: ${who}`, "", from].join("\n");
 }
 
 /** A position on a 21-wide track, the top of the hill marked in the middle. */

package/lib/mcp.mjs

@@ -53,8 +53,15 @@ export function createClient({ creds, save, fetcher = fetch, now = Date.now }) {
       const msg = await res.json();
       if (msg.error) throw new HarborError(msg.error.message);
       const result = msg.result ?? {};
-      if (result.isError)
-        throw new HarborError(result.content?.map((c) => c.text).join("\n") || "Harbor said no.");
+      if (result.isError) {
+        const said = result.content?.map((c) => c.text).join("\n") || "Harbor said no.";
+        // A command newer than the site it talks to: the tool ships with the next deploy.
+        if (/^No tool named "/.test(said))
+          throw new HarborError(
+            `${new URL(current.server).host} doesn't have this yet. Try again after the next site update.`,
+          );
+        throw new HarborError(said);
+      }
       return result.structuredContent ?? JSON.parse(result.content?.[0]?.text ?? "{}");
     },
 

package/package.json

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