@staff0rd/assist 0.576.0 → 0.577.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.576.0",
+  version: "0.577.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -14914,12 +14914,12 @@ async function link(fromId, toId, opts) {
   const { orm } = await getReady();
   const fromItem = await loadItem(orm, fromNum);
   if (!fromItem) return void fail4(`Item ${from} not found.`);
-  const toItem = await loadItem(orm, toNum);
-  if (!toItem) return void fail4(`Item ${to} not found.`);
+  const toItem2 = await loadItem(orm, toNum);
+  if (!toItem2) return void fail4(`Item ${to} not found.`);
   if (!validateLinkTarget(fromItem, fromNum, toNum, linkType)) return;
   if (await createsCycle(orm, linkType, fromNum, toNum)) return;
   await orm.insert(links).values({ itemId: fromNum, type: linkType, targetId: toNum });
-  console.log(chalk85.green(`Linked ${from} ${linkType} ${to} (${toItem.name})`));
+  console.log(chalk85.green(`Linked ${from} ${linkType} ${to} (${toItem2.name})`));
 }
 
 // src/commands/backlog/unlink.ts
@@ -22727,6 +22727,186 @@ function registerMermaid(program2) {
   configHelp(cmd, mermaidConfigHelp);
 }
 
+// src/commands/miro/runExtract.ts
+import { stringify } from "yaml";
+
+// src/commands/miro/MiroExtractError.ts
+var MiroExtractError = class extends Error {
+  constructor(message3) {
+    super(message3);
+    this.name = "MiroExtractError";
+  }
+};
+
+// src/commands/miro/stripHtml.ts
+var namedEntities = {
+  amp: "&",
+  apos: "'",
+  gt: ">",
+  lt: "<",
+  nbsp: " ",
+  quot: '"'
+};
+function decodeEntity(_match, entity) {
+  if (entity.startsWith("#")) {
+    const code = entity.startsWith("#x") || entity.startsWith("#X") ? Number.parseInt(entity.slice(2), 16) : Number.parseInt(entity.slice(1), 10);
+    return Number.isNaN(code) ? _match : String.fromCodePoint(code);
+  }
+  return namedEntities[entity.toLowerCase()] ?? _match;
+}
+function stripHtml2(content) {
+  return content.replace(/<br\s*\/?>/gi, " ").replace(/<\/(?:p|div|li|h[1-6])>/gi, " ").replace(/<[^>]*>/g, "").replace(/&(#[0-9a-f]+|[a-z]+);/gi, decodeEntity).replace(/\s+/g, " ").trim();
+}
+
+// src/commands/miro/normaliseItems.ts
+var frameCoordinates = "parent_top_left";
+function describe2(item) {
+  return `  ${item.id ?? "(no id)"} (${item.type ?? "unknown type"}): relativeTo=${item.position?.relativeTo ?? "missing"}`;
+}
+function coordinateSpaceError(rejected) {
+  return new MiroExtractError(
+    `${rejected.length} item(s) are not in frame coordinates (position.relativeTo must be "${frameCoordinates}"):
+${rejected.slice(0, 5).map(describe2).join(
+      "\n"
+    )}
+
+Dump the frame with board_list_items using ?moveToWidget=<frame id> so every item shares one coordinate space.`
+  );
+}
+function toItem(item) {
+  const halfWidth = (item.geometry?.width ?? 0) / 2;
+  const halfHeight = (item.geometry?.height ?? 0) / 2;
+  const x = item.position?.x ?? 0;
+  const y = item.position?.y ?? 0;
+  return {
+    id: item.id ?? "",
+    type: item.type ?? "",
+    text: stripHtml2(item.data?.content ?? ""),
+    left: x - halfWidth,
+    top: y - halfHeight,
+    right: x + halfWidth,
+    bottom: y + halfHeight
+  };
+}
+function normaliseItems(items2) {
+  const rejected = items2.filter(
+    (item) => item.position?.relativeTo !== frameCoordinates
+  );
+  if (rejected.length > 0) throw coordinateSpaceError(rejected);
+  return items2.map(toItem);
+}
+
+// src/commands/miro/parseAnchorId.ts
+function parseAnchorId(value) {
+  const trimmed = value.trim();
+  const link3 = /[?&]moveToWidget=([^&#]+)/.exec(trimmed);
+  return link3 ? decodeURIComponent(link3[1]).trim() : trimmed;
+}
+
+// src/commands/miro/readMiroItems.ts
+import { readFileSync as readFileSync40 } from "fs";
+function tryParse(text18) {
+  try {
+    return JSON.parse(text18);
+  } catch {
+    return void 0;
+  }
+}
+function toPage(value) {
+  const record = value ?? {};
+  if (Array.isArray(record.data)) return { data: record.data };
+  return record.id ? { data: [record] } : {};
+}
+function parseJsonLines(raw, file) {
+  return raw.split("\n").map((line) => line.trim()).filter(Boolean).map((line) => {
+    const parsed = tryParse(line);
+    if (parsed === void 0)
+      throw new MiroExtractError(
+        `${file} is not valid JSON or JSON lines. Save the raw board_list_items response pages without editing them.`
+      );
+    return toPage(parsed);
+  });
+}
+function parsePages(raw, file) {
+  const parsed = tryParse(raw);
+  if (parsed === void 0) return parseJsonLines(raw, file);
+  return Array.isArray(parsed) ? parsed.map(toPage) : [toPage(parsed)];
+}
+function readMiroItems(file) {
+  const items2 = parsePages(readFileSync40(file, "utf8"), file).flatMap(
+    (page) => page.data ?? []
+  );
+  if (items2.length === 0)
+    throw new MiroExtractError(
+      `No board items found in ${file}. Dump the frame with board_list_items, paging until has_more is false.`
+    );
+  return items2;
+}
+
+// src/commands/miro/selectBoxes.ts
+var boxTypes = /* @__PURE__ */ new Set(["shape", "sticky_note"]);
+function findAnchor(items2, id) {
+  const anchor = items2.find((item) => item.id === id);
+  if (!anchor)
+    throw new MiroExtractError(
+      `No item with id ${id} in the supplied items. Re-dump the frame so the anchor is included, then try again.`
+    );
+  return anchor;
+}
+function isBox(item) {
+  return boxTypes.has(item.type) && item.text.length > 0;
+}
+function centreInside(rect, item) {
+  const x = (item.left + item.right) / 2;
+  const y = (item.top + item.bottom) / 2;
+  return x >= rect.left && x <= rect.right && y >= rect.top && y <= rect.bottom;
+}
+function selectBoxes(items2, topLeftId, bottomRightId) {
+  const topLeft = findAnchor(items2, topLeftId);
+  const bottomRight = findAnchor(items2, bottomRightId);
+  const rect = {
+    left: topLeft.left,
+    top: topLeft.top,
+    right: bottomRight.right,
+    bottom: bottomRight.bottom
+  };
+  return items2.filter((item) => isBox(item) && centreInside(rect, item)).sort((a, b) => a.left - b.left || a.top - b.top);
+}
+
+// src/commands/miro/runExtract.ts
+function requireItems(file) {
+  if (!file)
+    throw new MiroExtractError(
+      "--items <file> is required: a file of raw board_list_items response pages."
+    );
+  return file;
+}
+function requireAnchors(options2) {
+  if (!options2.topLeft || !options2.bottomRight)
+    throw new MiroExtractError(
+      "Both --top-left <id|link> and --bottom-right <id|link> are required."
+    );
+  return [parseAnchorId(options2.topLeft), parseAnchorId(options2.bottomRight)];
+}
+function runExtract(options2) {
+  const [topLeft, bottomRight] = requireAnchors(options2);
+  const items2 = normaliseItems(readMiroItems(requireItems(options2.items)));
+  const boxes = selectBoxes(items2, topLeft, bottomRight);
+  process.stdout.write(stringify(boxes.map((box) => box.text)));
+}
+
+// src/commands/miro/registerMiro.ts
+function registerMiro(program2) {
+  const miroCommand = program2.command("miro").description("Miro board utilities");
+  miroCommand.command("extract").description("Print the text of every box inside a rectangle on a board").option("--items <file>", "File of raw board_list_items response pages").option(
+    "--top-left <id>",
+    "Widget id or ?moveToWidget=<id> link of the top-left box"
+  ).option(
+    "--bottom-right <id>",
+    "Widget id or ?moveToWidget=<id> link of the bottom-right box"
+  ).action(runExtract);
+}
+
 // src/commands/netcap/netcap.ts
 import { mkdir as mkdir4 } from "fs/promises";
 import { createServer as createServer2 } from "http";
@@ -22936,7 +23116,7 @@ import { join as join61 } from "path";
 import chalk171 from "chalk";
 
 // src/commands/netcap/extractPostsFromCapture.ts
-import { readFileSync as readFileSync40 } from "fs";
+import { readFileSync as readFileSync41 } from "fs";
 
 // src/commands/netcap/parseRscRows.ts
 var isRscRef = (v) => typeof v === "string" && /^\$[0-9a-fL@]/.test(v);
@@ -23332,7 +23512,7 @@ function extractVoyagerPosts(body) {
 
 // src/commands/netcap/extractPostsFromCapture.ts
 function captureEntries(captureFile) {
-  const lines2 = readFileSync40(captureFile, "utf8").split("\n").filter(Boolean);
+  const lines2 = readFileSync41(captureFile, "utf8").split("\n").filter(Boolean);
   const entries = [];
   for (const line of lines2) {
     let entry;
@@ -23906,7 +24086,7 @@ import { tmpdir as tmpdir6 } from "os";
 import { join as join63 } from "path";
 
 // src/commands/prs/loadCommentsCache.ts
-import { existsSync as existsSync54, readFileSync as readFileSync41, unlinkSync as unlinkSync13 } from "fs";
+import { existsSync as existsSync54, readFileSync as readFileSync42, unlinkSync as unlinkSync13 } from "fs";
 import { parse as parse2 } from "yaml";
 
 // src/commands/prs/commentsCachePath.ts
@@ -23929,7 +24109,7 @@ function loadCommentsCache(org, repo, prNumber) {
   if (!existsSync54(cachePath)) {
     return null;
   }
-  const content = readFileSync41(cachePath, "utf8");
+  const content = readFileSync42(cachePath, "utf8");
   return parse2(content);
 }
 function deleteCommentsCache(org, repo, prNumber) {
@@ -24121,7 +24301,7 @@ function fetchLineComments(org, repo, prNumber, threadInfo) {
 // src/commands/prs/listComments/updateCommentsCache.ts
 import { mkdirSync as mkdirSync19, writeFileSync as writeFileSync36 } from "fs";
 import { dirname as dirname29 } from "path";
-import { stringify } from "yaml";
+import { stringify as stringify2 } from "yaml";
 
 // src/commands/prs/removeStaleCommentsCaches.ts
 import { readdirSync as readdirSync12, unlinkSync as unlinkSync16 } from "fs";
@@ -24149,7 +24329,7 @@ function writeCommentsCache(org, repo, prNumber, comments3) {
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
     comments: comments3
   };
-  writeFileSync36(cachePath, stringify(cacheData));
+  writeFileSync36(cachePath, stringify2(cacheData));
 }
 function updateCommentsCache(org, repo, prNumber, comments3) {
   removeStaleCommentsCaches();
@@ -27481,7 +27661,7 @@ function gatherContext() {
 }
 
 // src/commands/review/postReviewToPr.ts
-import { readFileSync as readFileSync42 } from "fs";
+import { readFileSync as readFileSync43 } from "fs";
 
 // src/commands/review/carriedUnanchoredFindings.ts
 function carriedUnanchoredFindings(unanchored) {
@@ -27929,7 +28109,7 @@ async function confirmPost(prNumber, work, options2) {
   return promptConfirm(`Post ${work} to PR #${prNumber}?`, false);
 }
 async function postFindingsToPr(prInfo, synthesisPath, options2) {
-  const markdown = readFileSync42(synthesisPath, "utf8");
+  const markdown = readFileSync43(synthesisPath, "utf8");
   const { inDiff, unanchored } = selectPostableFindings(markdown, prInfo);
   const carried = carriedUnanchoredFindings(unanchored);
   if (inDiff.length === 0 && carried.length === 0) return NOTHING_POSTED;
@@ -28818,7 +28998,7 @@ async function runReviewers(reviewDir, claudePath, codexPath, stdinPrompt, optio
 }
 
 // src/commands/review/synthesise.ts
-import { readFileSync as readFileSync43 } from "fs";
+import { readFileSync as readFileSync44 } from "fs";
 
 // src/commands/review/buildSynthesisStdin.ts
 var SYNTHESIS_PROMPT = `You are consolidating two independent code reviews of the same change. The original review request is in request.md. The two reviews are in claude.md and codex.md in the current working directory.
@@ -28883,7 +29063,7 @@ Files:
 
 // src/commands/review/synthesise.ts
 function printSummary2(synthesisPath) {
-  const markdown = readFileSync43(synthesisPath, "utf8");
+  const markdown = readFileSync44(synthesisPath, "utf8");
   console.log("");
   console.log(buildReviewSummary(markdown));
   console.log("");
@@ -30246,7 +30426,7 @@ function list4() {
 import {
   existsSync as existsSync63,
   mkdirSync as mkdirSync26,
-  readFileSync as readFileSync48,
+  readFileSync as readFileSync49,
   renameSync as renameSync2,
   writeFileSync as writeFileSync42
 } from "fs";
@@ -30458,7 +30638,7 @@ function formatChatLog(messages) {
 // src/commands/transcript/move.ts
 var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
 function convertVttToMarkdown(inputPath) {
-  const cues = parseVtt(readFileSync48(inputPath, "utf8"));
+  const cues = parseVtt(readFileSync49(inputPath, "utf8"));
   const messages = cuesToChatMessages(deduplicateCues(cues));
   return formatChatLog(messages);
 }
@@ -30605,14 +30785,14 @@ function devices() {
 }
 
 // src/commands/voice/logs.ts
-import { existsSync as existsSync64, readFileSync as readFileSync49 } from "fs";
+import { existsSync as existsSync64, readFileSync as readFileSync50 } from "fs";
 function logs(options2) {
   if (!existsSync64(voicePaths.log)) {
     console.log("No voice log file found");
     return;
   }
   const count8 = Number.parseInt(options2.lines ?? "150", 10);
-  const content = readFileSync49(voicePaths.log, "utf8").trim();
+  const content = readFileSync50(voicePaths.log, "utf8").trim();
   if (!content) {
     console.log("Voice log is empty");
     return;
@@ -30639,7 +30819,7 @@ import { join as join82 } from "path";
 
 // src/commands/voice/checkLockFile.ts
 import { execSync as execSync58 } from "child_process";
-import { existsSync as existsSync65, mkdirSync as mkdirSync27, readFileSync as readFileSync50, writeFileSync as writeFileSync43 } from "fs";
+import { existsSync as existsSync65, mkdirSync as mkdirSync27, readFileSync as readFileSync51, writeFileSync as writeFileSync43 } from "fs";
 import { join as join81 } from "path";
 function isProcessAlive2(pid) {
   try {
@@ -30653,7 +30833,7 @@ function checkLockFile() {
   const lockFile = getLockFile();
   if (!existsSync65(lockFile)) return;
   try {
-    const lock2 = JSON.parse(readFileSync50(lockFile, "utf8"));
+    const lock2 = JSON.parse(readFileSync51(lockFile, "utf8"));
     if (lock2.pid && isProcessAlive2(lock2.pid)) {
       console.error(
         `Voice daemon already running (PID ${lock2.pid}, env: ${lock2.env}). Stop it first with: assist voice stop`
@@ -30755,7 +30935,7 @@ function start2(options2) {
 }
 
 // src/commands/voice/status.ts
-import { existsSync as existsSync66, readFileSync as readFileSync51 } from "fs";
+import { existsSync as existsSync66, readFileSync as readFileSync52 } from "fs";
 function isProcessAlive3(pid) {
   try {
     process.kill(pid, 0);
@@ -30766,7 +30946,7 @@ function isProcessAlive3(pid) {
 }
 function readRecentLogs(count8) {
   if (!existsSync66(voicePaths.log)) return [];
-  const lines2 = readFileSync51(voicePaths.log, "utf8").trim().split("\n");
+  const lines2 = readFileSync52(voicePaths.log, "utf8").trim().split("\n");
   return lines2.slice(-count8);
 }
 function status2() {
@@ -30774,7 +30954,7 @@ function status2() {
     console.log("Voice daemon: not running (no PID file)");
     return;
   }
-  const pid = Number.parseInt(readFileSync51(voicePaths.pid, "utf8").trim(), 10);
+  const pid = Number.parseInt(readFileSync52(voicePaths.pid, "utf8").trim(), 10);
   const alive = isProcessAlive3(pid);
   console.log(`Voice daemon: ${alive ? "running" : "dead"} (PID ${pid})`);
   const recent = readRecentLogs(5);
@@ -30793,13 +30973,13 @@ function status2() {
 }
 
 // src/commands/voice/stop.ts
-import { existsSync as existsSync67, readFileSync as readFileSync52, unlinkSync as unlinkSync20 } from "fs";
+import { existsSync as existsSync67, readFileSync as readFileSync53, unlinkSync as unlinkSync20 } from "fs";
 function stop2() {
   if (!existsSync67(voicePaths.pid)) {
     console.log("Voice daemon is not running (no PID file)");
     return;
   }
-  const pid = Number.parseInt(readFileSync52(voicePaths.pid, "utf8").trim(), 10);
+  const pid = Number.parseInt(readFileSync53(voicePaths.pid, "utf8").trim(), 10);
   try {
     process.kill(pid, "SIGTERM");
     console.log(`Sent SIGTERM to voice daemon (PID ${pid})`);
@@ -31674,7 +31854,7 @@ async function auth() {
 
 // src/commands/roam/postRoamActivity.ts
 import { execFileSync as execFileSync18 } from "child_process";
-import { readdirSync as readdirSync20, readFileSync as readFileSync53, statSync as statSync11 } from "fs";
+import { readdirSync as readdirSync20, readFileSync as readFileSync54, statSync as statSync11 } from "fs";
 import { join as join86 } from "path";
 function findPortFile(roamDir) {
   let entries;
@@ -31700,7 +31880,7 @@ function postRoamActivity(app, event) {
   if (!portFile) return;
   let port;
   try {
-    port = readFileSync53(portFile, "utf8").trim();
+    port = readFileSync54(portFile, "utf8").trim();
   } catch {
     return;
   }
@@ -32232,11 +32412,11 @@ function applyLine(result, pending, line) {
 }
 
 // src/commands/sessions/daemon/readDaemonPidFile.ts
-import { readFileSync as readFileSync54 } from "fs";
+import { readFileSync as readFileSync55 } from "fs";
 function readDaemonPidFile() {
   try {
     const pid = Number.parseInt(
-      readFileSync54(daemonPaths.pid, "utf8").trim(),
+      readFileSync55(daemonPaths.pid, "utf8").trim(),
       10
     );
     return Number.isInteger(pid) ? pid : void 0;
@@ -36267,14 +36447,14 @@ async function defaultConnect() {
 }
 
 // src/commands/sessions/daemon/hasPersistedWindowsSessions.ts
-import { existsSync as existsSync84, readFileSync as readFileSync56 } from "fs";
+import { existsSync as existsSync84, readFileSync as readFileSync57 } from "fs";
 import { posix as posix3 } from "path";
 function hasPersistedWindowsSessions() {
   const sessionsFile = windowsSessionsFileFromWsl();
   if (!sessionsFile) return false;
   try {
     if (!existsSync84(sessionsFile)) return false;
-    const data = JSON.parse(readFileSync56(sessionsFile, "utf8"));
+    const data = JSON.parse(readFileSync57(sessionsFile, "utf8"));
     return Array.isArray(data) && data.length > 0;
   } catch (error) {
     const message3 = error instanceof Error ? error.message : String(error);
@@ -37692,7 +37872,7 @@ function handleConnection(socket, manager) {
 import { unlinkSync as unlinkSync23, writeFileSync as writeFileSync47 } from "fs";
 
 // src/commands/sessions/daemon/startPidFileWatchdog.ts
-import { readFileSync as readFileSync57 } from "fs";
+import { readFileSync as readFileSync58 } from "fs";
 var WATCHDOG_INTERVAL_MS = 5e3;
 function startPidFileWatchdog(onLost, intervalMs = WATCHDOG_INTERVAL_MS) {
   const timer = setInterval(() => {
@@ -37703,7 +37883,7 @@ function startPidFileWatchdog(onLost, intervalMs = WATCHDOG_INTERVAL_MS) {
 }
 function ownsPidFile() {
   try {
-    return readFileSync57(daemonPaths.pid, "utf8").trim() === String(process.pid);
+    return readFileSync58(daemonPaths.pid, "utf8").trim() === String(process.pid);
   } catch {
     return false;
   }
@@ -38158,7 +38338,7 @@ function buildLimitsSegment(rateLimits) {
 }
 
 // src/commands/readGitBranch.ts
-import { readFileSync as readFileSync59, statSync as statSync15 } from "fs";
+import { readFileSync as readFileSync60, statSync as statSync15 } from "fs";
 import { isAbsolute as isAbsolute4, join as join95, resolve as resolve22 } from "path";
 function resolveGitDir(cwd) {
   const dotGit = join95(cwd, ".git");
@@ -38173,7 +38353,7 @@ function resolveGitDir(cwd) {
   }
   let contents;
   try {
-    contents = readFileSync59(dotGit, "utf8");
+    contents = readFileSync60(dotGit, "utf8");
   } catch {
     return null;
   }
@@ -38191,7 +38371,7 @@ function readGitBranch(cwd) {
   }
   let head;
   try {
-    head = readFileSync59(join95(gitDir, "HEAD"), "utf8");
+    head = readFileSync60(join95(gitDir, "HEAD"), "utf8");
   } catch {
     return null;
   }
@@ -38318,7 +38498,7 @@ async function update2() {
 // src/reportCliError.ts
 import chalk221 from "chalk";
 function reportCliError(error) {
-  if (error instanceof InvalidItemIdError || error instanceof AmbiguousRepoConfigError || error instanceof UnknownRepoConfigError || error instanceof MissingRunCwdError) {
+  if (error instanceof InvalidItemIdError || error instanceof AmbiguousRepoConfigError || error instanceof UnknownRepoConfigError || error instanceof MissingRunCwdError || error instanceof MiroExtractError) {
     console.error(chalk221.red(error.message));
   } else {
     console.error(error);
@@ -38362,6 +38542,7 @@ registerGithub(program);
 registerHandover(program);
 registerJira(program);
 registerMermaid(program);
+registerMiro(program);
 registerPrs(program);
 registerRoam(program);
 registerBacklog(program);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.576.0",
+	"version": "0.577.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {