@harborppm/cli 0.14.0 → 0.15.0

package/README.md

@@ -55,13 +55,13 @@ Your harbor is the same one at [harborppm.com](https://harborppm.com/today?utm_s
 - **GitHub**: a pull request that names a task's key (RR-42) shows on the task and moves it along.
 - **Claude and other AI apps**, connected over MCP from [harborppm.com/ai](https://harborppm.com/ai?utm_source=npm&utm_medium=readme&utm_campaign=cli).
 
-`harbor open RR-42` opens a task on the website (in the right harbor, even when the browser had another one open), `harbor open Ridge` a project, and `harbor open` on its own opens Today. `harbor invite sam@example.com` sends Sam the same invite letter the People page does (`--viewer` to let them look but not change anything); only a harbor's owner can invite.
+`harbor open RR-42` opens a task on the website (in the right harbor, even when the browser had another one open), `harbor open Ridge` a project, and `harbor open` on its own opens Today. `harbor invite sam@example.com` sends Sam the same invite letter the People page does (`--viewer` to let them look but not change anything); only a harbor's owner can invite. `harbor calendar` prints your private calendar link, to add to Google, Apple or Outlook calendar: your due dates, milestones and sign-offs beside your meetings, kept up to date (`--program NAME` for everything dated in one program, `--new` to swap the link for a fresh one, `--off` to turn it off).
 
 The website has the commands too: turn on **Command line at the bottom** in your menu, press `/`, and type `mine`, `add "Call the mill" #ridge @sam --due fri` or `done RR-12`.
 
 ## 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
 
@@ -95,6 +95,7 @@ harbor tasks [words] [--project P] [--assignee me|none|NAME] [--late] [--status
 harbor show TASK                            one task in full, with its web link
 harbor open [TASK|PROJECT]                  open it on the website (or Today)
 harbor invite EMAIL [--viewer]              invite someone to your harbor by email
+harbor calendar [--program P] [--new|--off] your private calendar link (.ics)
 
 harbor program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                      [--ends DATE]

package/lib/cli.mjs

@@ -66,6 +66,7 @@ export const HELP = `harbor: Harbor from the terminal
                                               shell prompt (never waits)
   harbor prompt --init SHELL                  how to add it: zsh, bash, fish
                                               or starship
+  harbor calendar [--program P] [--new|--off] your private calendar link (.ics)
 
   harbor program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                        [--ends DATE]
@@ -523,7 +524,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 +535,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 +557,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.
@@ -818,6 +822,34 @@ export async function run(argv, io = {}) {
       );
       return 0;
     }
+    case "calendar": {
+      const { values, harbor } = parse(spec(["new", "off"], ["program"]));
+      if (values.new && values.off) throw new HarborError("Say --new or --off, not both.");
+      if (!hasFullAccess(creds)) {
+        throw new HarborError("Calendar links need full access. Run harbor login, then try again.");
+      }
+      const r = await client.app({
+        op: "calendar",
+        ...(harbor ? { harbor } : {}),
+        ...(values.program ? { program: values.program } : {}),
+        action: values.off ? "off" : values.new ? "fresh" : "show",
+      });
+      if (asJson) {
+        out(jsonText(r));
+        return 0;
+      }
+      const what = r.program ? `everything dated in ${r.program}` : `your work in ${r.harbor}`;
+      if (!r.url) {
+        out(plain(`Turned off the calendar link for ${what}. Calendars using it stop updating.`));
+        return 0;
+      }
+      out(
+        plain(
+          `${values.new ? "A new calendar link" : "Your calendar link"} for ${what}${values.new ? " (the old one has stopped working)" : ""}:\n\n  ${r.url}\n\nAdd it to Google, Apple or Outlook calendar as a calendar from a URL. Anyone with the link can see these dates; harbor calendar --new swaps it for a fresh one.`,
+        ),
+      );
+      return 0;
+    }
     case "add": {
       const { positionals, values, harbor } = parse(
         spec(["over-limit"], ["project", "assignee", "due", "priority", "status"]),

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