@harborppm/cli 0.55.0 → 0.56.0

package/README.md

@@ -148,11 +148,13 @@ harbor project "NAME" --program P [--lead me|NAME] [--starts DATE]
                      [--ends DATE] [--budget N] [--from "DONE PROJECT"]
                                             --from: dead reckoning, its tasks due when
                                             they really finished in that project
-harbor add "TITLE" --project P [--assignee me|NAME] [--due DATE]
+harbor add "TITLE" --project P [--assignee me|NAME] [--due DATE|pilot]
                    [--priority low|medium|high|urgent] [--status S] [--comment TEXT]
                    [--over-limit]               no TITLE: one title a line from stdin
+                                            --due pilot takes the date the owner's queue suggests;
+                                            a date that won't hold says so
 harbor start TASK | submit TASK | done TASK [--confirm] [--over-limit]
-harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|none]
+harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|pilot|none]
                  [--priority P] [--status S] [--notes TEXT]
                  [--repeat weekly|biweekly|monthly|never]
                  [--waits-on TASK,TASK|none] [--confirm] [--over-limit]

package/lib/cli.mjs

@@ -135,15 +135,17 @@ export const HELP = `harbor: Harbor from the terminal
                        [--ends DATE] [--budget N] [--from "DONE PROJECT"]
                                               --from: plan it from a finished
                                               project as that one really ran
-  harbor add "TITLE" --project P [--assignee me|none|NAME] [--due DATE]
-                     [--priority low|medium|high|urgent] [--status S]
-                     [--comment TEXT] [--over-limit]
+  harbor add "TITLE" --project P [--assignee me|none|NAME]
+                     [--due DATE|pilot] [--priority low|medium|high|urgent]
+                     [--status S] [--comment TEXT] [--over-limit]
                                               with no TITLE: one title a line
-                                              from stdin
+                                              from stdin; --due pilot takes the
+                                              date the owner's queue suggests
   harbor start TASK | submit TASK | done TASK [--confirm] [--over-limit]
                                               move a task to In play, In review
                                               or Done
-  harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|none]
+  harbor edit TASK [--title T] [--assignee me|none|NAME]
+                   [--due DATE|pilot|none]
                    [--priority P] [--status S] [--notes TEXT]
                    [--repeat weekly|biweekly|monthly|never]
                    [--waits-on TASK,TASK|none] [--confirm] [--over-limit]
@@ -378,6 +380,21 @@ export function dueDate(v, today = new Date()) {
   return todayLocal(d);
 }
 
+/** --due pilot: the date the owner's queue suggests, set by Harbor. */
+const PILOT = new Set(["pilot", "suggested"]);
+const duePilot = (v) => (v !== undefined && PILOT.has(v.toLowerCase()) ? true : undefined);
+
+/** Pilot's word when the date given won't hold: what the queue says, why, and how to take it. */
+function pilotLines(r, task) {
+  const p = r.pilot;
+  if (!p) return [];
+  const ref = task.key ?? task.id;
+  return [
+    `${p.says}: ${p.why.map((w, i) => (i ? w.charAt(0).toLowerCase() + w.slice(1) : w)).join("; ")}.`,
+    `harbor edit ${ref} --due pilot takes ${p.earliest}.`,
+  ];
+}
+
 /** Harbor's tool fields, as the CLI's flags. */
 const FLAG = {
   due: "--due",
@@ -1991,7 +2008,8 @@ export async function run(argv, io = {}) {
           title,
           // Yours unless you say otherwise, as with n in the app.
           assignee: values.assignee ?? "me",
-          due: dueDate(values.due),
+          due: duePilot(values.due) ? undefined : dueDate(values.due),
+          suggestedDue: duePilot(values.due),
           priority: values.priority,
           status: values.status === undefined ? undefined : statusWord(values.status),
           overLimit: values["over-limit"] || undefined,
@@ -2018,7 +2036,13 @@ export async function run(argv, io = {}) {
         out(
           plain(
             added
-              .map((r) => `Added: ${taskLine(r.created, opts)}${r.comment ? ", with your comment" : ""}`)
+              .map((r) =>
+                [
+                  `Added: ${taskLine(r.created, opts)}${r.comment ? ", with your comment" : ""}`,
+                  // Pilot speaks up only when a date was given that the queue says won't hold.
+                  ...(values.due ? pilotLines(r, r.created) : []),
+                ].join("\n"),
+              )
               .join("\n"),
           ),
         );
@@ -2099,7 +2123,11 @@ export async function run(argv, io = {}) {
           task: one(positionals, "task key, like RR-42"),
           title: values.title,
           assignee: values.assignee,
-          due: values.due === undefined ? undefined : nullable(dueDate(values.due)),
+          due:
+            values.due === undefined || duePilot(values.due)
+              ? undefined
+              : nullable(dueDate(values.due)),
+          suggestedDue: duePilot(values.due),
           priority: values.priority,
           status: values.status === undefined ? undefined : statusWord(values.status),
           description: values.notes,
@@ -2121,6 +2149,7 @@ export async function run(argv, io = {}) {
             `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,
+            ...(values.due && !duePilot(values.due) ? pilotLines(r, r.updated) : []),
           ]
             .filter(Boolean)
             .join("\n"),

package/package.json

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