@harborppm/cli 0.74.0 → 0.76.0

package/dist/app.mjs

@@ -18722,6 +18722,146 @@ 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) {
+	return tasksSheetCsv(data, data.tasks);
+}
+/**
+* These tasks, one row each, as `allTasksCsv` lays them out: the whole
+* harbor's, or a program's for a sheet link (src/lib/sheet-feed.ts).
+*/
+function tasksSheetCsv(data, rows) {
+	const projects = byId(data.projects);
+	const programs = byId(data.programs);
+	const people = byId(data.people);
+	const tasks = byId(rows);
+	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"
+	], rows.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 +20548,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 +21320,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)));
@@ -21231,10 +21347,11 @@ function viewerUpdate(state, partial) {
 }
 /**
 * Whether this saved harbor can't be changed from here: the person is a
-* viewer, or its free trial has ended with nobody keeping it (keep.ts).
+* viewer, its free trial has ended with nobody keeping it (keep.ts), or it
+* was opened offline from this device's copy (`offlineCopy`).
 */
 function readOnlyHarbor(s) {
-	return s.cloud && (s.myRole === "viewer" || Boolean(s.keepPaused));
+	return s.cloud && (s.myRole === "viewer" || Boolean(s.keepPaused) || Boolean(s.offlineCopy));
 }
 var VIEWER_LOCAL, documentKeys;
 var init_view_only = __esmMin((() => {
@@ -21689,6 +21806,7 @@ function sessionSlice({ set, get, write }) {
 		}),
 		setWorkspaceVersion: (workspaceVersion) => set({ workspaceVersion }),
 		setPhase: (phase) => set({ phase }),
+		setOfflineCopy: (offlineCopy) => set({ offlineCopy }),
 		setMyRole: (myRole) => set({ myRole }),
 		setHarborName: (harborName) => set({ harborName }),
 		setKeep: (k) => set({
@@ -24719,6 +24837,7 @@ function shoreService(raw) {
 	if ((host === "discord.com" || host === "discordapp.com" || host === "ptb.discord.com" || host === "canary.discord.com") && /^\/api\/webhooks\/\d+\/[\w-]+$/.test(path)) return "discord";
 	if (/^[a-z0-9-]+\.webhook\.office\.com$/.test(host) && path.startsWith("/webhookb2/")) return "teams";
 	if ((/^[a-z0-9.-]+\.logic\.azure\.com$/.test(host) || /^[a-z0-9.-]+\.environment\.api\.powerplatform\.com$/.test(host)) && path.includes("/workflows/")) return "teams-workflow";
+	if (host === "chat.googleapis.com" && /^\/v1\/spaces\/[\w-]+\/messages$/.test(path) && url.searchParams.get("key") && url.searchParams.get("token")) return "google-chat";
 	return null;
 }
 /** "hooks.slack.com/…8f2Q": enough to recognise an address without showing the secret in it. */
@@ -24737,7 +24856,8 @@ var init_shore = __esmMin((() => {
 		slack: "Slack",
 		discord: "Discord",
 		teams: "Teams",
-		"teams-workflow": "Teams"
+		"teams-workflow": "Teams",
+		"google-chat": "Google Chat"
 	};
 	SHORE_KINDS = [
 		{
@@ -24829,7 +24949,7 @@ function memoryHarbor(start, opts) {
 				}
 				let row = hooks.get(program.id);
 				if (ask.url || ask.on?.length || ask.off?.length) {
-					if (ask.url && !shoreService(ask.url)) throw new TransportError("That isn’t a Slack, Discord or Teams incoming-webhook address.", 400);
+					if (ask.url && !shoreService(ask.url)) throw new TransportError("That isn’t a Slack, Discord, Teams or Google Chat incoming-webhook address.", 400);
 					const url = ask.url || row?.url;
 					if (!url) throw new TransportError("Paste the channel’s address first.", 400);
 					row = {
@@ -26446,7 +26566,7 @@ function LifeboatsPanel({ id, width, height, go, active, onClose }) {
 
 // src/tui/views/shore.tsx
 /**
-* Ship to shore in the terminal: a program's Slack, Discord or Teams channel
+* Ship to shore in the terminal: a program's Slack, Discord, Teams or Google Chat channel
 * and which posts go there, as the website's dialog sets it (shore.ts). The
 * address is a secret, so once saved only a hint of it shows. Asks /api/app's
 * `shore` (the in-memory server keeps a pretend one).
@@ -26499,7 +26619,7 @@ function ShorePanel({ id, width, height, go, active, onClose }) {
 		if (input === "p") return go.ask("The channel's incoming-webhook address", (text) => {
 			const url = text.trim();
 			if (!url) return;
-			if (!shoreService(url)) return go.notify("That isn't a Slack, Discord or Teams incoming-webhook address. It starts https://hooks.slack.com/, https://discord.com/api/webhooks/ or a Teams workflow address.");
+			if (!shoreService(url)) return go.notify("That isn't a Slack, Discord, Teams or Google Chat incoming-webhook address. It starts https://hooks.slack.com/, https://discord.com/api/webhooks/, https://chat.googleapis.com/ or a Teams workflow address.");
 			send({ url }, (a) => `Connected to ${a.hook?.service ?? "the channel"}. Turn on what it posts.`);
 		});
 		if (!hook) return;
@@ -26545,7 +26665,7 @@ function ShorePanel({ id, width, height, go, active, onClose }) {
 			/* @__PURE__ */ jsx(Text, {
 				color: theme.muted,
 				wrap: "wrap",
-				children: "Harbor posts into one Slack, Discord or Teams channel for this program instead of sending mail. Each post links back here."
+				children: "Harbor posts into one Slack, Discord, Teams or Google Chat channel for this program instead of sending mail. Each post links back here."
 			}),
 			/* @__PURE__ */ jsx(Text, { children: " " }),
 			failed ? /* @__PURE__ */ jsx(Text, {

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]
@@ -768,8 +769,8 @@ const DETAIL = {
   shore: [
     "  harbor shore PROGRAM                   reads the program's chat channel and",
     "                                         which posts go there",
-    "  harbor shore PROGRAM --url URL         writes: posts go to this Slack, Discord",
-    "                                         or Teams incoming-webhook address",
+    "  harbor shore PROGRAM --url URL         writes: posts go to this Slack, Discord,",
+    "                                         Teams or Google Chat webhook address",
     "  harbor shore PROGRAM --on KINDS        writes: turns posts on; KINDS are",
     "                                         forecast, health and notes, with commas",
     "  harbor shore PROGRAM --off KINDS       writes: turns them off",
@@ -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.76.0",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",