@thecorporation/cli 26.3.47 → 26.3.49

package/dist/index.js

@@ -571,7 +571,7 @@ import {
   isEntityScopedKind,
   extractId
 } from "@thecorporation/corp-tools";
-var NodeReferenceStorage, ReferenceResolver;
+var NodeReferenceStorage, GLOBAL_KEY, ReferenceResolver;
 var init_references = __esm({
   "src/references.ts"() {
     "use strict";
@@ -590,39 +590,178 @@ var init_references = __esm({
         return getActiveEntityId(this.cfg);
       }
     };
+    GLOBAL_KEY = "__global__";
     ReferenceResolver = class {
       client;
       cfg;
       tracker;
-      entityCache;
-      contactsCache = /* @__PURE__ */ new Map();
-      shareTransfersCache = /* @__PURE__ */ new Map();
-      invoicesCache = /* @__PURE__ */ new Map();
-      bankAccountsCache = /* @__PURE__ */ new Map();
-      paymentsCache = /* @__PURE__ */ new Map();
-      payrollRunsCache = /* @__PURE__ */ new Map();
-      distributionsCache = /* @__PURE__ */ new Map();
-      reconciliationsCache = /* @__PURE__ */ new Map();
-      taxFilingsCache = /* @__PURE__ */ new Map();
-      deadlinesCache = /* @__PURE__ */ new Map();
-      classificationsCache = /* @__PURE__ */ new Map();
-      bodiesCache = /* @__PURE__ */ new Map();
-      meetingsCache = /* @__PURE__ */ new Map();
-      seatsCache = /* @__PURE__ */ new Map();
-      agendaCache = /* @__PURE__ */ new Map();
-      resolutionsCache = /* @__PURE__ */ new Map();
-      documentsCache = /* @__PURE__ */ new Map();
-      workItemsCache = /* @__PURE__ */ new Map();
-      valuationsCache = /* @__PURE__ */ new Map();
-      safeNotesCache = /* @__PURE__ */ new Map();
-      roundsCache = /* @__PURE__ */ new Map();
-      serviceRequestsCache = /* @__PURE__ */ new Map();
+      // Single unified cache: ResourceKind → (cacheKey → records)
+      recordsCache = /* @__PURE__ */ new Map();
+      // Cap table is fetched as a single object; instruments/share_classes are
+      // derived from it, so we keep its own dedicated cache.
       capTableCache = /* @__PURE__ */ new Map();
-      agentsCache;
+      // Dispatch table: ResourceKind → fetcher that receives the scope and
+      // returns the raw (uncached) records for that kind.
+      fetchers;
       constructor(client, cfg) {
         this.client = client;
         this.cfg = cfg;
         this.tracker = new ReferenceTracker(new NodeReferenceStorage(cfg));
+        this.fetchers = /* @__PURE__ */ new Map([
+          ["entity", async (_scope) => ({
+            key: GLOBAL_KEY,
+            records: await this.client.listEntities()
+          })],
+          ["agent", async (_scope) => ({
+            key: GLOBAL_KEY,
+            records: await this.client.listAgents()
+          })],
+          ["contact", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve contacts.");
+            return { key: entityId, records: await this.client.listContacts(entityId) };
+          }],
+          ["share_transfer", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve share transfers.");
+            return { key: entityId, records: await this.client.listShareTransfers(entityId) };
+          }],
+          ["invoice", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve invoices.");
+            return { key: entityId, records: await this.client.listInvoices(entityId) };
+          }],
+          ["bank_account", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve bank accounts.");
+            return { key: entityId, records: await this.client.listBankAccounts(entityId) };
+          }],
+          ["payment", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve payments.");
+            return { key: entityId, records: await this.client.listPayments(entityId) };
+          }],
+          ["payroll_run", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve payroll runs.");
+            return { key: entityId, records: await this.client.listPayrollRuns(entityId) };
+          }],
+          ["distribution", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve distributions.");
+            return { key: entityId, records: await this.client.listDistributions(entityId) };
+          }],
+          ["reconciliation", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve reconciliations.");
+            return { key: entityId, records: await this.client.listReconciliations(entityId) };
+          }],
+          ["tax_filing", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve tax filings.");
+            return { key: entityId, records: await this.client.listTaxFilings(entityId) };
+          }],
+          ["deadline", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve deadlines.");
+            return { key: entityId, records: await this.client.listDeadlines(entityId) };
+          }],
+          ["classification", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve contractor classifications.");
+            return { key: entityId, records: await this.client.listContractorClassifications(entityId) };
+          }],
+          ["body", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve governance bodies.");
+            return { key: entityId, records: await this.client.listGovernanceBodies(entityId) };
+          }],
+          ["meeting", async ({ entityId, bodyId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve meetings.");
+            const cacheKey = `${entityId}:${bodyId ?? "*"}`;
+            const meetings = [];
+            if (bodyId) {
+              meetings.push(...await this.client.listMeetings(bodyId, entityId));
+            } else {
+              const bodies = await this.getCachedRecords("body", { entityId });
+              for (const body of bodies) {
+                const resolvedBodyId = extractId(body, ["body_id", "id"]);
+                if (!resolvedBodyId) continue;
+                meetings.push(...await this.client.listMeetings(resolvedBodyId, entityId));
+              }
+            }
+            return { key: cacheKey, records: meetings };
+          }],
+          ["seat", async ({ entityId, bodyId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve seats.");
+            const cacheKey = `${entityId}:${bodyId ?? "*"}`;
+            const seats = [];
+            if (bodyId) {
+              seats.push(...await this.client.getGovernanceSeats(bodyId, entityId));
+            } else {
+              const bodies = await this.getCachedRecords("body", { entityId });
+              for (const body of bodies) {
+                const resolvedBodyId = extractId(body, ["body_id", "id"]);
+                if (!resolvedBodyId) continue;
+                seats.push(...await this.client.getGovernanceSeats(resolvedBodyId, entityId));
+              }
+            }
+            return { key: cacheKey, records: seats };
+          }],
+          ["agenda_item", async ({ entityId, meetingId }) => {
+            if (!entityId || !meetingId) {
+              throw new Error("Entity and meeting context are required to resolve agenda items.");
+            }
+            return {
+              key: `${entityId}:${meetingId}`,
+              records: await this.client.listAgendaItems(meetingId, entityId)
+            };
+          }],
+          ["resolution", async ({ entityId, meetingId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve resolutions.");
+            const cacheKey = `${entityId}:${meetingId ?? "*"}`;
+            const resolutions = [];
+            if (meetingId) {
+              resolutions.push(...await this.client.getMeetingResolutions(meetingId, entityId));
+            } else {
+              const meetings = await this.getCachedRecords("meeting", { entityId });
+              for (const meeting of meetings) {
+                const resolvedMeetingId = extractId(meeting, ["meeting_id", "id"]);
+                if (!resolvedMeetingId) continue;
+                resolutions.push(...await this.client.getMeetingResolutions(resolvedMeetingId, entityId));
+              }
+            }
+            return { key: cacheKey, records: resolutions };
+          }],
+          ["document", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve documents.");
+            return { key: entityId, records: await this.client.getEntityDocuments(entityId) };
+          }],
+          ["work_item", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve work items.");
+            return { key: entityId, records: await this.client.listWorkItems(entityId) };
+          }],
+          ["valuation", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve valuations.");
+            return { key: entityId, records: await this.client.getValuations(entityId) };
+          }],
+          ["safe_note", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve SAFE notes.");
+            return { key: entityId, records: await this.client.getSafeNotes(entityId) };
+          }],
+          ["instrument", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve cap table resources.");
+            const capTable = await this.getCapTable(entityId);
+            return {
+              key: entityId,
+              records: Array.isArray(capTable.instruments) ? capTable.instruments : []
+            };
+          }],
+          ["share_class", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve cap table resources.");
+            const capTable = await this.getCapTable(entityId);
+            return {
+              key: entityId,
+              records: Array.isArray(capTable.share_classes) ? capTable.share_classes : []
+            };
+          }],
+          ["round", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve rounds.");
+            return { key: entityId, records: await this.client.listEquityRounds(entityId) };
+          }],
+          ["service_request", async ({ entityId }) => {
+            if (!entityId) throw new Error("An entity context is required to resolve service requests.");
+            return { key: entityId, records: await this.client.listServiceRequests(entityId) };
+          }]
+        ]);
       }
       /**
        * Public generic resolver for any resource kind.
@@ -846,64 +985,63 @@ var init_references = __esm({
         return `Ambiguous ${kindLabel(kind)} reference "${ref}". Matches: ${previews}. Try: corp find ${kind} ${JSON.stringify(ref)}`;
       }
       async listRecords(kind, scope) {
-        const records = await (async () => {
-          switch (kind) {
-            case "entity":
-              return this.listEntities();
-            case "contact":
-              return this.listContacts(scope.entityId);
-            case "share_transfer":
-              return this.listShareTransfers(scope.entityId);
-            case "invoice":
-              return this.listInvoices(scope.entityId);
-            case "bank_account":
-              return this.listBankAccounts(scope.entityId);
-            case "payment":
-              return this.listPayments(scope.entityId);
-            case "payroll_run":
-              return this.listPayrollRuns(scope.entityId);
-            case "distribution":
-              return this.listDistributions(scope.entityId);
-            case "reconciliation":
-              return this.listReconciliations(scope.entityId);
-            case "tax_filing":
-              return this.listTaxFilings(scope.entityId);
-            case "deadline":
-              return this.listDeadlines(scope.entityId);
-            case "classification":
-              return this.listClassifications(scope.entityId);
-            case "body":
-              return this.listBodies(scope.entityId);
-            case "meeting":
-              return this.listMeetings(scope.entityId, scope.bodyId);
-            case "seat":
-              return this.listSeats(scope.entityId, scope.bodyId);
-            case "agenda_item":
-              return this.listAgendaItems(scope.entityId, scope.meetingId);
-            case "resolution":
-              return this.listResolutions(scope.entityId, scope.meetingId);
-            case "document":
-              return this.listDocuments(scope.entityId);
-            case "work_item":
-              return this.listWorkItems(scope.entityId);
-            case "agent":
-              return this.listAgents();
-            case "valuation":
-              return this.listValuations(scope.entityId);
-            case "safe_note":
-              return this.listSafeNotes(scope.entityId);
-            case "instrument":
-              return this.listInstruments(scope.entityId);
-            case "share_class":
-              return this.listShareClasses(scope.entityId);
-            case "round":
-              return this.listRounds(scope.entityId);
-            case "service_request":
-              return this.listServiceRequestRecords(scope.entityId);
-          }
-        })();
+        const records = await this.getCachedRecords(kind, scope);
         return this.attachStableHandles(kind, records, scope.entityId);
       }
+      /**
+       * Returns the cached records for a given kind and scope, invoking the
+       * fetcher on a cache miss. Does NOT attach stable handles — use
+       * `listRecords` for that.
+       */
+      async getCachedRecords(kind, scope) {
+        const fetcher = this.fetchers.get(kind);
+        if (!fetcher) {
+          throw new Error(`No fetcher registered for resource kind "${kind}".`);
+        }
+        let kindCache = this.recordsCache.get(kind);
+        if (!kindCache) {
+          kindCache = /* @__PURE__ */ new Map();
+          this.recordsCache.set(kind, kindCache);
+        }
+        const probeKey = this.probeKey(kind, scope);
+        if (probeKey !== void 0) {
+          const hit2 = kindCache.get(probeKey);
+          if (hit2) return hit2;
+          const { key: key2, records: records2 } = await fetcher(scope);
+          kindCache.set(key2, records2);
+          return records2;
+        }
+        const { key, records } = await fetcher(scope);
+        const hit = kindCache.get(key);
+        if (hit) return hit;
+        kindCache.set(key, records);
+        return records;
+      }
+      /**
+       * Returns the expected cache key for a given kind and scope without
+       * invoking the fetcher. Returns `undefined` if the key cannot be
+       * determined without fetching (e.g., composite-key kinds that need to
+       * enumerate sub-resources first).
+       */
+      probeKey(kind, scope) {
+        switch (kind) {
+          case "entity":
+          case "agent":
+            return GLOBAL_KEY;
+          case "meeting":
+          case "seat":
+            if (!scope.entityId) return GLOBAL_KEY;
+            return `${scope.entityId}:${scope.bodyId ?? "*"}`;
+          case "agenda_item":
+            if (!scope.entityId || !scope.meetingId) return GLOBAL_KEY;
+            return `${scope.entityId}:${scope.meetingId}`;
+          case "resolution":
+            if (!scope.entityId) return GLOBAL_KEY;
+            return `${scope.entityId}:${scope.meetingId ?? "*"}`;
+          default:
+            return scope.entityId ?? GLOBAL_KEY;
+        }
+      }
       async attachStableHandles(kind, records, entityId) {
         const missing = records.map((record) => ({ record, described: describeReferenceRecord2(kind, record) })).filter(
           (entry) => entry.described !== null && !(typeof entry.record.handle === "string" && entry.record.handle.trim().length > 0)
@@ -938,221 +1076,6 @@ var init_references = __esm({
         }
         return records;
       }
-      async listEntities() {
-        if (!this.entityCache) {
-          this.entityCache = await this.client.listEntities();
-        }
-        return this.entityCache;
-      }
-      async listContacts(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve contacts.");
-        const cached = this.contactsCache.get(entityId);
-        if (cached) return cached;
-        const contacts = await this.client.listContacts(entityId);
-        this.contactsCache.set(entityId, contacts);
-        return contacts;
-      }
-      async listShareTransfers(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve share transfers.");
-        const cached = this.shareTransfersCache.get(entityId);
-        if (cached) return cached;
-        const transfers = await this.client.listShareTransfers(entityId);
-        this.shareTransfersCache.set(entityId, transfers);
-        return transfers;
-      }
-      async listInvoices(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve invoices.");
-        const cached = this.invoicesCache.get(entityId);
-        if (cached) return cached;
-        const invoices = await this.client.listInvoices(entityId);
-        this.invoicesCache.set(entityId, invoices);
-        return invoices;
-      }
-      async listBankAccounts(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve bank accounts.");
-        const cached = this.bankAccountsCache.get(entityId);
-        if (cached) return cached;
-        const bankAccounts = await this.client.listBankAccounts(entityId);
-        this.bankAccountsCache.set(entityId, bankAccounts);
-        return bankAccounts;
-      }
-      async listPayments(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve payments.");
-        const cached = this.paymentsCache.get(entityId);
-        if (cached) return cached;
-        const payments = await this.client.listPayments(entityId);
-        this.paymentsCache.set(entityId, payments);
-        return payments;
-      }
-      async listPayrollRuns(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve payroll runs.");
-        const cached = this.payrollRunsCache.get(entityId);
-        if (cached) return cached;
-        const payrollRuns = await this.client.listPayrollRuns(entityId);
-        this.payrollRunsCache.set(entityId, payrollRuns);
-        return payrollRuns;
-      }
-      async listDistributions(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve distributions.");
-        const cached = this.distributionsCache.get(entityId);
-        if (cached) return cached;
-        const distributions = await this.client.listDistributions(entityId);
-        this.distributionsCache.set(entityId, distributions);
-        return distributions;
-      }
-      async listReconciliations(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve reconciliations.");
-        const cached = this.reconciliationsCache.get(entityId);
-        if (cached) return cached;
-        const reconciliations = await this.client.listReconciliations(entityId);
-        this.reconciliationsCache.set(entityId, reconciliations);
-        return reconciliations;
-      }
-      async listTaxFilings(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve tax filings.");
-        const cached = this.taxFilingsCache.get(entityId);
-        if (cached) return cached;
-        const filings = await this.client.listTaxFilings(entityId);
-        this.taxFilingsCache.set(entityId, filings);
-        return filings;
-      }
-      async listDeadlines(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve deadlines.");
-        const cached = this.deadlinesCache.get(entityId);
-        if (cached) return cached;
-        const deadlines = await this.client.listDeadlines(entityId);
-        this.deadlinesCache.set(entityId, deadlines);
-        return deadlines;
-      }
-      async listClassifications(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve contractor classifications.");
-        const cached = this.classificationsCache.get(entityId);
-        if (cached) return cached;
-        const classifications = await this.client.listContractorClassifications(entityId);
-        this.classificationsCache.set(entityId, classifications);
-        return classifications;
-      }
-      async listBodies(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve governance bodies.");
-        const cached = this.bodiesCache.get(entityId);
-        if (cached) return cached;
-        const bodies = await this.client.listGovernanceBodies(entityId);
-        this.bodiesCache.set(entityId, bodies);
-        return bodies;
-      }
-      async listMeetings(entityId, bodyId) {
-        if (!entityId) throw new Error("An entity context is required to resolve meetings.");
-        const cacheKey = `${entityId}:${bodyId ?? "*"}`;
-        const cached = this.meetingsCache.get(cacheKey);
-        if (cached) return cached;
-        const meetings = [];
-        if (bodyId) {
-          meetings.push(...await this.client.listMeetings(bodyId, entityId));
-        } else {
-          const bodies = await this.listBodies(entityId);
-          for (const body of bodies) {
-            const resolvedBodyId = extractId(body, ["body_id", "id"]);
-            if (!resolvedBodyId) continue;
-            meetings.push(...await this.client.listMeetings(resolvedBodyId, entityId));
-          }
-        }
-        this.meetingsCache.set(cacheKey, meetings);
-        return meetings;
-      }
-      async listSeats(entityId, bodyId) {
-        if (!entityId) throw new Error("An entity context is required to resolve seats.");
-        const cacheKey = `${entityId}:${bodyId ?? "*"}`;
-        const cached = this.seatsCache.get(cacheKey);
-        if (cached) return cached;
-        const seats = [];
-        if (bodyId) {
-          seats.push(...await this.client.getGovernanceSeats(bodyId, entityId));
-        } else {
-          const bodies = await this.listBodies(entityId);
-          for (const body of bodies) {
-            const resolvedBodyId = extractId(body, ["body_id", "id"]);
-            if (!resolvedBodyId) continue;
-            seats.push(...await this.client.getGovernanceSeats(resolvedBodyId, entityId));
-          }
-        }
-        this.seatsCache.set(cacheKey, seats);
-        return seats;
-      }
-      async listAgendaItems(entityId, meetingId) {
-        if (!entityId || !meetingId) {
-          throw new Error("Entity and meeting context are required to resolve agenda items.");
-        }
-        const cached = this.agendaCache.get(`${entityId}:${meetingId}`);
-        if (cached) return cached;
-        const items = await this.client.listAgendaItems(meetingId, entityId);
-        this.agendaCache.set(`${entityId}:${meetingId}`, items);
-        return items;
-      }
-      async listResolutions(entityId, meetingId) {
-        if (!entityId) throw new Error("An entity context is required to resolve resolutions.");
-        const cacheKey = `${entityId}:${meetingId ?? "*"}`;
-        const cached = this.resolutionsCache.get(cacheKey);
-        if (cached) return cached;
-        const resolutions = [];
-        if (meetingId) {
-          resolutions.push(...await this.client.getMeetingResolutions(meetingId, entityId));
-        } else {
-          const meetings = await this.listMeetings(entityId);
-          for (const meeting of meetings) {
-            const resolvedMeetingId = extractId(meeting, ["meeting_id", "id"]);
-            if (!resolvedMeetingId) continue;
-            resolutions.push(...await this.client.getMeetingResolutions(resolvedMeetingId, entityId));
-          }
-        }
-        this.resolutionsCache.set(cacheKey, resolutions);
-        return resolutions;
-      }
-      async listDocuments(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve documents.");
-        const cached = this.documentsCache.get(entityId);
-        if (cached) return cached;
-        const docs = await this.client.getEntityDocuments(entityId);
-        this.documentsCache.set(entityId, docs);
-        return docs;
-      }
-      async listWorkItems(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve work items.");
-        const cached = this.workItemsCache.get(entityId);
-        if (cached) return cached;
-        const items = await this.client.listWorkItems(entityId);
-        this.workItemsCache.set(entityId, items);
-        return items;
-      }
-      async listAgents() {
-        if (!this.agentsCache) {
-          this.agentsCache = await this.client.listAgents();
-        }
-        return this.agentsCache;
-      }
-      async listValuations(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve valuations.");
-        const cached = this.valuationsCache.get(entityId);
-        if (cached) return cached;
-        const valuations = await this.client.getValuations(entityId);
-        this.valuationsCache.set(entityId, valuations);
-        return valuations;
-      }
-      async listSafeNotes(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve SAFE notes.");
-        const cached = this.safeNotesCache.get(entityId);
-        if (cached) return cached;
-        const safeNotes = await this.client.getSafeNotes(entityId);
-        this.safeNotesCache.set(entityId, safeNotes);
-        return safeNotes;
-      }
-      async listRounds(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve rounds.");
-        const cached = this.roundsCache.get(entityId);
-        if (cached) return cached;
-        const rounds = await this.client.listEquityRounds(entityId);
-        this.roundsCache.set(entityId, rounds);
-        return rounds;
-      }
       async getCapTable(entityId) {
         if (!entityId) throw new Error("An entity context is required to resolve cap table resources.");
         const cached = this.capTableCache.get(entityId);
@@ -1161,22 +1084,6 @@ var init_references = __esm({
         this.capTableCache.set(entityId, capTable);
         return capTable;
       }
-      async listInstruments(entityId) {
-        const capTable = await this.getCapTable(entityId);
-        return Array.isArray(capTable.instruments) ? capTable.instruments : [];
-      }
-      async listShareClasses(entityId) {
-        const capTable = await this.getCapTable(entityId);
-        return Array.isArray(capTable.share_classes) ? capTable.share_classes : [];
-      }
-      async listServiceRequestRecords(entityId) {
-        if (!entityId) throw new Error("An entity context is required to resolve service requests.");
-        const cached = this.serviceRequestsCache.get(entityId);
-        if (cached) return cached;
-        const requests = await this.client.listServiceRequests(entityId);
-        this.serviceRequestsCache.set(entityId, requests);
-        return requests;
-      }
     };
   }
 });
