@harborppm/cli 0.18.0 → 0.18.1

package/lib/cli.mjs

@@ -245,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.",
@@ -263,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");
@@ -278,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)
     ? []
@@ -591,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)));
@@ -1016,7 +1054,7 @@ 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());

package/lib/format.mjs

@@ -214,7 +214,7 @@ export function premortemText(r) {
 
 /** 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}` : ""}`];
+  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}`);

package/package.json

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