@fairmint/captable-ai 0.1.22 → 0.1.24

package/dist/index.js

@@ -448,866 +448,6 @@ async function runAuthStatus(args) {
   ]);
 }
 
-// src/commands/commands.ts
-var COMMAND_REGISTRY = [
-  {
-    name: "login",
-    group: "auth",
-    description: "Authenticate via browser-based login.",
-    usage: "captable-ai login",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "logout",
-    group: "auth",
-    description: "Revoke tokens and clear local credentials.",
-    usage: "captable-ai logout",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "auth status",
-    group: "auth",
-    description: "Show authentication status, token expiry, and active company.",
-    usage: "captable-ai auth status",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "company list",
-    group: "company",
-    description: "List available companies.",
-    usage: "captable-ai company list",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "company use",
-    group: "company",
-    description: "Set the active company by ID or name.",
-    usage: "captable-ai company use <id-or-name>",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "company current",
-    group: "company",
-    description: "Show the active company.",
-    usage: "captable-ai company current",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "company create",
-    group: "company",
-    description: "Create a new test portal with ISSUER OCF object. Requires Fairmint super admin.",
-    usage: "captable-ai company create --name <company-name> [--legal-name <name>] [--domain <domain>] [--country <code>] [--formation-date <YYYY-MM-DD>] [--currency <code>] [--json]",
-    requiresAuth: true,
-    requiresPortal: false,
-    flags: [
-      { name: "name", description: "Company display name (required).", type: "string" },
-      {
-        name: "legal-name",
-        description: "Legal entity name (defaults to --name).",
-        type: "string"
-      },
-      { name: "domain", description: "Portal domain.", type: "string" },
-      { name: "country", description: "ISO 3166-1 alpha-2 country code.", type: "string" },
-      { name: "formation-date", description: "Incorporation date (YYYY-MM-DD).", type: "string" },
-      { name: "currency", description: "Currency ISO 4217 (default: USD).", type: "string" }
-    ]
-  },
-  {
-    name: "company delete",
-    group: "company",
-    description: "Delete a test portal and all child data. Dev-only. Requires Fairmint super admin.",
-    usage: "captable-ai company delete <company-id> [--yes] [--json]",
-    requiresAuth: true,
-    requiresPortal: false,
-    flags: [{ name: "yes", description: "Skip the confirmation prompt.", type: "boolean" }]
-  },
-  {
-    name: "onboarding status",
-    group: "onboarding",
-    description: "Show the next first-workspace or import action. Works for authenticated users with zero companies.",
-    usage: "captable-ai onboarding status [--session <import-session-id>] [--json]",
-    requiresAuth: true,
-    requiresPortal: false,
-    flags: [
-      {
-        name: "session",
-        description: "Inspect this import session instead of local workspace state.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "onboarding setup",
-    group: "onboarding",
-    description: "Idempotently create the authenticated user's first production workspace. Only --accept-terms is required; the company profile is read from uploaded documents.",
-    usage: "captable-ai onboarding setup --accept-terms [--legal-name <name>] [--company-type <type>] [--country <code>] [--role <role>] [--other-role <role>] [--cap-table-source <source>] [--other-cap-table-source <source>] [--stakeholder-count <bucket>] [--json]",
-    requiresAuth: true,
-    requiresPortal: false,
-    flags: [
-      {
-        name: "accept-terms",
-        description: "Confirm acceptance of Fairmint's Terms of Service (required).",
-        type: "boolean"
-      },
-      {
-        name: "legal-name",
-        description: "Company name. Left unset until you or document extraction supplies one.",
-        type: "string"
-      },
-      {
-        name: "company-type",
-        description: "Legal entity type. Left unrecorded when omitted.",
-        type: "string",
-        enum: ["us_c_corporation", "us_llc", "foreign_entity", "not_incorporated"]
-      },
-      {
-        name: "country",
-        description: "ISO 3166-1 alpha-2 code. Only with --company-type foreign_entity.",
-        type: "string"
-      },
-      {
-        name: "role",
-        description: "Your role at the company.",
-        type: "string",
-        enum: [
-          "CEO",
-          "COO",
-          "CMO",
-          "CFO",
-          "CTO",
-          "CRO",
-          "Director",
-          "Founder",
-          "co-founder",
-          "co-CEO",
-          "other"
-        ]
-      },
-      {
-        name: "other-role",
-        description: "Free-text role. Required when --role other.",
-        type: "string"
-      },
-      {
-        name: "cap-table-source",
-        description: "Where the cap table is maintained today.",
-        type: "string",
-        enum: ["none", "spreadsheet", "carta", "pulley", "angellist", "other"]
-      },
-      {
-        name: "other-cap-table-source",
-        description: "Free-text source. Required when --cap-table-source other.",
-        type: "string"
-      },
-      {
-        name: "stakeholder-count",
-        description: "Approximate number of stakeholders on the cap table.",
-        type: "string",
-        enum: ["1_10", "11_25", "26_50", "50_100", "100_plus"]
-      }
-    ]
-  },
-  {
-    name: "import start",
-    group: "onboarding",
-    description: "Start or reuse a secure import session for existing document upload APIs.",
-    usage: "captable-ai import start [--json]",
-    requiresAuth: true,
-    requiresPortal: true
-  },
-  {
-    name: "import status",
-    group: "onboarding",
-    description: "Show import processing progress and the next existing-pipeline action.",
-    usage: "captable-ai import status <session-id> [--json]",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "summary",
-    group: "captable",
-    description: "Full cap table snapshot: capitalization, stakeholders, convertibles, metrics, and status.",
-    usage: "captable-ai summary [--as-of YYYY-MM-DD] [--include-pending] [--skip-stakeholders] [--page overview] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "as-of",
-        description: "Historical snapshot date (YYYY-MM-DD).",
-        type: "string"
-      },
-      {
-        name: "include-pending",
-        description: "Include draft objects in computation.",
-        type: "boolean"
-      },
-      {
-        name: "skip-stakeholders",
-        description: "Omit stakeholderView section (faster).",
-        type: "boolean"
-      },
-      {
-        name: "page",
-        description: "Use 'overview' for lightweight issuer/metrics/status.",
-        type: "string",
-        enum: ["overview"]
-      }
-    ]
-  },
-  {
-    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] [--stakeholder ID] [--document ID] [--all] [--max-confidence N] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "type",
-        description: "Filter by top-level OCF type (comma-separated). Use `schemas list` for allowed values.",
-        type: "string"
-      },
-      {
-        name: "subtype",
-        description: "Filter by TRANSACTION subtype (comma-separated). Use `schemas get TRANSACTION` for allowed values.",
-        type: "string"
-      },
-      {
-        name: "status",
-        description: "Filter by status: draft or committed.",
-        type: "string",
-        enum: ["draft", "committed"]
-      },
-      { name: "limit", description: "Page size (1-250, default 100).", type: "number" },
-      { name: "cursor", description: "Pagination cursor.", type: "string" },
-      { name: "q", description: "Full-text search query.", type: "string" },
-      {
-        name: "from",
-        description: "Filter objects with date >= (YYYY-MM-DD, inclusive).",
-        type: "string"
-      },
-      {
-        name: "to",
-        description: "Filter objects with date <= (YYYY-MM-DD, inclusive).",
-        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"
-      }
-    ]
-  },
-  {
-    name: "objects review-non-cash",
-    group: "captable",
-    description: "List unmarked convertible issuances whose stored evidence suggests possible non-cash consideration.",
-    usage: "captable-ai objects review-non-cash [--status draft|committed] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "status",
-        description: "Review only latest draft or committed objects.",
-        type: "string",
-        enum: ["draft", "committed"]
-      }
-    ]
-  },
-  {
-    name: "objects get",
-    group: "captable",
-    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",
-    description: "List available OCF object types.",
-    usage: "captable-ai schemas list [--json]",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "schemas get",
-    group: "captable",
-    description: "Get the schema for an OCF object type.",
-    usage: "captable-ai schemas get <object-type> [--json]",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "objects update",
-    group: "captable",
-    description: "Update an OCF object (committed or draft) by uploading a complete OCF payload (version-checked). Supply the payload via --stdin (piped JSON) or --file <path>. The --version is auto-fetched from the server if omitted.",
-    usage: "captable-ai objects update <object-id> (--stdin | --file <path>) [--version N] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      { name: "stdin", description: "Read complete OCF JSON payload from stdin.", type: "boolean" },
-      {
-        name: "file",
-        description: "Path to a JSON file containing the complete OCF payload.",
-        type: "string"
-      },
-      {
-        name: "version",
-        description: "Optimistic-concurrency version number. Auto-fetched from objects get if omitted.",
-        type: "number"
-      }
-    ]
-  },
-  {
-    name: "objects patch",
-    group: "captable",
-    description: "Patch an OCF object by uploading a partial OCF payload. The server shallow-merges the patch, validates the merged result, and writes a draft.",
-    usage: "captable-ai objects patch <object-id> (--stdin | --file <path>) [--version N] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      { name: "stdin", description: "Read partial OCF JSON payload from stdin.", type: "boolean" },
-      {
-        name: "file",
-        description: "Path to a JSON file containing the partial OCF payload.",
-        type: "string"
-      },
-      {
-        name: "version",
-        description: "Optional optimistic-concurrency version number.",
-        type: "number"
-      }
-    ]
-  },
-  {
-    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]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "dry-run",
-        description: "Preview selected/final IDs and dependency blockers without writing.",
-        type: "boolean"
-      },
-      {
-        name: "objects",
-        description: "Comma-separated final object IDs to revert selectively.",
-        type: "string"
-      },
-      {
-        name: "all",
-        description: "Revert all pending drafts for the active company.",
-        type: "boolean"
-      },
-      {
-        name: "yes",
-        description: "Skip the confirmation prompt when using --all.",
-        type: "boolean"
-      }
-    ]
-  },
-  {
-    name: "objects delete",
-    group: "captable",
-    description: "Permanently delete an OCF object. By default deletes only the latest version; use --delete-all to remove all versions. Supports --expected-version for concurrency.",
-    usage: "captable-ai objects delete <objectId> [--delete-all] [--expected-version N] [--yes] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "delete-all",
-        description: "Delete all versions, not just the latest.",
-        type: "boolean"
-      },
-      {
-        name: "expected-version",
-        description: "Expected version for optimistic concurrency check.",
-        type: "number"
-      },
-      {
-        name: "yes",
-        description: "Skip the confirmation prompt.",
-        type: "boolean"
-      }
-    ]
-  },
-  {
-    name: "objects versions",
-    group: "captable",
-    description: "List versions of an OCF object (draft vs committed).",
-    usage: "captable-ai objects versions <object-id> [--json]",
-    requiresAuth: true,
-    requiresPortal: true
-  },
-  {
-    name: "export",
-    group: "captable",
-    description: "Export the cap table as an Excel workbook. Returns a presigned download URL valid for 1 hour.",
-    usage: "captable-ai export [--as-of YYYY-MM-DD] [--show-empty-fields] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "as-of",
-        description: "Point-in-time date (YYYY-MM-DD) for historical export.",
-        type: "string"
-      },
-      {
-        name: "show-empty-fields",
-        description: "Include empty columns/rows in the export.",
-        type: "boolean"
-      }
-    ]
-  },
-  {
-    name: "register",
-    group: "captable",
-    description: "Generate shareholder register PDF.",
-    usage: "captable-ai register [--as-of YYYY-MM-DD] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "as-of",
-        description: "Point-in-time date (YYYY-MM-DD) for historical register.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    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]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "dry-run",
-        description: "Preview selected/final IDs and dependency blockers without committing.",
-        type: "boolean"
-      },
-      {
-        name: "all",
-        description: "Commit all pending drafts for the active company.",
-        type: "boolean"
-      },
-      {
-        name: "objects",
-        description: "Comma-separated final object IDs to commit selectively. Use preview.applyObjectIds.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "documents upload",
-    group: "captable",
-    description: "Upload cap table documents. Computes SHA-256, calls prepare, uploads to S3 via presigned PUT, then confirms. Classification runs automatically after confirmation.",
-    usage: "captable-ai documents upload <file...> [--json]",
-    requiresAuth: true,
-    requiresPortal: true
-  },
-  {
-    name: "documents list",
-    group: "captable",
-    description: "List uploaded cap table documents with their processing status, classification, and dates.",
-    usage: "captable-ai documents list [--status STATUS] [--limit N] [--cursor C] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "status",
-        description: "Filter by document status.",
-        type: "string",
-        enum: [
-          "PENDING_UPLOAD",
-          "NEW",
-          "EXTRACTION",
-          "OCF_EXTRACTION",
-          "CLASSIFICATION",
-          "CLASSIFIED",
-          "CREATION",
-          "VALIDATION",
-          "FINALIZATION",
-          "PROCESSED",
-          "FAILED",
-          "CANCELLED"
-        ]
-      },
-      { name: "limit", description: "Page size (1-100, default 50).", type: "number" },
-      { name: "cursor", description: "Pagination cursor.", type: "string" }
-    ]
-  },
-  {
-    name: "documents delete",
-    group: "captable",
-    description: "Delete an uploaded document and all associated artifacts (OCF object, captable_document, s3_asset, S3 file). Rejects if non-DOCUMENT OCF objects still reference the document.",
-    usage: "captable-ai documents delete <s3AssetId> [--json]",
-    requiresAuth: true,
-    requiresPortal: true
-  },
-  {
-    name: "documents download",
-    group: "captable",
-    description: "Get a presigned download URL for a cap table document's source file. Valid for 1 hour.",
-    usage: "captable-ai documents download <s3AssetId> [--json]",
-    requiresAuth: true,
-    requiresPortal: true
-  },
-  {
-    name: "documents trigger-extraction",
-    group: "captable",
-    description: "Trigger OCF extraction for classified documents. Sends them to the extraction queue for processing. Optionally filter to specific document IDs.",
-    usage: "captable-ai documents trigger-extraction [--s3-asset-ids ID1,ID2,...] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "s3-asset-ids",
-        description: "Comma-separated S3 asset IDs to filter to specific documents.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "documents cancel-extraction",
-    group: "captable",
-    description: "Cancel a stuck document extraction \u2014 marks it as FAILED and triggers validation for the remaining documents.",
-    usage: "captable-ai documents cancel-extraction <s3AssetId> [--json]",
-    requiresAuth: true,
-    requiresPortal: true
-  },
-  {
-    name: "documents restart-extraction",
-    group: "captable",
-    description: "Atomically restart extraction for stuck in-flight documents \u2014 cancels and re-enqueues them in order, routing each to the correct pipeline. Prefer this over cancel-extraction + trigger-extraction.",
-    usage: "captable-ai documents restart-extraction [--s3-asset-ids ID1,ID2,...] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "s3-asset-ids",
-        description: "Comma-separated S3 asset IDs to restart specific documents.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "documents processing-status",
-    group: "captable",
-    description: "Show per-document processing status, queue position, and health (processing | queued | stalled | failed | done). Health derives from the backend heartbeat.",
-    usage: "captable-ai documents processing-status [--s3-asset-ids ID1,ID2,...] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "s3-asset-ids",
-        description: "Comma-separated S3 asset IDs to filter to specific documents.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "documents classification-types",
-    group: "captable",
-    description: "List available document classification types.",
-    usage: "captable-ai documents classification-types [--json]",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "documents classification-update",
-    group: "captable",
-    description: "Update a document's classification labels and optional date.",
-    usage: "captable-ai documents classification-update --s3-asset-id ID --classification TYPE1,TYPE2 [--date YYYY-MM-DD] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "s3-asset-id",
-        description: "S3 asset ID of the document to classify.",
-        type: "string"
-      },
-      {
-        name: "classification",
-        description: "Comma-separated classification types to assign.",
-        type: "string"
-      },
-      {
-        name: "date",
-        description: "Optional document date (YYYY-MM-DD).",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "documents reprocess",
-    group: "captable",
-    description: "Reprocess a document through the extraction pipeline.",
-    usage: "captable-ai documents reprocess --s3-asset-id ID [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "s3-asset-id",
-        description: "S3 asset ID of the document to reprocess.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "retrigger-validation",
-    group: "captable",
-    description: "Force-retrigger OCF validation for the active company, bypassing the pending-documents check. Use when validation appears stuck.",
-    usage: "captable-ai retrigger-validation [--json]",
-    requiresAuth: true,
-    requiresPortal: true
-  },
-  {
-    name: "pro-forma run",
-    group: "captable",
-    description: "Run a pro-forma cap table scenario: financing round, convertible conversion, warrant exercise, or option pool expansion.",
-    usage: "captable-ai pro-forma run <type> [flags] [--json]\n  Types: financing, convertible, warrant, option-pool",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      { name: "pre-money", description: "Pre-money valuation (financing).", type: "number" },
-      { name: "amount", description: "Investment amount (financing).", type: "number" },
-      { name: "class-name", description: "New stock class name (financing).", type: "string" },
-      { name: "investor", description: "Lead investor name (financing).", type: "string" },
-      {
-        name: "pool-expansion",
-        description: "Target option pool % of post-money (financing).",
-        type: "number"
-      },
-      {
-        name: "pool-timing",
-        description: "PRE_MONEY or POST_MONEY (financing).",
-        type: "string",
-        enum: ["PRE_MONEY", "POST_MONEY"]
-      },
-      {
-        name: "trigger-valuation",
-        description: "Valuation triggering conversion (convertible).",
-        type: "number"
-      },
-      {
-        name: "include-interest",
-        description: "Include accrued interest for notes (convertible).",
-        type: "boolean"
-      },
-      { name: "exercise-all", description: "Exercise all warrants (warrant).", type: "boolean" },
-      {
-        name: "security-ids",
-        description: "Comma-separated security IDs (convertible, warrant).",
-        type: "string"
-      },
-      {
-        name: "target-percentage",
-        description: "Target pool % of fully diluted (option-pool).",
-        type: "number"
-      },
-      {
-        name: "additional-shares",
-        description: "Fixed shares to add (option-pool).",
-        type: "number"
-      }
-    ]
-  },
-  {
-    name: "jobs list",
-    group: "jobs",
-    description: "List tracked async jobs (extraction, validation) from the local job tracker.",
-    usage: "captable-ai jobs list [--status submitted|running|complete|failed] [--json]",
-    requiresAuth: false,
-    requiresPortal: false,
-    flags: [
-      {
-        name: "status",
-        description: "Filter by job status.",
-        type: "string",
-        enum: ["submitted", "running", "complete", "failed"]
-      }
-    ]
-  },
-  {
-    name: "jobs get",
-    group: "jobs",
-    description: "Check current status of a tracked job by polling the API and updating the local tracker.",
-    usage: "captable-ai jobs get <job-id> [--json]",
-    requiresAuth: true,
-    requiresPortal: false
-  },
-  {
-    name: "jobs prune",
-    group: "jobs",
-    description: "Remove completed/failed jobs older than 7 days (or --before date) from the local tracker.",
-    usage: "captable-ai jobs prune [--before YYYY-MM-DD] [--json]",
-    requiresAuth: false,
-    requiresPortal: false,
-    flags: [
-      {
-        name: "before",
-        description: "Remove jobs submitted before this date (YYYY-MM-DD).",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "profile list",
-    group: "profile",
-    description: "List saved configuration profiles.",
-    usage: "captable-ai profile list [--json]",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "profile get",
-    group: "profile",
-    description: "Show a profile's configuration.",
-    usage: "captable-ai profile get <name> [--json]",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "profile save",
-    group: "profile",
-    description: "Create or update a named profile.",
-    usage: "captable-ai profile save <name> --company=<id> [--stage=<s>] [--json]",
-    requiresAuth: false,
-    requiresPortal: false,
-    flags: [
-      { name: "company", description: "Company (portal) ID for this profile.", type: "string" },
-      {
-        name: "stage",
-        description: "Stage override.",
-        type: "string",
-        enum: ["dev", "staging", "production", "local"]
-      }
-    ]
-  },
-  {
-    name: "profile delete",
-    group: "profile",
-    description: "Remove a saved profile.",
-    usage: "captable-ai profile delete <name> [--json]",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "profile use",
-    group: "profile",
-    description: "Set a profile as the default.",
-    usage: "captable-ai profile use <name> [--json]",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "feedback",
-    group: "feedback",
-    description: "Record CLI friction feedback locally.",
-    usage: 'captable-ai feedback "<message>" [--json]',
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "feedback list",
-    group: "feedback",
-    description: "List recorded feedback entries.",
-    usage: "captable-ai feedback list [--json]",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "feedback send",
-    group: "feedback",
-    description: "POST unsent feedback to upstream endpoint (requires CAPTABLE_AI_FEEDBACK_URL).",
-    usage: "captable-ai feedback send [--json]",
-    requiresAuth: false,
-    requiresPortal: false
-  },
-  {
-    name: "logs list",
-    group: "logs",
-    description: "List OCF agent log entries (expert/validator runs) for the active portal. Requires Fairmint super-admin.",
-    usage: "captable-ai logs list [--agent-type expert|validator] [--limit N] [--cursor C] [--json]",
-    requiresAuth: true,
-    requiresPortal: true,
-    flags: [
-      {
-        name: "agent-type",
-        description: "Filter by agent type.",
-        type: "string",
-        enum: ["expert", "validator"]
-      },
-      { name: "limit", description: "Page size (1\u2013200, default 50).", type: "number" },
-      {
-        name: "cursor",
-        description: "Pagination cursor from a previous response.",
-        type: "string"
-      }
-    ]
-  },
-  {
-    name: "commands",
-    group: "commands",
-    description: "List all available commands (machine-readable JSON).",
-    usage: "captable-ai commands",
-    requiresAuth: false,
-    requiresPortal: false
-  }
-];
-async function runCommands(_args) {
-  printJson({ schemaVersion: "10", version: "0.0.1", commands: COMMAND_REGISTRY });
-}
-
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -15771,11 +14911,43 @@ var documentDownloadResultSchema = external_exports.object({
   contentType: external_exports.string().describe("MIME type."),
   expiresAt: external_exports.string().describe("URL expiry timestamp.")
 });
+var REGISTER_SECTION_OPTIONS = [
+  {
+    field: "includeShareClassDetails",
+    flag: "include-share-class-details",
+    description: "Include a Share Class Details section in the PDF."
+  },
+  {
+    field: "includeTransactionHistory",
+    flag: "include-transaction-history",
+    description: "Include a Transaction History section in the PDF."
+  },
+  {
+    field: "includeEquityAwards",
+    flag: "include-equity-awards",
+    description: "Include option grants and other equity awards: adds an Option Grants & Equity Awards section, includes equity-award events in Transaction History, and counts award-only holders in Number of Shareholders (Number of Record Holders stays stock-only). Set this when the user wants option or grant holders in the register."
+  }
+];
+var REGISTER_SECTION_DESCRIPTIONS = REGISTER_SECTION_OPTIONS.reduce((acc, option) => {
+  acc[option.field] = option.description;
+  return acc;
+}, {});
+function registerSectionField(field) {
+  const description = REGISTER_SECTION_DESCRIPTIONS[field];
+  if (description === void 0) {
+    throw new Error(`Missing register section description for ${field}`);
+  }
+  return external_exports.boolean().optional().default(false).describe(description);
+}
+var registerSectionFields = {
+  includeShareClassDetails: registerSectionField("includeShareClassDetails"),
+  includeTransactionHistory: registerSectionField("includeTransactionHistory"),
+  includeEquityAwards: registerSectionField("includeEquityAwards")
+};
 var generateRegisterInputSchema = external_exports.object({
   asOf: external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("Point-in-time date for register (YYYY-MM-DD)."),
   reportType: external_exports.literal("shareholder_register").optional().default("shareholder_register").describe("Report type."),
-  includeShareClassDetails: external_exports.boolean().optional().default(false).describe("Include a Share Class Details section in the PDF."),
-  includeTransactionHistory: external_exports.boolean().optional().default(false).describe("Include a Transaction History section in the PDF.")
+  ...registerSectionFields
 });
 var generateRegisterResultSchema = external_exports.object({
   downloadUrl: external_exports.string().describe("Presigned S3 download URL for the PDF."),
@@ -17257,154 +16429,1065 @@ async function apiRequest(path, opts = {}) {
       } catch (refreshErr) {
         exitForRefreshFailure(refreshErr, softFail);
       }
-      if (refreshed) {
-        headers.Authorization = `Bearer ${refreshed.accessToken}`;
-        try {
-          const retryRes = await fetch(url2.toString(), buildFetchOpts());
-          return handleResponse(retryRes, softFail);
-        } catch (retryErr) {
-          if (retryErr instanceof DOMException && retryErr.name === "TimeoutError") {
-            failRequest(
-              softFail,
-              "Request timed out. Check your network connection and try again.",
-              "TIMEOUT",
-              void 0,
-              EXIT.NETWORK
-            );
-          }
-          failRequest(
-            softFail,
-            `Network error: ${retryErr instanceof Error ? retryErr.message : "connection failed"}`,
-            "NETWORK",
-            void 0,
-            EXIT.NETWORK
-          );
-        }
+      if (refreshed) {
+        headers.Authorization = `Bearer ${refreshed.accessToken}`;
+        try {
+          const retryRes = await fetch(url2.toString(), buildFetchOpts());
+          return handleResponse(retryRes, softFail);
+        } catch (retryErr) {
+          if (retryErr instanceof DOMException && retryErr.name === "TimeoutError") {
+            failRequest(
+              softFail,
+              "Request timed out. Check your network connection and try again.",
+              "TIMEOUT",
+              void 0,
+              EXIT.NETWORK
+            );
+          }
+          failRequest(
+            softFail,
+            `Network error: ${retryErr instanceof Error ? retryErr.message : "connection failed"}`,
+            "NETWORK",
+            void 0,
+            EXIT.NETWORK
+          );
+        }
+      }
+    }
+  }
+  return handleResponse(res, softFail);
+}
+function exitCodeForStatus(status) {
+  if (status === 400) return EXIT.VALIDATION;
+  if (status === 401 || status === 403) return EXIT.AUTH;
+  if (status === 404) return EXIT.NOT_FOUND;
+  if (status === 409) return EXIT.CONFLICT;
+  if (status === 422) return EXIT.VALIDATION;
+  if (status >= 500) return EXIT.SERVER_ERROR;
+  return EXIT.SERVER_ERROR;
+}
+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) {
+      failRequest(
+        softFail,
+        `HTTP ${res.status}: ${text.slice(0, 200)}`,
+        `HTTP_${res.status}`,
+        void 0,
+        exitCodeForStatus(res.status)
+      );
+    }
+    return { data: text };
+  }
+  if (!res.ok) {
+    const exitCode = exitCodeForStatus(res.status);
+    const obj = isRecord2(parsed) ? parsed : {};
+    const nested = obj.error;
+    if (isRecord2(nested)) {
+      const code = typeof nested.code === "string" && nested.code.trim() ? nested.code : void 0;
+      const details = coerceDetails(nested.details);
+      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);
+      failRequest(softFail, nested, code, details, exitCode);
+    }
+    failRequest(
+      softFail,
+      `HTTP ${res.status}: ${text.slice(0, 200)}`,
+      void 0,
+      void 0,
+      exitCode
+    );
+  }
+  return parsed;
+}
+
+// src/flags.ts
+function looksLikeFlag(value) {
+  if (!value.startsWith("-")) return false;
+  if (value === "-" || /^-\d+(?:\.\d+)?$/.test(value)) return false;
+  return true;
+}
+function parseArgs(argv) {
+  const positional = [];
+  const positionalIndexes = [];
+  const flags = {};
+  const flagValueSources = {};
+  const flagValueIndexes = {};
+  const boolean4 = /* @__PURE__ */ new Set();
+  let i = 0;
+  while (i < argv.length) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      const eqIdx = arg.indexOf("=");
+      if (eqIdx !== -1) {
+        const key = arg.slice(2, eqIdx);
+        flags[key] = arg.slice(eqIdx + 1);
+        flagValueSources[key] = "equals";
+        flagValueIndexes[key] = i;
+      } else {
+        const key = arg.slice(2);
+        const next = argv[i + 1];
+        if (next !== void 0 && !looksLikeFlag(next)) {
+          flags[key] = next;
+          flagValueSources[key] = "next";
+          flagValueIndexes[key] = i + 1;
+          i++;
+        } else {
+          boolean4.add(key);
+        }
+      }
+    } else {
+      positional.push(arg);
+      positionalIndexes.push(i);
+    }
+    i++;
+  }
+  return { positional, positionalIndexes, flags, flagValueSources, flagValueIndexes, boolean: boolean4 };
+}
+function hasFlag(args, name) {
+  return args.boolean.has(name) || name in args.flags;
+}
+function getFlagValue(args, name) {
+  return args.flags[name];
+}
+function argvRequestsHelp(argv) {
+  if (argv.includes("--help") || argv.includes("-h")) return true;
+  return argv[0] === "help";
+}
+
+// src/commands/register.ts
+var REGISTER_USAGE = `captable-ai register [--as-of YYYY-MM-DD] ${REGISTER_SECTION_OPTIONS.map((o) => `[--${o.flag}]`).join(" ")} [--json]`;
+async function runRegister(args) {
+  validateFlags(args, {
+    flags: ["as-of"],
+    booleans: REGISTER_SECTION_OPTIONS.map((option) => option.flag)
+  });
+  if (args.positional.length > 0) {
+    exitWithUsage(
+      `Unexpected argument: ${args.positional[0]}. This command takes no positional arguments; section flags take no value (omit a flag to leave that section off).`,
+      REGISTER_USAGE
+    );
+  }
+  const portalId = await getActivePortalId();
+  const asOf = getFlagValue(args, "as-of");
+  const body = {};
+  if (asOf) body.asOf = asOf;
+  for (const option of REGISTER_SECTION_OPTIONS) {
+    if (hasFlag(args, option.flag)) body[option.field] = true;
+  }
+  const res = await apiRequest(`/${portalId}/register`, {
+    method: "POST",
+    body
+  });
+  if (isJsonMode()) {
+    printJson({ data: res.data });
+    return;
+  }
+  const d = res.data;
+  if (!d) {
+    exitWithError(
+      "Register generation failed \u2014 no data returned.",
+      "ERROR",
+      void 0,
+      EXIT.SERVER_ERROR
+    );
+  }
+  printLine("\n  Shareholder register generated successfully.\n");
+  printKeyValue([
+    ["Download URL", d.downloadUrl],
+    ["Filename", d.filename],
+    ["Expires at", d.expiresAt]
+  ]);
+  printLine();
+}
+
+// src/commands/commands.ts
+var COMMAND_REGISTRY = [
+  {
+    name: "login",
+    group: "auth",
+    description: "Authenticate via browser-based login.",
+    usage: "captable-ai login",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "logout",
+    group: "auth",
+    description: "Revoke tokens and clear local credentials.",
+    usage: "captable-ai logout",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "auth status",
+    group: "auth",
+    description: "Show authentication status, token expiry, and active company.",
+    usage: "captable-ai auth status",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "company list",
+    group: "company",
+    description: "List available companies.",
+    usage: "captable-ai company list",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "company use",
+    group: "company",
+    description: "Set the active company by ID or name.",
+    usage: "captable-ai company use <id-or-name>",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "company current",
+    group: "company",
+    description: "Show the active company.",
+    usage: "captable-ai company current",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "company create",
+    group: "company",
+    description: "Create a new test portal with ISSUER OCF object. Requires Fairmint super admin.",
+    usage: "captable-ai company create --name <company-name> [--legal-name <name>] [--domain <domain>] [--country <code>] [--formation-date <YYYY-MM-DD>] [--currency <code>] [--json]",
+    requiresAuth: true,
+    requiresPortal: false,
+    flags: [
+      { name: "name", description: "Company display name (required).", type: "string" },
+      {
+        name: "legal-name",
+        description: "Legal entity name (defaults to --name).",
+        type: "string"
+      },
+      { name: "domain", description: "Portal domain.", type: "string" },
+      { name: "country", description: "ISO 3166-1 alpha-2 country code.", type: "string" },
+      { name: "formation-date", description: "Incorporation date (YYYY-MM-DD).", type: "string" },
+      { name: "currency", description: "Currency ISO 4217 (default: USD).", type: "string" }
+    ]
+  },
+  {
+    name: "company delete",
+    group: "company",
+    description: "Delete a test portal and all child data. Dev-only. Requires Fairmint super admin.",
+    usage: "captable-ai company delete <company-id> [--yes] [--json]",
+    requiresAuth: true,
+    requiresPortal: false,
+    flags: [{ name: "yes", description: "Skip the confirmation prompt.", type: "boolean" }]
+  },
+  {
+    name: "onboarding status",
+    group: "onboarding",
+    description: "Show the next first-workspace or import action. Works for authenticated users with zero companies.",
+    usage: "captable-ai onboarding status [--session <import-session-id>] [--json]",
+    requiresAuth: true,
+    requiresPortal: false,
+    flags: [
+      {
+        name: "session",
+        description: "Inspect this import session instead of local workspace state.",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "onboarding setup",
+    group: "onboarding",
+    description: "Idempotently create the authenticated user's first production workspace. Only --accept-terms is required; the company profile is read from uploaded documents.",
+    usage: "captable-ai onboarding setup --accept-terms [--legal-name <name>] [--company-type <type>] [--country <code>] [--role <role>] [--other-role <role>] [--cap-table-source <source>] [--other-cap-table-source <source>] [--stakeholder-count <bucket>] [--json]",
+    requiresAuth: true,
+    requiresPortal: false,
+    flags: [
+      {
+        name: "accept-terms",
+        description: "Confirm acceptance of Fairmint's Terms of Service (required).",
+        type: "boolean"
+      },
+      {
+        name: "legal-name",
+        description: "Company name. Left unset until you or document extraction supplies one.",
+        type: "string"
+      },
+      {
+        name: "company-type",
+        description: "Legal entity type. Left unrecorded when omitted.",
+        type: "string",
+        enum: ["us_c_corporation", "us_llc", "foreign_entity", "not_incorporated"]
+      },
+      {
+        name: "country",
+        description: "ISO 3166-1 alpha-2 code. Only with --company-type foreign_entity.",
+        type: "string"
+      },
+      {
+        name: "role",
+        description: "Your role at the company.",
+        type: "string",
+        enum: [
+          "CEO",
+          "COO",
+          "CMO",
+          "CFO",
+          "CTO",
+          "CRO",
+          "Director",
+          "Founder",
+          "co-founder",
+          "co-CEO",
+          "other"
+        ]
+      },
+      {
+        name: "other-role",
+        description: "Free-text role. Required when --role other.",
+        type: "string"
+      },
+      {
+        name: "cap-table-source",
+        description: "Where the cap table is maintained today.",
+        type: "string",
+        enum: ["none", "spreadsheet", "carta", "pulley", "angellist", "other"]
+      },
+      {
+        name: "other-cap-table-source",
+        description: "Free-text source. Required when --cap-table-source other.",
+        type: "string"
+      },
+      {
+        name: "stakeholder-count",
+        description: "Approximate number of stakeholders on the cap table.",
+        type: "string",
+        enum: ["1_10", "11_25", "26_50", "50_100", "100_plus"]
+      }
+    ]
+  },
+  {
+    name: "import start",
+    group: "onboarding",
+    description: "Start or reuse a secure import session for existing document upload APIs.",
+    usage: "captable-ai import start [--json]",
+    requiresAuth: true,
+    requiresPortal: true
+  },
+  {
+    name: "import status",
+    group: "onboarding",
+    description: "Show import processing progress and the next existing-pipeline action.",
+    usage: "captable-ai import status <session-id> [--json]",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "summary",
+    group: "captable",
+    description: "Full cap table snapshot: capitalization, stakeholders, convertibles, metrics, and status.",
+    usage: "captable-ai summary [--as-of YYYY-MM-DD] [--include-pending] [--skip-stakeholders] [--page overview] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "as-of",
+        description: "Historical snapshot date (YYYY-MM-DD).",
+        type: "string"
+      },
+      {
+        name: "include-pending",
+        description: "Include draft objects in computation.",
+        type: "boolean"
+      },
+      {
+        name: "skip-stakeholders",
+        description: "Omit stakeholderView section (faster).",
+        type: "boolean"
+      },
+      {
+        name: "page",
+        description: "Use 'overview' for lightweight issuer/metrics/status.",
+        type: "string",
+        enum: ["overview"]
+      }
+    ]
+  },
+  {
+    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] [--stakeholder ID] [--document ID] [--all] [--max-confidence N] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "type",
+        description: "Filter by top-level OCF type (comma-separated). Use `schemas list` for allowed values.",
+        type: "string"
+      },
+      {
+        name: "subtype",
+        description: "Filter by TRANSACTION subtype (comma-separated). Use `schemas get TRANSACTION` for allowed values.",
+        type: "string"
+      },
+      {
+        name: "status",
+        description: "Filter by status: draft or committed.",
+        type: "string",
+        enum: ["draft", "committed"]
+      },
+      { name: "limit", description: "Page size (1-250, default 100).", type: "number" },
+      { name: "cursor", description: "Pagination cursor.", type: "string" },
+      { name: "q", description: "Full-text search query.", type: "string" },
+      {
+        name: "from",
+        description: "Filter objects with date >= (YYYY-MM-DD, inclusive).",
+        type: "string"
+      },
+      {
+        name: "to",
+        description: "Filter objects with date <= (YYYY-MM-DD, inclusive).",
+        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"
+      }
+    ]
+  },
+  {
+    name: "objects review-non-cash",
+    group: "captable",
+    description: "List unmarked convertible issuances whose stored evidence suggests possible non-cash consideration.",
+    usage: "captable-ai objects review-non-cash [--status draft|committed] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "status",
+        description: "Review only latest draft or committed objects.",
+        type: "string",
+        enum: ["draft", "committed"]
+      }
+    ]
+  },
+  {
+    name: "objects get",
+    group: "captable",
+    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",
+    description: "List available OCF object types.",
+    usage: "captable-ai schemas list [--json]",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "schemas get",
+    group: "captable",
+    description: "Get the schema for an OCF object type.",
+    usage: "captable-ai schemas get <object-type> [--json]",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "objects update",
+    group: "captable",
+    description: "Update an OCF object (committed or draft) by uploading a complete OCF payload (version-checked). Supply the payload via --stdin (piped JSON) or --file <path>. The --version is auto-fetched from the server if omitted.",
+    usage: "captable-ai objects update <object-id> (--stdin | --file <path>) [--version N] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      { name: "stdin", description: "Read complete OCF JSON payload from stdin.", type: "boolean" },
+      {
+        name: "file",
+        description: "Path to a JSON file containing the complete OCF payload.",
+        type: "string"
+      },
+      {
+        name: "version",
+        description: "Optimistic-concurrency version number. Auto-fetched from objects get if omitted.",
+        type: "number"
+      }
+    ]
+  },
+  {
+    name: "objects patch",
+    group: "captable",
+    description: "Patch an OCF object by uploading a partial OCF payload. The server shallow-merges the patch, validates the merged result, and writes a draft.",
+    usage: "captable-ai objects patch <object-id> (--stdin | --file <path>) [--version N] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      { name: "stdin", description: "Read partial OCF JSON payload from stdin.", type: "boolean" },
+      {
+        name: "file",
+        description: "Path to a JSON file containing the partial OCF payload.",
+        type: "string"
+      },
+      {
+        name: "version",
+        description: "Optional optimistic-concurrency version number.",
+        type: "number"
+      }
+    ]
+  },
+  {
+    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]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "dry-run",
+        description: "Preview selected/final IDs and dependency blockers without writing.",
+        type: "boolean"
+      },
+      {
+        name: "objects",
+        description: "Comma-separated final object IDs to revert selectively.",
+        type: "string"
+      },
+      {
+        name: "all",
+        description: "Revert all pending drafts for the active company.",
+        type: "boolean"
+      },
+      {
+        name: "yes",
+        description: "Skip the confirmation prompt when using --all.",
+        type: "boolean"
+      }
+    ]
+  },
+  {
+    name: "objects delete",
+    group: "captable",
+    description: "Permanently delete an OCF object. By default deletes only the latest version; use --delete-all to remove all versions. Supports --expected-version for concurrency.",
+    usage: "captable-ai objects delete <objectId> [--delete-all] [--expected-version N] [--yes] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "delete-all",
+        description: "Delete all versions, not just the latest.",
+        type: "boolean"
+      },
+      {
+        name: "expected-version",
+        description: "Expected version for optimistic concurrency check.",
+        type: "number"
+      },
+      {
+        name: "yes",
+        description: "Skip the confirmation prompt.",
+        type: "boolean"
+      }
+    ]
+  },
+  {
+    name: "objects versions",
+    group: "captable",
+    description: "List versions of an OCF object (draft vs committed).",
+    usage: "captable-ai objects versions <object-id> [--json]",
+    requiresAuth: true,
+    requiresPortal: true
+  },
+  {
+    name: "export",
+    group: "captable",
+    description: "Export the cap table as an Excel workbook. Returns a presigned download URL valid for 1 hour.",
+    usage: "captable-ai export [--as-of YYYY-MM-DD] [--show-empty-fields] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "as-of",
+        description: "Point-in-time date (YYYY-MM-DD) for historical export.",
+        type: "string"
+      },
+      {
+        name: "show-empty-fields",
+        description: "Include empty columns/rows in the export.",
+        type: "boolean"
+      }
+    ]
+  },
+  {
+    name: "register",
+    group: "captable",
+    description: "Generate a shareholder register PDF (shareholders of record by default). Returns a presigned download URL.",
+    usage: REGISTER_USAGE,
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "as-of",
+        description: "Point-in-time date (YYYY-MM-DD) for historical register.",
+        type: "string"
+      },
+      ...REGISTER_SECTION_OPTIONS.map((option) => ({
+        name: option.flag,
+        description: option.description,
+        type: "boolean"
+      }))
+    ]
+  },
+  {
+    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]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "dry-run",
+        description: "Preview selected/final IDs and dependency blockers without committing.",
+        type: "boolean"
+      },
+      {
+        name: "all",
+        description: "Commit all pending drafts for the active company.",
+        type: "boolean"
+      },
+      {
+        name: "objects",
+        description: "Comma-separated final object IDs to commit selectively. Use preview.applyObjectIds.",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "documents upload",
+    group: "captable",
+    description: "Upload cap table documents. Computes SHA-256, calls prepare, uploads to S3 via presigned PUT, then confirms. Classification runs automatically after confirmation.",
+    usage: "captable-ai documents upload <file...> [--json]",
+    requiresAuth: true,
+    requiresPortal: true
+  },
+  {
+    name: "documents list",
+    group: "captable",
+    description: "List uploaded cap table documents with their processing status, classification, and dates.",
+    usage: "captable-ai documents list [--status STATUS] [--limit N] [--cursor C] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "status",
+        description: "Filter by document status.",
+        type: "string",
+        enum: [
+          "PENDING_UPLOAD",
+          "NEW",
+          "EXTRACTION",
+          "OCF_EXTRACTION",
+          "CLASSIFICATION",
+          "CLASSIFIED",
+          "CREATION",
+          "VALIDATION",
+          "FINALIZATION",
+          "PROCESSED",
+          "FAILED",
+          "CANCELLED"
+        ]
+      },
+      { name: "limit", description: "Page size (1-100, default 50).", type: "number" },
+      { name: "cursor", description: "Pagination cursor.", type: "string" }
+    ]
+  },
+  {
+    name: "documents delete",
+    group: "captable",
+    description: "Delete an uploaded document and all associated artifacts (OCF object, captable_document, s3_asset, S3 file). Rejects if non-DOCUMENT OCF objects still reference the document.",
+    usage: "captable-ai documents delete <s3AssetId> [--json]",
+    requiresAuth: true,
+    requiresPortal: true
+  },
+  {
+    name: "documents download",
+    group: "captable",
+    description: "Get a presigned download URL for a cap table document's source file. Valid for 1 hour.",
+    usage: "captable-ai documents download <s3AssetId> [--json]",
+    requiresAuth: true,
+    requiresPortal: true
+  },
+  {
+    name: "documents trigger-extraction",
+    group: "captable",
+    description: "Trigger OCF extraction for classified documents. Sends them to the extraction queue for processing. Optionally filter to specific document IDs.",
+    usage: "captable-ai documents trigger-extraction [--s3-asset-ids ID1,ID2,...] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "s3-asset-ids",
+        description: "Comma-separated S3 asset IDs to filter to specific documents.",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "documents cancel-extraction",
+    group: "captable",
+    description: "Cancel a stuck document extraction \u2014 marks it as FAILED and triggers validation for the remaining documents.",
+    usage: "captable-ai documents cancel-extraction <s3AssetId> [--json]",
+    requiresAuth: true,
+    requiresPortal: true
+  },
+  {
+    name: "documents restart-extraction",
+    group: "captable",
+    description: "Atomically restart extraction for stuck in-flight documents \u2014 cancels and re-enqueues them in order, routing each to the correct pipeline. Prefer this over cancel-extraction + trigger-extraction.",
+    usage: "captable-ai documents restart-extraction [--s3-asset-ids ID1,ID2,...] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "s3-asset-ids",
+        description: "Comma-separated S3 asset IDs to restart specific documents.",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "documents processing-status",
+    group: "captable",
+    description: "Show per-document processing status, queue position, and health (processing | queued | stalled | failed | done). Health derives from the backend heartbeat.",
+    usage: "captable-ai documents processing-status [--s3-asset-ids ID1,ID2,...] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "s3-asset-ids",
+        description: "Comma-separated S3 asset IDs to filter to specific documents.",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "documents classification-types",
+    group: "captable",
+    description: "List available document classification types.",
+    usage: "captable-ai documents classification-types [--json]",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "documents classification-update",
+    group: "captable",
+    description: "Update a document's classification labels and optional date.",
+    usage: "captable-ai documents classification-update --s3-asset-id ID --classification TYPE1,TYPE2 [--date YYYY-MM-DD] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "s3-asset-id",
+        description: "S3 asset ID of the document to classify.",
+        type: "string"
+      },
+      {
+        name: "classification",
+        description: "Comma-separated classification types to assign.",
+        type: "string"
+      },
+      {
+        name: "date",
+        description: "Optional document date (YYYY-MM-DD).",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "documents reprocess",
+    group: "captable",
+    description: "Reprocess a document through the extraction pipeline.",
+    usage: "captable-ai documents reprocess --s3-asset-id ID [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "s3-asset-id",
+        description: "S3 asset ID of the document to reprocess.",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "retrigger-validation",
+    group: "captable",
+    description: "Force-retrigger OCF validation for the active company, bypassing the pending-documents check. Use when validation appears stuck.",
+    usage: "captable-ai retrigger-validation [--json]",
+    requiresAuth: true,
+    requiresPortal: true
+  },
+  {
+    name: "pro-forma run",
+    group: "captable",
+    description: "Run a pro-forma cap table scenario: financing round, convertible conversion, warrant exercise, or option pool expansion.",
+    usage: "captable-ai pro-forma run <type> [flags] [--json]\n  Types: financing, convertible, warrant, option-pool",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      { name: "pre-money", description: "Pre-money valuation (financing).", type: "number" },
+      { name: "amount", description: "Investment amount (financing).", type: "number" },
+      { name: "class-name", description: "New stock class name (financing).", type: "string" },
+      { name: "investor", description: "Lead investor name (financing).", type: "string" },
+      {
+        name: "pool-expansion",
+        description: "Target option pool % of post-money (financing).",
+        type: "number"
+      },
+      {
+        name: "pool-timing",
+        description: "PRE_MONEY or POST_MONEY (financing).",
+        type: "string",
+        enum: ["PRE_MONEY", "POST_MONEY"]
+      },
+      {
+        name: "trigger-valuation",
+        description: "Valuation triggering conversion (convertible).",
+        type: "number"
+      },
+      {
+        name: "include-interest",
+        description: "Include accrued interest for notes (convertible).",
+        type: "boolean"
+      },
+      { name: "exercise-all", description: "Exercise all warrants (warrant).", type: "boolean" },
+      {
+        name: "security-ids",
+        description: "Comma-separated security IDs (convertible, warrant).",
+        type: "string"
+      },
+      {
+        name: "target-percentage",
+        description: "Target pool % of fully diluted (option-pool).",
+        type: "number"
+      },
+      {
+        name: "additional-shares",
+        description: "Fixed shares to add (option-pool).",
+        type: "number"
+      }
+    ]
+  },
+  {
+    name: "jobs list",
+    group: "jobs",
+    description: "List tracked async jobs (extraction, validation) from the local job tracker.",
+    usage: "captable-ai jobs list [--status submitted|running|complete|failed] [--json]",
+    requiresAuth: false,
+    requiresPortal: false,
+    flags: [
+      {
+        name: "status",
+        description: "Filter by job status.",
+        type: "string",
+        enum: ["submitted", "running", "complete", "failed"]
+      }
+    ]
+  },
+  {
+    name: "jobs get",
+    group: "jobs",
+    description: "Check current status of a tracked job by polling the API and updating the local tracker.",
+    usage: "captable-ai jobs get <job-id> [--json]",
+    requiresAuth: true,
+    requiresPortal: false
+  },
+  {
+    name: "jobs prune",
+    group: "jobs",
+    description: "Remove completed/failed jobs older than 7 days (or --before date) from the local tracker.",
+    usage: "captable-ai jobs prune [--before YYYY-MM-DD] [--json]",
+    requiresAuth: false,
+    requiresPortal: false,
+    flags: [
+      {
+        name: "before",
+        description: "Remove jobs submitted before this date (YYYY-MM-DD).",
+        type: "string"
+      }
+    ]
+  },
+  {
+    name: "profile list",
+    group: "profile",
+    description: "List saved configuration profiles.",
+    usage: "captable-ai profile list [--json]",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "profile get",
+    group: "profile",
+    description: "Show a profile's configuration.",
+    usage: "captable-ai profile get <name> [--json]",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "profile save",
+    group: "profile",
+    description: "Create or update a named profile.",
+    usage: "captable-ai profile save <name> --company=<id> [--stage=<s>] [--json]",
+    requiresAuth: false,
+    requiresPortal: false,
+    flags: [
+      { name: "company", description: "Company (portal) ID for this profile.", type: "string" },
+      {
+        name: "stage",
+        description: "Stage override.",
+        type: "string",
+        enum: ["dev", "staging", "production", "local"]
       }
-    }
-  }
-  return handleResponse(res, softFail);
-}
-function exitCodeForStatus(status) {
-  if (status === 400) return EXIT.VALIDATION;
-  if (status === 401 || status === 403) return EXIT.AUTH;
-  if (status === 404) return EXIT.NOT_FOUND;
-  if (status === 409) return EXIT.CONFLICT;
-  if (status === 422) return EXIT.VALIDATION;
-  if (status >= 500) return EXIT.SERVER_ERROR;
-  return EXIT.SERVER_ERROR;
-}
-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) {
-      failRequest(
-        softFail,
-        `HTTP ${res.status}: ${text.slice(0, 200)}`,
-        `HTTP_${res.status}`,
-        void 0,
-        exitCodeForStatus(res.status)
-      );
-    }
-    return { data: text };
-  }
-  if (!res.ok) {
-    const exitCode = exitCodeForStatus(res.status);
-    const obj = isRecord2(parsed) ? parsed : {};
-    const nested = obj.error;
-    if (isRecord2(nested)) {
-      const code = typeof nested.code === "string" && nested.code.trim() ? nested.code : void 0;
-      const details = coerceDetails(nested.details);
-      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);
-      failRequest(softFail, nested, code, details, exitCode);
-    }
-    failRequest(
-      softFail,
-      `HTTP ${res.status}: ${text.slice(0, 200)}`,
-      void 0,
-      void 0,
-      exitCode
-    );
-  }
-  return parsed;
-}
-
-// src/flags.ts
-function looksLikeFlag(value) {
-  if (!value.startsWith("-")) return false;
-  if (value === "-" || /^-\d+(?:\.\d+)?$/.test(value)) return false;
-  return true;
-}
-function parseArgs(argv) {
-  const positional = [];
-  const positionalIndexes = [];
-  const flags = {};
-  const flagValueSources = {};
-  const flagValueIndexes = {};
-  const boolean4 = /* @__PURE__ */ new Set();
-  let i = 0;
-  while (i < argv.length) {
-    const arg = argv[i];
-    if (arg.startsWith("--")) {
-      const eqIdx = arg.indexOf("=");
-      if (eqIdx !== -1) {
-        const key = arg.slice(2, eqIdx);
-        flags[key] = arg.slice(eqIdx + 1);
-        flagValueSources[key] = "equals";
-        flagValueIndexes[key] = i;
-      } else {
-        const key = arg.slice(2);
-        const next = argv[i + 1];
-        if (next !== void 0 && !looksLikeFlag(next)) {
-          flags[key] = next;
-          flagValueSources[key] = "next";
-          flagValueIndexes[key] = i + 1;
-          i++;
-        } else {
-          boolean4.add(key);
-        }
+    ]
+  },
+  {
+    name: "profile delete",
+    group: "profile",
+    description: "Remove a saved profile.",
+    usage: "captable-ai profile delete <name> [--json]",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "profile use",
+    group: "profile",
+    description: "Set a profile as the default.",
+    usage: "captable-ai profile use <name> [--json]",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "feedback",
+    group: "feedback",
+    description: "Record CLI friction feedback locally.",
+    usage: 'captable-ai feedback "<message>" [--json]',
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "feedback list",
+    group: "feedback",
+    description: "List recorded feedback entries.",
+    usage: "captable-ai feedback list [--json]",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "feedback send",
+    group: "feedback",
+    description: "POST unsent feedback to upstream endpoint (requires CAPTABLE_AI_FEEDBACK_URL).",
+    usage: "captable-ai feedback send [--json]",
+    requiresAuth: false,
+    requiresPortal: false
+  },
+  {
+    name: "logs list",
+    group: "logs",
+    description: "List OCF agent log entries (expert/validator runs) for the active portal. Requires Fairmint super-admin.",
+    usage: "captable-ai logs list [--agent-type expert|validator] [--limit N] [--cursor C] [--json]",
+    requiresAuth: true,
+    requiresPortal: true,
+    flags: [
+      {
+        name: "agent-type",
+        description: "Filter by agent type.",
+        type: "string",
+        enum: ["expert", "validator"]
+      },
+      { name: "limit", description: "Page size (1\u2013200, default 50).", type: "number" },
+      {
+        name: "cursor",
+        description: "Pagination cursor from a previous response.",
+        type: "string"
       }
-    } else {
-      positional.push(arg);
-      positionalIndexes.push(i);
-    }
-    i++;
+    ]
+  },
+  {
+    name: "commands",
+    group: "commands",
+    description: "List all available commands (machine-readable JSON).",
+    usage: "captable-ai commands",
+    requiresAuth: false,
+    requiresPortal: false
   }
-  return { positional, positionalIndexes, flags, flagValueSources, flagValueIndexes, boolean: boolean4 };
-}
-function hasFlag(args, name) {
-  return args.boolean.has(name) || name in args.flags;
-}
-function getFlagValue(args, name) {
-  return args.flags[name];
-}
-function argvRequestsHelp(argv) {
-  if (argv.includes("--help") || argv.includes("-h")) return true;
-  return argv[0] === "help";
+];
+async function runCommands(_args) {
+  printJson({ schemaVersion: "10", version: "0.0.1", commands: COMMAND_REGISTRY });
 }
 
 // src/help-text.ts
