@harborppm/cli 0.16.0 → 0.18.1

package/README.md

@@ -117,9 +117,10 @@ harbor issue "TITLE" --project P|--program P [--impact 1-5] [--owner NAME]
 harbor decision "TITLE" --project P|--program P [--owner NAME] [--due DATE]
 harbor risks [words] [--kind risk,issue,decision] [--project P] [--closed]
 harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
+harbor voyage PROJECT ["YOUR LINE"]
 ```
 
-`harbor premortem` runs a pre-mortem with your crew: `--start` asks everyone "it's after the end date and this project failed: what happened?", each person adds answers alone for five minutes, and then the answers show together on the project's Risks & issues tab, where each becomes a risk in one click. On its own it prints the question and the answers you can see.
+`harbor premortem` runs a pre-mortem with your crew: `--start` asks everyone "it's after the end date and this project failed: what happened?", each person adds answers alone for five minutes, and then the answers show together on the project's Risks & issues tab, where each becomes a risk in one click. On its own it prints the question and the answers you can see. Once a project is Done, `harbor voyage` prints its voyage log (planned against actual dates, the biggest slips, the risks that came true, who closed the most, and the crew's lines) and adds yours.
 
 Every command takes `--json` for the raw result (a refusal then comes out as `{"error": "…"}` on standard output, still with exit code 1), and `harbor COMMAND --help` shows just that command. Statuses are backlog, todo, doing, review and done. A `DATE` is YYYY-MM-DD, `today`, `tomorrow`, or `+N` for N days from today.
 

package/dist/app.mjs

@@ -855,7 +855,8 @@ function normalizeRaidItem(r) {
 		createdAt: r.createdAt ?? now,
 		updatedAt: r.updatedAt ?? r.createdAt ?? now,
 		updates: Array.isArray(r.updates) ? r.updates : [],
-		scoreHistory: Array.isArray(r.scoreHistory) && r.scoreHistory.length ? r.scoreHistory : void 0
+		scoreHistory: Array.isArray(r.scoreHistory) && r.scoreHistory.length ? r.scoreHistory : void 0,
+		...kind === "risk" && typeof r.happened === "boolean" ? { happened: r.happened } : {}
 	};
 }
 /** Active first, then by score, then most recently touched. */
@@ -9336,6 +9337,33 @@ function milestonesRaidSlice({ set, get, write }) {
 				...r,
 				skipped
 			} : r) });
+		},
+		writeVoyageLine: (projectId, body) => {
+			const text = body.trim().slice(0, 600);
+			const me = get().currentUserId;
+			const all = get().reflections ?? [];
+			const mine = all.find((r) => r.projectId === projectId && r.kind === "voyage" && r.authorId === me);
+			if (!text) {
+				if (mine) write({ reflections: all.filter((r) => r.id !== mine.id) });
+				return;
+			}
+			if (mine) {
+				if (mine.body !== text) write({ reflections: all.map((r) => r.id === mine.id ? {
+					...r,
+					body: text
+				} : r) });
+				return;
+			}
+			if (!get().projects.some((p) => p.id === projectId)) return;
+			const row = {
+				id: uid("rf"),
+				projectId,
+				kind: "voyage",
+				authorId: me,
+				body: text,
+				createdAt: stamp()
+			};
+			write({ reflections: [...all, row] });
 		}
 	};
 }

package/lib/cli.mjs

@@ -20,6 +20,7 @@ import {
   harbors,
   myWork,
   premortemText,
+  voyageText,
   raidList,
   programTree,
   projectList,
@@ -93,6 +94,8 @@ export const HELP = `harbor: Harbor from the terminal
   harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
                                               a project's pre-mortem: start,
                                               answer or read it
+  harbor voyage PROJECT ["YOUR LINE"]           a Done project's voyage log, and
+                                              your line in it
 
   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.
@@ -242,6 +245,11 @@ export function hint(message) {
       "Say which with --harbor NAME, or set one with harbor use NAME.",
     )
     .replace(/Find it with search_tasks\.$/, "Find it with harbor tasks.")
+    .replace(
+      /^(.+) has no pre-mortem running\. Start one with start_premortem first\.$/s,
+      (_, name) =>
+        `${name} has no pre-mortem running. Start one with harbor premortem "${name}" --start.`,
+    )
     .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.",
@@ -260,6 +268,36 @@ export function hint(message) {
     );
 }
 
