@harborppm/cli 0.11.2 → 0.13.0

package/lib/cli.mjs

@@ -19,6 +19,7 @@ import {
 import {
   harbors,
   myWork,
+  raidList,
   programTree,
   projectList,
   taskLine,
@@ -59,13 +60,18 @@ export const HELP = `harbor: Harbor from the terminal
                      [--over-limit]
   harbor start TASK | review TASK | done TASK [--confirm] [--over-limit]
   harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|none]
-                   [--priority P] [--status S] [--confirm] [--over-limit]
+                   [--priority P] [--status S] [--notes TEXT]
+                   [--repeat weekly|biweekly|monthly|never]
+                   [--waits-on TASK,TASK|none] [--confirm] [--over-limit]
   harbor comment TASK "TEXT"
   harbor checkin "WHAT YOU'RE DOING" [--on-blocker]
   harbor risk "TITLE" --project P|--program P [--impact 1-5] [--probability 1-5]
                      [--owner NAME] [--due DATE]
   harbor issue "TITLE" --project P|--program P [--impact 1-5] [--owner NAME]
                        [--due DATE]
+  harbor decision "TITLE" --project P|--program P [--owner NAME] [--due DATE]
+  harbor risks [words] [--kind risk,issue,decision] [--project P] [--closed]
+                                              the register, worst first
 
   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.
@@ -144,6 +150,7 @@ const level = (v, name) => {
   return n;
 };
 const nullable = (v) => (v === "none" ? null : v);
+const REPEAT_WORD = { weekly: "every week", biweekly: "every two weeks", monthly: "every month" };
 
 /** --due as people say it: today, tomorrow, +3, or a date. Anything else goes to Harbor to judge. */
 export function dueDate(v, today = new Date()) {
@@ -176,6 +183,9 @@ const FLAG = {
   query: "the words",
   task: "the task",
   note: "the check-in",
+  waitsOn: "--waits-on",
+  repeat: "--repeat",
+  description: "--notes",
   body: "the comment",
 };
 
@@ -213,7 +223,7 @@ export function hint(message) {
     .replace(/Find it with search_tasks\.$/, "Find it with harbor tasks.")
     .replace(
       /^Nothing to change: pass a field to update\.$/,
-      "Nothing to change. Say what with --title, --assignee, --due, --priority or --status.",
+      "Nothing to change. Say what with --title, --assignee, --due, --priority, --status, --notes, --repeat or --waits-on.",
     )
     .replace(
       /^This connection was allowed to read only\..*$/s,
@@ -782,8 +792,12 @@ export async function run(argv, io = {}) {
     }
     case "edit": {
       const { positionals, values, harbor } = parse(
-        spec(["confirm", "over-limit"], ["title", "assignee", "due", "priority", "status"]),
+        spec(
+          ["confirm", "over-limit"],
+          ["title", "assignee", "due", "priority", "status", "notes", "repeat", "waits-on"],
+        ),
       );
+      const waits = values["waits-on"];
       return call(
         "update_task",
         {
@@ -794,10 +808,28 @@ export async function run(argv, io = {}) {
           due: values.due === undefined ? undefined : nullable(dueDate(values.due)),
           priority: values.priority,
           status: values.status,
+          description: values.notes,
+          repeat: values.repeat,
+          waitsOn:
+            waits === undefined
+              ? undefined
+              : waits === "none"
+                ? []
+                : waits
+                    .split(",")
+                    .map((x) => x.trim())
+                    .filter(Boolean),
           confirmed: values.confirm || undefined,
           overLimit: values["over-limit"] || undefined,
         },
-        (r) => `Updated: ${taskLine(r.updated, opts)}`,
+        (r) =>
+          [
+            `Updated: ${taskLine(r.updated, opts)}`,
+            r.updated.waitsOn ? `Waits on ${r.updated.waitsOn.join(", ")}.` : null,
+            r.updated.repeat ? `Repeats ${REPEAT_WORD[r.updated.repeat]}.` : null,
+          ]
+            .filter(Boolean)
+            .join("\n"),
       );
     }
     case "comment": {
@@ -823,13 +855,34 @@ export async function run(argv, io = {}) {
         () => "Checked in for today.",
       );
     }
+    case "risks": {
+      const { positionals, values, harbor } = parse(spec(["closed"], ["kind", "project"]));
+      const kind = values.kind
+        ?.split(",")
+        .map((x) => x.trim().replace(/s$/, ""))
+        .filter(Boolean);
+      const bad = kind?.find((k) => !["risk", "issue", "decision"].includes(k));
+      if (bad) throw new HarborError(`--kind is risk, issue or decision (not "${bad}").`);
+      return call(
+        "list_risks",
+        {
+          harbor,
+          kind,
+          project: values.project,
+          includeClosed: Boolean(values.closed),
+          limit: 50,
+        },
+        (r) => raidList(r, positionals.join(" ")),
+      );
+    }
     case "risk":
-    case "issue": {
+    case "issue":
+    case "decision": {
       const { positionals, values, harbor } = parse(
         spec(
           [],
-          ["project", "program", "owner", "impact", "due"].concat(
-            command === "risk" ? ["probability"] : [],
+          ["project", "program", "owner", "due"].concat(
+            command === "risk" ? ["impact", "probability"] : command === "issue" ? ["impact"] : [],
           ),
         ),
       );

package/lib/format.mjs

@@ -158,3 +158,28 @@ export function todayLocal(d = new Date()) {
   const p = (n) => String(n).padStart(2, "0");
   return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
 }
+
+/** The register, worst first: kind, title, then status, scores, owner and where it sits. */
+export function raidList(r, words = "") {
+  const want = words.trim().toLowerCase();
+  const items = (r.items ?? []).filter(
+    (x) => !want || `${x.title} ${x.description ?? ""}`.toLowerCase().includes(want),
+  );
+  if (!items.length) return want ? "Nothing in the register matches." : "The register is clear.";
+  const lines = items.map((x) => {
+    const bits = [
+      x.status?.toLowerCase(),
+      x.probability != null ? `likelihood ${x.probability}` : null,
+      x.impact != null ? `impact ${x.impact}` : null,
+      x.owner,
+      x.project ?? x.program ?? x.portfolio ?? null,
+      x.due ? `${x.kind === "Decision" ? "decide by" : "review by"} ${x.due}` : null,
+    ].filter(Boolean);
+    return `${x.kind.toLowerCase().padEnd(8)}  ${x.title}  (${bits.join(" · ")})`;
+  });
+  const more =
+    !want && r.total > items.length
+      ? `\n…and ${r.total - items.length} more. Narrow it with --kind or --project.`
+      : "";
+  return lines.join("\n") + more;
+}

package/package.json

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