codetrellis 0.0.0-stage → 0.2.0

package/src/shared/lib/tool-phrasing.js

@@ -0,0 +1,338 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var tool_phrasing_exports = {};
+__export(tool_phrasing_exports, {
+  phraseEvent: () => phraseEvent,
+  rawPayloadText: () => rawPayloadText
+});
+module.exports = __toCommonJS(tool_phrasing_exports);
+function subject(args, ...keys) {
+  for (const key of keys) {
+    const v = args[key];
+    if (typeof v === "string" && v.trim() && !/^(itm|pln|doc|evt)_/.test(v) && !/^[0-9a-f]{8}-[0-9a-f]{4}-/i.test(v)) {
+      return `"${v.length > 60 ? `${v.slice(0, 57)}\u2026` : v}"`;
+    }
+  }
+  for (const key of keys) {
+    const v = args[key];
+    if (typeof v === "string" && v.trim()) return `${v.slice(0, 12)}\u2026`;
+  }
+  return "an item";
+}
+const STATUS_VERB = {
+  in_progress: "Started",
+  done: "Finished",
+  blocked: "Blocked",
+  pending: "Reset",
+  cancelled: "Cancelled"
+};
+const TOOL_PHRASINGS = {
+  // ── Plan items: the ones that describe intent ──────────────────────
+  update_item: {
+    intent: "write",
+    mutating: true,
+    phrase: (a) => {
+      const status = typeof a.status === "string" ? a.status : null;
+      const verb = status ? STATUS_VERB[status] ?? `Set ${status} on` : "Updated";
+      return `${verb} ${subject(a, "title", "uid", "item_uid")}`;
+    }
+  },
+  add_item: {
+    intent: "write",
+    mutating: true,
+    phrase: (a) => `Added ${subject(a, "title", "uid")}`
+  },
+  bulk_add_items: {
+    intent: "write",
+    mutating: true,
+    phrase: (a) => {
+      const items = Array.isArray(a.items) ? a.items.length : null;
+      return items ? `Added ${items} items` : "Added several items";
+    }
+  },
+  delete_item: { intent: "write", mutating: true, phrase: (a) => `Deleted ${subject(a, "title", "uid")}` },
+  move_item: { intent: "write", mutating: true, phrase: (a) => `Moved ${subject(a, "title", "uid")}` },
+  claim_item: { intent: "write", mutating: true, phrase: (a) => `Claimed ${subject(a, "title", "uid")}` },
+  set_item_blocked: { intent: "write", mutating: true, phrase: (a) => `Blocked ${subject(a, "title", "uid")}` },
+  update_item_progress: {
+    intent: "write",
+    mutating: true,
+    phrase: (a) => {
+      const pct = typeof a.progress === "number" ? ` to ${a.progress}%` : "";
+      return `Moved ${subject(a, "title", "uid")}${pct}`;
+    }
+  },
+  add_item_comment: { intent: "write", mutating: true, phrase: (a) => `Commented on ${subject(a, "title", "uid")}` },
+  // ── Plans ─────────────────────────────────────────────────────────
+  create_plan: { intent: "write", mutating: true, phrase: (a) => `Created plan ${subject(a, "title")}` },
+  create_plan_from_template: {
+    intent: "write",
+    mutating: true,
+    phrase: (a) => `Created plan ${subject(a, "title")} from the ${String(a.template_id ?? "a")} template`
+  },
+  update_plan: { intent: "write", mutating: true, phrase: (a) => `Updated plan ${subject(a, "title", "plan_uid")}` },
+  set_active_plan: { intent: "session", mutating: false, phrase: (a) => `Switched to plan ${subject(a, "title", "plan_uid")}` },
+  export_plan_to_files: { intent: "write", mutating: true, phrase: (a) => `Exported plan ${subject(a, "plan_uid")} to disk` },
+  // ── Asking the human ──────────────────────────────────────────────
+  request_plan_deletion: {
+    intent: "ask",
+    mutating: false,
+    phrase: (a) => {
+      const n = Array.isArray(a.plan_uids) ? a.plan_uids.length : 1;
+      return n === 1 ? "Asked you to confirm deleting a plan" : `Asked you to confirm deleting ${n} plans`;
+    }
+  },
+  post_channel_event: {
+    intent: "ask",
+    mutating: true,
+    phrase: (a) => {
+      const type = typeof a.event_type === "string" ? a.event_type : "note";
+      const what = {
+        stuck: "Reported being stuck",
+        "need-decision": "Asked for a decision",
+        "need-context": "Asked for context",
+        "handing-off": "Handed off",
+        steer: "Gave direction",
+        "weigh-in": "Asked for a second opinion"
+      };
+      const msg = typeof a.message === "string" && a.message ? `: ${a.message.slice(0, 60)}` : "";
+      return `${what[type] ?? "Posted a note"}${msg}`;
+    }
+  },
+  await_user_input: { intent: "ask", mutating: false, phrase: () => "Waiting for your answer" },
+  await_ack: { intent: "ask", mutating: false, phrase: () => "Waiting for acknowledgement" },
+  await_decision: { intent: "ask", mutating: false, phrase: () => "Waiting for a decision at a breakpoint" },
+  check_breakpoint: { intent: "read", mutating: false, phrase: (a) => typeof a.path === "string" ? `Checked for a breakpoint on \`${a.path}\`` : "Checked for a breakpoint" },
+  approve_gate: { intent: "error", mutating: false, phrase: (a) => `Tried to clear the approval gate on ${subject(a, "uid")} \u2014 refused, sign-off is yours` },
+  record_artefact: { intent: "write", mutating: true, phrase: (a) => `Recorded ${{ material: "a material", output: "an output", evidence: "evidence" }[String(a.role)] ?? "a file"}: ${subject(a, "path")}` },
+  list_criteria: { intent: "read", mutating: false, phrase: (a) => `Read the criteria for ${subject(a, "item_uid")}` },
+  add_criterion: { intent: "write", mutating: true, phrase: (a) => `Added a criterion: ${subject(a, "text")}` },
+  submit_criterion: { intent: "ask", mutating: true, phrase: (a, summary) => summary ?? `Submitted evidence for ${subject(a, "criterion_uid")}` },
+  check_criterion: { intent: "read", mutating: false, phrase: (a, summary) => summary ?? `Checked evidence for ${subject(a, "criterion_uid")}` },
+  get_worklist: { intent: "read", mutating: false, phrase: () => "Read the worklist" },
+  run_checks: { intent: "read", mutating: false, phrase: () => "Re-ran every check on the plan" },
+  get_brief: { intent: "read", mutating: false, phrase: (a) => `Read the brief for ${subject(a, "item_uid")}` },
+  list_materials: { intent: "read", mutating: false, phrase: () => "Listed the materials" },
+  read_material: { intent: "read", mutating: false, phrase: (a, summary) => summary ?? `Read material ${subject(a, "attachment_uid")}` },
+  // ── Reading ───────────────────────────────────────────────────────
+  search_symbols: { intent: "read", mutating: false, phrase: (a) => `Looked for \`${String(a.query ?? "")}\`` },
+  search_items: { intent: "read", mutating: false, phrase: (a) => `Searched the plan for \`${String(a.query ?? "")}\`` },
+  get_dependencies: { intent: "read", mutating: false, phrase: (a) => `Checked what depends on ${String(a.file_path ?? a.path ?? "a file")}` },
+  check_architecture: { intent: "read", mutating: false, phrase: () => "Checked the architecture" },
+  check_conformity: { intent: "read", mutating: false, phrase: () => "Checked conformity" },
+  get_drift_report: { intent: "read", mutating: false, phrase: () => "Checked for drift" },
+  get_next_item: { intent: "read", mutating: false, phrase: () => "Asked what to work on next" },
+  get_item: { intent: "read", mutating: false, phrase: (a) => `Read ${subject(a, "title", "uid")}` },
+  resolve_reference: { intent: "read", mutating: false, phrase: (a) => `Looked up ${subject(a, "ref")}` },
+  read_item_full: { intent: "read", mutating: false, phrase: (a) => `Read ${subject(a, "title", "uid")} in full` },
+  get_plan: { intent: "read", mutating: false, phrase: (a) => `Read plan ${subject(a, "title", "plan_uid")}` },
+  list_items: { intent: "read", mutating: false, phrase: () => "Listed plan items" },
+  list_plans: { intent: "read", mutating: false, phrase: () => "Listed plans" },
+  read_system_doc: { intent: "read", mutating: false, phrase: (a) => `Read the ${String(a.doc_type ?? "system")} doc` },
+  list_cross_system_edges: { intent: "read", mutating: false, phrase: () => "Checked cross-system links" },
+  // ── Session ───────────────────────────────────────────────────────
+  register_session: { intent: "session", mutating: false, phrase: (a) => `${String(a.agent_type ?? "An agent")} connected` },
+  open_project: { intent: "session", mutating: false, phrase: (a) => `Opened ${String(a.path ?? "a project")}` },
+  rescan_project: { intent: "session", mutating: false, phrase: () => "Rescanned the project" },
+  // ── System docs + git ─────────────────────────────────────────────
+  write_system_doc: { intent: "write", mutating: true, phrase: (a) => `Wrote the ${String(a.doc_type ?? "system")} doc` },
+  commit_manifest_changes: { intent: "write", mutating: true, phrase: () => "Committed plan changes" },
+  set_freeze: {
+    intent: "write",
+    mutating: true,
+    phrase: (a) => a.active === false ? "Lifted the freeze" : "Started a freeze"
+  }
+};
+function fileName(args, key) {
+  const v = args[key];
+  return typeof v === "string" && v.trim() ? v.split(/[\\/]/).pop() : "a file";
+}
+const BRIEF_PHRASINGS = {
+  get_brief: { intent: "read", mutating: false, phrase: () => "Read the brief" },
+  list_materials: { intent: "read", mutating: false, phrase: () => "Looked through the materials" },
+  read_material: { intent: "read", mutating: false, phrase: (_a, summary) => summary ?? "Read a material" },
+  record_artefact: {
+    intent: "write",
+    mutating: true,
+    phrase: (a) => {
+      const name = fileName(a, "path");
+      if (a.role === "output") return `Wrote ${name}`;
+      if (a.role === "evidence") return `Saved ${name} as evidence`;
+      return `Added ${name} to the materials`;
+    }
+  },
+  list_criteria: { intent: "read", mutating: false, phrase: () => "Read what good looks like" },
+  add_criterion: { intent: "write", mutating: true, phrase: (a) => `Suggested what good looks like: ${subject(a, "text")}` },
+  check_criterion: { intent: "read", mutating: false, phrase: (_a, summary) => summary ?? "Checked its work before offering it" },
+  submit_criterion: { intent: "ask", mutating: true, phrase: (a, summary) => summary ?? `Offered evidence for ${subject(a, "criterion_uid")}` },
+  get_worklist: { intent: "read", mutating: false, phrase: () => "Checked what it still owes you" },
+  run_checks: { intent: "read", mutating: false, phrase: () => "Re-checked the whole brief" },
+  get_next_item: { intent: "read", mutating: false, phrase: () => "Asked which task is next" },
+  claim_item: { intent: "write", mutating: true, phrase: (a) => `Took on ${subject(a, "title", "uid")}` },
+  add_item_comment: { intent: "write", mutating: true, phrase: (a) => `Left a note on ${subject(a, "title", "uid")}` }
+};
+function parseArgs(raw) {
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) return raw;
+  if (typeof raw === "string") {
+    try {
+      const parsed = JSON.parse(raw);
+      if (parsed && typeof parsed === "object") return parsed;
+    } catch {
+    }
+  }
+  return {};
+}
+function humaniseToolName(tool) {
+  const words = tool.replace(/_/g, " ").trim();
+  return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function decidedBy(actorType) {
+  return actorType === "human" ? "You" : actorType === "unverified" ? "Someone over the local API" : "Someone";
+}
+function phraseEvent(event, vocabulary = "code") {
+  const payload = event.payload ?? {};
+  const tool = typeof payload.tool === "string" ? payload.tool : null;
+  if (tool && (event.type === "tool_call" || event.type === "tool_error")) {
+    const args = parseArgs(payload.args);
+    const phrasing = (vocabulary === "brief" ? BRIEF_PHRASINGS[tool] : void 0) ?? TOOL_PHRASINGS[tool];
+    const summary = typeof payload.summary === "string" && payload.summary.trim() ? payload.summary : null;
+    if (event.type === "tool_error") {
+      const err = typeof payload.error === "string" ? `: ${payload.error.slice(0, 80)}` : "";
+      return {
+        text: `${humaniseToolName(tool)} failed${err}`,
+        intent: "error",
+        tool,
+        mutating: false
+      };
+    }
+    if (phrasing) {
+      return { text: phrasing.phrase(args, summary), intent: phrasing.intent, tool, mutating: phrasing.mutating };
+    }
+    return { text: humaniseToolName(tool), intent: "read", tool, mutating: false };
+  }
+  if (event.type === "spec_edited") {
+    const title = typeof payload.title === "string" && payload.title.trim() ? payload.title : "untitled";
+    const what = payload.kind === "item" ? `the description of \u201C${title}\u201D` : `the spec \u201C${title}\u201D`;
+    const version = typeof payload.version === "number" ? ` (v${payload.version})` : "";
+    const from = payload.authorType === "file" ? ", from the plan file" : "";
+    return { text: `Edited ${what}${version}${from}`, intent: "write", tool: null, mutating: true };
+  }
+  if (event.type === "skill_used") {
+    const skill = typeof payload.skill === "string" && payload.skill ? payload.skill.slice(0, 80) : null;
+    return { text: skill ? `Used the ${skill} skill` : "Used a skill", intent: "read", tool: null, mutating: false };
+  }
+  if (event.type === "breakpoint_hit" || event.type === "breakpoint_answered") {
+    const title = typeof payload.path === "string" && payload.path ? payload.path.slice(0, 120) : typeof payload.itemTitle === "string" && payload.itemTitle.trim() ? payload.itemTitle.slice(0, 80) : "an item";
+    const doing = { claim: "claiming", done: "marking done", edit: "changing", delete: "deleting", edit_code: "changing", breach: "changing" };
+    const what = `${doing[String(payload.action)] ?? "acting on"} \u201C${title}\u201D`;
+    if (event.type === "breakpoint_hit") {
+      if (payload.breach === true) return { text: `Changed \u201C${title}\u201D past a breakpoint: a breach, it could not be paused`, intent: "error", tool: null, mutating: true };
+      if (typeof payload.signalKind === "string") return { text: `Paused at a breakpoint on a serious ${payload.signalKind} signal, before ${what}`, intent: "ask", tool: null, mutating: false };
+      return { text: `Paused at a breakpoint before ${what}`, intent: "ask", tool: null, mutating: false };
+    }
+    if (payload.byType === "system") {
+      const why = typeof payload.note === "string" && payload.note ? `: ${payload.note.slice(0, 120)}` : "";
+      return { text: `CodeTrellis let ${what} through${why}`, intent: "write", tool: null, mutating: false };
+    }
+    const who = payload.byType === "human" ? "You" : payload.byType === "phone" ? "You, from the phone," : "Someone";
+    const note = typeof payload.note === "string" && payload.note ? `: \u201C${payload.note.slice(0, 120)}\u201D` : "";
+    const words = payload.decision === "stop" ? `said stop to ${what}${note}` : payload.decision === "steer" ? `said continue ${what}, with a steer${note}` : `said continue ${what}`;
+    return { text: `${who} ${words}`, intent: payload.decision === "stop" ? "error" : "write", tool: null, mutating: false };
+  }
+  if (event.type === "criterion_decided") {
+    const text = typeof payload.text === "string" ? payload.text : "a criterion";
+    const approved = payload.decision === "approved";
+    const who = decidedBy(payload.actorType);
+    const from = payload.channel === "phone" ? ", from the phone" : "";
+    return { text: `${who} ${approved ? "approved" : "sent back"} \u201C${text.slice(0, 80)}\u201D${from}`, intent: approved ? "write" : "error", tool: null, mutating: true };
+  }
+  if (event.type === "check_run") {
+    const passed = Number(payload.passed) || 0;
+    const failed = Number(payload.failed) || 0;
+    const words = failed ? `${failed} failing, ${passed} passing` : `all ${passed} passing`;
+    return { text: `Checked criteria: ${words}`, intent: failed ? "error" : "read", tool: null, mutating: false };
+  }
+  const whoDid = decidedBy;
+  if (event.type === "signal_answered") {
+    const kind = typeof payload.kind === "string" ? payload.kind.replace(/-/g, " ") : "a";
+    const signal = `a ${kind} signal`;
+    const said = { acknowledged: `acknowledged ${signal}`, intended: `marked ${signal} intended`, dismissed: `dismissed ${signal}`, open: `reopened ${signal}` };
+    const from = payload.channel === "phone" ? ", from the phone" : "";
+    return { text: `${whoDid(payload.actorType)} ${said[String(payload.state)] ?? `answered ${signal}`}${from}`, intent: "write", tool: null, mutating: false };
+  }
+  if (event.type === "spec_decided") {
+    const said = { accept: "accepted", amend: "accepted", reject: "rejected" };
+    const section = typeof payload.section === "string" && payload.section ? ` to \u201C${payload.section.slice(0, 80)}\u201D` : "";
+    const amended = payload.decision === "amend" ? ", with changes" : "";
+    return { text: `${whoDid(payload.authorType)} ${said[String(payload.decision)] ?? "decided"} a proposed spec change${section}${amended}`, intent: payload.decision === "reject" ? "error" : "write", tool: null, mutating: true };
+  }
+  if (event.type === "retention_changed") {
+    const words = (v) => typeof v === "string" && v ? v : "another window";
+    const shorter = typeof payload.to === "number" && (payload.from === null || typeof payload.from === "number" && payload.to < payload.from);
+    return { text: `${whoDid(payload.authorType)} changed how long the record is kept, from ${words(payload.fromWords)} to ${words(payload.toWords)}`, intent: shorter ? "error" : "write", tool: null, mutating: true };
+  }
+  if (event.type === "rule_changed") {
+    const rule = typeof payload.from === "string" && typeof payload.mayNotImport === "string" ? ` \u201C${payload.from} may not import ${payload.mayNotImport}\u201D` : ` ${String(payload.ruleId ?? "")}`;
+    return { text: `${whoDid(payload.authorType)} ${payload.change === "stopped" ? "stopped" : "set"} the architecture rule${rule}`, intent: "write", tool: null, mutating: true };
+  }
+  const file = typeof payload.file === "string" ? payload.file.split("/").pop() : null;
+  switch (payload.action) {
+    case "read":
+      return { text: `Read ${file ?? "a file"}`, intent: "read", tool: null, mutating: false };
+    case "write":
+      return { text: `Wrote ${file ?? "a file"}`, intent: "write", tool: null, mutating: true };
+    case "edit":
+      return { text: `Edited ${file ?? "a file"}`, intent: "write", tool: null, mutating: true };
+    case "bash":
+      return {
+        text: `Ran \`${String(payload.command ?? "").slice(0, 60)}\``,
+        intent: "write",
+        tool: null,
+        mutating: true
+      };
+    default:
+      break;
+  }
+  if (typeof payload.tool === "string" && payload.pattern) {
+    return {
+      text: `${payload.tool === "Grep" ? "Searched for" : "Looked for files matching"} \`${String(payload.pattern)}\``,
+      intent: "read",
+      tool: null,
+      mutating: false
+    };
+  }
+  if (event.type === "session_start") return { text: "Session started", intent: "session", tool: null, mutating: false };
+  if (event.type === "session_end") return { text: "Session ended", intent: "session", tool: null, mutating: false };
+  const message = payload.message ?? payload.text;
+  if (typeof message === "string" && message.trim()) {
+    return { text: message.slice(0, 120), intent: "read", tool: null, mutating: false };
+  }
+  return { text: humaniseToolName(event.type), intent: "read", tool: null, mutating: false };
+}
+function rawPayloadText(event) {
+  try {
+    return JSON.stringify(event.payload, null, 2);
+  } catch {
+    return String(event.payload);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  phraseEvent,
+  rawPayloadText
+});

package/src/shared/lib/turn-gap.js

@@ -0,0 +1,27 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var turn_gap_exports = {};
+__export(turn_gap_exports, {
+  TURN_GAP_MS: () => TURN_GAP_MS
+});
+module.exports = __toCommonJS(turn_gap_exports);
+const TURN_GAP_MS = 3e4;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TURN_GAP_MS
+});

