@fairmint/captable-ai 0.1.5 → 0.1.6

package/README.md

@@ -88,7 +88,7 @@ automated, but a few habits make extraction faster and more accurate:
 | `documents upload\|list\|download\|delete` | Manage source documents |
 | `documents trigger-extraction\|cancel-extraction\|restart-extraction\|reprocess` | Control the OCF extraction pipeline |
 | `documents processing-status\|classification-types\|classification-update` | Inspect document status / classification |
-| `objects list\|get\|update\|patch\|revert\|versions\|delete` | Work with extracted OCF objects (`list` supports `--document`, `--stakeholder`, `--all`, `--max-confidence`) |
+| `objects list\|get\|dump\|update\|patch\|revert\|versions\|delete` | Work with extracted OCF objects (`list` supports `--document`, `--stakeholder`, `--all`, `--max-confidence`; `dump` writes engine-shaped `ocf.json`) |
 | `schemas list\|get` | Browse the OCF object-type registry |
 | `commit` | Commit drafts to the cap table — `--all` or `--objects id1,id2` (`--dry-run` to preview) |
 | `summary` | Full cap table snapshot |

package/dist/index.js

@@ -607,6 +607,27 @@ var COMMAND_REGISTRY = [
     requiresAuth: true,
     requiresPortal: true
   },
+  {
+    name: "objects dump",
+    group: "captable",
+    description: "Write engine-shaped ocf.json from object ocf payloads.",
+    usage: "captable-ai objects dump [--status committed|draft] [--output path]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "status",
+        description: "Filter by status: draft or committed. Default committed.",
+        type: "string",
+        enum: ["draft", "committed"]
+      },
+      {
+        name: "output",
+        description: "Write JSON to this file (global --output; implies --json).",
+        type: "string"
+      }
+    ]
+  },
   {
     name: "schemas list",
     group: "captable",
@@ -1147,7 +1168,7 @@ var COMMAND_REGISTRY = [
   }
 ];
 async function runCommands(_args) {
-  printJson({ schemaVersion: "7", version: "0.0.1", commands: COMMAND_REGISTRY });
+  printJson({ schemaVersion: "8", version: "0.0.1", commands: COMMAND_REGISTRY });
 }
 
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
@@ -16043,6 +16064,235 @@ var exportResultSchema = external_exports.object({
   }).optional().describe("Present when pro-forma sheets were requested but engine refused.")
 });
 
