@harborppm/cli 0.14.1 → 0.15.0

package/README.md

@@ -55,7 +55,7 @@ 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`.
 
@@ -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]
@@ -821,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/package.json

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