@harborppm/cli 0.45.0 → 0.46.0

package/lib/cli.mjs

@@ -78,6 +78,13 @@ export const HELP = `harbor: Harbor from the terminal
                                               projects with health and open work
                                               (--json adds each board's limits)
   harbor forecast [PROJECT] [--program P]     when projects will likely finish
+  harbor try PROJECT [--drop KEYS] [--add "TITLE" [--count N]]
+                     [--due KEY=DATE] [--give KEY=NAME] [--end DATE]
+                     [--borrow NAME[=DAYS]] [--release NAME]
+                     [--saved] [--apply|--save|--discard]
+                                              dry dock: the forecast with plan
+                                              changes tried on a copy; nothing
+                                              changes without --apply
   harbor hill [--program P]                   where each project is on its hill
   harbor hill PROJECT --at 0-100|top|done     move it: up to 50 is figuring it
                                               out, past 50 is getting it done
@@ -537,6 +544,33 @@ const DETAIL = {
     "  than the pace would finish sets the dates, and the forecast names it. It",
     "  warns when under two weeks of pace is all there is.",
   ],
+  try: [
+    "  harbor try PROJECT [changes]           reads the forecast with the changes",
+    "                                         tried on a copy of the plan",
+    "  harbor try PROJECT [changes] --apply   writes: makes the changes for real",
+    "  harbor try PROJECT [changes] --save    writes: keeps them on the project to",
+    "                                         show someone (Forecast tab, Open dry",
+    "                                         dock)",
+    "  harbor try PROJECT --saved             reads the saved ones (add changes,",
+    "                                         --apply or --save as above)",
+    "  harbor try PROJECT --discard           writes: throws the saved ones away",
+    "",
+    "  Changes, each taking several with commas between:",
+    "    --drop RL-4,RL-5        take tasks out of the plan (--apply removes them)",
+    '    --add "TITLE" --count N new work, N tasks called TITLE',
+    "    --due RL-4=fri          move a due date (none takes it off)",
+    "    --give RL-4=Sam         give a task to someone (none: nobody)",
+    "    --end 2026-12-19        move the project's end date",
+    "    --borrow Sam=3          someone joins 3 days a week (5 if left out);",
+    "                            --apply raises their share of the program",
+    "    --release Priya         someone leaves: their open tasks lose their owner",
+    "",
+    "  It prints the real plan and the changed one side by side: when it's",
+    "  probably and very likely done, open tasks, the chance of making the end",
+    "  date, the crew's pace, and the load of everyone the changes touch. A",
+    "  borrowed person adds an average crew member's pace for each day a week",
+    "  they give; a released one takes away their share of what was finished.",
+  ],
   report: [
     "  harbor report PROGRAM                  reads the program's status report",
     "",
@@ -1082,6 +1116,100 @@ export async function run(argv, io = {}) {
     return 0;
   }
 
+  if (command === "try") {
+    const { values, positionals } = parseArgs(rest, {
+      flags: ["apply", "save", "discard", "saved", "json"],
+      options: ["harbor", "drop", "add", "count", "due", "give", "end", "borrow", "release"],
+    });
+    if (positionals.length !== 1)
+      throw new HarborError(
+        positionals.length
+          ? "harbor try takes one project; put a name with spaces in quotes."
+          : "Say which project: harbor try PROJECT --drop RL-4. harbor help try has the rest.",
+      );
+    if (["apply", "save", "discard"].filter((k) => values[k]).length > 1)
+      throw new HarborError("Use one of --apply, --save or --discard.");
+    const creds = await readCredentials(env);
+    if (!hasFullAccess(creds))
+      throw new HarborError(
+        creds
+          ? "This sign-in can only read. Run harbor login (without --read-only) to use dry dock."
+          : "Not signed in. Run harbor login, or harbor signup if you're new.",
+      );
+    const app = await loadApp();
+    const notes = [];
+    const say = values.json ? (line) => notes.push(line) : (line) => out(plain(line));
+    const result = await app.tryHere({
+      transport: app.planTransport(
+        tokenSource({ creds, save: (c) => writeCredentials(c, env), fetcher }),
+        fetcher,
+      ),
+      project: positionals[0],
+      flags: values,
+      apply: Boolean(values.apply),
+      save: Boolean(values.save),
+      discard: Boolean(values.discard),
+      say,
+      pickHarbor: (list) => {
+        if (values.harbor) return app.harborNamed(list, values.harbor);
+        const saved = list.find((h) => h.id === creds?.harbor);
+        if (saved) return saved;
+        if (list.length === 1) return list[0];
+        throw new HarborError(
+          `You're in ${list.length} harbors (${list.map((h) => h.name).join(", ")}). Add --harbor NAME, or run harbor use NAME first.`,
+        );
+      },
+    });
+    if (!result) {
+      if (values.json) out(jsonText({ notes }));
+      return 0;
+    }
+    if (values.json) {
+      const side = (s) => ({
+        endDate: s.project.endDate,
+        open: s.open,
+        likely: s.tide.kind === "forecast" ? s.tide.likely : null,
+        veryLikely: s.tide.kind === "forecast" ? s.tide.veryLikely : null,
+        chanceByEnd: s.tide.kind === "forecast" ? s.tide.chanceByEnd : null,
+        forecast: s.tide.kind,
+      });
+      const c = result.comparison;
+      out(
+        jsonText({
+          project: { id: result.project.id, key: result.project.key, name: result.project.name },
+          changes: result.changes,
+          real: side(c.real),
+          dryDock: side(c.docked),
+          shiftDays: c.shift,
+          pace: c.pace,
+          ...(result.applied !== undefined ? { applied: result.applied } : {}),
+          ...(result.saved ? { saved: true } : {}),
+          notes,
+        }),
+      );
+      return 0;
+    }
+    for (const line of result.lines) out(plain(line));
+    out("");
+    if (result.applied !== undefined)
+      out(
+        plain(
+          `⚓ Applied ${result.applied} change${result.applied === 1 ? "" : "s"} to ${result.project.name}.`,
+        ),
+      );
+    else if (result.saved)
+      out(
+        plain(
+          `⚓ Saved on ${result.project.name}. It's on the Forecast tab under Open dry dock; --apply makes it real.`,
+        ),
+      );
+    else if (result.changes.length)
+      out(
+        "Nothing was changed. Add --apply to make these changes, or --save to keep them to show someone.",
+      );
+    return 0;
+  }
+
   if (command === "init" || command === "sync") {
     const init = command === "init";
     const { values, positionals } = parseArgs(rest, {

package/package.json

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