@@ -17866,16 +17949,25 @@ Options:
 Global:
   --json                 Machine-readable JSON output
   --output <path>        Write JSON response to file (implies --json)`;
-var HELP_REGISTER = `register \u2014 Generate shareholder register PDF (not yet available)
+var HELP_REGISTER = `register \u2014 Generate shareholder register PDF
 
 Usage:
-  captable-ai register [--as-of YYYY-MM-DD] [--json]
+  captable-ai register [--as-of YYYY-MM-DD] [--include-share-class-details]
+                       [--include-transaction-history] [--include-equity-awards] [--json]
 
-NOTE: This endpoint is not yet implemented (returns 501). The PDF engine
-(pdfmake) needs to be ported from the legacy API.
+Returns a presigned S3 download URL for the PDF. By default the register lists
+shareholders of record only (stock holdings); each optional section is off
+unless its flag is passed.
 
 Options:
-  --as-of YYYY-MM-DD     Historical snapshot date (YYYY-MM-DD)
+  --as-of YYYY-MM-DD               Historical snapshot date (YYYY-MM-DD)
+  --include-share-class-details    Add a Share Class Details section
+  --include-transaction-history    Add a Transaction History section
+  --include-equity-awards          Add option grants and other equity awards: an
+                                   Option Grants & Equity Awards section, award
+                                   events in transaction history, and award-only
+                                   holders in Number of Shareholders. Number of
+                                   Record Holders stays stock-only.
 
 Global:
   --json                 Machine-readable JSON output
@@ -21882,42 +21974,6 @@ async function runProfileUse(args) {
   printSuccess(`Default profile set to "${name}".`);
 }
 
-// src/commands/register.ts
-async function runRegister(args) {
-  validateFlags(args, {
-    flags: ["as-of"],
-    booleans: []
-  });
-  const portalId = await getActivePortalId();
-  const asOf = getFlagValue(args, "as-of");
-  const body = {};
-  if (asOf) body.asOf = asOf;
-  const res = await apiRequest(`/${portalId}/register`, {
-    method: "POST",
-    body
-  });
-  if (isJsonMode()) {
-    printJson({ data: res.data });
-    return;
-  }
-  const d = res.data;
-  if (!d) {
-    exitWithError(
-      "Register generation failed \u2014 no data returned.",
-      "ERROR",
-      void 0,
-      EXIT.SERVER_ERROR
-    );
-  }
-  printLine("\n  Shareholder register generated successfully.\n");
-  printKeyValue([
-    ["Download URL", d.downloadUrl],
-    ["Filename", d.filename],
-    ["Expires at", d.expiresAt]
-  ]);
-  printLine();
-}
-
 // src/commands/retrigger-validation.ts
 async function runRetriggerValidation(args) {
   validateFlags(args, { flags: [], booleans: [] });
@@ -22327,7 +22383,8 @@ Export:
 
 Reports:
   register                Generate shareholder register PDF
-                           Options: --as-of YYYY-MM-DD
+                           Options: --as-of YYYY-MM-DD, --include-share-class-details,
+                           --include-transaction-history, --include-equity-awards
 
 Pro-Forma:
   pro-forma run <type>    Model a scenario (financing, convertible, warrant, option-pool)