@harborppm/cli 0.38.0 → 0.39.0

package/README.md

@@ -57,7 +57,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 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). `harbor roadmap "Next steps"` publishes a project as a public roadmap page (Now, Next and Shipped, task titles only) and prints its link; `--dates` adds the day each thing shipped and `--off` takes it down. Only a harbor's owner can publish.
+`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). `harbor roadmap "Next steps"` says whether a project is a public roadmap page and prints its link; `--publish` publishes it (Now, Next and Shipped, task titles only, on a link that can't be guessed, which stays the same while it's live), `--publish --dates` adds the day each thing shipped (titles only is the default), and `--off` takes it down at once. Only a harbor's owner can publish. `harbor projects --json` gives each project's `public` and `url`.
 
 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`.
 
@@ -129,7 +129,7 @@ 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 roadmap PROJECT [--dates] [--off]    publish a project's public roadmap
+harbor roadmap PROJECT [--publish] [--off]  a project's public roadmap: read, publish or take it down
 
 harbor program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                      [--ends DATE]

package/lib/cli.mjs

@@ -85,8 +85,10 @@ export const HELP = `harbor: Harbor from the terminal
   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 roadmap PROJECT [--dates|--no-dates] [--off]
-                                              publish a project's public roadmap
+  harbor roadmap PROJECT [--publish [--dates|--no-dates] [--site|--no-site]]
+                 [--off]
+                                              a project's public roadmap: read,
+                                              publish or take it down
 
   harbor init [PROJECT] [--hook]              keep a project's tasks as files in
                                               this repository (.harbor/), one
@@ -450,6 +452,29 @@ const DETAIL = {
     "  PROJECT is a name, a key like RR, or an id. When two projects share a",
     "  name, give the key.",
   ],
+  roadmap: [
+    "  harbor roadmap PROJECT                 reads whether it's public, and its link",
+    "  harbor roadmap PROJECT --publish       writes: publishes it, or keeps it live",
+    "                                         with any change below; the link stays",
+    "                                         the same while it's live",
+    "  harbor roadmap PROJECT --publish --dates",
+    "                                         writes: also shows the day each thing",
+    "                                         shipped (--no-dates: titles only, the",
+    "                                         default)",
+    "  harbor roadmap PROJECT --publish --site",
+    "                                         writes: also shows it at",
+    "                                         harborppm.com/roadmap, in place of any",
+    "                                         other (Harbor's own team only;",
+    "                                         --no-site, the default, takes it off)",
+    "  harbor roadmap PROJECT --off           writes: takes it down at once; the link",
+    "                                         then says it isn't published, and",
+    "                                         publishing again makes a new link",
+    "",
+    "  A visitor sees Now, Next and Shipped: task titles only, with no people,",
+    "  keys, notes, comments or due dates. Anyone with the link can open it; the",
+    "  link is long and random, so it can't be guessed. Only the harbor's owner",
+    "  can publish.",
+  ],
   forecast: [
     "  harbor forecast [--program P]          reads when each open project will",
     "                                         likely finish",
@@ -1349,20 +1374,28 @@ export async function run(argv, io = {}) {
     }
     case "roadmap": {
       const { positionals, values, harbor } = parse(
-        spec(["dates", "no-dates", "site", "no-site", "off"]),
+        spec(["publish", "dates", "no-dates", "site", "no-site", "off"]),
       );
       const project = text(positionals, "which project");
       if (values.dates && values["no-dates"])
         throw new HarborError("Say --dates or --no-dates, not both.");
       if (values.site && values["no-site"])
         throw new HarborError("Say --site or --no-site, not both.");
+      if (values.off && values.publish) throw new HarborError("Say --publish or --off, not both.");
+      const changes = ["dates", "no-dates", "site", "no-site"].filter((f) => values[f]);
+      if (changes.length && !values.publish) {
+        throw new HarborError(
+          `Nothing changed. Add --publish to change what the page shows: harbor roadmap "${project}" --publish ${changes.map((f) => `--${f}`).join(" ")}`,
+        );
+      }
       if (!hasFullAccess(creds)) {
-        throw new HarborError("Publishing needs full access. Run harbor login, then try again.");
+        throw new HarborError("Roadmaps need full access. Run harbor login, then try again.");
       }
       const r = await client.app({
         op: "roadmap",
         ...(harbor ? { harbor } : {}),
         project,
+        ...(values.publish ? { publish: true } : {}),
         ...(values.off ? { off: true } : {}),
         ...(values.dates || values["no-dates"] ? { showDates: Boolean(values.dates) } : {}),
         ...(values.site || values["no-site"] ? { onSite: Boolean(values.site) } : {}),
@@ -1374,7 +1407,9 @@ export async function run(argv, io = {}) {
       if (!r.url) {
         out(
           plain(
-            `${r.project} isn't published any more. Its link says the roadmap isn't published.`,
+            values.off
+              ? `${r.project} isn't published any more. Its link now says the roadmap isn't published.`
+              : `${r.project} isn't public. harbor roadmap "${r.project}" --publish publishes it.`,
           ),
         );
         return 0;
@@ -1382,7 +1417,7 @@ export async function run(argv, io = {}) {
       const shows = r.showDates ? "titles and the day each shipped" : "titles only";
       out(
         plain(
-          `${r.project}'s public roadmap (Now, Next and Shipped; ${shows}, no people):\n\n  ${r.url}${r.siteUrl ? `\n\nIt's also Harbor's own roadmap at ${r.siteUrl}.` : ""}\n\nharbor roadmap "${r.project}" --off takes it down.`,
+          `${r.project}${values.publish ? " is public" : "'s public roadmap"} (Now, Next and Shipped; ${shows}, no people):\n\n  ${r.url}${r.siteUrl ? `\n\nIt's also Harbor's own roadmap at ${r.siteUrl}.` : ""}\n\nharbor roadmap "${r.project}" --off takes it down.`,
         ),
       );
       return 0;

package/package.json

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