@harborppm/cli 0.31.0 → 0.33.0

package/lib/cli.mjs

@@ -27,6 +27,7 @@ import {
   myWork,
   premortemText,
   voyageText,
+  handoverText,
   raidList,
   programTree,
   projectList,
@@ -110,11 +111,16 @@ export const HELP = `harbor: Harbor from the terminal
   harbor brief [--portfolio P] [--say]        the weekly brief, ready to send;
                                               --say reads it aloud as a
                                               shipping forecast
+  harbor report PROGRAM                       a program's status report
   harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
                                               a project's pre-mortem: start,
                                               answer or read it
   harbor voyage PROJECT ["YOUR LINE"]         a Done project's voyage log, and
                                               your line in it
+  harbor handover PERSON [--to NAME] [--until DATE] [--note TEXT]
+                         [--keep ID,ID] [--confirm]
+                                              hand someone's work to the crew
+  harbor handback PERSON                      give it back after time away
 
   Every command takes --json, and --harbor NAME when you're in more than one
   harbor (or set one with harbor use). harbor help COMMAND shows just that one.
@@ -283,6 +289,10 @@ const FLAG = {
   column: "the column",
   limit: "the limit",
   at: "--at",
+  until: "--until",
+  to: "--to",
+  keep: "--keep",
+  person: "the person",
 };
 
 /** Harbor's refusals are worded for agents; say them as the commands and flags that answer them. */
@@ -376,6 +386,21 @@ const DETAIL = {
     "  PROJECT is a name, a key like RR, or an id. When two projects share a",
     "  name, give the key.",
   ],
+  handover: [
+    "  harbor handover PERSON                 reads what would move, and to whom:",
+    "                                         their open tasks, sign-offs, risks",
+    "                                         and issues, and what they lead",
+    "  harbor handover PERSON --confirm       writes: hands it over as shown",
+    "",
+    "    --to NAME       all of it to one person, instead of who has room",
+    "    --until DATE    time away: they show as away, and harbor handback PERSON",
+    "                    (or People on the website) gives back what's still with",
+    "                    whoever took it",
+    '    --note "TEXT"   goes with each task and risk as a comment',
+    "    --keep ID,ID    leave these where they are (ids or keys from the list)",
+    "",
+    '  PERSON is a name, an id, or "me".',
+  ],
   voyage: [
     "  harbor voyage PROJECT                  reads a Done project's voyage log",
     '  harbor voyage PROJECT "YOUR LINE"      writes: adds or changes your line in it',
@@ -1266,6 +1291,12 @@ export async function run(argv, io = {}) {
         (r) => raidList(r, positionals.join(" ")),
       );
     }
+    case "report": {
+      const { positionals, harbor } = parse(spec([]));
+      const program = positionals.join(" ").trim();
+      if (!program) throw new HarborError('Give a program: harbor report "NAME".');
+      return call("status_report", { harbor, program }, (r) => r.markdown);
+    }
     case "premortem": {
       const { positionals, values, harbor } = parse(spec(["start"]));
       const [project, ...words] = positionals;
@@ -1333,6 +1364,52 @@ export async function run(argv, io = {}) {
       }
       return call("get_voyage_log", { harbor, project }, voyageText);
     }
+    case "handover": {
+      const { positionals, values, harbor } = parse(
+        spec(["confirm"], ["to", "until", "note", "keep"]),
+      );
+      const person = positionals.join(" ").trim();
+      if (!person) throw new HarborError('Say whose work: harbor handover "NAME" (or me).');
+      if (!values.confirm) {
+        return call("handover_plan", { harbor, person, to: values.to }, (r) => handoverText(r));
+      }
+      return call(
+        "hand_over",
+        {
+          harbor,
+          person,
+          to: values.to,
+          until: dueDate(values.until),
+          note: values.note,
+          keep: values.keep
+            ? values.keep
+                .split(",")
+                .map((k) => k.trim())
+                .filter(Boolean)
+            : undefined,
+        },
+        (r) => {
+          const h = r.handedOver;
+          const names = [...new Set(h.items.map((i) => i.to))];
+          const who =
+            names.length > 1 ? `${names.slice(0, -1).join(", ")} and ${names.at(-1)}` : names[0];
+          const moved = `Handed ${h.person}'s work over: ${h.moved} ${h.moved === 1 ? "thing" : "things"}${who ? ` to ${who}` : ""}.`;
+          return h.awayUntil
+            ? `${moved} ${h.person} shows as away until ${h.awayUntil}; harbor handback "${h.person}" gives it back.`
+            : moved;
+        },
+      );
+    }
+    case "handback": {
+      const { positionals, harbor } = parse(spec());
+      const person = positionals.join(" ").trim();
+      if (!person) throw new HarborError('Say who is back: harbor handback "NAME".');
+      return call("hand_back", { harbor, person }, (r) =>
+        r.handedBack.moved
+          ? `Handed ${r.handedBack.moved} back to ${r.handedBack.person}.`
+          : `${r.handedBack.person} is back. Nothing was still waiting to go back.`,
+      );
+    }
     case "risk":
     case "issue":
     case "decision": {

package/lib/format.mjs

@@ -369,3 +369,30 @@ export function hillList(r) {
   }
   return blocks.join("\n\n");
 }
+
+/** handover_plan as a list grouped like the website's dialog, each line with who takes it. */
+export function handoverText(r, { confirmHint = true } = {}) {
+  const items = r.items ?? [];
+  if (items.length === 0) return `${r.person} has nothing open to hand over.`;
+  const lines = [
+    `Hand over ${r.person}'s work${r.awayUntil ? ` (away until ${r.awayUntil})` : ""}`,
+  ];
+  let group = null;
+  for (const i of items) {
+    if (i.group !== group) {
+      group = i.group;
+      lines.push("", `${group}:`);
+    }
+    lines.push(
+      `  ${i.what}${i.due && i.kind !== "project" && i.kind !== "program" ? ` (${i.due})` : ""}  → ${i.to ?? "nobody yet"}`,
+    );
+  }
+  const room = (r.takers ?? []).filter((t) => t.note).map((t) => `${t.who} ${t.note}`);
+  if (room.length) lines.push("", `This week: ${room.join(", ")}.`);
+  if (confirmHint)
+    lines.push(
+      "",
+      'Nothing has moved yet. Add --confirm to hand it over, --until DATE for time away, --note "…" to send a note with it, --to NAME to give it all to one person, or --keep ID,ID to leave some where it is.',
+    );
+  return lines.join("\n");
+}

package/package.json

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