@harborppm/cli 0.97.0 → 0.99.0

package/lib/format.mjs

@@ -30,13 +30,20 @@ export function statusWord(typed) {
  * terminal's, when printing to one) shortens a long title so the line fits;
  * piped output keeps every title whole.
  */
+/**
+ * A task's status in words: its board's own name for the column when the
+ * project renamed it ("in progress"), else Harbor's ("in play").
+ */
+export const statusText = (t) =>
+  t.column ? t.column.toLowerCase() : (STATUS[t.status] ?? t.status);
+
 export function taskLine(t, { today, mine = false, width } = {}) {
   const open = t.status !== "done";
   const late = t.due && today && t.due < today && open;
   // Today and tomorrow in words, so what's close stands out from the dates.
   const soon = open && today && t.due ? soonWord(t.due, today) : null;
   const bits = [
-    STATUS[t.status] ?? t.status,
+    statusText(t),
     t.due ? (late ? `late, due ${t.due}` : soon ? `due ${soon}` : `due ${t.due}`) : null,
     t.priority && t.priority !== "medium" ? t.priority : null,
     mine ? null : t.assignee ? `${t.assignee}${t.alsoOn?.length ? ` +${t.alsoOn.length}` : ""}` : null,
@@ -115,6 +122,12 @@ const hiddenNote = (n, what) =>
  * Each portfolio's programs and their projects, indented, as harbor_overview
  * gives them. Programs and projects set to Done stay out unless `done`.
  */
+/** "starts 2026-11-02 · ends 2026-12-18", or whichever of the two it has. */
+const datesOf = (x) =>
+  [x.starts ? `starts ${x.starts}` : null, x.ends ? `ends ${x.ends}` : null]
+    .filter(Boolean)
+    .join(" · ") || null;
+
 export function programTree(r, { done = false } = {}) {
   const portfolios = r.portfolios ?? [];
   if (!portfolios.some((pf) => pf.programs.length)) {
@@ -129,7 +142,7 @@ export function programTree(r, { done = false } = {}) {
     if (portfolios.length > 1 && programs.length) out.push(pf.name);
     const pad = portfolios.length > 1 ? "  " : "";
     for (const pg of programs) {
-      const bits = [health(pg.health), pg.ends ? `ends ${pg.ends}` : null].filter(Boolean);
+      const bits = [health(pg.health), datesOf(pg)].filter(Boolean);
       out.push(`${pad}${pg.name}  (${bits.join(" · ")})`);
       const projects = pg.projects.filter(shown);
       hidden += pg.projects.length - projects.length;
@@ -138,7 +151,7 @@ export function programTree(r, { done = false } = {}) {
           health(pj.health),
           `${pj.openTasks} open`,
           pj.lateTasks ? `${pj.lateTasks} late` : null,
-          pj.ends ? `ends ${pj.ends}` : null,
+          datesOf(pj),
         ].filter(Boolean);
         out.push(`${pad}  ${pj.name}  (${work.join(" · ")})`);
       }
@@ -815,6 +828,34 @@ export function charterText(r) {
   return lines.join("\n");
 }
 
+const LANDFALL_RESULT = { yes: "Paid off", partly: "Partly", no: "Didn't" };
+
+/** A project's landfall as get_project, set_landfall or answer_landfall gives it. */
+export function landfallText(project, lf) {
+  if (!lf) {
+    return `${project} has no landfall yet. Say what should be true some days after it's Done:\n  harbor landfall "${project}" --expect "…" --after 90 [--measure "weekly sign-ups"]`;
+  }
+  const lines = [`Landfall · ${project}`, `  Looks like  ${lf.expect}`];
+  if (lf.measure) lines.push(`  Counting    ${lf.measure}`);
+  if (lf.result) {
+    const value =
+      lf.value != null ? ` · ${Number(lf.value).toLocaleString("en-US")}${lf.measure ? ` ${lf.measure}` : ""}` : "";
+    lines.push(`  Answer      ${LANDFALL_RESULT[lf.result] ?? lf.result}${value}`);
+    if (lf.note) lines.push(`              ${lf.note}`);
+    if (lf.answeredOn)
+      lines.push(`              said by ${lf.answeredBy ?? "someone"} on ${lf.answeredOn}`);
+  } else if (lf.state === "due") {
+    lines.push(
+      `  Due now     its day was ${lf.checkOn}. Answer: harbor landfall "${project}" --answer yes|partly|no [--value N]`,
+    );
+  } else if (lf.state === "waiting") {
+    lines.push(`  Check on    ${lf.checkOn} (${lf.afterDays} days after Done)`);
+  } else {
+    lines.push(`  Check       ${lf.afterDays} days after the project is marked Done`);
+  }
+  return lines.join("\n");
+}
+
 export function notesText(project, notes) {
   if (!notes?.length)
     return `No notes for later on ${project}. Leave one: harbor note "${project}" "NOTE" --opens +30`;
@@ -978,7 +1019,7 @@ export function agentWorkText(r) {
   const lines = [`Work for ${r.agent}${r.addedBy ? ` (added by ${r.addedBy})` : ""}`];
   if (!r.tasks?.length) lines.push("", "Nothing to do: no open tasks are assigned to it.");
   for (const t of r.tasks ?? []) {
-    const bits = [STATUS[t.status] ?? t.status, t.priority];
+    const bits = [statusText(t), t.priority];
     if (t.due) bits.push(`due ${t.due}`);
     lines.push(
       "",
@@ -1353,3 +1394,83 @@ export function messagesText(r) {
     ),
   ].join("\n\n");
 }
+
+const SIGN_OFF = {
+  pending: "waiting on the sign-off",
+  approved: "signed off",
+  changes_requested: "changes asked for",
+};
+
+/** One milestone's line: due, reached or late, its tasks, sign-off and waits. */
+export function milestoneLine(m, { program = true } = {}) {
+  const bits = [
+    m.reached ? "reached" : m.late ? `late, due ${m.due}` : `due ${m.due}`,
+    m.tasks
+      ? `${m.tasks.done} of ${m.tasks.total} task${m.tasks.total === 1 ? "" : "s"} done`
+      : null,
+    m.signOff
+      ? `${m.signOff.by ?? "someone"} signs off: ${SIGN_OFF[m.signOff.status] ?? m.signOff.status}${m.signOff.note ? ` (“${m.signOff.note}”)` : ""}`
+      : null,
+    m.waitsOn?.length
+      ? `waits on ${m.waitsOn.map((w) => `${w.project}${w.done ? " (done)" : ""}`).join(", ")}`
+      : null,
+    program && m.program ? m.program : null,
+  ].filter(Boolean);
+  return `${m.name}  (${bits.join(" · ")})`;
+}
+
+/** list_milestones: soonest first, the program named once when it's one. */
+export function milestonesText(r) {
+  const list = r.milestones ?? [];
+  const hidden = r.reachedHidden
+    ? `${r.reachedHidden} reached ${r.reachedHidden === 1 ? "one" : "ones"} not shown (--done shows them).`
+    : "";
+  if (!list.length) {
+    const none = r.program ? `${r.program} has no open milestones.` : "No open milestones.";
+    return [none, hidden || `Add one: harbor milestone "NAME" --new --program P --due DATE.`]
+      .filter(Boolean)
+      .join(" ");
+  }
+  return [
+    ...(r.program ? [`${r.program}:`] : []),
+    ...list.map((m) => `${r.program ? "  " : ""}${milestoneLine(m, { program: !r.program })}`),
+    ...(hidden ? [hidden] : []),
+  ].join("\n");
+}
+
+/** One goal in full, as list_goals gives it. */
+export function goalText(g, portfolio) {
+  const bits = [`${g.progress}%`, g.statusText.toLowerCase()];
+  if (g.owner) bits.push(g.owner);
+  if (g.due && g.status !== "achieved") bits.push(`by ${g.due}`);
+  return [
+    `${g.title}  (${bits.join(" · ")})`,
+    ...(portfolio ? [`In ${portfolio}.`] : []),
+    ...(g.why ? [`Why: ${g.why}`] : []),
+    ...(g.keyResults.length
+      ? g.keyResults.map(
+          (k) =>
+            `  ${k.title} · ${k.text}${k.kind === "work" && k.counts?.length ? ` (counts ${k.counts.join(", ")})` : ""}`,
+        )
+      : [`  No key results yet. harbor goal "${g.title}" --kr "TITLE" --target N adds one.`]),
+  ].join("\n");
+}
+
+/** list_dashboards: each dashboard, each chart's one-line text and its numbers. */
+export function reportsText(r) {
+  const list = r.dashboards ?? [];
+  if (!list.length) return "No dashboards yet. Make one on the website's Reports page.";
+  const out = [];
+  for (const d of list) {
+    if (out.length) out.push("");
+    out.push(d.name);
+    if (!d.charts.length) out.push("  No charts on it yet.");
+    for (const c of d.charts) {
+      out.push(
+        `  ${c.text}`,
+        `    ${c.counts} by ${c.splitBy.toLowerCase()}${c.from ? `, in ${c.from}` : ""}`,
+      );
+    }
+  }
+  return out.join("\n");
+}

package/package.json

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