@harborppm/cli 0.47.0 → 0.49.0

package/lib/cli.mjs

@@ -33,8 +33,12 @@ import {
   myWork,
   premortemText,
   notesText,
+  daysText,
+  soundingText,
+  soundingsText,
   voyageText,
   handoverText,
+  fogText,
   agentWorkText,
   raidDetail,
   raidList,
@@ -174,10 +178,20 @@ export const HELP = `harbor: Harbor from the terminal
   harbor note PROJECT ["NOTE"] [--opens DATE|--milestone NAME|--off-track]
                                               a note for later: sealed until
                                               its day, milestone, or Off track
+  harbor sound TASK [DAYS] [--why TEXT] [--ask NAMES|crew] [--settle DAYS]
+                                              a sounding: ask a few people how
+                                              many days a task will take, give
+                                              your answer, or read the spread
+  harbor soundings [PROJECT]                  open tasks with a sounding, and
+                                              the ones waiting on your answer
   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
+  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 +204,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(
@@ -363,6 +378,9 @@ const FLAG = {
   to: "--to",
   keep: "--keep",
   person: "the person",
+  days: "the days",
+  why: "--why",
+  people: "--ask",
 };
 
 /** Harbor's refusals are worded for agents; say them as the commands and flags that answer them. */
@@ -600,6 +618,25 @@ const DETAIL = {
     "  --no-people. A task already in its project is left alone: by its key",
     "  (a Key column, as harbor export writes) or by title.",
   ],
+  sound: [
+    "  harbor sound TASK                      reads its sounding: who hasn't answered,",
+    "                                         and the spread once everyone has",
+    "  harbor sound TASK --ask crew           writes: asks you, its owner and whoever",
+    "                                         has open work on its project",
+    '  harbor sound TASK --ask "Sam,Priya"    writes: asks those people',
+    '  harbor sound TASK 4 [--why "TEXT"]     writes: your answer, in working days',
+    "  harbor sound TASK --settle 6           writes: the days you agreed on after",
+    "                                         talking a wide spread through",
+    "",
+    "  Each person answers alone, and nobody sees the others' numbers until",
+    "  everyone has. Close guesses give the task an estimate; far-apart ones",
+    "  say talk first. The forecast draws on every answer.",
+  ],
+  soundings: [
+    "  harbor soundings [PROJECT]             reads: open tasks with a sounding",
+    "                                         (all projects when left out), and the",
+    "                                         ones waiting on your answer",
+  ],
   note: [
     "  harbor note PROJECT                    reads its notes for later: who left",
     "                                         each, what opens it, and the opened ones",
@@ -628,6 +665,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",
@@ -2031,6 +2082,65 @@ export async function run(argv, io = {}) {
         (r) => `Sealed your note on ${r.sealed.project}. It ${r.sealed.opens}.`,
       );
     }
+    case "sound": {
+      const { positionals, values, harbor } = parse(spec([], ["why", "ask", "settle"]));
+      const [task, days, ...extra] = positionals;
+      if (!task) throw new HarborError("Give a task's key, like harbor sound RR-4.");
+      if (extra.length) throw new HarborError(`Unexpected "${extra.join(" ")}".`);
+      const number = (text) => {
+        const n = Number(String(text).replace(/d(ays?)?$/i, ""));
+        if (!Number.isFinite(n) || n <= 0)
+          throw new HarborError(`Give days as a number, like 3 or 2.5 (not "${text}").`);
+        return n;
+      };
+      const given = [days !== undefined, values.ask !== undefined, values.settle !== undefined];
+      if (given.filter(Boolean).length > 1)
+        throw new HarborError("Answer, ask or settle: one at a time.");
+      if (values.why !== undefined && days === undefined)
+        throw new HarborError('--why goes with your answer: harbor sound TASK 4 --why "TEXT".');
+      if (values.ask !== undefined) {
+        const crew = /^crew$/i.test(values.ask.trim())
+          ? undefined
+          : values.ask
+              .split(",")
+              .map((x) => x.trim())
+              .filter(Boolean);
+        return call(
+          "take_sounding",
+          { harbor, task, ...(crew ? { people: crew } : {}) },
+          (r) =>
+            `Asked ${r.asked.people.join(", ")} how many days ${r.asked.key ?? r.asked.title} will take. The answers show together once everyone's in.`,
+        );
+      }
+      if (values.settle !== undefined) {
+        return call(
+          "settle_sounding",
+          { harbor, task, days: number(values.settle) },
+          (r) => `Settled ${r.settled.key ?? r.settled.title} at ${daysText(r.settled.days)}.`,
+        );
+      }
+      if (days !== undefined) {
+        return call(
+          "answer_sounding",
+          { harbor, task, days: number(days), ...(values.why ? { why: values.why } : {}) },
+          (r) => soundingText(r.answered, r.sounding, { answered: true }),
+        );
+      }
+      return call(
+        "get_task",
+        { harbor, task },
+        (r) => soundingText(r, r.sounding ?? null),
+        (r) => ({ id: r.id, key: r.key ?? null, title: r.title, sounding: r.sounding ?? null }),
+      );
+    }
+    case "soundings": {
+      const { positionals, harbor } = parse(spec());
+      const [project, ...extra] = positionals;
+      if (extra.length) throw new HarborError(`Unexpected "${extra.join(" ")}".`);
+      return call("list_soundings", { harbor, ...(project ? { project } : {}) }, (r) =>
+        soundingsText(r),
+      );
+    }
     case "voyage": {
       const { positionals, harbor } = parse(spec());
       const [project, ...words] = positionals;
@@ -2045,6 +2155,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

@@ -600,6 +600,78 @@ export function notesText(project, notes) {
   return lines.join("\n");
 }
 
+/** "half a day", "1 day", "2.5 days". */
+export function daysText(days) {
+  if (days === 0.5) return "half a day";
+  return `${days} day${days === 1 ? "" : "s"}`;
+}
+
+/** The spread as a line of dots, 0 to the highest guess, like the website's. */
+function spreadLine(answers, width = 30) {
+  const days = answers.map((a) => a.days);
+  const top = Math.max(5, ...days);
+  const cells = Array(width + 1).fill("·");
+  for (const d of days) cells[Math.round((d / top) * width)] = "●";
+  return `0 ${cells.join("")} ${daysText(top)}`;
+}
+
+/** One task's sounding: who's left to answer, or the spread and what it means. */
+export function soundingText(task, s, { answered = false } = {}) {
+  const name = task.key ? `${task.key} ${task.title}` : task.title;
+  if (!s)
+    return `No sounding on ${name}. Ask the crew: harbor sound ${task.key ?? task.id} --ask crew`;
+  const lines = [`Sounding · ${name} · ${s.answered} of ${s.crew.length} answered`];
+  if (answered) lines[0] = `Your answer is in. ${lines[0]}`;
+  if (!s.shown) {
+    if (s.waitingOn.length) lines.push(`  Waiting on ${s.waitingOn.join(", ")}.`);
+    lines.push("  The answers show together once everyone's in.");
+    for (const a of s.answers)
+      lines.push(`  You said ${daysText(a.days)}${a.why ? ` · "${a.why}"` : ""}`);
+    if (s.youWereAsked && !s.answers.length)
+      lines.push(`  Give yours: harbor sound ${task.key ?? task.id} DAYS`);
+    return lines.join("\n");
+  }
+  lines.push(`  ${spreadLine(s.answers)}`);
+  for (const a of s.answers)
+    lines.push(`  ${a.who}: ${daysText(a.days)}${a.why ? ` · "${a.why}"` : ""}`);
+  if (s.settled) lines.push(`  Settled on ${daysText(s.estimateDays)}.`);
+  else if (s.talkFirst)
+    lines.push(
+      `  Talk about this first: ${daysText(s.low)} to ${daysText(s.high)} means someone sees work the others don't.`,
+      `  Once you've talked: harbor sound ${task.key ?? task.id} --settle DAYS`,
+    );
+  else lines.push(`  Close enough: about ${daysText(s.estimateDays)}.`);
+  return lines.join("\n");
+}
+
+/** list_soundings: the ones waiting on you first, then the rest, wide ones flagged. */
+export function soundingsText(r) {
+  const all = r.soundings ?? [];
+  const where = r.project ? ` on ${r.project}` : "";
+  if (!all.length)
+    return `No soundings${where}. Ask how long a task will take: harbor sound TASK --ask crew`;
+  const name = (t) => (t.key ? `${t.key} ${t.title}` : t.title);
+  const yours = all.filter((t) => t.youWereAsked && !t.answers.length && !t.shown);
+  const lines = [];
+  if (yours.length) {
+    lines.push("Waiting on your answer");
+    for (const t of yours) lines.push(`  ${name(t)} · asked by ${t.askedBy ?? "someone"}`);
+    lines.push("");
+  }
+  lines.push(`Soundings${where}`);
+  for (const t of all) {
+    const state = t.settled
+      ? `settled · ${daysText(t.estimateDays)}`
+      : t.talkFirst
+        ? `talk first · ${daysText(t.low)} to ${daysText(t.high)}`
+        : t.shown
+          ? `about ${daysText(t.estimateDays)}`
+          : `${t.answered} of ${t.crew.length} answered`;
+    lines.push(`  ${name(t)} · ${state}`);
+  }
+  return lines.join("\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 ?? [];
@@ -705,3 +777,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.49.0",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",