@harborppm/cli 0.24.0 → 0.29.0

package/README.md

@@ -57,7 +57,7 @@ Your harbor is the same one at [harborppm.com](https://harborppm.com/today?utm_s
 - **GitHub**: a pull request that names a task's key (RR-42) shows on the task and moves it along.
 - **Claude and other AI apps**, connected over MCP from [harborppm.com/ai](https://harborppm.com/ai?utm_source=npm&utm_medium=readme&utm_campaign=cli).
 
-`harbor open RR-42` opens a task on the website (in the right harbor, even when the browser had another one open), `harbor open Ridge` a project, and `harbor open` on its own opens Today. `harbor invite sam@example.com` sends Sam the same invite letter the People page does (`--viewer` to let them look but not change anything); only a harbor's owner can invite. `harbor calendar` prints your private calendar link, to add to Google, Apple or Outlook calendar: your due dates, milestones and sign-offs beside your meetings, kept up to date (`--program NAME` for everything dated in one program, `--new` to swap the link for a fresh one, `--off` to turn it off).
+`harbor open RR-42` opens a task on the website (in the right harbor, even when the browser had another one open), `harbor open Ridge` a project, and `harbor open` on its own opens Today. `harbor invite sam@example.com` sends Sam the same invite letter the People page does (`--viewer` to let them look but not change anything); only a harbor's owner can invite. `harbor calendar` prints your private calendar link, to add to Google, Apple or Outlook calendar: your due dates, milestones and sign-offs beside your meetings, kept up to date (`--program NAME` for everything dated in one program, `--new` to swap the link for a fresh one, `--off` to turn it off). `harbor roadmap "Next steps"` publishes a project as a public roadmap page (Now, Next and Shipped, task titles only) and prints its link; `--dates` adds the day each thing shipped and `--off` takes it down. Only a harbor's owner can publish.
 
 The website has the commands too: turn on **Command line at the bottom** in your menu, press `/`, and type `mine`, `add "Call the mill" #ridge @sam --due fri` or `done RR-12`.
 
@@ -94,12 +94,16 @@ harbor programs                             programs and their projects
 harbor projects [words] [--program P]       projects with health and open work
 harbor forecast [PROJECT] [--program P]     when projects will likely finish, from
                                             how fast their crews finish tasks
+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
 harbor mine                                 what's on you, late first
 harbor tasks [words] [--project P] [--assignee me|none|NAME] [--late] [--status S,S]
 harbor show TASK                            one task in full, with its web link
 harbor open [TASK|PROJECT]                  open it on the website (or Today)
 harbor invite EMAIL [--viewer]              invite someone to your harbor by email
 harbor calendar [--program P] [--new|--off] your private calendar link (.ics)
+harbor roadmap PROJECT [--dates] [--off]    publish a project's public roadmap
 
 harbor program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                      [--ends DATE]

package/dist/app.mjs

@@ -4062,6 +4062,48 @@ function CalendarView({ active, width, height, go }) {
 	});
 }
 