@@ -2279,7 +2186,7 @@ var init_workspace = __esm({
             throw new Error(`Failed to resolve entity: ${err}`);
           }
         },
-        examples: ["corp use", "corp use --json"]
+        examples: ["corp use acme", "corp use ent_abc123"]
       },
       // --- next ---
       {
@@ -2376,7 +2283,7 @@ var init_workspace = __esm({
       // --- obligations (pure read) ---
       {
         name: "obligations",
-        description: "List obligations with urgency tiers",
+        description: "List compliance obligations with urgency tiers",
         route: { method: "GET", path: "/v1/obligations/summary" },
         display: {
           title: "Obligations",
@@ -2390,13 +2297,13 @@ var init_workspace = __esm({
           ]
         },
         optQP: ["tier"],
-        options: [{ flags: "--tier <tier>", description: "Filter by urgency tier" }],
-        examples: ["corp obligations"]
+        options: [{ flags: "--tier <tier>", description: "Filter by urgency tier", choices: ["critical", "high", "medium", "low"] }],
+        examples: ["corp obligations", "corp obligations --tier critical --json"]
       },
       // --- digest ---
       {
         name: "digest",
-        description: "View or trigger daily digests",
+        description: "View digest history or trigger a new digest",
         route: { method: "GET", path: "/v1/digests" },
         display: { title: "Digests" },
         options: [
@@ -2413,15 +2320,23 @@ var init_workspace = __esm({
                 const value = result.message;
                 return typeof value === "string" && value.trim() ? value : null;
               })();
-              if (!opts.json) {
-                ctx.writer.success(result.digest_count > 0 ? "Digest triggered." : "Digest trigger accepted.");
+              if (opts.json) {
+                ctx.writer.json(result);
+                return;
               }
-              if (message && !opts.json) {
+              ctx.writer.success(result.digest_count > 0 ? "Digest triggered." : "Digest trigger accepted.");
+              if (message) {
                 ctx.writer.warning(message);
               }
-              ctx.writer.json(result);
+              if (result.digest_count != null) {
+                ctx.writer.writeln(`  Digest count: ${result.digest_count}`);
+              }
             } else if (opts.key) {
               const result = await ctx.client.getDigest(opts.key);
+              if (opts.json) {
+                ctx.writer.json(result);
+                return;
+              }
               ctx.writer.json(result);
             } else {
               const digests = await ctx.client.listDigests();
@@ -2432,6 +2347,10 @@ var init_workspace = __esm({
                   ctx.writer.writeln("No digest history found.");
                 }
               } else {
+                if (opts.json) {
+                  ctx.writer.json(digests);
+                  return;
+                }
                 ctx.writer.json(digests);
               }
             }
@@ -2439,7 +2358,7 @@ var init_workspace = __esm({
             throw new Error(`Failed: ${err}`);
           }
         },
-        examples: ["corp digest"]
+        examples: ["corp digest", "corp digest --trigger", "corp digest --key daily_2026-03-22 --json"]
       },
       // --- billing ---
       {
@@ -2511,7 +2430,7 @@ var init_workspace = __esm({
             throw new Error(`Failed to create checkout session: ${err}`);
           }
         },
-        examples: ["corp billing upgrade"]
+        examples: ["corp billing upgrade", "corp billing upgrade --plan pro", "corp billing upgrade --plan enterprise --json"]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
@@ -2767,10 +2686,10 @@ var init_entities = __esm({
       },
       {
         name: "entities show",
-        description: "Show entity detail",
-        args: [{ name: "entity-ref", required: true }],
+        description: "Show detail for a specific entity",
+        args: [{ name: "entity-ref", required: true, description: "Entity name, short ID, or reference" }],
         handler: entitiesShowHandler,
-        examples: ["corp entities show"]
+        examples: ["corp entities show acme", "corp entities show ent_abc123 --json"]
       },
       {
         name: "entities convert",
@@ -2778,11 +2697,11 @@ var init_entities = __esm({
         route: { method: "POST", path: "/v1/entities/{pos}/convert" },
         args: [{ name: "entity-ref", required: true }],
         options: [
-          { flags: "--to <type>", description: "Target entity type (llc, c_corp)", required: true },
-          { flags: "--jurisdiction <jurisdiction>", description: "New jurisdiction" }
+          { flags: "--to <type>", description: "Target entity type", required: true, choices: ["llc", "c_corp"] },
+          { flags: "--jurisdiction <jurisdiction>", description: "New jurisdiction (e.g. DE, CA)" }
         ],
         handler: entitiesConvertHandler,
-        examples: ["corp entities convert <entity-ref> --to 'type'", "corp entities convert --json"]
+        examples: ["corp entities convert acme --to c_corp", "corp entities convert ent_abc123 --to llc --jurisdiction DE --json"]
       },
       {
         name: "entities dissolve",
@@ -2795,7 +2714,10 @@ var init_entities = __esm({
           { flags: "--yes -y", description: "Skip confirmation prompt" }
         ],
         handler: entitiesDissolveHandler,
-        examples: ["corp entities dissolve <entity-ref> --reason 'reason'", "corp entities dissolve --json"]
+        examples: [
+          "corp entities dissolve acme --reason 'Business wind-down'",
+          "corp entities dissolve ent_abc123 --reason 'Voluntary dissolution' --effective-date 2026-06-01 --yes"
+        ]
       },
       // ── contacts ──
       {
@@ -2818,7 +2740,7 @@ var init_entities = __esm({
         display: { title: "Contact Profile" },
         args: [{ name: "contact-ref", required: true }],
         handler: contactsShowHandler,
-        examples: ["corp contacts show", "corp contacts show --json"]
+        examples: ["corp contacts show alice", "corp contacts show con_abc123 --json"]
       },
       {
         name: "contacts add",
@@ -2828,9 +2750,9 @@ var init_entities = __esm({
         options: [
           { flags: "--name <name>", description: "Contact name", required: true },
           { flags: "--email <email>", description: "Contact email", required: true },
-          { flags: "--type <type>", description: "Contact type (individual, organization)", default: "individual" },
-          { flags: "--category <category>", description: "Category (employee, contractor, board_member, investor, law_firm, valuation_firm, accounting_firm, officer, founder, member, other)" },
-          { flags: "--cap-table-access <level>", description: "Cap table access (none, summary, detailed)" },
+          { flags: "--type <type>", description: "Contact type", default: "individual", choices: ["individual", "organization"] },
+          { flags: "--category <category>", description: "Contact role category", choices: ["employee", "contractor", "board_member", "investor", "law_firm", "valuation_firm", "accounting_firm", "officer", "founder", "member", "other"] },
+          { flags: "--cap-table-access <level>", description: "Cap table visibility level", choices: ["none", "summary", "detailed"] },
           { flags: "--address <address>", description: "Mailing address" },
           { flags: "--mailing-address <address>", description: "Alias for --address" },
           { flags: "--phone <phone>", description: "Phone number" },
@@ -2839,7 +2761,10 @@ var init_entities = __esm({
         handler: contactsAddHandler,
         produces: { kind: "contact" },
         successTemplate: "Contact created: {name}",
-        examples: ["corp contacts add --name 'name' --email 'email'", "corp contacts add --json"]
+        examples: [
+          "corp contacts add --name 'Alice Smith' --email alice@example.com --category founder",
+          "corp contacts add --name 'Bob Jones' --email bob@example.com --category employee --type individual --json"
+        ]
       },
       {
         name: "contacts edit",
@@ -2850,15 +2775,18 @@ var init_entities = __esm({
         options: [
           { flags: "--name <name>", description: "Contact name" },
           { flags: "--email <email>", description: "Contact email" },
-          { flags: "--category <category>", description: "Contact category" },
-          { flags: "--cap-table-access <level>", description: "Cap table access (none, summary, detailed)" },
+          { flags: "--category <category>", description: "Contact role category", choices: ["employee", "contractor", "board_member", "investor", "law_firm", "valuation_firm", "accounting_firm", "officer", "founder", "member", "other"] },
+          { flags: "--cap-table-access <level>", description: "Cap table visibility level", choices: ["none", "summary", "detailed"] },
           { flags: "--address <address>", description: "Mailing address" },
           { flags: "--mailing-address <address>", description: "Alias for --address" },
           { flags: "--phone <phone>", description: "Phone number" },
           { flags: "--notes <notes>", description: "Additional notes" }
         ],
         handler: contactsEditHandler,
-        examples: ["corp contacts edit <contact-ref>", "corp contacts edit --json"]
+        examples: [
+          "corp contacts edit alice --email newemail@example.com",
+          "corp contacts edit con_abc123 --category board_member --cap-table-access detailed --json"
+        ]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
@@ -2866,21 +2794,24 @@ var init_entities = __esm({
         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", posKind: "contact" }],
-        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"]
+        display: { title: "Contact Notification Preferences", cols: ["#contact_id>Contact ID", "email_enabled>Email", "sms_enabled>SMS", "webhook_enabled>Webhook", "@updated_at>Updated"] },
+        examples: ["corp contacts notification-prefs con_abc123", "corp contacts notification-prefs con_abc123 --json"]
       },
       {
         name: "contacts update-notification-prefs",
-        description: "View notification preferences for a contact",
+        description: "Update notification preferences for a contact",
         route: { method: "PATCH", path: "/v1/contacts/{pos}/notification-prefs" },
         args: [{ name: "contact-id", required: true, description: "Contact ID", posKind: "contact" }],
         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" }
+          { flags: "--email-enabled <email-enabled>", description: "Enable email notifications (true/false)" },
+          { flags: "--sms-enabled <sms-enabled>", description: "Enable SMS notifications (true/false)" },
+          { flags: "--webhook-enabled <webhook-enabled>", description: "Enable webhook notifications (true/false)" }
         ],
-        examples: ["corp contacts update-notification-prefs <contact-id>", "corp contacts update-notification-prefs --json"],
-        successTemplate: "Notification Prefs updated"
+        examples: [
+          "corp contacts update-notification-prefs con_abc123 --email-enabled true",
+          "corp contacts update-notification-prefs con_abc123 --sms-enabled false --webhook-enabled true --json"
+        ],
+        successTemplate: "Notification preferences updated"
       }
     ];
   }
@@ -4268,8 +4199,8 @@ var init_formation = __esm({
         produces: { kind: "entity", trackEntity: true },
         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 --principal-name "Carlos"'
+          'corp form create --type c_corp --name "Acme Inc" --jurisdiction US-DE --address "123 Main St,Wilmington,DE,19801"',
+          'corp form create --type llc --name "My LLC" --jurisdiction US-WY'
         ]
       },
       {
@@ -4315,7 +4246,11 @@ var init_formation = __esm({
           { flags: "--incorporator-address <address>", description: "Incorporator mailing address (overrides founder)" }
         ],
         handler: formFinalizeHandler,
-        examples: ["corp form finalize"]
+        examples: [
+          "corp form finalize @last:entity",
+          "corp form finalize @last:entity --authorized-shares 10000000 --par-value 0.0001",
+          'corp form finalize @last:entity --company-address "123 Main St,Wilmington,DE,19801" --incorporator-name "Alice Smith"'
+        ]
       },
       {
         name: "form activate",
@@ -4330,21 +4265,28 @@ var init_formation = __esm({
           { flags: "--ein <ein>", description: "EIN to confirm (defaults to a deterministic simulated EIN)" }
         ],
         handler: formActivateHandler,
-        examples: ["corp form activate"]
+        examples: [
+          "corp form activate @last:entity",
+          "corp form activate @last:entity --ein 84-1234567",
+          "corp form activate @last:entity --filing-id DE-2026-0042 --receipt-reference RECEIPT-001"
+        ]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
         name: "contracts",
-        description: "Generate a contract document",
+        description: "Create a contract document for the active entity",
         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"] }
+          { flags: "--counterparty-name <counterparty-name>", description: "Full legal name of the counterparty", required: true },
+          { flags: "--effective-date <effective-date>", description: "Contract effective date (YYYY-MM-DD)", required: true },
+          { flags: "--parameters <parameters>", description: "Additional contract parameters as a JSON object" },
+          { flags: "--template-type <template-type>", description: "Contract template to use", 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"
+        examples: [
+          'corp contracts --template-type consulting_agreement --counterparty-name "Acme Consulting LLC" --effective-date 2026-04-01',
+          'corp contracts --template-type nda --counterparty-name "Partner Corp" --effective-date 2026-04-01 --json'
+        ],
+        successTemplate: "Contract created: {contract_id}"
       },
       {
         name: "documents show",
@@ -4353,7 +4295,7 @@ var init_formation = __esm({
         entity: true,
         args: [{ name: "document-id", required: true, description: "Document ID", posKind: "document" }],
         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"]
+        examples: ["corp documents show @last", "corp documents show doc-abc123 --json"]
       },
       {
         name: "documents amendment-history",
@@ -4362,26 +4304,29 @@ var init_formation = __esm({
         entity: true,
         args: [{ name: "document-id", required: true, description: "Document ID", posKind: "document" }],
         display: { title: "Documents Amendment History", cols: ["amended_at>Amended At", "description>Description", "version>Version"] },
-        examples: ["corp documents amendment-history", "corp documents amendment-history --json"]
+        examples: ["corp documents amendment-history @last", "corp documents amendment-history doc-abc123 --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", posKind: "document" }],
-        examples: ["corp documents pdf", "corp documents pdf --json"]
+        args: [{ name: "document-id", required: true, description: "Document ID or @last reference", posKind: "document" }],
+        examples: ["corp documents pdf @last", "corp documents pdf doc-abc123"]
       },
       {
         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", posKind: "document" }],
+        args: [{ name: "document-id", required: true, description: "Document ID or @last reference", posKind: "document" }],
         options: [
-          { flags: "--recipient-email <recipient-email>", description: "Recipient Email" }
+          { flags: "--recipient-email <recipient-email>", description: "Email address to send the certified copy to" }
         ],
-        examples: ["corp documents request-copy <document-id>", "corp documents request-copy --json"],
-        successTemplate: "Request Copy created"
+        examples: [
+          "corp documents request-copy @last",
+          "corp documents request-copy doc-abc123 --recipient-email alice@acme.com"
+        ],
+        successTemplate: "Certified copy requested for document {document_id}"
       },
       {
         name: "entities list",
@@ -4408,69 +4353,78 @@ var init_formation = __esm({
       },
       {
         name: "formations create",
-        description: "View formation status for an entity",
+        description: "Create a new formation with founders and cap table in one step",
         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: "--authorized-shares <authorized-shares>", description: "Number of authorized shares (e.g. 10000000)" },
+          { flags: "--company-address <company-address>", description: "Company mailing address as 'street,city,state,zip'" },
+          { flags: "--entity-type <entity-type>", description: "Legal structure of the entity", required: true, choices: ["c_corp", "llc"] },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: "Fiscal year end (MM-DD, e.g. 12-31). Defaults to 12-31." },
+          { flags: "--formation-date <formation-date>", description: "Formation date for importing a pre-formed entity (ISO 8601)" },
+          { flags: "--jurisdiction <jurisdiction>", description: "Incorporation jurisdiction (e.g. US-DE, US-WY)", 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: "--members <members>", description: "Member/founder entries (repeatable)", required: true, type: "array" },
+          { flags: "--par-value <par-value>", description: "Par value per share (e.g. 0.0001)" },
           { 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." }
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent legal name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include right of first refusal in bylaws (true/false, corp only, default true)" },
+          { flags: "--s-corp-election <s-corp-election>", description: "Elect S-Corp tax treatment (true/false)" },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Include transfer restrictions in bylaws (true/false, corp only, default true)" }
+        ],
+        examples: [
+          `corp formations create --entity-type c_corp --jurisdiction US-DE --legal-name "Acme Inc" --members '{"name":"Alice","email":"alice@acme.com","role":"director","ownership_pct":100}'`,
+          `corp formations create --entity-type llc --jurisdiction US-WY --legal-name "My LLC" --members '{"name":"Bob","email":"bob@co.com","role":"member","ownership_pct":100}' --json`
         ],
-        examples: ["corp formations --entity-type c_corp --jurisdiction 'jurisdiction' --legal-name 'legal-name' --members 'members'", "corp formations --json"],
-        successTemplate: "Formations created"
+        successTemplate: "Formation created: {entity_id}"
       },
       {
         name: "formations pending",
-        description: "Create a pending formation",
+        description: "Create a pending (draft) formation record without founders",
         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: "--company-address <company-address>", description: "Company mailing address as 'street,city,state,zip'" },
+          { flags: "--entity-type <entity-type>", description: "Legal structure of the entity", required: true, choices: ["c_corp", "llc"] },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: "Fiscal year end (MM-DD, e.g. 12-31)" },
+          { flags: "--formation-date <formation-date>", description: "Formation date for pre-formed entity import (ISO 8601)" },
+          { flags: "--jurisdiction <jurisdiction>", description: "Incorporation jurisdiction (e.g. US-DE, US-WY)" },
           { 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" }
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent legal name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include ROFR in bylaws (true/false, corp only)" },
+          { flags: "--s-corp-election <s-corp-election>", description: "Elect S-Corp tax treatment (true/false)" },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Include transfer restrictions in bylaws (true/false, corp only)" }
+        ],
+        examples: [
+          'corp formations pending --entity-type c_corp --legal-name "Acme Inc" --jurisdiction US-DE',
+          'corp formations pending --entity-type llc --legal-name "My LLC" --jurisdiction US-WY --json'
         ],
-        examples: ["corp formations pending --entity-type c_corp --legal-name 'legal-name'", "corp formations pending --json"],
-        successTemplate: "Pending formation created"
+        successTemplate: "Pending formation created: {entity_id}"
       },
       {
         name: "formations with-cap-table",
-        description: "Create entity with formation and initial cap table",
+        description: "Create a formation together with an initial cap table in one request",
         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: "--authorized-shares <authorized-shares>", description: "Number of authorized shares (e.g. 10000000)" },
+          { flags: "--company-address <company-address>", description: "Company mailing address as 'street,city,state,zip'" },
+          { flags: "--entity-type <entity-type>", description: "Legal structure of the entity", required: true, choices: ["c_corp", "llc"] },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: "Fiscal year end (MM-DD, e.g. 12-31). Defaults to 12-31." },
+          { flags: "--formation-date <formation-date>", description: "Formation date for pre-formed entity import (ISO 8601)" },
+          { flags: "--jurisdiction <jurisdiction>", description: "Incorporation jurisdiction (e.g. US-DE, US-WY)", 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: "--members <members>", description: "Member/founder entries (repeatable)", required: true, type: "array" },
+          { flags: "--par-value <par-value>", description: "Par value per share (e.g. 0.0001)" },
           { 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." }
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent legal name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include right of first refusal in bylaws (true/false, corp only, default true)" },
+          { flags: "--s-corp-election <s-corp-election>", description: "Elect S-Corp tax treatment (true/false)" },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Include transfer restrictions in bylaws (true/false, corp only, default true)" }
+        ],
+        examples: [
+          `corp formations with-cap-table --entity-type c_corp --jurisdiction US-DE --legal-name "Acme Inc" --members '{"name":"Alice","email":"alice@acme.com","role":"director","ownership_pct":100}' --authorized-shares 10000000`,
+          `corp formations with-cap-table --entity-type llc --jurisdiction US-WY --legal-name "My LLC" --members '{"name":"Bob","email":"bob@co.com","role":"member","ownership_pct":100}' --json`
         ],
-        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"
+        successTemplate: "Formation with cap table created: {entity_id}"
       },
       {
         name: "formations",
@@ -4485,87 +4439,99 @@ var init_formation = __esm({
         description: "Submit EIN application",
         route: { method: "POST", path: "/v1/formations/{eid}/apply-ein" },
         entity: true,
-        examples: ["corp formations apply-ein"],
-        successTemplate: "Apply Ein created"
+        examples: ["corp formations apply-ein", "corp formations apply-ein --json"],
+        successTemplate: "EIN application submitted for {entity_id}"
       },
       {
         name: "formations ein-confirmation",
-        description: "Confirm EIN received from IRS",
+        description: "Confirm the EIN received from the IRS for the active entity",
         route: { method: "POST", path: "/v1/formations/{eid}/ein-confirmation" },
         entity: true,
         options: [
-          { flags: "--ein <ein>", description: "Employer Identification Number", required: true }
+          { flags: "--ein <ein>", description: "Employer Identification Number issued by the IRS (e.g. 84-1234567)", required: true }
         ],
-        examples: ["corp formations ein-confirmation --ein 'ein'"],
-        successTemplate: "Ein Confirmation created"
+        examples: ["corp formations ein-confirmation --ein 84-1234567", "corp formations ein-confirmation --ein 84-1234567 --json"],
+        successTemplate: "EIN confirmed: {ein}"
       },
       {
         name: "formations filing-attestation",
-        description: "Attest to filing accuracy",
+        description: "Record a filing accuracy attestation signed by an authorized person",
         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 }
+          { flags: "--consent-text <consent-text>", description: "Custom consent statement text (uses default if omitted)" },
+          { flags: "--notes <notes>", description: "Additional notes to attach to the attestation record" },
+          { flags: "--signer-email <signer-email>", description: "Email address of the person attesting", required: true },
+          { flags: "--signer-name <signer-name>", description: "Full legal name of the person attesting", required: true },
+          { flags: "--signer-role <signer-role>", description: "Role of the signer (e.g. CEO, Incorporator)", required: true }
+        ],
+        examples: [
+          'corp formations filing-attestation --signer-email alice@acme.com --signer-name "Alice Smith" --signer-role Incorporator',
+          'corp formations filing-attestation --signer-email alice@acme.com --signer-name "Alice Smith" --signer-role CEO --json'
         ],
-        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"
+        successTemplate: "Filing attestation recorded for {entity_id}"
       },
       {
         name: "formations filing-confirmation",
-        description: "Confirm state filing received",
+        description: "Record confirmation that the state filing has been received and processed",
         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" }
+          { flags: "--external-filing-id <external-filing-id>", description: "State-issued filing identifier (e.g. DE-2026-0042)", required: true },
+          { flags: "--receipt-reference <receipt-reference>", description: "Payment or receipt reference number for the filing fee" }
         ],
-        examples: ["corp formations filing-confirmation --external-filing-id 'external-filing-id'", "corp formations filing-confirmation --json"],
-        successTemplate: "Filing Confirmation created"
+        examples: [
+          "corp formations filing-confirmation --external-filing-id DE-2026-0042",
+          "corp formations filing-confirmation --external-filing-id DE-2026-0042 --receipt-reference RECEIPT-001 --json"
+        ],
+        successTemplate: "Filing confirmation recorded: {external_filing_id}"
       },
       {
         name: "formations finalize",
-        description: "Finalize a formation (lock documents)",
+        description: "Finalize a formation, locking documents and generating the cap table",
         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: "--authorized-shares <authorized-shares>", description: "Number of authorized shares (e.g. 10000000)" },
+          { flags: "--board-size <board-size>", description: "Number of board seats (corporations only)" },
+          { flags: "--company-address <company-address>", description: "Company mailing address as 'street,city,state,zip'" },
+          { flags: "--fiscal-year-end <fiscal-year-end>", description: "Fiscal year end (MM-DD, e.g. 12-31)" },
+          { flags: "--formation-date <formation-date>", description: "Formation date for pre-formed entity import (ISO 8601)" },
+          { flags: "--incorporator-address <incorporator-address>", description: "Incorporator mailing address (overrides founder address)" },
+          { flags: "--incorporator-name <incorporator-name>", description: "Incorporator full legal name (overrides founder name)" },
+          { flags: "--par-value <par-value>", description: "Par value per share (e.g. 0.0001)" },
+          { flags: "--principal-name <principal-name>", description: "Principal or managing member name for LLCs" },
           { 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" }
+          { flags: "--registered-agent-name <registered-agent-name>", description: "Registered agent legal name" },
+          { flags: "--right-of-first-refusal <right-of-first-refusal>", description: "Include ROFR in bylaws (true/false, corp only)" },
+          { flags: "--s-corp-election <s-corp-election>", description: "Elect S-Corp tax treatment (true/false)" },
+          { flags: "--transfer-restrictions <transfer-restrictions>", description: "Include transfer restrictions in bylaws (true/false, corp only)" }
+        ],
+        examples: [
+          "corp formations finalize",
+          "corp formations finalize --authorized-shares 10000000 --par-value 0.0001 --json"
         ],
-        examples: ["corp formations finalize", "corp formations finalize --json"],
-        successTemplate: "Finalize created"
+        successTemplate: "Formation finalized: {entity_id}"
       },
       {
         name: "formations founders",
-        description: "Add founders to a formation",
+        description: "Add a founder to an existing formation record",
         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"] }
+          { flags: "--address <address>", description: "Founder mailing address as 'street,city,state,zip'" },
+          { flags: "--email <email>", description: "Founder email address" },
+          { flags: "--is-incorporator <is-incorporator>", description: "Mark as the sole incorporator (true/false, corporations only)" },
+          { flags: "--name <name>", description: "Founder full legal name", required: true },
+          { flags: "--officer-title <officer-title>", description: "Officer title for the founder (corporations only)", choices: ["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"] },
+          { flags: "--ownership-pct <ownership-pct>", description: "Ownership percentage (e.g. 60 for 60%)" },
+          { flags: "--role <role>", description: "Founder role in the entity", choices: ["director", "officer", "manager", "member", "chair"] }
+        ],
+        examples: [
+          'corp formations founders --name "Alice Smith" --email alice@acme.com --role director --ownership-pct 60 --officer-title ceo --is-incorporator true',
+          'corp formations founders --name "Bob Jones" --email bob@acme.com --role director --ownership-pct 40 --json'
         ],
-        examples: ["corp formations founders --name ceo", "corp formations founders --json"],
-        successTemplate: "Founders created"
+        successTemplate: "Founder added to {entity_id}"
       },
       {
         name: "formations gates",
@@ -4580,42 +4546,48 @@ var init_formation = __esm({
         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"
+        examples: ["corp formations mark-documents-signed", "corp formations mark-documents-signed --json"],
+        successTemplate: "Formation documents marked as signed for {entity_id}"
       },
       {
         name: "formations registered-agent-consent-evidence",
-        description: "Provide registered agent consent evidence",
+        description: "Record registered agent consent evidence for the active formation",
         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" }
+          { flags: "--evidence-type <evidence-type>", description: "Type of consent evidence (e.g. generated, signed_pdf)" },
+          { flags: "--evidence-uri <evidence-uri>", description: "URI or path to the consent evidence document", required: true },
+          { flags: "--notes <notes>", description: "Additional notes about the consent evidence" }
+        ],
+        examples: [
+          "corp formations registered-agent-consent-evidence --evidence-uri https://files.example.com/consent.pdf",
+          "corp formations registered-agent-consent-evidence --evidence-uri https://files.example.com/consent.pdf --evidence-type signed_pdf --json"
         ],
-        examples: ["corp formations registered-agent-consent-evidence --evidence-uri 'evidence-uri'", "corp formations registered-agent-consent-evidence --json"],
-        successTemplate: "Registered Agent Consent Evidence created"
+        successTemplate: "Registered agent consent evidence recorded for {entity_id}"
       },
       {
         name: "formations service-agreement-execute",
-        description: "Execute the service agreement",
+        description: "Mark the formation service agreement as executed",
         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" }
+          { flags: "--contract-id <contract-id>", description: "Contract ID of the service agreement to execute" },
+          { flags: "--document-id <document-id>", description: "Document ID of the executed service agreement" },
+          { flags: "--notes <notes>", description: "Additional notes about the execution" }
+        ],
+        examples: [
+          "corp formations service-agreement-execute",
+          "corp formations service-agreement-execute --contract-id contract-abc123 --json"
         ],
-        examples: ["corp formations service-agreement-execute", "corp formations service-agreement-execute --json"],
-        successTemplate: "Service Agreement Execute created"
+        successTemplate: "Service agreement executed for {entity_id}"
       },
       {
         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"
+        examples: ["corp formations submit-filing", "corp formations submit-filing --json"],
+        successTemplate: "State filing submitted for {entity_id}"
       },
       {
         name: "governance catalog",
@@ -4630,7 +4602,7 @@ var init_formation = __esm({
         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"]
+        examples: ["corp governance catalog-markdown bylaws", "corp governance catalog-markdown articles_of_incorporation"]
       }
     ];
   }
@@ -4738,7 +4710,7 @@ var init_cap_table = __esm({
       // --- cap-table transfers ---
       {
         name: "cap-table transfers",
-        description: "Share transfers",
+        description: "List share transfers for this entity",
         route: { method: "GET", path: "/v1/entities/{eid}/share-transfers" },
         entity: true,
         display: {
@@ -4764,7 +4736,7 @@ var init_cap_table = __esm({
       // --- cap-table instruments ---
       {
         name: "cap-table instruments",
-        description: "Cap table instruments",
+        description: "List equity instruments (share classes, option pools, SAFEs) on the cap table",
         route: { method: "GET", path: "/v1/entities/{eid}/cap-table" },
         entity: true,
         display: {
@@ -4820,7 +4792,7 @@ var init_cap_table = __esm({
       // --- cap-table rounds ---
       {
         name: "cap-table rounds",
-        description: "Staged equity rounds",
+        description: "List equity rounds (staged and closed) for this entity",
         route: { method: "GET", path: "/v1/entities/{eid}/equity-rounds" },
         entity: true,
         display: {
@@ -4846,7 +4818,7 @@ var init_cap_table = __esm({
       // --- cap-table valuations ---
       {
         name: "cap-table valuations",
-        description: "Valuations history",
+        description: "List valuation history (409A, FMV, and other valuations)",
         route: { method: "GET", path: "/v1/entities/{eid}/valuations" },
         entity: true,
         display: {
@@ -4986,7 +4958,10 @@ var init_cap_table = __esm({
           }
           ctx.writer.json(result);
         },
-        examples: ["corp cap-table dilution", "corp cap-table dilution --json"]
+        examples: [
+          "corp cap-table dilution --round-id @last:round",
+          "corp cap-table dilution --round-id a1b2c3d4 --json"
+        ]
       },
       // --- cap-table create-instrument ---
       {
@@ -4996,7 +4971,7 @@ var init_cap_table = __esm({
         entity: true,
         dryRun: true,
         options: [
-          { flags: "--kind <kind>", description: "Instrument kind (common_equity, preferred_equity, membership_unit, option_grant, safe)", required: true },
+          { flags: "--kind <kind>", description: "Instrument kind", required: true, choices: ["common_equity", "preferred_equity", "membership_unit", "option_grant", "safe", "convertible_note", "warrant"] },
           { flags: "--symbol <symbol>", description: "Instrument symbol", required: true },
           { flags: "--issuer-legal-entity-id <ref>", description: "Issuer legal entity reference (ID, short ID, @last, or unique name)" },
           { flags: "--authorized-units <n>", description: "Authorized units", type: "int" },
@@ -5040,7 +5015,10 @@ var init_cap_table = __esm({
         },
         produces: { kind: "instrument" },
         successTemplate: "Instrument created: {symbol}",
-        examples: ["corp cap-table create-instrument --kind 'kind' --symbol 'symbol'", "corp cap-table create-instrument --json"]
+        examples: [
+          "corp cap-table create-instrument --kind common_equity --symbol COMMON",
+          "corp cap-table create-instrument --kind option_grant --symbol OPTIONS --authorized-units 10000000"
+        ]
       },
       // --- cap-table issue-equity ---
       {
@@ -5120,10 +5098,11 @@ var init_cap_table = __esm({
           }
         },
         produces: { kind: "round" },
-        successTemplate: "Equity issued: {round_name}",
+        successTemplate: "Equity issued to {recipient_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"'
+          'corp cap-table issue-equity --grant-type common --shares 1000000 --recipient "Alice Smith"',
+          'corp cap-table issue-equity --grant-type iso --shares 50000 --recipient "Bob Jones" --email "bob@acme.com"',
+          'corp cap-table issue-equity --grant-type preferred --shares 500000 --recipient "Acme Ventures" --meeting-id @last:meeting --resolution-id @last:resolution'
         ]
       },
       // --- cap-table issue-safe ---
@@ -5207,10 +5186,11 @@ var init_cap_table = __esm({
           printReferenceSummary("safe_note", result.data, { showReuseHint: true });
         },
         produces: { kind: "safe_note" },
-        successTemplate: "SAFE created: {investor_name}",
+        successTemplate: "SAFE issued to {investor_name}",
         examples: [
-          'corp cap-table issue-safe --investor "Seed Fund" --amount-dollars 500000 --valuation-cap-dollars 10000000',
-          'corp cap-table issue-safe --investor "Angel" --amount-cents 50000000 --valuation-cap-cents 1000000000'
+          'corp cap-table issue-safe --investor "Sequoia Capital" --amount-dollars 500000 --valuation-cap-dollars 10000000',
+          'corp cap-table issue-safe --investor "Angel Investor" --amount-dollars 250000 --valuation-cap-dollars 8000000 --safe-type pre_money',
+          'corp cap-table issue-safe --investor "YC" --amount-cents 12500000 --valuation-cap-cents 1500000000 --meeting-id @last:meeting --resolution-id @last:resolution'
         ]
       },
       // --- cap-table transfer ---
@@ -5225,10 +5205,10 @@ var init_cap_table = __esm({
           { 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 (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: "--governing-doc-type <type>", description: "Governing document that authorizes this transfer", default: "bylaws", choices: ["bylaws", "operating_agreement", "shareholder_agreement", "other"] },
+          { flags: "--transferee-rights <rights>", description: "Rights granted to the transferee", default: "full_member", choices: ["full_member", "economic_only", "limited"] },
           { 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: "--type <type>", description: "Type of transfer", default: "secondary_sale", choices: ["gift", "trust_transfer", "secondary_sale", "estate", "other"] },
           { flags: "--price-per-share-cents <n>", description: "Price per share in cents", type: "int" },
           { flags: "--relationship <rel>", description: "Relationship to holder" }
         ],
@@ -5313,8 +5293,11 @@ var init_cap_table = __esm({
           printReferenceSummary("share_transfer", result, { label: "Transfer Ref:", showReuseHint: true });
         },
         produces: { kind: "share_transfer" },
-        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"]
+        successTemplate: "Share transfer created: {transfer_workflow_id}",
+        examples: [
+          "corp cap-table transfer --from alice-johnson --to bob-smith --shares 50000 --type secondary_sale",
+          "corp cap-table transfer --from a1b2c3d4 --to e5f6a7b8 --shares 10000 --share-class-id COMMON --type gift --transferee-rights full_member"
+        ]
       },
       // --- cap-table distribute ---
       {
@@ -5326,7 +5309,7 @@ var init_cap_table = __esm({
         options: [
           { flags: "--amount-cents <n>", description: "Total distribution amount in cents (e.g. 100000 = $1,000.00)", required: true, type: "int" },
           { flags: "--amount-dollars <n>", description: "Total distribution amount in dollars (e.g. 1000 = $1,000.00)", type: "int" },
-          { flags: "--type <type>", description: "Distribution type (dividend, return, liquidation)", default: "dividend" },
+          { flags: "--type <type>", description: "Distribution type", default: "dividend", choices: ["dividend", "return", "liquidation"] },
           { flags: "--description <desc>", description: "Distribution description", required: true }
         ],
         handler: async (ctx) => {
@@ -5360,7 +5343,10 @@ 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"]
+        examples: [
+          'corp cap-table distribute --amount-dollars 250000 --description "Q1 2026 dividend distribution"',
+          'corp cap-table distribute --amount-cents 50000000 --type liquidation --description "Liquidation proceeds distribution"'
+        ]
       },
       // --- cap-table start-round ---
       {
@@ -5404,8 +5390,11 @@ var init_cap_table = __esm({
           printReferenceSummary("round", result, { showReuseHint: true });
         },
         produces: { kind: "round" },
-        successTemplate: "Round started: {round_name}",
-        examples: ["corp cap-table start-round --name 'name' --issuer-legal-entity-id 'ref'"]
+        successTemplate: "Round started: {name}",
+        examples: [
+          'corp cap-table start-round --name "Series A"',
+          'corp cap-table start-round --name "Seed Round" --issuer-legal-entity-id a1b2c3d4e5f6'
+        ]
       },
       // --- cap-table add-security ---
       {
@@ -5422,7 +5411,7 @@ var init_cap_table = __esm({
           { flags: "--holder-id <ref>", description: "Existing holder reference" },
           { flags: "--email <email>", description: "Recipient email (to find or create holder)" },
           { flags: "--principal-cents <n>", description: "Principal amount in cents", type: "int" },
-          { flags: "--grant-type <type>", description: "Grant type" }
+          { flags: "--grant-type <type>", description: "Grant type (common, preferred, iso, nso, rsa, membership_unit)", choices: ["common", "common_stock", "preferred", "preferred_stock", "membership_unit", "stock_option", "iso", "nso", "rsa", "svu"] }
         ],
         handler: async (ctx) => {
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
@@ -5449,7 +5438,10 @@ var init_cap_table = __esm({
           }
           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"]
+        examples: [
+          'corp cap-table add-security --round-id @last:round --instrument-id @last:instrument --quantity 500000 --recipient-name "Alice Smith"',
+          'corp cap-table add-security --round-id a1b2c3d4 --instrument-id COMMON --quantity 1000000 --recipient-name "Acme Ventures" --email "invest@acme.com" --grant-type preferred'
+        ]
       },
       // --- cap-table issue-round ---
       {
@@ -5498,7 +5490,10 @@ var init_cap_table = __esm({
             printReferenceSummary("round", roundMatch.raw, { showReuseHint: true });
           }
         },
-        examples: ["corp cap-table issue-round --round-id 'ref'", "corp cap-table issue-round --json"]
+        examples: [
+          "corp cap-table issue-round --round-id @last:round",
+          "corp cap-table issue-round --round-id a1b2c3d4 --meeting-id @last:meeting --resolution-id @last:resolution"
+        ]
       },
       // --- cap-table create-valuation ---
       {
@@ -5508,7 +5503,7 @@ var init_cap_table = __esm({
         entity: true,
         dryRun: true,
         options: [
-          { flags: "--type <type>", description: "Valuation type (four_oh_nine_a, fair_market_value, etc.)", required: true },
+          { flags: "--type <type>", description: "Valuation type", required: true, choices: ["four_oh_nine_a", "llc_profits_interest", "fair_market_value", "gift", "estate", "other"] },
           { flags: "--date <date>", description: "Effective date (ISO 8601)", 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" },
@@ -5559,8 +5554,11 @@ var init_cap_table = __esm({
           printReferenceSummary("valuation", result, { showReuseHint: true });
         },
         produces: { kind: "valuation" },
-        successTemplate: "Valuation created",
-        examples: ["corp cap-table create-valuation --type 'type' --date 'date' --methodology 'method'", "corp cap-table create-valuation --json"]
+        successTemplate: "Valuation created: {valuation_id}",
+        examples: [
+          "corp cap-table create-valuation --type four_oh_nine_a --date 2026-01-01 --methodology backsolve",
+          "corp cap-table create-valuation --type four_oh_nine_a --date 2026-01-01 --methodology market --fmv 125 --enterprise-value 50000000 --auto-approve"
+        ]
       },
       // --- cap-table submit-valuation <valuation-ref> ---
       {
@@ -5618,7 +5616,10 @@ var init_cap_table = __esm({
             }
           }
         },
-        examples: ["corp cap-table submit-valuation <valuation-ref>"]
+        examples: [
+          "corp cap-table submit-valuation @last:valuation",
+          "corp cap-table submit-valuation a1b2c3d4 --json"
+        ]
       },
       // --- cap-table approve-valuation <valuation-ref> ---
       {
@@ -5662,7 +5663,11 @@ var init_cap_table = __esm({
             }
           }
         },
-        examples: ["corp cap-table approve-valuation <valuation-ref>", "corp cap-table approve-valuation --json"]
+        successTemplate: "Valuation approved: {valuation_id}",
+        examples: [
+          "corp cap-table approve-valuation @last:valuation",
+          "corp cap-table approve-valuation a1b2c3d4 --resolution-id @last:resolution"
+        ]
       },
       // --- cap-table preview-conversion ---
       {
@@ -5692,7 +5697,10 @@ var init_cap_table = __esm({
           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"]
+        examples: [
+          "corp cap-table preview-conversion --safe-id @last:safe_note --price-per-share-cents 125",
+          "corp cap-table preview-conversion --safe-id a1b2c3d4 --price-per-share-cents 200 --json"
+        ]
       },
       // --- cap-table convert ---
       {
@@ -5726,7 +5734,10 @@ var init_cap_table = __esm({
           }
           ctx.writer.success(`Conversion executed for SAFE ${safeId}`);
         },
-        examples: ["corp cap-table convert --safe-id 'ref' --price-per-share-cents 'n'"]
+        examples: [
+          "corp cap-table convert --safe-id @last:safe_note --price-per-share-cents 125",
+          "corp cap-table convert --safe-id a1b2c3d4 --price-per-share-cents 200 --dry-run"
+        ]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
@@ -5741,8 +5752,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity control-links --child-legal-entity-id a1b2c3d4 --control-type voting --parent-legal-entity-id e5f6a7b8",
+          "corp equity control-links --child-legal-entity-id a1b2c3d4 --control-type board --parent-legal-entity-id e5f6a7b8 --voting-power-bps 5100"
+        ],
+        successTemplate: "Control link created"
       },
       {
         name: "equity control-map",
@@ -5761,8 +5775,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity conversions-execute --intent-id a1b2c3d4 --round-id e5f6a7b8",
+          "corp equity conversions-execute --intent-id a1b2c3d4 --round-id e5f6a7b8 --source-reference safe-note:f9g0h1i2"
+        ],
+        successTemplate: "Conversion executed"
       },
       {
         name: "equity conversions-preview",
@@ -5773,8 +5790,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity conversions-preview --round-id a1b2c3d4",
+          "corp equity conversions-preview --round-id a1b2c3d4 --source-reference safe-note:b2c3d4e5 --json"
+        ],
+        successTemplate: "Conversion preview calculated"
       },
       {
         name: "equity dilution-preview",
@@ -5794,8 +5814,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity entities --name "Acme Corp" --role operating',
+          'corp equity entities --name "Acme Holdings LLC" --role control --linked-entity-id a1b2c3d4'
+        ],
+        successTemplate: "Legal entity registered"
       },
       {
         name: "equity create-fundraising-workflow",
@@ -5811,8 +5834,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity create-fundraising-workflow --name "Series A" --issuer-legal-entity-id a1b2c3d4 --prepare-intent-id e5f6a7b8',
+          'corp equity create-fundraising-workflow --name "Seed Round" --issuer-legal-entity-id a1b2c3d4 --prepare-intent-id e5f6a7b8 --target-raise-cents 200000000'
+        ],
+        successTemplate: "Fundraising workflow created"
       },
       {
         name: "equity fundraising-workflows",
@@ -5821,7 +5847,7 @@ var init_cap_table = __esm({
         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"]
+        examples: ["corp equity fundraising-workflows a1b2c3d4", "corp equity fundraising-workflows a1b2c3d4 --json"]
       },
       {
         name: "equity fundraising-workflows-apply-terms",
@@ -5833,8 +5859,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity fundraising-workflows-apply-terms a1b2c3d4 --anti-dilution-method broad_based_weighted_average",
+          "corp equity fundraising-workflows-apply-terms a1b2c3d4 --anti-dilution-method none --protective-provisions 'standard Series A provisions'"
+        ],
+        successTemplate: "Term sheet applied to fundraising workflow"
       },
       {
         name: "equity fundraising-workflows-compile-packet",
@@ -5845,8 +5874,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity fundraising-workflows-compile-packet a1b2c3d4",
+          "corp equity fundraising-workflows-compile-packet a1b2c3d4 --phase closing"
+        ],
+        successTemplate: "Document packet compiled"
       },
       {
         name: "equity fundraising-workflows-finalize",
@@ -5856,8 +5888,11 @@ var init_cap_table = __esm({
         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"
+        examples: [
+          "corp equity fundraising-workflows-finalize a1b2c3d4",
+          "corp equity fundraising-workflows-finalize a1b2c3d4 --json"
+        ],
+        successTemplate: "Fundraising workflow finalized"
       },
       {
         name: "equity fundraising-workflows-generate-board-packet",
@@ -5867,8 +5902,11 @@ var init_cap_table = __esm({
         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"
+        examples: [
+          "corp equity fundraising-workflows-generate-board-packet a1b2c3d4",
+          "corp equity fundraising-workflows-generate-board-packet a1b2c3d4 --json"
+        ],
+        successTemplate: "Board approval packet generated"
       },
       {
         name: "equity fundraising-workflows-generate-closing-packet",
@@ -5878,8 +5916,11 @@ var init_cap_table = __esm({
         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"
+        examples: [
+          "corp equity fundraising-workflows-generate-closing-packet a1b2c3d4",
+          "corp equity fundraising-workflows-generate-closing-packet a1b2c3d4 --json"
+        ],
+        successTemplate: "Closing packet generated"
       },
       {
         name: "equity fundraising-workflows-prepare-execution",
@@ -5892,8 +5933,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity fundraising-workflows-prepare-execution a1b2c3d4 --approval-artifact-id b2c3d4e5 --intent-id f6g7h8i9",
+          "corp equity fundraising-workflows-prepare-execution a1b2c3d4 --approval-artifact-id b2c3d4e5 --intent-id f6g7h8i9 --json"
+        ],
+        successTemplate: "Fundraising workflow prepared for execution"
       },
       {
         name: "equity fundraising-workflows-record-board-approval",
@@ -5904,8 +5948,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity fundraising-workflows-record-board-approval a1b2c3d4 --meeting-id @last:meeting --resolution-id @last:resolution",
+          "corp equity fundraising-workflows-record-board-approval a1b2c3d4 --meeting-id b2c3d4e5 --resolution-id f6g7h8i9"
+        ],
+        successTemplate: "Board approval recorded"
       },
       {
         name: "equity fundraising-workflows-record-close",
@@ -5915,8 +5962,10 @@ var init_cap_table = __esm({
         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"
+        examples: [
+          "corp equity fundraising-workflows-record-close a1b2c3d4 --intent-id b2c3d4e5"
+        ],
+        successTemplate: "Fundraising round closed"
       },
       {
         name: "equity fundraising-workflows-record-investor-acceptance",
@@ -5927,8 +5976,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity fundraising-workflows-record-investor-acceptance a1b2c3d4 --intent-id b2c3d4e5",
+          "corp equity fundraising-workflows-record-investor-acceptance a1b2c3d4 --intent-id b2c3d4e5 --accepted-by-contact-id c3d4e5f6"
+        ],
+        successTemplate: "Investor acceptance recorded"
       },
       {
         name: "equity fundraising-workflows-record-signature",
@@ -5939,16 +5991,21 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity fundraising-workflows-record-signature a1b2c3d4 --signer-identity "alice@acme.com"',
+          'corp equity fundraising-workflows-record-signature a1b2c3d4 --signer-identity "alice@acme.com" --channel written_consent'
+        ],
+        successTemplate: "Signature recorded"
       },
       {
         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"
+        examples: [
+          "corp equity fundraising-workflows-start-signatures a1b2c3d4"
+        ],
+        successTemplate: "Signature collection started"
       },
       {
         name: "equity grants",
@@ -5960,8 +6017,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity grants --grant-type common_stock --recipient-name "Alice Smith" --shares 500000',
+          'corp equity grants --grant-type iso --recipient-name "Bob Jones" --shares 25000'
+        ],
+        successTemplate: "Equity grant issued"
       },
       {
         name: "equity holders",
@@ -5975,8 +6035,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity holders --contact-id a1b2c3d4 --holder-type individual --name "Alice Smith"',
+          'corp equity holders --contact-id e5f6a7b8 --holder-type fund --name "Acme Ventures Fund I"'
+        ],
+        successTemplate: "Equity holder registered"
       },
       {
         name: "equity instruments",
@@ -5991,8 +6054,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity instruments --issuer-legal-entity-id a1b2c3d4 --kind common_equity --symbol COMMON",
+          "corp equity instruments --issuer-legal-entity-id a1b2c3d4 --kind option_grant --symbol OPTIONS --authorized-units 10000000"
+        ],
+        successTemplate: "Instrument created"
       },
       {
         name: "equity positions-adjust",
@@ -6007,8 +6073,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity positions-adjust --holder-id a1b2c3d4 --instrument-id b2c3d4e5 --issuer-legal-entity-id c3d4e5f6 --quantity-delta 10000",
+          "corp equity positions-adjust --holder-id a1b2c3d4 --instrument-id b2c3d4e5 --issuer-legal-entity-id c3d4e5f6 --quantity-delta -5000 --source-reference correction:2026-01"
+        ],
+        successTemplate: "Equity position adjusted"
       },
       {
         name: "equity rounds",
@@ -6024,8 +6093,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity rounds --issuer-legal-entity-id a1b2c3d4 --name "Series A"',
+          'corp equity rounds --issuer-legal-entity-id a1b2c3d4 --name "Seed Round" --target-raise-cents 150000000 --pre-money-cents 800000000'
+        ],
+        successTemplate: "Equity round created"
       },
       {
         name: "equity rounds-staged",
@@ -6040,8 +6112,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity rounds-staged --issuer-legal-entity-id a1b2c3d4 --name "Series A"',
+          'corp equity rounds-staged --issuer-legal-entity-id a1b2c3d4 --name "Seed Round" --target-raise-cents 150000000'
+        ],
+        successTemplate: "Staged equity round created"
       },
       {
         name: "equity rounds-accept",
@@ -6053,8 +6128,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity rounds-accept a1b2c3d4 --intent-id b2c3d4e5",
+          "corp equity rounds-accept a1b2c3d4 --intent-id b2c3d4e5 --accepted-by-contact-id c3d4e5f6"
+        ],
+        successTemplate: "Round terms accepted"
       },
       {
         name: "equity rounds-apply-terms",
@@ -6067,8 +6145,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity rounds-apply-terms a1b2c3d4 --anti-dilution-method broad_based_weighted_average",
+          "corp equity rounds-apply-terms a1b2c3d4 --anti-dilution-method none --protective-provisions 'standard Series A'"
+        ],
+        successTemplate: "Term sheet applied to round"
       },
       {
         name: "equity rounds-board-approve",
@@ -6080,8 +6161,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity rounds-board-approve a1b2c3d4 --meeting-id @last:meeting --resolution-id @last:resolution",
+          "corp equity rounds-board-approve a1b2c3d4 --meeting-id b2c3d4e5 --resolution-id f6g7h8i9"
+        ],
+        successTemplate: "Board approval recorded for round"
       },
       {
         name: "equity rounds-issue",
@@ -6093,8 +6177,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity rounds-issue a1b2c3d4",
+          "corp equity rounds-issue a1b2c3d4 --meeting-id @last:meeting --resolution-id @last:resolution"
+        ],
+        successTemplate: "Round issued"
       },
       {
         name: "equity rounds-securities",
@@ -6111,8 +6198,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity rounds-securities a1b2c3d4 --instrument-id COMMON --quantity 500000 --recipient-name "Alice Smith"',
+          'corp equity rounds-securities a1b2c3d4 --instrument-id SERIES-A --quantity 1000000 --recipient-name "Acme Ventures" --email "invest@acme.com"'
+        ],
+        successTemplate: "Security added to round"
       },
       {
         name: "equity create-transfer-workflow",
@@ -6130,8 +6220,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity create-transfer-workflow --from-contact-id a1b2c3d4 --to-contact-id e5f6a7b8 --share-class-id COMMON --share-count 10000 --transfer-type secondary_sale --governing-doc-type bylaws --transferee-rights full_member --prepare-intent-id f9g0h1i2",
+          "corp equity create-transfer-workflow --from-contact-id a1b2c3d4 --to-contact-id e5f6a7b8 --share-class-id COMMON --share-count 5000 --transfer-type gift --governing-doc-type bylaws --transferee-rights full_member --prepare-intent-id f9g0h1i2"
+        ],
+        successTemplate: "Transfer workflow created"
       },
       {
         name: "equity transfer-workflows",
@@ -6140,7 +6233,7 @@ var init_cap_table = __esm({
         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"]
+        examples: ["corp equity transfer-workflows a1b2c3d4", "corp equity transfer-workflows a1b2c3d4 --json"]
       },
       {
         name: "equity transfer-workflows-compile-packet",
@@ -6151,8 +6244,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity transfer-workflows-compile-packet a1b2c3d4",
+          "corp equity transfer-workflows-compile-packet a1b2c3d4 --phase execution"
+        ],
+        successTemplate: "Transfer document packet compiled"
       },
       {
         name: "equity transfer-workflows-finalize",
@@ -6162,8 +6258,11 @@ var init_cap_table = __esm({
         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"
+        examples: [
+          "corp equity transfer-workflows-finalize a1b2c3d4",
+          "corp equity transfer-workflows-finalize a1b2c3d4 --json"
+        ],
+        successTemplate: "Transfer workflow finalized"
       },
       {
         name: "equity transfer-workflows-generate-docs",
@@ -6173,8 +6272,11 @@ var init_cap_table = __esm({
         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"
+        examples: [
+          "corp equity transfer-workflows-generate-docs a1b2c3d4",
+          "corp equity transfer-workflows-generate-docs a1b2c3d4 --json"
+        ],
+        successTemplate: "Transfer documents generated"
       },
       {
         name: "equity transfer-workflows-prepare-execution",
@@ -6187,8 +6289,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity transfer-workflows-prepare-execution a1b2c3d4 --approval-artifact-id b2c3d4e5 --intent-id f6g7h8i9",
+          "corp equity transfer-workflows-prepare-execution a1b2c3d4 --approval-artifact-id b2c3d4e5 --intent-id f6g7h8i9 --json"
+        ],
+        successTemplate: "Transfer workflow prepared for execution"
       },
       {
         name: "equity transfer-workflows-record-board-approval",
@@ -6199,8 +6304,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity transfer-workflows-record-board-approval a1b2c3d4 --meeting-id @last:meeting --resolution-id @last:resolution",
+          "corp equity transfer-workflows-record-board-approval a1b2c3d4 --meeting-id b2c3d4e5 --resolution-id f6g7h8i9"
+        ],
+        successTemplate: "Board approval recorded for transfer"
       },
       {
         name: "equity transfer-workflows-record-execution",
@@ -6210,8 +6318,10 @@ var init_cap_table = __esm({
         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"
+        examples: [
+          "corp equity transfer-workflows-record-execution a1b2c3d4 --intent-id b2c3d4e5"
+        ],
+        successTemplate: "Transfer execution recorded"
       },
       {
         name: "equity transfer-workflows-record-review",
@@ -6223,8 +6333,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity transfer-workflows-record-review a1b2c3d4 --approved --notes "Transfer complies with ROFR provisions" --reviewer alice-johnson',
+          'corp equity transfer-workflows-record-review a1b2c3d4 --notes "Missing consent form" --reviewer alice-johnson'
+        ],
+        successTemplate: "Transfer review recorded"
       },
       {
         name: "equity transfer-workflows-record-rofr",
@@ -6235,8 +6348,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp equity transfer-workflows-record-rofr a1b2c3d4 --offered --waived",
+          "corp equity transfer-workflows-record-rofr a1b2c3d4 --offered"
+        ],
+        successTemplate: "ROFR recorded"
       },
       {
         name: "equity transfer-workflows-record-signature",
@@ -6247,24 +6363,31 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp equity transfer-workflows-record-signature a1b2c3d4 --signer-identity "alice@acme.com"',
+          'corp equity transfer-workflows-record-signature a1b2c3d4 --signer-identity "bob@acme.com" --channel written_consent'
+        ],
+        successTemplate: "Signature recorded on transfer"
       },
       {
         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"
+        examples: [
+          "corp equity transfer-workflows-start-signatures a1b2c3d4"
+        ],
+        successTemplate: "Transfer signature collection started"
       },
       {
         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"
+        examples: [
+          "corp equity transfer-workflows-submit-review a1b2c3d4"
+        ],
+        successTemplate: "Transfer submitted for review"
       },
       {
         name: "equity workflows-status",
@@ -6273,7 +6396,10 @@ var init_cap_table = __esm({
         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"]
+        examples: [
+          "corp equity workflows-status transfer a1b2c3d4",
+          "corp equity workflows-status fundraising a1b2c3d4 --json"
+        ]
       },
       {
         name: "safe-notes",
@@ -6293,8 +6419,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          'corp safe-notes --investor-name "Sequoia Capital" --principal-amount-cents 50000000 --valuation-cap-cents 1000000000',
+          'corp safe-notes --investor-name "Angel Investor" --principal-amount-cents 25000000 --safe-type pre_money --discount-rate 20'
+        ],
+        successTemplate: "SAFE note issued"
       },
       {
         name: "share-transfers",
@@ -6309,8 +6438,11 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp share-transfers --from-holder a1b2c3d4 --to-holder e5f6a7b8 --share-class-id COMMON --shares 10000 --transfer-type secondary_sale",
+          "corp share-transfers --from-holder a1b2c3d4 --to-holder e5f6a7b8 --share-class-id COMMON --shares 5000 --transfer-type gift --governing-doc-type bylaws --transferee-rights full_member"
+        ],
+        successTemplate: "Share transfer recorded"
       },
       {
         name: "valuations",
@@ -6328,16 +6460,21 @@ var init_cap_table = __esm({
           { 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"
+        examples: [
+          "corp valuations --effective-date 2026-01-01 --methodology backsolve --valuation-type four_oh_nine_a",
+          "corp valuations --effective-date 2026-01-01 --methodology market --valuation-type fair_market_value --fmv-per-share-cents 125 --enterprise-value-cents 50000000"
+        ],
+        successTemplate: "Valuation 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"
+        examples: [
+          "corp valuations submit-for-approval a1b2c3d4"
+        ],
+        successTemplate: "Valuation submitted for approval"
       }
     ];
   }
@@ -6991,7 +7128,10 @@ var init_governance = __esm({
           }
           printSeatsTable(seats);
         },
-        examples: ["corp governance seats <body-ref>", "corp governance seats <body-ref> --json"]
+        examples: [
+          "corp governance seats @last:body",
+          "corp governance seats a1b2c3d4 --json"
+        ]
       },
       // --- governance meetings <body-ref> ---
       {
@@ -7023,7 +7163,10 @@ var init_governance = __esm({
           }
           printMeetingsTable(meetings);
         },
-        examples: ["corp governance meetings <body-ref>", "corp governance meetings <body-ref> --json"]
+        examples: [
+          "corp governance meetings @last:body",
+          "corp governance meetings a1b2c3d4 --json"
+        ]
       },
       // --- governance resolutions <meeting-ref> ---
       {
@@ -7055,7 +7198,10 @@ var init_governance = __esm({
           }
           printResolutionsTable(resolutions);
         },
-        examples: ["corp governance resolutions <meeting-ref>", "corp governance resolutions <meeting-ref> --json"]
+        examples: [
+          "corp governance resolutions @last:meeting",
+          "corp governance resolutions a1b2c3d4 --json"
+        ]
       },
       // --- governance agenda-items <meeting-ref> ---
       {
@@ -7087,12 +7233,15 @@ var init_governance = __esm({
           }
           printAgendaItemsTable(items);
         },
-        examples: ["corp governance agenda-items <meeting-ref>", "corp governance agenda-items <meeting-ref> --json"]
-      },
+        examples: [
+          "corp governance agenda-items @last:meeting",
+          "corp governance agenda-items a1b2c3d4 --json"
+        ]
+      },
       // --- governance incidents ---
       {
         name: "governance incidents",
-        description: "Report a governance incident",
+        description: "List governance incidents for this entity",
         route: { method: "GET", path: "/v1/entities/{eid}/governance/incidents" },
         entity: true,
         display: { title: "Governance Incidents" },
@@ -7175,7 +7324,11 @@ var init_governance = __esm({
             if (result.reason) console.log(`  ${chalk8.bold("Reason:")} ${result.reason}`);
           }
         },
-        examples: ["corp governance mode", "corp governance mode --json"]
+        examples: [
+          "corp governance mode",
+          "corp governance mode --set board",
+          "corp governance mode --set founder"
+        ]
       },
       // --- governance create-body ---
       {
@@ -7219,7 +7372,10 @@ var init_governance = __esm({
         },
         produces: { kind: "body" },
         successTemplate: "Governance body created: {name}",
-        examples: ["corp governance create-body --name 'name' --body-type 'type'", "corp governance create-body --json"]
+        examples: [
+          'corp governance create-body --name "Board of Directors" --body-type board_of_directors',
+          'corp governance create-body --name "Member Vote" --body-type llc_member_vote --quorum unanimous --voting per_unit'
+        ]
       },
       // --- governance add-seat <body-ref> ---
       {
@@ -7231,7 +7387,7 @@ var init_governance = __esm({
         args: [{ name: "body-ref", required: true, description: "Governance body reference" }],
         options: [
           { flags: "--holder <contact-ref>", description: "Contact reference for the seat holder", required: true },
-          { flags: "--role <role>", description: "Seat role (chair, member, officer, observer)", default: "member" }
+          { flags: "--role <role>", description: "Seat role", default: "member", choices: ["chair", "member", "officer", "observer"] }
         ],
         handler: async (ctx) => {
           const bodyRef = ctx.positional[0];
@@ -7254,8 +7410,11 @@ var init_governance = __esm({
           printReferenceSummary("seat", result, { showReuseHint: true });
         },
         produces: { kind: "seat" },
-        successTemplate: "Seat added to {body_id}",
-        examples: ["corp governance add-seat <body-ref> --holder 'contact-ref'", "corp governance add-seat --json"]
+        successTemplate: "Seat added: {seat_id}",
+        examples: [
+          "corp governance add-seat @last:body --holder alice-johnson",
+          "corp governance add-seat @last:body --holder bob-smith --role chair"
+        ]
       },
       // --- governance convene ---
       {
@@ -7266,7 +7425,7 @@ var init_governance = __esm({
         dryRun: true,
         options: [
           { flags: "--body <ref>", description: "Governance body reference", required: true },
-          { flags: "--type <type>", description: "Meeting type (board_meeting, shareholder_meeting, member_meeting, written_consent)", required: true },
+          { flags: "--type <type>", description: "Meeting type", required: true, choices: ["board_meeting", "shareholder_meeting", "member_meeting", "written_consent"] },
           { flags: "--title <title>", description: "Meeting title", required: true },
           { flags: "--date <date>", description: "Meeting date (ISO 8601)" },
           { flags: "--agenda <item>", description: "Agenda item (repeatable)", type: "array" }
@@ -7303,7 +7462,10 @@ var init_governance = __esm({
         },
         produces: { kind: "meeting" },
         successTemplate: "Meeting scheduled: {title}",
-        examples: ["corp governance convene --body 'ref' --type 'type' --title 'title'", "corp governance convene --json"]
+        examples: [
+          'corp governance convene --body @last:body --type board_meeting --title "Q1 2026 Board Meeting" --date 2026-03-31',
+          'corp governance convene --body @last:body --type board_meeting --title "Special Meeting" --agenda "Approve option plan" --agenda "Approve SAFE issuance"'
+        ]
       },
       // --- governance open <meeting-ref> ---
       {
@@ -7345,7 +7507,10 @@ var init_governance = __esm({
           }
           ctx.writer.success(`Meeting opened: ${resolvedMeetingId}`);
         },
-        examples: ["corp governance open <meeting-ref> --present-seat 'ref'"]
+        examples: [
+          "corp governance open @last:meeting --present-seat @last:seat",
+          "corp governance open a1b2c3d4 --present-seat seat-alice --present-seat seat-bob"
+        ]
       },
       // --- governance vote <meeting-ref> <item-ref> ---
       {
@@ -7399,7 +7564,11 @@ var init_governance = __esm({
             }
           }
         },
-        examples: ["corp governance vote <meeting-ref> <item-ref> --voter <contact-ref> --vote for"]
+        successTemplate: "Vote recorded: {vote_id}",
+        examples: [
+          "corp governance vote @last:meeting @last:agenda_item --voter alice-johnson --vote for",
+          "corp governance vote a1b2c3d4 b2c3d4e5 --voter bob-smith --vote against"
+        ]
       },
       // --- governance notice <meeting-ref> ---
       {
@@ -7424,7 +7593,11 @@ var init_governance = __esm({
           }
           ctx.writer.success(`Notice sent for meeting ${resolvedMeetingId}`);
         },
-        examples: ["corp governance notice <meeting-ref>"]
+        successTemplate: "Meeting notice sent",
+        examples: [
+          "corp governance notice @last:meeting",
+          "corp governance notice a1b2c3d4"
+        ]
       },
       // --- governance adjourn <meeting-ref> ---
       {
@@ -7449,7 +7622,11 @@ var init_governance = __esm({
           }
           ctx.writer.success(`Meeting ${resolvedMeetingId} adjourned`);
         },
-        examples: ["corp governance adjourn <meeting-ref>"]
+        successTemplate: "Meeting adjourned",
+        examples: [
+          "corp governance adjourn @last:meeting",
+          "corp governance adjourn a1b2c3d4"
+        ]
       },
       // --- governance reopen <meeting-ref> ---
       {
@@ -7474,7 +7651,11 @@ var init_governance = __esm({
           }
           ctx.writer.success(`Meeting ${resolvedMeetingId} re-opened`);
         },
-        examples: ["corp governance reopen <meeting-ref>"]
+        successTemplate: "Meeting re-opened",
+        examples: [
+          "corp governance reopen @last:meeting",
+          "corp governance reopen a1b2c3d4"
+        ]
       },
       // --- governance cancel <meeting-ref> ---
       {
@@ -7512,7 +7693,11 @@ var init_governance = __esm({
           }
           ctx.writer.success(`Meeting ${resolvedMeetingId} cancelled`);
         },
-        examples: ["corp governance cancel <meeting-ref>", "corp governance cancel --json"]
+        successTemplate: "Meeting cancelled",
+        examples: [
+          "corp governance cancel @last:meeting",
+          "corp governance cancel a1b2c3d4 --yes"
+        ]
       },
       // --- governance finalize-item <meeting-ref> <item-ref> ---
       {
@@ -7551,7 +7736,11 @@ var init_governance = __esm({
           }
           ctx.writer.success(`Agenda item ${resolvedItemId} finalized as ${ctx.opts.status}`);
         },
-        examples: ["corp governance finalize-item <meeting-ref> <item-ref>"]
+        successTemplate: "Agenda item finalized",
+        examples: [
+          "corp governance finalize-item @last:meeting @last:agenda_item --status voted",
+          "corp governance finalize-item a1b2c3d4 b2c3d4e5 --status tabled"
+        ]
       },
       // --- governance resolve <meeting-ref> <item-ref> ---
       {
@@ -7594,8 +7783,11 @@ var init_governance = __esm({
           printReferenceSummary("resolution", result, { showReuseHint: true });
         },
         produces: { kind: "resolution" },
-        successTemplate: "Resolution computed",
-        examples: ["corp governance resolve <meeting-ref> <item-ref> --text 'resolution_text'"]
+        successTemplate: "Resolution computed: {resolution_id}",
+        examples: [
+          'corp governance resolve @last:meeting @last:agenda_item --text "RESOLVED: The board approves the 2026 option plan."',
+          'corp governance resolve a1b2c3d4 b2c3d4e5 --text "RESOLVED: The board authorizes issuance of Series A preferred stock."'
+        ]
       },
       // --- governance written-consent ---
       {
@@ -7647,7 +7839,10 @@ var init_governance = __esm({
         },
         produces: { kind: "meeting" },
         successTemplate: "Written consent created: {title}",
-        examples: ["corp governance written-consent --body 'ref' --title 'title' --description 'desc'"]
+        examples: [
+          'corp governance written-consent --body @last:body --title "Approve 2026 Option Plan" --description "The board approves adoption of the 2026 Equity Incentive Plan."',
+          'corp governance written-consent --body @last:body --title "Authorize SAFE Issuance" --description "The board authorizes issuance of a SAFE to Sequoia Capital for $500,000."'
+        ]
       },
       // --- governance quick-approve ---
       {
@@ -7762,6 +7957,10 @@ var init_governance = __esm({
           const seatRef = ctx.positional[0];
           const eid = await ctx.resolver.resolveEntity(ctx.opts.entityId);
           const seatId = await ctx.resolver.resolveSeat(eid, seatRef, ctx.opts.bodyId);
+          if (ctx.dryRun) {
+            ctx.writer.dryRun("governance.resign_seat", { entity_id: eid, seat_id: seatId });
+            return;
+          }
           const result = await ctx.client.resignSeat(seatId, eid);
           if (ctx.opts.json) {
             ctx.writer.json(result);
@@ -7769,7 +7968,11 @@ var init_governance = __esm({
           }
           ctx.writer.success(`Seat ${seatId} resigned.`);
         },
-        examples: ["corp governance resign <seat-ref>", "corp governance resign --json"]
+        successTemplate: "Seat resigned",
+        examples: [
+          "corp governance resign @last:seat",
+          "corp governance resign a1b2c3d4"
+        ]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
@@ -7820,17 +8023,20 @@ var init_governance = __esm({
         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"
+        examples: [
+          "corp entities governance-doc-bundles-generate",
+          "corp entities governance-doc-bundles-generate --template-version v2 --json"
+        ],
+        successTemplate: "Governance document bundle generated"
       },
       {
         name: "entities governance-doc-bundle",
-        description: "List governance document bundles",
+        description: "View a specific governance document bundle by ID",
         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"]
+        examples: ["corp entities governance-doc-bundle a1b2c3d4", "corp entities governance-doc-bundle a1b2c3d4 --json"]
       },
       {
         name: "entities governance-mode-history",
@@ -7866,7 +8072,10 @@ var init_governance = __esm({
           { 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"],
+        examples: [
+          'corp governance-bodies create --name "Board of Directors" --body-type board_of_directors --quorum-rule majority --voting-method per_capita',
+          'corp governance-bodies create --name "LLC Member Vote" --body-type llc_member_vote --quorum-rule unanimous --voting-method per_unit'
+        ],
         successTemplate: "Governance body created"
       },
       {
@@ -7874,8 +8083,10 @@ var init_governance = __esm({
         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: "Expired seats scanned"
+        examples: [
+          "corp governance-seats scan-expired"
+        ],
+        successTemplate: "Expired seats scanned and flagged"
       },
       {
         name: "governance-seats resign",
@@ -7883,7 +8094,9 @@ var init_governance = __esm({
         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>"],
+        examples: [
+          "corp governance-seats resign a1b2c3d4"
+        ],
         successTemplate: "Seat resigned"
       },
       {
@@ -7892,7 +8105,7 @@ var init_governance = __esm({
         route: { method: "POST", path: "/v1/governance/audit/checkpoints" },
         entity: true,
         examples: ["corp governance audit-checkpoints"],
-        successTemplate: "Audit Checkpoints created"
+        successTemplate: "Audit checkpoint created"
       },
       {
         name: "governance audit-events",
@@ -7909,8 +8122,11 @@ var init_governance = __esm({
           { 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"
+        examples: [
+          'corp governance audit-events --action "Mode changed to board" --event-type mode_changed',
+          'corp governance audit-events --action "Manual review completed" --event-type manual_event --details "Reviewed by legal team"'
+        ],
+        successTemplate: "Audit event recorded"
       },
       {
         name: "governance audit-verify",
@@ -7918,7 +8134,7 @@ var init_governance = __esm({
         route: { method: "POST", path: "/v1/governance/audit/verify" },
         entity: true,
         examples: ["corp governance audit-verify"],
-        successTemplate: "Audit Verify created"
+        successTemplate: "Governance audit verified"
       },
       {
         name: "governance delegation-schedule",
@@ -7941,8 +8157,11 @@ var init_governance = __esm({
           { 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"
+        examples: [
+          'corp governance delegation-schedule-amend --rationale "Expanding Tier 1 authority for routine operations"',
+          "corp governance delegation-schedule-amend --meeting-id @last:meeting --adopted-resolution-id @last:resolution --tier1-max-amount-cents 500000"
+        ],
+        successTemplate: "Delegation schedule amended"
       },
       {
         name: "governance delegation-schedule-history",
@@ -7962,8 +8181,11 @@ var init_governance = __esm({
           { 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"
+        examples: [
+          "corp governance delegation-schedule-reauthorize --adopted-resolution-id @last:resolution --meeting-id @last:meeting",
+          'corp governance delegation-schedule-reauthorize --adopted-resolution-id a1b2c3d4 --meeting-id b2c3d4e5 --rationale "Annual reauthorization of delegation schedule"'
+        ],
+        successTemplate: "Delegation schedule reauthorized"
       },
       {
         name: "governance evaluate",
@@ -7974,8 +8196,11 @@ var init_governance = __esm({
           { 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: "Governance evaluated"
+        examples: [
+          "corp governance evaluate --intent-type equity.issuance.execute",
+          `corp governance evaluate --intent-type equity.transfer.prepare --metadata '{"amount_cents": 50000000}'`
+        ],
+        successTemplate: "Governance evaluation complete"
       },
       {
         name: "governance report-incident",
@@ -7987,8 +8212,11 @@ var init_governance = __esm({
           { 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"
+        examples: [
+          'corp governance report-incident --title "Unauthorized access attempt" --description "Board portal accessed from unknown IP" --severity medium',
+          'corp governance report-incident --title "Quorum breach" --description "Meeting held without required quorum" --severity high'
+        ],
+        successTemplate: "Incident reported"
       },
       {
         name: "governance incidents-resolve",
@@ -7996,8 +8224,10 @@ var init_governance = __esm({
         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"
+        examples: [
+          "corp governance incidents-resolve a1b2c3d4"
+        ],
+        successTemplate: "Incident resolved"
       },
       {
         name: "meetings written-consent",
@@ -8008,8 +8238,11 @@ var init_governance = __esm({
           { 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"
+        examples: [
+          'corp meetings written-consent --body-id a1b2c3d4 --title "Approve Budget" --description "The board approves the 2026 operating budget."',
+          'corp meetings written-consent --body-id a1b2c3d4 --title "Authorize Officer" --description "The board authorizes Alice Smith as CFO."'
+        ],
+        successTemplate: "Written consent created"
       },
       {
         name: "meetings agenda-items-vote",
@@ -8021,8 +8254,11 @@ var init_governance = __esm({
           { 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"
+        examples: [
+          "corp meetings agenda-items-vote a1b2c3d4 b2c3d4e5 --vote-value for --voter-id c3d4e5f6",
+          "corp meetings agenda-items-vote a1b2c3d4 b2c3d4e5 --vote-value abstain --voter-id c3d4e5f6"
+        ],
+        successTemplate: "Vote recorded"
       },
       {
         name: "meetings convene",
@@ -8033,8 +8269,10 @@ var init_governance = __esm({
         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"
+        examples: [
+          "corp meetings convene a1b2c3d4 --present-seat-ids seat-alice seat-bob"
+        ],
+        successTemplate: "Meeting convened"
       },
       {
         name: "meetings resolutions-attach-document",
@@ -8044,8 +8282,10 @@ var init_governance = __esm({
         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"
+        examples: [
+          "corp meetings resolutions-attach-document a1b2c3d4 b2c3d4e5 --document-id c3d4e5f6"
+        ],
+        successTemplate: "Document attached to resolution"
       }
     ];
   }
@@ -8141,7 +8381,7 @@ var init_documents = __esm({
           }
           console.log(shareUrl);
         },
-        examples: ["corp documents signing-link", "corp documents signing-link --json"]
+        examples: ["corp documents signing-link @last", "corp documents signing-link doc-abc123"]
       },
       // --- documents sign <doc-ref> ---
       {
@@ -8195,7 +8435,10 @@ var init_documents = __esm({
           printReferenceSummary("document", result.document, { showReuseHint: true });
           printJson(result.document);
         },
-        examples: ["corp documents sign <doc-ref>", "corp documents sign --json"]
+        examples: [
+          "corp documents sign @last",
+          'corp documents sign doc-abc123 --signer-name "Alice Smith" --signer-role CEO --signer-email alice@acme.com'
+        ]
       },
       // --- documents sign-all ---
       {
@@ -8220,7 +8463,7 @@ var init_documents = __esm({
             signatures: Array.isArray(document.signatures) ? document.signatures.length : document.signatures
           })));
         },
-        examples: ["corp documents sign-all"]
+        examples: ["corp documents sign-all", "corp documents sign-all --json"]
       },
       // --- documents generate ---
       {
@@ -8229,7 +8472,7 @@ var init_documents = __esm({
         route: { method: "POST", path: "/v1/contracts/generate" },
         entity: true,
         options: [
-          { flags: "--template <type>", description: "Template type (consulting_agreement, employment_offer, contractor_agreement, nda, custom)", required: true },
+          { flags: "--template <type>", description: "Contract template type", required: true, choices: ["consulting_agreement", "employment_offer", "contractor_agreement", "nda", "safe_agreement", "custom"] },
           { flags: "--counterparty <name>", description: "Counterparty name", required: true },
           { flags: "--effective-date <date>", description: "Effective date (ISO 8601, defaults to today)" },
           { flags: "--base-salary <amount>", description: "Employment offer base salary (for employment_offer)" },
@@ -8298,8 +8541,13 @@ var init_documents = __esm({
           }
         },
         produces: { kind: "document" },
-        successTemplate: "Document generated: {title}",
-        examples: ["corp documents generate --template 'type' --counterparty 'name'", "corp documents generate --json"]
+        successTemplate: "Contract generated: {document_id} \u2014 {title}",
+        examples: [
+          'corp documents generate --template consulting_agreement --counterparty "Acme Consulting LLC"',
+          'corp documents generate --template employment_offer --counterparty "Jane Doe" --base-salary 150000',
+          'corp documents generate --template nda --counterparty "Partner Corp" --effective-date 2026-04-01',
+          'corp documents generate --template safe_agreement --counterparty "Seed Investor" --param purchase_amount=500000 --param valuation_cap=10000000'
+        ]
       },
       // --- documents preview-pdf ---
       {
@@ -8322,7 +8570,10 @@ var init_documents = __esm({
           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"]
+        examples: [
+          "corp documents preview-pdf --definition-id bylaws",
+          "corp documents preview-pdf --definition-id articles_of_incorporation"
+        ]
       }
     ];
   }
@@ -8455,7 +8706,10 @@ var init_compliance = __esm({
         },
         produces: { kind: "tax_filing" },
         successTemplate: "Tax filing created",
-        examples: ["corp tax file --type 1120 --year 'year'"]
+        examples: [
+          "corp tax file --type 1120 --year 2025",
+          "corp tax file --type 83b --year 2025 --filer-contact-id @last:contact"
+        ]
       },
       // --- tax deadlines ---
       {
@@ -8519,48 +8773,60 @@ var init_compliance = __esm({
         },
         produces: { kind: "deadline" },
         successTemplate: "Deadline tracked",
-        examples: ["corp tax deadline --type 'type' --due-date 'date' --description 'desc'", "corp tax deadline --json"]
+        examples: [
+          'corp tax deadline --type annual_report --due-date 2026-03-31 --description "Delaware annual report due"',
+          'corp tax deadline --type annual_report --due-date 2026-03-31 --description "Delaware annual report" --recurrence annual'
+        ]
       },
       // ── 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"],
+        examples: [
+          "corp compliance escalations-scan",
+          "corp compliance escalations-scan --json"
+        ],
         successTemplate: "Escalation scan complete"
       },
       {
         name: "compliance escalations-resolve-with-evidence",
-        description: "Resolve a compliance escalation with evidence",
+        description: "Resolve a compliance escalation by submitting supporting 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" }
+          { flags: "--evidence-type <evidence-type>", description: "Type of evidence provided", choices: ["filing", "payment", "document", "correspondence", "other"] },
+          { flags: "--filing-reference <filing-reference>", description: "Reference number or identifier of the associated filing" },
+          { flags: "--notes <notes>", description: "Additional notes about the resolution" },
+          { flags: "--packet-id <packet-id>", description: "Document packet ID containing evidence" },
+          { flags: "--resolve-incident", description: "Also mark the associated incident as resolved" },
+          { flags: "--resolve-obligation", description: "Also mark the associated obligation as resolved" }
+        ],
+        examples: [
+          "corp compliance escalations-resolve-with-evidence esc_01hx9k3n2p4q7r8s9t0uvwxyz --evidence-type filing --filing-reference DE-2026-0042",
+          'corp compliance escalations-resolve-with-evidence esc_01hx9k3n2p4q7r8s9t0uvwxyz --resolve-incident --notes "Filed on time"'
         ],
-        examples: ["corp compliance escalations-resolve-with-evidence <escalation-id>", "corp compliance escalations-resolve-with-evidence --json"],
-        successTemplate: "Escalations Resolve With Evidence created"
+        successTemplate: "Escalation resolved with evidence"
       },
       {
         name: "contractors classify",
-        description: "Classify a worker as employee or contractor",
+        description: "Classify a worker as an employee or independent 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" }
+          { flags: "--contractor-name <contractor-name>", description: "Full name or company name of the worker", required: true },
+          { flags: "--duration-months <duration-months>", description: "Expected or actual engagement duration in months" },
+          { flags: "--exclusive-client <exclusive-client>", description: "Whether the worker works exclusively for this entity (true/false)" },
+          { flags: "--factors <factors>", description: "Additional classification factors (JSON)" },
+          { flags: "--hours-per-week <hours-per-week>", description: "Average hours worked per week" },
+          { flags: "--provides-tools <provides-tools>", description: "Whether the worker provides their own tools and equipment (true/false)" },
+          { flags: "--state <state>", description: "State whose labor law governs the classification (e.g. CA, DE)" }
+        ],
+        examples: [
+          'corp contractors classify --contractor-name "Jane Doe" --state CA --hours-per-week 20',
+          'corp contractors classify --contractor-name "Acme Services LLC" --duration-months 6 --exclusive-client false --provides-tools true'
         ],
-        examples: ["corp contractors classify --contractor-name 'contractor-name'", "corp contractors classify --json"],
-        successTemplate: "Classify created"
+        successTemplate: "Worker classification complete"
       },
       {
         name: "deadlines",
@@ -8573,8 +8839,11 @@ var init_compliance = __esm({
           { 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"
+        examples: [
+          'corp deadlines --deadline-type annual_report --description "Delaware annual report" --due-date 2026-03-31 --recurrence annual',
+          'corp deadlines --deadline-type tax_filing --description "Q1 estimated taxes" --due-date 2026-04-15 --severity high'
+        ],
+        successTemplate: "Deadline tracked"
       },
       {
         name: "entities compliance-escalations",
@@ -8590,11 +8859,14 @@ var init_compliance = __esm({
         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" }
+          { flags: "--document-type <document-type>", description: "Type of tax document to file", required: true, choices: ["1120", "1120s", "1065", "franchise_tax", "annual_report", "83b", "1099_nec", "k1", "941", "w2"] },
+          { flags: "--tax-year <tax-year>", description: "Tax year the filing covers (e.g. 2025)", required: true, type: "int" }
+        ],
+        examples: [
+          "corp tax create-filing --document-type 1120 --tax-year 2025",
+          "corp tax create-filing --document-type 1065 --tax-year 2025"
         ],
-        examples: ["corp tax create-filing --document-type 'document-type' --tax-year 'tax-year'"],
-        successTemplate: "Filings created"
+        successTemplate: "Tax filing created"
       }
     ];
   }
@@ -8697,7 +8969,10 @@ var init_agents = __esm({
           }
           console.log(chalk9.magenta("\u2500".repeat(40)));
         },
-        examples: ["corp agents show"]
+        examples: [
+          "corp agents show @last:agent",
+          "corp agents show agt_01hx9k3n2p4q7r8s9t0uvwxyz"
+        ]
       },
       // --- agents create ---
       {
@@ -8738,7 +9013,10 @@ var init_agents = __esm({
         },
         produces: { kind: "agent" },
         successTemplate: "Agent created: {name}",
-        examples: ["corp agents create --name 'name' --prompt 'prompt'", "corp agents create --json"]
+        examples: [
+          'corp agents create --name "bookkeeper" --prompt "You manage accounts payable for the company"',
+          'corp agents create --name "compliance-monitor" --prompt "You monitor regulatory deadlines" --model gpt-4o'
+        ]
       },
       // --- agents pause <agent-ref> ---
       {
@@ -8752,7 +9030,10 @@ var init_agents = __esm({
           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>"]
+        examples: [
+          "corp agents pause @last:agent",
+          "corp agents pause agt_01hx9k3n2p4q7r8s9t0uvwxyz"
+        ]
       },
       // --- agents resume <agent-ref> ---
       {
@@ -8779,7 +9060,10 @@ var init_agents = __esm({
             }
           }
         },
-        examples: ["corp agents resume <agent-ref>"]
+        examples: [
+          "corp agents resume @last:agent",
+          "corp agents resume agt_01hx9k3n2p4q7r8s9t0uvwxyz"
+        ]
       },
       // --- agents delete <agent-ref> ---
       {
@@ -8806,7 +9090,10 @@ 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"]
+        examples: [
+          "corp agents delete @last:agent",
+          "corp agents delete agt_01hx9k3n2p4q7r8s9t0uvwxyz --yes"
+        ]
       },
       // --- agents message <agent-ref> ---
       {
@@ -8837,7 +9124,10 @@ var init_agents = __esm({
             }
           }
         },
-        examples: ["corp agents message <agent-ref>", "corp agents message --json"]
+        examples: [
+          `corp agents message @last:agent --body "Process this month's invoices"`,
+          "corp agents message agt_01hx9k3n2p4q7r8s9t0uvwxyz --body-file ./task.txt"
+        ]
       },
       // --- agents skill <agent-ref> ---
       {
@@ -8866,7 +9156,10 @@ var init_agents = __esm({
           });
           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"]
+        examples: [
+          'corp agents skill @last:agent --name invoice-processing --description "Process AP invoices from email"',
+          'corp agents skill agt_01hx9k3n2p4q7r8s9t0uvwxyz --name bookkeeping --description "Reconcile ledger entries" --instructions-file ./skills/bookkeeping.txt'
+        ]
       },
       // --- agents execution <agent-ref> <execution-id> ---
       {
@@ -8897,7 +9190,10 @@ var init_agents = __esm({
           if (result.completed_at) console.log(`  ${chalk9.bold("Completed:")} ${result.completed_at}`);
           console.log(chalk9.magenta("\u2500".repeat(40)));
         },
-        examples: ["corp agents execution"]
+        examples: [
+          "corp agents execution @last:agent exc_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp agents execution agt_01hx9k3n2p4q7r8s9t0uvwxyz exc_01hx9k3n2p4q7r8s9t0uvwxyz"
+        ]
       },
       // --- agents execution-result <agent-ref> <execution-id> ---
       {
@@ -8921,7 +9217,10 @@ var init_agents = __esm({
           ctx.writer.success(`Result for execution ${executionId}:`);
           printJson(result);
         },
-        examples: ["corp agents execution-result"]
+        examples: [
+          "corp agents execution-result @last:agent exc_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp agents execution-result @last:agent exc_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       // --- agents kill <agent-ref> <execution-id> ---
       {
@@ -8949,7 +9248,10 @@ 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"]
+        examples: [
+          "corp agents kill @last:agent exc_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp agents kill @last:agent exc_01hx9k3n2p4q7r8s9t0uvwxyz --yes"
+        ]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
@@ -8958,7 +9260,10 @@ var init_agents = __esm({
         route: { method: "GET", path: "/v1/agents/{pos}/executions/{pos2}/logs" },
         args: [{ name: "agent-id", required: true, description: "Agent ID", posKind: "agent" }, { 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"]
+        examples: [
+          "corp agents executions-logs @last:agent exc_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp agents executions-logs agt_01hx9k3n2p4q7r8s9t0uvwxyz exc_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
@@ -8967,7 +9272,10 @@ var init_agents = __esm({
         route: { method: "GET", path: "/v1/agents/{pos}/messages/{pos2}" },
         args: [{ name: "agent-id", required: true, description: "Agent ID", posKind: "agent" }, { name: "message-id", required: true, description: "Message Id" }],
         display: { title: "Agent Message" },
-        examples: ["corp agents messages"]
+        examples: [
+          "corp agents messages @last:agent msg_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp agents messages @last:agent msg_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       }
     ];
   }
@@ -9074,7 +9382,10 @@ var init_work_items = __esm({
           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"]
+        examples: [
+          "corp work-items show wi_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp work-items show @last:work_item --json"
+        ]
       },
       // --- work-items create ---
       {
@@ -9112,7 +9423,10 @@ var init_work_items = __esm({
         },
         produces: { kind: "work_item" },
         successTemplate: "Work item created: {title}",
-        examples: ["corp work-items create --title 'title'", "corp work-items create --json"]
+        examples: [
+          'corp work-items create --title "File Q1 taxes" --category compliance --deadline 2026-04-15',
+          'corp work-items create --title "Renew Delaware registered agent" --category legal --asap'
+        ]
       },
       // --- work-items claim <item-ref> ---
       {
@@ -9141,7 +9455,10 @@ var init_work_items = __esm({
           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"]
+        examples: [
+          "corp work-items claim wi_01hx9k3n2p4q7r8s9t0uvwxyz --by bookkeeper-agent",
+          "corp work-items claim @last:work_item --by ops-agent --ttl 3600"
+        ]
       },
       // --- work-items complete <item-ref> ---
       {
@@ -9172,7 +9489,10 @@ var init_work_items = __esm({
           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"]
+        examples: [
+          'corp work-items complete wi_01hx9k3n2p4q7r8s9t0uvwxyz --by bookkeeper-agent --result "Filed 1120 for Q1 2025"',
+          'corp work-items complete @last:work_item --by ops-agent --result "Completed and verified"'
+        ]
       },
       // --- work-items release <item-ref> ---
       {
@@ -9188,7 +9508,10 @@ var init_work_items = __esm({
           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>"]
+        examples: [
+          "corp work-items release wi_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp work-items release @last:work_item"
+        ]
       },
       // --- work-items cancel <item-ref> ---
       {
@@ -9217,7 +9540,10 @@ 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"]
+        examples: [
+          "corp work-items cancel wi_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp work-items cancel @last:work_item --yes"
+        ]
       }
     ];
   }
@@ -9295,7 +9621,7 @@ var init_services = __esm({
           printReferenceSummary("service_request", result);
           printJson(result);
         },
-        examples: ["corp services show", "corp services show --json"]
+        examples: ["corp services show req_abc123", "corp services show @last --json"]
       },
       // --- services buy <slug> ---
       {
@@ -9341,7 +9667,7 @@ var init_services = __esm({
         },
         produces: { kind: "service_request" },
         successTemplate: "Service request created",
-        examples: ["corp services buy <slug>"]
+        examples: ["corp services buy registered-agent", "corp services buy annual-report --entity-id ent_abc123"]
       },
       // --- services fulfill <ref> ---
       {
@@ -9371,7 +9697,7 @@ var init_services = __esm({
           printReferenceSummary("service_request", result, { showReuseHint: true });
           printJson(result);
         },
-        examples: ["corp services fulfill <ref>", "corp services fulfill --json"]
+        examples: ["corp services fulfill req_abc123", "corp services fulfill req_abc123 --note 'Filed with state' --json"]
       },
       // --- services cancel <ref> ---
       {
@@ -9397,55 +9723,58 @@ var init_services = __esm({
           printReferenceSummary("service_request", result, { showReuseHint: true });
           printJson(result);
         },
-        examples: ["corp services cancel <ref>"]
+        examples: ["corp services cancel req_abc123", "corp services cancel @last --json"]
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
         name: "services create-request",
-        description: "Submit a new service request",
+        description: "Submit a new service request by slug",
         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 }
+          { flags: "--obligation-id <obligation-id>", description: "Obligation ID to attach this request to" },
+          { flags: "--service-slug <service-slug>", description: "Service catalog slug", required: true }
         ],
-        examples: ["corp services requests --service-slug 'service-slug'", "corp services requests --json"],
-        successTemplate: "Requests created"
+        examples: [
+          "corp services create-request --service-slug registered-agent",
+          "corp services create-request --service-slug annual-report --obligation-id obl_abc123 --json"
+        ],
+        successTemplate: "Service request created"
       },
       {
         name: "services requests",
         description: "View a service request by ID",
         route: { method: "GET", path: "/v1/services/requests/{pos}" },
         entity: true,
-        args: [{ name: "request-id", required: true, description: "Document request ID", posKind: "service_request" }],
-        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"]
+        args: [{ name: "request-id", required: true, description: "Service request ID", posKind: "service_request" }],
+        display: { title: "Service Request", cols: ["amount_cents>Amount", "checkout_url>Checkout URL", "failed_at>Failed At", "fulfilled_at>Fulfilled At", "@created_at>Created", "#entity_id>Entity ID"] },
+        examples: ["corp services requests req_abc123", "corp services requests req_abc123 --json"]
       },
       {
         name: "services requests-cancel",
-        description: "Cancel a service request",
+        description: "Cancel a pending service request",
         route: { method: "POST", path: "/v1/services/requests/{pos}/cancel" },
-        args: [{ name: "request-id", required: true, description: "Document request ID", posKind: "service_request" }],
-        examples: ["corp services requests-cancel <request-id>"],
-        successTemplate: "Request cancelled"
+        args: [{ name: "request-id", required: true, description: "Service request ID", posKind: "service_request" }],
+        examples: ["corp services requests-cancel req_abc123"],
+        successTemplate: "Service request cancelled"
       },
       {
         name: "services requests-checkout",
-        description: "Start checkout for a service request",
+        description: "Start Stripe checkout for a service request",
         route: { method: "POST", path: "/v1/services/requests/{pos}/checkout" },
-        args: [{ name: "request-id", required: true, description: "Document request ID", posKind: "service_request" }],
-        examples: ["corp services requests-checkout <request-id>"],
-        successTemplate: "Checkout started"
+        args: [{ name: "request-id", required: true, description: "Service request ID", posKind: "service_request" }],
+        examples: ["corp services requests-checkout req_abc123", "corp services requests-checkout req_abc123 --json"],
+        successTemplate: "Checkout session created"
       },
       {
         name: "services requests-fulfill",
-        description: "Fulfill a service request",
+        description: "Mark a service request as fulfilled (operator only)",
         route: { method: "POST", path: "/v1/services/requests/{pos}/fulfill" },
-        args: [{ name: "request-id", required: true, description: "Document request ID", posKind: "service_request" }],
+        args: [{ name: "request-id", required: true, description: "Service request ID", posKind: "service_request" }],
         options: [
-          { flags: "--note <note>", description: "Note" }
+          { flags: "--note <note>", description: "Fulfillment note visible to the customer" }
         ],
-        examples: ["corp services requests-fulfill <request-id>", "corp services requests-fulfill --json"],
-        successTemplate: "Requests Fulfill created"
+        examples: ["corp services requests-fulfill req_abc123", "corp services requests-fulfill req_abc123 --note 'Filed with Delaware' --json"],
+        successTemplate: "Service request fulfilled"
       }
     ];
   }
@@ -10875,7 +11204,7 @@ var init_admin = __esm({
             { force: ctx.opts.force }
           );
         },
-        examples: ["corp config set"]
+        examples: ["corp config set api_url https://api.thecorporation.com", "corp config set workspace_id ws_abc123"]
       },
       {
         name: "config get",
@@ -10888,7 +11217,7 @@ var init_admin = __esm({
           const { configGetCommand: configGetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
           configGetCommand2(ctx.positional[0]);
         },
-        examples: ["corp config get"]
+        examples: ["corp config get api_url", "corp config get workspace_id"]
       },
       {
         name: "config list",
@@ -10958,7 +11287,7 @@ var init_admin = __esm({
         local: true,
         options: [
           { flags: "--name <name>", description: "Corporation name", required: true },
-          { flags: "--scenario <scenario>", description: "Scenario to create (startup, llc, restaurant)", default: "startup" },
+          { flags: "--scenario <scenario>", description: "Demo scenario to create", default: "startup", choices: ["startup", "llc", "restaurant"] },
           { flags: "--minimal", description: "Use the minimal server-side demo seed instead of the full CLI workflow" },
           { flags: "--json", description: "Output as JSON" }
         ],
@@ -10971,7 +11300,7 @@ var init_admin = __esm({
             json: ctx.opts.json
           });
         },
-        examples: ["corp demo"]
+        examples: ["corp demo --name 'Acme Corp'", "corp demo --name 'Taco LLC' --scenario restaurant"]
       },
       // ── chat (local, interactive) ───────────────────────────────────────
       {
@@ -11018,7 +11347,7 @@ var init_admin = __esm({
         },
         produces: { kind: "api_key" },
         successTemplate: "API key created",
-        examples: ["corp api-keys create --name 'name'", "corp api-keys create --json"]
+        examples: ["corp api-keys create --name 'CI Deploy Key'", "corp api-keys create --name 'Webhook Key' --scopes read:entities --json"]
       },
       {
         name: "api-keys revoke",
@@ -11038,7 +11367,7 @@ var init_admin = __esm({
             json: ctx.opts.json
           });
         },
-        examples: ["corp api-keys revoke <key-id>", "corp api-keys revoke --json"]
+        examples: ["corp api-keys revoke key_abc123", "corp api-keys revoke key_abc123 --yes"]
       },
       {
         name: "api-keys rotate",
@@ -11058,7 +11387,7 @@ var init_admin = __esm({
         },
         produces: { kind: "api_key" },
         successTemplate: "API key rotated",
-        examples: ["corp api-keys rotate <key-id>", "corp api-keys rotate --json"]
+        examples: ["corp api-keys rotate key_abc123", "corp api-keys rotate key_abc123 --json"]
       },
       // ── link (API, write) ───────────────────────────────────────────────
       {
@@ -11076,7 +11405,7 @@ var init_admin = __esm({
             provider: ctx.opts.provider
           });
         },
-        examples: ["corp link --external-id 'id' --provider 'provider'"]
+        examples: ["corp link --external-id cus_abc123 --provider stripe", "corp link --external-id org_xyz --provider github"]
       },
       // ── claim (API, write) ──────────────────────────────────────────────
       {
@@ -11091,7 +11420,7 @@ var init_admin = __esm({
           await claimCommand2(ctx.positional[0]);
         },
         produces: { kind: "entity", trackEntity: true },
-        examples: ["corp claim <code>"]
+        examples: ["corp claim CLAIM-ABC123", "corp claim ws_invite_xyz789"]
       },
       // ── feedback (API, write) ───────────────────────────────────────────
       {
@@ -11102,7 +11431,7 @@ var init_admin = __esm({
           { name: "message", required: true, description: "Feedback message" }
         ],
         options: [
-          { flags: "--category <category>", description: "Category (e.g. bug, feature, general)", default: "general" },
+          { flags: "--category <category>", description: "Feedback category", default: "general", choices: ["bug", "feature", "general"] },
           { flags: "--email <email>", description: "Your email address (to receive a copy)" }
         ],
         handler: async (ctx) => {
@@ -11113,7 +11442,10 @@ var init_admin = __esm({
             json: ctx.opts.json
           });
         },
-        examples: ["corp feedback <message>", "corp feedback --json"]
+        examples: [
+          "corp feedback 'The cap table export is missing share classes'",
+          "corp feedback 'PDF generation fails on long names' --category bug --email me@example.com"
+        ]
       },
       // ── resolve (API, read) ─────────────────────────────────────────────
       {
@@ -11136,7 +11468,7 @@ var init_admin = __esm({
             meetingId: ctx.opts.meetingId
           });
         },
-        examples: ["corp resolve"]
+        examples: ["corp resolve entity acme", "corp resolve contact alice --entity-id ent_abc123"]
       },
       // ── find (API, read) ────────────────────────────────────────────────
       {
@@ -11161,7 +11493,7 @@ var init_admin = __esm({
             json: ctx.opts.json
           });
         },
-        examples: ["corp find"]
+        examples: ["corp find entity acme", "corp find contact alice --entity-id ent_abc123 --json"]
       },
       // ── approvals (informational) ───────────────────────────────────────
       {
@@ -11224,26 +11556,26 @@ var init_admin = __esm({
         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" }
+          { flags: "--name <name>", description: "Corporation display name" },
+          { flags: "--scenario <scenario>", description: "Demo scenario to seed", choices: ["startup", "llc", "restaurant"] }
         ],
-        examples: ["corp demo seed", "corp demo seed --json"],
-        successTemplate: "Seed created"
+        examples: ["corp demo seed --name 'Acme Corp'", "corp demo seed --name 'Taco LLC' --scenario restaurant --json"],
+        successTemplate: "Demo workspace seeded"
       },
       {
         name: "digests trigger",
-        description: "Trigger digest generation now",
+        description: "Trigger digest generation immediately",
         route: { method: "POST", path: "/v1/digests/trigger" },
         examples: ["corp digests trigger"],
-        successTemplate: "Trigger created"
+        successTemplate: "Digest triggered"
       },
       {
         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" }],
+        args: [{ name: "digest-key", required: true, description: "Digest key (e.g. daily_2026-03-22)" }],
         display: { title: "Digest" },
-        examples: ["corp digests"]
+        examples: ["corp digests daily_2026-03-22", "corp digests weekly_2026-03-22 --json"]
       },
       {
         name: "service-token",
@@ -11273,14 +11605,14 @@ var init_admin = __esm({
         options: [
           { flags: "--claim-token <claim-token>", description: "Workspace claim token", required: true }
         ],
-        examples: ["corp workspaces claim --claim-token 'claim-token'"],
-        successTemplate: "Claim created"
+        examples: ["corp workspaces claim --claim-token tok_abc123xyz"],
+        successTemplate: "Workspace claimed"
       },
       {
         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"] },
+        display: { title: "Workspaces Contacts", cols: ["#contact_id>Contact ID", "#entity_id>Entity ID"] },
         examples: ["corp workspaces contacts"]
       },
       {
@@ -11299,7 +11631,7 @@ var init_admin = __esm({
           { 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"],
+        examples: ["corp auth token-exchange --api-key sk_live_abc123", "corp auth token-exchange --api-key sk_live_abc123 --ttl-seconds 3600 --json"],
         successTemplate: "Token exchanged"
       },
       {
@@ -11328,7 +11660,7 @@ var init_admin = __esm({
         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>"],
+        examples: ["corp ssh-keys revoke key_abc123"],
         successTemplate: "SSH key revoked"
       },
       {
@@ -11339,8 +11671,8 @@ var init_admin = __esm({
           { 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"
+        examples: ["corp workspaces provision --name 'Acme Corp'", "corp workspaces provision --name 'Taco LLC' --owner-email founder@taco.com --json"],
+        successTemplate: "Workspace provisioned"
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
       {
@@ -11351,7 +11683,10 @@ var init_admin = __esm({
           { 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'"],
+        examples: [
+          `corp references sync --kind entity --items '[{"id":"ent_abc123","name":"Acme"}]'`,
+          `corp references sync --kind contact --items '[{"id":"con_xyz","name":"Alice"}]' --json`
+        ],
         successTemplate: "References synced"
       },
       // ── Auto-generated from OpenAPI ──────────────────────────────
@@ -11363,26 +11698,29 @@ var init_admin = __esm({
           { 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"
+        examples: [
+          "corp secrets interpolate --execution-id exec_abc123 --template 'Bearer {{MY_API_KEY}}'",
+          "corp secrets interpolate --execution-id exec_abc123 --template '{{DB_HOST}}:5432' --json"
+        ],
+        successTemplate: "Template interpolated"
       },
       {
         name: "secrets resolve",
-        description: "Resolve a secrets token to its values",
+        description: "Resolve a secrets access token to its plaintext 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"
+        examples: ["corp secrets resolve --token stok_abc123xyz", "corp secrets resolve --token stok_abc123xyz --json"],
+        successTemplate: "Secrets resolved"
       },
       {
         name: "documents validate-preview",
-        description: "Validate a document preview without generating PDF",
+        description: "Validate the document preview AST without generating a 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"]
+        examples: ["corp documents validate-preview --entity-id ent_abc123", "corp documents validate-preview --entity-id ent_abc123 --json"]
       }
     ];
   }
@@ -11400,8 +11738,8 @@ var init_execution = __esm({
         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"
+        examples: ["corp document-requests fulfill req_01hx9k3n2p4q7r8s9t0uvwxyz"],
+        successTemplate: "Document request fulfilled"
       },
       {
         name: "document-requests not-applicable",
@@ -11409,8 +11747,8 @@ var init_execution = __esm({
         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"
+        examples: ["corp document-requests not-applicable req_01hx9k3n2p4q7r8s9t0uvwxyz"],
+        successTemplate: "Document request marked not applicable"
       },
       {
         name: "entities approval-artifacts",
@@ -11475,8 +11813,11 @@ var init_execution = __esm({
           { 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"
+        examples: [
+          'corp execution approval-artifacts --approver-identity "alice@acme.com" --channel board_vote --intent-type equity_grant --scope entity',
+          'corp execution approval-artifacts --approver-identity "alice@acme.com" --channel written_consent --intent-type equity_grant --scope entity --approved-at 2026-03-01T00:00:00Z'
+        ],
+        successTemplate: "Approval artifact recorded"
       },
       {
         name: "execution intents",
@@ -11489,8 +11830,11 @@ var init_execution = __esm({
           { 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"
+        examples: [
+          'corp execution intents --description "Issue 10,000 options to Alice" --intent-type equity_grant --authority-tier tier_2',
+          'corp execution intents --description "Wire $50,000 to vendor" --intent-type payment --authority-tier tier_1'
+        ],
+        successTemplate: "Execution intent created"
       },
       {
         name: "execution obligations",
@@ -11505,8 +11849,11 @@ var init_execution = __esm({
           { 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"
+        examples: [
+          'corp execution obligations --assignee-type human --description "Sign equity grant agreement" --obligation-type signature',
+          'corp execution obligations --assignee-type internal --description "File 83(b) election" --obligation-type document --due-date 2026-04-15'
+        ],
+        successTemplate: "Obligation created"
       },
       {
         name: "execution packets",
@@ -11515,7 +11862,10 @@ var init_execution = __esm({
         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"]
+        examples: [
+          "corp execution packets pkt_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp execution packets pkt_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       {
         name: "intents authorize",
@@ -11523,7 +11873,10 @@ var init_execution = __esm({
         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>"],
+        examples: [
+          "corp intents authorize int_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp intents authorize @last:intent"
+        ],
         successTemplate: "Intent authorized"
       },
       {
@@ -11534,8 +11887,10 @@ var init_execution = __esm({
         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"
+        examples: [
+          "corp intents bind-approval-artifact @last:intent --approval-artifact-id art_01hx9k3n2p4q7r8s9t0uvwxyz"
+        ],
+        successTemplate: "Approval artifact bound to intent"
       },
       {
         name: "intents bind-document-request",
@@ -11545,8 +11900,10 @@ var init_execution = __esm({
         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"
+        examples: [
+          "corp intents bind-document-request @last:intent --request-id req_01hx9k3n2p4q7r8s9t0uvwxyz"
+        ],
+        successTemplate: "Document request bound to intent"
       },
       {
         name: "intents cancel",
@@ -11554,7 +11911,10 @@ var init_execution = __esm({
         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>"],
+        examples: [
+          "corp intents cancel int_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp intents cancel @last:intent"
+        ],
         successTemplate: "Intent cancelled"
       },
       {
@@ -11563,7 +11923,10 @@ var init_execution = __esm({
         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>"],
+        examples: [
+          "corp intents evaluate int_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp intents evaluate @last:intent"
+        ],
         successTemplate: "Intent evaluated"
       },
       {
@@ -11572,7 +11935,10 @@ var init_execution = __esm({
         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>"],
+        examples: [
+          "corp intents execute int_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp intents execute @last:intent"
+        ],
         successTemplate: "Intent executed"
       },
       {
@@ -11582,7 +11948,10 @@ var init_execution = __esm({
         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"]
+        examples: [
+          "corp intents receipts int_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp intents receipts @last:intent --json"
+        ]
       },
       {
         name: "obligations assign",
@@ -11593,8 +11962,10 @@ var init_execution = __esm({
         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"
+        examples: [
+          "corp obligations assign obl_01hx9k3n2p4q7r8s9t0uvwxyz --assignee-id usr_01hx9k3n2p4q7r8s9t0uvwxyz"
+        ],
+        successTemplate: "Obligation assigned"
       },
       {
         name: "obligations document-requests",
@@ -11603,7 +11974,10 @@ var init_execution = __esm({
         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"]
+        examples: [
+          "corp obligations document-requests obl_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp obligations document-requests obl_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       {
         name: "obligations create-document-request",
@@ -11615,8 +11989,10 @@ var init_execution = __esm({
           { 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"
+        examples: [
+          'corp obligations create-document-request obl_01hx9k3n2p4q7r8s9t0uvwxyz --description "Signed equity grant agreement" --document-type equity_grant'
+        ],
+        successTemplate: "Document request created"
       },
       {
         name: "obligations expire",
@@ -11624,7 +12000,10 @@ var init_execution = __esm({
         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>"],
+        examples: [
+          "corp obligations expire obl_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp obligations expire @last:obligation"
+        ],
         successTemplate: "Obligation expired"
       },
       {
@@ -11633,7 +12012,10 @@ var init_execution = __esm({
         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>"],
+        examples: [
+          "corp obligations fulfill obl_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp obligations fulfill @last:obligation"
+        ],
         successTemplate: "Obligation fulfilled"
       },
       {
@@ -11642,7 +12024,10 @@ var init_execution = __esm({
         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>"],
+        examples: [
+          "corp obligations waive obl_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp obligations waive @last:obligation"
+        ],
         successTemplate: "Obligation waived"
       },
       {
@@ -11652,7 +12037,10 @@ var init_execution = __esm({
         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"]
+        examples: [
+          "corp receipts rcp_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp receipts rcp_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       // ── Human obligations ───────────────────────────────────────────────
       {
@@ -11671,7 +12059,10 @@ var init_execution = __esm({
         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>"]
+        examples: [
+          "corp human-obligations fulfill obl_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp human-obligations fulfill @last:obligation"
+        ]
       },
       {
         name: "human-obligations signer-token",
@@ -11679,7 +12070,10 @@ var init_execution = __esm({
         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>"]
+        examples: [
+          "corp human-obligations signer-token obl_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp human-obligations signer-token @last:obligation"
+        ]
       }
     ];
   }
@@ -11711,7 +12105,10 @@ var init_secret_proxies = __esm({
           { 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"]
+        examples: [
+          "corp secret-proxies create --name stripe-keys --url https://secrets.example.com/proxy",
+          "corp secret-proxies create --name local-secrets --url self --description 'Locally encrypted secrets' --json"
+        ]
       },
       {
         name: "secret-proxies show",
@@ -11722,7 +12119,7 @@ var init_secret_proxies = __esm({
           title: "Secret Proxy",
           cols: ["name>Name", "url>URL", "description>Description", "secret_count>Secrets", "@created_at>Created"]
         },
-        examples: ["corp secret-proxies show"]
+        examples: ["corp secret-proxies show my-proxy", "corp secret-proxies show my-proxy --json"]
       },
       {
         name: "secret-proxies secrets",
@@ -11733,7 +12130,7 @@ var init_secret_proxies = __esm({
           title: "Secrets",
           cols: ["names>Secret Names", "proxy_name>Proxy"]
         },
-        examples: ["corp secret-proxies secrets"]
+        examples: ["corp secret-proxies secrets my-proxy", "corp secret-proxies secrets my-proxy --json"]
       },
       {
         name: "secret-proxies set-secrets",
@@ -11744,7 +12141,10 @@ var init_secret_proxies = __esm({
           { 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'"]
+        examples: [
+          `corp secret-proxies set-secrets my-proxy --secrets '{"API_KEY":"sk-live-abc","DB_PASS":"hunter2"}'`,
+          `corp secret-proxies set-secrets my-proxy --secrets '{"STRIPE_KEY":"sk_live_xyz"}' --json`
+        ]
       }
     ];
   }
@@ -11762,20 +12162,23 @@ var init_treasury = __esm({
         route: { method: "POST", path: "/v1/bank-accounts/{pos}/close" },
         entity: true,
         args: [{ name: "bank-account-id", required: true, description: "Bank account ID", posKind: "bank_account" }],
-        examples: ["corp bank-accounts close <bank-account-id>"],
-        successTemplate: "Account closed"
+        examples: ["corp bank-accounts close ba_01hx9k3n2p4q7r8s9t0uvwxyz"],
+        successTemplate: "Bank account closed"
       },
       {
         name: "distributions",
-        description: "Record a distribution (dividend, member draw)",
+        description: "Record a distribution (dividend, member draw, or liquidation)",
         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" }
+          { flags: "--distribution-type <distribution-type>", description: "Type of distribution", choices: ["dividend", "return", "liquidation"] },
+          { flags: "--total-amount-cents <total-amount-cents>", description: "Total amount in cents (e.g. 500000 for $5,000)", required: true, type: "int" }
         ],
-        examples: ["corp distributions --description dividend --total-amount-cents 'total-amount-cents'", "corp distributions --json"],
-        successTemplate: "Distributions created"
+        examples: [
+          'corp distributions --description "Q1 dividend" --distribution-type dividend --total-amount-cents 500000',
+          'corp distributions --description "Founder draw" --distribution-type return --total-amount-cents 1000000'
+        ],
+        successTemplate: "Distribution recorded"
       },
       {
         name: "entities accounts",
@@ -11803,7 +12206,7 @@ var init_treasury = __esm({
       },
       {
         name: "entities stripe-account",
-        description: "View Stripe account for an entity",
+        description: "View Stripe account details 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"] },
@@ -11815,13 +12218,15 @@ var init_treasury = __esm({
         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: "--amount-cents <amount-cents>", description: "Invoice amount in cents (e.g. 500000 for $5,000)", 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 }
+          { flags: "--description <description>", description: "Description of the services or goods invoiced", required: true },
+          { flags: "--due-date <due-date>", description: "Payment 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"
+        examples: [
+          'corp invoices from-agent-request --amount-cents 500000 --customer-name "Acme Corp" --description "Consulting services Q1" --due-date 2026-06-30'
+        ],
+        successTemplate: "Invoice created from agent request"
       },
       {
         name: "invoices",
@@ -11830,7 +12235,10 @@ var init_treasury = __esm({
         entity: true,
         args: [{ name: "invoice-id", required: true, description: "Invoice ID", posKind: "invoice" }],
         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"]
+        examples: [
+          "corp invoices inv_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp invoices inv_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       {
         name: "invoices mark-paid",
@@ -11838,7 +12246,7 @@ var init_treasury = __esm({
         route: { method: "POST", path: "/v1/invoices/{pos}/mark-paid" },
         entity: true,
         args: [{ name: "invoice-id", required: true, description: "Invoice ID", posKind: "invoice" }],
-        examples: ["corp invoices mark-paid <invoice-id>"],
+        examples: ["corp invoices mark-paid inv_01hx9k3n2p4q7r8s9t0uvwxyz"],
         successTemplate: "Invoice marked as paid"
       },
       {
@@ -11848,7 +12256,10 @@ var init_treasury = __esm({
         entity: true,
         args: [{ name: "invoice-id", required: true, description: "Invoice ID", posKind: "invoice" }],
         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"]
+        examples: [
+          "corp invoices pay-instructions inv_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp invoices pay-instructions inv_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       {
         name: "invoices send",
@@ -11856,17 +12267,20 @@ var init_treasury = __esm({
         route: { method: "POST", path: "/v1/invoices/{pos}/send" },
         entity: true,
         args: [{ name: "invoice-id", required: true, description: "Invoice ID", posKind: "invoice" }],
-        examples: ["corp invoices send <invoice-id>"],
+        examples: ["corp invoices send inv_01hx9k3n2p4q7r8s9t0uvwxyz"],
         successTemplate: "Invoice sent"
       },
       {
         name: "invoices status",
-        description: "Check invoice payment status",
+        description: "Check payment status of an invoice",
         route: { method: "GET", path: "/v1/invoices/{pos}/status" },
         entity: true,
         args: [{ name: "invoice-id", required: true, description: "Invoice ID", posKind: "invoice" }],
         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"]
+        examples: [
+          "corp invoices status inv_01hx9k3n2p4q7r8s9t0uvwxyz",
+          "corp invoices status inv_01hx9k3n2p4q7r8s9t0uvwxyz --json"
+        ]
       },
       {
         name: "journal-entries post",
@@ -11874,7 +12288,7 @@ var init_treasury = __esm({
         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>"],
+        examples: ["corp journal-entries post jrn_01hx9k3n2p4q7r8s9t0uvwxyz"],
         successTemplate: "Journal entry posted"
       },
       {
@@ -11883,21 +12297,24 @@ var init_treasury = __esm({
         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>"],
+        examples: ["corp journal-entries void jrn_01hx9k3n2p4q7r8s9t0uvwxyz"],
         successTemplate: "Journal entry voided"
       },
       {
         name: "ledger reconcile",
-        description: "Reconcile the ledger",
+        description: "Run a ledger reconciliation for an entity",
         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" }
+          { flags: "--as-of-date <as-of-date>", description: "Reconcile as of this date (ISO 8601, e.g. 2026-03-31)" },
+          { flags: "--end-date <end-date>", description: "End of reconciliation period (ISO 8601)" },
+          { flags: "--start-date <start-date>", description: "Start of reconciliation period (ISO 8601)" }
         ],
-        examples: ["corp ledger reconcile", "corp ledger reconcile --json"],
-        successTemplate: "Reconcile created"
+        examples: [
+          "corp ledger reconcile --as-of-date 2026-03-31",
+          "corp ledger reconcile --start-date 2026-01-01 --end-date 2026-03-31"
+        ],
+        successTemplate: "Ledger reconciliation complete"
       },
       {
         name: "payments",
@@ -11905,79 +12322,95 @@ var init_treasury = __esm({
         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 }
+          { flags: "--amount-cents <amount-cents>", description: "Payment amount in cents (e.g. 500000 for $5,000)", required: true, type: "int" },
+          { flags: "--description <description>", description: "Description of the payment", required: true },
+          { flags: "--payment-method <payment-method>", description: "How the payment is made or received", choices: ["bank_transfer", "card", "check", "wire", "ach"] },
+          { flags: "--recipient <recipient>", description: "Recipient name or ID", required: true }
+        ],
+        examples: [
+          'corp payments --amount-cents 250000 --description "Software subscription" --payment-method ach --recipient "Acme Vendors LLC"',
+          'corp payments --amount-cents 1000000 --description "Consulting invoice #42" --payment-method wire --recipient "Jane Doe"'
         ],
-        examples: ["corp payments --amount-cents 'amount-cents' --description bank_transfer --recipient 'recipient'", "corp payments --json"],
-        successTemplate: "Payments created"
+        successTemplate: "Payment recorded"
       },
       {
         name: "payments execute",
-        description: "Execute a pending payment",
+        description: "Execute a pending payment immediately",
         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 }
+          { flags: "--amount-cents <amount-cents>", description: "Payment amount in cents (e.g. 500000 for $5,000)", required: true, type: "int" },
+          { flags: "--description <description>", description: "Description of the payment", required: true },
+          { flags: "--payment-method <payment-method>", description: "How the payment is made or received", choices: ["bank_transfer", "card", "check", "wire", "ach"] },
+          { flags: "--recipient <recipient>", description: "Recipient name or ID", required: true }
+        ],
+        examples: [
+          'corp payments execute --amount-cents 250000 --description "Vendor invoice" --payment-method wire --recipient "Acme Vendors LLC"'
         ],
-        examples: ["corp payments execute --amount-cents 'amount-cents' --description bank_transfer --recipient 'recipient'", "corp payments execute --json"],
         successTemplate: "Payment executed"
       },
       {
         name: "payroll runs",
-        description: "Create a payroll run",
+        description: "Create a payroll run for a pay period",
         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 }
+          { flags: "--pay-period-end <pay-period-end>", description: "Last day of the pay period (ISO 8601, e.g. 2026-03-31)", required: true },
+          { flags: "--pay-period-start <pay-period-start>", description: "First day of the pay period (ISO 8601, e.g. 2026-03-01)", required: true }
+        ],
+        examples: [
+          "corp payroll runs --pay-period-start 2026-03-01 --pay-period-end 2026-03-31"
         ],
-        examples: ["corp payroll runs --pay-period-end 'pay-period-end' --pay-period-start 'pay-period-start'"],
         successTemplate: "Payroll run created"
       },
       {
         name: "spending-limits",
-        description: "Set a spending limit",
+        description: "Set a spending limit for a category and period",
         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 }
+          { flags: "--amount-cents <amount-cents>", description: "Limit amount in cents (e.g. 500000 for $5,000)", required: true, type: "int" },
+          { flags: "--category <category>", description: "Spending category (e.g. software, travel, marketing)", required: true },
+          { flags: "--period <period>", description: "Limit period (e.g. monthly, quarterly, annual)", required: true }
         ],
-        examples: ["corp spending-limits --amount-cents 'amount-cents' --category 'category' --period 'period'"],
-        successTemplate: "Spending Limits created"
+        examples: [
+          "corp spending-limits --amount-cents 500000 --category software --period monthly",
+          "corp spending-limits --amount-cents 2000000 --category travel --period quarterly"
+        ],
+        successTemplate: "Spending limit set"
       },
       {
         name: "treasury accounts",
-        description: "Create a new ledger account",
+        description: "Create a new ledger account for an entity",
         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"] }
+          { flags: "--account-code <account-code>", description: "Standard GL account code to create", required: true, choices: ["Cash", "AccountsReceivable", "AccountsPayable", "AccruedExpenses", "FounderCapital", "Revenue", "OperatingExpenses", "Cogs"] }
+        ],
+        examples: [
+          "corp treasury accounts --account-code Cash",
+          "corp treasury accounts --account-code Revenue"
         ],
-        examples: ["corp treasury accounts --account-code Cash"],
-        successTemplate: "Accounts created"
+        successTemplate: "Ledger account created"
       },
       {
         name: "treasury bank-accounts",
-        description: "Register a new bank account",
+        description: "Register a new bank account for an entity",
         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 }
+          { flags: "--account-type <account-type>", description: "Type of bank account", choices: ["checking", "savings"] },
+          { flags: "--bank-name <bank-name>", description: "Name of the bank (e.g. Mercury, Chase)", required: true }
         ],
-        examples: ["corp treasury bank-accounts --bank-name 'bank-name'", "corp treasury bank-accounts --json"],
-        successTemplate: "Bank Accounts created"
+        examples: [
+          "corp treasury bank-accounts --bank-name Mercury --account-type checking",
+          "corp treasury bank-accounts --bank-name Chase --account-type savings"
+        ],
+        successTemplate: "Bank account registered"
       },
       {
         name: "treasury chart-of-accounts",
-        description: "View chart of accounts for an entity",
+        description: "View the 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"] },
@@ -11989,13 +12422,15 @@ var init_treasury = __esm({
         route: { method: "POST", path: "/v1/treasury/invoices" },
         entity: true,
         options: [
-          { flags: "--amount-cents <amount-cents>", description: "Amount in cents", required: true, type: "int" },
+          { flags: "--amount-cents <amount-cents>", description: "Invoice amount in cents (e.g. 500000 for $5,000)", 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 }
+          { flags: "--description <description>", description: "Description of services or goods invoiced", required: true },
+          { flags: "--due-date <due-date>", description: "Payment due date (ISO 8601, e.g. 2026-06-30)", required: true }
+        ],
+        examples: [
+          'corp treasury invoices --amount-cents 500000 --customer-name "Acme Corp" --description "Consulting services Q1" --due-date 2026-06-30'
         ],
-        examples: ["corp treasury invoices --amount-cents 'amount-cents' --customer-name 'customer-name' --description 'description' --due-date 'due-date'"],
-        successTemplate: "Invoices created"
+        successTemplate: "Invoice created"
       },
       {
         name: "treasury journal-entries",
@@ -12003,12 +12438,14 @@ var init_treasury = __esm({
         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" }
+          { flags: "--description <description>", description: "Description of the journal entry", required: true },
+          { flags: "--effective-date <effective-date>", description: "Date the entry takes effect (ISO 8601, e.g. 2026-03-31)", required: true },
+          { flags: "--lines <lines>", description: "JSON array of debit/credit line items", required: true, type: "array" }
+        ],
+        examples: [
+          `corp treasury journal-entries --description "Prepaid software expense" --effective-date 2026-03-31 --lines '[{"account_code":"OperatingExpenses","amount_cents":50000,"type":"debit"},{"account_code":"Cash","amount_cents":50000,"type":"credit"}]'`
         ],
-        examples: ["corp treasury journal-entries --description 'description' --effective-date 'effective-date' --lines 'lines'"],
-        successTemplate: "Journal Entries created"
+        successTemplate: "Journal entry created"
       },
       {
         name: "treasury payment-intents",
@@ -12016,44 +12453,51 @@ var init_treasury = __esm({
         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" }
+          { flags: "--amount-cents <amount-cents>", description: "Payment amount in cents (e.g. 500000 for $5,000)", required: true, type: "int" },
+          { flags: "--currency <currency>", description: "ISO 4217 currency code (e.g. USD)" },
+          { flags: "--description <description>", description: "Description of the payment" }
+        ],
+        examples: [
+          'corp treasury payment-intents --amount-cents 500000 --currency USD --description "Vendor payment"'
         ],
-        examples: ["corp treasury payment-intents --amount-cents 'amount-cents'", "corp treasury payment-intents --json"],
-        successTemplate: "Payment Intents created"
+        successTemplate: "Payment intent created"
       },
       {
         name: "treasury payouts",
-        description: "Create a payout",
+        description: "Create a payout to a destination",
         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 }
+          { flags: "--amount-cents <amount-cents>", description: "Payout amount in cents (e.g. 500000 for $5,000)", required: true, type: "int" },
+          { flags: "--description <description>", description: "Description of the payout" },
+          { flags: "--destination <destination>", description: "Destination account or recipient ID", required: true }
+        ],
+        examples: [
+          'corp treasury payouts --amount-cents 500000 --destination ba_01hx9k3n2p4q7r8s9t0uvwxyz --description "Founder distribution"'
         ],
-        examples: ["corp treasury payouts --amount-cents 'amount-cents' --destination 'destination'", "corp treasury payouts --json"],
-        successTemplate: "Payouts created"
+        successTemplate: "Payout created"
       },
       {
         name: "treasury seed-chart-of-accounts",
-        description: "Initialize chart of accounts for an entity",
+        description: "Initialize the chart of accounts for an entity from a template",
         route: { method: "POST", path: "/v1/treasury/seed-chart-of-accounts" },
         entity: true,
         options: [
-          { flags: "--template <template>", description: "Chart of accounts template name to seed from" }
+          { flags: "--template <template>", description: "Chart of accounts template to seed from (e.g. standard, startup)" }
         ],
-        examples: ["corp treasury seed-chart-of-accounts", "corp treasury seed-chart-of-accounts --json"],
-        successTemplate: "Seed Chart Of Accounts created"
+        examples: [
+          "corp treasury seed-chart-of-accounts",
+          "corp treasury seed-chart-of-accounts --template startup"
+        ],
+        successTemplate: "Chart of accounts initialized"
       },
       {
         name: "treasury stripe-accounts",
-        description: "Register a Stripe account",
+        description: "Register a Stripe account for an entity",
         route: { method: "POST", path: "/v1/treasury/stripe-accounts" },
         entity: true,
         examples: ["corp treasury stripe-accounts"],
-        successTemplate: "Stripe Accounts created"
+        successTemplate: "Stripe account registered"
       }
     ];
   }
@@ -12086,7 +12530,7 @@ var init_branches = __esm({
           { 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"]
+        examples: ["corp branches create --name feature/my-change", "corp branches create --name hotfix/fix-ein --from main --json"]
       },
       {
         name: "branches merge",
@@ -12099,7 +12543,7 @@ var init_branches = __esm({
           { flags: "--squash", description: "Squash merge (default: true)" }
         ],
         successTemplate: "Merge {strategy}: {commit}",
-        examples: ["corp branches merge <branch>", "corp branches merge --json"]
+        examples: ["corp branches merge feature/my-change", "corp branches merge feature/my-change --into main --squash --json"]
       },
       {
         name: "branches delete",
@@ -12108,7 +12552,7 @@ var init_branches = __esm({
         entity: "query",
         args: [{ name: "branch", required: true, description: "Branch to delete" }],
         successTemplate: "Branch deleted",
-        examples: ["corp branches delete <branch>"]
+        examples: ["corp branches delete feature/my-change"]
       },
       {
         name: "branches prune",
@@ -12117,12 +12561,281 @@ var init_branches = __esm({
         entity: "query",
         args: [{ name: "branch", required: true, description: "Branch to prune" }],
         successTemplate: "Branch pruned",
-        examples: ["corp branches prune <branch>"]
+        examples: ["corp branches prune feature/my-change"]
       }
     ];
   }
 });
 
+// src/registry/completions.ts
+function buildTree(commands) {
+  const topLevelMap = /* @__PURE__ */ new Map();
+  const topLevel = [];
+  for (const cmd of commands) {
+    if (cmd.hidden) continue;
+    const parts = cmd.name.split(" ");
+    const opts = ["--json"];
+    if (cmd.entity) opts.push("--entity-id");
+    if (cmd.dryRun) opts.push("--dry-run");
+    for (const o of cmd.options ?? []) {
+      if (o.hidden) continue;
+      const longFlag = o.flags.split(/\s+/).find((f) => f.startsWith("--"));
+      if (longFlag) {
+        opts.push(longFlag.replace(/<[^>]*>|\[[^\]]*\]/, "").trim());
+      }
+    }
+    const node = {
+      name: parts[parts.length - 1],
+      description: cmd.description,
+      options: opts,
+      subcmds: []
+    };
+    if (parts.length === 1) {
+      topLevelMap.set(parts[0], node);
+      topLevel.push(node);
+    } else {
+      const parentName = parts[0];
+      let parent = topLevelMap.get(parentName);
+      if (!parent) {
+        parent = { name: parentName, description: "", options: [], subcmds: [] };
+        topLevelMap.set(parentName, parent);
+        topLevel.push(parent);
+      }
+      parent.subcmds.push(node);
+    }
+  }
+  return topLevel;
+}
+function generateBash(commands) {
+  const tree = buildTree(commands);
+  const lines = [
+    "# corp bash completion",
+    "# Source this file or add to ~/.bash_completion.d/",
+    "#   source <(corp completions --shell bash)",
+    "",
+    "_corp_completions() {",
+    "  local cur prev words cword",
+    "  _init_completion 2>/dev/null || {",
+    "    COMPREPLY=()",
+    '    cur="${COMP_WORDS[COMP_CWORD]}"',
+    '    prev="${COMP_WORDS[COMP_CWORD-1]}"',
+    '    words=("${COMP_WORDS[@]}")',
+    "    cword=$COMP_CWORD",
+    "  }",
+    "",
+    '  local subcommand=""',
+    '  local subsubcommand=""',
+    '  if [[ ${#words[@]} -ge 2 ]]; then subcommand="${words[1]}"; fi',
+    '  if [[ ${#words[@]} -ge 3 ]]; then subsubcommand="${words[2]}"; fi',
+    ""
+  ];
+  const topNames = tree.map((n) => n.name).join(" ");
+  lines.push(`  local top_commands="${topNames}"`);
+  lines.push("");
+  lines.push('  case "$subcommand" in');
+  for (const parent of tree) {
+    if (parent.subcmds.length > 0) {
+      const subNames = parent.subcmds.map((s3) => s3.name).join(" ");
+      lines.push(`    ${parent.name})`);
+      lines.push(`      local ${parent.name}_subcmds="${subNames}"`);
+      lines.push(`      case "$subsubcommand" in`);
+      for (const child of parent.subcmds) {
+        const childFlags = child.options.join(" ");
+        lines.push(`        ${child.name})`);
+        lines.push(`          COMPREPLY=( $(compgen -W "${childFlags}" -- "$cur") )`);
+        lines.push("          return 0 ;;");
+      }
+      const parentFlags = parent.options.join(" ");
+      lines.push("        *)");
+      if (parent.options.length > 0) {
+        lines.push(`          COMPREPLY=( $(compgen -W "${parent.subcmds.map((s3) => s3.name).join(" ")} ${parentFlags}" -- "$cur") )`);
+      } else {
+        lines.push(`          COMPREPLY=( $(compgen -W "$${parent.name}_subcmds" -- "$cur") )`);
+      }
+      lines.push("          return 0 ;;");
+      lines.push("      esac ;;");
+    } else {
+      const flags = parent.options.join(" ");
+      lines.push(`    ${parent.name})`);
+      lines.push(`      COMPREPLY=( $(compgen -W "${flags}" -- "$cur") )`);
+      lines.push("      return 0 ;;");
+    }
+  }
+  lines.push("    *)");
+  lines.push('      COMPREPLY=( $(compgen -W "$top_commands" -- "$cur") )');
+  lines.push("      return 0 ;;");
+  lines.push("  esac");
+  lines.push("}");
+  lines.push("");
+  lines.push("complete -F _corp_completions corp");
+  lines.push("complete -F _corp_completions npx corp");
+  return lines.join("\n");
+}
+function escapeZshDesc(s3) {
+  return s3.replace(/'/g, "'\\''").replace(/:/g, "\\:");
+}
+function generateZsh(commands) {
+  const tree = buildTree(commands);
+  const lines = [
+    "#compdef corp",
+    "# corp zsh completion",
+    "# Add to your fpath and run: compdef _corp corp",
+    '#   eval "$(corp completions --shell zsh)"',
+    "",
+    "_corp() {",
+    "  local state",
+    "  local -a top_commands",
+    ""
+  ];
+  lines.push("  top_commands=(");
+  for (const node of tree) {
+    lines.push(`    '${node.name}:${escapeZshDesc(node.description)}'`);
+  }
+  lines.push("  )");
+  lines.push("");
+  lines.push("  _arguments -C \\");
+  lines.push("    '(-h --help)'{-h,--help}'[Show help]' \\");
+  lines.push("    '(-V --version)'{-V,--version}'[Show version]' \\");
+  lines.push("    '(-q --quiet)'{-q,--quiet}'[Quiet output]' \\");
+  lines.push("    '1: :->cmd' \\");
+  lines.push("    '*: :->args'");
+  lines.push("");
+  lines.push("  case $state in");
+  lines.push("    cmd)");
+  lines.push("      _describe 'command' top_commands ;;");
+  lines.push("    args)");
+  lines.push("      case $words[2] in");
+  for (const parent of tree) {
+    lines.push(`        ${parent.name})`);
+    if (parent.subcmds.length > 0) {
+      lines.push("          local -a subcmds");
+      lines.push("          subcmds=(");
+      for (const child of parent.subcmds) {
+        lines.push(`            '${child.name}:${escapeZshDesc(child.description)}'`);
+      }
+      lines.push("          )");
+      lines.push("          if (( CURRENT == 3 )); then");
+      lines.push("            _describe 'subcommand' subcmds");
+      lines.push("          else");
+      lines.push("            case $words[3] in");
+      for (const child of parent.subcmds) {
+        const argSpec = child.options.map((f) => `'${f}[option]'`).join(" \\\n                ");
+        lines.push(`              ${child.name})`);
+        lines.push(`                _arguments ${argSpec} ;;`);
+      }
+      lines.push("            esac");
+      lines.push("          fi ;;");
+    } else {
+      const argSpec = parent.options.map((f) => `'${f}[option]'`).join(" \\\n            ");
+      if (argSpec) {
+        lines.push(`          _arguments ${argSpec} ;;`);
+      } else {
+        lines.push("          ;; # no options");
+      }
+    }
+  }
+  lines.push("      esac ;;");
+  lines.push("  esac");
+  lines.push("}");
+  lines.push("");
+  lines.push("_corp");
+  return lines.join("\n");
+}
+function generateFish(commands) {
+  const tree = buildTree(commands);
+  const lines = [
+    "# corp fish completion",
+    "# Save to ~/.config/fish/completions/corp.fish",
+    "#   corp completions --shell fish > ~/.config/fish/completions/corp.fish",
+    ""
+  ];
+  lines.push("complete -c corp -f");
+  lines.push("");
+  for (const node of tree) {
+    const desc = node.description.replace(/'/g, "\\'");
+    lines.push(`complete -c corp -n '__fish_use_subcommand' -a '${node.name}' -d '${desc}'`);
+  }
+  lines.push("");
+  for (const parent of tree) {
+    const parentName = parent.name;
+    if (parent.subcmds.length > 0) {
+      for (const child of parent.subcmds) {
+        const desc = child.description.replace(/'/g, "\\'");
+        lines.push(
+          `complete -c corp -n "__fish_seen_subcommand_from ${parentName}; and not __fish_seen_subcommand_from ${parent.subcmds.map((s3) => s3.name).join(" ")}" -a '${child.name}' -d '${desc}'`
+        );
+      }
+      lines.push("");
+      for (const child of parent.subcmds) {
+        for (const flag of child.options) {
+          const long = flag.replace(/^--/, "");
+          lines.push(
+            `complete -c corp -n "__fish_seen_subcommand_from ${parentName}; and __fish_seen_subcommand_from ${child.name}" -l '${long}'`
+          );
+        }
+        if (child.options.length > 0) lines.push("");
+      }
+    } else {
+      for (const flag of parent.options) {
+        const long = flag.replace(/^--/, "");
+        lines.push(
+          `complete -c corp -n "__fish_seen_subcommand_from ${parentName}" -l '${long}'`
+        );
+      }
+      if (parent.options.length > 0) lines.push("");
+    }
+  }
+  return lines.join("\n");
+}
+function makeCompletionsCommand(allCommands) {
+  return {
+    name: "completions",
+    description: "Generate shell completion scripts",
+    local: true,
+    options: [
+      {
+        flags: "--shell <shell>",
+        description: "Shell type (bash, zsh, fish)",
+        choices: ["bash", "zsh", "fish"],
+        required: true
+      }
+    ],
+    examples: [
+      "corp completions --shell bash",
+      "corp completions --shell zsh",
+      "corp completions --shell fish",
+      "source <(corp completions --shell bash)",
+      'eval "$(corp completions --shell zsh)"',
+      "corp completions --shell fish > ~/.config/fish/completions/corp.fish"
+    ],
+    handler: async (ctx) => {
+      const shell = ctx.opts.shell;
+      const cmds = allCommands.filter((c) => c.name !== "completions");
+      let script;
+      switch (shell) {
+        case "bash":
+          script = generateBash(cmds);
+          break;
+        case "zsh":
+          script = generateZsh(cmds);
+          break;
+        case "fish":
+          script = generateFish(cmds);
+          break;
+        default:
+          ctx.writer.error(`Unknown shell: ${shell}. Choose bash, zsh, or fish.`);
+          process.exit(1);
+      }
+      process.stdout.write(script + "\n");
+    }
+  };
+}
+var init_completions = __esm({
+  "src/registry/completions.ts"() {
+    "use strict";
+  }
+});
+
 // src/registry/index.ts
 var registry_exports = {};
 __export(registry_exports, {
@@ -12254,7 +12967,7 @@ function generateSchema(commands, programName, version) {
     commands: topLevel
   };
 }
-var registry;
+var baseRegistry, registry;
 var init_registry = __esm({
   "src/registry/index.ts"() {
     "use strict";
@@ -12274,7 +12987,8 @@ var init_registry = __esm({
     init_secret_proxies();
     init_treasury();
     init_branches();
-    registry = [
+    init_completions();
+    baseRegistry = [
       ...workspaceCommands,
       ...entityCommands,
       ...formationCommands,
@@ -12292,6 +13006,10 @@ var init_registry = __esm({
       ...treasuryCommands,
       ...branchCommands
     ];
+    registry = [
+      ...baseRegistry,
+      makeCompletionsCommand(baseRegistry)
+    ];
   }
 });
 
@@ -12617,7 +13335,9 @@ init_api_client();
 init_references();
 function buildCLI(commands, version) {
   const program2 = new Command();
-  program2.name("corp").description("corp \u2014 Corporate governance from the terminal").version(version).enablePositionalOptions();
+  program2.name("corp").description(
+    'The Corporation CLI \u2014 form entities, manage cap tables, govern, and operate.\n\nQuick start:\n  corp form --type llc --name "My LLC" --member "Alice,a@co.com,member,100"\n  corp cap-table\n  corp next\n\nDocs: https://docs.thecorporation.ai'
+  ).version(version).enablePositionalOptions();
   program2.option("-q, --quiet", "Only output the resource ID (for scripting)");
   program2.action(() => {
     program2.outputHelp();
@@ -12638,6 +13358,61 @@ function buildCLI(commands, version) {
       children.get(parent).push(def);
     }
   }
+  const commandGroupOrder = {
+    // Core workflow — formation & entity management
+    form: 0,
+    entities: 1,
+    contacts: 2,
+    // Cap table
+    "cap-table": 10,
+    "safe-notes": 11,
+    "share-transfers": 12,
+    valuations: 13,
+    // Governance
+    governance: 20,
+    // Finance
+    finance: 30,
+    // Compliance & tax
+    tax: 40,
+    deadlines: 41,
+    // Status / context / actions
+    status: 50,
+    context: 51,
+    use: 52,
+    next: 53,
+    obligations: 54,
+    "human-obligations": 55,
+    digest: 56,
+    // Services & work items
+    services: 60,
+    "work-items": 61,
+    contracts: 62,
+    // Agents
+    agents: 70,
+    // Admin / config / setup (last)
+    billing: 80,
+    "api-keys": 81,
+    link: 82,
+    claim: 83,
+    feedback: 84,
+    resolve: 85,
+    find: 86,
+    approvals: 87,
+    receipts: 88,
+    config: 90,
+    setup: 91,
+    schema: 92,
+    serve: 93,
+    demo: 94,
+    chat: 95,
+    completions: 96
+  };
+  topLevel.sort((a, b) => {
+    const ga = commandGroupOrder[a.name] ?? 75;
+    const gb = commandGroupOrder[b.name] ?? 75;
+    if (ga !== gb) return ga - gb;
+    return a.name.localeCompare(b.name);
+  });
   const parentCmds = /* @__PURE__ */ new Map();
   for (const def of topLevel) {
     const cmd = wireCommand(program2, def);