@harborppm/cli 0.72.0 → 0.74.0

package/lib/cli.mjs

@@ -112,7 +112,8 @@ export const HELP = `harbor: Harbor from the terminal
   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 mine                                 what's on you, late first, and
+                                              what you're also on
   harbor catchup [--since DATE]               while you were away: handed to
                                               you, decided, what moved
   harbor clock [NAME] [--zone ZONE|here|none] [--hours 9-17]
@@ -123,8 +124,11 @@ export const HELP = `harbor: Harbor from the terminal
                                               the first 20 (--all: every one);
                                               done ones only with --status done
   harbor show TASK                            one task (TASK: a key like RR-42),
-                                              with the date its owner's queue
-                                              suggests
+                                              who's on it, its files, and the
+                                              date its owner's queue suggests
+  harbor files PROJECT [--kind image|doc|link]
+                                              every file on a project's tasks,
+                                              newest first
   harbor open [TASK|PROJECT]                  open it on the website (or Today)
   harbor invite EMAIL [--viewer]              invite someone to your harbor
   harbor prompt [--shell SHELL] [--refresh]   due today and late, for your
@@ -157,7 +161,8 @@ export const HELP = `harbor: Harbor from the terminal
                                               --from: plan it from a finished
                                               project as that one really ran
   harbor add "TITLE" [--project P] [--assignee me|none|NAME]
-                     [--due DATE|pilot] [--priority low|medium|high|urgent]
+                     [--also "NAME, NAME"] [--due DATE|pilot]
+                     [--priority low|medium|high|urgent]
                      [--status S] [--comment TEXT] [--over-limit] [--dry-run]
                                               with no TITLE: one title a line
                                               from stdin; --due pilot takes the
@@ -167,7 +172,7 @@ export const HELP = `harbor: Harbor from the terminal
                                               move a task to In play, In review
                                               or Done
   harbor edit TASK [--title T] [--assignee me|none|NAME]
-                   [--due DATE|pilot|none]
+                   [--also "NAME, NAME"|none] [--due DATE|pilot|none]
                    [--priority P] [--status S] [--notes TEXT]
                    [--repeat weekly|biweekly|monthly|never]
                    [--waits-on TASK,TASK|none] [--confirm] [--over-limit]
@@ -608,7 +613,7 @@ export function hint(message, project) {
     )
     .replace(
       /^Nothing to change: pass a field to update\.$/,
-      "Nothing to change. Say what with --title, --assignee, --due, --priority, --status, --notes, --repeat or --waits-on.",
+      "Nothing to change. Say what with --title, --assignee, --also, --due, --priority, --status, --notes, --repeat or --waits-on.",
     )
     .replace(
       /^This connection was allowed to read only\..*$/s,
@@ -642,6 +647,24 @@ export function voyageForTerminal(r, project = r.project) {
   };
 }
 
