@fairmint/captable-ai 0.1.34 → 0.1.36

package/dist/index.js

@@ -15355,10 +15355,82 @@ function planImportStatus({ documents, sessionState, scopeUnknown = false }) {
     }
   }
 }
-function applyDraftCount(plan, draftCount) {
-  if (plan.phase !== "complete" || draftCount !== 0)
+var IMPORT_REVIEW_MAX_IDS = 50;
+function reviewIsCut(action) {
+  return action.reviewObjectIds !== void 0 && action.s3AssetIds?.length !== 1 && action.reviewObjectIds.length > IMPORT_REVIEW_MAX_IDS;
+}
+function isFileRecordRow(draft) {
+  return draft.type === "DOCUMENT" || draft.subtype === "DOCUMENT";
+}
+function partitionImportDrafts(drafts, documentIds) {
+  if (documentIds.length === 0)
+    return null;
+  const documents = new Set(documentIds.map((id) => id.toLowerCase()));
+  const importDraftIds = [];
+  const importReviewableIds = [];
+  const portalIssuerDraftIds = [];
+  let otherDrafts = false;
+  for (const draft of drafts) {
+    if (typeof draft.id !== "string" || draft.id.length === 0)
+      return null;
+    if (!("documentId" in draft))
+      return null;
+    const ours = typeof draft.documentId === "string" && documents.has(draft.documentId.toLowerCase());
+    const selectable = !draft.id.includes(",") && draft.id === draft.id.trim();
+    if (!ours) {
+      if (draft.type === "ISSUER" && draft.documentId === null) {
+        if (!selectable)
+          return null;
+        portalIssuerDraftIds.push(draft.id);
+      } else {
+        otherDrafts = true;
+      }
+      continue;
+    }
+    if (!selectable)
+      return null;
+    importDraftIds.push(draft.id);
+    if (!isFileRecordRow(draft))
+      importReviewableIds.push(draft.id);
+  }
+  return { importDraftIds, importReviewableIds, portalIssuerDraftIds, otherDrafts };
+}
+function applyImportDrafts(plan, scope, documentIds) {
+  if (plan.phase !== "complete" || scope === null)
+    return plan;
+  if (scope.importReviewableIds.length === 0) {
+    return {
+      ...plan,
+      state: "complete",
+      actions: [],
+      ...scope.otherDrafts ? { unrelatedDrafts: true } : {}
+    };
+  }
+  if (!scope.otherDrafts)
     return plan;
-  return { ...plan, state: "complete", actions: [] };
+  const selection = [...scope.importDraftIds, ...scope.portalIssuerDraftIds];
+  const scoped = (action) => {
+    const base = { ...action, objectIds: selection };
+    switch (action.id) {
+      case "review_drafts":
+        return {
+          ...base,
+          label: "Review the drafts from this import's documents",
+          s3AssetIds: [...documentIds],
+          reviewObjectIds: scope.importReviewableIds
+        };
+      case "preview_commit":
+        return { ...base, label: "Preview committing this import's drafts" };
+      case "confirm_commit":
+        return {
+          ...base,
+          label: "Commit this import's drafts with the preview's final IDs as objectIds. Not allDrafts: the portal also has pending drafts from other sources"
+        };
+      default:
+        return action;
+    }
+  };
+  return { ...plan, actions: plan.actions.map(scoped) };
 }
 var EXTRACTION_NOT_READY_REASONS = [
   "pending_upload",
@@ -18497,8 +18569,8 @@ var COMMAND_REGISTRY = [
   {
     name: "objects revert",
     group: "captable",
-    description: "Preview or revert draft objects using backend dependency closure. Execution requires explicit final IDs (<object-id> or --objects) or --all.",
-    usage: "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --all) [--yes] [--json]",
+    description: "Preview or revert draft objects using backend dependency closure. Execution requires explicit final IDs (<object-id>, --objects or --objects-file) or --all.",
+    usage: "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all) [--yes] [--json]",
     requiresAuth: true,
     requiresPortal: true,
     flags: [
@@ -18512,6 +18584,11 @@ var COMMAND_REGISTRY = [
         description: "Comma-separated final object IDs to revert selectively.",
         type: "string"
       },
+      {
+        name: "objects-file",
+        description: "File of final object IDs to revert, one per line (- for stdin).",
+        type: "string"
+      },
       {
         name: "all",
         description: "Revert all pending drafts for the active company.",
@@ -18621,8 +18698,8 @@ var COMMAND_REGISTRY = [
   {
     name: "commit",
     group: "captable",
-    description: "Commit pending draft objects to the cap table. Use --dry-run to preview selected/final IDs without writing. Execution requires --objects with final IDs from preview, or --all. Exits with NOTHING_TO_COMMIT if no drafts exist.",
-    usage: "captable-ai commit --dry-run [--objects id1,id2,...] [--json]\ncaptable-ai commit (--objects id1,id2,... | --all) [--json]",
+    description: "Commit pending draft objects to the cap table. Use --dry-run to preview selected/final IDs without writing. Execution requires --objects or --objects-file with final IDs from preview, or --all. Exits with NOTHING_TO_COMMIT if no drafts exist.",
+    usage: "captable-ai commit --dry-run [--objects id1,id2,... | --objects-file <path|->] [--json]\ncaptable-ai commit (--objects id1,id2,... | --objects-file <path|-> | --all) [--json]",
     requiresAuth: true,
     requiresPortal: true,
     flags: [
@@ -18640,6 +18717,11 @@ var COMMAND_REGISTRY = [
         name: "objects",
         description: "Comma-separated final object IDs to commit selectively. Use preview.applyObjectIds.",
         type: "string"
+      },
+      {
+        name: "objects-file",
+        description: "File of final object IDs to commit, one per line (- for stdin).",
+        type: "string"
       }
     ]
   },
@@ -19219,22 +19301,24 @@ Examples:
 var HELP_OBJECTS_REVERT = `objects revert \u2014 Preview or revert draft objects
 
 Usage:
-  captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --all] [--json]
+  captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all] [--json]
   captable-ai objects revert <object-id> [--yes] [--json]
   captable-ai objects revert --objects id1,id2,... [--yes] [--json]
+  captable-ai objects revert --objects-file <path|-> [--yes] [--json]
   captable-ai objects revert --all [--yes] [--json]
 
 Previews or reverts draft objects using the backend dependency closure. Preview
 returns selected IDs, final IDs, auto-included IDs, invalid IDs, dependency
 reasons, blockers, and the applyObjectIds value to use for execution.
 
-Execution requires explicit final IDs (<object-id> or --objects) or --all.
+Execution requires explicit final IDs (<object-id>, --objects or --objects-file) or --all.
 Use IDs from preview.applyObjectIds when applyObjectIds is not null. Revert-all
 prompts for confirmation unless --yes or --json is set.
 
 Options:
   --dry-run         Preview mode \u2014 no write
   --objects IDS     Revert specific final object IDs (comma-separated)
+  --objects-file F  Read the IDs from a file, one per line (- for stdin); for long lists
   --all             Revert all pending drafts for the active company
   --yes             Skip the confirmation prompt (for scripts)
 
@@ -19296,14 +19380,14 @@ ${HELP_SCHEMAS_GET}`;
 var HELP_COMMIT = `commit \u2014 Commit pending drafts to the cap table
 
 Usage:
-  captable-ai commit --dry-run [--objects id1,id2,...] [--json]
-  captable-ai commit (--objects id1,id2,... | --all) [--json]
+  captable-ai commit --dry-run [--objects id1,id2,... | --objects-file <path|->] [--json]
+  captable-ai commit (--objects id1,id2,... | --objects-file <path|-> | --all) [--json]
 
 Previews or commits pending draft objects using the backend dependency closure.
 Preview returns selected IDs, final IDs, auto-included IDs, invalid IDs,
 dependency reasons, blockers, and the applyObjectIds value to use for execution.
 
-Execution requires explicit final IDs (--objects) or --all. Use IDs from
+Execution requires explicit final IDs (--objects or --objects-file) or --all. Use IDs from
 preview.applyObjectIds when applyObjectIds is not null. Exits with
 NOTHING_TO_COMMIT if no drafts exist.
 
@@ -19313,6 +19397,8 @@ Options:
   --objects id1,id2,...   Commit only specific object IDs (comma-separated). The server
                          validates that all transitive dependencies are satisfied.
                          Note: IDs containing commas are not supported.
+  --objects-file F        Read the IDs from a file, one per line (- for stdin), for lists too
+                         long for one command line. The dry run writes one when it must.
 
 Global:
   --json                 Machine-readable JSON output
@@ -19537,6 +19623,89 @@ Environment:
 Global:
   --json    Machine-readable JSON output`;
 
+// src/selection-input.ts
+import { createHash, randomBytes } from "crypto";
+import { chmod, mkdir as mkdir2, readFile as readFile2, rename, rm as rm2, writeFile as writeFile2 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+var CLI_SELECTION_MAX_BYTES = 1e5;
+function isPlainId(id) {
+  return id.length > 0 && id === id.trim();
+}
+function canSelectInline(objectIds) {
+  if (!objectIds.every((id) => isPlainId(id) && !id.includes(","))) return false;
+  const joined = objectIds.join(",");
+  const quotes = joined.split("'").length - 1;
+  return Buffer.byteLength(`--objects=${joined}`, "utf8") + 2 + quotes * 3 <= CLI_SELECTION_MAX_BYTES;
+}
+function canSelectFromFile(objectIds) {
+  return objectIds.every((id) => isPlainId(id) && !/[\r\n]/.test(id));
+}
+function parseObjectIdLines(text) {
+  return text.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+}
+var processSelectionReader = {
+  readFile: (path) => readFile2(path, "utf8"),
+  stdinIsTerminal: () => process.stdin.isTTY === true,
+  // Reads to end of input, like any `-` filter: a pipe that never closes waits, as `cat -` does.
+  readStdin: async () => {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+  }
+};
+async function readSelectionIds(source, reader = processSelectionReader) {
+  let text;
+  try {
+    if (source === "-") {
+      if (reader.stdinIsTerminal()) {
+        return {
+          ok: false,
+          message: "--objects-file - reads ids from stdin, but nothing is piped in."
+        };
+      }
+      text = await reader.readStdin();
+    } else {
+      text = await reader.readFile(source);
+    }
+  } catch (error51) {
+    const reason = error51 instanceof Error ? error51.message : String(error51);
+    return { ok: false, message: `Could not read --objects-file ${source}: ${reason}` };
+  }
+  const objectIds = parseObjectIdLines(text);
+  if (objectIds.length === 0) {
+    return {
+      ok: false,
+      message: `The --objects-file ${source === "-" ? "input" : source} must include at least one object ID.`
+    };
+  }
+  return { ok: true, objectIds };
+}
+function selectionsDir() {
+  return join2(homedir2(), ".captable-ai", "selections");
+}
+async function writeSelectionFile(name, objectIds) {
+  if (!canSelectFromFile(objectIds)) return null;
+  const dir = selectionsDir();
+  const digest = createHash("sha256").update(JSON.stringify(objectIds)).digest("hex").slice(0, 32);
+  const path = join2(dir, `${name.replace(/[^A-Za-z0-9._-]/g, "_")}-${digest}.txt`);
+  const temp = `${path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+  try {
+    await mkdir2(dir, { recursive: true, mode: 448 });
+    await chmod(dir, 448);
+    await writeFile2(temp, `${objectIds.join("\n")}
+`, { mode: 384, flag: "wx" });
+    await chmod(temp, 384);
+    await rename(temp, path);
+    return path;
+  } catch {
+    await rm2(temp, { force: true }).catch(() => void 0);
+    return null;
+  }
+}
+
 // src/commands/draft-operations.ts
 function parseObjectIdsList(raw) {
   if (raw === void 0) return void 0;
@@ -19545,6 +19714,23 @@ function parseObjectIdsList(raw) {
 function hasObjectIds(raw, objectIds) {
   return raw !== void 0 && (objectIds?.length ?? 0) > 0;
 }
+async function resolveObjectsInput(args, otherSelectorMessage = null, reader = processSelectionReader) {
+  const objectsRaw = getFlagValue(args, "objects");
+  const fileSource = getFlagValue(args, "objects-file");
+  if (objectsRaw !== void 0 && fileSource !== void 0) {
+    return { kind: "invalid", message: "Specify either --objects or --objects-file, not both." };
+  }
+  if (fileSource !== void 0) {
+    if (otherSelectorMessage !== null) return { kind: "invalid", message: otherSelectorMessage };
+    const read = await readSelectionIds(fileSource, reader);
+    return read.ok ? { kind: "ids", objectIds: read.objectIds } : { kind: "invalid", message: read.message };
+  }
+  const objectIds = parseObjectIdsList(objectsRaw);
+  if (objectsRaw !== void 0 && !hasObjectIds(objectsRaw, objectIds)) {
+    return { kind: "invalid", message: "The --objects flag must include at least one object ID." };
+  }
+  return objectIds === void 0 ? { kind: "none" } : { kind: "ids", objectIds };
+}
 function operationPastTense(operation) {
   return operation === "commit" ? "committed" : "reverted";
 }
@@ -19595,7 +19781,7 @@ function canApplyRevertAllFallback(data, operation) {
 function shellQuote(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
-function printDraftOperationPreview(data, options) {
+async function printDraftOperationPreview(data, options) {
   const applied = operationPastTense(options.operation);
   const objectCount = data.finalIds.length;
   if (objectCount === 0) {
@@ -19630,10 +19816,29 @@ Run \`${options.command} --all\` to revert all pending drafts.
     printLine("\nResolve the reported issues before applying this preview.\n");
     return;
   }
-  const applyCommand = data.applyObjectIds === null ? `${options.command} --all` : `${options.command} --objects=${shellQuote(data.applyObjectIds.join(","))}`;
-  printLine(`
-Run \`${applyCommand}\` to apply this preview.
+  if (data.applyObjectIds === null) {
+    printLine(`
+Run \`${options.command} --all\` to apply this preview.
 `);
+    return;
+  }
+  if (canSelectInline(data.applyObjectIds)) {
+    printLine(
+      `
+Run \`${options.command} --objects=${shellQuote(data.applyObjectIds.join(","))}\` to apply this preview.
+`
+    );
+    return;
+  }
+  const file2 = await writeSelectionFile(`${options.operation}-apply`, data.applyObjectIds);
+  printLine(
+    file2 ? `
+These ${data.applyObjectIds.length} IDs cannot be given inline (too many for one command line, or an ID with a comma). They are in ${file2}.
+Run \`${options.command} --objects-file ${shellQuote(file2)}\` to apply this preview.
+` : `
+These ${data.applyObjectIds.length} IDs cannot be put on one command line or in a file as they are (too many, or an ID with surrounding spaces or a line break). Apply this preview from the Studio timeline or the MCP.
+`
+  );
 }
 
 // src/commands/commit.ts
@@ -19643,8 +19848,8 @@ async function runCommit(args, rawArgv) {
 `);
     process.exit(0);
   }
-  validateFlags(args, { flags: ["objects"], booleans: ["all", "dry-run"] });
-  const USAGE2 = "captable-ai commit --dry-run [--objects id1,id2,...] [--json]\ncaptable-ai commit (--objects id1,id2,... | --all) [--json]";
+  validateFlags(args, { flags: ["objects", "objects-file"], booleans: ["all", "dry-run"] });
+  const USAGE2 = "captable-ai commit --dry-run [--objects id1,id2,... | --objects-file <path|->] [--json]\ncaptable-ai commit (--objects id1,id2,... | --objects-file <path|-> | --all) [--json]";
   if (args.positional.length > 0) {
     exitWithUsage(
       `Unexpected argument: ${args.positional[0]}. This command takes no positional arguments.`,
@@ -19653,14 +19858,14 @@ async function runCommit(args, rawArgv) {
   }
   const dryRun = hasFlag(args, "dry-run");
   const all = hasFlag(args, "all");
-  const objectIdsRaw = getFlagValue(args, "objects");
-  const objectIds = parseObjectIdsList(objectIdsRaw);
-  const hasExplicitObjectIds = hasObjectIds(objectIdsRaw, objectIds);
-  if (objectIdsRaw !== void 0 && !hasExplicitObjectIds) {
-    exitWithUsage("The --objects flag must include at least one object ID.", USAGE2);
-  }
+  const objectsInput = await resolveObjectsInput(
+    args,
+    all ? "Specify either --objects (or --objects-file) or --all, not both." : null
+  );
+  if (objectsInput.kind === "invalid") exitWithUsage(objectsInput.message, USAGE2);
+  const objectIds = objectsInput.kind === "ids" ? objectsInput.objectIds : void 0;
   if (all && objectIds) {
-    exitWithUsage("Specify either --objects or --all, not both.", USAGE2);
+    exitWithUsage("Specify either --objects (or --objects-file) or --all, not both.", USAGE2);
   }
   if (dryRun) {
     const portalId2 = await getActivePortalId();
@@ -19679,7 +19884,7 @@ async function runCommit(args, rawArgv) {
       printJson({ data: data2 });
       return;
     }
-    printDraftOperationPreview(data2, { command: "captable-ai commit", operation: "commit" });
+    await printDraftOperationPreview(data2, { command: "captable-ai commit", operation: "commit" });
     return;
   }
   const selection = resolveDraftOperationSelection(
@@ -20404,12 +20609,12 @@ async function runDocumentsRestartExtraction(args, rawArgv) {
 
 // src/jobs/tracker.ts
 import { randomUUID } from "crypto";
-import { appendFile, mkdir as mkdir2, readFile as readFile2, rename, rm as rm2, writeFile as writeFile2 } from "fs/promises";
-import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
-var CONFIG_DIR2 = join2(homedir2(), ".captable-ai");
-var JOBS_FILE = join2(CONFIG_DIR2, "jobs.jsonl");
-var LOCK_DIR = join2(CONFIG_DIR2, "jobs.lock");
+import { appendFile, mkdir as mkdir3, readFile as readFile3, rename as rename2, rm as rm3, writeFile as writeFile3 } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { join as join3 } from "path";
+var CONFIG_DIR2 = join3(homedir3(), ".captable-ai");
+var JOBS_FILE = join3(CONFIG_DIR2, "jobs.jsonl");
+var LOCK_DIR = join3(CONFIG_DIR2, "jobs.lock");
 var VALID_JOB_STATUSES = /* @__PURE__ */ new Set(["submitted", "running", "complete", "failed"]);
 var VALID_JOB_KINDS = /* @__PURE__ */ new Set(["extraction"]);
 function isRecord3(v) {
@@ -20420,7 +20625,7 @@ function isJobEntry(value) {
   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() {
-  await mkdir2(CONFIG_DIR2, { recursive: true, mode: 448 });
+  await mkdir3(CONFIG_DIR2, { recursive: true, mode: 448 });
 }
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -20437,7 +20642,7 @@ async function withJobsLock(fn) {
   const startedAt = Date.now();
   for (; ; ) {
     try {
-      await mkdir2(LOCK_DIR, { mode: 448 });
+      await mkdir3(LOCK_DIR, { mode: 448 });
       break;
     } catch (err) {
       if (!isErrno(err, "EEXIST")) throw err;
@@ -20450,7 +20655,7 @@ async function withJobsLock(fn) {
   try {
     return await fn();
   } finally {
-    await rm2(LOCK_DIR, { recursive: true, force: true });
+    await rm3(LOCK_DIR, { recursive: true, force: true });
   }
 }
 function generateJobId() {
@@ -20465,7 +20670,7 @@ async function appendJob(entry) {
 async function listJobs(filter) {
   let raw;
   try {
-    raw = await readFile2(JOBS_FILE, "utf8");
+    raw = await readFile3(JOBS_FILE, "utf8");
   } catch (err) {
     if (!isErrno(err, "ENOENT")) throw err;
     return [];
@@ -20526,10 +20731,10 @@ async function pruneJobs(before) {
 async function atomicWriteJobs(content) {
   const tmp = `${JOBS_FILE}.${process.pid}.${Date.now()}.tmp`;
   try {
-    await writeFile2(tmp, content, { mode: 384 });
-    await rename(tmp, JOBS_FILE);
+    await writeFile3(tmp, content, { mode: 384 });
+    await rename2(tmp, JOBS_FILE);
   } catch (err) {
-    await rm2(tmp, { force: true });
+    await rm3(tmp, { force: true });
     throw err;
   }
 }
@@ -20706,12 +20911,12 @@ function flagMissingIds(missingIds) {
 }
 
 // src/commands/documents-upload.ts
-import { createHash } from "crypto";
-import { readFile as readFile3, stat } from "fs/promises";
+import { createHash as createHash2 } from "crypto";
+import { readFile as readFile4, stat } from "fs/promises";
 import { basename } from "path";
 async function hashFile(path) {
-  const data = await readFile3(path);
-  return createHash("sha256").update(data).digest("hex");
+  const data = await readFile4(path);
+  return createHash2("sha256").update(data).digest("hex");
 }
 async function runDocumentsUpload(args, rawArgv) {
   if (rawArgv.includes("--help") || rawArgv.includes("-h")) {
@@ -20767,7 +20972,7 @@ async function runDocumentsUpload(args, rawArgv) {
   }
   for (const { doc, filePath } of toUpload) {
     if (!isJsonMode()) printLine(`  \u2191 Uploading ${doc.name}...`);
-    const fileData = await readFile3(filePath);
+    const fileData = await readFile4(filePath);
     const putRes = await fetch(doc.presignedUrl, {
       method: "PUT",
       headers: { "Content-Type": doc.contentType },
@@ -20818,11 +21023,11 @@ ${successCount}/${results.length} document(s) confirmed.`);
 }
 
 // src/commands/feedback.ts
-import { appendFile as appendFile2, mkdir as mkdir3, readFile as readFile4, rename as rename2, rm as rm3, writeFile as writeFile3 } from "fs/promises";
-import { homedir as homedir3 } from "os";
-import { join as join3 } from "path";
-var CONFIG_DIR3 = join3(homedir3(), ".captable-ai");
-var FEEDBACK_FILE = join3(CONFIG_DIR3, "feedback.jsonl");
+import { appendFile as appendFile2, mkdir as mkdir4, readFile as readFile5, rename as rename3, rm as rm4, writeFile as writeFile4 } from "fs/promises";
+import { homedir as homedir4 } from "os";
+import { join as join4 } from "path";
+var CONFIG_DIR3 = join4(homedir4(), ".captable-ai");
+var FEEDBACK_FILE = join4(CONFIG_DIR3, "feedback.jsonl");
 function isErrno2(err, code) {
   return typeof err === "object" && err !== null && "code" in err && err.code === code;
 }
@@ -20891,7 +21096,7 @@ async function runFeedback(args, rawArgv) {
   if (!text.trim()) {
     exitWithUsage("Feedback text cannot be empty.", 'Usage: captable-ai feedback "<message>"');
   }
-  await mkdir3(CONFIG_DIR3, { recursive: true, mode: 448 });
+  await mkdir4(CONFIG_DIR3, { recursive: true, mode: 448 });
   const entry = { ts: (/* @__PURE__ */ new Date()).toISOString(), text: text.trim(), sent: false };
   await appendFile2(FEEDBACK_FILE, `${JSON.stringify(entry)}
 `, { mode: 384 });
@@ -20974,14 +21179,14 @@ async function runFeedbackSend() {
     );
   }
   const updated = entries.map((e) => e.sent ? e : { ...e, sent: true });
-  await mkdir3(CONFIG_DIR3, { recursive: true, mode: 448 });
+  await mkdir4(CONFIG_DIR3, { recursive: true, mode: 448 });
   const tmp = `${FEEDBACK_FILE}.${process.pid}.${Date.now()}.tmp`;
   try {
-    await writeFile3(tmp, updated.map((e) => `${JSON.stringify(e)}
+    await writeFile4(tmp, updated.map((e) => `${JSON.stringify(e)}
 `).join(""), { mode: 384 });
-    await rename2(tmp, FEEDBACK_FILE);
+    await rename3(tmp, FEEDBACK_FILE);
   } catch (err) {
-    await rm3(tmp, { force: true });
+    await rm4(tmp, { force: true });
     throw err;
   }
   if (isJsonMode()) {
@@ -20993,7 +21198,7 @@ async function runFeedbackSend() {
 async function readEntries() {
   let raw;
   try {
-    raw = await readFile4(FEEDBACK_FILE, "utf8");
+    raw = await readFile5(FEEDBACK_FILE, "utf8");
   } catch (err) {
     if (!isErrno2(err, "ENOENT")) {
       exitWithError(
@@ -21211,7 +21416,7 @@ async function fetchTrackedDocuments(portalId, assetIds) {
 
 // src/commands/login.ts
 import { execFile } from "child_process";
-import { randomBytes, timingSafeEqual } from "crypto";
+import { randomBytes as randomBytes2, timingSafeEqual } from "crypto";
 import { createServer } from "http";
 import { platform } from "os";
 import { createInterface } from "readline";
@@ -21324,7 +21529,7 @@ function tryParseLoginPaste(line, expectedState) {
 async function runLogin(args) {
   validateFlags(args, { flags: [], booleans: [] });
   const jsonMode2 = isJsonMode();
-  const state = randomBytes(16).toString("hex");
+  const state = randomBytes2(16).toString("hex");
   let settled = false;
   let timeoutId;
   let rl;
@@ -22335,16 +22540,19 @@ async function runObjectsRevert(args, rawArgv) {
 `);
     process.exit(0);
   }
-  validateFlags(args, { flags: ["objects"], booleans: ["all", "dry-run", "yes"] });
+  validateFlags(args, { flags: ["objects", "objects-file"], booleans: ["all", "dry-run", "yes"] });
   const objectIdRaw = args.positional[0];
   const objectId = objectIdRaw?.trim();
   const all = hasFlag(args, "all");
   const dryRun = hasFlag(args, "dry-run");
   const yes = hasFlag(args, "yes");
-  const objectIdsRaw = getFlagValue(args, "objects");
-  const objectIdsFromFlag = parseObjectIdsList(objectIdsRaw);
-  const hasExplicitObjectIds = hasObjectIds(objectIdsRaw, objectIdsFromFlag);
-  const USAGE2 = "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --all) [--yes] [--json]";
+  const USAGE2 = "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all) [--yes] [--json]";
+  const objectsInput = await resolveObjectsInput(
+    args,
+    objectIdRaw !== void 0 || all ? "Specify only one of an object ID, --objects (or --objects-file), or --all." : null
+  );
+  if (objectsInput.kind === "invalid") exitWithUsage(objectsInput.message, USAGE2);
+  const objectIdsFromFlag = objectsInput.kind === "ids" ? objectsInput.objectIds : void 0;
   if (args.positional.length > 1) {
     exitWithUsage(
       `Too many arguments: expected one object ID, got ${args.positional.length}.`,
@@ -22354,12 +22562,12 @@ async function runObjectsRevert(args, rawArgv) {
   if (objectIdRaw !== void 0 && !objectId) {
     exitWithUsage("Object ID must be a non-empty string.", USAGE2);
   }
-  if (objectIdsRaw !== void 0 && !hasExplicitObjectIds) {
-    exitWithUsage("The --objects flag must include at least one object ID.", USAGE2);
-  }
   const selectionSources = [Boolean(objectId), Boolean(objectIdsFromFlag), all].filter(Boolean);
   if (selectionSources.length > 1) {
-    exitWithUsage("Specify only one of an object ID, --objects, or --all.", USAGE2);
+    exitWithUsage(
+      "Specify only one of an object ID, --objects (or --objects-file), or --all.",
+      USAGE2
+    );
   }
   const objectIds = objectId ? [objectId] : objectIdsFromFlag;
   if (dryRun) {
@@ -22378,7 +22586,7 @@ async function runObjectsRevert(args, rawArgv) {
       printJson({ data: res2.data });
       return;
     }
-    printDraftOperationPreview(res2.data, {
+    await printDraftOperationPreview(res2.data, {
       command: "captable-ai objects revert",
       operation: "revert"
     });
@@ -23031,7 +23239,17 @@ async function runImportStart(args) {
 function scopeFlag(ids) {
   return ids && ids.length > 0 ? ` --s3-asset-ids ${ids.join(",")}` : "";
 }
-function importStatusCommand(action, sessionId) {
+function selectionTooLong(action) {
+  return (action.id === "preview_commit" || action.id === "confirm_commit") && action.objectIds !== void 0 && !canSelectInline(action.objectIds);
+}
+function importStatusCommand(action, sessionId, selectionFile) {
+  if (selectionTooLong(action) && selectionFile === null) {
+    return {
+      id: action.id,
+      label: `This import has ${action.objectIds?.length ?? 0} drafts, too many to select on one command line, and they could not be written to a file. Commit them from the Studio timeline, or with the MCP. Not --all: the portal also has pending drafts from other sources.`,
+      required: action.required
+    };
+  }
   const command = (() => {
     switch (action.id) {
       case "upload_documents":
@@ -23048,12 +23266,20 @@ function importStatusCommand(action, sessionId) {
         return "captable-ai documents list";
       case "review_failures":
         return action.statusFilter ? `captable-ai documents list --status ${action.statusFilter}` : "captable-ai documents list";
-      case "review_drafts":
-        return "captable-ai objects list --status draft --all";
+      case "review_drafts": {
+        if (!action.objectIds) return "captable-ai objects list --status draft --all";
+        const [onlyDocument, ...moreDocuments] = action.s3AssetIds ?? [];
+        if (onlyDocument !== void 0 && moreDocuments.length === 0) {
+          return `captable-ai objects list --status draft --document ${shellQuote(onlyDocument)} --all`;
+        }
+        const reviewable = (action.reviewObjectIds ?? []).slice(0, IMPORT_REVIEW_MAX_IDS);
+        return `captable-ai objects list --status draft --ids=${shellQuote(reviewable.join(","))}`;
+      }
       case "preview_commit":
-        return "captable-ai commit --dry-run";
+        if (!action.objectIds) return "captable-ai commit --dry-run";
+        return selectionTooLong(action) && selectionFile !== null ? `captable-ai commit --dry-run --objects-file ${shellQuote(selectionFile)}` : `captable-ai commit --dry-run --objects=${shellQuote(action.objectIds.join(","))}`;
       case "confirm_commit":
-        return "captable-ai commit --all";
+        return action.objectIds ? "captable-ai commit --objects <final IDs from the dry run>" : "captable-ai commit --all";
       default: {
         const unhandled = action.id;
         throw new Error(`Unhandled import status action: ${String(unhandled)}`);
@@ -23063,35 +23289,40 @@ function importStatusCommand(action, sessionId) {
   const id = action.id === "upload_documents" ? "upload_cli" : action.id;
   return {
     id,
-    label: action.label,
+    label: action.id === "review_drafts" && reviewIsCut(action) ? `${action.label} (first ${IMPORT_REVIEW_MAX_IDS} of ${action.reviewObjectIds?.length ?? 0})` : action.label,
     required: action.required,
     command,
     ...action.id === "review_failures" && action.s3AssetIds && { s3AssetIds: action.s3AssetIds }
   };
 }
-var DRAFT_COUNT_MAX_PAGES = 100;
-async function readDraftCount(portalId) {
+var DRAFT_SCOPE_MAX_PAGES = 100;
+async function readImportDraftScope(portalId, documentIds) {
   if (!portalId) return null;
   try {
-    let count = 0;
+    const drafts = [];
     let cursor;
-    for (let page = 0; page < DRAFT_COUNT_MAX_PAGES; page += 1) {
+    for (let page = 0; page < DRAFT_SCOPE_MAX_PAGES; page += 1) {
       const res = await apiRequest(
         `/${encodeURIComponent(portalId)}/objects`,
         {
-          query: { status: "draft", ...cursor ? { cursor } : {} },
+          query: { status: "draft", limit: 250, ...cursor ? { cursor } : {} },
           // Optional read: throw (caught below) instead of exiting the process on a failure.
           softFail: true
         }
       );
       const objects = res.data?.objects;
       if (!Array.isArray(objects)) return null;
-      count += objects.filter(
-        (obj) => obj.type !== "DOCUMENT" && obj.subtype !== "DOCUMENT"
-      ).length;
-      if (count > 0) return count;
+      for (const obj of objects) {
+        if (typeof obj !== "object" || obj === null || Array.isArray(obj)) return null;
+        drafts.push({
+          id: Reflect.get(obj, "id"),
+          type: Reflect.get(obj, "type"),
+          subtype: Reflect.get(obj, "subtype"),
+          ..."documentId" in obj ? { documentId: Reflect.get(obj, "documentId") } : {}
+        });
+      }
+      if (!res.meta?.hasMore) return partitionImportDrafts(drafts, documentIds);
       const next = res.meta?.cursor;
-      if (!res.meta?.hasMore) return count;
       if (!next || next === cursor) return null;
       cursor = next;
     }
@@ -23114,12 +23345,19 @@ async function runImportStatus(args) {
   );
   const portalDocuments = response.data?.processing?.documents ?? [];
   const documents = documentsForImportSession(portalDocuments, response.data?.session?.createdAt);
+  const documentIds = documents.flatMap(
+    (document) => typeof document.s3AssetId === "string" ? [document.s3AssetId] : []
+  );
   const documentPlan = planImportStatus({
     documents,
     sessionState: response.data?.session?.state,
     scopeUnknown: importSessionScopeUnknown(portalDocuments)
   });
-  const plan = documentPlan.phase === "complete" ? applyDraftCount(documentPlan, await readDraftCount(response.data?.session?.portalId)) : documentPlan;
+  const plan = documentPlan.phase === "complete" ? applyImportDrafts(
+    documentPlan,
+    await readImportDraftScope(response.data?.session?.portalId, documentIds),
+    documentIds
+  ) : documentPlan;
   const { summary } = plan;
   if (plan.shouldComplete) {
     const completed = await apiRequest(
@@ -23133,7 +23371,11 @@ async function runImportStatus(args) {
       response.data.session = { ...response.data.session, ...completed.data.session };
     }
   }
-  const nextActions = plan.actions.map((action) => importStatusCommand(action, sessionId));
+  const longSelection = plan.actions.find(selectionTooLong)?.objectIds;
+  const selectionFile = longSelection ? await writeSelectionFile(`import-${sessionId}`, longSelection) : null;
+  const nextActions = plan.actions.map(
+    (action) => importStatusCommand(action, sessionId, selectionFile)
+  );
   const suggestMonitoring = shouldSuggestBackgroundMonitoring(plan.phase);
   const data = {
     ...response.data,
@@ -23141,6 +23383,7 @@ async function runImportStatus(args) {
     phase: plan.phase,
     summary,
     nextActions,
+    ...plan.unrelatedDrafts && { unrelatedDrafts: true },
     ...suggestMonitoring && { monitoringHint: BACKGROUND_MONITORING_SUGGESTION }
   };
   if (isJsonMode()) {
@@ -23165,12 +23408,28 @@ async function runImportStatus(args) {
       "  Some uploads never finished. Re-upload them; checking status again will not complete them."
     );
   }
+  if (plan.unrelatedDrafts) {
+    printLine(
+      "  The portal has other pending drafts that this import did not produce; leave them alone unless asked."
+    );
+  }
+  const scopedCommit = plan.actions.some(
+    (planned) => planned.id === "confirm_commit" && planned.objectIds !== void 0
+  );
   for (const action of nextActions) {
+    if (action.command === void 0) {
+      printLine(`  Note: ${action.label}`);
+      continue;
+    }
     printLine(`  Next: ${action.command}`);
     if (action.id === "resolve_extraction_scope") printLine(`    Note: ${action.label}`);
     if (action.id === "check_status" && plan.phase === "empty") {
       printLine(`    Note: ${action.label}`);
     }
+    if (action.id === "confirm_commit" && scopedCommit) printLine(`    Note: ${action.label}`);
+    if (action.id === "review_drafts" && action.label.includes("(first ")) {
+      printLine(`    Note: ${action.label}`);
+    }
     if (action.id === "review_failures" && action.s3AssetIds) {
       printLine(`    Documents: ${action.s3AssetIds.join(", ")}`);
     }
@@ -23340,11 +23599,11 @@ function formatNumber(n) {
 }
 
 // src/profiles.ts
-import { mkdir as mkdir4, readFile as readFile5, rename as rename3, rm as rm4, writeFile as writeFile4 } from "fs/promises";
-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");
+import { mkdir as mkdir5, readFile as readFile6, rename as rename4, rm as rm5, writeFile as writeFile5 } from "fs/promises";
+import { homedir as homedir5 } from "os";
+import { join as join5 } from "path";
+var CONFIG_DIR4 = join5(homedir5(), ".captable-ai");
+var PROFILES_FILE = join5(CONFIG_DIR4, "profiles.json");
 function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -23372,7 +23631,7 @@ function parseProfiles(raw) {
 }
 async function readProfiles() {
   try {
-    const raw = await readFile5(PROFILES_FILE, "utf8");
+    const raw = await readFile6(PROFILES_FILE, "utf8");
     return parseProfiles(raw);
   } catch (err) {
     if (isErrno3(err, "ENOENT")) return { profiles: {}, default: null };
@@ -23386,13 +23645,13 @@ async function readProfiles() {
 }
 async function writeProfiles(data) {
   try {
-    await mkdir4(CONFIG_DIR4, { recursive: true, mode: 448 });
+    await mkdir5(CONFIG_DIR4, { recursive: true, mode: 448 });
     const tmp = `${PROFILES_FILE}.${process.pid}.${Date.now()}.tmp`;
     try {
-      await writeFile4(tmp, JSON.stringify(data, null, 2), { mode: 384 });
-      await rename3(tmp, PROFILES_FILE);
+      await writeFile5(tmp, JSON.stringify(data, null, 2), { mode: 384 });
+      await rename4(tmp, PROFILES_FILE);
     } catch (err) {
-      await rm4(tmp, { force: true });
+      await rm5(tmp, { force: true });
       throw err;
     }
   } catch (err) {

package/package.json

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