@fairmint/captable-ai 0.1.4 → 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 |
+| `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

@@ -543,7 +543,7 @@ var COMMAND_REGISTRY = [
     name: "objects list",
     group: "captable",
     description: "List OCF objects with filtering and pagination.",
-    usage: "captable-ai objects list [--type TYPE] [--subtype SUBTYPE] [--status STATUS] [--limit N] [--cursor C] [--q QUERY] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--ids IDS] [--json]",
+    usage: "captable-ai objects list [--type TYPE] [--subtype SUBTYPE] [--status STATUS] [--limit N] [--cursor C] [--q QUERY] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--ids IDS] [--stakeholder ID] [--document ID] [--all] [--max-confidence N] [--json]",
     requiresAuth: true,
     requiresPortal: true,
     flags: [
@@ -576,7 +576,27 @@ var COMMAND_REGISTRY = [
         description: "Filter objects with date <= (YYYY-MM-DD, inclusive).",
         type: "string"
       },
-      { name: "ids", description: "Batch fetch by comma-separated IDs.", type: "string" }
+      { name: "ids", description: "Batch fetch by comma-separated IDs.", type: "string" },
+      {
+        name: "stakeholder",
+        description: "Filter by OCF stakeholder id.",
+        type: "string"
+      },
+      {
+        name: "document",
+        description: "Filter by source document s3 asset id.",
+        type: "string"
+      },
+      {
+        name: "all",
+        description: "Follow pagination cursors until every matching object is returned.",
+        type: "boolean"
+      },
+      {
+        name: "max-confidence",
+        description: "Keep objects with extraction confidence <= N. Requires --all.",
+        type: "number"
+      }
     ]
   },
   {
@@ -587,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",
@@ -1127,7 +1168,7 @@ var COMMAND_REGISTRY = [
   }
 ];
 async function runCommands(_args) {
-  printJson({ schemaVersion: "6", 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
@@ -16023,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",
@@ -16183,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;
@@ -16381,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);
@@ -16486,24 +16756,54 @@ Usage:
   captable-ai objects list [options]
 
 Filters:
-  --type TYPE       Top-level OCF types (comma-separated)
-  --subtype STYPE   TRANSACTION subtypes (comma-separated)
-  --status STATUS   draft | committed
-  --q QUERY         Full-text search
-  --from DATE       YYYY-MM-DD (inclusive lower bound on object date)
-  --to DATE         YYYY-MM-DD (inclusive upper bound on object date)
-  --ids ID,ID,...   Batch fetch by object IDs
+  --type TYPE              Top-level OCF types (comma-separated)
+  --subtype STYPE          TRANSACTION subtypes (comma-separated)
+  --status STATUS          draft | committed
+  --q QUERY                Full-text search
+  --from DATE              YYYY-MM-DD (inclusive lower bound on object date)
+  --to DATE                YYYY-MM-DD (inclusive upper bound on object date)
+  --ids ID,ID,...          Batch fetch by object IDs
+  --stakeholder ID         Filter by OCF stakeholder id
+  --document S3_ASSET_ID   Filter by source document
+  --max-confidence N       Keep objects with confidence <= N (requires --all)
 
 Pagination:
-  --limit N         Page size (1\u2013250; omit for server default, typically 100)
-  --cursor C        Opaque continuation cursor from prior response
+  --limit N                Page size (1\u2013250; omit for server default, typically 100)
+  --cursor C               Opaque continuation cursor from prior response
+  --all                    Follow cursors until every matching object is returned
+
+Human table sorts lowest extraction confidence first. Conf markers:
+  !N  red (<65)    ~N  amber (65\u201384)    N  green (\u226585)
 
 Global:
-  --json            Machine-readable JSON output`;
+  --json                   Machine-readable JSON output (API order, not confidence-sorted)`;
 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:
@@ -16592,6 +16892,8 @@ ${HELP_OBJECTS_LIST}
 
 ${HELP_OBJECTS_GET}
 
+${HELP_OBJECTS_DUMP}
+
 ${HELP_OBJECTS_UPDATE}
 
 ${HELP_OBJECTS_PATCH}
@@ -17686,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() {
@@ -18241,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";
 }
 
@@ -18462,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) {
@@ -18483,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 [
       {
@@ -18527,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");
@@ -18892,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, `'\\''`)}'`;
@@ -19020,6 +19421,106 @@ function validateIsoDateRange(fromRaw, toRaw) {
 }
 
 // src/commands/objects-list.ts
+var CONFIDENCE_RED_MAX = 64;
+var CONFIDENCE_AMBER_MAX = 84;
+function isRecord6(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getValidatedMaxConfidence(raw) {
+  if (raw === void 0) return void 0;
+  const trimmed = raw.trim();
+  if (!/^\d+$/.test(trimmed)) {
+    exitWithError(
+      "--max-confidence must be an integer between 0 and 100",
+      "VALIDATION_FAILED",
+      void 0,
+      EXIT.VALIDATION
+    );
+  }
+  const n = Number.parseInt(trimmed, 10);
+  if (n < 0 || n > 100) {
+    exitWithError(
+      "--max-confidence must be an integer between 0 and 100",
+      "VALIDATION_FAILED",
+      void 0,
+      EXIT.VALIDATION
+    );
+  }
+  return n;
+}
+function objectConfidence(obj) {
+  const n = obj.extraction?.confidence;
+  return typeof n === "number" && Number.isFinite(n) ? n : void 0;
+}
+function formatConfidence(confidence) {
+  if (confidence === void 0) return "\u2014";
+  if (confidence <= CONFIDENCE_RED_MAX) return `!${confidence}`;
+  if (confidence <= CONFIDENCE_AMBER_MAX) return `~${confidence}`;
+  return String(confidence);
+}
+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 (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(
+      (p) => typeof p === "string" && p.trim().length > 0
+    );
+    if (parts.length > 0) return parts.join(" ");
+  }
+  return null;
+}
+function stakeholderNamesById(objects) {
+  const names = /* @__PURE__ */ new Map();
+  for (const obj of objects) {
+    if (obj.type !== "STAKEHOLDER") continue;
+    const name = stakeholderDisplayName(obj.ocf);
+    if (name) names.set(obj.id, name);
+  }
+  return names;
+}
+function compareConfidenceAsc(a, b) {
+  const ca = objectConfidence(a);
+  const cb = objectConfidence(b);
+  if (ca === void 0 && cb === void 0) return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+  if (ca === void 0) return 1;
+  if (cb === void 0) return -1;
+  if (ca !== cb) return ca - cb;
+  return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+}
+function shellQuote3(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function nextPageHint(query, cursor) {
+  const parts = ["captable-ai objects list"];
+  const flagNames = [
+    { queryKey: "type", flag: "type" },
+    { queryKey: "subtype", flag: "subtype" },
+    { queryKey: "status", flag: "status" },
+    { queryKey: "q", flag: "q" },
+    { queryKey: "from", flag: "from" },
+    { queryKey: "to", flag: "to" },
+    { queryKey: "ids", flag: "ids" },
+    { queryKey: "stakeholderId", flag: "stakeholder" },
+    { queryKey: "documentId", flag: "document" },
+    { queryKey: "limit", flag: "limit" }
+  ];
+  for (const { queryKey, flag } of flagNames) {
+    const value = query[queryKey];
+    if (value !== void 0) parts.push(`--${flag} ${shellQuote3(String(value))}`);
+  }
+  parts.push(`--cursor ${shellQuote3(cursor)}`);
+  return parts.join(" ");
+}
+function documentsReferencedBy(documents, objects) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const obj of objects) {
+    if (typeof obj.documentId === "string" && obj.documentId.length > 0) ids.add(obj.documentId);
+  }
+  return documents.filter((doc) => ids.has(doc.id));
+}
 async function runObjectsList(args, rawArgv) {
   if (argvRequestsHelp(rawArgv)) {
     process.stdout.write(`${HELP_OBJECTS_LIST}
