@harborppm/cli 0.14.0 → 0.14.1

package/README.md

@@ -61,7 +61,7 @@ The website has the commands too: turn on **Command line at the bottom** in your
 
 ## In your shell prompt
 
-`harbor prompt` prints a few characters for your prompt: `⚓ 2 today · 1 late`, with late work in coral, and nothing at all when you're clear. It never waits on the network: it shows the counts it kept and fetches new ones in the background when they're more than five minutes old, or after you change a task. `harbor prompt --init zsh` (or `bash`, `fish`, `starship`) prints the lines to add to your shell's setup:
+`harbor prompt` prints a few characters for your prompt: `⚓ 2 today · 1 late`, with late work in coral, and nothing at all when you're clear. It never waits on the network: it shows the counts it kept and fetches new ones in the background when they're more than five minutes old, or after you change a task. `harbor prompt --init zsh` (or `bash`, `fish`, `starship`) prints the lines to add to your shell's setup, so `harbor prompt --init starship >> ~/.config/starship.toml` does it in one go:
 
 ```zsh
 # ~/.zshrc
@@ -71,7 +71,7 @@ RPROMPT='$(harbor prompt --shell zsh)'
 
 ## Staying up to date
 
-npm doesn't update a global install by itself, so once a day `harbor` asks npm whether a newer version is out, alongside whatever command you ran, and says so in one line when there is (`npm install -g @harborppm/cli@latest` updates it). It says nothing in scripts, pipes or CI; set `HARBOR_NO_UPDATE_CHECK=1` (or `NO_UPDATE_NOTIFIER=1`) to turn it off.
+npm doesn't update a global install by itself, so once a day `harbor` asks npm whether a newer version is out, alongside whatever command you ran, and says so in one line when there is (`npm install -g @harborppm/cli@latest --prefer-online` updates it). It says nothing in scripts, pipes or CI; set `HARBOR_NO_UPDATE_CHECK=1` (or `NO_UPDATE_NOTIFIER=1`) to turn it off.
 
 ## Text from others
 

package/lib/cli.mjs

@@ -523,7 +523,8 @@ export async function run(argv, io = {}) {
       const snippet = initSnippet(values.init);
       if (!snippet) throw new HarborError(`Pick ${SHELLS.join(", ")} (not "${values.init}").`);
       out(
-        `${snippet}\n\nYour prompt shows what's due today and late once Harbor has answered,\na moment after the next prompt. harbor prompt --refresh checks now.`,
+        // Comments, so the whole of it can be appended straight to the file.
+        `${snippet}\n# Shows what's due today and late, from the prompt after next;\n# nothing when you're clear. harbor prompt --refresh checks now.`,
       );
       return 0;
     }
@@ -533,12 +534,14 @@ export async function run(argv, io = {}) {
     const creds = await readCredentials(env);
     const harbor = values.harbor ?? creds?.harbor ?? null;
     const today = todayLocal(io.now ? new Date(io.now()) : new Date());
-    const show = (counts, at) =>
-      out(
-        values.json
-          ? jsonText({ ...(counts ?? { today: null, late: null }), at })
-          : segment(counts ?? {}, shell),
-      );
+    // A prompt with nothing to say gets nothing, not an empty line; a
+    // --refresh run by hand says what it found.
+    const show = (counts, at, byHand = false) => {
+      if (values.json) return out(jsonText({ ...(counts ?? { today: null, late: null }), at }));
+      const text = segment(counts ?? {}, shell);
+      if (text) out(text);
+      else if (byHand) out("Nothing due today or late.");
+    };
     if (!creds) {
       if (values.refresh) throw new HarborError("Not signed in. Run harbor login.");
       show(null, null);
@@ -553,7 +556,7 @@ export async function run(argv, io = {}) {
       const counts = promptCounts(work, today);
       const at = io.now?.() ?? Date.now();
       await writePromptCache({ at, day: today, harbor, counts }, env);
-      show(counts, at);
+      show(counts, at, !shell);
       return 0;
     }
     // The prompt itself: what's kept, at once, and fresh counts fetched for next time.

package/lib/update.mjs

@@ -68,6 +68,6 @@ export async function updateNotice({
     }
   }
   return latest && isNewer(latest, version)
-    ? `Harbor CLI ${latest} is out (you have ${version}): npm install -g @harborppm/cli@latest`
+    ? `Harbor CLI ${latest} is out (you have ${version}): npm install -g @harborppm/cli@latest --prefer-online`
     : null;
 }

package/package.json

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