@harborppm/cli 0.28.0 → 0.29.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 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.
 
 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`.
 
@@ -103,6 +103,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 program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                      [--ends DATE]

package/lib/cli.mjs

@@ -79,6 +79,8 @@ 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 program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                        [--ends DATE]
@@ -1011,6 +1013,46 @@ export async function run(argv, io = {}) {
       );
       return 0;
     }
+    case "roadmap": {
+      const { positionals, values, harbor } = parse(
+        spec(["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 (!hasFullAccess(creds)) {
+        throw new HarborError("Publishing needs full access. Run harbor login, then try again.");
+      }
+      const r = await client.app({
+        op: "roadmap",
+        ...(harbor ? { harbor } : {}),
+        project,
+        ...(values.off ? { off: true } : {}),
+        ...(values.dates || values["no-dates"] ? { showDates: Boolean(values.dates) } : {}),
+        ...(values.site || values["no-site"] ? { onSite: Boolean(values.site) } : {}),
+      });
+      if (asJson) {
+        out(jsonText(r));
+        return 0;
+      }
+      if (!r.url) {
+        out(
+          plain(
+            `${r.project} isn't published any more. Its link says the roadmap isn't published.`,
+          ),
+        );
+        return 0;
+      }
+      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.`,
+        ),
+      );
+      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.28.0",
+  "version": "0.29.0",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",