@@ -19027,14 +19528,45 @@ async function runObjectsList(args, rawArgv) {
     process.exit(0);
   }
   validateFlags(args, {
-    flags: ["type", "subtype", "status", "limit", "cursor", "q", "from", "to", "ids"],
-    booleans: []
+    flags: [
+      "type",
+      "subtype",
+      "status",
+      "limit",
+      "cursor",
+      "q",
+      "from",
+      "to",
+      "ids",
+      "stakeholder",
+      "document",
+      "max-confidence"
+    ],
+    booleans: ["all"]
   });
+  if (args.positional.length > 0) {
+    exitWithError(
+      `Unexpected argument: ${args.positional[0]}. This command takes no positional arguments.`,
+      "UNEXPECTED_ARGUMENT",
+      void 0,
+      EXIT.USAGE
+    );
+  }
   const portalId = await getActivePortalId();
   const from = getFlagValue(args, "from");
   const to = getFlagValue(args, "to");
   validateIsoDateRange(from, to);
   const limit = getValidatedLimit(getFlagValue(args, "limit"));
+  const drainAll = hasFlag(args, "all");
+  const maxConfidence = getValidatedMaxConfidence(getFlagValue(args, "max-confidence"));
+  if (maxConfidence !== void 0 && !drainAll) {
+    exitWithError(
+      "--max-confidence requires --all so the review queue is not a single page.",
+      "VALIDATION_FAILED",
+      void 0,
+      EXIT.VALIDATION
+    );
+  }
   const type = getFlagValue(args, "type");
   const subtype = getFlagValue(args, "subtype");
   const status = getFlagValue(args, "status");