+// ../captable-ai-core/dist/objects-dump.js
+var DumpAssemblyError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DumpAssemblyError";
+  }
+};
+var ISSUANCE_TYPES = /* @__PURE__ */ new Set([
+  "TX_STOCK_ISSUANCE",
+  "TX_CONVERTIBLE_ISSUANCE",
+  "TX_WARRANT_ISSUANCE",
+  "TX_EQUITY_COMPENSATION_ISSUANCE",
+  "TX_PLAN_SECURITY_ISSUANCE"
+]);
+var CONVERSION_PARENT_TYPES = /* @__PURE__ */ new Set([
+  "TX_CONVERTIBLE_CONVERSION",
+  "TX_WARRANT_EXERCISE",
+  "TX_EQUITY_COMPENSATION_EXERCISE",
+  "TX_EQUITY_COMPENSATION_RELEASE",
+  "TX_PLAN_SECURITY_RELEASE",
+  "TX_STOCK_TRANSFER",
+  "TX_STOCK_CONVERSION",
+  "TX_CONVERTIBLE_TRANSFER",
+  "TX_WARRANT_TRANSFER",
+  "TX_EQUITY_COMPENSATION_TRANSFER",
+  "TX_PLAN_SECURITY_TRANSFER",
+  "TX_STOCK_REISSUANCE"
+]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function canonicalType(obj) {
+  const type = String(obj.type ?? "").toUpperCase();
+  if (type === "OBJECT")
+    return String(obj.subtype ?? "").toUpperCase();
+  return type;
+}
+function issuerForEngine(payload) {
+  if (payload.initial_shares_authorized == null && payload.authorized_shares != null) {
+    return { ...payload, initial_shares_authorized: payload.authorized_shares };
+  }
+  return payload;
+}
+function payloadId(payload, fallback) {
+  return typeof payload.id === "string" && payload.id.length > 0 ? payload.id : fallback;
+}
+function pushByOcfId(bucket, payload, fallback) {
+  bucket.set(payloadId(payload, fallback), payload);
+}
+function timestampMs(input, defaultValue) {
+  if (input == null)
+    return defaultValue;
+  const ms = typeof input === "number" ? input : new Date(String(input)).getTime();
+  return Number.isNaN(ms) ? defaultValue : ms;
+}
+function dumpTxWeight(tx, conversionResultSecurityIds) {
+  const objectType = String(tx.object_type ?? "");
+  if (conversionResultSecurityIds.size > 0 && ISSUANCE_TYPES.has(objectType) && typeof tx.security_id === "string" && conversionResultSecurityIds.has(tx.security_id)) {
+    return 36;
+  }
+  switch (objectType) {
+    case "TX_ISSUER_AUTHORIZED_SHARES_ADJUSTMENT":
+    case "TX_STOCK_CLASS_AUTHORIZED_SHARES_ADJUSTMENT":
+    case "TX_STOCK_PLAN_POOL_ADJUSTMENT":
+      return 5;
+    case "TX_STOCK_REISSUANCE":
+      return 9;
+    case "TX_STOCK_ISSUANCE":
+    case "TX_EQUITY_COMPENSATION_ISSUANCE":
+    case "TX_WARRANT_ISSUANCE":
+    case "TX_CONVERTIBLE_ISSUANCE":
+    case "TX_PLAN_SECURITY_ISSUANCE":
+      return 10;
+    case "TX_STOCK_ACCEPTANCE":
+    case "TX_WARRANT_ACCEPTANCE":
+    case "TX_EQUITY_COMPENSATION_ACCEPTANCE":
+    case "TX_PLAN_SECURITY_ACCEPTANCE":
+      return 11;
+    case "TX_VESTING_START":
+      return 12;
+    case "TX_VESTING_EVENT":
+      return 13;
+    case "TX_VESTING_ACCELERATION":
+      return 14;
+    case "TX_STOCK_CLASS_SPLIT":
+      return 15;
+    case "TX_STOCK_RETRACTION":
+    case "TX_CONVERTIBLE_RETRACTION":
+    case "TX_WARRANT_RETRACTION":
+    case "TX_EQUITY_COMPENSATION_RETRACTION":
+      return 16;
+    case "TX_STOCK_CONSOLIDATION":
+      return 17;
+    case "TX_STOCK_CLASS_CONVERSION_RATIO_ADJUSTMENT":
+      return 18;
+    case "TX_EQUITY_COMPENSATION_REPRICING":
+      return 19;
+    case "TX_STOCK_TRANSFER":
+    case "TX_WARRANT_TRANSFER":
+    case "TX_CONVERTIBLE_TRANSFER":
+    case "TX_EQUITY_COMPENSATION_TRANSFER":
+    case "TX_PLAN_SECURITY_TRANSFER":
+      return 20;
+    case "TX_CONVERTIBLE_ACCEPTANCE":
+      return 22;
+    case "TX_EQUITY_COMPENSATION_EXERCISE":
+    case "TX_WARRANT_EXERCISE":
+      return 30;
+    case "TX_CONVERTIBLE_CONVERSION":
+      return 35;
+    case "TX_STOCK_REPURCHASE":
+    case "TX_STOCK_CANCELLATION":
+    case "TX_EQUITY_COMPENSATION_CANCELLATION":
+    case "TX_WARRANT_CANCELLATION":
+    case "TX_CONVERTIBLE_CANCELLATION":
+    case "TX_EQUITY_COMPENSATION_RETURN_TO_POOL":
+      return 40;
+    default:
+      return 50;
+  }
+}
+function dumpTransactionSortKey(tx, issuanceDates, conversionResultSecurityIds) {
+  let day = new Date(timestampMs(tx.date, 0) ?? 0).toISOString().slice(0, 10);
+  const objectType = String(tx.object_type ?? "");
+  if (objectType === "TX_VESTING_START" && typeof tx.security_id === "string") {
+    const issuanceDate = issuanceDates.get(tx.security_id);
+    if (issuanceDate && String(tx.date) < issuanceDate) {
+      day = new Date(timestampMs(issuanceDate, 0) ?? 0).toISOString().slice(0, 10);
+    }
+  }
+  const weight = String(dumpTxWeight(tx, conversionResultSecurityIds)).padStart(3, "0");
+  const group = typeof tx.security_id === "string" && tx.security_id ? tx.security_id : "_no_security_";
+  const createdMs = timestampMs(tx.createdAt ?? tx.created_at, null);
+  const created = createdMs !== null ? new Date(createdMs).toISOString() : "9999-12-31T23:59:59.999Z";
+  const id = String(tx._id ?? tx.id ?? "");
+  return `${day}|${weight}|${group}|${created}|${id}`;
+}
+function sortDumpTransactions(transactions) {
+  const issuanceDates = /* @__PURE__ */ new Map();
+  const conversionResultSecurityIds = /* @__PURE__ */ new Set();
+  for (const tx of transactions) {
+    const objectType = String(tx.object_type ?? "");
+    if (ISSUANCE_TYPES.has(objectType) && typeof tx.security_id === "string" && typeof tx.date === "string") {
+      issuanceDates.set(tx.security_id, tx.date);
+    }
+    if (!CONVERSION_PARENT_TYPES.has(objectType))
+      continue;
+    if (Array.isArray(tx.resulting_security_ids)) {
+      for (const id of tx.resulting_security_ids) {
+        if (typeof id === "string" && id)
+          conversionResultSecurityIds.add(id);
+      }
+    }
+    if (typeof tx.balance_security_id === "string" && tx.balance_security_id) {
+      conversionResultSecurityIds.add(tx.balance_security_id);
+    }
+  }
+  return [...transactions].sort((a, b) => {
+    const ka = dumpTransactionSortKey(a, issuanceDates, conversionResultSecurityIds);
+    const kb = dumpTransactionSortKey(b, issuanceDates, conversionResultSecurityIds);
+    if (ka < kb)
+      return -1;
+    if (ka > kb)
+      return 1;
+    return 0;
+  });
+}
+function assembleEngineOcfDump(objects) {
+  const issuers = [];
+  const stockClasses = /* @__PURE__ */ new Map();
+  const stockPlans = /* @__PURE__ */ new Map();
+  const stakeholders = /* @__PURE__ */ new Map();
+  const transactions = /* @__PURE__ */ new Map();
+  const vestingTerms = /* @__PURE__ */ new Map();
+  let index = 0;
+  for (const obj of objects) {
+    if (!isRecord(obj))
+      continue;
+    const type = canonicalType(obj);
+    const payload = isRecord(obj.ocf) ? obj.ocf : null;
+    index += 1;
+    switch (type) {
+      case "ISSUER":
+        if (!payload) {
+          throw new DumpAssemblyError("ISSUER object is missing an ocf payload.");
+        }
+        issuers.push(issuerForEngine(payload));
+        break;
+      case "STOCK_CLASS":
+        if (payload)
+          pushByOcfId(stockClasses, payload, `anon-stock-class-${index}`);
+        break;
+      case "STOCK_PLAN":
+        if (payload)
+          pushByOcfId(stockPlans, payload, `anon-stock-plan-${index}`);
+        break;
+      case "STAKEHOLDER":
+        if (payload)
+          pushByOcfId(stakeholders, payload, `anon-stakeholder-${index}`);
+        break;
+      case "TRANSACTION":
+        if (payload)
+          pushByOcfId(transactions, payload, `anon-transaction-${index}`);
+        break;
+      case "VESTING_TERMS":
+        if (payload)
+          pushByOcfId(vestingTerms, payload, `anon-vesting-terms-${index}`);
+        break;
+      default:
+        break;
+    }
+  }
+  if (issuers.length === 0) {
+    throw new DumpAssemblyError("Dump requires exactly one ISSUER object; none found.");
+  }
+  if (issuers.length > 1) {
+    throw new DumpAssemblyError(`Dump requires exactly one ISSUER object; found ${issuers.length}.`);
+  }
+  return {
+    issuer: issuers[0],
+    stockClasses: [...stockClasses.values()],
+    stockPlans: [...stockPlans.values()],
+    stakeholders: [...stakeholders.values()],
+    transactions: sortDumpTransactions([...transactions.values()]),
+    vestingTerms: [...vestingTerms.values()],
+    sharePrices: []
+  };
+}
+
 // ../captable-ai-core/dist/scopes.js
 var CAPTABLE_AI_SCOPES = {
   READ: "read",
@@ -16203,14 +16453,14 @@ var summarySchema = external_exports.object({
 });
 
 // src/api.ts
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function coerceDetails(raw) {
   if (!Array.isArray(raw)) return void 0;
   const details = [];
   for (const entry of raw) {
-    if (!isRecord(entry)) continue;
+    if (!isRecord2(entry)) continue;
     const message = typeof entry.message === "string" ? entry.message : void 0;
     if (!message) continue;
     const path = typeof entry.path === "string" ? entry.path : void 0;
@@ -16401,9 +16651,9 @@ async function handleResponse(res) {
   }
   if (!res.ok) {
     const exitCode = exitCodeForStatus(res.status);
-    const obj = isRecord(parsed) ? parsed : {};
+    const obj = isRecord2(parsed) ? parsed : {};
     const nested = obj.error;
-    if (isRecord(nested)) {
+    if (isRecord2(nested)) {
       const code = typeof nested.code === "string" && nested.code.trim() ? nested.code : void 0;
       const details = coerceDetails(nested.details);
       exitWithError(String(nested.message ?? `HTTP ${res.status}`), code, details, exitCode);
@@ -16531,6 +16781,29 @@ var HELP_OBJECTS_GET = `objects get \u2014 Show one OCF object
 
 Usage:
   captable-ai objects get <object-id> [--json]`;
+var HELP_OBJECTS_DUMP = `objects dump \u2014 Engine-shaped ocf.json
+
+Assembles each row's ocf payload into the shape processCapTable consumes:
+  { issuer, stockClasses, stockPlans, stakeholders, transactions, vestingTerms, sharePrices }
+
+Fails if ISSUER is missing or duplicated. Not an OCF zip and not expected.json.
+Drains up to 400 pages (100,000 objects). Large tables: write a file with --output.
+
+The list API picks the latest row per object id, then optionally filters status.
+--status committed therefore omits an object when a newer draft exists.
+--status draft dumps that latest-row working set (drafts win) so the engine
+still sees the committed ISSUER and other unchanged baseline objects.
+
+Usage:
+  captable-ai objects dump [--status committed|draft] [--output path]
+
+Flags:
+  --status STATUS   committed = latest committed-only rows (default).
+                    draft = pending working set (latest row per object).
+  --output PATH     Write JSON to file (global flag; implies --json)
+
+Global:
+  --json            Machine-readable JSON (dump is always JSON)`;
 var HELP_OBJECTS_UPDATE = `objects update \u2014 Update an OCF object
 
 Usage:
@@ -16619,6 +16892,8 @@ ${HELP_OBJECTS_LIST}
 
 ${HELP_OBJECTS_GET}
 
+${HELP_OBJECTS_DUMP}
+
 ${HELP_OBJECTS_UPDATE}
 
 ${HELP_OBJECTS_PATCH}
@@ -17713,11 +17988,11 @@ var JOBS_FILE = join2(CONFIG_DIR2, "jobs.jsonl");
 var LOCK_DIR = join2(CONFIG_DIR2, "jobs.lock");
 var VALID_JOB_STATUSES = /* @__PURE__ */ new Set(["submitted", "running", "complete", "failed"]);
 var VALID_JOB_KINDS = /* @__PURE__ */ new Set(["extraction"]);
-function isRecord2(v) {
+function isRecord3(v) {
   return typeof v === "object" && v !== null;
 }
 function isJobEntry(value) {
-  if (!isRecord2(value)) return false;
+  if (!isRecord3(value)) return false;
   return typeof value.id === "string" && typeof value.kind === "string" && VALID_JOB_KINDS.has(value.kind) && typeof value.portalId === "string" && typeof value.submittedAt === "string" && typeof value.status === "string" && VALID_JOB_STATUSES.has(value.status);
 }
 async function ensureDir() {
@@ -18268,11 +18543,11 @@ async function readEntries() {
   }
   return entries;
 }
-function isRecord3(v) {
+function isRecord4(v) {
   return typeof v === "object" && v !== null;
 }
 function isFeedbackEntry(value) {
-  if (!isRecord3(value)) return false;
+  if (!isRecord4(value)) return false;
   return typeof value.ts === "string" && typeof value.text === "string" && typeof value.sent === "boolean";
 }
 
@@ -18489,7 +18764,7 @@ function successHtml() {
 h1{font-size:1.5rem;color:#111}p{color:#666}</style></head>
 <body><div class="card"><h1>Login successful</h1><p>You can close this window and return to the terminal.</p></div></body></html>`;
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readStr(obj, ...keys) {
@@ -18510,7 +18785,7 @@ function parsePortalsFromExchange(raw) {
   }
   if (!Array.isArray(parsed)) return [];
   return parsed.flatMap((p) => {
-    if (!isRecord4(p)) return [];
+    if (!isRecord5(p)) return [];
     if (typeof p.id !== "string" || p.id.length === 0) return [];
     return [
       {
@@ -18554,7 +18829,7 @@ function tryParseLoginPaste(line, expectedState) {
   } catch {
     return null;
   }
-  if (!isRecord4(obj)) return null;
+  if (!isRecord5(obj)) return null;
   if (typeof obj.state !== "string" || !pastedStateMatches(expectedState, obj.state)) return null;
   const accessToken = readStr(obj, "access_token", "accessToken");
   const refreshToken = readStr(obj, "refresh_token", "refreshToken");
@@ -18919,6 +19194,105 @@ async function runObjectsDelete(args, rawArgv) {
   );
 }
 
+// src/objects-pages.ts
+var OBJECTS_LIST_MAX_PAGES = 100;
+var OBJECTS_DUMP_MAX_PAGES = 400;
+async function fetchAllObjectPages(portalId, query, options) {
+  const maxPages = options?.maxPages ?? OBJECTS_LIST_MAX_PAGES;
+  const objects = [];
+  const documentsById = /* @__PURE__ */ new Map();
+  let cursor = typeof query.cursor === "string" ? query.cursor : void 0;
+  let total = 0;
+  let pages = 0;
+  while (true) {
+    pages += 1;
+    if (pages > maxPages) {
+      exitWithError(
+        `Exceeded max object-list pages (${maxPages}). Narrow the query or raise the page size.`,
+        "ERROR",
+        void 0,
+        EXIT.SERVER_ERROR
+      );
+    }
+    const pageQuery = { ...query };
+    if (cursor !== void 0) pageQuery.cursor = cursor;
+    else delete pageQuery.cursor;
+    const res = await apiRequest(`/${portalId}/objects`, { query: pageQuery });
+    const pageObjects = res.data?.objects ?? [];
+    const pageDocs = res.data?.documents ?? [];
+    objects.push(...pageObjects);
+    for (const doc of pageDocs) {
+      documentsById.set(doc.id, doc);
+    }
+    if (res.meta?.total != null) total = res.meta.total;
+    if (!res.meta?.hasMore) break;
+    if (!res.meta.cursor) {
+      exitWithError(
+        "Pagination response has more results but no continuation cursor.",
+        "ERROR",
+        void 0,
+        EXIT.SERVER_ERROR
+      );
+    }
+    if (cursor !== void 0 && res.meta.cursor === cursor) {
+      exitWithError(
+        "Pagination cursor did not advance; stopped draining object pages.",
+        "ERROR",
+        void 0,
+        EXIT.SERVER_ERROR
+      );
+    }
+    cursor = res.meta.cursor;
+  }
+  return {
+    data: { objects, documents: Array.from(documentsById.values()) },
+    meta: { cursor: null, total: total || objects.length, hasMore: false }
+  };
+}
+
+// src/commands/objects-dump.ts
+var DUMP_PAGE_LIMIT = 250;
+function dumpStatus(raw) {
+  const status = raw ?? "committed";
+  if (status === "committed" || status === "draft") return status;
+  exitWithError(
+    `--status must be one of: draft, committed (got: "${status}")`,
+    "VALIDATION_FAILED",
+    void 0,
+    EXIT.VALIDATION
+  );
+}
+async function runObjectsDump(args, rawArgv) {
+  if (argvRequestsHelp(rawArgv)) {
+    process.stdout.write(`${HELP_OBJECTS_DUMP}
+`);
+    process.exit(0);
+  }
+  validateFlags(args, { flags: ["status"], booleans: [] });
+  if (args.positional.length > 0) {
+    exitWithError(
+      `Unexpected argument: ${args.positional[0]}. objects dump takes flags only.`,
+      "USAGE",
+      void 0,
+      EXIT.USAGE
+    );
+  }
+  const status = dumpStatus(getFlagValue(args, "status"));
+  const portalId = await getActivePortalId();
+  const query = { limit: DUMP_PAGE_LIMIT };
+  if (status === "committed") query.status = "committed";
+  const page = await fetchAllObjectPages(portalId, query, { maxPages: OBJECTS_DUMP_MAX_PAGES });
+  try {
+    const objects = Array.isArray(page.data?.objects) ? page.data.objects : [];
+    printJson(assembleEngineOcfDump(objects));
+  } catch (err) {
+    if (err instanceof DumpAssemblyError) {
+      exitWithError(err.message, "VALIDATION_FAILED", void 0, EXIT.VALIDATION);
+    }
+    throw err;
+  }
+}
+
 // src/commands/objects-get.ts
 function shellQuote2(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
@@ -18980,60 +19354,6 @@ Object: ${obj.id}
   printLine();
 }
 
-// src/objects-pages.ts
-var OBJECTS_LIST_MAX_PAGES = 100;
-async function fetchAllObjectPages(portalId, query) {
-  const objects = [];
-  const documentsById = /* @__PURE__ */ new Map();
-  let cursor = typeof query.cursor === "string" ? query.cursor : void 0;
-  let total = 0;
-  let pages = 0;
-  while (true) {
-    pages += 1;
-    if (pages > OBJECTS_LIST_MAX_PAGES) {
-      exitWithError(
-        `Exceeded max object-list pages (${OBJECTS_LIST_MAX_PAGES}). Narrow the query or raise the page size.`,
-        "ERROR",
-        void 0,
-        EXIT.SERVER_ERROR
-      );
-    }
-    const pageQuery = { ...query };
-    if (cursor !== void 0) pageQuery.cursor = cursor;
-    else delete pageQuery.cursor;
-    const res = await apiRequest(`/${portalId}/objects`, { query: pageQuery });
-    const pageObjects = res.data?.objects ?? [];
-    const pageDocs = res.data?.documents ?? [];
-    objects.push(...pageObjects);
-    for (const doc of pageDocs) {
-      documentsById.set(doc.id, doc);
-    }
-    if (res.meta?.total != null) total = res.meta.total;
-    if (!res.meta?.hasMore) break;
-    if (!res.meta.cursor) {
-      exitWithError(
-        "Pagination response has more results but no continuation cursor.",
-        "ERROR",
-        void 0,
-        EXIT.SERVER_ERROR
-      );
-    }
-    if (cursor !== void 0 && res.meta.cursor === cursor) {
-      exitWithError(
-        "Pagination cursor did not advance; stopped draining object pages.",
-        "ERROR",
-        void 0,
-        EXIT.SERVER_ERROR
-      );
-    }
-    cursor = res.meta.cursor;
-  }
-  return {
-    data: { objects, documents: Array.from(documentsById.values()) },
-    meta: { cursor: null, total: total || objects.length, hasMore: false }
-  };
-}
-
 // src/validate.ts
 var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
 function isValidCalendarIsoDate(s) {
@@ -19103,7 +19423,7 @@ function validateIsoDateRange(fromRaw, toRaw) {
 // src/commands/objects-list.ts
 var CONFIDENCE_RED_MAX = 64;
 var CONFIDENCE_AMBER_MAX = 84;
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function getValidatedMaxConfidence(raw) {
@@ -19142,7 +19462,7 @@ function stakeholderDisplayName(ocf) {
   if (!ocf) return null;
   if (typeof ocf.name === "string" && ocf.name.trim()) return ocf.name.trim();
   if (typeof ocf.legal_name === "string" && ocf.legal_name.trim()) return ocf.legal_name.trim();
-  if (isRecord5(ocf.name)) {
+  if (isRecord6(ocf.name)) {
     const legal = ocf.name.legal_name;
     if (typeof legal === "string" && legal.trim()) return legal.trim();
     const parts = [ocf.name.first_name, ocf.name.last_name].filter(
@@ -19354,7 +19674,7 @@ async function readStdin() {
   }
   return Buffer.concat(chunks).toString("utf-8");
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parsePatchPayload(raw) {
@@ -19369,7 +19689,7 @@ function parsePatchPayload(raw) {
       EXIT.VALIDATION
     );
   }
-  if (!isRecord6(parsed)) {
+  if (!isRecord7(parsed)) {
     exitWithError(
       "OCF patch payload must be a JSON object.",
       "VALIDATION_FAILED",
@@ -19589,7 +19909,7 @@ async function readStdin2() {
   }
   return Buffer.concat(chunks).toString("utf-8");
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseOcfPayload(raw) {
@@ -19604,7 +19924,7 @@ function parseOcfPayload(raw) {
       EXIT.VALIDATION
     );
   }
-  if (!isRecord7(parsed)) {
+  if (!isRecord8(parsed)) {
     exitWithError(
       "OCF payload must be a JSON object.",
       "VALIDATION_FAILED",
@@ -19973,20 +20293,20 @@ import { homedir as homedir4 } from "os";
 import { join as join4 } from "path";
 var CONFIG_DIR4 = join4(homedir4(), ".captable-ai");
 var PROFILES_FILE = join4(CONFIG_DIR4, "profiles.json");
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isErrno3(err, code) {
-  return isRecord8(err) && err.code === code;
+  return isRecord9(err) && err.code === code;
 }
 function parseProfiles(raw) {
   const parsed = JSON.parse(raw);
-  if (!isRecord8(parsed) || !isRecord8(parsed.profiles)) {
+  if (!isRecord9(parsed) || !isRecord9(parsed.profiles)) {
     throw new Error("profiles.json must contain a profiles object.");
   }
   const profiles = {};
   for (const [name, value] of Object.entries(parsed.profiles)) {
-    if (!isRecord8(value) || typeof value.company !== "string" || !value.company.trim()) {
+    if (!isRecord9(value) || typeof value.company !== "string" || !value.company.trim()) {
       throw new Error(`Profile "${name}" must include a non-empty company string.`);
     }
     const stage = typeof value.stage === "string" && value.stage.trim() ? value.stage : void 0;
@@ -20671,6 +20991,7 @@ Cap Table (read):
                              Pagination: --limit (1-250), --cursor, --all
                              Dates: --from / --to as YYYY-MM-DD
   objects get <id>          Show a single OCF object
+  objects dump              Engine-shaped ocf.json (default --status committed; --output path)
   schemas list              List OCF object types
   schemas get <type>        Show schema for an OCF type
 
@@ -20957,6 +21278,9 @@ async function main() {
           case "get":
             await runObjectsGet(parseArgs(positionalArgs.slice(2)), positionalArgs.slice(2));
             break;
+          case "dump":
+            await runObjectsDump(parseArgs(positionalArgs.slice(2)), positionalArgs.slice(2));
+            break;
           case "update":
             await runObjectsUpdate(parseArgs(positionalArgs.slice(2)), positionalArgs.slice(2));
             break;
@@ -20974,7 +21298,7 @@ async function main() {
             break;
           default:
             exitWithError(
-              `Unknown objects command: ${sub ?? "(none)"}. Try: objects list | get | update | patch | revert | versions | delete`,
+              `Unknown objects command: ${sub ?? "(none)"}. Try: objects list | get | dump | update | patch | revert | versions | delete`,
               "UNKNOWN_COMMAND",
               void 0,
               EXIT.USAGE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/captable-ai",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Agent-native CLI for Captable AI — manage companies, upload documents, run OCF extraction, and commit cap tables from the terminal.",
   "keywords": [
     "captable",