+/** --also "Sam, Aya" as the names; none (or nobody) leaves only the owner. */
+export function alsoList(value) {
+  const v = value.trim();
+  if (/^(none|nobody)$/i.test(v)) return [];
+  const names = v
+    .split(",")
+    .map((x) => x.trim())
+    .filter(Boolean);
+  if (!names.length) throw new HarborError('Say who: --also "NAME, NAME", or --also none.');
+  return names;
+}
+
+/** One file: its name and kind, a link's address, who added it and when. */
+export function fileText(f) {
+  const kind = { image: "image", doc: "document", link: "link" }[f.kind] ?? f.kind;
+  return `${f.name} (${kind}${f.url ? `, ${f.url}` : ""}) · ${f.addedBy ?? "someone"}, ${f.added}`;
+}
+
 /** Commands whose forms do different things: one line each, saying which read and which write. */
 const DETAIL = {
   add: [
@@ -654,7 +677,8 @@ const DETAIL = {
     "  --project can be left out when the harbor has one open project (First",
     "  voyage aside); the task goes there.",
     "",
-    "  --assignee me|none|NAME, --due DATE|pilot, --priority low|medium|high|urgent,",
+    "  --assignee me|none|NAME, --also \"NAME, NAME\" (others on it with the",
+    "  owner), --due DATE|pilot, --priority low|medium|high|urgent,",
     "  --status S, --comment TEXT and --over-limit apply to every task added, so",
     "  ten lines with --comment add the same comment to all ten. More than 100",
     "  lines is harbor import's job.",
@@ -961,8 +985,9 @@ const DETAIL = {
   ],
   watch: [
     "  harbor watch                           reads, live: each change to the harbor",
-    "                                         as it lands, one line with the time:",
-    "                                         cards moving, comments, health changes",
+    "                                         as it lands, one line with its time",
+    "                                         and zone: cards moving, comments,",
+    "                                         health changes",
     "    --project P     one project's changes only",
     "    --bell          ring the terminal's bell when something of yours changes",
     "    --since TIME    start with every change since TIME (14:30 today, or",
@@ -2088,6 +2113,25 @@ export async function run(argv, io = {}) {
       out(asJson ? jsonText(result) : plain(taskList(result, opts)));
       return 0;
     }
+    case "files": {
+      const { positionals, values, harbor } = parse(spec([], ["kind"]));
+      const project = text(positionals, "the project");
+      const kind = values.kind?.trim().toLowerCase().replace(/s$/, "");
+      if (kind !== undefined && !["image", "doc", "link"].includes(kind))
+        throw new HarborError("--kind is image, doc or link.");
+      return call("list_files", { harbor, project, kind, limit: 200 }, (r) =>
+        r.files.length
+          ? [
+              `${r.project}: ${r.total} file${r.total === 1 ? "" : "s"}${kind ? ` (${kind}s)` : ""}`,
+              "",
+              ...r.files.map(
+                (f) => `${fileText(f)}  on ${f.task.key ?? f.task.id} ${f.task.title}`,
+              ),
+              ...(r.total > r.files.length ? [`…and ${r.total - r.files.length} more.`] : []),
+            ].join("\n")
+          : `No ${kind ? `${kind}s` : "files"} on ${r.project}'s tasks yet. Attach them to a task on the website.`,
+      );
+    }
     case "show": {
       const { positionals, harbor } = parse(spec());
       return call("get_task", { harbor, task: one(positionals, "task key, like RR-42") }, (t) => {
@@ -2097,6 +2141,7 @@ export async function run(argv, io = {}) {
             { ...opts, width: undefined },
           ),
         ];
+        if (t.alsoOn?.length) lines.push(`Also on it: ${t.alsoOn.join(", ")}.`);
         if (t.repeats) lines.push(`Repeats ${REPEAT_WORD[t.repeats] ?? t.repeats}.`);
         if (t.pilotDue?.fits) lines.push(`${t.pilotDue.says}, so the due date holds.`);
         else if (t.pilotDue) lines.push(...pilotLines({ pilot: t.pilotDue }, t));
@@ -2119,6 +2164,7 @@ export async function run(argv, io = {}) {
               (w) => `  ${w.key ?? w.id}  ${w.title} (${STATUS[w.status] ?? w.status})`,
             ),
           );
+        if (t.files?.length) lines.push("", "Files:", ...t.files.map((f) => `  ${fileText(f)}`));
         if (t.comments.length)
           lines.push(
             "",
@@ -2337,7 +2383,7 @@ export async function run(argv, io = {}) {
       const { positionals, values, harbor } = parse(
         spec(
           ["over-limit", "dry-run"],
-          ["project", "assignee", "due", "priority", "status", "comment"],
+          ["project", "assignee", "also", "due", "priority", "status", "comment"],
         ),
       );
       // No --project: the harbor's one open project, if that's all there is.
@@ -2413,6 +2459,7 @@ export async function run(argv, io = {}) {
             title,
             // Yours unless you say otherwise, as with n in the app.
             assignee: values.assignee ?? "me",
+            also: values.also === undefined ? undefined : alsoList(values.also),
             due: duePilot(values.due) ? undefined : dueDate(values.due),
             suggestedDue: duePilot(values.due),
             priority: values.priority,
@@ -2526,7 +2573,17 @@ export async function run(argv, io = {}) {
       const { positionals, values, harbor } = parse(
         spec(
           ["confirm", "over-limit"],
-          ["title", "assignee", "due", "priority", "status", "notes", "repeat", "waits-on"],
+          [
+            "title",
+            "assignee",
+            "also",
+            "due",
+            "priority",
+            "status",
+            "notes",
+            "repeat",
+            "waits-on",
+          ],
         ),
       );
       const waits = values["waits-on"];
@@ -2537,6 +2594,7 @@ export async function run(argv, io = {}) {
           task: one(positionals, "task key, like RR-42"),
           title: values.title,
           assignee: values.assignee,
+          also: values.also === undefined ? undefined : alsoList(values.also),
           due:
             values.due === undefined || duePilot(values.due)
               ? undefined
@@ -2561,6 +2619,11 @@ export async function run(argv, io = {}) {
         (r) =>
           [
             `Updated: ${taskLine(r.updated, opts)}`,
+            values.also !== undefined
+              ? r.updated.alsoOn?.length
+                ? `Also on it: ${r.updated.alsoOn.join(", ")}.`
+                : "Only the owner is on it now."
+              : null,
             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) : []),

package/lib/format.mjs

@@ -39,7 +39,7 @@ export function taskLine(t, { today, mine = false, width } = {}) {
     STATUS[t.status] ?? t.status,
     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 ?? null),
+    mine ? null : t.assignee ? `${t.assignee}${t.alsoOn?.length ? ` +${t.alsoOn.length}` : ""}` : null,
     t.project ?? null,
     t.waitingOn ? `waits on ${t.waitingOn}` : null,
   ].filter(Boolean);
@@ -72,6 +72,8 @@ export function myWork(w, opts) {
   if (!w.you) return w.note ?? "Nothing is yours in this harbor yet.";
   const out = [`${w.you}: ${w.openTasks} open${w.late ? `, ${w.late} late` : ""}`];
   if (w.tasks?.length) out.push("", ...w.tasks.map((t) => taskLine(t, { ...opts, mine: true })));
+  if (w.alsoOn?.length)
+    out.push("", "Also on (others own these):", ...w.alsoOn.map((t) => `  ${taskLine(t, opts)}`));
   if (w.waitingOnYou?.length) {
     out.push("", "Waiting on you:");
     for (const x of w.waitingOnYou)

package/package.json

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