@@ -19049,6 +19581,8 @@ async function runObjectsList(args, rawArgv) {
   const q = getFlagValue(args, "q");
   const cursor = getFlagValue(args, "cursor");
   const ids = getFlagValue(args, "ids");
+  const stakeholderId = getFlagValue(args, "stakeholder");
+  const documentId = getFlagValue(args, "document");
   const query = {
     type,
     subtype,
@@ -19058,51 +19592,75 @@ async function runObjectsList(args, rawArgv) {
     cursor,
     from,
     to,
-    ids
+    ids,
+    stakeholderId,
+    documentId
   };
-  const res = await apiRequest(`/${portalId}/objects`, { query });
+  let page;
+  if (drainAll) {
+    page = await fetchAllObjectPages(portalId, query);
+  } else {
+    const res = await apiRequest(`/${portalId}/objects`, { query });
+    page = {
+      data: { objects: res.data?.objects ?? [], documents: res.data?.documents ?? [] },
+      meta: res.meta ?? {}
+    };
+  }
+  let objects = page.data.objects;
+  let documents = page.data.documents;
+  if (maxConfidence !== void 0) {
+    objects = objects.filter((obj) => {
+      const confidence = objectConfidence(obj);
+      return confidence !== void 0 && confidence <= maxConfidence;
+    });
+    documents = documentsReferencedBy(documents, objects);
+  }
   if (isJsonMode()) {
-    const out = { data: res.data };
-    if (res.meta !== void 0) out.meta = res.meta;
+    const out = {
+      data: { objects, documents }
+    };
+    if (page.meta !== void 0) {
+      out.meta = maxConfidence !== void 0 ? { ...page.meta, total: objects.length, hasMore: false, cursor: null } : page.meta;
+    }
     printJson(out);
     return;
   }
-  const objects = res.data?.objects ?? [];
-  const meta3 = res.meta;
+  const documentsById = new Map(documents.map((d) => [d.id, d.name]));
+  const namesByStakeholderId = stakeholderNamesById(page.data.objects);
+  const sorted = [...objects].sort(compareConfidenceAsc);
+  const meta3 = page.meta;
+  const totalLabel = maxConfidence !== void 0 ? ` (${objects.length} matching)` : meta3?.total != null && objects.length !== meta3.total ? ` (${objects.length} shown, ${meta3.total} total)` : meta3?.total != null ? ` (${meta3.total} total)` : "";
   printLine(`
-Objects${meta3?.total != null ? ` (${meta3.total} total)` : ""}:
+Objects${totalLabel}:
 `);
   printTable(
-    objects.map((o) => ({
-      id: o.id,
-      type: o.subtype ?? o.type,
-      status: o.status,
-      date: o.date ?? "",
-      version: o.version
-    })),
+    sorted.map((o) => {
+      const stakeholderIdValue = o.type === "STAKEHOLDER" ? o.id : o.stakeholderId ?? "";
+      const stakeholderName = stakeholderIdValue ? namesByStakeholderId.get(stakeholderIdValue) ?? stakeholderIdValue : "";
+      return {
+        id: o.id,
+        type: o.subtype ?? o.type,
+        status: o.status,
+        conf: formatConfidence(objectConfidence(o)),
+        document: o.documentId ? documentsById.get(o.documentId) ?? o.documentId : "",
+        stakeholder: stakeholderName,
+        date: o.date ?? ""
+      };
+    }),
     [
       { key: "id", label: "ID", width: 38 },
-      { key: "type", label: "Type", width: 30 },
+      { key: "type", label: "Type", width: 28 },
       { key: "status", label: "Status", width: 10 },
-      { key: "date", label: "Date", width: 12 },
-      { key: "version", label: "Version", width: 8 }
+      { key: "conf", label: "Conf", width: 6 },
+      { key: "document", label: "Document", width: 24 },
+      { key: "stakeholder", label: "Stakeholder", width: 22 },
+      { key: "date", label: "Date", width: 12 }
     ]
   );
-  if (meta3?.hasMore && meta3.cursor) {
-    const shQ = (v) => `'${v.replace(/'/g, `'\\''`)}'`;
-    const parts = ["captable-ai objects list"];
-    if (type !== void 0) parts.push(`--type ${shQ(type)}`);
-    if (subtype !== void 0) parts.push(`--subtype ${shQ(subtype)}`);
-    if (status !== void 0) parts.push(`--status ${shQ(status)}`);
-    if (q !== void 0) parts.push(`--q ${shQ(q)}`);
-    if (from !== void 0) parts.push(`--from ${shQ(from)}`);
-    if (to !== void 0) parts.push(`--to ${shQ(to)}`);
-    if (ids !== void 0) parts.push(`--ids ${shQ(ids)}`);
-    if (limit !== void 0) parts.push(`--limit ${shQ(String(limit))}`);
-    parts.push(`--cursor ${shQ(meta3.cursor)}`);
+  if (!drainAll && meta3?.hasMore && meta3.cursor) {
     printLine(`
 More results available. Next page:
-  ${parts.join(" ")}`);
+  ${nextPageHint(query, meta3.cursor)}`);
   }
   printLine();
 }
