@harborppm/cli 0.74.0 → 0.75.0

package/dist/app.mjs

@@ -18722,6 +18722,139 @@ function toCsv(headers, rows) {
 	return [headers, ...rows].map((r) => r.map(cell).join(",")).join("\r\n");
 }
 
+// src/lib/payload.ts
+/**
+* The document fields of a store state, by reference, with stable empties for
+* anything missing. Cheap enough to run on every render; feeds `useHarborData`.
+*/
+function pickData(s) {
+	return {
+		people: s.people ?? NONE,
+		portfolios: s.portfolios ?? NONE,
+		programs: s.programs ?? NONE,
+		projects: s.projects ?? NONE,
+		milestones: s.milestones ?? NONE,
+		raidItems: s.raidItems ?? NONE,
+		constraints: s.constraints ?? NONE,
+		tasks: s.tasks ?? NONE,
+		comments: s.comments ?? NONE,
+		attachments: s.attachments ?? NONE,
+		activity: s.activity ?? NONE,
+		currentUserId: s.currentUserId,
+		boardConfigs: s.boardConfigs ?? NO_CONFIGS,
+		readPingIds: s.readPingIds ?? NONE,
+		ropes: s.ropes ?? NONE,
+		checkIns: s.checkIns ?? NONE,
+		spendEntries: s.spendEntries ?? NONE,
+		reflections: s.reflections ?? NONE,
+		priorityRules: s.priorityRules ?? null,
+		workCalendar: s.workCalendar ?? null
+	};
+}
+/** The document as sent to the server: normalized and without inline file data. */
+function payloadOf(s) {
+	const data = pickData(s);
+	return {
+		...data,
+		people: data.people.map((p) => ({
+			...p,
+			accountId: p.accountId ?? null
+		})),
+		attachments: data.attachments.map((a) => a.url?.startsWith("data:") ? {
+			...a,
+			url: null
+		} : a)
+	};
+}
+var NONE, NO_CONFIGS;
+var init_payload = __esmMin((() => {
+	NONE = [];
+	NO_CONFIGS = {};
+}));
+
+// src/lib/harbor-export.ts
+/**
+* A copy of a whole harbor for its owner to keep: everything in the document
+* as one JSON file, and every task in one spreadsheet. The website downloads
+* them (components/export-dialog.tsx), agents and the terminal get the same
+* through the export_harbor tool (`harbor export harbor`). Owners only: the
+* file holds everyone's work, comments and time off.
+*/
+init_blockers();
+init_indexes();
+init_payload();
+init_swatches();
+init_task_keys();
+/** Bumped when the file's shape changes in a way a reader would notice. */
+const EXPORT_VERSION = 1;
+/**
+* The whole document, as the server keeps it. Left out: who is looking
+* (`currentUserId`) and which notifications they've read, which belong to the
+* person exporting, not the harbor. Files uploaded to a task are listed with
+* their links; images pasted straight into this browser aren't on the server
+* and come without one.
+*/
+function harborExport(data, harbor, now) {
+	const { currentUserId: _me, readPingIds: _read, ...doc } = payloadOf(data);
+	const counts = {};
+	for (const [k, v] of Object.entries(doc)) if (Array.isArray(v)) counts[k] = v.length;
+	return {
+		format: "harbor-export",
+		version: 1,
+		exportedAt: now.toISOString(),
+		harbor,
+		counts,
+		data: doc
+	};
+}
+/**
+* Every task in the harbor, one row each, with its project and program. Key
+* first, as in a project's own export, so a project's rows can go back in
+* through Import.
+*/
+function allTasksCsv(data) {
+	const projects = byId(data.projects);
+	const programs = byId(data.programs);
+	const people = byId(data.people);
+	const tasks = byId(data.tasks);
+	const keyOf = (t) => taskKey(t, projects.get(t.projectId)) ?? t.title;
+	return toCsv([
+		"Key",
+		"Title",
+		"Project",
+		"Program",
+		"Status",
+		"Priority",
+		"Owner",
+		"Due",
+		"Done",
+		"Blocked by",
+		"Created",
+		"Description"
+	], data.tasks.map((t) => {
+		const project = projects.get(t.projectId);
+		const program = project ? programs.get(project.programId) : void 0;
+		return [
+			taskKey(t, project) ?? "",
+			t.title,
+			project?.name ?? "",
+			program?.name ?? "",
+			TASK_STATUS_LABEL[t.status],
+			PRIORITY_LABEL[t.priority],
+			t.assigneeId && people.get(t.assigneeId)?.name || "",
+			t.dueDate ?? "",
+			t.status === "done" ? "yes" : "no",
+			blockerIds(t).map((id) => tasks.get(id)).filter((b) => Boolean(b)).map(keyOf).join("; "),
+			t.createdAt?.slice(0, 10) ?? "",
+			t.description
+		];
+	}));
+}
+/** "cedar-and-co-2026-11-01": a file name for the harbor on a day. */
+function exportName(harborName, now) {
+	return `${harborName.normalize("NFKD").replace(/\p{M}/gu, "").replace(/&/g, " and ").replace(/[^\w]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase() || "harbor"}-${now.toISOString().slice(0, 10)}`;
+}
+
 // src/lib/exports.ts
 /**
 * The spreadsheets Harbor hands out: a project's tasks, the risk register and
@@ -20408,6 +20541,32 @@ const HARBOR_TOOLS = [
 			};
 		}
 	}),
+	tool({
+		name: "export_harbor",
+		title: "Download the whole harbor",
+		description: "A copy of the whole harbor for its owner to keep: as json, one file with every portfolio, program, project, task, comment, milestone, risk, decision, person and day off; as csv, every task in one spreadsheet with its project and program. Owners only, since it holds everyone's work; anyone can use export_csv for one project or the register." + DATA_NOTE,
+		input: object({
+			harbor: harborArg,
+			as: _enum(["json", "csv"]).default("json")
+		}),
+		run: (ctx, input) => {
+			if (ctx.harbor.role !== "owner") throw new ToolError(`Only an owner can download the whole of ${ctx.harbor.name}. export_csv gives a project's tasks or the register.`);
+			const base = exportName(ctx.harbor.name, ctx.now);
+			if (input.as === "csv") return {
+				filename: `${base}-tasks.csv`,
+				csv: allTasksCsv(ctx.data)
+			};
+			const file = harborExport(ctx.data, {
+				id: ctx.harbor.id,
+				name: ctx.harbor.name
+			}, ctx.now);
+			return {
+				filename: `${base}.json`,
+				counts: file.counts,
+				json: JSON.stringify(file, null, 2)
+			};
+		}
+	}),
 	tool({
 		name: "list_risks",
 		title: "Risks, issues and decisions",
@@ -21154,56 +21313,6 @@ const LIST_HARBORS = {
 	input: object({})
 };
 
-// src/lib/payload.ts
-/**
-* The document fields of a store state, by reference, with stable empties for
-* anything missing. Cheap enough to run on every render; feeds `useHarborData`.
-*/
-function pickData(s) {
-	return {
-		people: s.people ?? NONE,
-		portfolios: s.portfolios ?? NONE,
-		programs: s.programs ?? NONE,
-		projects: s.projects ?? NONE,
-		milestones: s.milestones ?? NONE,
-		raidItems: s.raidItems ?? NONE,
-		constraints: s.constraints ?? NONE,
-		tasks: s.tasks ?? NONE,
-		comments: s.comments ?? NONE,
-		attachments: s.attachments ?? NONE,
-		activity: s.activity ?? NONE,
-		currentUserId: s.currentUserId,
-		boardConfigs: s.boardConfigs ?? NO_CONFIGS,
-		readPingIds: s.readPingIds ?? NONE,
-		ropes: s.ropes ?? NONE,
-		checkIns: s.checkIns ?? NONE,
-		spendEntries: s.spendEntries ?? NONE,
-		reflections: s.reflections ?? NONE,
-		priorityRules: s.priorityRules ?? null,
-		workCalendar: s.workCalendar ?? null
-	};
-}
-/** The document as sent to the server: normalized and without inline file data. */
-function payloadOf(s) {
-	const data = pickData(s);
-	return {
-		...data,
-		people: data.people.map((p) => ({
-			...p,
-			accountId: p.accountId ?? null
-		})),
-		attachments: data.attachments.map((a) => a.url?.startsWith("data:") ? {
-			...a,
-			url: null
-		} : a)
-	};
-}
-var NONE, NO_CONFIGS;
-var init_payload = __esmMin((() => {
-	NONE = [];
-	NO_CONFIGS = {};
-}));
-
 // src/lib/view-only.ts
 function isDocumentKey(key, state) {
 	documentKeys ??= new Set(Object.keys(pickData(state)));

package/lib/cli.mjs

@@ -233,6 +233,7 @@ export const HELP = `harbor: Harbor from the terminal
   harbor report PROGRAM                       a program's status report
   harbor export tasks PROJECT|risks|review [--all]
                                               a spreadsheet (CSV) to stdout
+  harbor export harbor [--csv]                the whole harbor as JSON (owners)
   harbor import FILE [--project P] [--portfolio P] [--no-people]
                                               add tasks from a CSV file
   harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
@@ -870,11 +871,16 @@ const DETAIL = {
     "  harbor export risks [--all]            reads the risk register as CSV",
     "                                         (--all adds closed ones)",
     "  harbor export review                   reads the review as CSV",
+    "  harbor export harbor                   reads the whole harbor as JSON:",
+    "                                         every project, task, comment, risk,",
+    "                                         person and day off (owners only)",
+    "    --csv           every task instead, one row each with its project",
     "",
     "  The same spreadsheets the website's Export buttons download. They print;",
     "  harbor export tasks RR > tasks.csv saves one. A task export starts with",
     "  each task's key, so harbor import matches those tasks by key. With",
     "  --json, rows is one object per row, keyed by column.",
+    "  harbor export harbor > cedar.json keeps a copy of everything.",
   ],
   import: [
     "  harbor import FILE --project P         writes: adds the file's tasks",
@@ -2821,10 +2827,22 @@ export async function run(argv, io = {}) {
       return call("status_report", { harbor, program }, (r) => r.markdown);
     }
     case "export": {
-      const { positionals, values, harbor } = parse(spec(["all"]));
+      const { positionals, values, harbor } = parse(spec(["all", "csv"]));
       const [what, ...name] = positionals;
+      if (what === "harbor") {
+        none(name);
+        // The whole harbor, owners only: JSON by default, every task with --csv.
+        return call(
+          "export_harbor",
+          { harbor, as: values.csv ? "csv" : "json" },
+          (r) => (r.csv ? r.csv.replace(/\r\n/g, "\n") : r.json),
+          (r) => (asJson && r.json ? JSON.parse(r.json) : r),
+        );
+      }
       if (!["tasks", "risks", "review"].includes(what))
-        throw new HarborError("Say what to export: harbor export tasks PROJECT, risks or review.");
+        throw new HarborError(
+          "Say what to export: harbor export tasks PROJECT, risks, review or harbor.",
+        );
       const project = name.join(" ").trim();
       if (what === "tasks" && !project)
         throw new HarborError('Give the project: harbor export tasks "NAME".');

package/package.json

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