@thecorporation/cli 26.3.48 → 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'
         ]
       },
       {
@@ -4343,16 +4274,19 @@ var init_formation = __esm({
       // ── 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",
@@ -4361,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",
@@ -4370,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 @last",
+          "corp documents request-copy doc-abc123 --recipient-email alice@acme.com"
         ],
-        examples: ["corp documents request-copy <document-id>", "corp documents request-copy --json"],
-        successTemplate: "Request Copy created"
+        successTemplate: "Certified copy requested for document {document_id}"
       },
       {
         name: "entities list",
@@ -4416,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 --entity-type c_corp --jurisdiction 'jurisdiction' --legal-name 'legal-name' --members 'members'", "corp formations --json"],
-        successTemplate: "Formations created"
+        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`
+        ],
+        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 'legal-name'", "corp formations pending --json"],
-        successTemplate: "Pending formation created"
+        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'
+        ],
+        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",
@@ -4493,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 ceo", "corp formations founders --json"],
-        successTemplate: "Founders created"
+        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'
+        ],
+        successTemplate: "Founder added to {entity_id}"
       },
       {
         name: "formations gates",
@@ -4588,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 --json"],
-        successTemplate: "Service Agreement Execute created"
+        examples: [
+          "corp formations service-agreement-execute",
+          "corp formations service-agreement-execute --contract-id contract-abc123 --json"
+        ],
+        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",
@@ -4638,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"]
       }
     ];
   }
@@ -4746,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: {
@@ -4772,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: {
@@ -4828,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: {
@@ -4854,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: {
@@ -4994,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 ---
       {
@@ -5004,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" },
@@ -5048,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 ---
       {
@@ -5128,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 ---
@@ -5215,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 ---
@@ -5233,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" }
         ],
@@ -5321,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 ---
       {
@@ -5334,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) => {
@@ -5368,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 ---
       {
@@ -5412,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 ---
       {
@@ -5430,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);
@@ -5457,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 ---
       {
@@ -5506,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 ---
       {
@@ -5516,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" },
@@ -5567,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> ---
       {
@@ -5626,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> ---
       {
@@ -5670,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 ---
       {
@@ -5700,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 ---
       {
@@ -5734,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 ──────────────────────────────
       {
@@ -5749,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",
@@ -5769,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",
@@ -5781,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",
@@ -5802,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",
@@ -5819,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",
@@ -5829,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",
@@ -5841,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",
@@ -5853,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",
@@ -5864,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",
@@ -5875,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",
@@ -5886,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",
@@ -5900,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",
@@ -5912,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",
@@ -5923,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",
@@ -5935,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",
@@ -5947,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",
@@ -5968,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",
@@ -5983,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",
@@ -5999,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",
@@ -6015,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",
@@ -6032,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",
@@ -6048,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",
@@ -6061,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",
@@ -6075,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",
@@ -6088,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",
@@ -6101,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",
@@ -6119,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",
@@ -6138,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",
@@ -6148,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",
@@ -6159,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",
@@ -6170,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",
@@ -6181,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",
@@ -6195,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",
@@ -6207,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",
@@ -6218,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",
@@ -6231,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",
@@ -6243,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",
@@ -6255,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",
@@ -6281,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",
@@ -6301,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",
@@ -6317,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",
@@ -6336,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"
       }
     ];
   }
@@ -6999,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> ---
       {
@@ -7031,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> ---
       {
@@ -7063,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> ---
       {
@@ -7095,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" },
@@ -7183,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 ---
       {
@@ -7227,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> ---
       {
@@ -7239,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];
@@ -7262,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 ---
       {
@@ -7274,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" }
@@ -7311,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> ---
       {
@@ -7353,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> ---
       {
@@ -7407,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> ---
       {
@@ -7432,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> ---
       {
@@ -7457,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> ---
       {
@@ -7482,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> ---
       {
@@ -7520,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> ---
       {
@@ -7559,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> ---
       {
@@ -7602,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 ---
       {
@@ -7655,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 ---
       {
@@ -7770,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);
@@ -7777,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 ──────────────────────────────
       {
@@ -7828,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",
@@ -7874,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"
       },
       {
@@ -7882,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",
@@ -7891,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"
       },
       {
@@ -7900,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",
@@ -7917,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",
@@ -7926,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",
@@ -7949,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",
@@ -7970,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",
@@ -7982,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",
@@ -7995,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",
@@ -8004,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",
@@ -8016,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",
@@ -8029,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",
@@ -8041,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",
@@ -8052,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"
       }
     ];
   }
@@ -8149,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> ---
       {
@@ -8203,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 ---
       {
@@ -8228,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 ---
       {
@@ -8237,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)" },
@@ -8306,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 ---
       {
@@ -8330,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"
+        ]
       }
     ];
   }
@@ -8548,42 +8791,42 @@ var init_compliance = __esm({
       },
       {
         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"'
         ],
-        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'
+          'corp contractors classify --contractor-name "Acme Services LLC" --duration-months 6 --exclusive-client false --provides-tools true'
         ],
-        successTemplate: "Classify created"
+        successTemplate: "Worker classification complete"
       },
       {
         name: "deadlines",
@@ -8600,7 +8843,7 @@ var init_compliance = __esm({
           '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: "Deadlines created"
+        successTemplate: "Deadline tracked"
       },
       {
         name: "entities compliance-escalations",
@@ -8616,14 +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 --json"
+          "corp tax create-filing --document-type 1065 --tax-year 2025"
         ],
-        successTemplate: "Filings created"
+        successTemplate: "Tax filing created"
       }
     ];
   }
@@ -9139,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 ---
       {
@@ -9177,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> ---
       {
@@ -9206,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> ---
       {
@@ -9237,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> ---
       {
@@ -9253,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> ---
       {
@@ -9282,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"
+        ]
       }
     ];
   }
@@ -9360,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> ---
       {
@@ -9406,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> ---
       {
@@ -9436,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> ---
       {
@@ -9462,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 create-request --service-slug registered-agent",
+          "corp services create-request --service-slug annual-report --obligation-id obl_abc123 --json"
         ],
-        examples: ["corp services requests --service-slug 'service-slug'", "corp services requests --json"],
-        successTemplate: "Requests created"
+        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"
       }
     ];
   }
@@ -10940,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",
@@ -10953,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",
@@ -11023,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" }
         ],
@@ -11036,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) ───────────────────────────────────────
       {
@@ -11083,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",
@@ -11103,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",
@@ -11123,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) ───────────────────────────────────────────────
       {
@@ -11141,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) ──────────────────────────────────────────────
       {
@@ -11156,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) ───────────────────────────────────────────
       {
@@ -11167,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) => {
@@ -11178,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) ─────────────────────────────────────────────
       {
@@ -11201,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) ────────────────────────────────────────────────
       {
@@ -11226,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) ───────────────────────────────────────
       {
@@ -11289,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",
@@ -11338,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"]
       },
       {
@@ -11364,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"
       },
       {
@@ -11393,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"
       },
       {
@@ -11404,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 ──────────────────────────────
       {
@@ -11416,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 ──────────────────────────────
@@ -11428,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"]
       }
     ];
   }
@@ -11465,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",
@@ -11474,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",
@@ -11544,7 +11817,7 @@ var init_execution = __esm({
           '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 Artifacts created"
+        successTemplate: "Approval artifact recorded"
       },
       {
         name: "execution intents",
@@ -11561,7 +11834,7 @@ var init_execution = __esm({
           '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: "Intents created"
+        successTemplate: "Execution intent created"
       },
       {
         name: "execution obligations",
@@ -11580,7 +11853,7 @@ var init_execution = __esm({
           '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: "Obligations created"
+        successTemplate: "Obligation created"
       },
       {
         name: "execution packets",
@@ -11600,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"
       },
       {
@@ -11614,7 +11890,7 @@ var init_execution = __esm({
         examples: [
           "corp intents bind-approval-artifact @last:intent --approval-artifact-id art_01hx9k3n2p4q7r8s9t0uvwxyz"
         ],
-        successTemplate: "Bind Approval Artifact created"
+        successTemplate: "Approval artifact bound to intent"
       },
       {
         name: "intents bind-document-request",
@@ -11627,7 +11903,7 @@ var init_execution = __esm({
         examples: [
           "corp intents bind-document-request @last:intent --request-id req_01hx9k3n2p4q7r8s9t0uvwxyz"
         ],
-        successTemplate: "Bind Document Request created"
+        successTemplate: "Document request bound to intent"
       },
       {
         name: "intents cancel",
@@ -11635,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"
       },
       {
@@ -11644,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"
       },
       {
@@ -11653,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"
       },
       {
@@ -11680,7 +11965,7 @@ var init_execution = __esm({
         examples: [
           "corp obligations assign obl_01hx9k3n2p4q7r8s9t0uvwxyz --assignee-id usr_01hx9k3n2p4q7r8s9t0uvwxyz"
         ],
-        successTemplate: "Assign created"
+        successTemplate: "Obligation assigned"
       },
       {
         name: "obligations document-requests",
@@ -11707,7 +11992,7 @@ var init_execution = __esm({
         examples: [
           'corp obligations create-document-request obl_01hx9k3n2p4q7r8s9t0uvwxyz --description "Signed equity grant agreement" --document-type equity_grant'
         ],
-        successTemplate: "Document Requests created"
+        successTemplate: "Document request created"
       },
       {
         name: "obligations expire",
@@ -11715,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"
       },
       {
@@ -11724,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"
       },
       {
@@ -11733,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"
       },
       {
@@ -11765,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",
@@ -11773,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"
+        ]
       }
     ];
   }
@@ -11805,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",
@@ -11816,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",
@@ -11827,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",
@@ -11838,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`
+        ]
       }
     ];
   }
