@harborppm/cli 0.19.0 → 0.20.1

package/README.md

@@ -118,8 +118,11 @@ harbor decision "TITLE" --project P|--program P [--owner NAME] [--due DATE]
 harbor risks [words] [--kind risk,issue,decision] [--project P] [--closed]
 harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
 harbor voyage PROJECT ["YOUR LINE"]
+harbor limit PROJECT [COLUMN N|none]
 ```
 
+`harbor limit RR` prints how many tasks each of a board's columns takes at once; `harbor limit RR doing 8` changes one (1 to 20, or `none` for no limit), if you own the harbor. `harbor projects --json` carries each board's `limits` too.
+
 `harbor premortem` runs a pre-mortem with your crew: `--start` asks everyone "it's after the end date and this project failed: what happened?", each person adds answers alone for five minutes, and then the answers show together on the project's Risks & issues tab, where each becomes a risk in one click. On its own it prints the question and the answers you can see. Once a project is Done, `harbor voyage` prints its voyage log (planned against actual dates, the biggest slips, the risks that came true, who closed the most, and the crew's lines) and adds yours.
 
 Every command takes `--json` for the raw result (a refusal then comes out as `{"error": "…"}` on standard output, still with exit code 1), and `harbor COMMAND --help` shows just that command. Statuses are backlog, todo, doing, review and done. A `DATE` is YYYY-MM-DD, `today`, `tomorrow`, or `+N` for N days from today.

package/dist/app.mjs

@@ -1264,6 +1264,18 @@ const ALL_FIELDS = {
 };
 const DEFAULT_DOING_WIP = 3;
 const DEFAULT_REVIEW_WIP = 2;
+/** The column's cap after "No cap" (`uncapped`) or a number is picked. */
+function withWipLimit(col, limit) {
+	const { uncapped: _drop, ...rest } = col;
+	return limit == null ? {
+		...rest,
+		wipLimit: null,
+		uncapped: true
+	} : {
+		...rest,
+		wipLimit: limit
+	};
+}
 function defaultWipFor(status) {
 	if (status === "doing") return 3;
 	if (status === "review") return 2;
@@ -1337,6 +1349,15 @@ function clampWip(value) {
 	if (!Number.isFinite(n) || n <= 0) return null;
 	return Math.min(20, Math.round(n));
 }
+function capOf(c) {
+	const n = clampWip(c.wipLimit);
+	if (n != null) return { wipLimit: n };
+	if (c.uncapped === true) return {
+		wipLimit: null,
+		uncapped: true
+	};
+	return { wipLimit: defaultWipFor(c.status) };
+}
 function normalizeBoardConfig(raw) {
 	const base = defaultBoardConfig();
 	if (!raw) return base;
@@ -1350,7 +1371,7 @@ function normalizeBoardConfig(raw) {
 			status: c.status,
 			label: typeof c.label === "string" && c.label.trim() ? c.label.trim() : TASK_STATUS_LABEL[c.status],
 			visible: c.visible !== false,
-			wipLimit: clampWip(c.wipLimit) ?? defaultWipFor(c.status)
+			...capOf(c)
 		});
 	}
 	for (const status of TASK_COLUMNS) if (!order.includes(status)) order.push(status);
@@ -7532,8 +7553,9 @@ function daysUntil(date, now) {
 function incomplete(task) {
 	return task.status !== "done";
 }
-function wipLimitOf(status, stored) {
+function wipLimitOf(status, stored, uncapped) {
 	if (stored != null) return stored;
+	if (uncapped === true) return null;
 	if (status === "doing") return 3;
 	if (status === "review") return 2;
 	return null;
@@ -7542,7 +7564,7 @@ function wipOverflowing(data, projectId) {
 	const cols = data.boardConfigs?.[projectId]?.columns;
 	if (cols?.length) return cols.some((c) => {
 		if (c.visible === false) return false;
-		const limit = wipLimitOf(c.status, c.wipLimit);
+		const limit = wipLimitOf(c.status, c.wipLimit, c.uncapped);
 		if (limit == null) return false;
 		return tasksOf(data.tasks, projectId).filter((t) => t.status === c.status).length > limit;
 	});
@@ -8704,10 +8726,7 @@ function hierarchySlice({ get, write }) {
 			const columns = config.columns.map((c) => {
 				if (c.status !== status) return c;
 				const floor = Math.max(c.wipLimit ?? 0, current);
-				return {
-					...c,
-					wipLimit: Math.min(20, floor + 1)
-				};
+				return withWipLimit(c, Math.min(20, floor + 1));
 			});
 			get().setBoardConfig(projectId, {
 				...config,

package/lib/cli.mjs

@@ -19,6 +19,7 @@ import {
 import {
   STATUS,
   harbors,
+  limitsText,
   myWork,
   premortemText,
   voyageText,
@@ -59,6 +60,7 @@ export const HELP = `harbor: Harbor from the terminal
   harbor programs [--done]                    programs and their projects
   harbor projects [words] [--program P] [--done]
                                               projects with health and open work
