@thecorporation/cli 26.3.25 → 26.3.32

package/dist/index.js

@@ -678,7 +678,7 @@ var init_config = __esm({
     CONFIG_LOCK_TIMEOUT_MS = 5e3;
     CONFIG_LOCK_RETRY_MS = 25;
     CONFIG_STALE_LOCK_MS = 6e4;
-    MAX_LAST_REFERENCES = 128;
+    MAX_LAST_REFERENCES = 4096;
     TRUSTED_API_HOST_SUFFIXES = ["thecorporation.ai"];
     CONFIG_WAIT_BUFFER = new SharedArrayBuffer(4);
     CONFIG_WAIT_SIGNAL = new Int32Array(CONFIG_WAIT_BUFFER);
@@ -793,6 +793,11 @@ var init_references = __esm({
         this.tracker = new ReferenceTracker(new NodeReferenceStorage(cfg));
       }
       async resolveEntity(ref) {
+        if (ref !== void 0 && ref !== null && !ref.trim()) {
+          throw new Error(
+            "Entity reference is empty or whitespace. If you want the active entity, omit --entity-id entirely."
+          );
+        }
         if (!ref || !ref.trim()) {
           const activeEntityId = getActiveEntityId(this.cfg);
           if (!activeEntityId) {
@@ -907,6 +912,9 @@ var init_references = __esm({
         const records = await this.listRecords(kind, scope);
         return this.tracker.findMatches(kind, query, records);
       }
+      getLastId(kind, entityId) {
+        return getLastReference(this.cfg, kind, entityId);
+      }
       remember(kind, referenceId, entityId) {
         setLastReference(this.cfg, kind, referenceId, entityId);
         updateConfig((cfg) => {
@@ -1063,18 +1071,23 @@ var init_references = __esm({
         if (missing.length === 0) {
           return records;
         }
-        const response = await this.client.syncReferences(
-          kind,
-          missing.map(({ described }) => ({
-            resource_id: described.id,
-            label: described.label
-          })),
-          isEntityScopedKind(kind) ? entityId : void 0
-        );
+        const SYNC_BATCH_SIZE = 400;
         const handleById = /* @__PURE__ */ new Map();
-        for (const reference of response.references) {
-          if (typeof reference.resource_id === "string" && typeof reference.handle === "string") {
-            handleById.set(reference.resource_id, reference.handle);
+        const scopeEntityId = isEntityScopedKind(kind) ? entityId : void 0;
+        for (let i = 0; i < missing.length; i += SYNC_BATCH_SIZE) {
+          const batch = missing.slice(i, i + SYNC_BATCH_SIZE);
+          const response = await this.client.syncReferences(
+            kind,
+            batch.map(({ described }) => ({
+              resource_id: described.id,
+              label: described.label
+            })),
+            scopeEntityId
+          );
+          for (const reference of response.references) {
+            if (typeof reference.resource_id === "string" && typeof reference.handle === "string") {
+              handleById.set(reference.resource_id, reference.handle);
+            }
           }
         }
         for (const { record, described } of missing) {
@@ -1890,7 +1903,7 @@ function printSeatsTable(seats) {
   for (const st of seats) {
     table.push([
       formatReferenceCell("seat", st),
-      s2(st.holder_name ?? st.holder),
+      s2(st.holder_name ?? st.holder ?? st.holder_id),
       s2(st.role),
       s2(st.status)
     ]);
@@ -2164,7 +2177,8 @@ var init_workspace = __esm({
             ctx.writer.error(`Failed to fetch status: ${err}`);
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp status"]
       },
       // --- context / whoami ---
       {
@@ -2236,7 +2250,8 @@ var init_workspace = __esm({
             ctx.writer.error(`Failed to fetch context: ${err}`);
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp context", "corp context --json"]
       },
       // --- use <entity-ref> ---
       {
@@ -2258,7 +2273,8 @@ var init_workspace = __esm({
             ctx.writer.error(`Failed to resolve entity: ${err}`);
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp use", "corp use --json"]
       },
       // --- next ---
       {
@@ -2323,8 +2339,34 @@ var init_workspace = __esm({
               printNextSteps(data);
             }
           } catch (err) {
-            ctx.writer.error(`Failed to fetch next steps: ${err}`);
-            process.exit(1);
+            const msg = String(err);
+            if (msg.includes("Not found") || msg.includes("404")) {
+              if (localItems.length > 0) {
+                const top = localItems[0];
+                const backlog = localItems.slice(1);
+                const summary = { critical: 0, high: 0, medium: 0, low: 0 };
+                for (const item of [top, ...backlog]) {
+                  const key = item.urgency;
+                  if (key in summary) summary[key]++;
+                }
+                const response = { top, backlog, summary };
+                if (opts.json) {
+                  ctx.writer.json(response);
+                } else {
+                  printNextSteps(response);
+                }
+              } else {
+                console.log("No entities found yet. Get started:\n");
+                console.log('  corp form --type c_corp --name "My Company" --member "Name,email,director,100,street|city|state|zip,ceo,true"');
+                console.log("\n  Or use the staged flow:");
+                console.log('  corp form create --type llc --name "My LLC"');
+                console.log('  corp form add-founder @last --name "Alice" --email "a@co.com" --role member --ownership-pct 100');
+                console.log("  corp form finalize @last");
+              }
+            } else {
+              ctx.writer.error(`Failed to fetch next steps: ${err}`);
+              process.exit(1);
+            }
           }
         }
       },
@@ -2345,7 +2387,8 @@ var init_workspace = __esm({
           ]
         },
         optQP: ["tier"],
-        options: [{ flags: "--tier <tier>", description: "Filter by urgency tier" }]
+        options: [{ flags: "--tier <tier>", description: "Filter by urgency tier" }],
+        examples: ["corp obligations"]
       },
       // --- digest ---
       {
@@ -2393,7 +2436,8 @@ var init_workspace = __esm({
             ctx.writer.error(`Failed: ${err}`);
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp digest"]
       },
       // --- billing ---
       {
@@ -2416,7 +2460,8 @@ var init_workspace = __esm({
             ctx.writer.error(`Failed to fetch billing info: ${err}`);
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp billing"]
       },
       // --- billing portal ---
       {
@@ -2437,7 +2482,8 @@ var init_workspace = __esm({
             ctx.writer.error(`Failed to create portal session: ${err}`);
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp billing portal"]
       },
       // --- billing upgrade ---
       {
@@ -2467,7 +2513,24 @@ var init_workspace = __esm({
             ctx.writer.error(`Failed to create checkout session: ${err}`);
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp billing upgrade"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "entities next-steps",
+        description: "View recommended next actions for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/next-steps" },
+        entity: true,
+        display: { title: "Entities Next Steps", cols: ["backlog>Backlog", "summary>Summary", "top>Top"] },
+        examples: ["corp entities next-steps", "corp entities next-steps --json"]
+      },
+      {
+        name: "workspaces next-steps",
+        description: "View recommended next actions across the workspace",
+        route: { method: "GET", path: "/v1/workspaces/{workspace_id}/next-steps" },
+        display: { title: "Workspaces Next Steps", cols: ["backlog>Backlog", "summary>Summary", "top>Top"] },
+        examples: ["corp workspaces next-steps"]
       }
     ];
   }
@@ -2496,6 +2559,7 @@ async function entitiesHandler(ctx) {
 async function entitiesShowHandler(ctx) {
   const entityRef = ctx.positional[0];
   const jsonOutput = !!ctx.opts.json;
+  const quiet = !!ctx.opts.quiet;
   try {
     const resolvedEntityId = await ctx.resolver.resolveEntity(entityRef);
     const entities = await ctx.client.listEntities();
@@ -2505,6 +2569,10 @@ async function entitiesShowHandler(ctx) {
       process.exit(1);
     }
     await ctx.resolver.stabilizeRecord("entity", entity);
+    if (quiet) {
+      console.log(String(entity.entity_id ?? resolvedEntityId));
+      return;
+    }
     if (jsonOutput) {
       printJson(entity);
     } else {
@@ -2705,14 +2773,16 @@ var init_entities = __esm({
       // ── entities ──
       {
         name: "entities",
-        description: "List entities, show detail, convert, or dissolve",
-        handler: entitiesHandler
+        description: "List all entities",
+        handler: entitiesHandler,
+        examples: ["corp entities"]
       },
       {
         name: "entities show",
         description: "Show entity detail",
         args: [{ name: "entity-ref", required: true }],
-        handler: entitiesShowHandler
+        handler: entitiesShowHandler,
+        examples: ["corp entities show"]
       },
       {
         name: "entities convert",
@@ -2723,7 +2793,8 @@ var init_entities = __esm({
           { flags: "--to <type>", description: "Target entity type (llc, c_corp)", required: true },
           { flags: "--jurisdiction <jurisdiction>", description: "New jurisdiction" }
         ],
-        handler: entitiesConvertHandler
+        handler: entitiesConvertHandler,
+        examples: ["corp entities convert <entity-ref> --to 'type'", "corp entities convert --json"]
       },
       {
         name: "entities dissolve",
@@ -2735,7 +2806,8 @@ var init_entities = __esm({
           { flags: "--effective-date <date>", description: "Effective date (ISO 8601)" },
           { flags: "--yes, -y", description: "Skip confirmation prompt" }
         ],
-        handler: entitiesDissolveHandler
+        handler: entitiesDissolveHandler,
+        examples: ["corp entities dissolve <entity-ref> --reason 'reason'", "corp entities dissolve --json"]
       },
       // ── contacts ──
       {
@@ -2747,7 +2819,8 @@ var init_entities = __esm({
           title: "Contacts",
           cols: ["name>Name", "email>Email", "category>Category", "#contact_id>ID"]
         },
-        handler: contactsHandler
+        handler: contactsHandler,
+        examples: ["corp contacts", "corp contacts --json"]
       },
       {
         name: "contacts show",
@@ -2756,7 +2829,8 @@ var init_entities = __esm({
         entity: "query",
         display: { title: "Contact Profile" },
         args: [{ name: "contact-ref", required: true }],
-        handler: contactsShowHandler
+        handler: contactsShowHandler,
+        examples: ["corp contacts show", "corp contacts show --json"]
       },
       {
         name: "contacts add",
@@ -2772,11 +2846,12 @@ var init_entities = __esm({
           { flags: "--address <address>", description: "Mailing address" },
           { flags: "--mailing-address <address>", description: "Alias for --address" },
           { flags: "--phone <phone>", description: "Phone number" },
-          { flags: "--notes <notes>", description: "Notes" }
+          { flags: "--notes <notes>", description: "Additional notes" }
         ],
         handler: contactsAddHandler,
         produces: { kind: "contact" },
-        successTemplate: "Contact created: {name}"
+        successTemplate: "Contact created: {name}",
+        examples: ["corp contacts add --name 'name' --email 'email'", "corp contacts add --json"]
       },
       {
         name: "contacts edit",
@@ -2792,9 +2867,32 @@ var init_entities = __esm({
           { flags: "--address <address>", description: "Mailing address" },
           { flags: "--mailing-address <address>", description: "Alias for --address" },
           { flags: "--phone <phone>", description: "Phone number" },
-          { flags: "--notes <notes>", description: "Notes" }
+          { flags: "--notes <notes>", description: "Additional notes" }
+        ],
+        handler: contactsEditHandler,
+        examples: ["corp contacts edit <contact-ref>", "corp contacts edit --json"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "contacts notification-prefs",
+        description: "View notification preferences for a contact",
+        route: { method: "GET", path: "/v1/contacts/{pos}/notification-prefs" },
+        args: [{ name: "contact-id", required: true, description: "Contact ID" }],
+        display: { title: "Contacts Notification Prefs", cols: ["#contact_id>ID", "email_enabled>Email Enabled", "sms_enabled>Sms Enabled", "@updated_at>Updated At", "webhook_enabled>Webhook Enabled"] },
+        examples: ["corp contacts notification-prefs"]
+      },
+      {
+        name: "contacts update-notification-prefs",
+        description: "View notification preferences for a contact",
+        route: { method: "PATCH", path: "/v1/contacts/{pos}/notification-prefs" },
+        args: [{ name: "contact-id", required: true, description: "Contact ID" }],
+        options: [
+          { flags: "--email-enabled <email-enabled>", description: "Email Enabled" },
+          { flags: "--sms-enabled <sms-enabled>", description: "Sms Enabled" },
+          { flags: "--webhook-enabled <webhook-enabled>", description: "Webhook Enabled" }
         ],
-        handler: contactsEditHandler
+        examples: ["corp contacts notification-prefs <contact-id>", "corp contacts notification-prefs --json"],
+        successTemplate: "Notification Prefs updated"
       }
     ];
   }
@@ -2901,6 +2999,9 @@ async function activateFormationEntity(client, resolver, entityId, options = {})
   for (let i = 0; i < 10; i += 1) {
     const status = String(formation.formation_status ?? "");
     if (status === "active") {
+      if (initialStatus === "active") {
+        steps.push("entity is already active \u2014 no action needed");
+      }
       return {
         entity_id: entityId,
         initial_status: initialStatus,
@@ -2912,7 +3013,9 @@ async function activateFormationEntity(client, resolver, entityId, options = {})
       };
     }
     if (status === "pending") {
-      throw new Error("Formation is still pending. Finalize it before activation.");
+      throw new Error(
+        "Formation is still pending \u2014 finalize before activation.\n  Run: corp form finalize " + entityId
+      );
     }
     if (status === "documents_generated") {
       const signed = await autoSignFormationDocuments(client, resolver, entityId);
@@ -3095,7 +3198,7 @@ function parseLegacyMemberSpec(raw) {
   const parts = raw.split(",").map((p) => p.trim());
   if (parts.length < 3) {
     throw new Error(
-      `Invalid member format: ${raw}. Expected: name,email,role[,pct[,address[,officer_title[,is_incorporator]]]]`
+      `Invalid member format: ${raw}. Expected: name,email,role[,pct[,street|city|state|zip[,officer_title[,is_incorporator]]]]`
     );
   }
   const founder = { name: parts[0], email: parts[1], role: parts[2] };
@@ -3133,6 +3236,28 @@ function readSafeJsonFile(filePath, label) {
     `--${label} must stay inside the current working directory unless CORP_ALLOW_UNSAFE_FILE_INPUT=1 is set.`
   );
 }
+function validateFounders(founders) {
+  const seenEmails = /* @__PURE__ */ new Set();
+  for (const f of founders) {
+    const email = f.email.toLowerCase().trim();
+    if (seenEmails.has(email)) {
+      throw new Error(`Duplicate founder email: ${email}. Each founder must have a unique email address.`);
+    }
+    seenEmails.add(email);
+  }
+  let totalOwnership = 0;
+  for (const f of founders) {
+    if (f.ownership_pct != null) {
+      if (f.ownership_pct <= 0 || f.ownership_pct > 100) {
+        throw new Error(`Invalid ownership_pct ${f.ownership_pct} for ${f.name}. Must be between 0 and 100.`);
+      }
+      totalOwnership += f.ownership_pct;
+    }
+  }
+  if (totalOwnership > 100.000001) {
+    throw new Error(`Total ownership_pct is ${totalOwnership.toFixed(2)}%, which exceeds 100%. Reduce ownership percentages.`);
+  }
+}
 function parseScriptedFounders(opts) {
   const founders = [];
   for (const raw of opts.member ?? []) {
@@ -3158,6 +3283,7 @@ function parseScriptedFounders(opts) {
       founders.push(normalizeFounderInfo(entry));
     }
   }
+  validateFounders(founders);
   return founders;
 }
 async function promptAddress() {
@@ -3371,8 +3497,26 @@ async function formCommand(opts) {
     }
     const { entityType, name, jurisdiction, companyAddress, fiscalYearEnd, sCorpElection } = await phaseEntityDetails(opts, serverCfg, scripted);
     const founders = await phasePeople(opts, entityType, scripted);
+    if (isCorp(entityType) && scripted) {
+      const missing = [];
+      const hasAddress = founders.some((f) => f.address);
+      const hasOfficer = founders.some((f) => f.officer_title);
+      const hasIncorporator = founders.some((f) => f.is_incorporator);
+      if (!hasAddress) missing.push("At least one member with an address (for incorporator filing)");
+      if (!hasOfficer) missing.push("At least one member with --officer-title (for initial board consent)");
+      if (!hasIncorporator && founders.length === 1) {
+      } else if (!hasIncorporator && founders.length > 1) {
+        missing.push("At least one member marked as --incorporator");
+      }
+      if (missing.length > 0) {
+        printError(
+          "C-Corp formation requires:\n" + missing.map((m) => `  - ${m}`).join("\n") + '\n  Example: --member "Name,email,director,100,street|city|state|zip,ceo,true"'
+        );
+        process.exit(1);
+      }
+    }
     const { transferRestrictions, rofr } = await phaseStock(opts, entityType, founders, scripted);
-    if (!opts.quiet) {
+    if (!opts.quiet && !opts.json) {
       printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElection, founders, transferRestrictions, rofr);
     }
     const shouldProceed = scripted ? true : await confirm2({ message: "Proceed with formation?", default: true });
@@ -3418,7 +3562,6 @@ async function formCommand(opts) {
     if (result.entity_id) {
       setActiveEntityId(cfg, String(result.entity_id));
       saveConfig(cfg);
-      console.log(chalk5.dim(`  Active entity set to ${result.entity_id}`));
     }
     if (opts.quiet) {
       const id = result.entity_id ?? result.formation_id;
@@ -3429,6 +3572,9 @@ async function formCommand(opts) {
       printJson(result);
       return;
     }
+    if (result.entity_id) {
+      console.log(chalk5.dim(`  Active entity set to ${result.entity_id}`));
+    }
     printSuccess(`Formation created: ${result.formation_id ?? "OK"}`);
     if (result.entity_id) {
       printReferenceSummary("entity", result, { showReuseHint: true });
@@ -3453,8 +3599,22 @@ async function formCommand(opts) {
       console.log(table.toString());
     }
     if (result.next_action) {
-      console.log(chalk5.yellow(`
+      const entityRef = result.entity_id ? `${result.entity_id}` : "@last:entity";
+      const actionHint = {
+        sign_documents: `corp form activate ${entityRef}`,
+        submit_state_filing: `corp form activate ${entityRef}`,
+        confirm_state_filing: `corp form activate ${entityRef} --filing-id "..."`,
+        apply_for_ein: `corp form activate ${entityRef}`,
+        confirm_ein: `corp form activate ${entityRef} --ein "..."`
+      };
+      const hint = actionHint[result.next_action];
+      if (hint) {
+        console.log(chalk5.yellow(`
+  Next step: ${hint}`));
+      } else {
+        console.log(chalk5.yellow(`
   Next: ${result.next_action}`));
+      }
     }
   } catch (err) {
     if (err instanceof Error && err.message.includes("exit")) throw err;
@@ -3767,6 +3927,12 @@ async function resolveEntityRefForFormCommand2(resolver, entityRef, dryRun) {
 }
 async function formCreateHandler(ctx) {
   const opts = ctx.opts;
+  if (opts.shares || opts.authorizedShares) {
+    ctx.writer.error(
+      "--shares / --authorized-shares is not accepted on form create.\n  Set authorized shares during finalize:\n    corp form finalize @last:entity --authorized-shares 10000000"
+    );
+    process.exit(1);
+  }
   const resolvedType = opts.type;
   const resolvedName = opts.name;
   if (!resolvedType) {
@@ -3800,7 +3966,7 @@ async function formCreateHandler(ctx) {
     if (opts.sCorp !== void 0) payload.s_corp_election = opts.sCorp;
     if (opts.transferRestrictions !== void 0) payload.transfer_restrictions = opts.transferRestrictions;
     if (opts.rofr !== void 0) payload.right_of_first_refusal = opts.rofr;
-    const companyAddress = parseCsvAddress2(opts.companyAddress);
+    const companyAddress = parseCsvAddress2(opts.companyAddress ?? opts.address);
     if (companyAddress) payload.company_address = companyAddress;
     if (ctx.dryRun) {
       printDryRun("formation.create_pending", payload);
@@ -3840,11 +4006,21 @@ async function formAddFounderHandler(ctx) {
   const opts = ctx.opts;
   try {
     const resolvedEntityId = await resolveEntityRefForFormCommand2(ctx.resolver, entityRef, ctx.dryRun);
+    const rawPct = opts.ownershipPct ?? opts.pct;
+    if (!rawPct) {
+      ctx.writer.error("required option '--ownership-pct <percent>' not specified");
+      process.exit(1);
+    }
+    const pctValue = parseFloat(rawPct);
+    if (isNaN(pctValue) || pctValue <= 0 || pctValue > 100) {
+      ctx.writer.error(`--ownership-pct must be between 0 and 100 (e.g. 60 for 60%), got: ${rawPct}`);
+      process.exit(1);
+    }
     const payload = {
       name: opts.name,
       email: opts.email,
       role: opts.role,
-      ownership_pct: parseFloat(opts.pct)
+      ownership_pct: pctValue
     };
     if (opts.officerTitle) payload.officer_title = opts.officerTitle.toLowerCase();
     if (opts.incorporator) payload.is_incorporator = true;
@@ -3997,6 +4173,11 @@ async function formActivateHandler(ctx) {
     }
     console.log(`  Signatures added: ${result.signatures_added}`);
     console.log(`  Documents updated: ${result.documents_signed}`);
+    if (result.final_status === "active") {
+      console.log(chalk6.yellow("\n  Next steps:"));
+      console.log(chalk6.yellow("    corp cap-table              View your cap table"));
+      console.log(chalk6.yellow("    corp next                   See all recommended actions"));
+    }
   } catch (err) {
     printError(`Failed to activate formation: ${err}`);
     process.exit(1);
@@ -4017,15 +4198,15 @@ var init_formation = __esm({
         passThroughOptions: true,
         dryRun: true,
         options: [
-          { flags: "--type <type>", description: "Entity type (llc, c_corp)" },
+          { flags: "--type <type>", description: "Entity type", choices: ["llc", "c_corp", "s_corp"] },
           { flags: "--entity-type <type>", description: "Entity type (alias for --type)" },
           { flags: "--name <name>", description: "Legal name" },
           { flags: "--legal-name <name>", description: "Legal name (alias for --name)" },
           { flags: "--jurisdiction <jurisdiction>", description: "Jurisdiction (e.g. US-DE, US-WY)" },
-          { flags: "--member <member>", description: "Founder as 'name,email,role[,pct[,address[,officer_title[,is_incorporator]]]]' (repeatable)", type: "array", default: [] },
+          { flags: "--member <member>", description: "Founder as 'name,email,role[,pct[,street|city|state|zip[,officer_title[,is_incorporator]]]]' (repeatable)", type: "array", default: [] },
           { flags: "--member-json <json>", description: "Founder JSON object (repeatable)", type: "array", default: [] },
           { flags: "--members-file <path>", description: 'Path to a JSON array of founders or {"members": [...]}' },
-          { flags: "--address <address>", description: "Company address as 'street,city,state,zip'" },
+          { flags: "--address <address>", description: "Company address as 'street,city,state,zip' (required for c_corp)" },
           { flags: "--fiscal-year-end <date>", description: "Fiscal year end (MM-DD)", default: "12-31" },
           { flags: "--s-corp", description: "Elect S-Corp status" },
           { flags: "--transfer-restrictions", description: "Enable transfer restrictions" },
@@ -4036,9 +4217,10 @@ var init_formation = __esm({
         successTemplate: "Entity formed: {legal_name}",
         examples: [
           'corp form --type llc --name "My LLC" --member "Alice,alice@co.com,member,100"',
+          'corp form --type c_corp --name "Acme Inc" --member "Bob,bob@co.com,director,100,123 Main|City|DE|19801,ceo,true"',
           `corp form --type c_corp --name "Acme Inc" --jurisdiction US-DE --member-json '{"name":"Bob","email":"bob@acme.com","role":"director","pct":100}'`,
           'corp form create --type llc --name "My LLC"',
-          'corp form add-founder @last:entity --name "Alice" --email "alice@co.com" --role member --pct 100',
+          'corp form add-founder @last:entity --name "Alice" --email "alice@co.com" --role member --ownership-pct 100',
           "corp form finalize @last:entity",
           "corp form activate @last:entity"
         ]
@@ -4048,7 +4230,7 @@ var init_formation = __esm({
         description: "Create a pending entity (staged flow step 1)",
         dryRun: true,
         options: [
-          { flags: "--type <type>", description: "Entity type (llc, c_corp)" },
+          { flags: "--type <type>", description: "Entity type", choices: ["llc", "c_corp", "s_corp"] },
           { flags: "--name <name>", description: "Legal name" },
           { flags: "--jurisdiction <jurisdiction>", description: "Jurisdiction (e.g. US-DE, US-WY)" },
           { flags: "--registered-agent-name <name>", description: "Registered agent legal name" },
@@ -4058,11 +4240,18 @@ var init_formation = __esm({
           { flags: "--s-corp", description: "Elect S-Corp status" },
           { flags: "--transfer-restrictions", description: "Enable transfer restrictions" },
           { flags: "--rofr", description: "Enable right of first refusal" },
-          { flags: "--company-address <address>", description: "Company address as 'street,city,state,zip'" }
+          { flags: "--company-address <address>", description: "Company address as 'street,city,state,zip'" },
+          { flags: "--address <address>", description: "Company address (alias for --company-address)" },
+          { flags: "--shares <count>", description: "", hidden: true },
+          { flags: "--authorized-shares <count>", description: "", hidden: true }
         ],
         handler: formCreateHandler,
         produces: { kind: "entity", trackEntity: true },
-        successTemplate: "Pending entity created: {legal_name}"
+        successTemplate: "Pending entity created: {legal_name}",
+        examples: [
+          'corp form create --type c_corp --name "Acme Inc" --jurisdiction US-DE --address "123 Main,City,ST,12345"',
+          'corp form create --type llc --name "My LLC" --jurisdiction US-WY'
+        ]
       },
       {
         name: "form add-founder",
@@ -4072,13 +4261,18 @@ var init_formation = __esm({
         options: [
           { flags: "--name <name>", description: "Founder name", required: true },
           { flags: "--email <email>", description: "Founder email", required: true },
-          { flags: "--role <role>", description: "Role: director|officer|manager|member|chair", required: true },
-          { flags: "--pct <pct>", description: "Ownership percentage", required: true },
+          { flags: "--role <role>", description: "Founder role", required: true, choices: ["director", "officer", "manager", "member", "chair"] },
+          { flags: "--ownership-pct <percent>", description: "Ownership percentage (e.g. 60 for 60%)", required: true },
+          { flags: "--pct <percent>", description: "Alias for --ownership-pct" },
           { flags: "--officer-title <title>", description: "Officer title (corporations only)", choices: ["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"] },
           { flags: "--incorporator", description: "Mark as sole incorporator (corporations only)" },
           { flags: "--address <address>", description: "Founder address as 'street,city,state,zip'" }
         ],
-        handler: formAddFounderHandler
+        handler: formAddFounderHandler,
+        examples: [
+          'corp form add-founder @last --name "Alice" --email "alice@co.com" --role director --ownership-pct 60 --officer-title ceo --incorporator',
+          'corp form add-founder @last --name "Bob" --email "bob@co.com" --role member --ownership-pct 40 --address "123 Main|City|ST|12345"'
+        ]
       },
       {
         name: "form finalize",
@@ -4101,7 +4295,8 @@ var init_formation = __esm({
           { flags: "--incorporator-name <name>", description: "Incorporator legal name (overrides founder)" },
           { flags: "--incorporator-address <address>", description: "Incorporator mailing address (overrides founder)" }
         ],
-        handler: formFinalizeHandler
+        handler: formFinalizeHandler,
+        examples: ["corp form finalize"]
       },
       {
         name: "form activate",
@@ -4115,7 +4310,308 @@ var init_formation = __esm({
           { flags: "--receipt-reference <ref>", description: "External receipt reference to record" },
           { flags: "--ein <ein>", description: "EIN to confirm (defaults to a deterministic simulated EIN)" }
         ],
-        handler: formActivateHandler
+        handler: formActivateHandler,
+        examples: ["corp form activate"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "contracts",
+        description: "Generate a contract document",
+        route: { method: "POST", path: "/v1/contracts" },
+        options: [
+          { flags: "--counterparty-name <counterparty-name>", description: "Counterparty Name", required: true },
+          { flags: "--effective-date <effective-date>", description: "Effective Date", required: true },
+          { flags: "--parameters <parameters>", description: "Parameters" },
+          { flags: "--template-type <template-type>", description: "Template type for generated contracts.", required: true, choices: ["consulting_agreement", "employment_offer", "contractor_agreement", "nda", "safe_agreement", "custom"] }
+        ],
+        examples: ["corp contracts --counterparty-name 'counterparty-name' --effective-date 'effective-date' --template-type consulting_agreement", "corp contracts --json"],
+        successTemplate: "Contracts created"
+      },
+      {
+        name: "documents show",
+        description: "View a document by ID",
+        route: { method: "GET", path: "/v1/documents/{pos}" },
+        entity: true,
+        args: [{ name: "document-id", required: true, description: "Document ID" }],
+        display: { title: "Document", cols: ["document_type>Type", "status>Status", "title>Title", "signature_count>Signatures", "@created_at>Created", "#document_id>ID"] },
+        examples: ["corp documents show <document-id>", "corp documents show <document-id> --json"]
+      },
+      {
+        name: "documents amendment-history",
+        description: "View amendment history for a document",
+        route: { method: "GET", path: "/v1/documents/{pos}/amendment-history" },
+        entity: true,
+        args: [{ name: "document-id", required: true, description: "Document ID" }],
+        display: { title: "Documents Amendment History", cols: ["amended_at>Amended At", "description>Description", "version>Version"] },
+        examples: ["corp documents amendment-history", "corp documents amendment-history --json"]
+      },
+      {
+        name: "documents pdf",
+        description: "Download a document as PDF",
+        route: { method: "GET", path: "/v1/documents/{pos}/pdf" },
+        entity: true,
+        args: [{ name: "document-id", required: true, description: "Document ID" }],
+        examples: ["corp documents pdf", "corp documents pdf --json"]
+      },
+      {
+        name: "documents request-copy",
+        description: "Request a certified copy of a document",
+        route: { method: "POST", path: "/v1/documents/{pos}/request-copy" },
+        args: [{ name: "document-id", required: true, description: "Document ID" }],
+        options: [
+          { flags: "--recipient-email <recipient-email>", description: "Recipient Email" }
+        ],
+        examples: ["corp documents request-copy <document-id>", "corp documents request-copy --json"],
+        successTemplate: "Request Copy created"
+      },
+      {
+        name: "entities list",
+        description: "List all entities in the workspace",
+        route: { method: "GET", path: "/v1/entities" },
+        display: { title: "Entities", cols: ["legal_name>Name", "entity_type>Type", "formation_status>Status", "jurisdiction>Jurisdiction", "#entity_id>ID"] },
+        examples: ["corp entities list", "corp entities list --json"]
+      },
+      {
+        name: "entities governance-documents",
+        description: "List governance documents for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance-documents" },
+        entity: true,
+        display: { title: "Entities Governance Documents", cols: ["@created_at>Created At", "#document_id>ID", "document_type>Document Type", "signature_count>Signature Count", "status>Status", "title>Title"] },
+        examples: ["corp entities governance-documents", "corp entities governance-documents --json"]
+      },
+      {
+        name: "entities governance-documents-current",
+        description: "View current governance documents",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance-documents/current" },
+        entity: true,
+        display: { title: "Entities Governance Documents Current", cols: ["@created_at>Created At", "#document_id>ID", "document_type>Document Type", "signature_count>Signature Count", "status>Status", "title>Title"] },
+        examples: ["corp entities governance-documents-current", "corp entities governance-documents-current --json"]
+      },
+      {
+        name: "formations create",
+        description: "View formation status for an entity",
+        route: { method: "POST", path: "/v1/formations" },
+        options: [
+          { flags: "--authorized-shares <authorized-shares>", description: "Number of authorized shares" },
+          { flags: "--company-address <company-address>", description: "Company mailing address" },
+          { flags: "--entity-type <entity-type>", description: "The legal structure of a business entity.", required: true, choices: ["c_corp", "llc"] },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: 'Fiscal year end, e.g. "12-31". Defaults to "12-31".' },
+          { flags: "--formation-date <formation-date>", description: "Optional formation date for importing pre-formed entities." },
+          { flags: "--jurisdiction <jurisdiction>", description: "Jurisdiction (e.g. Delaware, US-DE)", required: true },
+          { flags: "--legal-name <legal-name>", description: "Legal name of the entity", required: true },
+          { flags: "--members <members>", description: "LLC member entries", required: true, type: "array" },
+          { flags: "--par-value <par-value>", description: "Par value per share" },
+          { flags: "--registered-agent-address <registered-agent-address>", description: "Registered agent mailing address" },
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include right of first refusal in bylaws (corp). Default true." },
+          { flags: "--s-corp-election <s-corp-election>", description: "Whether the company will elect S-Corp tax treatment." },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Include transfer restrictions in bylaws (corp). Default true." }
+        ],
+        examples: ["corp formations --entity-type c_corp --jurisdiction 'jurisdiction' --legal-name 'legal-name' --members 'members'", "corp formations --json"],
+        successTemplate: "Formations created"
+      },
+      {
+        name: "formations pending",
+        description: "List entities with pending formations",
+        route: { method: "POST", path: "/v1/formations/pending" },
+        options: [
+          { flags: "--company-address <company-address>", description: "Company mailing address" },
+          { flags: "--entity-type <entity-type>", description: "The legal structure of a business entity.", required: true, choices: ["c_corp", "llc"] },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: "Fiscal year end (e.g. 12-31)" },
+          { flags: "--formation-date <formation-date>", description: "Date of formation (ISO 8601)" },
+          { flags: "--jurisdiction <jurisdiction>", description: "Jurisdiction (e.g. Delaware, US-DE)" },
+          { flags: "--legal-name <legal-name>", description: "Legal name of the entity", required: true },
+          { flags: "--registered-agent-address <registered-agent-address>", description: "Registered agent mailing address" },
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include ROFR in bylaws (true/false)" },
+          { flags: "--s-corp-election <s-corp-election>", description: "S Corp Election" },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Transfer Restrictions" }
+        ],
+        examples: ["corp formations pending --entity-type c_corp --legal-name 'legal-name'", "corp formations pending --json"],
+        successTemplate: "Pending created"
+      },
+      {
+        name: "formations with-cap-table",
+        description: "Create entity with formation and initial cap table",
+        route: { method: "POST", path: "/v1/formations/with-cap-table" },
+        options: [
+          { flags: "--authorized-shares <authorized-shares>", description: "Number of authorized shares" },
+          { flags: "--company-address <company-address>", description: "Company mailing address" },
+          { flags: "--entity-type <entity-type>", description: "The legal structure of a business entity.", required: true, choices: ["c_corp", "llc"] },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: 'Fiscal year end, e.g. "12-31". Defaults to "12-31".' },
+          { flags: "--formation-date <formation-date>", description: "Optional formation date for importing pre-formed entities." },
+          { flags: "--jurisdiction <jurisdiction>", description: "Jurisdiction (e.g. Delaware, US-DE)", required: true },
+          { flags: "--legal-name <legal-name>", description: "Legal name of the entity", required: true },
+          { flags: "--members <members>", description: "LLC member entries", required: true, type: "array" },
+          { flags: "--par-value <par-value>", description: "Par value per share" },
+          { flags: "--registered-agent-address <registered-agent-address>", description: "Registered agent mailing address" },
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include right of first refusal in bylaws (corp). Default true." },
+          { flags: "--s-corp-election <s-corp-election>", description: "Whether the company will elect S-Corp tax treatment." },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Include transfer restrictions in bylaws (corp). Default true." }
+        ],
+        examples: ["corp formations with-cap-table --entity-type c_corp --jurisdiction 'jurisdiction' --legal-name 'legal-name' --members 'members'", "corp formations with-cap-table --json"],
+        successTemplate: "With Cap Table created"
+      },
+      {
+        name: "formations",
+        description: "View formation status for an entity",
+        route: { method: "GET", path: "/v1/formations/{eid}" },
+        entity: true,
+        display: { title: "Formations", cols: ["entity_type>Entity Type", "formation_date>Formation Date", "formation_state>Formation State", "formation_status>Formation Status", "#entity_id>ID"] },
+        examples: ["corp formations", "corp formations --json"]
+      },
+      {
+        name: "formations apply-ein",
+        description: "Submit EIN application",
+        route: { method: "POST", path: "/v1/formations/{eid}/apply-ein" },
+        entity: true,
+        examples: ["corp formations apply-ein"],
+        successTemplate: "Apply Ein created"
+      },
+      {
+        name: "formations ein-confirmation",
+        description: "Confirm EIN received from IRS",
+        route: { method: "POST", path: "/v1/formations/{eid}/ein-confirmation" },
+        entity: true,
+        options: [
+          { flags: "--ein <ein>", description: "Employer Identification Number", required: true }
+        ],
+        examples: ["corp formations ein-confirmation --ein 'ein'"],
+        successTemplate: "Ein Confirmation created"
+      },
+      {
+        name: "formations filing-attestation",
+        description: "Attest to filing accuracy",
+        route: { method: "POST", path: "/v1/formations/{eid}/filing-attestation" },
+        entity: true,
+        options: [
+          { flags: "--consent-text <consent-text>", description: "Consent Text" },
+          { flags: "--notes <notes>", description: "Additional notes" },
+          { flags: "--signer-email <signer-email>", description: "Signer Email", required: true },
+          { flags: "--signer-name <signer-name>", description: "Signer Name", required: true },
+          { flags: "--signer-role <signer-role>", description: "Signer Role", required: true }
+        ],
+        examples: ["corp formations filing-attestation --signer-email 'signer-email' --signer-name 'signer-name' --signer-role 'signer-role'", "corp formations filing-attestation --json"],
+        successTemplate: "Filing Attestation created"
+      },
+      {
+        name: "formations filing-confirmation",
+        description: "Confirm state filing received",
+        route: { method: "POST", path: "/v1/formations/{eid}/filing-confirmation" },
+        entity: true,
+        options: [
+          { flags: "--external-filing-id <external-filing-id>", description: "External Filing Id", required: true },
+          { flags: "--receipt-reference <receipt-reference>", description: "Receipt Reference" }
+        ],
+        examples: ["corp formations filing-confirmation --external-filing-id 'external-filing-id'", "corp formations filing-confirmation --json"],
+        successTemplate: "Filing Confirmation created"
+      },
+      {
+        name: "formations finalize",
+        description: "Finalize a formation (lock documents)",
+        route: { method: "POST", path: "/v1/formations/{eid}/finalize" },
+        entity: true,
+        options: [
+          { flags: "--authorized-shares <authorized-shares>", description: "Number of authorized shares" },
+          { flags: "--board-size <board-size>", description: "Board Size" },
+          { flags: "--company-address <company-address>", description: "Company mailing address" },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: "Fiscal year end (e.g. 12-31)" },
+          { flags: "--formation-date <formation-date>", description: "Date of formation (ISO 8601)" },
+          { flags: "--incorporator-address <incorporator-address>", description: "Incorporator Address" },
+          { flags: "--incorporator-name <incorporator-name>", description: "Incorporator Name" },
+          { flags: "--par-value <par-value>", description: "Par value per share" },
+          { flags: "--principal-name <principal-name>", description: "Principal Name" },
+          { flags: "--registered-agent-address <registered-agent-address>", description: "Registered agent mailing address" },
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include ROFR in bylaws (true/false)" },
+          { flags: "--s-corp-election <s-corp-election>", description: "S Corp Election" },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Transfer Restrictions" }
+        ],
+        examples: ["corp formations finalize", "corp formations finalize --json"],
+        successTemplate: "Finalize created"
+      },
+      {
+        name: "formations founders",
+        description: "Add founders to a formation",
+        route: { method: "POST", path: "/v1/formations/{eid}/founders" },
+        entity: true,
+        options: [
+          { flags: "--address <address>", description: "Address" },
+          { flags: "--email <email>", description: "Email" },
+          { flags: "--is-incorporator <is-incorporator>", description: "Is Incorporator" },
+          { flags: "--name <name>", description: "Display name", required: true },
+          { flags: "--officer-title <officer-title>", description: "Officer Title", choices: ["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"] },
+          { flags: "--ownership-pct <ownership-pct>", description: "Ownership Pct" },
+          { flags: "--role <role>", description: "Role", choices: ["director", "officer", "manager", "member", "chair"] }
+        ],
+        examples: ["corp formations founders --name ceo", "corp formations founders --json"],
+        successTemplate: "Founders created"
+      },
+      {
+        name: "formations gates",
+        description: "View formation gate status (checklist)",
+        route: { method: "GET", path: "/v1/formations/{eid}/gates" },
+        entity: true,
+        display: { title: "Formations Gates", cols: ["attestation_recorded>Attestation Recorded", "designated_attestor_email>Designated Attestor Email", "designated_attestor_name>Designated Attestor Name", "designated_attestor_role>Designated Attestor Role", "#entity_id>ID"] },
+        examples: ["corp formations gates", "corp formations gates --json"]
+      },
+      {
+        name: "formations mark-documents-signed",
+        description: "Mark formation documents as signed",
+        route: { method: "POST", path: "/v1/formations/{eid}/mark-documents-signed" },
+        entity: true,
+        examples: ["corp formations mark-documents-signed"],
+        successTemplate: "Mark Documents Signed created"
+      },
+      {
+        name: "formations registered-agent-consent-evidence",
+        description: "Provide registered agent consent evidence",
+        route: { method: "POST", path: "/v1/formations/{eid}/registered-agent-consent-evidence" },
+        entity: true,
+        options: [
+          { flags: "--evidence-type <evidence-type>", description: "Evidence Type" },
+          { flags: "--evidence-uri <evidence-uri>", description: "Evidence Uri", required: true },
+          { flags: "--notes <notes>", description: "Additional notes" }
+        ],
+        examples: ["corp formations registered-agent-consent-evidence --evidence-uri 'evidence-uri'", "corp formations registered-agent-consent-evidence --json"],
+        successTemplate: "Registered Agent Consent Evidence created"
+      },
+      {
+        name: "formations service-agreement-execute",
+        description: "Execute the service agreement",
+        route: { method: "POST", path: "/v1/formations/{eid}/service-agreement/execute" },
+        entity: true,
+        options: [
+          { flags: "--contract-id <contract-id>", description: "Contract Id" },
+          { flags: "--document-id <document-id>", description: "Document ID" },
+          { flags: "--notes <notes>", description: "Additional notes" }
+        ],
+        examples: ["corp formations service-agreement-execute", "corp formations service-agreement-execute --json"],
+        successTemplate: "Service Agreement Execute created"
+      },
+      {
+        name: "formations submit-filing",
+        description: "Submit state filing for a formation",
+        route: { method: "POST", path: "/v1/formations/{eid}/submit-filing" },
+        entity: true,
+        examples: ["corp formations submit-filing"],
+        successTemplate: "Submit Filing created"
+      },
+      {
+        name: "governance catalog",
+        description: "Browse the governance document catalog",
+        route: { method: "GET", path: "/v1/governance/catalog" },
+        display: { title: "Governance Catalog", cols: ["categories>Categories"] },
+        examples: ["corp governance catalog"]
+      },
+      {
+        name: "governance catalog-markdown",
+        description: "View a governance document in markdown",
+        route: { method: "GET", path: "/v1/governance/catalog/{pos}/markdown" },
+        args: [{ name: "document-id", required: true, description: "Document ID" }],
+        display: { title: "Governance Catalog Markdown", cols: ["category>Category", "entity_scope>Entity Scope", "id>Id", "markdown>Markdown", "title>Title", "variants>Variants"] },
+        examples: ["corp governance catalog-markdown"]
       }
     ];
   }
@@ -4158,7 +4654,16 @@ var init_cap_table = __esm({
         },
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
-          const data = await ctx.client.getCapTable(eid);
+          let data;
+          try {
+            data = await ctx.client.getCapTable(eid);
+          } catch (err) {
+            const msg = String(err);
+            if (msg.includes("no linked legal entity") || msg.includes("Not found")) {
+              throw new Error("No cap table found. Finalize formation first: corp form finalize " + eid);
+            }
+            throw err;
+          }
           const instruments = Array.isArray(data.instruments) ? data.instruments : [];
           const shareClasses = Array.isArray(data.share_classes) ? data.share_classes : [];
           await ctx.resolver.stabilizeRecords("instrument", instruments, eid);
@@ -4189,7 +4694,7 @@ var init_cap_table = __esm({
       // --- cap-table safes ---
       {
         name: "cap-table safes",
-        description: "SAFE notes",
+        description: "List SAFE notes",
         route: { method: "GET", path: "/v1/entities/{eid}/safe-notes" },
         entity: true,
         display: {
@@ -4209,7 +4714,8 @@ var init_cap_table = __esm({
             return;
           }
           printSafesTable(safes);
-        }
+        },
+        examples: ["corp cap-table safes", "corp cap-table safes --json"]
       },
       // --- cap-table transfers ---
       {
@@ -4234,7 +4740,8 @@ var init_cap_table = __esm({
             return;
           }
           printTransfersTable(transfers);
-        }
+        },
+        examples: ["corp cap-table transfers", "corp cap-table transfers --json"]
       },
       // --- cap-table instruments ---
       {
@@ -4261,12 +4768,13 @@ var init_cap_table = __esm({
             return;
           }
           printInstrumentsTable(instruments);
-        }
+        },
+        examples: ["corp cap-table instruments", "corp cap-table instruments --json"]
       },
       // --- cap-table share-classes ---
       {
         name: "cap-table share-classes",
-        description: "Share classes",
+        description: "List share classes",
         route: { method: "GET", path: "/v1/entities/{eid}/cap-table" },
         entity: true,
         display: {
@@ -4288,7 +4796,8 @@ var init_cap_table = __esm({
             return;
           }
           printShareClassesTable(shareClasses);
-        }
+        },
+        examples: ["corp cap-table share-classes", "corp cap-table share-classes --json"]
       },
       // --- cap-table rounds ---
       {
@@ -4313,7 +4822,8 @@ var init_cap_table = __esm({
             return;
           }
           printRoundsTable(rounds);
-        }
+        },
+        examples: ["corp cap-table rounds", "corp cap-table rounds --json"]
       },
       // --- cap-table valuations ---
       {
@@ -4338,7 +4848,8 @@ var init_cap_table = __esm({
             return;
           }
           printValuationsTable(valuations);
-        }
+        },
+        examples: ["corp cap-table valuations", "corp cap-table valuations --json"]
       },
       // --- cap-table 409a ---
       {
@@ -4388,7 +4899,8 @@ var init_cap_table = __esm({
             }
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp cap-table 409a", "corp cap-table 409a --json"]
       },
       // --- cap-table control-map ---
       {
@@ -4429,7 +4941,8 @@ var init_cap_table = __esm({
             return;
           }
           ctx.writer.json(result);
-        }
+        },
+        examples: ["corp cap-table control-map", "corp cap-table control-map --json"]
       },
       // --- cap-table dilution ---
       {
@@ -4454,7 +4967,8 @@ var init_cap_table = __esm({
             console.log(chalk7.dim("  For scenario modeling, create a new round with: corp cap-table start-round --name '...' --issuer-legal-entity-id '...'"));
           }
           ctx.writer.json(result);
-        }
+        },
+        examples: ["corp cap-table dilution", "corp cap-table dilution --json"]
       },
       // --- cap-table create-instrument ---
       {
@@ -4507,7 +5021,8 @@ var init_cap_table = __esm({
           printReferenceSummary("instrument", result, { showReuseHint: true });
         },
         produces: { kind: "instrument" },
-        successTemplate: "Instrument created: {symbol}"
+        successTemplate: "Instrument created: {symbol}",
+        examples: ["corp cap-table create-instrument --kind 'kind' --symbol 'symbol'", "corp cap-table create-instrument --json"]
       },
       // --- cap-table issue-equity ---
       {
@@ -4583,7 +5098,11 @@ var init_cap_table = __esm({
           }
         },
         produces: { kind: "round" },
-        successTemplate: "Equity issued: {round_name}"
+        successTemplate: "Equity issued: {round_name}",
+        examples: [
+          'corp cap-table issue-equity --grant-type common --shares 50000 --recipient "Alice Smith"',
+          'corp cap-table issue-equity --grant-type iso --shares 10000 --recipient "Bob" --email "bob@co.com"'
+        ]
       },
       // --- cap-table issue-safe ---
       {
@@ -4594,20 +5113,32 @@ var init_cap_table = __esm({
         dryRun: true,
         options: [
           { flags: "--investor <name>", description: "Investor name", required: true },
-          { flags: "--amount-cents <n>", description: "Principal amount in cents (e.g. 5000000000 = $50M)", required: true, type: "int" },
-          { flags: "--amount <n>", description: "", type: "int" },
-          { flags: "--safe-type <type>", description: "SAFE type", default: "post_money" },
-          { flags: "--valuation-cap-cents <n>", description: "Valuation cap in cents (e.g. 1000000000 = $10M)", required: true, type: "int" },
-          { flags: "--valuation-cap <n>", description: "", type: "int" },
+          { flags: "--amount-cents <n>", description: "Principal amount in cents (e.g. 50000000 = $500,000)", type: "int" },
+          { flags: "--amount <n>", description: "Amount in dollars (alternative to --amount-cents)", type: "int" },
+          { flags: "--safe-type <type>", description: "SAFE type", default: "post_money", choices: ["post_money", "pre_money", "mfn"] },
+          { flags: "--valuation-cap-cents <n>", description: "Valuation cap in cents (e.g. 100000000 = $1M)", type: "int" },
+          { flags: "--valuation-cap <n>", description: "Valuation cap in dollars (alternative to --valuation-cap-cents)", type: "int" },
           { flags: "--meeting-id <ref>", description: "Board meeting reference required when issuing under a board-governed entity" },
           { flags: "--resolution-id <ref>", description: "Board resolution reference required when issuing under a board-governed entity" }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const investor = ctx.opts.investor;
-          const amountCents = ctx.opts.amountCents ?? ctx.opts.amount;
+          if (ctx.opts.amountCents != null && ctx.opts.amount != null) {
+            throw new Error("--amount-cents and --amount are mutually exclusive. Use one or the other.");
+          }
+          const amountCents = ctx.opts.amountCents != null ? ctx.opts.amountCents : ctx.opts.amount != null ? ctx.opts.amount * 100 : void 0;
+          if (amountCents == null) {
+            throw new Error("required option '--amount-cents <n>' or '--amount <n>' not specified");
+          }
           const safeType = ctx.opts.safeType ?? "post_money";
-          const valuationCapCents = ctx.opts.valuationCapCents ?? ctx.opts.valuationCap;
+          if (ctx.opts.valuationCapCents != null && ctx.opts.valuationCap != null) {
+            throw new Error("--valuation-cap-cents and --valuation-cap are mutually exclusive. Use one or the other.");
+          }
+          const valuationCapCents = ctx.opts.valuationCapCents != null ? ctx.opts.valuationCapCents : ctx.opts.valuationCap != null ? ctx.opts.valuationCap * 100 : void 0;
+          if (valuationCapCents == null) {
+            throw new Error("required option '--valuation-cap-cents <n>' or '--valuation-cap <n>' not specified");
+          }
           const email = ctx.opts.email;
           const optMeetingId = ctx.opts.meetingId;
           const optResolutionId = ctx.opts.resolutionId;
@@ -4650,7 +5181,8 @@ var init_cap_table = __esm({
           printReferenceSummary("safe_note", result.data, { showReuseHint: true });
         },
         produces: { kind: "safe_note" },
-        successTemplate: "SAFE created: {investor_name}"
+        successTemplate: "SAFE created: {investor_name}",
+        examples: ["corp cap-table issue-safe --investor 'name' --amount-cents 'n' --valuation-cap-cents 'n'", "corp cap-table issue-safe --json"]
       },
       // --- cap-table transfer ---
       {
@@ -4663,9 +5195,9 @@ var init_cap_table = __esm({
           { flags: "--from <ref>", description: "Source contact reference (from_contact_id)", required: true },
           { flags: "--to <ref>", description: "Destination contact reference (to_contact_id)", required: true },
           { flags: "--shares <n>", description: "Number of shares to transfer", required: true, type: "int" },
-          { flags: "--share-class-id <ref>", description: "Share class reference", required: true },
-          { flags: "--governing-doc-type <type>", description: "Governing doc type (bylaws, operating_agreement, shareholder_agreement, other)", required: true },
-          { flags: "--transferee-rights <rights>", description: "Transferee rights (full_member, economic_only, limited)", required: true },
+          { flags: "--share-class-id <ref>", description: "Share class reference (auto-resolved if only one exists)" },
+          { flags: "--governing-doc-type <type>", description: "Governing doc type (bylaws, operating_agreement, shareholder_agreement, other)", default: "bylaws" },
+          { flags: "--transferee-rights <rights>", description: "Transferee rights (full_member, economic_only, limited)", default: "full_member" },
           { flags: "--prepare-intent-id <id>", description: "Prepare intent ID (auto-created if omitted)" },
           { flags: "--type <type>", description: "Transfer type (gift, trust_transfer, secondary_sale, estate, other)", default: "secondary_sale" },
           { flags: "--price-per-share-cents <n>", description: "Price per share in cents", type: "int" },
@@ -4675,7 +5207,21 @@ var init_cap_table = __esm({
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const fromContactId = await ctx.resolver.resolveContact(eid, ctx.opts.from);
           const toContactId = await ctx.resolver.resolveContact(eid, ctx.opts.to);
-          const shareClassId = await ctx.resolver.resolveShareClass(eid, ctx.opts.shareClassId);
+          let shareClassId;
+          if (ctx.opts.shareClassId) {
+            shareClassId = await ctx.resolver.resolveShareClass(eid, ctx.opts.shareClassId);
+          } else {
+            const capTable = await ctx.client.getCapTable(eid);
+            const instruments = capTable.instruments ?? [];
+            const classIds = [...new Set(instruments.map((i) => i.share_class_id).filter(Boolean))];
+            if (classIds.length === 1) {
+              shareClassId = classIds[0];
+            } else if (classIds.length === 0) {
+              throw new Error("No share classes found. Create one first or specify --share-class-id.");
+            } else {
+              throw new Error(`Multiple share classes found (${classIds.length}). Specify --share-class-id to disambiguate.`);
+            }
+          }
           const shares = ctx.opts.shares;
           const pricePerShareCents = ctx.opts.pricePerShareCents;
           const relationship = ctx.opts.relationship;
@@ -4738,7 +5284,8 @@ var init_cap_table = __esm({
           printReferenceSummary("share_transfer", result, { label: "Transfer Ref:", showReuseHint: true });
         },
         produces: { kind: "share_transfer" },
-        successTemplate: "Transfer created"
+        successTemplate: "Transfer created",
+        examples: ["corp cap-table transfer --from 'ref' --to 'ref' --shares 'n' --share-class-id 'ref' --governing-doc-type 'type' --transferee-rights 'rights'", "corp cap-table transfer --json"]
       },
       // --- cap-table distribute ---
       {
@@ -4749,13 +5296,19 @@ var init_cap_table = __esm({
         dryRun: true,
         options: [
           { flags: "--amount-cents <n>", description: "Total distribution amount in cents (e.g. 100000 = $1,000.00)", required: true, type: "int" },
-          { flags: "--amount <n>", description: "", type: "int" },
+          { flags: "--amount <n>", description: "Amount in dollars (alternative to --amount-cents)", type: "int" },
           { flags: "--type <type>", description: "Distribution type (dividend, return, liquidation)", default: "dividend" },
           { flags: "--description <desc>", description: "Distribution description", required: true }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
-          const amountCents = ctx.opts.amountCents ?? ctx.opts.amount;
+          if (ctx.opts.amountCents != null && ctx.opts.amount != null) {
+            throw new Error("--amount-cents and --amount are mutually exclusive. Use one or the other.");
+          }
+          const amountCents = ctx.opts.amountCents != null ? ctx.opts.amountCents : ctx.opts.amount != null ? ctx.opts.amount * 100 : void 0;
+          if (amountCents == null) {
+            throw new Error("required option '--amount-cents <n>' or '--amount <n>' not specified");
+          }
           const distributionType = ctx.opts.type ?? "dividend";
           const description = ctx.opts.description;
           const payload = {
@@ -4777,7 +5330,8 @@ var init_cap_table = __esm({
           }
           ctx.writer.success(`Distribution calculated: ${result.distribution_id ?? "OK"}`);
           printReferenceSummary("distribution", result, { showReuseHint: true });
-        }
+        },
+        examples: ["corp cap-table distribute --amount-cents 'n' --description 'desc'", "corp cap-table distribute --json"]
       },
       // --- cap-table start-round ---
       {
@@ -4788,11 +5342,19 @@ var init_cap_table = __esm({
         dryRun: true,
         options: [
           { flags: "--name <name>", description: "Round name", required: true },
-          { flags: "--issuer-legal-entity-id <ref>", description: "Issuer legal entity reference", required: true }
+          { flags: "--issuer-legal-entity-id <ref>", description: "Issuer legal entity reference (auto-resolved from cap table if omitted)" }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
-          const issuerLegalEntityId = await ctx.resolver.resolveEntity(ctx.opts.issuerLegalEntityId);
+          let issuerLegalEntityId = ctx.opts.issuerLegalEntityId;
+          if (!issuerLegalEntityId) {
+            const capTable = await ctx.client.getCapTable(eid);
+            issuerLegalEntityId = capTable.issuer_legal_entity_id;
+          }
+          if (!issuerLegalEntityId) {
+            throw new Error("No issuer legal entity found. Provide --issuer-legal-entity-id or ensure the entity has a cap table.");
+          }
+          issuerLegalEntityId = await ctx.resolver.resolveEntity(issuerLegalEntityId);
           const payload = {
             entity_id: eid,
             name: ctx.opts.name,
@@ -4813,7 +5375,8 @@ var init_cap_table = __esm({
           printReferenceSummary("round", result, { showReuseHint: true });
         },
         produces: { kind: "round" },
-        successTemplate: "Round started: {round_name}"
+        successTemplate: "Round started: {round_name}",
+        examples: ["corp cap-table start-round --name 'name' --issuer-legal-entity-id 'ref'"]
       },
       // --- cap-table add-security ---
       {
@@ -4856,7 +5419,8 @@ var init_cap_table = __esm({
             return;
           }
           ctx.writer.success(`Security added for ${ctx.opts.recipientName}`);
-        }
+        },
+        examples: ["corp cap-table add-security --round-id 'ref' --instrument-id 'ref' --quantity 'n' --recipient-name 'name'", "corp cap-table add-security --json"]
       },
       // --- cap-table issue-round ---
       {
@@ -4867,8 +5431,8 @@ var init_cap_table = __esm({
         dryRun: true,
         options: [
           { flags: "--round-id <ref>", description: "Round reference", required: true },
-          { flags: "--meeting-id <ref>", description: "Board meeting reference required when issuing under a board-governed entity" },
-          { flags: "--resolution-id <ref>", description: "Board resolution reference required when issuing under a board-governed entity" }
+          { flags: "--meeting-id <ref>", description: "Board meeting reference (required if entity has an active board)" },
+          { flags: "--resolution-id <ref>", description: "Board resolution reference (required if entity has an active board)" }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
@@ -4886,7 +5450,8 @@ var init_cap_table = __esm({
           }
           if ((!meetingId || !resolutionId) && await entityHasActiveBoard(ctx.client, eid)) {
             throw new Error(
-              "Board approval is required before issuing this round. Pass --meeting-id and --resolution-id from a passed board vote."
+              `Board approval is required before issuing this round. Pass --meeting-id and --resolution-id from a passed board vote.
+  Tip: Use 'corp governance quick-approve --text "RESOLVED: ..."' for one-step approval.`
             );
           }
           const body = { entity_id: eid };
@@ -4903,7 +5468,8 @@ var init_cap_table = __esm({
           if (roundMatch) {
             printReferenceSummary("round", roundMatch.raw, { showReuseHint: true });
           }
-        }
+        },
+        examples: ["corp cap-table issue-round --round-id 'ref'", "corp cap-table issue-round --json"]
       },
       // --- cap-table create-valuation ---
       {
@@ -4915,9 +5481,10 @@ var init_cap_table = __esm({
         options: [
           { flags: "--type <type>", description: "Valuation type (four_oh_nine_a, fair_market_value, etc.)", required: true },
           { flags: "--date <date>", description: "Effective date (ISO 8601)", required: true },
-          { flags: "--methodology <method>", description: "Methodology (income, market, asset, backsolve, hybrid)", required: true },
+          { flags: "--methodology <method>", description: "Methodology", required: true, choices: ["income", "market", "asset", "backsolve", "hybrid", "other"] },
           { flags: "--fmv <cents>", description: "FMV per share in cents", type: "int" },
-          { flags: "--enterprise-value <cents>", description: "Enterprise value in cents", type: "int" }
+          { flags: "--enterprise-value <cents>", description: "Enterprise value in cents", type: "int" },
+          { flags: "--auto-approve", description: "Automatically submit and approve the valuation (skips board workflow)" }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
@@ -4936,6 +5503,25 @@ var init_cap_table = __esm({
           const result = await ctx.client.createValuation(body);
           await ctx.resolver.stabilizeRecord("valuation", result, eid);
           ctx.resolver.rememberFromRecord("valuation", result, eid);
+          const valuationId = String(result.valuation_id ?? result.id);
+          if (ctx.opts.autoApprove && valuationId) {
+            try {
+              await ctx.client.submitValuationForApproval(valuationId, eid);
+              const approved = await ctx.client.approveValuation(valuationId, eid);
+              await ctx.resolver.stabilizeRecord("valuation", approved, eid);
+              if (ctx.opts.json) {
+                ctx.writer.json(approved);
+                return;
+              }
+              ctx.writer.success(`Valuation created and approved: ${valuationId}`);
+              printReferenceSummary("valuation", approved, { showReuseHint: true });
+              return;
+            } catch (err) {
+              if (!ctx.opts.json) {
+                ctx.writer.warning(`Auto-approve failed (board approval may be required): ${err}`);
+              }
+            }
+          }
           if (ctx.opts.json) {
             ctx.writer.json(result);
             return;
@@ -4944,7 +5530,8 @@ var init_cap_table = __esm({
           printReferenceSummary("valuation", result, { showReuseHint: true });
         },
         produces: { kind: "valuation" },
-        successTemplate: "Valuation created"
+        successTemplate: "Valuation created",
+        examples: ["corp cap-table create-valuation --type 'type' --date 'date' --methodology 'method'", "corp cap-table create-valuation --json"]
       },
       // --- cap-table submit-valuation <valuation-ref> ---
       {
@@ -5002,7 +5589,8 @@ var init_cap_table = __esm({
             }
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp cap-table submit-valuation <valuation-ref>"]
       },
       // --- cap-table approve-valuation <valuation-ref> ---
       {
@@ -5046,7 +5634,8 @@ var init_cap_table = __esm({
             }
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp cap-table approve-valuation <valuation-ref>", "corp cap-table approve-valuation --json"]
       },
       // --- cap-table preview-conversion ---
       {
@@ -5075,7 +5664,8 @@ var init_cap_table = __esm({
           if (result.shares_issued) console.log(`  Shares to issue: ${result.shares_issued}`);
           if (result.ownership_pct) console.log(`  Post-conversion ownership: ${result.ownership_pct}%`);
           ctx.writer.json(result);
-        }
+        },
+        examples: ["corp cap-table preview-conversion", "corp cap-table preview-conversion --json"]
       },
       // --- cap-table convert ---
       {
@@ -5108,20 +5698,632 @@ var init_cap_table = __esm({
             return;
           }
           ctx.writer.success(`Conversion executed for SAFE ${safeId}`);
-        }
-      }
-    ];
-  }
-});
-
-// src/registry/finance.ts
-function sumAmounts(records, candidates) {
-  return records.reduce((sum, record) => {
-    for (const key of candidates) {
-      if (typeof record[key] === "number" && Number.isFinite(record[key])) {
-        return sum + Number(record[key]);
-      }
-    }
+        },
+        examples: ["corp cap-table convert --safe-id 'ref' --price-per-share-cents 'n'"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "equity control-links",
+        description: "Create a control link between legal entities",
+        route: { method: "POST", path: "/v1/equity/control-links" },
+        entity: true,
+        options: [
+          { flags: "--child-legal-entity-id <child-legal-entity-id>", description: "Child entity in the control relationship", required: true },
+          { flags: "--control-type <control-type>", description: "Type of control relationship.", required: true, choices: ["voting", "board", "economic", "contractual"] },
+          { flags: "--notes <notes>", description: "Additional notes" },
+          { flags: "--parent-legal-entity-id <parent-legal-entity-id>", description: "Parent entity in the control relationship", required: true },
+          { flags: "--voting-power-bps <voting-power-bps>", description: "Voting power in basis points (0-10000)" }
+        ],
+        examples: ["corp equity control-links --child-legal-entity-id voting --control-type voting --parent-legal-entity-id 'parent-legal-entity-id'", "corp equity control-links --json"],
+        successTemplate: "Control Links created"
+      },
+      {
+        name: "equity control-map",
+        description: "View the equity control map",
+        route: { method: "GET", path: "/v1/equity/control-map" },
+        entity: true,
+        display: { title: "Equity Control Map", cols: ["edges>Edges", "#root_entity_id>ID", "traversed_entities>Traversed Entities"] },
+        examples: ["corp equity control-map", "corp equity control-map --json"]
+      },
+      {
+        name: "equity conversions-execute",
+        description: "Execute a SAFE/note conversion into equity",
+        route: { method: "POST", path: "/v1/equity/conversions/execute" },
+        options: [
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID", required: true },
+          { flags: "--round-id <round-id>", description: "Equity round ID", required: true },
+          { flags: "--source-reference <source-reference>", description: "Source reference for the conversion" }
+        ],
+        examples: ["corp equity conversions-execute --intent-id 'intent-id' --round-id 'round-id'", "corp equity conversions-execute --json"],
+        successTemplate: "Conversions Execute created"
+      },
+      {
+        name: "equity conversions-preview",
+        description: "Preview a SAFE/note conversion without executing",
+        route: { method: "POST", path: "/v1/equity/conversions/preview" },
+        entity: true,
+        options: [
+          { flags: "--round-id <round-id>", description: "Equity round ID", required: true },
+          { flags: "--source-reference <source-reference>", description: "Source reference for the conversion" }
+        ],
+        examples: ["corp equity conversions-preview --round-id 'round-id'", "corp equity conversions-preview --json"],
+        successTemplate: "Conversions Preview created"
+      },
+      {
+        name: "equity dilution-preview",
+        description: "Preview dilution impact of a potential issuance",
+        route: { method: "GET", path: "/v1/equity/dilution/preview" },
+        entity: true,
+        display: { title: "Equity Dilution Preview", cols: ["#issuer_legal_entity_id>ID", "pre_round_outstanding_units>Pre Round Outstanding Units", "projected_dilution_bps>Projected Dilution Bps", "projected_new_units>Projected New Units", "projected_post_outstanding_units>Projected Post Outstanding Units", "#round_id>ID"] },
+        examples: ["corp equity dilution-preview", "corp equity dilution-preview --json"]
+      },
+      {
+        name: "equity entities",
+        description: "Register a legal entity in the equity system",
+        route: { method: "POST", path: "/v1/equity/entities" },
+        entity: true,
+        options: [
+          { flags: "--linked-entity-id <linked-entity-id>", description: "ID of the entity to link" },
+          { flags: "--name <name>", description: "Display name", required: true },
+          { flags: "--role <role>", description: "Role this legal entity plays in the ownership/control graph.", required: true, choices: ["operating", "control", "investment", "nonprofit", "spv", "other"] }
+        ],
+        examples: ["corp equity entities --name 'name' --role operating", "corp equity entities --json"],
+        successTemplate: "Entities created"
+      },
+      {
+        name: "equity create-fundraising-workflow",
+        description: "Start or view a fundraising workflow",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows" },
+        options: [
+          { flags: "--conversion-target-instrument-id <conversion-target-instrument-id>", description: "Target instrument for conversion" },
+          { flags: "--issuer-legal-entity-id <issuer-legal-entity-id>", description: "Legal entity issuing the securities", required: true },
+          { flags: "--metadata <metadata>", description: "Additional metadata (JSON)" },
+          { flags: "--name <name>", description: "Display name", required: true },
+          { flags: "--pre-money-cents <pre-money-cents>", description: "Pre-money valuation in cents" },
+          { flags: "--prepare-intent-id <prepare-intent-id>", description: "Execution intent ID for preparation", required: true },
+          { flags: "--round-price-cents <round-price-cents>", description: "Round share price in cents" },
+          { flags: "--target-raise-cents <target-raise-cents>", description: "Target fundraising amount in cents" }
+        ],
+        examples: ["corp equity fundraising-workflows --issuer-legal-entity-id 'issuer-legal-entity-id' --name 'name' --prepare-intent-id 'prepare-intent-id'", "corp equity fundraising-workflows --json"],
+        successTemplate: "Fundraising Workflows created"
+      },
+      {
+        name: "equity fundraising-workflows",
+        description: "Start or view a fundraising workflow",
+        route: { method: "GET", path: "/v1/equity/fundraising-workflows/{pos}" },
+        entity: true,
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        display: { title: "Equity Fundraising Workflows", cols: ["board_packet_documents>Board Packet Documents", "closing_packet_documents>Closing Packet Documents", "@created_at>Created At", "#accept_intent_id>ID"] },
+        examples: ["corp equity fundraising-workflows", "corp equity fundraising-workflows --json"]
+      },
+      {
+        name: "equity fundraising-workflows-apply-terms",
+        description: "Apply term sheet to a fundraising round",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/apply-terms" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--anti-dilution-method <anti-dilution-method>", description: "Anti-dilution protection method", required: true, choices: ["none", "broad_based_weighted_average", "narrow_based_weighted_average", "full_ratchet"] },
+          { flags: "--conversion-precedence <conversion-precedence>", description: "Conversion priority ordering", type: "array" },
+          { flags: "--protective-provisions <protective-provisions>", description: "Protective provision terms" }
+        ],
+        examples: ["corp equity fundraising-workflows-apply-terms <workflow-id> --anti-dilution-method none", "corp equity fundraising-workflows-apply-terms --json"],
+        successTemplate: "Fundraising Workflows Apply Terms created"
+      },
+      {
+        name: "equity fundraising-workflows-compile-packet",
+        description: "Compile the document packet for a fundraising round",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/compile-packet" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--phase <phase>", description: "Workflow phase" },
+          { flags: "--required-signers <required-signers>", description: "List of required signers", type: "array" }
+        ],
+        examples: ["corp equity fundraising-workflows-compile-packet <workflow-id>", "corp equity fundraising-workflows-compile-packet --json"],
+        successTemplate: "Fundraising Workflows Compile Packet created"
+      },
+      {
+        name: "equity fundraising-workflows-finalize",
+        description: "Finalize and close a fundraising workflow",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/finalize" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--phase <phase>", description: "Workflow phase" }
+        ],
+        examples: ["corp equity fundraising-workflows-finalize <workflow-id>", "corp equity fundraising-workflows-finalize --json"],
+        successTemplate: "Fundraising Workflows Finalize created"
+      },
+      {
+        name: "equity fundraising-workflows-generate-board-packet",
+        description: "Generate board approval packet for fundraising",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/generate-board-packet" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--documents <documents>", description: "Document references or content", type: "array" }
+        ],
+        examples: ["corp equity fundraising-workflows-generate-board-packet <workflow-id>", "corp equity fundraising-workflows-generate-board-packet --json"],
+        successTemplate: "Fundraising Workflows Generate Board Packet created"
+      },
+      {
+        name: "equity fundraising-workflows-generate-closing-packet",
+        description: "Generate closing documents for fundraising",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/generate-closing-packet" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--documents <documents>", description: "Document references or content", type: "array" }
+        ],
+        examples: ["corp equity fundraising-workflows-generate-closing-packet <workflow-id>", "corp equity fundraising-workflows-generate-closing-packet --json"],
+        successTemplate: "Fundraising Workflows Generate Closing Packet created"
+      },
+      {
+        name: "equity fundraising-workflows-prepare-execution",
+        description: "Prepare fundraising for execution",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/prepare-execution" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--approval-artifact-id <approval-artifact-id>", description: "Approval artifact ID to bind", required: true },
+          { flags: "--document-request-ids <document-request-ids>", description: "Comma-separated document request IDs", type: "array" },
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID", required: true },
+          { flags: "--phase <phase>", description: "Workflow phase" }
+        ],
+        examples: ["corp equity fundraising-workflows-prepare-execution <workflow-id> --approval-artifact-id 'approval-artifact-id' --intent-id 'intent-id'", "corp equity fundraising-workflows-prepare-execution --json"],
+        successTemplate: "Fundraising Workflows Prepare Execution created"
+      },
+      {
+        name: "equity fundraising-workflows-record-board-approval",
+        description: "Record board approval for fundraising",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/record-board-approval" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--meeting-id <meeting-id>", description: "Meeting ID", required: true },
+          { flags: "--resolution-id <resolution-id>", description: "Resolution ID", required: true }
+        ],
+        examples: ["corp equity fundraising-workflows-record-board-approval <workflow-id> --meeting-id 'meeting-id' --resolution-id 'resolution-id'"],
+        successTemplate: "Fundraising Workflows Record Board Approval created"
+      },
+      {
+        name: "equity fundraising-workflows-record-close",
+        description: "Record closing of a fundraising round",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/record-close" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID", required: true }
+        ],
+        examples: ["corp equity fundraising-workflows-record-close <workflow-id> --intent-id 'intent-id'"],
+        successTemplate: "Fundraising Workflows Record Close created"
+      },
+      {
+        name: "equity fundraising-workflows-record-investor-acceptance",
+        description: "Record investor acceptance of terms",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/record-investor-acceptance" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--accepted-by-contact-id <accepted-by-contact-id>", description: "Contact ID of the accepting party" },
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID", required: true }
+        ],
+        examples: ["corp equity fundraising-workflows-record-investor-acceptance <workflow-id> --intent-id 'intent-id'", "corp equity fundraising-workflows-record-investor-acceptance --json"],
+        successTemplate: "Fundraising Workflows Record Investor Acceptance created"
+      },
+      {
+        name: "equity fundraising-workflows-record-signature",
+        description: "Record a signature on fundraising documents",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/record-signature" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--channel <channel>", description: "Approval channel (board_vote, written_consent, etc.)" },
+          { flags: "--signer-identity <signer-identity>", description: "Identity of the signer", required: true }
+        ],
+        examples: ["corp equity fundraising-workflows-record-signature <workflow-id> --signer-identity 'signer-identity'", "corp equity fundraising-workflows-record-signature --json"],
+        successTemplate: "Fundraising Workflows Record Signature created"
+      },
+      {
+        name: "equity fundraising-workflows-start-signatures",
+        description: "Start the signature collection process",
+        route: { method: "POST", path: "/v1/equity/fundraising-workflows/{pos}/start-signatures" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        examples: ["corp equity fundraising-workflows-start-signatures <workflow-id>"],
+        successTemplate: "Fundraising Workflows Start Signatures created"
+      },
+      {
+        name: "equity grants",
+        description: "Issue an equity grant (options, RSUs, etc.)",
+        route: { method: "POST", path: "/v1/equity/grants" },
+        entity: true,
+        options: [
+          { flags: "--grant-type <grant-type>", description: "The type of equity grant.", required: true, choices: ["common", "common_stock", "preferred", "preferred_stock", "membership_unit", "stock_option", "iso", "nso", "rsa", "svu"] },
+          { flags: "--recipient-name <recipient-name>", description: "Payment recipient name", required: true },
+          { flags: "--shares <shares>", description: "Shares", required: true, type: "int" }
+        ],
+        examples: ["corp equity grants --grant-type common_stock --recipient-name 'recipient-name' --shares 'shares'"],
+        successTemplate: "Grants created"
+      },
+      {
+        name: "equity holders",
+        description: "Register a new equity holder",
+        route: { method: "POST", path: "/v1/equity/holders" },
+        entity: true,
+        options: [
+          { flags: "--contact-id <contact-id>", description: "Contact ID", required: true },
+          { flags: "--external-reference <external-reference>", description: "External Reference" },
+          { flags: "--holder-type <holder-type>", description: "Type of holder represented in the cap table.", required: true, choices: ["individual", "organization", "fund", "nonprofit", "trust", "other"] },
+          { flags: "--linked-entity-id <linked-entity-id>", description: "ID of the entity to link" },
+          { flags: "--name <name>", description: "Display name", required: true }
+        ],
+        examples: ["corp equity holders --contact-id 'contact-id' --holder-type individual --name 'name'", "corp equity holders --json"],
+        successTemplate: "Holders created"
+      },
+      {
+        name: "equity instruments",
+        description: "Create a new equity instrument",
+        route: { method: "POST", path: "/v1/equity/instruments" },
+        entity: true,
+        options: [
+          { flags: "--authorized-units <authorized-units>", description: "Authorized Units" },
+          { flags: "--issue-price-cents <issue-price-cents>", description: "Issue Price Cents" },
+          { flags: "--issuer-legal-entity-id <issuer-legal-entity-id>", description: "Legal entity issuing the securities", required: true },
+          { flags: "--kind <kind>", description: "Instrument kind in the ownership model.", required: true, choices: ["common_equity", "preferred_equity", "membership_unit", "option_grant", "safe", "convertible_note", "warrant"] },
+          { flags: "--symbol <symbol>", description: "Symbol", required: true },
+          { flags: "--terms <terms>", description: "Terms" }
+        ],
+        examples: ["corp equity instruments --issuer-legal-entity-id 'issuer-legal-entity-id' --kind common_equity --symbol 'symbol'", "corp equity instruments --json"],
+        successTemplate: "Instruments created"
+      },
+      {
+        name: "equity positions-adjust",
+        description: "Adjust an equity position (split, correction)",
+        route: { method: "POST", path: "/v1/equity/positions/adjust" },
+        entity: true,
+        options: [
+          { flags: "--holder-id <holder-id>", description: "Equity holder ID", required: true },
+          { flags: "--instrument-id <instrument-id>", description: "Instrument Id", required: true },
+          { flags: "--issuer-legal-entity-id <issuer-legal-entity-id>", description: "Legal entity issuing the securities", required: true },
+          { flags: "--principal-delta-cents <principal-delta-cents>", description: "Principal Delta Cents", type: "int" },
+          { flags: "--quantity-delta <quantity-delta>", description: "Quantity Delta", required: true, type: "int" },
+          { flags: "--source-reference <source-reference>", description: "Source reference for the conversion" }
+        ],
+        examples: ["corp equity positions-adjust --holder-id 'holder-id' --instrument-id 'instrument-id' --issuer-legal-entity-id 'issuer-legal-entity-id' --quantity-delta 'quantity-delta'", "corp equity positions-adjust --json"],
+        successTemplate: "Positions Adjust created"
+      },
+      {
+        name: "equity rounds",
+        description: "Create a new equity round (prefer cap-table start-round which auto-resolves issuer)",
+        route: { method: "POST", path: "/v1/equity/rounds" },
+        entity: true,
+        options: [
+          { flags: "--conversion-target-instrument-id <conversion-target-instrument-id>", description: "Target instrument for conversion" },
+          { flags: "--issuer-legal-entity-id <issuer-legal-entity-id>", description: "Issuer legal entity (run 'corp cap-table --json' to find this)", required: true },
+          { flags: "--metadata <metadata>", description: "Additional metadata (JSON)" },
+          { flags: "--name <name>", description: "Display name", required: true },
+          { flags: "--pre-money-cents <pre-money-cents>", description: "Pre-money valuation in cents" },
+          { flags: "--round-price-cents <round-price-cents>", description: "Round share price in cents" },
+          { flags: "--target-raise-cents <target-raise-cents>", description: "Target fundraising amount in cents" }
+        ],
+        examples: ["corp equity rounds --issuer-legal-entity-id 'issuer-legal-entity-id' --name 'name'", "corp equity rounds --json"],
+        successTemplate: "Rounds created"
+      },
+      {
+        name: "equity rounds-staged",
+        description: "Create a staged (draft) equity round (prefer cap-table start-round which auto-resolves issuer)",
+        route: { method: "POST", path: "/v1/equity/rounds/staged" },
+        entity: true,
+        options: [
+          { flags: "--issuer-legal-entity-id <issuer-legal-entity-id>", description: "Issuer legal entity (run 'corp cap-table --json' to find this)", required: true },
+          { flags: "--metadata <metadata>", description: "Additional metadata (JSON)" },
+          { flags: "--name <name>", description: "Display name", required: true },
+          { flags: "--pre-money-cents <pre-money-cents>", description: "Pre-money valuation in cents" },
+          { flags: "--round-price-cents <round-price-cents>", description: "Round share price in cents" },
+          { flags: "--target-raise-cents <target-raise-cents>", description: "Target fundraising amount in cents" }
+        ],
+        examples: ["corp equity rounds-staged --issuer-legal-entity-id 'issuer-legal-entity-id' --name 'name'", "corp equity rounds-staged --json"],
+        successTemplate: "Rounds Staged created"
+      },
+      {
+        name: "equity rounds-accept",
+        description: "Accept terms for an equity round",
+        route: { method: "POST", path: "/v1/equity/rounds/{pos}/accept" },
+        entity: true,
+        args: [{ name: "round-id", required: true, description: "Equity round ID" }],
+        options: [
+          { flags: "--accepted-by-contact-id <accepted-by-contact-id>", description: "Contact ID of the accepting party" },
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID", required: true }
+        ],
+        examples: ["corp equity rounds-accept <round-id> --intent-id 'intent-id'", "corp equity rounds-accept --json"],
+        successTemplate: "Rounds Accept created"
+      },
+      {
+        name: "equity rounds-apply-terms",
+        description: "Apply term sheet to an equity round",
+        route: { method: "POST", path: "/v1/equity/rounds/{pos}/apply-terms" },
+        entity: true,
+        args: [{ name: "round-id", required: true, description: "Equity round ID" }],
+        options: [
+          { flags: "--anti-dilution-method <anti-dilution-method>", description: "Anti-dilution protection method", required: true, choices: ["none", "broad_based_weighted_average", "narrow_based_weighted_average", "full_ratchet"] },
+          { flags: "--conversion-precedence <conversion-precedence>", description: "Conversion priority ordering", type: "array" },
+          { flags: "--protective-provisions <protective-provisions>", description: "Protective provision terms" }
+        ],
+        examples: ["corp equity rounds-apply-terms <round-id> --anti-dilution-method none", "corp equity rounds-apply-terms --json"],
+        successTemplate: "Rounds Apply Terms created"
+      },
+      {
+        name: "equity rounds-board-approve",
+        description: "Record board approval for an equity round",
+        route: { method: "POST", path: "/v1/equity/rounds/{pos}/board-approve" },
+        entity: true,
+        args: [{ name: "round-id", required: true, description: "Equity round ID" }],
+        options: [
+          { flags: "--meeting-id <meeting-id>", description: "Meeting ID", required: true },
+          { flags: "--resolution-id <resolution-id>", description: "Resolution ID", required: true }
+        ],
+        examples: ["corp equity rounds-board-approve <round-id> --meeting-id 'meeting-id' --resolution-id 'resolution-id'"],
+        successTemplate: "Rounds Board Approve created"
+      },
+      {
+        name: "equity rounds-issue",
+        description: "Issue shares for an equity round",
+        route: { method: "POST", path: "/v1/equity/rounds/{pos}/issue" },
+        entity: true,
+        args: [{ name: "round-id", required: true, description: "Equity round ID" }],
+        options: [
+          { flags: "--meeting-id <meeting-id>", description: "Meeting ID" },
+          { flags: "--resolution-id <resolution-id>", description: "Resolution ID" }
+        ],
+        examples: ["corp equity rounds-issue <round-id>", "corp equity rounds-issue --json"],
+        successTemplate: "Rounds Issue created"
+      },
+      {
+        name: "equity rounds-securities",
+        description: "Add securities to an equity round",
+        route: { method: "POST", path: "/v1/equity/rounds/{pos}/securities" },
+        entity: true,
+        args: [{ name: "round-id", required: true, description: "Equity round ID" }],
+        options: [
+          { flags: "--email <email>", description: "Email" },
+          { flags: "--grant-type <grant-type>", description: "Grant Type" },
+          { flags: "--holder-id <holder-id>", description: "Equity holder ID" },
+          { flags: "--instrument-id <instrument-id>", description: "Instrument Id", required: true },
+          { flags: "--principal-cents <principal-cents>", description: "Principal Cents", type: "int" },
+          { flags: "--quantity <quantity>", description: "Quantity", required: true, type: "int" },
+          { flags: "--recipient-name <recipient-name>", description: "Payment recipient name", required: true }
+        ],
+        examples: ["corp equity rounds-securities <round-id> --instrument-id 'instrument-id' --quantity 'quantity' --recipient-name 'recipient-name'", "corp equity rounds-securities --json"],
+        successTemplate: "Rounds Securities created"
+      },
+      {
+        name: "equity create-transfer-workflow",
+        description: "Start or view a share transfer workflow",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows" },
+        options: [
+          { flags: "--from-contact-id <from-contact-id>", description: "From Contact Id", required: true },
+          { flags: "--governing-doc-type <governing-doc-type>", description: "The type of governing document for a share transfer.", required: true, choices: ["bylaws", "operating_agreement", "shareholder_agreement", "other"] },
+          { flags: "--prepare-intent-id <prepare-intent-id>", description: "Execution intent ID for preparation", required: true },
+          { flags: "--price-per-share-cents <price-per-share-cents>", description: "Price Per Share Cents" },
+          { flags: "--relationship-to-holder <relationship-to-holder>", description: "Relationship To Holder" },
+          { flags: "--share-class-id <share-class-id>", description: "Share class ID", required: true },
+          { flags: "--share-count <share-count>", description: "Number of shares", required: true, type: "int" },
+          { flags: "--to-contact-id <to-contact-id>", description: "To Contact Id", required: true },
+          { flags: "--transfer-type <transfer-type>", description: "Type of share transfer.", required: true, choices: ["gift", "trust_transfer", "secondary_sale", "estate", "other"] },
+          { flags: "--transferee-rights <transferee-rights>", description: "Rights granted to the transferee.", required: true, choices: ["full_member", "economic_only", "limited"] }
+        ],
+        examples: ["corp equity transfer-workflows --from-contact-id 'from-contact-id' --governing-doc-type bylaws --prepare-intent-id 'prepare-intent-id' --share-class-id 'share-class-id' --share-count 'share-count' --to-contact-id gift --transfer-type gift --transferee-rights full_member", "corp equity transfer-workflows --json"],
+        successTemplate: "Transfer Workflows created"
+      },
+      {
+        name: "equity transfer-workflows",
+        description: "Start or view a share transfer workflow",
+        route: { method: "GET", path: "/v1/equity/transfer-workflows/{pos}" },
+        entity: true,
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        display: { title: "Equity Transfer Workflows", cols: ["execution_status>Execution Status", "generated_documents>Generated Documents", "last_packet_hash>Last Packet Hash", "@created_at>Created At", "#active_packet_id>ID"] },
+        examples: ["corp equity transfer-workflows", "corp equity transfer-workflows --json"]
+      },
+      {
+        name: "equity transfer-workflows-compile-packet",
+        description: "Compile documents for a share transfer",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/compile-packet" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--phase <phase>", description: "Workflow phase" },
+          { flags: "--required-signers <required-signers>", description: "List of required signers", type: "array" }
+        ],
+        examples: ["corp equity transfer-workflows-compile-packet <workflow-id>", "corp equity transfer-workflows-compile-packet --json"],
+        successTemplate: "Transfer Workflows Compile Packet created"
+      },
+      {
+        name: "equity transfer-workflows-finalize",
+        description: "Finalize a share transfer workflow",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/finalize" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--phase <phase>", description: "Workflow phase" }
+        ],
+        examples: ["corp equity transfer-workflows-finalize <workflow-id>", "corp equity transfer-workflows-finalize --json"],
+        successTemplate: "Transfer Workflows Finalize created"
+      },
+      {
+        name: "equity transfer-workflows-generate-docs",
+        description: "Generate documents for a share transfer",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/generate-docs" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--documents <documents>", description: "Document references or content", type: "array" }
+        ],
+        examples: ["corp equity transfer-workflows-generate-docs <workflow-id>", "corp equity transfer-workflows-generate-docs --json"],
+        successTemplate: "Transfer Workflows Generate Docs created"
+      },
+      {
+        name: "equity transfer-workflows-prepare-execution",
+        description: "Prepare transfer for execution",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/prepare-execution" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--approval-artifact-id <approval-artifact-id>", description: "Approval artifact ID to bind", required: true },
+          { flags: "--document-request-ids <document-request-ids>", description: "Comma-separated document request IDs", type: "array" },
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID", required: true },
+          { flags: "--phase <phase>", description: "Workflow phase" }
+        ],
+        examples: ["corp equity transfer-workflows-prepare-execution <workflow-id> --approval-artifact-id 'approval-artifact-id' --intent-id 'intent-id'", "corp equity transfer-workflows-prepare-execution --json"],
+        successTemplate: "Transfer Workflows Prepare Execution created"
+      },
+      {
+        name: "equity transfer-workflows-record-board-approval",
+        description: "Record board approval for a transfer",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/record-board-approval" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--meeting-id <meeting-id>", description: "Meeting ID", required: true },
+          { flags: "--resolution-id <resolution-id>", description: "Resolution ID", required: true }
+        ],
+        examples: ["corp equity transfer-workflows-record-board-approval <workflow-id> --meeting-id 'meeting-id' --resolution-id 'resolution-id'"],
+        successTemplate: "Transfer Workflows Record Board Approval created"
+      },
+      {
+        name: "equity transfer-workflows-record-execution",
+        description: "Record execution of a share transfer",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/record-execution" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID", required: true }
+        ],
+        examples: ["corp equity transfer-workflows-record-execution <workflow-id> --intent-id 'intent-id'"],
+        successTemplate: "Transfer Workflows Record Execution created"
+      },
+      {
+        name: "equity transfer-workflows-record-review",
+        description: "Record review of a share transfer",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/record-review" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--approved", description: "Approved", required: true },
+          { flags: "--notes <notes>", description: "Additional notes", required: true },
+          { flags: "--reviewer <reviewer>", description: "Reviewer", required: true }
+        ],
+        examples: ["corp equity transfer-workflows-record-review <workflow-id> --approved --notes 'notes' --reviewer 'reviewer'"],
+        successTemplate: "Transfer Workflows Record Review created"
+      },
+      {
+        name: "equity transfer-workflows-record-rofr",
+        description: "Record right of first refusal waiver",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/record-rofr" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--offered", description: "Offered", required: true },
+          { flags: "--waived", description: "Waived", required: true }
+        ],
+        examples: ["corp equity transfer-workflows-record-rofr <workflow-id> --offered --waived"],
+        successTemplate: "Transfer Workflows Record Rofr created"
+      },
+      {
+        name: "equity transfer-workflows-record-signature",
+        description: "Record a signature on transfer documents",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/record-signature" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        options: [
+          { flags: "--channel <channel>", description: "Approval channel (board_vote, written_consent, etc.)" },
+          { flags: "--signer-identity <signer-identity>", description: "Identity of the signer", required: true }
+        ],
+        examples: ["corp equity transfer-workflows-record-signature <workflow-id> --signer-identity 'signer-identity'", "corp equity transfer-workflows-record-signature --json"],
+        successTemplate: "Transfer Workflows Record Signature created"
+      },
+      {
+        name: "equity transfer-workflows-start-signatures",
+        description: "Start signature collection for transfer",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/start-signatures" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        examples: ["corp equity transfer-workflows-start-signatures <workflow-id>"],
+        successTemplate: "Transfer Workflows Start Signatures created"
+      },
+      {
+        name: "equity transfer-workflows-submit-review",
+        description: "Submit a share transfer for review",
+        route: { method: "POST", path: "/v1/equity/transfer-workflows/{pos}/submit-review" },
+        args: [{ name: "workflow-id", required: true, description: "Workflow ID" }],
+        examples: ["corp equity transfer-workflows-submit-review <workflow-id>"],
+        successTemplate: "Transfer Workflows Submit Review created"
+      },
+      {
+        name: "equity workflows-status",
+        description: "Check status of an equity workflow",
+        route: { method: "GET", path: "/v1/equity/workflows/{pos}/{pos2}/status" },
+        entity: true,
+        args: [{ name: "workflow-type", required: true, description: "Workflow Type" }, { name: "workflow-id", required: true, description: "Workflow ID" }],
+        display: { title: "Equity Workflows Status", cols: ["execution_status>Execution Status", "fundraising_workflow>Fundraising Workflow", "packet>Packet", "transfer_workflow>Transfer Workflow", "#active_packet_id>ID"] },
+        examples: ["corp equity workflows-status", "corp equity workflows-status --json"]
+      },
+      {
+        name: "safe-notes",
+        description: "Issue a new SAFE note",
+        route: { method: "POST", path: "/v1/safe-notes" },
+        options: [
+          { flags: "--conversion-unit-type <conversion-unit-type>", description: "Conversion Unit Type" },
+          { flags: "--discount-rate <discount-rate>", description: "SAFE discount rate (0-100)" },
+          { flags: "--document-id <document-id>", description: "Document ID" },
+          { flags: "--email <email>", description: "Email" },
+          { flags: "--investor-contact-id <investor-contact-id>", description: "Investor Contact Id" },
+          { flags: "--investor-name <investor-name>", description: "Investor name", required: true },
+          { flags: "--meeting-id <meeting-id>", description: "Meeting ID" },
+          { flags: "--principal-amount-cents <principal-amount-cents>", description: "Principal Amount Cents", required: true, type: "int" },
+          { flags: "--pro-rata-rights", description: "Pro Rata Rights" },
+          { flags: "--resolution-id <resolution-id>", description: "Resolution ID" },
+          { flags: "--safe-type <safe-type>", description: "Safe Type", choices: ["post_money", "pre_money", "mfn"] },
+          { flags: "--valuation-cap-cents <valuation-cap-cents>", description: "Valuation Cap Cents" }
+        ],
+        examples: ["corp safe-notes --investor-name 'investor-name' --principal-amount-cents 'principal-amount-cents'", "corp safe-notes --json"],
+        successTemplate: "Safe Notes created"
+      },
+      {
+        name: "share-transfers",
+        description: "Execute a share transfer between parties",
+        route: { method: "POST", path: "/v1/share-transfers" },
+        options: [
+          { flags: "--from-holder <from-holder>", description: "From Holder", required: true },
+          { flags: "--governing-doc-type <governing-doc-type>", description: "Governing Doc Type", choices: ["bylaws", "operating_agreement", "shareholder_agreement", "other"] },
+          { flags: "--share-class-id <share-class-id>", description: "Share class ID", required: true },
+          { flags: "--shares <shares>", description: "Shares", required: true, type: "int" },
+          { flags: "--to-holder <to-holder>", description: "To Holder", required: true },
+          { flags: "--transfer-type <transfer-type>", description: "Type of share transfer.", required: true, choices: ["gift", "trust_transfer", "secondary_sale", "estate", "other"] },
+          { flags: "--transferee-rights <transferee-rights>", description: "Transferee Rights", choices: ["full_member", "economic_only", "limited"] }
+        ],
+        examples: ["corp share-transfers --from-holder bylaws --share-class-id 'share-class-id' --shares 'shares' --to-holder gift --transfer-type gift", "corp share-transfers --json"],
+        successTemplate: "Share Transfers created"
+      },
+      {
+        name: "valuations",
+        description: "Create a new company valuation",
+        route: { method: "POST", path: "/v1/valuations" },
+        options: [
+          { flags: "--dlom <dlom>", description: "Dlom" },
+          { flags: "--effective-date <effective-date>", description: "Effective Date", required: true },
+          { flags: "--enterprise-value-cents <enterprise-value-cents>", description: "Enterprise Value Cents" },
+          { flags: "--fmv-per-share-cents <fmv-per-share-cents>", description: "Fmv Per Share Cents" },
+          { flags: "--hurdle-amount-cents <hurdle-amount-cents>", description: "Hurdle Amount Cents" },
+          { flags: "--methodology <methodology>", description: "Methodology used for a valuation.", required: true, choices: ["income", "market", "asset", "backsolve", "hybrid", "other"] },
+          { flags: "--provider-contact-id <provider-contact-id>", description: "Provider Contact Id" },
+          { flags: "--report-date <report-date>", description: "Report Date" },
+          { flags: "--report-document-id <report-document-id>", description: "Report Document Id" },
+          { flags: "--valuation-type <valuation-type>", description: "Type of 409A or equivalent valuation.", required: true, choices: ["four_oh_nine_a", "llc_profits_interest", "fair_market_value", "gift", "estate", "other"] }
+        ],
+        examples: ["corp valuations --effective-date 'effective-date' --methodology income --valuation-type four_oh_nine_a", "corp valuations --json"],
+        successTemplate: "Valuations created"
+      },
+      {
+        name: "valuations submit-for-approval",
+        description: "Submit a valuation for board approval",
+        route: { method: "POST", path: "/v1/valuations/{pos}/submit-for-approval" },
+        args: [{ name: "valuation-id", required: true, description: "Valuation ID" }],
+        examples: ["corp valuations submit-for-approval <valuation-id>"],
+        successTemplate: "Submit For Approval created"
+      }
+    ];
+  }
+});
+
+// src/registry/finance.ts
+function sumAmounts(records, candidates) {
+  return records.reduce((sum, record) => {
+    for (const key of candidates) {
+      if (typeof record[key] === "number" && Number.isFinite(record[key])) {
+        return sum + Number(record[key]);
+      }
+    }
     return sum;
   }, 0);
 }
@@ -5255,7 +6457,8 @@ var init_finance = __esm({
             return;
           }
           printInvoicesTable(invoices);
-        }
+        },
+        examples: ["corp finance invoices", "corp finance invoices --json"]
       },
       // --- finance invoice (create) ---
       {
@@ -5268,10 +6471,14 @@ var init_finance = __esm({
           { flags: "--amount-cents <n>", description: "Amount in cents (e.g. 500000 = $5,000.00)", type: "int" },
           { flags: "--amount <n>", description: "Amount in dollars (converted to cents)", type: "int" },
           { flags: "--due-date <date>", description: "Due date (ISO 8601)", required: true },
-          { flags: "--description <desc>", description: "Description", default: "Services rendered" }
+          { flags: "--description <desc>", description: "Description text", default: "Services rendered" }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
+          if (ctx.opts.amountCents != null && ctx.opts.amount != null) {
+            printError("--amount-cents and --amount are mutually exclusive. Use one or the other.");
+            process.exit(1);
+          }
           const amountCents = ctx.opts.amountCents ?? (ctx.opts.amount != null ? ctx.opts.amount * 100 : void 0);
           if (amountCents == null) {
             printError("required option '--amount-cents <n>' or '--amount <n>' not specified");
@@ -5293,7 +6500,8 @@ var init_finance = __esm({
           });
         },
         produces: { kind: "invoice" },
-        successTemplate: "Invoice created: {customer_name}"
+        successTemplate: "Invoice created: {customer_name}",
+        examples: ["corp finance invoice --customer 'name' --due-date 'date'", "corp finance invoice --json"]
       },
       // --- finance payments ---
       {
@@ -5318,7 +6526,8 @@ var init_finance = __esm({
             return;
           }
           printPaymentsTable(payments);
-        }
+        },
+        examples: ["corp finance payments", "corp finance payments --json"]
       },
       // --- finance pay ---
       {
@@ -5334,6 +6543,10 @@ var init_finance = __esm({
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
+          if (ctx.opts.amountCents != null && ctx.opts.amount != null) {
+            printError("--amount-cents and --amount are mutually exclusive. Use one or the other.");
+            process.exit(1);
+          }
           const amountCents = ctx.opts.amountCents ?? (ctx.opts.amount != null ? ctx.opts.amount * 100 : void 0);
           if (amountCents == null) {
             printError("required option '--amount-cents <n>' or '--amount <n>' not specified");
@@ -5356,7 +6569,8 @@ var init_finance = __esm({
           });
         },
         produces: { kind: "payment" },
-        successTemplate: "Payment submitted: {recipient_name}"
+        successTemplate: "Payment submitted: {recipient_name}",
+        examples: ["corp finance pay --recipient 'name'", "corp finance pay --json"]
       },
       // --- finance bank-accounts ---
       {
@@ -5381,7 +6595,8 @@ var init_finance = __esm({
             return;
           }
           printBankAccountsTable(accounts);
-        }
+        },
+        examples: ["corp finance bank-accounts", "corp finance bank-accounts --json"]
       },
       // --- finance open-account ---
       {
@@ -5404,7 +6619,8 @@ var init_finance = __esm({
           });
         },
         produces: { kind: "bank_account" },
-        successTemplate: "Bank account opened: {bank_name}"
+        successTemplate: "Bank account opened: {bank_name}",
+        examples: ["corp finance open-account", "corp finance open-account --json"]
       },
       // --- finance activate-account <account-ref> ---
       {
@@ -5425,7 +6641,8 @@ var init_finance = __esm({
             referenceKind: "bank_account",
             showReuseHint: true
           });
-        }
+        },
+        examples: ["corp finance activate-account <account-ref>"]
       },
       // --- finance payroll-runs ---
       {
@@ -5450,7 +6667,8 @@ var init_finance = __esm({
             return;
           }
           printPayrollRunsTable(runs);
-        }
+        },
+        examples: ["corp finance payroll-runs", "corp finance payroll-runs --json"]
       },
       // --- finance payroll ---
       {
@@ -5478,7 +6696,8 @@ var init_finance = __esm({
           });
         },
         produces: { kind: "payroll_run" },
-        successTemplate: "Payroll run created"
+        successTemplate: "Payroll run created",
+        examples: ["corp finance payroll --period-start 'date' --period-end 'date'"]
       },
       // --- finance distributions ---
       {
@@ -5503,7 +6722,8 @@ var init_finance = __esm({
             return;
           }
           printDistributionsTable(distributions);
-        }
+        },
+        examples: ["corp finance distributions", "corp finance distributions --json"]
       },
       // --- finance reconciliations ---
       {
@@ -5528,7 +6748,8 @@ var init_finance = __esm({
             return;
           }
           printReconciliationsTable(reconciliations);
-        }
+        },
+        examples: ["corp finance reconciliations", "corp finance reconciliations --json"]
       },
       // --- finance reconcile ---
       {
@@ -5556,7 +6777,8 @@ var init_finance = __esm({
           });
         },
         produces: { kind: "reconciliation" },
-        successTemplate: "Reconciliation created"
+        successTemplate: "Reconciliation created",
+        examples: ["corp finance reconcile --start-date 'date' --end-date 'date'"]
       },
       // --- finance classifications ---
       {
@@ -5581,7 +6803,8 @@ var init_finance = __esm({
             return;
           }
           printClassificationsTable(classifications);
-        }
+        },
+        examples: ["corp finance classifications", "corp finance classifications --json"]
       },
       // --- finance classify-contractor ---
       {
@@ -5617,7 +6840,8 @@ var init_finance = __esm({
           });
         },
         produces: { kind: "classification" },
-        successTemplate: "Classification created: {contractor_name}"
+        successTemplate: "Classification created: {contractor_name}",
+        examples: ["corp finance classify-contractor --name 'name' --state 'code' --hours 'n' --duration 'n'", "corp finance classify-contractor --json"]
       },
       // --- finance statements ---
       {
@@ -5639,7 +6863,8 @@ var init_finance = __esm({
             return;
           }
           printJson(result);
-        }
+        },
+        examples: ["corp finance statements", "corp finance statements --json"]
       }
     ];
   }
@@ -5716,6 +6941,9 @@ var init_governance = __esm({
         },
         handler: async (ctx) => {
           const bodyRef = ctx.positional[0];
+          if (!bodyRef) {
+            throw new Error("Missing required argument <body-ref>.\n  List bodies first: corp governance\n  Then: corp governance seats <body-id>");
+          }
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const resolvedBodyId = await ctx.resolver.resolveBody(eid, bodyRef);
           const seats = await ctx.client.getGovernanceSeats(resolvedBodyId, eid);
@@ -5729,7 +6957,8 @@ var init_governance = __esm({
             return;
           }
           printSeatsTable(seats);
-        }
+        },
+        examples: ["corp governance seats <body-ref>", "corp governance seats <body-ref> --json"]
       },
       // --- governance meetings <body-ref> ---
       {
@@ -5744,6 +6973,9 @@ var init_governance = __esm({
         },
         handler: async (ctx) => {
           const bodyRef = ctx.positional[0];
+          if (!bodyRef) {
+            throw new Error("Missing required argument <body-ref>.\n  List bodies first: corp governance\n  Then: corp governance meetings <body-id>");
+          }
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const resolvedBodyId = await ctx.resolver.resolveBody(eid, bodyRef);
           const meetings = await ctx.client.listMeetings(resolvedBodyId, eid);
@@ -5757,7 +6989,8 @@ var init_governance = __esm({
             return;
           }
           printMeetingsTable(meetings);
-        }
+        },
+        examples: ["corp governance meetings <body-ref>", "corp governance meetings <body-ref> --json"]
       },
       // --- governance resolutions <meeting-ref> ---
       {
@@ -5772,6 +7005,9 @@ var init_governance = __esm({
         },
         handler: async (ctx) => {
           const meetingRef = ctx.positional[0];
+          if (!meetingRef) {
+            throw new Error("Missing required argument <meeting-ref>.\n  List meetings first: corp governance meetings <body-ref>\n  Then: corp governance resolutions <meeting-id>");
+          }
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const resolvedMeetingId = await ctx.resolver.resolveMeeting(eid, meetingRef);
           const resolutions = await ctx.client.getMeetingResolutions(resolvedMeetingId, eid);
@@ -5785,7 +7021,8 @@ var init_governance = __esm({
             return;
           }
           printResolutionsTable(resolutions);
-        }
+        },
+        examples: ["corp governance resolutions <meeting-ref>", "corp governance resolutions <meeting-ref> --json"]
       },
       // --- governance agenda-items <meeting-ref> ---
       {
@@ -5800,6 +7037,9 @@ var init_governance = __esm({
         },
         handler: async (ctx) => {
           const meetingRef = ctx.positional[0];
+          if (!meetingRef) {
+            throw new Error("Missing required argument <meeting-ref>.\n  List meetings first: corp governance meetings <body-ref>\n  Then: corp governance agenda-items <meeting-id>");
+          }
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const resolvedMeetingId = await ctx.resolver.resolveMeeting(eid, meetingRef);
           const items = await ctx.client.listAgendaItems(resolvedMeetingId, eid);
@@ -5813,12 +7053,13 @@ var init_governance = __esm({
             return;
           }
           printAgendaItemsTable(items);
-        }
+        },
+        examples: ["corp governance agenda-items <meeting-ref>", "corp governance agenda-items <meeting-ref> --json"]
       },
       // --- governance incidents ---
       {
         name: "governance incidents",
-        description: "List governance incidents",
+        description: "Report a governance incident",
         route: { method: "GET", path: "/v1/entities/{eid}/governance/incidents" },
         entity: true,
         display: { title: "Governance Incidents" },
@@ -5838,7 +7079,8 @@ var init_governance = __esm({
             const colored = status === "resolved" ? chalk8.green(status) : chalk8.red(status);
             console.log(`  [${colored}] ${inc.incident_type ?? "unknown"}: ${inc.description ?? inc.id}`);
           }
-        }
+        },
+        examples: ["corp governance incidents", "corp governance incidents --json"]
       },
       // --- governance profile ---
       {
@@ -5863,7 +7105,8 @@ var init_governance = __esm({
             }
           }
           console.log(chalk8.blue("\u2500".repeat(40)));
-        }
+        },
+        examples: ["corp governance profile", "corp governance profile --json"]
       },
       // --- governance mode ---
       {
@@ -5898,7 +7141,8 @@ var init_governance = __esm({
             console.log(`  ${chalk8.bold("Governance Mode:")} ${result.mode ?? "N/A"}`);
             if (result.reason) console.log(`  ${chalk8.bold("Reason:")} ${result.reason}`);
           }
-        }
+        },
+        examples: ["corp governance mode", "corp governance mode --json"]
       },
       // --- governance create-body ---
       {
@@ -5909,9 +7153,9 @@ var init_governance = __esm({
         dryRun: true,
         options: [
           { flags: "--name <name>", description: "Body name (e.g. 'Board of Directors')", required: true },
-          { flags: "--body-type <type>", description: "Body type (board_of_directors, llc_member_vote)", required: true },
-          { flags: "--quorum <rule>", description: "Quorum rule (majority, supermajority, unanimous)", default: "majority" },
-          { flags: "--voting <method>", description: "Voting method (per_capita, per_unit)", default: "per_capita" }
+          { flags: "--body-type <type>", description: "Body type", required: true, choices: ["board_of_directors", "llc_member_vote"] },
+          { flags: "--quorum <rule>", description: "Quorum rule", default: "majority", choices: ["majority", "supermajority", "unanimous"] },
+          { flags: "--voting <method>", description: "Voting method", default: "per_capita", choices: ["per_capita", "per_unit"] }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
@@ -5941,7 +7185,8 @@ var init_governance = __esm({
           console.log(chalk8.dim(`    corp governance seats @last:body`));
         },
         produces: { kind: "body" },
-        successTemplate: "Governance body created: {name}"
+        successTemplate: "Governance body created: {name}",
+        examples: ["corp governance create-body --name 'name' --body-type 'type'", "corp governance create-body --json"]
       },
       // --- governance add-seat <body-ref> ---
       {
@@ -5976,7 +7221,8 @@ var init_governance = __esm({
           printReferenceSummary("seat", result, { showReuseHint: true });
         },
         produces: { kind: "seat" },
-        successTemplate: "Seat added to {body_id}"
+        successTemplate: "Seat added to {body_id}",
+        examples: ["corp governance add-seat <body-ref> --holder 'contact-ref'", "corp governance add-seat --json"]
       },
       // --- governance convene ---
       {
@@ -6023,7 +7269,8 @@ var init_governance = __esm({
           console.log(chalk8.dim(`    corp governance agenda-items @last:meeting`));
         },
         produces: { kind: "meeting" },
-        successTemplate: "Meeting scheduled: {title}"
+        successTemplate: "Meeting scheduled: {title}",
+        examples: ["corp governance convene --body 'ref' --type 'type' --title 'title'", "corp governance convene --json"]
       },
       // --- governance open <meeting-ref> ---
       {
@@ -6041,9 +7288,18 @@ var init_governance = __esm({
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const resolvedMeetingId = await ctx.resolver.resolveMeeting(eid, meetingRef);
           const presentSeats = ctx.opts.presentSeat;
-          const resolvedSeats = await Promise.all(
-            presentSeats.map((seatRef) => ctx.resolver.resolveSeat(eid, seatRef))
-          );
+          let resolvedSeats;
+          try {
+            resolvedSeats = await Promise.all(
+              presentSeats.map((seatRef) => ctx.resolver.resolveSeat(eid, seatRef))
+            );
+          } catch (err) {
+            throw new Error(
+              `Failed to resolve seat reference: ${err}
+  --present-seat expects seat IDs, not contact IDs.
+  Find seat IDs with: corp governance seats <body-ref>`
+            );
+          }
           const payload = { present_seat_ids: resolvedSeats };
           if (ctx.dryRun) {
             ctx.writer.dryRun("governance.open_meeting", { entity_id: eid, meeting_id: resolvedMeetingId, ...payload });
@@ -6055,7 +7311,8 @@ var init_governance = __esm({
             return;
           }
           ctx.writer.success(`Meeting opened: ${resolvedMeetingId}`);
-        }
+        },
+        examples: ["corp governance open <meeting-ref> --present-seat 'ref'"]
       },
       // --- governance vote <meeting-ref> <item-ref> ---
       {
@@ -6108,7 +7365,8 @@ var init_governance = __esm({
               throw err;
             }
           }
-        }
+        },
+        examples: ["corp governance vote <meeting-ref> <item-ref> --voter for --vote for"]
       },
       // --- governance notice <meeting-ref> ---
       {
@@ -6132,7 +7390,8 @@ var init_governance = __esm({
             return;
           }
           ctx.writer.success(`Notice sent for meeting ${resolvedMeetingId}`);
-        }
+        },
+        examples: ["corp governance notice <meeting-ref>"]
       },
       // --- governance adjourn <meeting-ref> ---
       {
@@ -6156,7 +7415,8 @@ var init_governance = __esm({
             return;
           }
           ctx.writer.success(`Meeting ${resolvedMeetingId} adjourned`);
-        }
+        },
+        examples: ["corp governance adjourn <meeting-ref>"]
       },
       // --- governance reopen <meeting-ref> ---
       {
@@ -6180,7 +7440,8 @@ var init_governance = __esm({
             return;
           }
           ctx.writer.success(`Meeting ${resolvedMeetingId} re-opened`);
-        }
+        },
+        examples: ["corp governance reopen <meeting-ref>"]
       },
       // --- governance cancel <meeting-ref> ---
       {
@@ -6217,7 +7478,8 @@ var init_governance = __esm({
             return;
           }
           ctx.writer.success(`Meeting ${resolvedMeetingId} cancelled`);
-        }
+        },
+        examples: ["corp governance cancel <meeting-ref>", "corp governance cancel --json"]
       },
       // --- governance finalize-item <meeting-ref> <item-ref> ---
       {
@@ -6255,7 +7517,8 @@ var init_governance = __esm({
             return;
           }
           ctx.writer.success(`Agenda item ${resolvedItemId} finalized as ${ctx.opts.status}`);
-        }
+        },
+        examples: ["corp governance finalize-item <meeting-ref> <item-ref>"]
       },
       // --- governance resolve <meeting-ref> <item-ref> ---
       {
@@ -6298,7 +7561,8 @@ var init_governance = __esm({
           printReferenceSummary("resolution", result, { showReuseHint: true });
         },
         produces: { kind: "resolution" },
-        successTemplate: "Resolution computed"
+        successTemplate: "Resolution computed",
+        examples: ["corp governance resolve <meeting-ref> <item-ref> --text 'resolution_text'"]
       },
       // --- governance written-consent ---
       {
@@ -6310,7 +7574,7 @@ var init_governance = __esm({
         options: [
           { flags: "--body <ref>", description: "Governance body reference", required: true },
           { flags: "--title <title>", description: "Title", required: true },
-          { flags: "--description <desc>", description: "Description", required: true }
+          { flags: "--description <desc>", description: "Description text", required: true }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
@@ -6349,7 +7613,104 @@ var init_governance = __esm({
           console.log(chalk8.dim(`    corp governance vote @last:meeting <item-ref> --voter <contact-ref> --vote for`));
         },
         produces: { kind: "meeting" },
-        successTemplate: "Written consent created: {title}"
+        successTemplate: "Written consent created: {title}",
+        examples: ["corp governance written-consent --body 'ref' --title 'title' --description 'desc'"]
+      },
+      // --- governance quick-approve ---
+      {
+        name: "governance quick-approve",
+        description: "One-step board approval: create written consent, auto-vote, return meeting + resolution IDs",
+        entity: true,
+        dryRun: true,
+        options: [
+          { flags: "--body <ref>", description: "Governance body reference (auto-detected if only one exists)" },
+          { flags: "--text <resolution_text>", description: "Resolution text (e.g. 'RESOLVED: authorize SAFE issuance')", required: true }
+        ],
+        handler: async (ctx) => {
+          const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
+          let resolvedBodyId;
+          if (ctx.opts.body) {
+            resolvedBodyId = await ctx.resolver.resolveBody(eid, ctx.opts.body);
+          } else {
+            const bodies = await ctx.client.listGovernanceBodies(eid);
+            const active = bodies.filter((b) => b.status === "active");
+            if (active.length === 1) {
+              resolvedBodyId = String(active[0].body_id);
+            } else if (active.length === 0) {
+              throw new Error("No active governance bodies found. Create one first: corp governance create-body");
+            } else {
+              throw new Error(`Multiple governance bodies found (${active.length}). Specify --body <ref>.`);
+            }
+          }
+          const resolutionText = ctx.opts.text;
+          const title = `Board Approval: ${resolutionText.slice(0, 60)}`;
+          if (ctx.dryRun) {
+            ctx.writer.dryRun("governance.quick_approve", {
+              entity_id: eid,
+              body_id: resolvedBodyId,
+              title,
+              resolution_text: resolutionText
+            });
+            return;
+          }
+          const consentResult = await writtenConsentWorkflow(ctx.client, {
+            entityId: eid,
+            bodyId: resolvedBodyId,
+            title,
+            description: resolutionText
+          });
+          if (!consentResult.success) {
+            throw new Error(`Written consent failed: ${consentResult.error}`);
+          }
+          const meetingId = String(consentResult.data?.meeting_id);
+          ctx.resolver.remember("meeting", meetingId, eid);
+          const agendaItems = await ctx.client.listAgendaItems(meetingId, eid);
+          if (agendaItems.length === 0) {
+            throw new Error("Written consent created but no agenda items found.");
+          }
+          const itemId = String(agendaItems[0].agenda_item_id);
+          const seats = await ctx.client.getGovernanceSeats(resolvedBodyId, eid);
+          const filledSeats = seats.filter((s3) => s3.status === "filled" || s3.status === "active");
+          const seatIds = filledSeats.map((s3) => String(s3.seat_id));
+          if (seatIds.length === 0) {
+            throw new Error("No filled seats found on this governance body. Add seats first: corp governance add-seat <body-ref>");
+          }
+          const meetingStatus = consentResult.data?.status ?? consentResult.data?.meeting_status;
+          if (meetingStatus !== "convened") {
+            await ctx.client.conveneMeeting(meetingId, eid, { present_seat_ids: seatIds });
+          }
+          for (const seatId of seatIds) {
+            try {
+              await ctx.client.castVote(eid, meetingId, itemId, {
+                seat_id: seatId,
+                vote: "for"
+              });
+            } catch {
+            }
+          }
+          const resolution = await ctx.client.computeResolution(meetingId, itemId, eid, {
+            resolution_text: resolutionText
+          });
+          const resolutionId = String(resolution.resolution_id);
+          ctx.resolver.remember("resolution", resolutionId, eid);
+          const passed = resolution.passed === true;
+          if (ctx.opts.json) {
+            ctx.writer.json({ meeting_id: meetingId, resolution_id: resolutionId, passed, votes: filledSeats.length });
+            return;
+          }
+          ctx.writer.success(passed ? "Board approval completed" : "Board vote completed (resolution did not pass)");
+          console.log(`  Meeting:    ${meetingId}`);
+          console.log(`  Resolution: ${resolutionId}`);
+          console.log(chalk8.dim("\n  Use with:"));
+          console.log(chalk8.dim(`    --meeting-id ${meetingId} --resolution-id ${resolutionId}`));
+          console.log(chalk8.dim(`    or: --meeting-id @last:meeting --resolution-id @last:resolution`));
+        },
+        produces: { kind: "resolution" },
+        successTemplate: "Board approval completed",
+        examples: [
+          'corp governance quick-approve --text "RESOLVED: authorize SAFE issuance to Seed Fund"',
+          'corp governance quick-approve --body @last:body --text "RESOLVED: issue Series A equity round"'
+        ]
       },
       // --- governance resign <seat-ref> ---
       {
@@ -6372,7 +7733,284 @@ var init_governance = __esm({
             return;
           }
           ctx.writer.success(`Seat ${seatId} resigned.`);
-        }
+        },
+        examples: ["corp governance resign <seat-ref>", "corp governance resign --json"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "entities governance-audit-checkpoints",
+        description: "List governance audit checkpoints",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/audit/checkpoints" },
+        entity: true,
+        display: { title: "Entities Governance Audit Checkpoints", cols: ["#checkpoint_id>ID", "@created_at>Created At", "#entity_id>ID", "latest_entry_hash>Latest Entry Hash", "#latest_entry_id>ID", "total_entries>Total Entries"] },
+        examples: ["corp entities governance-audit-checkpoints", "corp entities governance-audit-checkpoints --json"]
+      },
+      {
+        name: "entities governance-audit-entries",
+        description: "List governance audit log entries",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/audit/entries" },
+        entity: true,
+        display: { title: "Entities Governance Audit Entries", cols: ["action>Action", "details>Details", "entry_hash>Entry Hash", "event_type>Event Type", "@created_at>Created At", "#audit_entry_id>ID"] },
+        examples: ["corp entities governance-audit-entries", "corp entities governance-audit-entries --json"]
+      },
+      {
+        name: "entities governance-audit-verifications",
+        description: "List governance audit verifications",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/audit/verifications" },
+        entity: true,
+        display: { title: "Entities Governance Audit Verifications", cols: ["anomalies>Anomalies", "latest_entry_hash>Latest Entry Hash", "ok>Ok", "total_entries>Total Entries", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp entities governance-audit-verifications", "corp entities governance-audit-verifications --json"]
+      },
+      {
+        name: "entities governance-doc-bundles",
+        description: "List governance document bundles",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/doc-bundles" },
+        entity: true,
+        display: { title: "Entities Governance Doc Bundles", cols: ["document_count>Document Count", "entity_type>Entity Type", "generated_at>Generated At", "profile_version>Profile Version", "#bundle_id>ID"] },
+        examples: ["corp entities governance-doc-bundles", "corp entities governance-doc-bundles --json"]
+      },
+      {
+        name: "entities governance-doc-bundles-current",
+        description: "View the current governance document bundle",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/doc-bundles/current" },
+        entity: true,
+        display: { title: "Entities Governance Doc Bundles Current", cols: ["#bundle_id>ID", "#entity_id>ID", "generated_at>Generated At", "manifest_path>Manifest Path", "template_version>Template Version"] },
+        examples: ["corp entities governance-doc-bundles-current", "corp entities governance-doc-bundles-current --json"]
+      },
+      {
+        name: "entities governance-doc-bundles-generate",
+        description: "Generate a new governance document bundle",
+        route: { method: "POST", path: "/v1/entities/{eid}/governance/doc-bundles/generate" },
+        entity: true,
+        options: [
+          { flags: "--template-version <template-version>", description: "Template Version" }
+        ],
+        examples: ["corp entities governance-doc-bundles-generate", "corp entities governance-doc-bundles-generate --json"],
+        successTemplate: "Governance Doc Bundles Generate created"
+      },
+      {
+        name: "entities governance-doc-bundle",
+        description: "List governance document bundles",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/doc-bundles/{pos}" },
+        entity: true,
+        args: [{ name: "bundle-id", required: true, description: "Document bundle ID" }],
+        display: { title: "Entities Governance Doc Bundles", cols: ["documents>Documents", "entity_type>Entity Type", "generated_at>Generated At", "profile_version>Profile Version", "#bundle_id>ID"] },
+        examples: ["corp entities governance-doc-bundles", "corp entities governance-doc-bundles --json"]
+      },
+      {
+        name: "entities governance-mode-history",
+        description: "View governance mode change history",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/mode-history" },
+        entity: true,
+        display: { title: "Entities Governance Mode History", cols: ["evidence_refs>Evidence Refs", "from_mode>From Mode", "incident_ids>Incident Ids", "reason>Reason", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp entities governance-mode-history", "corp entities governance-mode-history --json"]
+      },
+      {
+        name: "entities governance-triggers",
+        description: "List governance triggers for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/governance/triggers" },
+        entity: true,
+        display: { title: "Entities Governance Triggers", cols: ["description>Description", "evidence_refs>Evidence Refs", "idempotency_key_hash>Idempotency Key Hash", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp entities governance-triggers", "corp entities governance-triggers --json"]
+      },
+      {
+        name: "governance-bodies",
+        description: "List all governance bodies",
+        route: { method: "GET", path: "/v1/governance-bodies" },
+        entity: true,
+        display: { title: "Governance Bodies", cols: ["body_type>Body Type", "name>Name", "quorum_rule>Quorum Rule", "status>Status", "@created_at>Created At", "#body_id>ID"] },
+        examples: ["corp governance-bodies", "corp governance-bodies --json"]
+      },
+      {
+        name: "governance-bodies create",
+        description: "List all governance bodies",
+        route: { method: "POST", path: "/v1/governance-bodies" },
+        options: [
+          { flags: "--body-type <body-type>", description: "The type of governance body.", required: true, choices: ["board_of_directors", "llc_member_vote"] },
+          { flags: "--name <name>", description: "Display name", required: true },
+          { flags: "--quorum-rule <quorum-rule>", description: "The threshold required for a vote to pass.", required: true, choices: ["majority", "supermajority", "unanimous"] },
+          { flags: "--voting-method <voting-method>", description: "How votes are counted.", required: true, choices: ["per_capita", "per_unit"] }
+        ],
+        examples: ["corp governance-bodies --body-type board_of_directors --name majority --quorum-rule majority --voting-method per_capita"],
+        successTemplate: "Governance Bodies created"
+      },
+      {
+        name: "governance-seats scan-expired",
+        description: "Scan for and flag expired governance seats",
+        route: { method: "POST", path: "/v1/governance-seats/scan-expired" },
+        entity: true,
+        examples: ["corp governance-seats scan-expired"],
+        successTemplate: "Scan Expired created"
+      },
+      {
+        name: "governance-seats resign",
+        description: "Resign from a governance seat",
+        route: { method: "POST", path: "/v1/governance-seats/{pos}/resign" },
+        entity: true,
+        args: [{ name: "seat-id", required: true, description: "Governance seat ID" }],
+        examples: ["corp governance-seats resign <seat-id>"],
+        successTemplate: "Resign created"
+      },
+      {
+        name: "governance audit-checkpoints",
+        description: "Create a governance audit checkpoint",
+        route: { method: "POST", path: "/v1/governance/audit/checkpoints" },
+        entity: true,
+        examples: ["corp governance audit-checkpoints"],
+        successTemplate: "Audit Checkpoints created"
+      },
+      {
+        name: "governance audit-events",
+        description: "Record a governance audit event",
+        route: { method: "POST", path: "/v1/governance/audit/events" },
+        entity: true,
+        options: [
+          { flags: "--action <action>", description: "Action", required: true },
+          { flags: "--details <details>", description: "Details" },
+          { flags: "--event-type <event-type>", description: "Event Type", required: true, choices: ["mode_changed", "lockdown_trigger_applied", "manual_event", "checkpoint_written", "chain_verified", "chain_verification_failed"] },
+          { flags: "--evidence-refs <evidence-refs>", description: "Evidence Refs", type: "array" },
+          { flags: "--linked-incident-id <linked-incident-id>", description: "Linked Incident Id" },
+          { flags: "--linked-intent-id <linked-intent-id>", description: "Linked Intent Id" },
+          { flags: "--linked-mode-event-id <linked-mode-event-id>", description: "Linked Mode Event Id" },
+          { flags: "--linked-trigger-id <linked-trigger-id>", description: "Linked Trigger Id" }
+        ],
+        examples: ["corp governance audit-events --action 'action' --event-type mode_changed", "corp governance audit-events --json"],
+        successTemplate: "Audit Events created"
+      },
+      {
+        name: "governance audit-verify",
+        description: "Verify governance state integrity",
+        route: { method: "POST", path: "/v1/governance/audit/verify" },
+        entity: true,
+        examples: ["corp governance audit-verify"],
+        successTemplate: "Audit Verify created"
+      },
+      {
+        name: "governance delegation-schedule",
+        description: "View the current delegation schedule",
+        route: { method: "GET", path: "/v1/governance/delegation-schedule" },
+        entity: true,
+        display: { title: "Governance Delegation Schedule", cols: ["allowed_tier1_intent_types>Allowed Tier1 Intent Types", "last_reauthorized_at>Last Reauthorized At", "next_mandatory_review_at>Next Mandatory Review At", "reauth_full_suspension_at_days>Reauth Full Suspension At Days", "@created_at>Created At", "#adopted_resolution_id>ID"] },
+        examples: ["corp governance delegation-schedule", "corp governance delegation-schedule --json"]
+      },
+      {
+        name: "governance delegation-schedule-amend",
+        description: "Amend the delegation schedule",
+        route: { method: "POST", path: "/v1/governance/delegation-schedule/amend" },
+        entity: true,
+        options: [
+          { flags: "--adopted-resolution-id <adopted-resolution-id>", description: "Adopted Resolution Id" },
+          { flags: "--allowed-tier1-intent-types <allowed-tier1-intent-types>", description: "Allowed Tier1 Intent Types" },
+          { flags: "--meeting-id <meeting-id>", description: "Meeting ID" },
+          { flags: "--next-mandatory-review-at <next-mandatory-review-at>", description: "Next Mandatory Review At" },
+          { flags: "--rationale <rationale>", description: "Rationale" },
+          { flags: "--tier1-max-amount-cents <tier1-max-amount-cents>", description: "Tier1 Max Amount Cents" }
+        ],
+        examples: ["corp governance delegation-schedule-amend", "corp governance delegation-schedule-amend --json"],
+        successTemplate: "Delegation Schedule Amend created"
+      },
+      {
+        name: "governance delegation-schedule-history",
+        description: "View delegation schedule change history",
+        route: { method: "GET", path: "/v1/governance/delegation-schedule/history" },
+        entity: true,
+        display: { title: "Governance Delegation Schedule History", cols: ["added_tier1_intent_types>Added Tier1 Intent Types", "authority_expansion>Authority Expansion", "from_version>From Version", "new_tier1_max_amount_cents>New Tier1 Max Amount Cents", "@created_at>Created At", "#adopted_resolution_id>ID"] },
+        examples: ["corp governance delegation-schedule-history", "corp governance delegation-schedule-history --json"]
+      },
+      {
+        name: "governance delegation-schedule-reauthorize",
+        description: "Reauthorize the delegation schedule",
+        route: { method: "POST", path: "/v1/governance/delegation-schedule/reauthorize" },
+        entity: true,
+        options: [
+          { flags: "--adopted-resolution-id <adopted-resolution-id>", description: "Adopted Resolution Id", required: true },
+          { flags: "--meeting-id <meeting-id>", description: "Meeting ID", required: true },
+          { flags: "--rationale <rationale>", description: "Rationale" }
+        ],
+        examples: ["corp governance delegation-schedule-reauthorize --adopted-resolution-id 'adopted-resolution-id' --meeting-id 'meeting-id'", "corp governance delegation-schedule-reauthorize --json"],
+        successTemplate: "Delegation Schedule Reauthorize created"
+      },
+      {
+        name: "governance evaluate",
+        description: "Evaluate governance compliance for an action",
+        route: { method: "POST", path: "/v1/governance/evaluate" },
+        entity: true,
+        options: [
+          { flags: "--intent-type <intent-type>", description: "Type of intent", required: true },
+          { flags: "--metadata <metadata>", description: "Additional metadata (JSON)" }
+        ],
+        examples: ["corp governance evaluate --intent-type 'intent-type'", "corp governance evaluate --json"],
+        successTemplate: "Evaluate created"
+      },
+      {
+        name: "governance report-incident",
+        description: "Report a governance incident",
+        route: { method: "POST", path: "/v1/governance/incidents" },
+        entity: true,
+        options: [
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--severity <severity>", description: "Severity level", required: true, choices: ["low", "medium", "high", "critical"] },
+          { flags: "--title <title>", description: "Title", required: true }
+        ],
+        examples: ["corp governance incidents --description low --severity low --title 'title'"],
+        successTemplate: "Incidents created"
+      },
+      {
+        name: "governance incidents-resolve",
+        description: "Resolve a governance incident",
+        route: { method: "POST", path: "/v1/governance/incidents/{pos}/resolve" },
+        entity: true,
+        args: [{ name: "incident-id", required: true, description: "Incident ID" }],
+        examples: ["corp governance incidents-resolve <incident-id>"],
+        successTemplate: "Incidents Resolve created"
+      },
+      {
+        name: "meetings written-consent",
+        description: "Create a written consent resolution (no meeting)",
+        route: { method: "POST", path: "/v1/meetings/written-consent" },
+        options: [
+          { flags: "--body-id <body-id>", description: "Governance body ID", required: true },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--title <title>", description: "Title", required: true }
+        ],
+        examples: ["corp meetings written-consent --body-id 'body-id' --description 'description' --title 'title'"],
+        successTemplate: "Written Consent created"
+      },
+      {
+        name: "meetings agenda-items-vote",
+        description: "Cast a vote on a meeting agenda item",
+        route: { method: "POST", path: "/v1/meetings/{pos}/agenda-items/{pos2}/vote" },
+        entity: true,
+        args: [{ name: "meeting-id", required: true, description: "Meeting ID" }, { name: "item-id", required: true, description: "Agenda item ID" }],
+        options: [
+          { flags: "--vote-value <vote-value>", description: "How a participant voted.", required: true, choices: ["for", "against", "abstain", "recusal"] },
+          { flags: "--voter-id <voter-id>", description: "Voter Id", required: true }
+        ],
+        examples: ["corp meetings agenda-items-vote <meeting-id> <item-id> --vote-value for --voter-id 'voter-id'"],
+        successTemplate: "Agenda Items Vote created"
+      },
+      {
+        name: "meetings convene",
+        description: "Convene a scheduled meeting (start it)",
+        route: { method: "POST", path: "/v1/meetings/{pos}/convene" },
+        entity: true,
+        args: [{ name: "meeting-id", required: true, description: "Meeting ID" }],
+        options: [
+          { flags: "--present-seat-ids <present-seat-ids>", description: "Present Seat Ids", required: true, type: "array" }
+        ],
+        examples: ["corp meetings convene <meeting-id> --present-seat-ids 'present-seat-ids'"],
+        successTemplate: "Convene created"
+      },
+      {
+        name: "meetings resolutions-attach-document",
+        description: "Attach a document to a meeting resolution",
+        route: { method: "POST", path: "/v1/meetings/{pos}/resolutions/{pos2}/attach-document" },
+        args: [{ name: "meeting-id", required: true, description: "Meeting ID" }, { name: "resolution-id", required: true, description: "Resolution ID" }],
+        options: [
+          { flags: "--document-id <document-id>", description: "Document ID", required: true }
+        ],
+        examples: ["corp meetings resolutions-attach-document <meeting-id> <resolution-id> --document-id 'document-id'"],
+        successTemplate: "Resolutions Attach Document created"
       }
     ];
   }
@@ -6416,7 +8054,7 @@ var init_documents = __esm({
       // --- documents (list) ---
       {
         name: "documents",
-        description: "Documents and signing",
+        description: "List formation and governance documents",
         route: { method: "GET", path: "/v1/formations/{eid}/documents" },
         entity: true,
         display: {
@@ -6436,7 +8074,8 @@ var init_documents = __esm({
             return;
           }
           printDocumentsTable(docs);
-        }
+        },
+        examples: ["corp documents", "corp documents --json"]
       },
       // --- documents signing-link <doc-ref> ---
       {
@@ -6468,7 +8107,8 @@ var init_documents = __esm({
             printReferenceSummary("document", summaryRecord, { label: "Document Ref:" });
           }
           console.log(shareUrl);
-        }
+        },
+        examples: ["corp documents signing-link", "corp documents signing-link --json"]
       },
       // --- documents sign <doc-ref> ---
       {
@@ -6521,7 +8161,8 @@ var init_documents = __esm({
           );
           printReferenceSummary("document", result.document, { showReuseHint: true });
           printJson(result.document);
-        }
+        },
+        examples: ["corp documents sign <doc-ref>", "corp documents sign --json"]
       },
       // --- documents sign-all ---
       {
@@ -6545,7 +8186,8 @@ var init_documents = __esm({
             status: document.status,
             signatures: Array.isArray(document.signatures) ? document.signatures.length : document.signatures
           })));
-        }
+        },
+        examples: ["corp documents sign-all"]
       },
       // --- documents generate ---
       {
@@ -6576,6 +8218,11 @@ var init_documents = __esm({
             if (!key) throw new Error(`Invalid --param value: ${raw}. Expected key=value.`);
             parameters[key] = coerceParamValue(value);
           }
+          if (template === "employment_offer" && !parameters.base_salary) {
+            throw new Error(
+              "base_salary is required for employment_offer template.\n  Use: --base-salary 150000\n  Or:  --param base_salary=150000"
+            );
+          }
           try {
             const result = await ctx.client.generateContract({
               entity_id: eid,
@@ -6619,7 +8266,8 @@ var init_documents = __esm({
           }
         },
         produces: { kind: "document" },
-        successTemplate: "Document generated: {title}"
+        successTemplate: "Document generated: {title}",
+        examples: ["corp documents generate --template 'type' --counterparty 'name'", "corp documents generate --json"]
       },
       // --- documents preview-pdf ---
       {
@@ -6642,7 +8290,8 @@ var init_documents = __esm({
           const url = ctx.client.getPreviewPdfUrl(eid, documentId);
           ctx.writer.success(`Preview PDF URL: ${url}`);
           console.log("The document definition was validated successfully. Use your API key to download the PDF.");
-        }
+        },
+        examples: ["corp documents preview-pdf", "corp documents preview-pdf --json"]
       }
     ];
   }
@@ -6708,12 +8357,13 @@ var init_compliance = __esm({
           }
           if (filings.length > 0) printTaxFilingsTable(filings);
           if (deadlines.length > 0) printDeadlinesTable(deadlines);
-        }
+        },
+        examples: ["corp tax", "corp tax --json"]
       },
       // --- tax filings ---
       {
         name: "tax filings",
-        description: "List tax filings",
+        description: "Create a tax filing record",
         route: { method: "GET", path: "/v1/entities/{eid}/tax-filings" },
         entity: true,
         display: {
@@ -6733,7 +8383,8 @@ var init_compliance = __esm({
             return;
           }
           printTaxFilingsTable(filings);
-        }
+        },
+        examples: ["corp tax filings", "corp tax filings --json"]
       },
       // --- tax file ---
       {
@@ -6748,17 +8399,21 @@ var init_compliance = __esm({
             required: true,
             choices: [...TAX_DOCUMENT_TYPE_CHOICES]
           },
-          { flags: "--year <year>", description: "Tax year", required: true, type: "int" }
+          { flags: "--year <year>", description: "Tax year", required: true, type: "int" },
+          { flags: "--filer-contact-id <ref>", description: "Contact reference for per-person filings (e.g. 83(b) elections)" }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const rawType = ctx.opts.type;
           const docType = TAX_DOCUMENT_TYPE_ALIASES[rawType] ?? rawType;
-          const result = await ctx.client.fileTaxDocument({
+          const filerContactId = ctx.opts.filerContactId ? await ctx.resolver.resolveContact(eid, ctx.opts.filerContactId) : void 0;
+          const payload = {
             entity_id: eid,
             document_type: docType,
             tax_year: ctx.opts.year
-          });
+          };
+          if (filerContactId) payload.filer_contact_id = filerContactId;
+          const result = await ctx.client.fileTaxDocument(payload);
           await ctx.resolver.stabilizeRecord("tax_filing", result, eid);
           ctx.resolver.rememberFromRecord("tax_filing", result, eid);
           ctx.writer.writeResult(result, `Tax document filed: ${result.filing_id ?? "OK"}`, {
@@ -6768,7 +8423,8 @@ var init_compliance = __esm({
           });
         },
         produces: { kind: "tax_filing" },
-        successTemplate: "Tax filing created"
+        successTemplate: "Tax filing created",
+        examples: ["corp tax file --year 'year'"]
       },
       // --- tax deadlines ---
       {
@@ -6793,7 +8449,8 @@ var init_compliance = __esm({
             return;
           }
           printDeadlinesTable(deadlines);
-        }
+        },
+        examples: ["corp tax deadlines", "corp tax deadlines --json"]
       },
       // --- tax deadline ---
       {
@@ -6804,7 +8461,7 @@ var init_compliance = __esm({
         options: [
           { flags: "--type <type>", description: "Deadline type", required: true },
           { flags: "--due-date <date>", description: "Due date (ISO 8601)", required: true },
-          { flags: "--description <desc>", description: "Description", required: true },
+          { flags: "--description <desc>", description: "Description text", required: true },
           { flags: "--recurrence <recurrence>", description: "Recurrence (e.g. annual; 'yearly' is normalized). Required for annual_report type." }
         ],
         handler: async (ctx) => {
@@ -6830,7 +8487,83 @@ var init_compliance = __esm({
           });
         },
         produces: { kind: "deadline" },
-        successTemplate: "Deadline tracked"
+        successTemplate: "Deadline tracked",
+        examples: ["corp tax deadline --type 'type' --due-date 'date' --description 'desc'", "corp tax deadline --json"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "compliance escalations-scan",
+        description: "Scan for compliance issues and create escalations",
+        route: { method: "POST", path: "/v1/compliance/escalations/scan" },
+        examples: ["corp compliance escalations-scan"],
+        successTemplate: "Escalations Scan created"
+      },
+      {
+        name: "compliance escalations-resolve-with-evidence",
+        description: "Resolve a compliance escalation with evidence",
+        route: { method: "POST", path: "/v1/compliance/escalations/{pos}/resolve-with-evidence" },
+        args: [{ name: "escalation-id", required: true, description: "Escalation ID" }],
+        options: [
+          { flags: "--evidence-type <evidence-type>", description: "Evidence Type" },
+          { flags: "--filing-reference <filing-reference>", description: "Filing Reference" },
+          { flags: "--notes <notes>", description: "Additional notes" },
+          { flags: "--packet-id <packet-id>", description: "Document packet ID" },
+          { flags: "--resolve-incident", description: "Resolve Incident" },
+          { flags: "--resolve-obligation", description: "Resolve Obligation" }
+        ],
+        examples: ["corp compliance escalations-resolve-with-evidence <escalation-id>", "corp compliance escalations-resolve-with-evidence --json"],
+        successTemplate: "Escalations Resolve With Evidence created"
+      },
+      {
+        name: "contractors classify",
+        description: "Classify a worker as employee or contractor",
+        route: { method: "POST", path: "/v1/contractors/classify" },
+        entity: true,
+        options: [
+          { flags: "--contractor-name <contractor-name>", description: "Contractor Name", required: true },
+          { flags: "--duration-months <duration-months>", description: "Duration Months" },
+          { flags: "--exclusive-client <exclusive-client>", description: "Exclusive Client" },
+          { flags: "--factors <factors>", description: "Factors" },
+          { flags: "--hours-per-week <hours-per-week>", description: "Hours Per Week" },
+          { flags: "--provides-tools <provides-tools>", description: "Provides Tools" },
+          { flags: "--state <state>", description: "State" }
+        ],
+        examples: ["corp contractors classify --contractor-name 'contractor-name'", "corp contractors classify --json"],
+        successTemplate: "Classify created"
+      },
+      {
+        name: "deadlines",
+        description: "Create a compliance deadline",
+        route: { method: "POST", path: "/v1/deadlines" },
+        options: [
+          { flags: "--deadline-type <deadline-type>", description: "Deadline Type", required: true },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--due-date <due-date>", description: "Due date (ISO 8601, e.g. 2026-06-30)", required: true },
+          { flags: "--recurrence <recurrence>", description: "Recurrence pattern for a deadline.", choices: ["one_time", "monthly", "quarterly", "annual"] },
+          { flags: "--severity <severity>", description: "Risk severity of missing a deadline.", choices: ["low", "medium", "high", "critical"] }
+        ],
+        examples: ["corp deadlines --deadline-type 'deadline-type' --description 'description' --due-date one_time", "corp deadlines --json"],
+        successTemplate: "Deadlines created"
+      },
+      {
+        name: "entities compliance-escalations",
+        description: "List compliance escalations for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/compliance/escalations" },
+        entity: true,
+        display: { title: "Entities Compliance Escalations", cols: ["action>Action", "authority>Authority", "milestone>Milestone", "@created_at>Created At", "#deadline_id>ID"] },
+        examples: ["corp entities compliance-escalations", "corp entities compliance-escalations --json"]
+      },
+      {
+        name: "tax create-filing",
+        description: "Create a tax filing record",
+        route: { method: "POST", path: "/v1/tax/filings" },
+        entity: true,
+        options: [
+          { flags: "--document-type <document-type>", description: "Type of document required", required: true },
+          { flags: "--tax-year <tax-year>", description: "Tax Year", required: true, type: "int" }
+        ],
+        examples: ["corp tax filings --document-type 'document-type' --tax-year 'tax-year'"],
+        successTemplate: "Filings created"
       }
     ];
   }
@@ -6932,7 +8665,8 @@ var init_agents = __esm({
             console.log(`  ${chalk9.bold("Skills:")} ${agent.skills.map((s3) => s3.name ?? "?").join(", ")}`);
           }
           console.log(chalk9.magenta("\u2500".repeat(40)));
-        }
+        },
+        examples: ["corp agents show"]
       },
       // --- agents create ---
       {
@@ -6942,7 +8676,7 @@ var init_agents = __esm({
         options: [
           { flags: "--name <name>", description: "Agent name", required: true },
           { flags: "--prompt <prompt>", description: "System prompt", required: true },
-          { flags: "--model <model>", description: "Model" }
+          { flags: "--model <model>", description: "LLM model name" }
         ],
         handler: async (ctx) => {
           const data = {
@@ -6973,12 +8707,13 @@ var init_agents = __esm({
           }
         },
         produces: { kind: "agent" },
-        successTemplate: "Agent created: {name}"
+        successTemplate: "Agent created: {name}",
+        examples: ["corp agents create --name 'name' --prompt 'prompt'", "corp agents create --json"]
       },
       // --- agents pause <agent-ref> ---
       {
         name: "agents pause",
-        description: "Pause an agent",
+        description: "Pause an active agent",
         route: { method: "POST", path: "/v1/agents/{pos}/pause" },
         args: [{ name: "agent-ref", required: true, description: "Agent reference" }],
         handler: async (ctx) => {
@@ -6986,7 +8721,8 @@ var init_agents = __esm({
           const resolvedAgentId = await ctx.resolver.resolveAgent(agentRef);
           const result = await ctx.client.updateAgent(resolvedAgentId, { status: "paused" });
           ctx.writer.writeResult(result, `Agent ${resolvedAgentId} paused.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp agents pause <agent-ref>"]
       },
       // --- agents resume <agent-ref> ---
       {
@@ -7013,7 +8749,8 @@ var init_agents = __esm({
             }
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp agents resume <agent-ref>"]
       },
       // --- agents delete <agent-ref> ---
       {
@@ -7039,7 +8776,8 @@ var init_agents = __esm({
           }
           const result = await ctx.client.deleteAgent(resolvedAgentId);
           ctx.writer.writeResult(result, `Agent ${resolvedAgentId} deleted.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp agents delete <agent-ref>", "corp agents delete --json"]
       },
       // --- agents message <agent-ref> ---
       {
@@ -7070,7 +8808,8 @@ var init_agents = __esm({
             }
             process.exit(1);
           }
-        }
+        },
+        examples: ["corp agents message <agent-ref>", "corp agents message --json"]
       },
       // --- agents skill <agent-ref> ---
       {
@@ -7081,7 +8820,7 @@ var init_agents = __esm({
         options: [
           { flags: "--name <name>", description: "Skill name", required: true },
           { flags: "--description <desc>", description: "Skill description", required: true },
-          { flags: "--instructions <text>", description: "Instructions" },
+          { flags: "--instructions <text>", description: "Skill instructions text" },
           { flags: "--instructions-file <path>", description: "Read skill instructions from a file" }
         ],
         handler: async (ctx) => {
@@ -7098,7 +8837,8 @@ var init_agents = __esm({
             parameters: instructions ? { instructions } : {}
           });
           ctx.writer.writeResult(result, `Skill '${ctx.opts.name}' added to agent ${resolvedAgentId}.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp agents skill <agent-ref> --name 'name' --description 'desc'", "corp agents skill --json"]
       },
       // --- agents execution <agent-ref> <execution-id> ---
       {
@@ -7128,7 +8868,8 @@ var init_agents = __esm({
           if (result.started_at) console.log(`  ${chalk9.bold("Started:")} ${result.started_at}`);
           if (result.completed_at) console.log(`  ${chalk9.bold("Completed:")} ${result.completed_at}`);
           console.log(chalk9.magenta("\u2500".repeat(40)));
-        }
+        },
+        examples: ["corp agents execution"]
       },
       // --- agents execution-result <agent-ref> <execution-id> ---
       {
@@ -7151,7 +8892,8 @@ var init_agents = __esm({
           }
           ctx.writer.success(`Result for execution ${executionId}:`);
           printJson(result);
-        }
+        },
+        examples: ["corp agents execution-result"]
       },
       // --- agents kill <agent-ref> <execution-id> ---
       {
@@ -7178,7 +8920,26 @@ var init_agents = __esm({
           }
           const result = await ctx.client.killAgentExecution(resolvedAgentId, executionId);
           ctx.writer.writeResult(result, `Execution ${executionId} killed.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp agents kill <agent-ref> <execution-id>", "corp agents kill --json"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "agents executions-logs",
+        description: "View execution logs for an agent run",
+        route: { method: "GET", path: "/v1/agents/{pos}/executions/{pos2}/logs" },
+        args: [{ name: "agent-id", required: true, description: "Agent ID" }, { name: "execution-id", required: true, description: "Agent execution ID" }],
+        display: { title: "Execution Logs", cols: ["@timestamp>Time", "level>Level", "message>Message"] },
+        examples: ["corp agents executions-logs"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "agents messages",
+        description: "View a specific agent message",
+        route: { method: "GET", path: "/v1/agents/{pos}/messages/{pos2}" },
+        args: [{ name: "agent-id", required: true, description: "Agent ID" }, { name: "message-id", required: true, description: "Message Id" }],
+        display: { title: "Agent Message" },
+        examples: ["corp agents messages"]
       }
     ];
   }
@@ -7284,7 +9045,8 @@ var init_work_items = __esm({
           if (createdBy) console.log(`  ${chalk10.bold("Created by:")} ${createdBy}`);
           console.log(`  ${chalk10.bold("Created at:")} ${w.created_at ?? "N/A"}`);
           console.log(chalk10.cyan("\u2500".repeat(40)));
-        }
+        },
+        examples: ["corp work-items show", "corp work-items show --json"]
       },
       // --- work-items create ---
       {
@@ -7294,8 +9056,8 @@ var init_work_items = __esm({
         entity: true,
         options: [
           { flags: "--title <title>", description: "Work item title", required: true },
-          { flags: "--category <category>", description: "Work item category" },
-          { flags: "--description <desc>", description: "Description" },
+          { flags: "--category <category>", description: "Work item category", required: true },
+          { flags: "--description <desc>", description: "Description text" },
           { flags: "--deadline <date>", description: "Deadline (YYYY-MM-DD)" },
           { flags: "--asap", description: "Mark as ASAP priority" },
           { flags: "--created-by <name>", description: "Creator identifier" }
@@ -7322,7 +9084,8 @@ var init_work_items = __esm({
           );
         },
         produces: { kind: "work_item" },
-        successTemplate: "Work item created: {title}"
+        successTemplate: "Work item created: {title}",
+        examples: ["corp work-items create --title 'title'", "corp work-items create --json"]
       },
       // --- work-items claim <item-ref> ---
       {
@@ -7351,7 +9114,8 @@ var init_work_items = __esm({
           if (ctx.opts.ttl != null) data.ttl_seconds = ctx.opts.ttl;
           const result = await ctx.client.claimWorkItem(eid, resolvedWorkItemId, data);
           ctx.writer.writeResult(result, `Work item ${resolvedWorkItemId} claimed by ${claimedBy}.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp work-items claim <item-ref>", "corp work-items claim --json"]
       },
       // --- work-items complete <item-ref> ---
       {
@@ -7382,7 +9146,8 @@ var init_work_items = __esm({
           if (resultText) data.result = resultText;
           const result = await ctx.client.completeWorkItem(eid, resolvedWorkItemId, data);
           ctx.writer.writeResult(result, `Work item ${resolvedWorkItemId} completed.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp work-items complete <item-ref>", "corp work-items complete --json"]
       },
       // --- work-items release <item-ref> ---
       {
@@ -7397,7 +9162,8 @@ var init_work_items = __esm({
           const resolvedWorkItemId = await ctx.resolver.resolveWorkItem(eid, itemRef);
           const result = await ctx.client.releaseWorkItem(eid, resolvedWorkItemId);
           ctx.writer.writeResult(result, `Work item ${resolvedWorkItemId} claim released.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp work-items release <item-ref>"]
       },
       // --- work-items cancel <item-ref> ---
       {
@@ -7425,7 +9191,8 @@ var init_work_items = __esm({
           }
           const result = await ctx.client.cancelWorkItem(eid, resolvedWorkItemId);
           ctx.writer.writeResult(result, `Work item ${resolvedWorkItemId} cancelled.`, { jsonOnly: ctx.opts.json });
-        }
+        },
+        examples: ["corp work-items cancel <item-ref>", "corp work-items cancel --json"]
       }
     ];
   }
@@ -7456,7 +9223,8 @@ var init_services = __esm({
             return;
           }
           printServiceCatalogTable(items);
-        }
+        },
+        examples: ["corp services", "corp services --json"]
       },
       // --- services catalog ---
       {
@@ -7474,7 +9242,8 @@ var init_services = __esm({
             return;
           }
           printServiceCatalogTable(items);
-        }
+        },
+        examples: ["corp services catalog"]
       },
       // --- services list ---
       {
@@ -7495,7 +9264,8 @@ var init_services = __esm({
             return;
           }
           printServiceRequestsTable(stable);
-        }
+        },
+        examples: ["corp services list", "corp services list --json"]
       },
       // --- services show <ref> ---
       {
@@ -7518,7 +9288,8 @@ var init_services = __esm({
           }
           printReferenceSummary("service_request", result);
           printJson(result);
-        }
+        },
+        examples: ["corp services show", "corp services show --json"]
       },
       // --- services buy <slug> ---
       {
@@ -7563,7 +9334,8 @@ var init_services = __esm({
           }
         },
         produces: { kind: "service_request" },
-        successTemplate: "Service request created"
+        successTemplate: "Service request created",
+        examples: ["corp services buy <slug>"]
       },
       // --- services fulfill <ref> ---
       {
@@ -7592,7 +9364,8 @@ var init_services = __esm({
           ctx.writer.success(`Service request fulfilled: ${requestId}`);
           printReferenceSummary("service_request", result, { showReuseHint: true });
           printJson(result);
-        }
+        },
+        examples: ["corp services fulfill <ref>", "corp services fulfill --json"]
       },
       // --- services cancel <ref> ---
       {
@@ -7617,7 +9390,56 @@ var init_services = __esm({
           ctx.writer.success(`Service request cancelled: ${requestId}`);
           printReferenceSummary("service_request", result, { showReuseHint: true });
           printJson(result);
-        }
+        },
+        examples: ["corp services cancel <ref>"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "services create-request",
+        description: "Submit a new service request",
+        route: { method: "POST", path: "/v1/services/requests" },
+        options: [
+          { flags: "--obligation-id <obligation-id>", description: "Obligation ID" },
+          { flags: "--service-slug <service-slug>", description: "Service Slug", required: true }
+        ],
+        examples: ["corp services requests --service-slug 'service-slug'", "corp services requests --json"],
+        successTemplate: "Requests created"
+      },
+      {
+        name: "services requests",
+        description: "Submit a new service request",
+        route: { method: "GET", path: "/v1/services/requests/{pos}" },
+        entity: true,
+        args: [{ name: "request-id", required: true, description: "Document request ID" }],
+        display: { title: "Services Requests", cols: ["amount_cents>Amount Cents", "checkout_url>Checkout Url", "failed_at>Failed At", "fulfilled_at>Fulfilled At", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp services requests", "corp services requests --json"]
+      },
+      {
+        name: "services requests-cancel",
+        description: "Cancel a service request",
+        route: { method: "POST", path: "/v1/services/requests/{pos}/cancel" },
+        args: [{ name: "request-id", required: true, description: "Document request ID" }],
+        examples: ["corp services requests-cancel <request-id>"],
+        successTemplate: "Requests Cancel created"
+      },
+      {
+        name: "services requests-checkout",
+        description: "Start checkout for a service request",
+        route: { method: "POST", path: "/v1/services/requests/{pos}/checkout" },
+        args: [{ name: "request-id", required: true, description: "Document request ID" }],
+        examples: ["corp services requests-checkout <request-id>"],
+        successTemplate: "Requests Checkout created"
+      },
+      {
+        name: "services requests-fulfill",
+        description: "Fulfill a service request",
+        route: { method: "POST", path: "/v1/services/requests/{pos}/fulfill" },
+        args: [{ name: "request-id", required: true, description: "Document request ID" }],
+        options: [
+          { flags: "--note <note>", description: "Note" }
+        ],
+        examples: ["corp services requests-fulfill <request-id>", "corp services requests-fulfill --json"],
+        successTemplate: "Requests Fulfill created"
       }
     ];
   }
@@ -9055,13 +10877,15 @@ var init_admin = __esm({
         handler: async () => {
           const { setupCommand: setupCommand2 } = await Promise.resolve().then(() => (init_setup(), setup_exports));
           await setupCommand2();
-        }
+        },
+        examples: ["corp setup"]
       },
       // ── config (local) ──────────────────────────────────────────────────
       {
         name: "config",
         description: "Manage configuration",
-        local: true
+        local: true,
+        examples: ["corp config"]
       },
       {
         name: "config set",
@@ -9081,7 +10905,8 @@ var init_admin = __esm({
             ctx.positional[1],
             { force: ctx.opts.force }
           );
-        }
+        },
+        examples: ["corp config set"]
       },
       {
         name: "config get",
@@ -9093,7 +10918,8 @@ var init_admin = __esm({
         handler: async (ctx) => {
           const { configGetCommand: configGetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
           configGetCommand2(ctx.positional[0]);
-        }
+        },
+        examples: ["corp config get"]
       },
       {
         name: "config list",
@@ -9102,7 +10928,8 @@ var init_admin = __esm({
         handler: async () => {
           const { configListCommand: configListCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
           configListCommand2();
-        }
+        },
+        examples: ["corp config list"]
       },
       // ── schema (local, special) ─────────────────────────────────────────
       {
@@ -9134,7 +10961,8 @@ var init_admin = __esm({
           } else {
             ctx.writer.json(schema);
           }
-        }
+        },
+        examples: ["corp schema"]
       },
       // ── serve (local, complex) ──────────────────────────────────────────
       {
@@ -9151,7 +10979,8 @@ var init_admin = __esm({
             port: ctx.opts.port ?? "8000",
             dataDir: ctx.opts.dataDir ?? "./data/repos"
           });
-        }
+        },
+        examples: ["corp serve"]
       },
       // ── demo (complex, uses API) ────────────────────────────────────────
       {
@@ -9172,7 +11001,8 @@ var init_admin = __esm({
             minimal: ctx.opts.minimal,
             json: ctx.opts.json
           });
-        }
+        },
+        examples: ["corp demo"]
       },
       // ── chat (local, interactive) ───────────────────────────────────────
       {
@@ -9182,7 +11012,8 @@ var init_admin = __esm({
         handler: async () => {
           const { chatCommand: chatCommand2 } = await Promise.resolve().then(() => (init_chat(), chat_exports));
           await chatCommand2();
-        }
+        },
+        examples: ["corp chat"]
       },
       // ── api-keys (API, parent + subcommands) ────────────────────────────
       {
@@ -9196,7 +11027,8 @@ var init_admin = __esm({
         handler: async (ctx) => {
           const { apiKeysListCommand: apiKeysListCommand2 } = await Promise.resolve().then(() => (init_api_keys(), api_keys_exports));
           await apiKeysListCommand2({ json: ctx.opts.json });
-        }
+        },
+        examples: ["corp api-keys"]
       },
       {
         name: "api-keys create",
@@ -9216,7 +11048,8 @@ var init_admin = __esm({
           });
         },
         produces: { kind: "api_key" },
-        successTemplate: "API key created"
+        successTemplate: "API key created",
+        examples: ["corp api-keys create --name 'name'", "corp api-keys create --json"]
       },
       {
         name: "api-keys revoke",
@@ -9235,7 +11068,8 @@ var init_admin = __esm({
             yes: ctx.opts.yes,
             json: ctx.opts.json
           });
-        }
+        },
+        examples: ["corp api-keys revoke <key-id>", "corp api-keys revoke --json"]
       },
       {
         name: "api-keys rotate",
@@ -9254,7 +11088,8 @@ var init_admin = __esm({
           });
         },
         produces: { kind: "api_key" },
-        successTemplate: "API key rotated"
+        successTemplate: "API key rotated",
+        examples: ["corp api-keys rotate <key-id>", "corp api-keys rotate --json"]
       },
       // ── link (API, write) ───────────────────────────────────────────────
       {
@@ -9271,7 +11106,8 @@ var init_admin = __esm({
             externalId: ctx.opts.externalId,
             provider: ctx.opts.provider
           });
-        }
+        },
+        examples: ["corp link --external-id 'id' --provider 'provider'"]
       },
       // ── claim (API, write) ──────────────────────────────────────────────
       {
@@ -9285,7 +11121,8 @@ var init_admin = __esm({
           const { claimCommand: claimCommand2 } = await Promise.resolve().then(() => (init_claim(), claim_exports));
           await claimCommand2(ctx.positional[0]);
         },
-        produces: { kind: "entity", trackEntity: true }
+        produces: { kind: "entity", trackEntity: true },
+        examples: ["corp claim <code>"]
       },
       // ── feedback (API, write) ───────────────────────────────────────────
       {
@@ -9306,7 +11143,8 @@ var init_admin = __esm({
             email: ctx.opts.email,
             json: ctx.opts.json
           });
-        }
+        },
+        examples: ["corp feedback <message>", "corp feedback --json"]
       },
       // ── resolve (API, read) ─────────────────────────────────────────────
       {
@@ -9328,7 +11166,8 @@ var init_admin = __esm({
             bodyId: ctx.opts.bodyId,
             meetingId: ctx.opts.meetingId
           });
-        }
+        },
+        examples: ["corp resolve"]
       },
       // ── find (API, read) ────────────────────────────────────────────────
       {
@@ -9352,7 +11191,8 @@ var init_admin = __esm({
             meetingId: ctx.opts.meetingId,
             json: ctx.opts.json
           });
-        }
+        },
+        examples: ["corp find"]
       },
       // ── approvals (informational) ───────────────────────────────────────
       {
@@ -9364,7 +11204,951 @@ var init_admin = __esm({
             'Approvals are managed through governance meetings and execution intents.\nUse these commands to manage approvals:\n\n  Board approval via meeting vote:\n    corp governance convene --body <body> --type board_meeting --title "Approve X"\n    corp governance vote <meeting> <item> --voter <contact> --vote for\n\n  Written consent (no meeting needed):\n    corp governance written-consent --body <body> --title "Approve X" --description "..."\n\n  View pending items:\n    corp governance meetings <body>        # see scheduled meetings\n    corp governance agenda-items <meeting>  # see items awaiting votes\n    corp cap-table valuations               # see pending valuations\n'
           );
           process.exit(1);
-        }
+        },
+        examples: ["corp approvals"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "admin audit-events",
+        description: "View audit log of workspace events",
+        route: { method: "GET", path: "/v1/admin/audit-events" },
+        display: { title: "Admin Audit Events", cols: ["details>Details", "#event_id>ID", "event_type>Event Type", "timestamp>Timestamp"] },
+        examples: ["corp admin audit-events"]
+      },
+      {
+        name: "admin system-health",
+        description: "Check API server health and uptime",
+        route: { method: "GET", path: "/v1/admin/system-health" },
+        display: { title: "Admin System Health", cols: ["git_storage>Git Storage", "status>Status", "uptime_seconds>Uptime Seconds", "version>Version", "workspace_count>Workspace Count"] },
+        examples: ["corp admin system-health"]
+      },
+      {
+        name: "admin workspaces",
+        description: "List all workspaces (admin)",
+        route: { method: "GET", path: "/v1/admin/workspaces" },
+        display: { title: "Admin Workspaces", cols: ["entity_count>Entity Count", "name>Name", "#workspace_id>ID"] },
+        examples: ["corp admin workspaces"]
+      },
+      {
+        name: "billing plans",
+        description: "View available billing plans",
+        route: { method: "GET", path: "/v1/billing/plans" },
+        display: { title: "Billing Plans", cols: ["plans>Plans"] },
+        examples: ["corp billing plans"]
+      },
+      {
+        name: "billing status",
+        description: "Check current billing and subscription status",
+        route: { method: "GET", path: "/v1/billing/status" },
+        display: { title: "Billing Status", cols: ["current_period_end>Current Period End", "plan>Plan", "status>Status", "#workspace_id>ID"] },
+        examples: ["corp billing status"]
+      },
+      {
+        name: "server-config",
+        description: "View server configuration (environment, version, features)",
+        route: { method: "GET", path: "/v1/config" },
+        display: { title: "Server Config", cols: ["environment>Environment", "version>Version", "features>Features"] },
+        examples: ["corp server-config", "corp server-config --json"]
+      },
+      {
+        name: "demo seed",
+        description: "Seed a demo workspace with sample data",
+        route: { method: "POST", path: "/v1/demo/seed" },
+        options: [
+          { flags: "--name <name>", description: "Display name" },
+          { flags: "--scenario <scenario>", description: "Demo scenario to use" }
+        ],
+        examples: ["corp demo seed", "corp demo seed --json"],
+        successTemplate: "Seed created"
+      },
+      {
+        name: "digests trigger",
+        description: "Trigger digest generation now",
+        route: { method: "POST", path: "/v1/digests/trigger" },
+        examples: ["corp digests trigger"],
+        successTemplate: "Trigger created"
+      },
+      {
+        name: "digests",
+        description: "View a specific digest by key",
+        route: { method: "GET", path: "/v1/digests/{pos}" },
+        args: [{ name: "digest-key", required: true, description: "Digest key" }],
+        display: { title: "Digest" },
+        examples: ["corp digests"]
+      },
+      {
+        name: "service-token",
+        description: "Get a service authentication token",
+        route: { method: "GET", path: "/v1/service-token" },
+        display: { title: "Service Token", cols: ["#api_key_id>ID", "expires_in>Expires In", "token>Token", "token_type>Token Type"] },
+        examples: ["corp service-token"]
+      },
+      {
+        name: "workspace entities",
+        description: "List entities in current workspace",
+        route: { method: "GET", path: "/v1/workspace/entities" },
+        display: { title: "Workspace Entities", cols: ["#entity_id>ID"] },
+        examples: ["corp workspace entities"]
+      },
+      {
+        name: "workspace status",
+        description: "Show current workspace status",
+        route: { method: "GET", path: "/v1/workspace/status" },
+        display: { title: "Workspace Status", cols: ["entity_count>Entity Count", "name>Name", "status>Status", "#workspace_id>ID"] },
+        examples: ["corp workspace status"]
+      },
+      {
+        name: "workspaces claim",
+        description: "Claim a workspace using a claim token",
+        route: { method: "POST", path: "/v1/workspaces/claim" },
+        options: [
+          { flags: "--claim-token <claim-token>", description: "Workspace claim token", required: true }
+        ],
+        examples: ["corp workspaces claim --claim-token 'claim-token'"],
+        successTemplate: "Claim created"
+      },
+      {
+        name: "workspaces contacts",
+        description: "List contacts across the workspace",
+        route: { method: "GET", path: "/v1/workspaces/{workspace_id}/contacts" },
+        display: { title: "Workspaces Contacts", cols: ["#contact_id>ID", "#entity_id>ID"] },
+        examples: ["corp workspaces contacts"]
+      },
+      {
+        name: "workspaces entities",
+        description: "List all entities in a workspace",
+        route: { method: "GET", path: "/v1/workspaces/{workspace_id}/entities" },
+        display: { title: "Workspaces Entities", cols: ["#entity_id>ID"] },
+        examples: ["corp workspaces entities"]
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "auth token-exchange",
+        description: "Exchange an API key for a short-lived JWT",
+        route: { method: "POST", path: "/v1/auth/token-exchange" },
+        options: [
+          { flags: "--api-key <api-key>", description: "API key (starts with sk_)", required: true },
+          { flags: "--ttl-seconds <ttl-seconds>", description: "Token TTL in seconds (60-86400)", type: "int" }
+        ],
+        examples: ["corp auth token-exchange --api-key 'api-key'", "corp auth token-exchange --json"],
+        successTemplate: "Token Exchange created"
+      },
+      {
+        name: "ssh-keys",
+        description: "List registered SSH public keys",
+        route: { method: "GET", path: "/v1/ssh-keys" },
+        display: { title: "SSH Keys", cols: ["name>Name", "algorithm>Algorithm", "fingerprint>Fingerprint", "@created_at>Created", "#key_id>ID"] },
+        examples: ["corp ssh-keys"]
+      },
+      {
+        name: "ssh-keys add",
+        description: "Register a new SSH public key",
+        route: { method: "POST", path: "/v1/ssh-keys" },
+        options: [
+          { flags: "--name <name>", description: "Key name/label", required: true },
+          { flags: "--public-key <key>", description: "SSH public key in OpenSSH format", required: true },
+          { flags: "--scopes <scopes>", description: "Comma-separated scopes (e.g. git_read,git_write)", type: "array" },
+          { flags: "--entity-ids <ids>", description: "Restrict key to specific entity IDs" },
+          { flags: "--contact-id <id>", description: "Associate with a contact" }
+        ],
+        examples: ["corp ssh-keys add --name laptop --public-key 'ssh-ed25519 AAAA...'", "corp ssh-keys add --name ci --public-key 'ssh-ed25519 AAAA...' --scopes git_read,git_write"],
+        successTemplate: "SSH key {name} added ({fingerprint})"
+      },
+      {
+        name: "ssh-keys revoke",
+        description: "Revoke an SSH public key",
+        route: { method: "DELETE", path: "/v1/ssh-keys/{pos}" },
+        args: [{ name: "key-id", required: true, description: "SSH key ID to revoke" }],
+        examples: ["corp ssh-keys revoke <key-id>"],
+        successTemplate: "SSH key revoked"
+      },
+      {
+        name: "workspaces provision",
+        description: "Provision a new workspace",
+        route: { method: "POST", path: "/v1/workspaces/provision" },
+        options: [
+          { flags: "--name <name>", description: "Display name", required: true },
+          { flags: "--owner-email <owner-email>", description: "Workspace owner email address" }
+        ],
+        examples: ["corp workspaces provision --name 'name'", "corp workspaces provision --json"],
+        successTemplate: "Provision created"
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "references sync",
+        description: "Sync reference aliases for a resource kind",
+        route: { method: "POST", path: "/v1/references/sync" },
+        options: [
+          { flags: "--items <items>", description: "Items to sync (JSON array)", required: true, type: "array" },
+          { flags: "--kind <kind>", description: "Resource kind", required: true, choices: ["entity", "contact", "share_transfer", "invoice", "bank_account", "payment", "payroll_run", "distribution", "reconciliation", "tax_filing", "deadline", "classification", "body", "meeting", "seat", "agenda_item", "resolution", "document", "work_item", "agent", "valuation", "safe_note", "instrument", "share_class", "round"] }
+        ],
+        examples: ["corp references sync --items 'items' --kind 'kind'"],
+        successTemplate: "Sync created"
+      },
+      // ── Auto-generated from OpenAPI ──────────────────────────────
+      {
+        name: "secrets interpolate",
+        description: "Interpolate secrets into a template string",
+        route: { method: "POST", path: "/v1/secrets/interpolate" },
+        options: [
+          { flags: "--execution-id <execution-id>", description: "Agent execution ID", required: true },
+          { flags: "--template <template>", description: "Template string with {{secret}} placeholders", required: true }
+        ],
+        examples: ["corp secrets interpolate --execution-id 'execution-id' --template 'template'"],
+        successTemplate: "Interpolate created"
+      },
+      {
+        name: "secrets resolve",
+        description: "Resolve a secrets token to its values",
+        route: { method: "POST", path: "/v1/secrets/resolve" },
+        options: [
+          { flags: "--token <token>", description: "Secrets access token", required: true }
+        ],
+        examples: ["corp secrets resolve --token 'token'"],
+        successTemplate: "Resolve created"
+      },
+      {
+        name: "documents validate-preview",
+        description: "Validate a document preview without generating PDF",
+        route: { method: "GET", path: "/v1/documents/preview/pdf/validate" },
+        entity: true,
+        display: { title: "Document Preview Validation" },
+        examples: ["corp documents validate-preview", "corp documents validate-preview --json"]
+      }
+    ];
+  }
+});
+
+// src/registry/execution.ts
+var executionCommands;
+var init_execution = __esm({
+  "src/registry/execution.ts"() {
+    "use strict";
+    executionCommands = [
+      {
+        name: "document-requests fulfill",
+        description: "Fulfill a document request with uploaded content",
+        route: { method: "PATCH", path: "/v1/document-requests/{pos}/fulfill" },
+        entity: true,
+        args: [{ name: "request-id", required: true, description: "Document request ID" }],
+        examples: ["corp document-requests fulfill <request-id>"],
+        successTemplate: "Fulfill updated"
+      },
+      {
+        name: "document-requests not-applicable",
+        description: "Mark a document request as not applicable",
+        route: { method: "PATCH", path: "/v1/document-requests/{pos}/not-applicable" },
+        entity: true,
+        args: [{ name: "request-id", required: true, description: "Document request ID" }],
+        examples: ["corp document-requests not-applicable <request-id>"],
+        successTemplate: "Not Applicable updated"
+      },
+      {
+        name: "entities approval-artifacts",
+        description: "List approval artifacts for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/approval-artifacts" },
+        entity: true,
+        display: { title: "Entities Approval Artifacts", cols: ["approved_at>Approved At", "approver_identity>Approver Identity", "channel>Channel", "expires_at>Expires At", "@created_at>Created At", "#approval_artifact_id>ID"] },
+        examples: ["corp entities approval-artifacts", "corp entities approval-artifacts --json"]
+      },
+      {
+        name: "entities intents",
+        description: "List execution intents for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/intents" },
+        entity: true,
+        display: { title: "Entities Intents", cols: ["authority_tier>Authority Tier", "authorized_at>Authorized At", "bound_document_request_ids>Bound Document Request Ids", "cancelled_at>Cancelled At", "@created_at>Created At", "#bound_approval_artifact_id>ID"] },
+        examples: ["corp entities intents", "corp entities intents --json"]
+      },
+      {
+        name: "entities obligations",
+        description: "List obligations for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/obligations" },
+        entity: true,
+        display: { title: "Entities Obligations", cols: ["assignee_type>Assignee Type", "description>Description", "expired_at>Expired At", "fulfilled_at>Fulfilled At", "@created_at>Created At", "#assignee_id>ID"] },
+        examples: ["corp entities obligations", "corp entities obligations --json"]
+      },
+      {
+        name: "entities obligations-human",
+        description: "List human-actionable obligations for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/obligations/human" },
+        entity: true,
+        display: { title: "Entities Obligations Human", cols: ["assignee_type>Assignee Type", "description>Description", "expired_at>Expired At", "fulfilled_at>Fulfilled At", "@created_at>Created At", "#assignee_id>ID"] },
+        examples: ["corp entities obligations-human", "corp entities obligations-human --json"]
+      },
+      {
+        name: "entities obligations-summary",
+        description: "View obligation summary (pending/fulfilled/expired)",
+        route: { method: "GET", path: "/v1/entities/{eid}/obligations/summary" },
+        entity: true,
+        display: { title: "Entities Obligations Summary", cols: ["expired>Expired", "fulfilled>Fulfilled", "pending>Pending", "total>Total", "waived>Waived"] },
+        examples: ["corp entities obligations-summary", "corp entities obligations-summary --json"]
+      },
+      {
+        name: "entities packets",
+        description: "List document packets for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/packets" },
+        entity: true,
+        display: { title: "Entities Packets", cols: ["finalized_at>Finalized At", "items>Items", "manifest_hash>Manifest Hash", "required_signers>Required Signers", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp entities packets", "corp entities packets --json"]
+      },
+      {
+        name: "execution approval-artifacts",
+        description: "Create an approval artifact (e.g. board vote record)",
+        route: { method: "POST", path: "/v1/execution/approval-artifacts" },
+        entity: true,
+        options: [
+          { flags: "--approved-at <approved-at>", description: "Timestamp of approval (ISO 8601)" },
+          { flags: "--approver-identity <approver-identity>", description: "Identity of the approver", required: true },
+          { flags: "--channel <channel>", description: "Approval channel (board_vote, written_consent, etc.)", required: true },
+          { flags: "--expires-at <expires-at>", description: "Expiration timestamp (ISO 8601)" },
+          { flags: "--explicit", description: "Whether approval is explicit (vs implied)" },
+          { flags: "--intent-type <intent-type>", description: "Type of intent", required: true },
+          { flags: "--max-amount-cents <max-amount-cents>", description: "Maximum authorized amount in cents" },
+          { flags: "--scope <scope>", description: "Authorization scope", required: true }
+        ],
+        examples: ["corp execution approval-artifacts --approver-identity 'approver-identity' --channel 'channel' --intent-type 'intent-type' --scope 'scope'", "corp execution approval-artifacts --json"],
+        successTemplate: "Approval Artifacts created"
+      },
+      {
+        name: "execution intents",
+        description: "Create an execution intent (action requiring authorization)",
+        route: { method: "POST", path: "/v1/execution/intents" },
+        entity: true,
+        options: [
+          { flags: "--authority-tier <authority-tier>", description: "Authority tier required (tier_1, tier_2, tier_3)", choices: ["tier_1", "tier_2", "tier_3"] },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--intent-type <intent-type>", description: "Type of intent", required: true },
+          { flags: "--metadata <metadata>", description: "Additional metadata (JSON)" }
+        ],
+        examples: ["corp execution intents --description 'description' --intent-type 'intent-type'", "corp execution intents --json"],
+        successTemplate: "Intents created"
+      },
+      {
+        name: "execution obligations",
+        description: "Create an obligation (task assigned to a party)",
+        route: { method: "POST", path: "/v1/execution/obligations" },
+        entity: true,
+        options: [
+          { flags: "--assignee-id <assignee-id>", description: "ID of the party to assign to" },
+          { flags: "--assignee-type <assignee-type>", description: "Who is responsible for fulfilling an obligation.", required: true, choices: ["internal", "third_party", "human"] },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--due-date <due-date>", description: "Due date (ISO 8601, e.g. 2026-06-30)" },
+          { flags: "--intent-id <intent-id>", description: "Execution intent ID" },
+          { flags: "--obligation-type <obligation-type>", description: "Type of obligation", required: true }
+        ],
+        examples: ["corp execution obligations --assignee-type internal --description 'description' --obligation-type 'obligation-type'", "corp execution obligations --json"],
+        successTemplate: "Obligations created"
+      },
+      {
+        name: "execution packets",
+        description: "View a document packet",
+        route: { method: "GET", path: "/v1/execution/packets/{pos}" },
+        entity: true,
+        args: [{ name: "packet-id", required: true, description: "Document packet ID" }],
+        display: { title: "Execution Packets", cols: ["finalized_at>Finalized At", "items>Items", "manifest_hash>Manifest Hash", "required_signers>Required Signers", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp execution packets", "corp execution packets --json"]
+      },
+      {
+        name: "intents authorize",
+        description: "Authorize an execution intent",
+        route: { method: "POST", path: "/v1/intents/{pos}/authorize" },
+        entity: true,
+        args: [{ name: "intent-id", required: true, description: "Execution intent ID" }],
+        examples: ["corp intents authorize <intent-id>"],
+        successTemplate: "Authorize created"
+      },
+      {
+        name: "intents bind-approval-artifact",
+        description: "Bind an approval artifact to an intent",
+        route: { method: "POST", path: "/v1/intents/{pos}/bind-approval-artifact" },
+        args: [{ name: "intent-id", required: true, description: "Execution intent ID" }],
+        options: [
+          { flags: "--approval-artifact-id <approval-artifact-id>", description: "Approval artifact ID to bind", required: true }
+        ],
+        examples: ["corp intents bind-approval-artifact <intent-id> --approval-artifact-id 'approval-artifact-id'"],
+        successTemplate: "Bind Approval Artifact created"
+      },
+      {
+        name: "intents bind-document-request",
+        description: "Bind a document request to an intent",
+        route: { method: "POST", path: "/v1/intents/{pos}/bind-document-request" },
+        args: [{ name: "intent-id", required: true, description: "Execution intent ID" }],
+        options: [
+          { flags: "--request-id <request-id>", description: "Document request ID", required: true }
+        ],
+        examples: ["corp intents bind-document-request <intent-id> --request-id 'request-id'"],
+        successTemplate: "Bind Document Request created"
+      },
+      {
+        name: "intents cancel",
+        description: "Cancel an execution intent",
+        route: { method: "POST", path: "/v1/intents/{pos}/cancel" },
+        entity: true,
+        args: [{ name: "intent-id", required: true, description: "Execution intent ID" }],
+        examples: ["corp intents cancel <intent-id>"],
+        successTemplate: "Cancel created"
+      },
+      {
+        name: "intents evaluate",
+        description: "Evaluate whether an intent meets its requirements",
+        route: { method: "POST", path: "/v1/intents/{pos}/evaluate" },
+        entity: true,
+        args: [{ name: "intent-id", required: true, description: "Execution intent ID" }],
+        examples: ["corp intents evaluate <intent-id>"],
+        successTemplate: "Evaluate created"
+      },
+      {
+        name: "intents execute",
+        description: "Execute an authorized intent",
+        route: { method: "POST", path: "/v1/intents/{pos}/execute" },
+        entity: true,
+        args: [{ name: "intent-id", required: true, description: "Execution intent ID" }],
+        examples: ["corp intents execute <intent-id>"],
+        successTemplate: "Execute created"
+      },
+      {
+        name: "intents receipts",
+        description: "View execution receipts for an intent",
+        route: { method: "GET", path: "/v1/intents/{pos}/receipts" },
+        entity: true,
+        args: [{ name: "intent-id", required: true, description: "Execution intent ID" }],
+        display: { title: "Intents Receipts", cols: ["executed_at>Executed At", "idempotency_key>Idempotency Key", "request_hash>Request Hash", "response_hash>Response Hash", "@created_at>Created At", "#intent_id>ID"] },
+        examples: ["corp intents receipts", "corp intents receipts --json"]
+      },
+      {
+        name: "obligations assign",
+        description: "Assign an obligation to a party",
+        route: { method: "POST", path: "/v1/obligations/{pos}/assign" },
+        entity: true,
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        options: [
+          { flags: "--assignee-id <assignee-id>", description: "ID of the party to assign to", required: true }
+        ],
+        examples: ["corp obligations assign <obligation-id> --assignee-id 'assignee-id'"],
+        successTemplate: "Assign created"
+      },
+      {
+        name: "obligations document-requests",
+        description: "List or create document requests for an obligation",
+        route: { method: "GET", path: "/v1/obligations/{pos}/document-requests" },
+        entity: true,
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        display: { title: "Obligations Document Requests", cols: ["description>Description", "document_type>Document Type", "fulfilled_at>Fulfilled At", "not_applicable_at>Not Applicable At", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp obligations document-requests", "corp obligations document-requests --json"]
+      },
+      {
+        name: "obligations create-document-request",
+        description: "List or create document requests for an obligation",
+        route: { method: "POST", path: "/v1/obligations/{pos}/document-requests" },
+        entity: true,
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        options: [
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--document-type <document-type>", description: "Type of document required", required: true }
+        ],
+        examples: ["corp obligations document-requests <obligation-id> --description 'description' --document-type 'document-type'"],
+        successTemplate: "Document Requests created"
+      },
+      {
+        name: "obligations expire",
+        description: "Mark an obligation as expired",
+        route: { method: "POST", path: "/v1/obligations/{pos}/expire" },
+        entity: true,
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        examples: ["corp obligations expire <obligation-id>"],
+        successTemplate: "Expire created"
+      },
+      {
+        name: "obligations fulfill",
+        description: "Mark an obligation as fulfilled",
+        route: { method: "POST", path: "/v1/obligations/{pos}/fulfill" },
+        entity: true,
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        examples: ["corp obligations fulfill <obligation-id>"],
+        successTemplate: "Fulfill created"
+      },
+      {
+        name: "obligations waive",
+        description: "Waive an obligation",
+        route: { method: "POST", path: "/v1/obligations/{pos}/waive" },
+        entity: true,
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        examples: ["corp obligations waive <obligation-id>"],
+        successTemplate: "Waive created"
+      },
+      {
+        name: "receipts",
+        description: "View an execution receipt",
+        route: { method: "GET", path: "/v1/receipts/{pos}" },
+        entity: true,
+        args: [{ name: "receipt-id", required: true, description: "Execution receipt ID" }],
+        display: { title: "Receipts", cols: ["executed_at>Executed At", "idempotency_key>Idempotency Key", "request_hash>Request Hash", "response_hash>Response Hash", "@created_at>Created At", "#intent_id>ID"] },
+        examples: ["corp receipts", "corp receipts --json"]
+      },
+      // ── Human obligations ───────────────────────────────────────────────
+      {
+        name: "human-obligations",
+        description: "List obligations requiring human action (signing, upload)",
+        route: { method: "GET", path: "/v1/human-obligations" },
+        display: {
+          title: "Human Obligations",
+          cols: ["obligation_type>Type", "status>Status", "@due_at>Due", "#obligation_id>ID"]
+        },
+        examples: ["corp human-obligations"]
+      },
+      {
+        name: "human-obligations fulfill",
+        description: "Fulfill a human obligation",
+        route: { method: "POST", path: "/v1/human-obligations/{pos}/fulfill" },
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        successTemplate: "Obligation fulfilled",
+        examples: ["corp human-obligations fulfill <obligation-id>"]
+      },
+      {
+        name: "human-obligations signer-token",
+        description: "Get a signing token for a human obligation",
+        route: { method: "POST", path: "/v1/human-obligations/{pos}/signer-token" },
+        args: [{ name: "obligation-id", required: true, description: "Obligation ID" }],
+        successTemplate: "Signer token issued",
+        examples: ["corp human-obligations signer-token <obligation-id>"]
+      }
+    ];
+  }
+});
+
+// src/registry/secret-proxies.ts
+var secretProxyCommands;
+var init_secret_proxies = __esm({
+  "src/registry/secret-proxies.ts"() {
+    "use strict";
+    secretProxyCommands = [
+      {
+        name: "secret-proxies",
+        description: "List secret proxies for the workspace",
+        route: { method: "GET", path: "/v1/workspaces/{wid}/secret-proxies" },
+        display: {
+          title: "Secret Proxies",
+          cols: ["name>Name", "url>URL", "description>Description", "secret_count>Secrets", "@created_at>Created"]
+        },
+        examples: ["corp secret-proxies"]
+      },
+      {
+        name: "secret-proxies create",
+        description: "Create a secret proxy",
+        route: { method: "POST", path: "/v1/workspaces/{wid}/secret-proxies" },
+        options: [
+          { flags: "--name <name>", description: "Proxy name", required: true },
+          { flags: "--url <url>", description: "Proxy URL (or 'self' for local encrypted secrets)", required: true },
+          { flags: "--description <desc>", description: "Description text" }
+        ],
+        successTemplate: "Secret proxy {name} created",
+        examples: ["corp secret-proxies create --name 'name' --url 'url'", "corp secret-proxies create --json"]
+      },
+      {
+        name: "secret-proxies show",
+        description: "Show a secret proxy",
+        route: { method: "GET", path: "/v1/workspaces/{wid}/secret-proxies/{pos}" },
+        args: [{ name: "proxy-name", required: true, description: "Proxy name" }],
+        display: {
+          title: "Secret Proxy",
+          cols: ["name>Name", "url>URL", "description>Description", "secret_count>Secrets", "@created_at>Created"]
+        },
+        examples: ["corp secret-proxies show"]
+      },
+      {
+        name: "secret-proxies secrets",
+        description: "List secret names in a proxy",
+        route: { method: "GET", path: "/v1/workspaces/{wid}/secret-proxies/{pos}/secrets" },
+        args: [{ name: "proxy-name", required: true, description: "Proxy name" }],
+        display: {
+          title: "Secrets",
+          cols: ["names>Secret Names", "proxy_name>Proxy"]
+        },
+        examples: ["corp secret-proxies secrets"]
+      },
+      {
+        name: "secret-proxies set-secrets",
+        description: "Set secrets in a proxy (key-value pairs, server encrypts)",
+        route: { method: "PUT", path: "/v1/workspaces/{wid}/secret-proxies/{pos}/secrets" },
+        args: [{ name: "proxy-name", required: true, description: "Proxy name" }],
+        options: [
+          { flags: "--secrets <json>", description: "JSON object of key-value secret pairs", required: true }
+        ],
+        successTemplate: "Secrets updated for {proxy_name}",
+        examples: ["corp secret-proxies set-secrets <proxy-name> --secrets 'json'"]
+      }
+    ];
+  }
+});
+
+// src/registry/treasury.ts
+var treasuryCommands;
+var init_treasury = __esm({
+  "src/registry/treasury.ts"() {
+    "use strict";
+    treasuryCommands = [
+      {
+        name: "bank-accounts close",
+        description: "Close a bank account",
+        route: { method: "POST", path: "/v1/bank-accounts/{pos}/close" },
+        entity: true,
+        args: [{ name: "bank-account-id", required: true, description: "Bank account ID" }],
+        examples: ["corp bank-accounts close <bank-account-id>"],
+        successTemplate: "Close created"
+      },
+      {
+        name: "distributions",
+        description: "Record a distribution (dividend, member draw)",
+        route: { method: "POST", path: "/v1/distributions" },
+        options: [
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--distribution-type <distribution-type>", description: "Type of distribution.", choices: ["dividend", "return", "liquidation"] },
+          { flags: "--total-amount-cents <total-amount-cents>", description: "Total Amount Cents", required: true, type: "int" }
+        ],
+        examples: ["corp distributions --description dividend --total-amount-cents 'total-amount-cents'", "corp distributions --json"],
+        successTemplate: "Distributions created"
+      },
+      {
+        name: "entities accounts",
+        description: "List ledger accounts for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/accounts" },
+        entity: true,
+        display: { title: "Entities Accounts", cols: ["account_code>Account Code", "account_name>Account Name", "account_type>Account Type", "currency>Currency", "@created_at>Created At", "#account_id>ID"] },
+        examples: ["corp entities accounts", "corp entities accounts --json"]
+      },
+      {
+        name: "entities journal-entries",
+        description: "List journal entries for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/journal-entries" },
+        entity: true,
+        display: { title: "Entities Journal Entries", cols: ["description>Description", "effective_date>Effective Date", "status>Status", "total_credits_cents>Total Credits Cents", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp entities journal-entries", "corp entities journal-entries --json"]
+      },
+      {
+        name: "entities spending-limits",
+        description: "List spending limits for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/spending-limits" },
+        entity: true,
+        display: { title: "Entities Spending Limits", cols: ["amount_cents>Amount Cents", "category>Category", "@created_at>Created At", "#entity_id>ID", "period>Period", "#spending_limit_id>ID"] },
+        examples: ["corp entities spending-limits", "corp entities spending-limits --json"]
+      },
+      {
+        name: "entities stripe-account",
+        description: "View Stripe account for an entity",
+        route: { method: "GET", path: "/v1/entities/{eid}/stripe-account" },
+        entity: true,
+        display: { title: "Entities Stripe Account", cols: ["@created_at>Created At", "#entity_id>ID", "status>Status", "#stripe_account_id>ID"] },
+        examples: ["corp entities stripe-account", "corp entities stripe-account --json"]
+      },
+      {
+        name: "invoices from-agent-request",
+        description: "Create an invoice from an agent request",
+        route: { method: "POST", path: "/v1/invoices/from-agent-request" },
+        entity: true,
+        options: [
+          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--customer-name <customer-name>", description: "Customer name for the invoice", required: true },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--due-date <due-date>", description: "Due date (ISO 8601, e.g. 2026-06-30)", required: true }
+        ],
+        examples: ["corp invoices from-agent-request --amount-cents 'amount-cents' --customer-name 'customer-name' --description 'description' --due-date 'due-date'"],
+        successTemplate: "From Agent Request created"
+      },
+      {
+        name: "invoices",
+        description: "Create a new invoice",
+        route: { method: "GET", path: "/v1/invoices/{pos}" },
+        entity: true,
+        args: [{ name: "invoice-id", required: true, description: "Invoice ID" }],
+        display: { title: "Invoices", cols: ["amount_cents>Amount Cents", "customer_name>Customer Name", "description>Description", "status>Status", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp invoices", "corp invoices --json"]
+      },
+      {
+        name: "invoices mark-paid",
+        description: "Mark an invoice as paid",
+        route: { method: "POST", path: "/v1/invoices/{pos}/mark-paid" },
+        entity: true,
+        args: [{ name: "invoice-id", required: true, description: "Invoice ID" }],
+        examples: ["corp invoices mark-paid <invoice-id>"],
+        successTemplate: "Mark Paid created"
+      },
+      {
+        name: "invoices pay-instructions",
+        description: "Get payment instructions for an invoice",
+        route: { method: "GET", path: "/v1/invoices/{pos}/pay-instructions" },
+        entity: true,
+        args: [{ name: "invoice-id", required: true, description: "Invoice ID" }],
+        display: { title: "Invoices Pay Instructions", cols: ["amount_cents>Amount Cents", "currency>Currency", "instructions>Instructions", "#invoice_id>ID", "payment_method>Payment Method"] },
+        examples: ["corp invoices pay-instructions", "corp invoices pay-instructions --json"]
+      },
+      {
+        name: "invoices send",
+        description: "Send an invoice to the recipient",
+        route: { method: "POST", path: "/v1/invoices/{pos}/send" },
+        entity: true,
+        args: [{ name: "invoice-id", required: true, description: "Invoice ID" }],
+        examples: ["corp invoices send <invoice-id>"],
+        successTemplate: "Send created"
+      },
+      {
+        name: "invoices status",
+        description: "Check invoice payment status",
+        route: { method: "GET", path: "/v1/invoices/{pos}/status" },
+        entity: true,
+        args: [{ name: "invoice-id", required: true, description: "Invoice ID" }],
+        display: { title: "Invoices Status", cols: ["amount_cents>Amount Cents", "customer_name>Customer Name", "description>Description", "status>Status", "@created_at>Created At", "#entity_id>ID"] },
+        examples: ["corp invoices status", "corp invoices status --json"]
+      },
+      {
+        name: "journal-entries post",
+        description: "Post a journal entry (make it permanent)",
+        route: { method: "POST", path: "/v1/journal-entries/{pos}/post" },
+        entity: true,
+        args: [{ name: "entry-id", required: true, description: "Journal entry ID" }],
+        examples: ["corp journal-entries post <entry-id>"],
+        successTemplate: "Post created"
+      },
+      {
+        name: "journal-entries void",
+        description: "Void a journal entry",
+        route: { method: "POST", path: "/v1/journal-entries/{pos}/void" },
+        entity: true,
+        args: [{ name: "entry-id", required: true, description: "Journal entry ID" }],
+        examples: ["corp journal-entries void <entry-id>"],
+        successTemplate: "Void created"
+      },
+      {
+        name: "ledger reconcile",
+        description: "Reconcile the ledger",
+        route: { method: "POST", path: "/v1/ledger/reconcile" },
+        entity: true,
+        options: [
+          { flags: "--as-of-date <as-of-date>", description: "As Of Date" },
+          { flags: "--end-date <end-date>", description: "End Date" },
+          { flags: "--start-date <start-date>", description: "Start Date" }
+        ],
+        examples: ["corp ledger reconcile", "corp ledger reconcile --json"],
+        successTemplate: "Reconcile created"
+      },
+      {
+        name: "payments",
+        description: "Record a new payment",
+        route: { method: "POST", path: "/v1/payments" },
+        entity: true,
+        options: [
+          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--payment-method <payment-method>", description: "How a payment is made or received.", choices: ["bank_transfer", "card", "check", "wire", "ach"] },
+          { flags: "--recipient <recipient>", description: "Recipient", required: true }
+        ],
+        examples: ["corp payments --amount-cents 'amount-cents' --description bank_transfer --recipient 'recipient'", "corp payments --json"],
+        successTemplate: "Payments created"
+      },
+      {
+        name: "payments execute",
+        description: "Execute a pending payment",
+        route: { method: "POST", path: "/v1/payments/execute" },
+        entity: true,
+        options: [
+          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--payment-method <payment-method>", description: "How a payment is made or received.", choices: ["bank_transfer", "card", "check", "wire", "ach"] },
+          { flags: "--recipient <recipient>", description: "Recipient", required: true }
+        ],
+        examples: ["corp payments execute --amount-cents 'amount-cents' --description bank_transfer --recipient 'recipient'", "corp payments execute --json"],
+        successTemplate: "Execute created"
+      },
+      {
+        name: "payroll runs",
+        description: "Create a payroll run",
+        route: { method: "POST", path: "/v1/payroll/runs" },
+        entity: true,
+        options: [
+          { flags: "--pay-period-end <pay-period-end>", description: "Pay Period End", required: true },
+          { flags: "--pay-period-start <pay-period-start>", description: "Pay Period Start", required: true }
+        ],
+        examples: ["corp payroll runs --pay-period-end 'pay-period-end' --pay-period-start 'pay-period-start'"],
+        successTemplate: "Runs created"
+      },
+      {
+        name: "spending-limits",
+        description: "Set a spending limit",
+        route: { method: "POST", path: "/v1/spending-limits" },
+        entity: true,
+        options: [
+          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--category <category>", description: "Category", required: true },
+          { flags: "--period <period>", description: "Period", required: true }
+        ],
+        examples: ["corp spending-limits --amount-cents 'amount-cents' --category 'category' --period 'period'"],
+        successTemplate: "Spending Limits created"
+      },
+      {
+        name: "treasury accounts",
+        description: "Create a new ledger account",
+        route: { method: "POST", path: "/v1/treasury/accounts" },
+        entity: true,
+        options: [
+          { flags: "--account-code <account-code>", description: "Standard GL account codes with integer discriminants matching the code number.", required: true, choices: ["Cash", "AccountsReceivable", "AccountsPayable", "AccruedExpenses", "FounderCapital", "Revenue", "OperatingExpenses", "Cogs"] }
+        ],
+        examples: ["corp treasury accounts --account-code Cash"],
+        successTemplate: "Accounts created"
+      },
+      {
+        name: "treasury bank-accounts",
+        description: "Register a new bank account",
+        route: { method: "POST", path: "/v1/treasury/bank-accounts" },
+        entity: true,
+        options: [
+          { flags: "--account-type <account-type>", description: "Account type (checking, savings)", choices: ["checking", "savings"] },
+          { flags: "--bank-name <bank-name>", description: "Bank name", required: true }
+        ],
+        examples: ["corp treasury bank-accounts --bank-name 'bank-name'", "corp treasury bank-accounts --json"],
+        successTemplate: "Bank Accounts created"
+      },
+      {
+        name: "treasury chart-of-accounts",
+        description: "View chart of accounts for an entity",
+        route: { method: "GET", path: "/v1/treasury/chart-of-accounts/{eid}" },
+        entity: true,
+        display: { title: "Treasury Chart Of Accounts", cols: ["accounts>Accounts", "#entity_id>ID"] },
+        examples: ["corp treasury chart-of-accounts", "corp treasury chart-of-accounts --json"]
+      },
+      {
+        name: "treasury invoices",
+        description: "Create a new invoice",
+        route: { method: "POST", path: "/v1/treasury/invoices" },
+        entity: true,
+        options: [
+          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--customer-name <customer-name>", description: "Customer name for the invoice", required: true },
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--due-date <due-date>", description: "Due date (ISO 8601, e.g. 2026-06-30)", required: true }
+        ],
+        examples: ["corp treasury invoices --amount-cents 'amount-cents' --customer-name 'customer-name' --description 'description' --due-date 'due-date'"],
+        successTemplate: "Invoices created"
+      },
+      {
+        name: "treasury journal-entries",
+        description: "Create a journal entry",
+        route: { method: "POST", path: "/v1/treasury/journal-entries" },
+        entity: true,
+        options: [
+          { flags: "--description <description>", description: "Description text", required: true },
+          { flags: "--effective-date <effective-date>", description: "Effective Date", required: true },
+          { flags: "--lines <lines>", description: "Lines", required: true, type: "array" }
+        ],
+        examples: ["corp treasury journal-entries --description 'description' --effective-date 'effective-date' --lines 'lines'"],
+        successTemplate: "Journal Entries created"
+      },
+      {
+        name: "treasury payment-intents",
+        description: "Create a payment intent",
+        route: { method: "POST", path: "/v1/treasury/payment-intents" },
+        entity: true,
+        options: [
+          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--currency <currency>", description: "Currency code (e.g. USD)" },
+          { flags: "--description <description>", description: "Description text" }
+        ],
+        examples: ["corp treasury payment-intents --amount-cents 'amount-cents'", "corp treasury payment-intents --json"],
+        successTemplate: "Payment Intents created"
+      },
+      {
+        name: "treasury payouts",
+        description: "Create a payout",
+        route: { method: "POST", path: "/v1/treasury/payouts" },
+        entity: true,
+        options: [
+          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--description <description>", description: "Description text" },
+          { flags: "--destination <destination>", description: "Destination", required: true }
+        ],
+        examples: ["corp treasury payouts --amount-cents 'amount-cents' --destination 'destination'", "corp treasury payouts --json"],
+        successTemplate: "Payouts created"
+      },
+      {
+        name: "treasury seed-chart-of-accounts",
+        description: "Initialize chart of accounts for an entity",
+        route: { method: "POST", path: "/v1/treasury/seed-chart-of-accounts" },
+        entity: true,
+        options: [
+          { flags: "--template <template>", description: "Template string with {{secret}} placeholders" }
+        ],
+        examples: ["corp treasury seed-chart-of-accounts", "corp treasury seed-chart-of-accounts --json"],
+        successTemplate: "Seed Chart Of Accounts created"
+      },
+      {
+        name: "treasury stripe-accounts",
+        description: "Register a Stripe account",
+        route: { method: "POST", path: "/v1/treasury/stripe-accounts" },
+        entity: true,
+        examples: ["corp treasury stripe-accounts"],
+        successTemplate: "Stripe Accounts created"
+      }
+    ];
+  }
+});
+
+// src/registry/branches.ts
+var branchCommands;
+var init_branches = __esm({
+  "src/registry/branches.ts"() {
+    "use strict";
+    branchCommands = [
+      {
+        name: "branches",
+        description: "List branches for an entity repo",
+        route: { method: "GET", path: "/v1/branches" },
+        entity: "query",
+        display: {
+          title: "Branches",
+          cols: ["name>Branch", "head_oid>HEAD"]
+        },
+        examples: ["corp branches", "corp branches --json"]
+      },
+      {
+        name: "branches create",
+        description: "Create a new branch from an existing one",
+        route: { method: "POST", path: "/v1/branches" },
+        entity: "query",
+        options: [
+          { flags: "--name <name>", description: "Branch name", required: true },
+          { flags: "--from <branch>", description: "Base branch (default: main)", default: "main" }
+        ],
+        successTemplate: "Branch {branch} created at {base_commit}",
+        examples: ["corp branches create --name 'name'", "corp branches create --json"]
+      },
+      {
+        name: "branches merge",
+        description: "Merge a branch into another (default: main)",
+        route: { method: "POST", path: "/v1/branches/{pos}/merge" },
+        entity: "query",
+        args: [{ name: "branch", required: true, description: "Branch to merge" }],
+        options: [
+          { flags: "--into <branch>", description: "Target branch (default: main)", default: "main" },
+          { flags: "--squash", description: "Squash merge (default: true)" }
+        ],
+        successTemplate: "Merge {strategy}: {commit}",
+        examples: ["corp branches merge <branch>", "corp branches merge --json"]
+      },
+      {
+        name: "branches delete",
+        description: "Delete a branch",
+        route: { method: "DELETE", path: "/v1/branches/{pos}" },
+        entity: "query",
+        args: [{ name: "branch", required: true, description: "Branch to delete" }],
+        successTemplate: "Branch deleted",
+        examples: ["corp branches delete <branch>"]
+      },
+      {
+        name: "branches prune",
+        description: "Prune a merged branch",
+        route: { method: "POST", path: "/v1/branches/{pos}/prune" },
+        entity: "query",
+        args: [{ name: "branch", required: true, description: "Branch to prune" }],
+        successTemplate: "Branch pruned",
+        examples: ["corp branches prune <branch>"]
       }
     ];
   }
@@ -9517,6 +12301,10 @@ var init_registry = __esm({
     init_work_items();
     init_services();
     init_admin();
+    init_execution();
+    init_secret_proxies();
+    init_treasury();
+    init_branches();
     registry = [
       ...workspaceCommands,
       ...entityCommands,
@@ -9529,7 +12317,11 @@ var init_registry = __esm({
       ...agentCommands,
       ...workItemCommands,
       ...serviceCommands,
-      ...adminCommands
+      ...adminCommands,
+      ...executionCommands,
+      ...secretProxyCommands,
+      ...treasuryCommands,
+      ...branchCommands
     ];
   }
 });
@@ -9684,6 +12476,7 @@ async function executeGenericRead(def, ctx) {
     path = path.replace("{pos}", encodeURIComponent(ctx.positional[posIdx++]));
   }
   path = path.replace("{wid}", encodeURIComponent(ctx.client.workspaceId));
+  path = path.replace("{workspace_id}", encodeURIComponent(ctx.client.workspaceId));
   if (def.optQP) {
     for (const optName of def.optQP) {
       const val = ctx.opts[optName];
@@ -9721,6 +12514,77 @@ async function executeGenericRead(def, ctx) {
     ctx.writer.json(data);
   }
 }
+async function executeGenericWrite(def, ctx) {
+  if (!def.route?.path || !def.route?.method) {
+    ctx.writer.error("No route defined for this command");
+    return;
+  }
+  let path = def.route.path;
+  let posIdx = 0;
+  if (def.entity) {
+    let eid;
+    const explicitEid = ctx.opts["entity-id"];
+    if (explicitEid) {
+      eid = await ctx.resolver.resolveEntity(explicitEid);
+    } else if (def.entity === true && !path.includes("{pos}") && ctx.positional[posIdx]) {
+      eid = await ctx.resolver.resolveEntity(ctx.positional[posIdx++]);
+    } else {
+      eid = ctx.entityId;
+    }
+    if (eid) {
+      path = path.replace("{eid}", encodeURIComponent(eid));
+    } else if (path.includes("{eid}")) {
+      ctx.writer.error("Entity ID required. Use --entity-id or set active entity with 'corp use <name>'.");
+      return;
+    }
+  }
+  if (path.includes("{pos}")) {
+    if (!ctx.positional[posIdx]) {
+      ctx.writer.error("Missing required argument (ID or reference).");
+      return;
+    }
+    path = path.replace("{pos}", encodeURIComponent(ctx.positional[posIdx++]));
+  }
+  if (path.includes("{pos2}")) {
+    if (!ctx.positional[posIdx]) {
+      ctx.writer.error("Missing required second argument (ID or reference).");
+      return;
+    }
+    path = path.replace("{pos2}", encodeURIComponent(ctx.positional[posIdx++]));
+  }
+  path = path.replace("{wid}", encodeURIComponent(ctx.client.workspaceId));
+  path = path.replace("{workspace_id}", encodeURIComponent(ctx.client.workspaceId));
+  const body = {};
+  if (def.entity && ctx.entityId) {
+    body.entity_id = ctx.entityId;
+  }
+  for (const opt of def.options ?? []) {
+    const match = opt.flags.match(/^--([a-z0-9-]+)/);
+    if (!match) continue;
+    const camelKey = match[1].replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    const val = ctx.opts[camelKey];
+    if (val != null && camelKey !== "entityId" && camelKey !== "json") {
+      body[match[1].replace(/-/g, "_")] = val;
+    }
+  }
+  if (ctx.dryRun) {
+    ctx.writer.dryRun(def.name.replace(/ /g, "."), body);
+    return;
+  }
+  const data = await withSpinner(
+    "Submitting",
+    () => ctx.client.submitJSON(def.route.method, path, Object.keys(body).length ? body : void 0),
+    ctx.opts.json
+  );
+  if (ctx.opts.json) {
+    ctx.writer.json(data);
+    return;
+  }
+  const result = data;
+  const idKey = result ? Object.keys(result).find((k) => k.endsWith("_id")) : void 0;
+  const idVal = idKey && result ? result[idKey] : void 0;
+  ctx.writer.success(`${def.description ?? def.name}: ${idVal ?? "OK"}`);
+}
 
 // src/writer.ts
 init_output();
@@ -9810,7 +12674,45 @@ function buildCLI(commands, version) {
   for (const [parentName, childDefs] of children) {
     let parentCmd = parentCmds.get(parentName);
     if (!parentCmd) {
-      parentCmd = program2.command(parentName).description("");
+      const parentDescriptions = {
+        workspaces: "Workspace management",
+        workspace: "Workspace settings",
+        equity: "Equity system (low-level grants, holders, instruments)",
+        execution: "Execution intents, obligations, and approval artifacts",
+        meetings: "Meeting management (convene, adjourn, notice)",
+        compliance: "Compliance escalations and monitoring",
+        contractors: "Contractor classification",
+        admin: "Admin tools (audit, billing, SSH keys, secrets)",
+        auth: "Authentication and API key management",
+        references: "Reference tracking and sync",
+        secrets: "Secret management and proxy configuration",
+        "document-requests": "Document request fulfillment",
+        intents: "Execution intent management",
+        "bank-accounts": "Bank account management",
+        "journal-entries": "Ledger journal entries",
+        ledger: "Ledger operations and reconciliation",
+        payroll: "Payroll runs",
+        payments: "Payment submission and tracking",
+        invoices: "Invoice management",
+        treasury: "Treasury, invoices, payments, and payouts",
+        "governance-seats": "Governance seat management",
+        "governance-bodies": "Governance body management",
+        "human-obligations": "Human obligation fulfillment",
+        "ssh-keys": "SSH key management",
+        "secret-proxies": "Secret proxy configuration",
+        formations: "Formation workflows (low-level API)",
+        valuations: "Valuation management",
+        branches: "Git branch management",
+        digests: "Digest generation and viewing",
+        obligations: "Obligation tracking and fulfillment",
+        "spending-limits": "Spending limit management",
+        receipts: "Execution receipts",
+        "share-transfers": "Share transfer workflows",
+        "safe-notes": "SAFE note management",
+        distributions: "Distribution management",
+        deadlines: "Compliance deadline management"
+      };
+      parentCmd = program2.command(parentName).description(parentDescriptions[parentName] ?? "");
       parentCmds.set(parentName, parentCmd);
     }
     for (const def of childDefs) {
@@ -9855,6 +12757,13 @@ function wireCommand(parent, def) {
         ...prev || [],
         v
       ];
+    if (opt.hidden) {
+      const o = new Option(opt.flags, opt.description);
+      o.hideHelp();
+      if (coerce) o.argParser(coerce);
+      cmd.addOption(o);
+      continue;
+    }
     if (opt.choices && opt.choices.length > 0) {
       const o = new Option(opt.flags, opt.description);
       o.choices(opt.choices);
@@ -9945,10 +12854,20 @@ function wireCommand(parent, def) {
         await def.handler(ctx);
       } else if (def.display) {
         await executeGenericRead(def, ctx);
+      } else if (def.route && def.route.method !== "GET") {
+        await executeGenericWrite(def, ctx);
       } else {
         writer.error(`Command "${def.name}" has no handler or display config`);
         process.exit(1);
       }
+      if (def.produces?.kind && !def.handler && !quiet && !mergedOpts.json) {
+        const kind = def.produces.kind;
+        const lastId = resolver.getLastId(kind);
+        if (lastId) {
+          const shortRef = lastId.length > 12 ? lastId.slice(0, 8) + "\u2026" : lastId;
+          console.log(`  Ref: @last:${kind} \u2192 ${shortRef}`);
+        }
+      }
     } catch (err) {
       writer.error(`Failed: ${err instanceof Error ? err.message : String(err)}`);
       process.exit(1);