@harborppm/cli 0.30.0 → 0.31.0

package/lib/cli.mjs

@@ -22,6 +22,7 @@ import {
   STATUS,
   harbors,
   limitsText,
+  hillData,
   hillList,
   myWork,
   premortemText,
@@ -899,7 +900,12 @@ export async function run(argv, io = {}) {
       if (!project) {
         if (values.at !== undefined)
           throw new HarborError("Say which project: harbor hill PROJECT --at N.");
-        return call("list_projects", { harbor, program: values.program, limit: 100 }, hillList);
+        return call(
+          "list_projects",
+          { harbor, program: values.program, limit: 100 },
+          hillList,
+          (r) => hillData(r, values.program),
+        );
       }
       if (values.at === undefined) {
         throw new HarborError("Say where with --at: 0 to 100, or start, top, doing or done.");
@@ -1299,7 +1305,7 @@ export async function run(argv, io = {}) {
       if (!project) throw new HarborError("Give a project, like harbor limit RR doing 5.");
       if (!column) {
         return call("get_project", { harbor, project }, (r) =>
-          limitsText(r.name, r.limits, r.tasks),
+          limitsText(r.name, r.limits, r.tasks, r.hiddenColumns),
         );
       }
       if (value === undefined || extra.length) {
@@ -1310,7 +1316,7 @@ export async function run(argv, io = {}) {
         throw new HarborError("A limit is a whole number from 1 to 20, or none.");
       }
       return call("set_column_limit", { harbor, project, column, limit }, (r) =>
-        limitsText(r.set.project, r.limits, r.tasks),
+        limitsText(r.set.project, r.limits, r.tasks, r.hiddenColumns),
       );
     }
     case "voyage": {

package/lib/format.mjs

@@ -144,16 +144,26 @@ export function projectList(r, { done = false } = {}) {
   );
 }
 
-/** A project's column limits with how full each is: "doing 4 of 5; no limit on backlog, todo, done". */
-export function limitsText(name, limits, tasks = {}) {
+/**
+ * A project's column limits with how full each is: "doing 4 of 5; no limit on
+ * backlog, todo, done". Columns the board hides are named after, with any cap
+ * they keep for when they're shown again.
+ */
+export function limitsText(name, limits, tasks = {}, hidden = []) {
+  const label = (status) => STATUS[status] ?? status;
   const entries = Object.entries(limits ?? {});
-  const capped = entries
+  const shown = entries.filter(([status]) => !hidden.includes(status));
+  const capped = shown
     .filter(([, n]) => n != null)
-    .map(([status, n]) => `${STATUS[status] ?? status} ${tasks[status] ?? 0} of ${n}`);
-  const open = entries.filter(([, n]) => n == null).map(([status]) => STATUS[status] ?? status);
-  if (!capped.length) return `${name}'s board has no column limits.`;
+    .map(([status, n]) => `${label(status)} ${tasks[status] ?? 0} of ${n}`);
+  const open = shown.filter(([, n]) => n == null).map(([status]) => label(status));
+  const off = entries
+    .filter(([status]) => hidden.includes(status))
+    .map(([status, n]) => (n == null ? label(status) : `${label(status)} (limit ${n})`));
+  const offNote = off.length ? ` Hidden on the board: ${off.join(", ")}.` : "";
+  if (!capped.length) return `${name}'s board has no column limits.${offNote}`;
   const rest = open.length ? `; no limit on ${open.join(", ")}` : "";
-  return `${name}: ${capped.join(", ")}${rest}.`;
+  return `${name}: ${capped.join(", ")}${rest}.${offNote}`;
 }
 
 export function harbors(r) {
@@ -295,10 +305,43 @@ function hillTrack(at) {
   return cells.join("");
 }
 
+/**
+ * What harbor hill shows, for the chart and --json alike: open projects with
+ * their place on the hill (null when not on it), how many Done ones were left
+ * out, and the program asked for.
+ */
+export function hillData(r, program) {
+  const all = r.projects ?? [];
+  const open = all.filter((p) => p.health !== "done");
+  // The program's own name when every project is in it, else what was typed.
+  const named =
+    all.length && all.every((p) => p.program === all[0].program) ? all[0].program : null;
+  return {
+    ...(program ? { program: named ?? program } : {}),
+    projects: open.map((p) => ({
+      id: p.id,
+      name: p.name,
+      ...(p.key ? { key: p.key } : {}),
+      program: p.program ?? null,
+      health: p.health,
+      hill: p.hill ?? null,
+    })),
+    done: all.length - open.length,
+  };
+}
+
 /** Each open project's place on its program's hill, by program, unplaced ones named after. */
 export function hillList(r) {
   const projects = (r.projects ?? []).filter((p) => p.health !== "done");
-  if (!projects.length) return "No open projects match.";
+  if (!projects.length) {
+    if (r.done) {
+      const where = r.program ? `in ${r.program} ` : "";
+      return r.done === 1
+        ? `The one project ${where}is Done, so nothing is on the hill.`
+        : `All ${r.done} projects ${where}are Done, so nothing is on the hill.`;
+    }
+    return "No open projects match.";
+  }
   const byProgram = new Map();
   for (const p of projects) {
     const key = p.program ?? "No program";
@@ -317,6 +360,11 @@ export function hillList(r) {
       lines.push(`  ${name}  ${hillTrack(p.hill.at)} ${String(p.hill.at).padStart(3)}${still}`);
     }
     if (unplaced.length) lines.push(`  Not on the hill: ${unplaced.map((p) => p.name).join(", ")}`);
+    if (!placed.length) {
+      lines.push(
+        `  Place one with harbor hill "${unplaced[0].name}" --at 30 (0 to 100, top is 50).`,
+      );
+    }
     blocks.push(lines.join("\n"));
   }
   return blocks.join("\n\n");

package/package.json

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