+                                              (--json adds each board's limits)
   harbor mine                                 what's on you, late first
   harbor tasks [words] [--project P] [--assignee me|none|NAME]
                      [--late] [--status S,S]
@@ -83,6 +85,8 @@ export const HELP = `harbor: Harbor from the terminal
                    [--priority P] [--status S] [--notes TEXT]
                    [--repeat weekly|biweekly|monthly|never]
                    [--waits-on TASK,TASK|none] [--confirm] [--over-limit]
+  harbor limit PROJECT [COLUMN N|none]        how many tasks a board column
+                                              takes at once; the owner sets it
   harbor comment TASK "TEXT"
   harbor checkin "WHAT YOU'RE DOING" [--on-blocker]
   harbor risk "TITLE" --project P|--program P [--impact 1-5] [--probability 1-5]
@@ -213,6 +217,8 @@ const FLAG = {
   repeat: "--repeat",
   description: "--notes",
   body: "the comment",
+  column: "the column",
+  limit: "the limit",
 };
 
 /** Harbor's refusals are worded for agents; say them as the commands and flags that answer them. */
@@ -283,6 +289,17 @@ export function premortemForTerminal(r) {
 
 /** Commands whose forms do different things: one line each, saying which read and which write. */
 const DETAIL = {
+  limit: [
+    "  harbor limit PROJECT                   reads its board's column limits",
+    "  harbor limit PROJECT COLUMN N          writes: COLUMN takes at most N tasks",
+    "                                         at once (1 to 20; the website offers",
+    "                                         1-5, 8, 10 and 15)",
+    "  harbor limit PROJECT COLUMN none       writes: no limit on COLUMN",
+    "",
+    "  COLUMN is a status: doing or review usually, or backlog, todo, done.",
+    "  Only the harbor's owner can change a limit. A move past a limit is",
+    "  refused until you run it again with --over-limit.",
+  ],
   premortem: [
     "  harbor premortem PROJECT               reads it: the question, the time left,",
     "                                         and the answers you may see",
@@ -851,13 +868,17 @@ export async function run(argv, io = {}) {
           lines.push(
             "",
             "Waits on:",
-            ...t.waitingOn.map((w) => `  ${w.key ?? w.id}  ${w.title} (${STATUS[w.status] ?? w.status})`),
+            ...t.waitingOn.map(
+              (w) => `  ${w.key ?? w.id}  ${w.title} (${STATUS[w.status] ?? w.status})`,
+            ),
           );
         if (t.waitedOnBy.length)
           lines.push(
             "",
             "Holds up:",
-            ...t.waitedOnBy.map((w) => `  ${w.key ?? w.id}  ${w.title} (${STATUS[w.status] ?? w.status})`),
+            ...t.waitedOnBy.map(
+              (w) => `  ${w.key ?? w.id}  ${w.title} (${STATUS[w.status] ?? w.status})`,
+            ),
           );
         if (t.comments.length)
           lines.push(
@@ -1111,6 +1132,26 @@ export async function run(argv, io = {}) {
       }
       return call("get_premortem", { harbor, project }, premortemText, premortemForTerminal);
     }
+    case "limit": {
+      const { positionals, harbor } = parse(spec());
+      const [project, column, value, ...extra] = positionals;
+      if (!project) throw new HarborError("Give a project, like harbor limit RR doing 5.");
+      if (!column) {
+        return call("get_project", { harbor, project }, (r) =>
+          limitsText(r.name, r.limits, r.tasks),
+        );
+      }
+      if (value === undefined || extra.length) {
+        throw new HarborError(`Give one limit for ${column}: a number like 5, or none.`);
+      }
+      const limit = /^(none|no|off|0)$/i.test(value) ? null : Number(value);
+      if (limit !== null && !(Number.isInteger(limit) && limit >= 1 && limit <= 20)) {
+        throw new HarborError("A limit is a whole number from 1 to 20, or none.");
+      }
+      return call("set_column_limit", { harbor, project, column, limit }, (r) =>
+        limitsText(r.set.project, r.limits, r.tasks),
+      );
+    }
     case "voyage": {
       const { positionals, harbor } = parse(spec());
       const [project, ...words] = positionals;

package/lib/format.mjs

@@ -144,6 +144,18 @@ export function projectList(r, { done = false } = {}) {
   );
 }
 
+/** A project's column limits with how full each is: "doing 4 of 5; no limit on backlog, todo, done". */
+export function limitsText(name, limits, tasks = {}) {
+  const entries = Object.entries(limits ?? {});
+  const capped = entries
+    .filter(([, n]) => n != null)
+    .map(([status, n]) => `${STATUS[status] ?? status} ${tasks[status] ?? 0} of ${n}`);
+  const open = entries.filter(([, n]) => n == null).map(([status]) => STATUS[status] ?? status);
+  if (!capped.length) return `${name}'s board has no column limits.`;
+  const rest = open.length ? `; no limit on ${open.join(", ")}` : "";
+  return `${name}: ${capped.join(", ")}${rest}.`;
+}
+
 export function harbors(r) {
   const list = r.harbors ?? [];
   if (!list.length) return "You aren't in any harbor yet. Run harbor to make one.";

package/package.json

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