package/src/shared/lib/workstream-words.js

@@ -0,0 +1,38 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var workstream_words_exports = {};
+__export(workstream_words_exports, {
+  chipLabel: () => chipLabel,
+  sideLabel: () => sideLabel
+});
+module.exports = __toCommonJS(workstream_words_exports);
+function chipLabel(w) {
+  if (w.branch) return w.branch;
+  return w.head ? `detached ${w.head.slice(0, 7)}` : "detached";
+}
+function sideLabel(root, workstreams) {
+  const ws = workstreams.find((w) => w.root === root);
+  if (ws) return chipLabel(ws);
+  if (root.startsWith("branch:")) return root.slice("branch:".length);
+  return root.split(/[\\/]/).filter(Boolean).pop() ?? root;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  chipLabel,
+  sideLabel
+});

package/src/shared/lib/xlsx-xml.js

@@ -0,0 +1,144 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var xlsx_xml_exports = {};
+__export(xlsx_xml_exports, {
+  colLetters: () => colLetters,
+  colNumber: () => colNumber,
+  decodeXml: () => decodeXml,
+  parseDateStyles: () => parseDateStyles,
+  parseSharedStrings: () => parseSharedStrings,
+  parseSheetGrid: () => parseSheetGrid,
+  parseWorkbookSheets: () => parseWorkbookSheets,
+  serialToDate: () => serialToDate,
+  sheetDimension: () => sheetDimension
+});
+module.exports = __toCommonJS(xlsx_xml_exports);
+function decodeXml(s) {
+  return s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n))).replace(/&#x([0-9a-f]+);/gi, (_, n) => String.fromCodePoint(parseInt(n, 16))).replace(/&amp;/g, "&");
+}
+function parseWorkbookSheets(workbookXml, relsXml) {
+  const targets = /* @__PURE__ */ new Map();
+  for (const m of relsXml.matchAll(/<Relationship\b[^>]*>/g)) {
+    const id = m[0].match(/\bId="([^"]+)"/)?.[1];
+    const target = m[0].match(/\bTarget="([^"]+)"/)?.[1];
+    if (id && target) targets.set(id, target.replace(/^\/?(xl\/)?/, "xl/"));
+  }
+  const sheets = [];
+  for (const m of workbookXml.matchAll(/<sheet\b[^>]*>/g)) {
+    const name = m[0].match(/\bname="([^"]*)"/)?.[1];
+    if (name === void 0) continue;
+    const rid = m[0].match(/\br:id="([^"]+)"/)?.[1];
+    sheets.push({ name: decodeXml(name), part: rid && targets.get(rid) || null });
+  }
+  return sheets;
+}
+function sheetDimension(sheetXml) {
+  return sheetXml.match(/<dimension\b[^>]*\bref="([^"]+)"/)?.[1] ?? null;
+}
+function parseSharedStrings(xml) {
+  const out = [];
+  for (const si of xml.matchAll(/<si\b[^>]*>([\s\S]*?)<\/si>/g)) {
+    let text = "";
+    for (const t of si[1].matchAll(/<t\b[^>]*>([\s\S]*?)<\/t>/g)) text += t[1];
+    out.push(decodeXml(text));
+  }
+  return out;
+}
+function parseDateStyles(stylesXml) {
+  const custom = /* @__PURE__ */ new Map();
+  for (const m of stylesXml.matchAll(/<numFmt\b[^>]*>/g)) {
+    const id = Number(m[0].match(/\bnumFmtId="(\d+)"/)?.[1]);
+    const code = decodeXml(m[0].match(/\bformatCode="([^"]*)"/)?.[1] ?? "");
+    if (Number.isFinite(id)) custom.set(id, code);
+  }
+  const isDateFmt = (id) => id >= 14 && id <= 22 || id >= 45 && id <= 47 || custom.has(id) && /(^|[^"\\])[dy]/i.test(custom.get(id).replace(/"[^"]*"/g, ""));
+  const dates = /* @__PURE__ */ new Set();
+  const xfs = stylesXml.match(/<cellXfs\b[^>]*>([\s\S]*?)<\/cellXfs>/)?.[1] ?? "";
+  let i = 0;
+  for (const m of xfs.matchAll(/<xf\b[^>]*>/g)) {
+    if (isDateFmt(Number(m[0].match(/\bnumFmtId="(\d+)"/)?.[1] ?? -1))) dates.add(i);
+    i++;
+  }
+  return dates;
+}
+function colNumber(letters) {
+  let n = 0;
+  for (const ch of letters.toUpperCase()) n = n * 26 + (ch.charCodeAt(0) - 64);
+  return n;
+}
+function colLetters(n) {
+  let s = "";
+  for (let x = n; x > 0; x = Math.floor((x - 1) / 26)) s = String.fromCharCode(65 + (x - 1) % 26) + s;
+  return s;
+}
+function serialToDate(serial) {
+  const ms = Math.round((serial - 25569) * 86400 * 1e3);
+  const iso = new Date(ms).toISOString();
+  return serial % 1 === 0 ? iso.slice(0, 10) : iso.slice(0, 16).replace("T", " ");
+}
+function parseSheetGrid(sheetXml, shared, dateStyles, caps) {
+  const rows = [];
+  let truncated = false;
+  let cells = 0;
+  for (const c of sheetXml.matchAll(/<c\b([^>]*?)(?:\/>|>([\s\S]*?)<\/c>)/g)) {
+    const attrs = c[1];
+    const ref = attrs.match(/\br="([A-Z]{1,3})(\d+)"/);
+    if (!ref) continue;
+    const col = colNumber(ref[1]);
+    const row = Number(ref[2]);
+    if (row > caps.maxRows || col > caps.maxCols) {
+      truncated = true;
+      continue;
+    }
+    if (cells >= caps.maxCells) {
+      truncated = true;
+      break;
+    }
+    const inner = c[2] ?? "";
+    const type = attrs.match(/\bt="([^"]+)"/)?.[1] ?? "n";
+    const style = Number(attrs.match(/\bs="(\d+)"/)?.[1] ?? -1);
+    const v = inner.match(/<v>([\s\S]*?)<\/v>/)?.[1];
+    let text = "";
+    if (type === "s") text = v !== void 0 ? shared[Number(v)] ?? "" : "";
+    else if (type === "inlineStr") text = decodeXml([...inner.matchAll(/<t\b[^>]*>([\s\S]*?)<\/t>/g)].map((t) => t[1]).join(""));
+    else if (type === "b") text = v === "1" ? "TRUE" : v === "0" ? "FALSE" : "";
+    else if (v !== void 0) {
+      const raw = decodeXml(v);
+      const n = Number(raw);
+      text = type === "n" && dateStyles.has(style) && Number.isFinite(n) ? serialToDate(n) : raw;
+    }
+    while (rows.length < row) rows.push([]);
+    const r = rows[row - 1];
+    while (r.length < col - 1) r.push("");
+    r[col - 1] = text;
+    cells++;
+  }
+  return { rows, truncated, cells };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  colLetters,
+  colNumber,
+  decodeXml,
+  parseDateStyles,
+  parseSharedStrings,
+  parseSheetGrid,
+  parseWorkbookSheets,
+  serialToDate,
+  sheetDimension
+});