@@ -19116,7 +19674,7 @@ async function readStdin() {
   }
   return Buffer.concat(chunks).toString("utf-8");
 }
-function isRecord5(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parsePatchPayload(raw) {
@@ -19131,7 +19689,7 @@ function parsePatchPayload(raw) {
       EXIT.VALIDATION
     );
   }
-  if (!isRecord5(parsed)) {
+  if (!isRecord7(parsed)) {
     exitWithError(
       "OCF patch payload must be a JSON object.",
       "VALIDATION_FAILED",
@@ -19351,7 +19909,7 @@ async function readStdin2() {
   }
   return Buffer.concat(chunks).toString("utf-8");
 }
-function isRecord6(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseOcfPayload(raw) {
@@ -19366,7 +19924,7 @@ function parseOcfPayload(raw) {
       EXIT.VALIDATION
     );
   }
-  if (!isRecord6(parsed)) {
+  if (!isRecord8(parsed)) {
     exitWithError(
       "OCF payload must be a JSON object.",
       "VALIDATION_FAILED",
@@ -19376,7 +19934,7 @@ function parseOcfPayload(raw) {
   }
   return parsed;
 }
-function shellQuote3(value) {
+function shellQuote4(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 async function runObjectsUpdate(args, rawArgv) {
@@ -19501,7 +20059,7 @@ Updated object: ${obj.id}
     printKeyValue([["Key", obj.schemaKey]]);
     printLine(
       `
-  Run: captable-ai schemas get ${shellQuote3(obj.schemaKey)} to view the exact schema.`
+  Run: captable-ai schemas get ${shellQuote4(obj.schemaKey)} to view the exact schema.`
     );
   }
   printLine();
@@ -19735,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 isRecord7(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isErrno3(err, code) {
-  return isRecord7(err) && err.code === code;
+  return isRecord9(err) && err.code === code;
 }
 function parseProfiles(raw) {
   const parsed = JSON.parse(raw);
-  if (!isRecord7(parsed) || !isRecord7(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 (!isRecord7(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;
@@ -20429,9 +20987,11 @@ Cap Table (read):
                              Options: --as-of, --include-pending, --skip-stakeholders, --page
   objects list              List OCF objects
                              Filters: --type, --subtype, --status, --q, --from, --to, --ids
-                             Pagination: --limit (1-250), --cursor
+                             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 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
 
@@ -20718,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;
@@ -20735,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.4",
+  "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",