+/** get_premortem's answer with its note naming the command, not the agent tool, since --json shows it. */
+export function premortemForTerminal(r) {
+  if (r.running || !r.note) return r;
+  return {
+    ...r,
+    note: `No pre-mortem on ${r.project} yet. Start one with harbor premortem "${r.project}" --start.`,
+  };
+}
+
+/** Commands whose forms do different things: one line each, saying which read and which write. */
+const DETAIL = {
+  premortem: [
+    "  harbor premortem PROJECT               reads it: the question, the time left,",
+    "                                         and the answers you may see",
+    "  harbor premortem PROJECT --start       writes: starts one (five minutes of",
+    "                                         answering alone, then they show)",
+    '  harbor premortem PROJECT "ANSWER"      writes: adds your answer',
+    '  harbor premortem PROJECT "ANSWER" --start',
+    "                                         writes: starts one and adds your answer",
+    "",
+    "  PROJECT is a name or an id. When two projects share a name, give the id.",
+  ],
+  voyage: [
+    "  harbor voyage PROJECT                  reads a Done project's voyage log",
+    '  harbor voyage PROJECT "YOUR LINE"      writes: adds or changes your line in it',
+    "",
+    "  PROJECT is a name or an id. When two projects share a name, give the id.",
+  ],
+};
+
 /** The lines of the help about one command, or null when it has none. */
 export function commandHelp(command) {
   const lines = HELP.split("\n");
@@ -275,6 +313,7 @@ export function commandHelp(command) {
     while (lines[i + 1]?.startsWith("                  ") && /^\s+\[|^\s+--/.test(lines[i + 1]))
       picked.push(lines[++i]);
   }
+  if (DETAIL[command]) picked.splice(0, picked.length, ...DETAIL[command]);
   if (picked.length === 0) return null;
   const common = ["signup", "login", "logout", "use", "theme", "help", "app"].includes(command)
     ? []
@@ -588,11 +627,13 @@ export async function run(argv, io = {}) {
     width: process.stdout.isTTY ? process.stdout.columns : undefined,
   };
 
-  const call = async (name, args, show) => {
-    const result = await client.call(name, args).catch((err) => {
-      if (err instanceof HarborError) throw new HarborError(hint(err.message));
-      throw err;
-    });
+  const call = async (name, args, show, forTerminal = (r) => r) => {
+    const result = forTerminal(
+      await client.call(name, args).catch((err) => {
+        if (err instanceof HarborError) throw new HarborError(hint(err.message));
+        throw err;
+      }),
+    );
     // The prompt's counts are behind now; its next draw fetches new ones.
     if (name === "create_task" || name === "update_task") await stalePromptCache(env);
     out(asJson ? jsonText(result) : plain(show(result)));
@@ -1013,7 +1054,21 @@ export async function run(argv, io = {}) {
             : `Added your answer (${r.answered.yourAnswers} so far).`,
         );
       }
-      return call("get_premortem", { harbor, project }, premortemText);
+      return call("get_premortem", { harbor, project }, premortemText, premortemForTerminal);
+    }
+    case "voyage": {
+      const { positionals, harbor } = parse(spec());
+      const [project, ...words] = positionals;
+      if (!project) throw new HarborError("Give a project, and your line if you're adding one.");
+      const line = words.join(" ").trim();
+      if (line) {
+        return call(
+          "add_voyage_line",
+          { harbor, project, line },
+          (r) => `Your line is in ${r.added.project}'s voyage log.`,
+        );
+      }
+      return call("get_voyage_log", { harbor, project }, voyageText);
     }
     case "risk":
     case "issue":

package/lib/format.mjs

@@ -211,3 +211,15 @@ export function premortemText(r) {
     lines.push(`  Nothing yet. Add one: harbor premortem "${r.project}" "WHAT WENT WRONG"`);
   return [...head, "", ...lines].join("\n");
 }
+
+/** A project's voyage log, as get_voyage_log answers it. */
+export function voyageText(r) {
+  const head = [`Voyage log · ${r.project}${r.done ? ` · Done ${r.finished}` : " · not Done yet"}`];
+  if (r.note) head.push(r.note);
+  head.push((r.stats ?? []).join(" · "));
+  const story = (r.story ?? []).map((s) => `  - ${s}`);
+  const crew = (r.crew ?? []).map((c) => `  - ${c.who ?? "Someone"}: ${c.line}`);
+  return [...head, "", ...story, ...(crew.length ? ["", "From the crew:", ...crew] : [])].join(
+    "\n",
+  );
+}

package/package.json

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