package/src/shared/lib/zip-reader.js

@@ -0,0 +1,99 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var zip_reader_exports = {};
+__export(zip_reader_exports, {
+  CapError: () => CapError,
+  listEntries: () => listEntries,
+  readEntry: () => readEntry,
+  readText: () => readText
+});
+module.exports = __toCommonJS(zip_reader_exports);
+class CapError extends Error {
+}
+function listEntries(view) {
+  const floor = Math.max(0, view.byteLength - 22 - 65535);
+  let eocd = -1;
+  for (let i = view.byteLength - 22; i >= floor; i--) {
+    if (view.getUint32(i, true) === 101010256) {
+      eocd = i;
+      break;
+    }
+  }
+  if (eocd < 0) throw new Error("not a zip archive");
+  const count = view.getUint16(eocd + 10, true);
+  let p = view.getUint32(eocd + 16, true);
+  const decoder = new TextDecoder();
+  const out = [];
+  for (let n = 0; n < count; n++) {
+    if (p + 46 > view.byteLength || view.getUint32(p, true) !== 33639248) throw new Error("corrupt central directory");
+    const nameLen = view.getUint16(p + 28, true);
+    out.push({
+      method: view.getUint16(p + 10, true),
+      compressedSize: view.getUint32(p + 20, true),
+      offset: view.getUint32(p + 42, true),
+      name: decoder.decode(new Uint8Array(view.buffer, view.byteOffset + p + 46, nameLen))
+    });
+    p += 46 + nameLen + view.getUint16(p + 30, true) + view.getUint16(p + 32, true);
+  }
+  return out;
+}
+async function readEntry(view, e, budget) {
+  if (view.getUint32(e.offset, true) !== 67324752) throw new Error("corrupt local header");
+  const start = e.offset + 30 + view.getUint16(e.offset + 26, true) + view.getUint16(e.offset + 28, true);
+  const raw = new Uint8Array(view.buffer, view.byteOffset + start, e.compressedSize);
+  if (e.method === 0) {
+    budget.used += raw.byteLength;
+    if (raw.byteLength > budget.maxPart || budget.used > budget.maxTotal) {
+      throw new CapError(`${e.name} is larger than CodeTrellis will read`);
+    }
+    return raw;
+  }
+  if (e.method !== 8) throw new Error(`${e.name} uses a compression CodeTrellis does not read`);
+  const reader = new Blob([raw]).stream().pipeThrough(new DecompressionStream("deflate-raw")).getReader();
+  const chunks = [];
+  let size = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    size += value.byteLength;
+    budget.used += value.byteLength;
+    if (size > budget.maxPart || budget.used > budget.maxTotal) {
+      await reader.cancel();
+      throw new CapError(`${e.name} expands past what CodeTrellis will read`);
+    }
+    chunks.push(value);
+  }
+  const bytes = new Uint8Array(size);
+  let at = 0;
+  for (const c of chunks) {
+    bytes.set(c, at);
+    at += c.byteLength;
+  }
+  return bytes;
+}
+async function readText(view, entries, name, budget) {
+  const e = entries.find((x) => x.name === name);
+  return e ? new TextDecoder().decode(await readEntry(view, e, budget)) : null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CapError,
+  listEntries,
+  readEntry,
+  readText
+});