@harborppm/cli 0.16.0 → 0.18.0

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.
@@ -1015,6 +1018,20 @@ export async function run(argv, io = {}) {
       }
       return call("get_premortem", { harbor, project }, premortemText);
     }
+    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":
     case "decision": {

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}` : ""}`];
+  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.0",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",