@fairmint/captable-ai 0.1.5 → 0.1.7

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

@@ -602,11 +602,32 @@ var COMMAND_REGISTRY = [
   {
     name: "objects get",
     group: "captable",
-    description: "Get a single OCF object with document and extraction details.",
+    description: "Get a single OCF object with document, extraction details, and a vesting summary when present.",
     usage: "captable-ai objects get <object-id> [--json]",
     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: "9", version: "0.0.1", commands: COMMAND_REGISTRY });
 }
 
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
@@ -16043,6 +16064,405 @@ var exportResultSchema = external_exports.object({
   }).optional().describe("Present when pro-forma sheets were requested but engine refused.")
 });
 
+// ../captable-ai-core/dist/format-vesting-summary.js
+function asRecord(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return null;
+  const out = {};
+  for (const [key, val] of Object.entries(value)) {
+    out[key] = val;
+  }
+  return out;
+}
+function gcd(a, b) {
+  let x = Math.abs(Math.trunc(a));
+  let y = Math.abs(Math.trunc(b));
+  while (y !== 0) {
+    const t = y;
+    y = x % y;
+    x = t;
+  }
+  return x || 1;
+}
+function reduceFraction(numerator, denominator) {
+  const divisor = gcd(numerator, denominator);
+  return { numerator: numerator / divisor, denominator: denominator / divisor };
+}
+function asConditions(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.filter((item) => asRecord(item) !== null);
+}
+function portionFraction(condition) {
+  const portion = asRecord(condition.portion);
+  if (!portion)
+    return null;
+  const numerator = Number(portion.numerator);
+  const denominator = Number(portion.denominator);
+  if (!Number.isFinite(numerator) || !Number.isFinite(denominator) || denominator <= 0)
+    return null;
+  if (numerator <= 0)
+    return null;
+  return { numerator, denominator };
+}
+function formatPercent(numerator, denominator) {
+  const reduced = reduceFraction(numerator, denominator);
+  const pct = reduced.numerator / reduced.denominator * 100;
+  if (Number.isInteger(pct) && pct >= 1 && pct <= 100)
+    return `${pct}%`;
+  return `${reduced.numerator}/${reduced.denominator}`;
+}
+function periodLabel(period) {
+  if (!period)
+    return null;
+  let occurrences = 1;
+  if (period.occurrences != null && period.occurrences !== "") {
+    occurrences = Number(period.occurrences);
+    if (!Number.isInteger(occurrences) || occurrences <= 0)
+      return null;
+  }
+  let length = 1;
+  if (period.length != null && period.length !== "") {
+    const suppliedLength = Number(period.length);
+    if (!Number.isFinite(suppliedLength) || suppliedLength < 0)
+      return null;
+    length = suppliedLength;
+  }
+  if (length === 0)
+    return { cadence: "immediately", occurrences };
+  const unit = String(period.type ?? "").toUpperCase();
+  if (unit === "MONTHS") {
+    return { cadence: length === 1 ? "monthly" : `every ${length} months`, occurrences };
+  }
+  if (unit === "DAYS") {
+    return { cadence: length === 1 ? "daily" : `every ${length} days`, occurrences };
+  }
+  if (unit === "WEEKS") {
+    return { cadence: length === 1 ? "weekly" : `every ${length} weeks`, occurrences };
+  }
+  if (unit === "YEARS") {
+    return { cadence: length === 1 ? "yearly" : `every ${length} years`, occurrences };
+  }
+  return null;
+}
+function quantityLabel(condition) {
+  const raw = condition.quantity;
+  if (raw == null || raw === "")
+    return null;
+  const quantity = Number(raw);
+  if (!Number.isFinite(quantity) || quantity <= 0)
+    return null;
+  return quantity === 1 ? "1 share" : `${quantity} shares`;
+}
+function trancheAmount(condition) {
+  const fraction = portionFraction(condition);
+  if (fraction)
+    return formatPercent(fraction.numerator, fraction.denominator);
+  return quantityLabel(condition);
+}
+function formatVestingSummary(ocf) {
+  const record2 = asRecord(ocf);
+  const conditions = asConditions(record2?.vesting_conditions);
+  if (conditions.length === 0)
+    return null;
+  const parts = [];
+  for (const condition of conditions) {
+    const trigger = asRecord(condition.trigger);
+    const triggerType = String(trigger?.type ?? "").toUpperCase();
+    if (triggerType === "VESTING_EVENT") {
+      const portion = asRecord(condition.portion);
+      const remainder = portion?.remainder === true || portion?.remainder === "true";
+      const hasAllocation = Boolean(trancheAmount(condition) || remainder);
+      if (portion && !hasAllocation)
+        continue;
+      parts.push("event-based (see conditions)");
+      continue;
+    }
+    const amount = trancheAmount(condition);
+    if (!amount)
+      continue;
+    if (triggerType === "VESTING_START_DATE") {
+      parts.push(`${amount} at grant`);
+      continue;
+    }
+    if (triggerType === "VESTING_SCHEDULE_ABSOLUTE") {
+      const date5 = typeof trigger?.date === "string" && trigger.date.length > 0 ? trigger.date : null;
+      parts.push(date5 ? `${amount} on ${date5}` : `${amount} on a fixed date`);
+      continue;
+    }
+    if (triggerType === "VESTING_SCHEDULE_RELATIVE") {
+      const period = periodLabel(asRecord(trigger?.period));
+      if (!period)
+        continue;
+      if (period.cadence === "immediately" && period.occurrences === 1) {
+        parts.push(`${amount} immediately`);
+        continue;
+      }
+      const fraction = portionFraction(condition);
+      if (fraction) {
+        const reduced = reduceFraction(fraction.numerator, fraction.denominator);
+        parts.push(`${reduced.numerator}/${reduced.denominator} ${period.cadence} \xD7 ${period.occurrences}`);
+        continue;
+      }
+      parts.push(`${amount} ${period.cadence} \xD7 ${period.occurrences}`);
+    }
+  }
+  if (parts.length === 0)
+    return null;
+  return `Vesting: ${parts.join(", then ")}`;
+}
+function unresolvedVestingTermsId(ocf) {
+  const record2 = asRecord(ocf);
+  if (!record2)
+    return null;
+  if (Array.isArray(record2.vesting_conditions) && record2.vesting_conditions.length > 0) {
+    return null;
+  }
+  return typeof record2.vesting_terms_id === "string" && record2.vesting_terms_id.length > 0 ? record2.vesting_terms_id : null;
+}
+async function resolveVestingSummary(ocf, fetchTermsOcf) {
+  const direct = formatVestingSummary(ocf);
+  if (direct)
+    return direct;
+  const termsId = unresolvedVestingTermsId(ocf);
+  if (!termsId)
+    return null;
+  try {
+    return formatVestingSummary(await fetchTermsOcf(termsId));
+  } catch {
+    return null;
+  }
+}
+
+// ../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 +16623,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;
@@ -16219,12 +16639,19 @@ function coerceDetails(raw) {
   return details.length > 0 ? details : void 0;
 }
 var REQUEST_TIMEOUT_MS2 = 3e4;
