@harborppm/cli 0.47.0 → 0.48.0

package/lib/cli.mjs

@@ -35,6 +35,7 @@ import {
   notesText,
   voyageText,
   handoverText,
+  fogText,
   agentWorkText,
   raidDetail,
   raidList,
@@ -178,6 +179,10 @@ export const HELP = `harbor: Harbor from the terminal
                          [--keep ID,ID] [--confirm]
                                               hand someone's work to the crew
   harbor handback PERSON                      give it back after time away
+  harbor fog [--project P] [--list]           tasks nobody has touched for three
+                                              weeks, one at a time: still
+                                              needed, a new date, or drop it
+  harbor fog keep TASK                        it's still needed: out of the fog
   harbor agent [--agent NAME]                 the tasks given to an AI agent on
                                               the crew, in the order to do them
   harbor agent report TASK "WHAT YOU DID" [--start] [--agent NAME]
@@ -190,7 +195,8 @@ export const HELP = `harbor: Harbor from the terminal
   "to do", "in play"; --json says doing for In play).
   DATE: YYYY-MM-DD, today, tomorrow, or +N for N days from today.
   Changes show in Harbor's History as yours, "via Harbor CLI". These commands
-  never delete; the full-screen app can, as the website can, and asks first.
+  never delete; the full-screen app can, as the website can, and asks first,
+  and so can harbor fog's x (drop it), one task at a time.
 `;
 
 export const VERSION = JSON.parse(
@@ -628,6 +634,20 @@ const DETAIL = {
     "",
     '  PERSON is a name, an id, or "me".',
   ],
+  fog: [
+    "  harbor fog [--project P]               in a terminal: the tasks in fog, one",
+    "                                         at a time. k still needed (clears the",
+    "                                         fog), d a new date, x drop it, s skip,",
+    "                                         q stop; then it saves what you chose",
+    "  harbor fog --list                      reads them: open tasks nobody has",
+    "                                         opened, moved, edited or commented on",
+    "                                         for three weeks, longest first",
+    "  harbor fog keep TASK                   writes: it's still needed, so it",
+    "                                         leaves the fog",
+    "",
+    "  Piped, or with --json, it lists. The one-at-a-time sweep needs full access",
+    "  (harbor login without --read-only), since dropping a task deletes it.",
+  ],
   handback: [
     "  harbor handback PERSON                 writes, straight away: gives back",
     "                                         what was handed over for their time",
@@ -2045,6 +2065,36 @@ export async function run(argv, io = {}) {
       }
       return call("get_voyage_log", { harbor, project }, voyageText, voyageForTerminal);
     }
+    case "fog": {
+      const { positionals, values, harbor } = parse(spec(["list"], ["project"]));
+      if (positionals[0] === "keep") {
+        const task = one(positionals.slice(1), "task");
+        return call(
+          "keep_task",
+          { harbor, task },
+          (r) => `Kept ${r.kept.key ?? r.kept.task} out of the fog: it counts as touched today.`,
+        );
+      }
+      none(positionals);
+      const terminal = io.terminal ?? Boolean(process.stdout.isTTY && process.stdin.isTTY);
+      if (terminal && !values.list && !asJson && hasFullAccess(creds)) {
+        const { fogHere } = await loadApp();
+        await fogHere({
+          source: tokenSource({ creds, save: (c) => writeCredentials(c, env), fetcher }),
+          fetcher,
+          harbor,
+          saved: creds.harbor ?? null,
+          project: values.project,
+        });
+        await stalePromptCache(env);
+        return 0;
+      }
+      return call(
+        "fog",
+        { harbor, project: values.project, limit: 100 },
+        (r) => fogText(r),
+      );
+    }
     case "handover": {
       const { positionals, values, harbor } = parse(
         spec(["confirm"], ["to", "until", "note", "keep"]),

package/lib/format.mjs

@@ -705,3 +705,25 @@ export function exportData(r) {
     rows: body.map((cells) => Object.fromEntries(columns.map((c, i) => [c, cells[i] ?? ""]))),
   };
 }
+
+/** fog: the open tasks nobody has touched for three weeks, longest first. */
+export function fogText(r, { sweepHint = true } = {}) {
+  const where = r.project ? ` in ${r.project}` : "";
+  if (!r.inFog) return `No fog${where}: every open task was touched in the last three weeks.`;
+  const lines = [
+    `${r.inFog} ${r.inFog === 1 ? "task" : "tasks"} in fog${where}: nobody has opened, moved or commented on ${r.inFog === 1 ? "it" : "them"} for three weeks.`,
+    "",
+  ];
+  for (const t of r.tasks) {
+    const bits = [t.untouched, r.project ? null : t.project, t.due ? `due ${t.due}` : null];
+    lines.push(`  ${(t.key ?? "").padEnd(7)} ${t.title}`);
+    lines.push(`          ${bits.filter(Boolean).join(" · ")}`);
+  }
+  if (r.more) lines.push("", `And ${r.inFog - r.tasks.length} more.`);
+  if (sweepHint)
+    lines.push(
+      "",
+      "In a terminal, harbor fog walks through them one at a time: k still needed, d new date, x drop it. harbor fog keep TASK keeps one.",
+    );
+  return lines.join("\n");
+}

package/package.json

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