+//#endregion
+//#region src/lib/hill.ts
+/**
+* Hill charts, after Basecamp's Shape Up: each project is a dot on a hill.
+* Climbing the left side means still figuring out how to do it; rolling down
+* the right means the unknowns are solved and it's just the work. Owners
+* place their own dot, and a dot nobody has moved in two weeks fades, so a
+* stuck project shows without anyone saying so.
+*/
+/** Where the top of the hill is, on the 0–100 scale. */
+const HILL_TOP = 50;
+/** Days without a move before a dot reads as still. */
+const STILL_DAYS = 14;
+const HILL_PHASE_LABEL = {
+	figuring: "Figuring it out",
+	doing: "Getting it done"
+};
+/** A position kept on the scale, in whole steps. */
+function clampHill(at) {
+	if (!Number.isFinite(at)) return 0;
+	return Math.max(0, Math.min(100, Math.round(at)));
+}
+function hillPhase(at) {
+	return clampHill(at) < 50 ? "figuring" : "doing";
+}
+/** Days since the dot last moved, or null when it's never been placed. */
+function stillFor(project, today) {
+	if (!project.hillMovedAt) return null;
+	return Math.max(0, differenceInCalendarDays(/* @__PURE__ */ new Date(`${today}T12:00:00`), /* @__PURE__ */ new Date(`${project.hillMovedAt.slice(0, 10)}T12:00:00`)));
+}
+function isStill(project, today) {
+	const days = stillFor(project, today);
+	return days != null && days >= 14;
+}
+/** "Figuring it out, 40 of 100", or "Not on the hill yet". */
+function hillText(project) {
+	if (project.hillAt == null) return "Not on the hill yet";
+	const at = clampHill(project.hillAt);
+	if (at === 100) return "Over the hill: done";
+	return `${HILL_PHASE_LABEL[hillPhase(at)]} (${at} of 100)`;
+}
+
 //#endregion
 //#region src/lib/history-copy.ts
 /**
@@ -4231,6 +4273,10 @@ function describeEvent(e, names) {
 			action: "cleared the health override on",
 			detail: null
 		};
+		case "hillAt": return {
+			action: "moved",
+			detail: `on the hill to ${hillText({ hillAt: to == null ? null : Number(to) }).toLowerCase()}`
+		};
 		case "programId": return {
 			action: "moved",
 			detail: `to ${nameOf$1(names, to, "another program")}`
@@ -5475,7 +5521,7 @@ const HELP = [
 	["Enter / Esc", "open / back"],
 	["n", "new: a task, or what the screen lists"],
 	["e", "change what's open (health, lead, dates)"],
-	["[ ]", "move a card one column left or right"],
+	["[ ] / { }", "move a card a column / a project along its hill"],
 	["x / d", "mark done / delete (asks first)"],
 	["u / r", "undo your last change / retry saving"],
 	["v", "switch layout: board, list, budget, by project"],
@@ -7205,6 +7251,10 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 			else if (input === "d" && entry) go.confirm(`Take out ${money(entry.amount)}${entry.note ? ` for “${entry.note}”` : ""}? u undoes it.`, () => store.getState().removeSpend(entry.id), "Take it out");
 			return;
 		}
+		if ((input === "{" || input === "}") && project) {
+			const at = project.hillAt ?? (input === "}" ? -5 : 0);
+			return store.getState().moveOnHill(projectId, at + (input === "}" ? 5 : -5));
+		}
 		if (input === "[") return moveSelected(-1);
 		if (input === "]") return moveSelected(1);
 		if (key.return && selected) return go.openTask(selected.id);
@@ -7299,10 +7349,19 @@ function ProjectView({ projectId, active, width, height, go, onBack }) {
 					})
 				})]
 			}),
-			/* @__PURE__ */ jsx(Text, {
-				color: tide?.late ? theme.warn : theme.muted,
+			/* @__PURE__ */ jsxs(Text, {
 				wrap: "truncate-end",
-				children: tide ? tide.text : " "
+				children: [/* @__PURE__ */ jsx(Text, {
+					color: tide?.late ? theme.warn : theme.muted,
+					children: tide ? `${tide.text} · ` : ""
+				}), /* @__PURE__ */ jsxs(Text, {
+					color: isStill(project, day) ? theme.warn : theme.muted,
+					children: [
+						project.hillAt == null ? "Not on the hill · } puts it on" : `Hill: ${hillText(project).toLowerCase()}`,
+						isStill(project, day) ? `, still ${stillFor(project, day)} days` : "",
+						project.hillAt == null ? "" : " · { } move it"
+					]
+				})]
 			}),
 			mode === "budget" ? /* @__PURE__ */ jsx(BudgetPane, {
 				project,
@@ -9774,6 +9833,14 @@ function hierarchySlice({ get, write }) {
 				...patch
 			} : p) });
 		},