@@ -11856,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 "Q1 dividend" --distribution-type dividend --total-amount-cents 500000',
+          'corp distributions --description "Founder draw" --distribution-type return --total-amount-cents 1000000'
         ],
-        examples: ["corp distributions --description dividend --total-amount-cents 'total-amount-cents'", "corp distributions --json"],
-        successTemplate: "Distributions created"
+        successTemplate: "Distribution recorded"
       },
       {
         name: "entities accounts",
@@ -11897,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"] },
@@ -11909,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 500000 --customer-name "Acme Corp" --description "Consulting services Q1" --due-date 2026-06-30'
         ],
-        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"
+        successTemplate: "Invoice created from agent request"
       },
       {
         name: "invoices",
@@ -11924,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",
@@ -11932,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"
       },
       {
@@ -11942,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",
@@ -11950,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",
@@ -11968,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"
       },
       {
@@ -11977,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 --as-of-date 2026-03-31",
+          "corp ledger reconcile --start-date 2026-01-01 --end-date 2026-03-31"
         ],
-        examples: ["corp ledger reconcile", "corp ledger reconcile --json"],
-        successTemplate: "Reconcile created"
+        successTemplate: "Ledger reconciliation complete"
       },
       {
         name: "payments",
@@ -11999,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 'amount-cents' --description bank_transfer --recipient 'recipient'", "corp payments --json"],
-        successTemplate: "Payments created"
+        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"'
+        ],
+        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"] },
@@ -12083,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 'amount-cents' --customer-name 'customer-name' --description 'description' --due-date 'due-date'"],
-        successTemplate: "Invoices created"
+        examples: [
+          'corp treasury invoices --amount-cents 500000 --customer-name "Acme Corp" --description "Consulting services Q1" --due-date 2026-06-30'
+        ],
+        successTemplate: "Invoice created"
       },
       {
         name: "treasury journal-entries",
@@ -12097,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",
@@ -12110,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 'amount-cents'", "corp treasury payment-intents --json"],
-        successTemplate: "Payment Intents created"
+        examples: [
+          'corp treasury payment-intents --amount-cents 500000 --currency USD --description "Vendor payment"'
+        ],
+        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 --template startup"
         ],
-        examples: ["corp treasury seed-chart-of-accounts", "corp treasury seed-chart-of-accounts --json"],
-        successTemplate: "Seed Chart Of Accounts created"
+        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"
       }
     ];
   }
@@ -12180,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",
@@ -12193,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",
@@ -12202,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",
@@ -12211,7 +12561,7 @@ 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"]
       }
     ];
   }