-function exitForRefreshFailure(err) {
+function exitForRefreshFailure(err, softFail = false) {
   if (err instanceof Error && err.name === "AuthError") {
-    exitWithError("Session expired. Run: captable-ai login", "AUTH_EXPIRED", void 0, EXIT.AUTH);
+    failRequest(
+      softFail,
+      "Session expired. Run: captable-ai login",
+      "AUTH_EXPIRED",
+      void 0,
+      EXIT.AUTH
+    );
   }
   if (err instanceof Error && (err.name === "NetworkError" || isTransportError(err))) {
-    exitWithError(
+    failRequest(
+      softFail,
       "Network error while refreshing session. Check your connection and try again.",
       "REFRESH_TRANSPORT",
       void 0,
@@ -16232,7 +16659,8 @@ function exitForRefreshFailure(err) {
     );
   }
   const detail = err instanceof Error ? err.message : String(err);
-  exitWithError(
+  failRequest(
+    softFail,
     `Token refresh failed: ${detail}. Run: captable-ai login`,
     "REFRESH_FAILED",
     void 0,
@@ -16246,6 +16674,22 @@ function isTransportError(err) {
   if (!(err instanceof Error)) return false;
   return err.name === "TimeoutError" || err.name === "AbortError" || err.name === "TypeError" || /network|timeout|fetch|ECONNRESET|ENOTFOUND|ETIMEDOUT/i.test(err.message);
 }
+var ApiRequestError = class extends Error {
+  code;
+  details;
+  constructor(message, code, details) {
+    super(message);
+    this.name = "ApiRequestError";
+    if (code !== void 0) this.code = code;
+    if (details !== void 0) this.details = details;
+  }
+};
+function failRequest(softFail, message, code, details, exitCode) {
+  if (softFail) {
+    throw new ApiRequestError(message, code, details);
+  }
+  exitWithError(message, code, details, exitCode);
+}
 async function refreshTokens(creds) {
   const baseUrl = getApiUrl();
   let res;
@@ -16289,20 +16733,20 @@ async function refreshTokens(creds) {
   await writeCredentials(updated);
   return updated;
 }
-async function getAuthHeaders() {
+async function getAuthHeaders(softFail = false) {
   let creds = await readCredentials();
   if (!creds) return {};
   if (isTokenExpired(creds.accessToken)) {
     try {
       creds = await refreshTokens(creds);
     } catch (err) {
-      exitForRefreshFailure(err);
+      exitForRefreshFailure(err, softFail);
     }
   }
   return { Authorization: `Bearer ${creds.accessToken}` };
 }
 async function apiRequest(path, opts = {}) {
-  const { method = "GET", body, query, skipAuth = false } = opts;
+  const { method = "GET", body, query, skipAuth = false, softFail = false } = opts;
   const baseUrl = getApiUrl();
   const url2 = new URL(`${baseUrl}${path}`);
   if (query) {
@@ -16312,7 +16756,7 @@ async function apiRequest(path, opts = {}) {
   }
   const headers = { "Content-Type": "application/json" };
   if (!skipAuth) {
-    Object.assign(headers, await getAuthHeaders());
+    Object.assign(headers, await getAuthHeaders(softFail));
   }
   const buildFetchOpts = () => ({
     method,
@@ -16325,14 +16769,16 @@ async function apiRequest(path, opts = {}) {
     res = await fetch(url2.toString(), buildFetchOpts());
   } catch (err) {
     if (err instanceof DOMException && err.name === "TimeoutError") {
-      exitWithError(
+      failRequest(
+        softFail,
         "Request timed out. Check your network connection and try again.",
         "TIMEOUT",
         void 0,
         EXIT.NETWORK
       );
     }
-    exitWithError(
+    failRequest(
+      softFail,
       `Network error: ${err instanceof Error ? err.message : "connection failed"}`,
       "NETWORK",
       void 0,
@@ -16346,23 +16792,25 @@ async function apiRequest(path, opts = {}) {
       try {
         refreshed = await refreshTokens(creds);
       } catch (refreshErr) {
-        exitForRefreshFailure(refreshErr);
+        exitForRefreshFailure(refreshErr, softFail);
       }
       if (refreshed) {
         headers.Authorization = `Bearer ${refreshed.accessToken}`;
         try {
           const retryRes = await fetch(url2.toString(), buildFetchOpts());
-          return handleResponse(retryRes);
+          return handleResponse(retryRes, softFail);
         } catch (retryErr) {
           if (retryErr instanceof DOMException && retryErr.name === "TimeoutError") {
-            exitWithError(
+            failRequest(
+              softFail,
               "Request timed out. Check your network connection and try again.",
               "TIMEOUT",
               void 0,
               EXIT.NETWORK
             );
           }
-          exitWithError(
+          failRequest(
+            softFail,
             `Network error: ${retryErr instanceof Error ? retryErr.message : "connection failed"}`,
             "NETWORK",
             void 0,
@@ -16372,7 +16820,7 @@ async function apiRequest(path, opts = {}) {
       }
     }
   }
-  return handleResponse(res);
+  return handleResponse(res, softFail);
 }
 function exitCodeForStatus(status) {
   if (status === 400) return EXIT.VALIDATION;
@@ -16383,14 +16831,26 @@ function exitCodeForStatus(status) {
   if (status >= 500) return EXIT.SERVER_ERROR;
   return EXIT.SERVER_ERROR;
 }
-async function handleResponse(res) {
-  const text = await res.text();
+async function handleResponse(res, softFail = false) {
+  let text;
+  try {
+    text = await res.text();
+  } catch (err) {
+    failRequest(
+      softFail,
+      `Network error: ${err instanceof Error ? err.message : "connection failed"}`,
+      "NETWORK",
+      void 0,
+      EXIT.NETWORK
+    );
+  }
   let parsed;
   try {
     parsed = JSON.parse(text);
   } catch {
     if (!res.ok) {
-      exitWithError(
+      failRequest(
+        softFail,
         `HTTP ${res.status}: ${text.slice(0, 200)}`,
         `HTTP_${res.status}`,
         void 0,
@@ -16401,19 +16861,31 @@ 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);
+      failRequest(
+        softFail,
+        String(nested.message ?? `HTTP ${res.status}`),
+        code,
+        details,
+        exitCode
+      );
     }
     if (typeof nested === "string") {
       const code = typeof obj.code === "string" && obj.code.trim() ? obj.code : `HTTP_${res.status}`;
       const details = coerceDetails(obj.details);
-      exitWithError(nested, code, details, exitCode);
+      failRequest(softFail, nested, code, details, exitCode);
     }
-    exitWithError(`HTTP ${res.status}: ${text.slice(0, 200)}`, void 0, void 0, exitCode);
+    failRequest(
+      softFail,
+      `HTTP ${res.status}: ${text.slice(0, 200)}`,
+      void 0,
+      void 0,
+      exitCode
+    );
   }
   return parsed;
 }
@@ -16529,8 +17001,35 @@ Global:
   --json                   Machine-readable JSON output (API order, not confidence-sorted)`;
 var HELP_OBJECTS_GET = `objects get \u2014 Show one OCF object
 
+After the OCF payload, prints a one-line vesting summary when the object (or
+its vesting_terms_id target) has a condition graph. --json adds vestingSummary
+as a sibling of data \u2014 not inside ocf.
+
 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 +17118,8 @@ ${HELP_OBJECTS_LIST}
 
 ${HELP_OBJECTS_GET}
 
+${HELP_OBJECTS_DUMP}
+
 ${HELP_OBJECTS_UPDATE}
 
 ${HELP_OBJECTS_PATCH}
@@ -17713,11 +18214,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 +18769,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 +18990,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 +19011,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 +19055,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 +19420,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, `'\\''`)}'`;
@@ -18940,9 +19540,17 @@ async function runObjectsGet(args, rawArgv) {
   if (!obj) {
     exitWithError("Object not found", "OBJECT_NOT_FOUND", void 0, EXIT.NOT_FOUND);
   }
+  const vestingSummary = await resolveVestingSummary(obj.ocf, async (termsId) => {
+    const terms = await apiRequest(
+      `/${portalId}/objects/${encodeURIComponent(termsId)}`,
+      { softFail: true }
+    );
+    return terms.data?.ocf ?? null;
+  });
   if (isJsonMode()) {
     const out = { data: obj };
     if (res.meta !== void 0) out.meta = res.meta;
+    if (vestingSummary) out.vestingSummary = vestingSummary;
     printJson(out);
     return;
   }
@@ -18977,61 +19585,10 @@ Object: ${obj.id}
   }
   printLine("\nOCF data:\n");
   printJson(obj.ocf);
-  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 }
-  };
+  if (vestingSummary) printLine(`
+${vestingSummary}
+`);
+  else printLine();
 }
 
 // src/validate.ts
@@ -19103,7 +19660,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 +19699,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 +19911,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 +19926,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 +20146,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 +20161,7 @@ function parseOcfPayload(raw) {
       EXIT.VALIDATION
     );
   }
-  if (!isRecord7(parsed)) {
+  if (!isRecord8(parsed)) {
     exitWithError(
       "OCF payload must be a JSON object.",
       "VALIDATION_FAILED",
@@ -19973,20 +20530,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;
@@ -20670,7 +21227,8 @@ Cap Table (read):
                              Review: --stakeholder, --document, --max-confidence N (requires --all)
                              Pagination: --limit (1-250), --cursor, --all
                              Dates: --from / --to as YYYY-MM-DD
-  objects get <id>          Show a single OCF object
+  objects get <id>          Show a single OCF object (vesting summary when present)
+  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 +21515,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 +21535,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.7",
   "description": "Agent-native CLI for Captable AI — manage companies, upload documents, run OCF extraction, and commit cap tables from the terminal.",
   "keywords": [
     "captable",