+		moveOnHill: (id, at) => {
+			const hillAt = clampHill(at);
+			write({ projects: get().projects.map((p) => p.id === id ? {
+				...p,
+				hillAt,
+				hillMovedAt: stamp()
+			} : p) });
+		},
 		addCustomField: (projectId, def) => {
 			const id = uid("cf");
 			write({ projects: get().projects.map((p) => p.id === projectId ? {

package/lib/cli.mjs

@@ -22,6 +22,7 @@ import {
   STATUS,
   harbors,
   limitsText,
+  hillList,
   myWork,
   premortemText,
   voyageText,
@@ -64,6 +65,9 @@ export const HELP = `harbor: Harbor from the terminal
                                               projects with health and open work
                                               (--json adds each board's limits)
   harbor forecast [PROJECT] [--program P]     when projects will likely finish
+  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
   harbor mine                                 what's on you, late first
   harbor tasks [words] [--project P] [--assignee me|none|NAME]
                      [--late] [--status S,S]
@@ -75,6 +79,8 @@ export const HELP = `harbor: Harbor from the terminal
   harbor prompt --init SHELL                  how to add it: zsh, bash, fish
                                               or starship
   harbor calendar [--program P] [--new|--off] your private calendar link (.ics)
+  harbor roadmap PROJECT [--dates|--no-dates] [--off]
+                                              publish a project's public roadmap
 
   harbor program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                        [--ends DATE]
@@ -223,6 +229,7 @@ const FLAG = {
   body: "the comment",
   column: "the column",
   limit: "the limit",
+  at: "--at",
 };
 
 /** Harbor's refusals are worded for agents; say them as the commands and flags that answer them. */
@@ -834,6 +841,27 @@ export async function run(argv, io = {}) {
       if (project) return call("get_project", { harbor, project }, forecastOne);
       return call("list_projects", { harbor, program: values.program, limit: 100 }, forecastList);
     }
+    case "hill": {
+      const { positionals, values, harbor } = parse(spec([], ["program", "at"]));
+      const project = positionals.join(" ").trim();
+      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);
+      }
+      if (values.at === undefined) {
+        throw new HarborError("Say where with --at: 0 to 100, or start, top, doing or done.");
+      }
+      const at = readHillWord(values.at);
+      if (at === null)
+        throw new HarborError("--at is 0 to 100, or start, figuring, top, doing or done.");
+      return call(
+        "move_on_hill",
+        { harbor, project, at },
+        (r) =>
+          `Moved ${r.moved.project} on the hill: ${r.moved.where.replace(/^\w/, (c) => c.toLowerCase())}.`,
+      );
+    }
     case "mine": {
       const { positionals, harbor } = parse(spec());
       none(positionals);
@@ -985,6 +1013,46 @@ export async function run(argv, io = {}) {
       );
       return 0;
     }
+    case "roadmap": {
+      const { positionals, values, harbor } = parse(
+        spec(["dates", "no-dates", "site", "no-site", "off"]),
+      );
+      const project = text(positionals, "which project");
+      if (values.dates && values["no-dates"])
+        throw new HarborError("Say --dates or --no-dates, not both.");
+      if (values.site && values["no-site"])
+        throw new HarborError("Say --site or --no-site, not both.");
+      if (!hasFullAccess(creds)) {
+        throw new HarborError("Publishing needs full access. Run harbor login, then try again.");
+      }
+      const r = await client.app({
+        op: "roadmap",
+        ...(harbor ? { harbor } : {}),
+        project,
+        ...(values.off ? { off: true } : {}),
+        ...(values.dates || values["no-dates"] ? { showDates: Boolean(values.dates) } : {}),
+        ...(values.site || values["no-site"] ? { onSite: Boolean(values.site) } : {}),
+      });
+      if (asJson) {
+        out(jsonText(r));
+        return 0;
+      }
+      if (!r.url) {
+        out(
+          plain(
+            `${r.project} isn't published any more. Its link says the roadmap isn't published.`,
+          ),
+        );
+        return 0;
+      }
+      const shows = r.showDates ? "titles and the day each shipped" : "titles only";
+      out(
+        plain(
+          `${r.project}'s public roadmap (Now, Next and Shipped; ${shows}, no people):\n\n  ${r.url}${r.siteUrl ? `\n\nIt's also Harbor's own roadmap at ${r.siteUrl}.` : ""}\n\nharbor roadmap "${r.project}" --off takes it down.`,
+        ),
+      );
+      return 0;
+    }
     case "add": {
       const { positionals, values, harbor } = parse(
         spec(["over-limit"], ["project", "assignee", "due", "priority", "status"]),
@@ -1223,3 +1291,10 @@ export async function run(argv, io = {}) {
       throw new HarborError(`No command "${command}". Run harbor help.`);
   }
 }
+
+/** --at for harbor hill: a number 0–100 or a word (src/lib/hill.ts readHill says the same). */
+function readHillWord(text) {
+  const t = String(text).trim().toLowerCase();
+  if (/^\d{1,3}$/.test(t)) return Number(t) <= 100 ? Number(t) : null;
+  return { start: 0, figuring: 25, top: 50, doing: 75, done: 100 }[t] ?? null;
+}

package/lib/format.mjs

@@ -287,3 +287,37 @@ export function voyageText(r) {
     "\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 ? "┼" : "─"));
+  cells[Math.round(at / 5)] = "●";
+  return cells.join("");
+}
+
+/** 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.";
+  const byProgram = new Map();
+  for (const p of projects) {
+    const key = p.program ?? "No program";
+    if (!byProgram.has(key)) byProgram.set(key, []);
+    byProgram.get(key).push(p);
+  }
+  const width = Math.min(28, Math.max(...projects.map((p) => p.name.length)));
+  const blocks = [];
+  for (const [program, list] of byProgram) {
+    const placed = list.filter((p) => p.hill).sort((a, b) => a.hill.at - b.hill.at);
+    const unplaced = list.filter((p) => !p.hill);
+    const lines = [program, `  ${"".padEnd(width)}  figuring it out ┼ getting it done`];
+    for (const p of placed) {
+      const name = p.name.length > width ? `${p.name.slice(0, width - 1)}…` : p.name.padEnd(width);
+      const still = p.hill.daysSinceMoved >= 14 ? `  still ${p.hill.daysSinceMoved} days` : "";
+      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(", ")}`);
+    blocks.push(lines.join("\n"));
+  }
+  return blocks.join("\n\n");
+}

package/package.json

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