@fairmint/captable-ai 0.1.29 → 0.1.31

package/dist/index.js

@@ -15355,6 +15355,11 @@ function planImportStatus({ documents, sessionState, scopeUnknown = false }) {
     }
   }
 }
+function applyDraftCount(plan, draftCount) {
+  if (plan.phase !== "complete" || draftCount !== 0)
+    return plan;
+  return { ...plan, state: "complete", actions: [] };
+}
 var EXTRACTION_NOT_READY_REASONS = [
   "pending_upload",
   "classification_in_progress"
@@ -15527,6 +15532,7 @@ var DOCUMENT_HEALTH_VALUES = [
 ];
 var documentProcessingStatusItemSchema = external_exports.object({
   s3AssetId: external_exports.string().describe("S3 asset / document ID."),
+  name: external_exports.string().nullable().optional().describe("Original file name; absent on older servers."),
   status: external_exports.string().describe("Document processing status."),
   createdAt: external_exports.string().nullable().optional().describe("Immutable document creation timestamp; absent on older servers."),
   lastActivityAt: external_exports.string().nullable().describe("Last backend activity timestamp (updated_at / heartbeat); null if unknown."),
@@ -15722,13 +15728,18 @@ var draftOperationDependencyIssueSchema = external_exports.object({
   expectedType: external_exports.string().describe("Expected OCF object category for the reference.")
 });
 var draftOperationPlanIssueSchema = external_exports.object({
-  code: external_exports.enum(["NO_DRAFTS", "REVERT_LIMIT_EXCEEDED"]).describe("Plan-level validation code."),
+  code: external_exports.enum(["NO_DRAFTS", "REVERT_LIMIT_EXCEEDED", "ISSUER_REQUIRED", "ISSUER_INCOMPLETE"]).describe("Plan-level validation code."),
   message: external_exports.string().describe("Human-readable plan validation message.")
 });
 var draftOperationPreviewInputSchema = external_exports.object({
   operation: draftOperationSchema.describe("Draft operation to preview."),
   objectIds: external_exports.array(external_exports.string().trim().min(1, "objectIds must contain only non-empty strings.")).min(1, "objectIds must contain at least one ID when provided.").optional().describe("Optional draft OCF object IDs. Omit to preview all pending drafts.")
 });
+var draftOperationEmailIssueSchema = external_exports.object({
+  id: external_exports.string().describe("Stakeholder ID."),
+  name: external_exports.string().nullable().describe("Stakeholder legal name, when known."),
+  problem: external_exports.enum(["missing", "invalid"]).describe("No email address, or one that is not *@*.*.")
+});
 var draftOperationPreviewSchema = external_exports.object({
   operation: draftOperationSchema,
   dependencyValid: external_exports.boolean().describe("True when object IDs are valid and dependency validation passes."),
@@ -15741,7 +15752,9 @@ var draftOperationPreviewSchema = external_exports.object({
   missingDependencies: external_exports.array(draftOperationDependencyIssueSchema).describe("Remaining dependency blockers reported by backend preflight validation."),
   planIssues: external_exports.array(draftOperationPlanIssueSchema).describe("Plan-level blockers."),
   objects: external_exports.array(ocfObjectSchema).describe("Versioned draft objects in finalIds order."),
-  draftCount: external_exports.number().int().nonnegative().describe("Total latest draft objects considered by this preview.")
+  draftCount: external_exports.number().int().nonnegative().describe("Total latest draft objects considered by this preview."),
+  emailIssues: external_exports.array(draftOperationEmailIssueSchema).optional().describe("Commit only: stakeholders whose email would make the commit refuse (or warn)."),
+  emailOverride: external_exports.boolean().optional().describe("True when only missing emails remain and the caller is a super-admin.")
 });
 function normalizeDraftOperationObjectIds(objectIds) {
   if (!objectIds)
@@ -16658,6 +16671,8 @@ var ONBOARDING_STATES = {
   READY_TO_IMPORT: "ready_to_import",
   PROCESSING: "processing",
   NEEDS_REVIEW: "needs_review",
+  /** Processing finished and nothing is left to review or commit (no drafts). */
+  COMPLETE: "complete",
   BLOCKED: "blocked",
   READY_TO_COMMIT: "ready_to_commit"
 };
@@ -16695,6 +16710,11 @@ var onboardingStateSchema = external_exports.discriminatedUnion("state", [
     importSessionId: external_exports.string().uuid(),
     blockerCount: external_exports.number().int().nonnegative()
   }),
+  onboardingStateBaseSchema.extend({
+    state: external_exports.literal(ONBOARDING_STATES.COMPLETE),
+    portalId: external_exports.string().uuid(),
+    importSessionId: external_exports.string().uuid()
+  }),
   onboardingStateBaseSchema.extend({
     state: external_exports.literal(ONBOARDING_STATES.BLOCKED),
     portalId: external_exports.string().uuid().optional(),
@@ -19534,6 +19554,20 @@ function printPreviewWarnings(data) {
       `${data.missingDependencies.length} dependency blocker(s) remain. Use --json for details.`
     );
   }
+  const emailIssues = data.emailIssues ?? [];
+  const kinds = [
+    ["missing", "missing an email address"],
+    ["invalid", "with an invalid email address"]
+  ];
+  for (const [problem, text] of kinds) {
+    const names = emailIssues.filter((issue2) => issue2.problem === problem).map((i) => i.name || i.id);
+    if (names.length > 0) {
+      const override = problem === "missing" && data.emailOverride === true;
+      printWarning(
+        `${names.length} stakeholder(s) ${text}: ${names.join(", ")}.${override ? " Super-admin override: a missing email will not block the commit." : ""}`
+      );
+    }
+  }
 }
 function previewRows(data) {
   const objectsById = new Map(data.objects.map((object2) => [object2.id, object2]));
@@ -23026,6 +23060,37 @@ function importStatusCommand(action, sessionId) {
     ...action.id === "review_failures" && action.s3AssetIds && { s3AssetIds: action.s3AssetIds }
   };
 }
+var DRAFT_COUNT_MAX_PAGES = 100;
+async function readDraftCount(portalId) {
+  if (!portalId) return null;
+  try {
+    let count = 0;
+    let cursor;
+    for (let page = 0; page < DRAFT_COUNT_MAX_PAGES; page += 1) {
+      const res = await apiRequest(
+        `/${encodeURIComponent(portalId)}/objects`,
+        {
+          query: { status: "draft", ...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;
+      const next = res.meta?.cursor;
+      if (!res.meta?.hasMore) return count;
+      if (!next || next === cursor) return null;
+      cursor = next;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 async function runImportStatus(args) {
   validateFlags(args, { flags: [], booleans: [] });
   const sessionId = args.positional[0];
@@ -23040,11 +23105,12 @@ async function runImportStatus(args) {
   );
   const portalDocuments = response.data?.processing?.documents ?? [];
   const documents = documentsForImportSession(portalDocuments, response.data?.session?.createdAt);
-  const plan = planImportStatus({
+  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 { summary } = plan;
   if (plan.shouldComplete) {
     const completed = await apiRequest(

package/package.json

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