@thecorporation/cli 26.3.2 → 26.3.4

package/dist/index.js

@@ -10,6 +10,17 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
+var config_exports = {};
+__export(config_exports, {
+  configForDisplay: () => configForDisplay,
+  getValue: () => getValue,
+  loadConfig: () => loadConfig,
+  maskKey: () => maskKey,
+  requireConfig: () => requireConfig,
+  resolveEntityId: () => resolveEntityId,
+  saveConfig: () => saveConfig,
+  setValue: () => setValue
+});
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -122,6 +133,29 @@ var init_api_client = __esm({
 });
 
 // src/output.ts
+var output_exports = {};
+__export(output_exports, {
+  printAgentsTable: () => printAgentsTable,
+  printApprovalsTable: () => printApprovalsTable,
+  printBillingPanel: () => printBillingPanel,
+  printCapTable: () => printCapTable,
+  printContactsTable: () => printContactsTable,
+  printDocumentsTable: () => printDocumentsTable,
+  printEntitiesTable: () => printEntitiesTable,
+  printError: () => printError,
+  printGovernanceTable: () => printGovernanceTable,
+  printJson: () => printJson,
+  printMeetingsTable: () => printMeetingsTable,
+  printObligationsTable: () => printObligationsTable,
+  printResolutionsTable: () => printResolutionsTable,
+  printSafesTable: () => printSafesTable,
+  printSeatsTable: () => printSeatsTable,
+  printStatusPanel: () => printStatusPanel,
+  printSuccess: () => printSuccess,
+  printTransfersTable: () => printTransfersTable,
+  printValuationsTable: () => printValuationsTable,
+  printWarning: () => printWarning
+});
 import chalk from "chalk";
 import Table from "cli-table3";
 function printError(msg) {
@@ -130,6 +164,9 @@ function printError(msg) {
 function printSuccess(msg) {
   console.log(chalk.green(msg));
 }
+function printWarning(msg) {
+  console.log(chalk.yellow(msg));
+}
 function printJson(data) {
   console.log(JSON.stringify(data, null, 2));
 }
@@ -364,35 +401,30 @@ function printApprovalsTable(approvals) {
   console.log(table.toString());
 }
 function printBillingPanel(status, plans) {
-  const tier = s(status.tier ?? status.plan) || "free";
-  const subs = status.subscriptions ?? [];
-  const usageCount = status.usage_count ?? 0;
+  const plan = s(status.plan ?? status.tier) || "free";
+  const subStatus = s(status.status) || "active";
+  const periodEnd = s(status.current_period_end);
   console.log(chalk.green("\u2500".repeat(50)));
   console.log(chalk.green.bold("  Billing Status"));
   console.log(chalk.green("\u2500".repeat(50)));
-  console.log(`  ${chalk.bold("Current Tier:")} ${tier}`);
-  console.log(`  ${chalk.bold("Active Subscriptions:")} ${subs.length}`);
-  for (const sub of subs) {
-    console.log(`    - ${sub.tier ?? "N/A"} (${sub.status ?? "N/A"})`);
-  }
-  console.log(`  ${chalk.bold("Tool Calls:")} ${usageCount}`);
+  console.log(`  ${chalk.bold("Plan:")} ${plan}`);
+  console.log(`  ${chalk.bold("Status:")} ${subStatus}`);
+  if (periodEnd) console.log(`  ${chalk.bold("Current Period End:")} ${periodEnd}`);
   console.log(chalk.dim("  Manage:  corp billing portal"));
-  console.log(chalk.dim("  Upgrade: corp billing upgrade"));
+  console.log(chalk.dim("  Upgrade: corp billing upgrade --plan <plan>"));
   console.log(chalk.green("\u2500".repeat(50)));
   if (plans.length > 0) {
-    const table = makeTable("Available Plans", ["Tier", "Price", "Type", "Description"]);
+    const table = makeTable("Available Plans", ["Plan", "Price", "Features"]);
     for (const p of plans) {
-      const amount = p.amount ?? 0;
+      const amount = p.price_cents ?? p.amount ?? 0;
       const interval = s(p.interval);
       let priceStr = "Free";
       if (amount > 0) {
-        priceStr = interval ? `$${Math.round(amount / 100)}/${interval[0]}` : `$${Math.round(amount / 100)}`;
+        priceStr = interval ? `$${Math.round(amount / 100)}/${interval}` : `$${Math.round(amount / 100)}`;
       }
-      let name = s(p.name ?? p.tier);
-      if (p.addon) name += chalk.dim(" (add-on)");
-      let desc = s(p.description);
-      if (desc.length > 60) desc = desc.slice(0, 57) + "...";
-      table.push([name, priceStr, s(p.type), desc]);
+      const name = s(p.name ?? p.plan_id ?? p.tier);
+      const features = Array.isArray(p.features) ? p.features.join(", ") : s(p.description);
+      table.push([name, priceStr, features]);
     }
     console.log(table.toString());
   }
@@ -682,8 +714,8 @@ var init_status = __esm({
 });
 
 // src/commands/config.ts
-var config_exports = {};
-__export(config_exports, {
+var config_exports2 = {};
+__export(config_exports2, {
   configGetCommand: () => configGetCommand,
   configListCommand: () => configListCommand,
   configSetCommand: () => configSetCommand
@@ -787,19 +819,13 @@ var link_exports = {};
 __export(link_exports, {
   linkCommand: () => linkCommand
 });
-async function linkCommand() {
+async function linkCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const data = await client.createLink();
-    const code = data.code;
-    const expires = data.expires_in_seconds ?? 900;
-    console.log();
-    console.log(`  ${code}`);
-    console.log();
-    console.log(`Run this on the other device (expires in ${Math.floor(expires / 60)} minutes):`);
-    console.log(`  corp claim ${code}`);
-    console.log();
+    const data = await client.createLink(opts.externalId, opts.provider);
+    printSuccess(`Workspace linked to ${opts.provider} (external ID: ${opts.externalId})`);
+    if (data.workspace_id) console.log(`  Workspace: ${data.workspace_id}`);
   } catch (err) {
     printError(`${err}`);
     process.exit(1);
@@ -1035,7 +1061,7 @@ async function chatCommand() {
   const messages = [{ role: "system", content: SYSTEM_PROMPT }];
   let totalTokens = 0;
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const prompt = () => new Promise((resolve) => rl.question(chalk2.green.bold("> "), resolve));
+  const prompt = () => new Promise((resolve2) => rl.question(chalk2.green.bold("> "), resolve2));
   console.log(chalk2.blue.bold("corp chat") + " \u2014 type /help for commands, /quit to exit\n");
   const slashHandlers = {
     "/status": async () => {
@@ -1245,7 +1271,7 @@ async function entitiesConvertCommand(entityId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const data = { new_entity_type: opts.to };
+    const data = { target_type: opts.to };
     if (opts.jurisdiction) data.new_jurisdiction = opts.jurisdiction;
     const result = await client.convertEntity(entityId, data);
     printSuccess(`Entity conversion initiated: ${result.conversion_id ?? "OK"}`);
@@ -1265,7 +1291,12 @@ async function entitiesDissolveCommand(entityId, opts) {
     printSuccess(`Dissolution initiated: ${result.dissolution_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
-    printError(`Failed to dissolve entity: ${err}`);
+    const msg = String(err);
+    if (msg.includes("InvalidTransition") || msg.includes("422")) {
+      printError(`Cannot dissolve entity: only entities with 'active' status can be dissolved. Check the entity's current status with: corp entities show ${entityId}`);
+    } else {
+      printError(`Failed to dissolve entity: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1290,9 +1321,10 @@ __export(contacts_exports, {
 import chalk4 from "chalk";
 async function contactsListCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const contacts = await client.listContacts();
+    const contacts = await client.listContacts(eid);
     if (opts.json) printJson(contacts);
     else if (contacts.length === 0) console.log("No contacts found.");
     else printContactsTable(contacts);
@@ -1303,9 +1335,10 @@ async function contactsListCommand(opts) {
 }
 async function contactsShowCommand(contactId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const profile = await client.getContactProfile(contactId);
+    const profile = await client.getContactProfile(contactId, eid);
     if (opts.json) {
       printJson(profile);
     } else {
@@ -1336,10 +1369,16 @@ async function contactsShowCommand(contactId, opts) {
 }
 async function contactsAddCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const data = { name: opts.name, email: opts.email };
-    if (opts.category) data.category = opts.category;
+    const data = {
+      entity_id: eid,
+      contact_type: opts.type ?? "individual",
+      name: opts.name,
+      email: opts.email,
+      category: opts.category ?? "employee"
+    };
     if (opts.phone) data.phone = opts.phone;
     if (opts.notes) data.notes = opts.notes;
     const result = await client.createContact(data);
@@ -1351,9 +1390,10 @@ async function contactsAddCommand(opts) {
 }
 async function contactsEditCommand(contactId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const data = {};
+    const data = { entity_id: eid };
     if (opts.name != null) data.name = opts.name;
     if (opts.email != null) data.email = opts.email;
     if (opts.category != null) data.category = opts.category;
@@ -1476,7 +1516,12 @@ async function fourOhNineACommand(opts) {
     else if (!data || Object.keys(data).length === 0) console.log("No 409A valuation found.");
     else print409a(data);
   } catch (err) {
-    printError(`Failed to fetch 409A valuation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("404")) {
+      console.log("No 409A valuation found for this entity. Create one with:\n  corp cap-table create-valuation --type four_oh_nine_a --date YYYY-MM-DD --methodology <method>");
+    } else {
+      printError(`Failed to fetch 409A valuation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1485,13 +1530,48 @@ async function issueEquityCommand(opts) {
   const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const result = await client.issueEquity({
+    const capTable = await client.getCapTable(eid);
+    const issuerLegalEntityId = capTable.issuer_legal_entity_id;
+    if (!issuerLegalEntityId) {
+      printError("No issuer legal entity found. Has this entity been formed with a cap table?");
+      process.exit(1);
+    }
+    let instrumentId = opts.instrumentId;
+    if (!instrumentId) {
+      const instruments = capTable.instruments;
+      if (!instruments?.length) {
+        printError("No instruments found on cap table. Create an instrument first.");
+        process.exit(1);
+      }
+      const grantLower = opts.grantType.toLowerCase();
+      const match = instruments.find(
+        (i) => i.kind.toLowerCase().includes(grantLower) || i.symbol.toLowerCase().includes(grantLower)
+      ) ?? instruments.find((i) => i.kind.toLowerCase().includes("common"));
+      if (match) {
+        instrumentId = match.instrument_id;
+        console.log(`Using instrument: ${match.symbol} (${match.kind})`);
+      } else {
+        instrumentId = instruments[0].instrument_id;
+        console.log(`Using first instrument: ${instruments[0].symbol} (${instruments[0].kind})`);
+      }
+    }
+    const round = await client.startEquityRound({
       entity_id: eid,
-      grant_type: opts.grantType,
-      shares: opts.shares,
-      recipient_name: opts.recipient
+      name: `${opts.grantType} grant \u2014 ${opts.recipient}`,
+      issuer_legal_entity_id: issuerLegalEntityId
     });
-    printSuccess(`Equity issued: ${result.grant_id ?? "OK"}`);
+    const roundId = round.round_id ?? round.equity_round_id;
+    const securityData = {
+      entity_id: eid,
+      instrument_id: instrumentId,
+      quantity: opts.shares,
+      recipient_name: opts.recipient,
+      grant_type: opts.grantType
+    };
+    if (opts.email) securityData.email = opts.email;
+    await client.addRoundSecurity(roundId, securityData);
+    const result = await client.issueRound(roundId, { entity_id: eid });
+    printSuccess(`Equity issued: ${opts.shares} shares (${opts.grantType}) to ${opts.recipient}`);
     printJson(result);
   } catch (err) {
     printError(`Failed to issue equity: ${err}`);
@@ -1503,14 +1583,36 @@ async function issueSafeCommand(opts) {
   const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const result = await client.issueSafe({
+    const capTable = await client.getCapTable(eid);
+    const issuerLegalEntityId = capTable.issuer_legal_entity_id;
+    if (!issuerLegalEntityId) {
+      printError("No issuer legal entity found. Has this entity been formed with a cap table?");
+      process.exit(1);
+    }
+    const instruments = capTable.instruments;
+    const safeInstrument = instruments?.find((i) => i.kind.toLowerCase() === "safe");
+    if (!safeInstrument) {
+      printError("No SAFE instrument found on cap table. Create a SAFE instrument first.");
+      process.exit(1);
+    }
+    const round = await client.startEquityRound({
       entity_id: eid,
-      investor_name: opts.investor,
-      principal_amount_cents: opts.amount,
-      safe_type: opts.safeType,
-      valuation_cap_cents: opts.valuationCap
+      name: `SAFE \u2014 ${opts.investor}`,
+      issuer_legal_entity_id: issuerLegalEntityId
     });
-    printSuccess(`SAFE issued: ${result.safe_note_id ?? result.safe_id ?? "OK"}`);
+    const roundId = round.round_id ?? round.equity_round_id;
+    const securityData = {
+      entity_id: eid,
+      instrument_id: safeInstrument.instrument_id,
+      quantity: opts.amount,
+      recipient_name: opts.investor,
+      principal_cents: opts.amount,
+      grant_type: opts.safeType
+    };
+    if (opts.email) securityData.email = opts.email;
+    await client.addRoundSecurity(roundId, securityData);
+    const result = await client.issueRound(roundId, { entity_id: eid });
+    printSuccess(`SAFE issued: $${(opts.amount / 100).toLocaleString()} to ${opts.investor}`);
     printJson(result);
   } catch (err) {
     printError(`Failed to issue SAFE: ${err}`);
@@ -1522,17 +1624,24 @@ async function transferSharesCommand(opts) {
   const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const result = await client.transferShares({
+    const body = {
       entity_id: eid,
-      from_holder: opts.fromGrant,
-      to_holder: opts.to,
-      shares: opts.shares,
-      transfer_type: opts.type
-    });
-    printSuccess(`Transfer complete: ${result.transfer_id ?? "OK"}`);
+      share_class_id: opts.shareClassId,
+      from_contact_id: opts.from,
+      to_contact_id: opts.to,
+      transfer_type: opts.type,
+      share_count: opts.shares,
+      governing_doc_type: opts.governingDocType,
+      transferee_rights: opts.transfereeRights,
+      prepare_intent_id: opts.prepareIntentId
+    };
+    if (opts.pricePerShareCents != null) body.price_per_share_cents = opts.pricePerShareCents;
+    if (opts.relationship) body.relationship_to_holder = opts.relationship;
+    const result = await client.transferShares(body);
+    printSuccess(`Transfer workflow created: ${result.workflow_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
-    printError(`Failed to transfer shares: ${err}`);
+    printError(`Failed to create transfer workflow: ${err}`);
     process.exit(1);
   }
 }
@@ -1544,7 +1653,8 @@ async function distributeCommand(opts) {
     const result = await client.calculateDistribution({
       entity_id: eid,
       total_amount_cents: opts.amount,
-      distribution_type: opts.type
+      distribution_type: opts.type,
+      description: opts.description
     });
     printSuccess(`Distribution calculated: ${result.distribution_id ?? "OK"}`);
     printJson(result);
@@ -1638,7 +1748,12 @@ async function submitValuationCommand(opts) {
     if (result.agenda_item_id) console.log(`  Agenda Item: ${result.agenda_item_id}`);
     printJson(result);
   } catch (err) {
-    printError(`Failed to submit valuation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("404")) {
+      printError(`Valuation not found. List valuations with: corp cap-table valuations`);
+    } else {
+      printError(`Failed to submit valuation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1651,7 +1766,12 @@ async function approveValuationCommand(opts) {
     printSuccess(`Valuation approved: ${result.valuation_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
-    printError(`Failed to approve valuation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("400")) {
+      printError(`Bad request \u2014 a --resolution-id from a board vote may be required. Submit for approval first: corp cap-table submit-valuation <id>`);
+    } else {
+      printError(`Failed to approve valuation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1743,7 +1863,7 @@ async function financeOpenAccountCommand(opts) {
   const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const result = await client.openBankAccount({ entity_id: eid, institution_name: opts.institution });
+    const result = await client.openBankAccount({ entity_id: eid, bank_name: opts.institution });
     printSuccess(`Bank account opened: ${result.account_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
@@ -1805,7 +1925,9 @@ __export(governance_exports, {
   cancelMeetingCommand: () => cancelMeetingCommand,
   computeResolutionCommand: () => computeResolutionCommand,
   finalizeAgendaItemCommand: () => finalizeAgendaItemCommand,
+  governanceAddSeatCommand: () => governanceAddSeatCommand,
   governanceConveneCommand: () => governanceConveneCommand,
+  governanceCreateBodyCommand: () => governanceCreateBodyCommand,
   governanceListCommand: () => governanceListCommand,
   governanceMeetingsCommand: () => governanceMeetingsCommand,
   governanceResolutionsCommand: () => governanceResolutionsCommand,
@@ -1815,6 +1937,39 @@ __export(governance_exports, {
   sendNoticeCommand: () => sendNoticeCommand,
   writtenConsentCommand: () => writtenConsentCommand
 });
+async function governanceCreateBodyCommand(opts) {
+  const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
+  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  try {
+    const result = await client.createGovernanceBody({
+      entity_id: eid,
+      body_type: opts.bodyType,
+      name: opts.name,
+      quorum_rule: opts.quorum,
+      voting_method: opts.voting
+    });
+    printSuccess(`Governance body created: ${result.body_id ?? "OK"}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to create governance body: ${err}`);
+    process.exit(1);
+  }
+}
+async function governanceAddSeatCommand(bodyId, opts) {
+  const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  try {
+    const data = { holder_id: opts.holder };
+    if (opts.title) data.title = opts.title;
+    const result = await client.createGovernanceSeat(bodyId, data);
+    printSuccess(`Seat added: ${result.seat_id ?? "OK"}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to add seat: ${err}`);
+    process.exit(1);
+  }
+}
 async function governanceListCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const eid = resolveEntityId(cfg, opts.entityId);
@@ -1831,9 +1986,10 @@ async function governanceListCommand(opts) {
 }
 async function governanceSeatsCommand(bodyId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const seats = await client.getGovernanceSeats(bodyId);
+    const seats = await client.getGovernanceSeats(bodyId, eid);
     if (opts.json) printJson(seats);
     else if (seats.length === 0) console.log("No seats found.");
     else printSeatsTable(seats);
@@ -1844,9 +2000,10 @@ async function governanceSeatsCommand(bodyId, opts) {
 }
 async function governanceMeetingsCommand(bodyId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const meetings = await client.listMeetings(bodyId);
+    const meetings = await client.listMeetings(bodyId, eid);
     if (opts.json) printJson(meetings);
     else if (meetings.length === 0) console.log("No meetings found.");
     else printMeetingsTable(meetings);
@@ -1857,9 +2014,10 @@ async function governanceMeetingsCommand(bodyId, opts) {
 }
 async function governanceResolutionsCommand(meetingId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const resolutions = await client.getMeetingResolutions(meetingId);
+    const resolutions = await client.getMeetingResolutions(meetingId, eid);
     if (opts.json) printJson(resolutions);
     else if (resolutions.length === 0) console.log("No resolutions found.");
     else printResolutionsTable(resolutions);
@@ -2037,13 +2195,18 @@ async function documentsListCommand(opts) {
     process.exit(1);
   }
 }
-async function documentsSigningLinkCommand(docId) {
+async function documentsSigningLinkCommand(docId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const result = client.getSigningLink(docId);
+    const result = await client.getSigningLink(docId, eid);
     printSuccess(`Signing link: ${result.signing_url}`);
-    console.log("Open this link in your browser to sign the document.");
+    if (result.token) {
+      console.log(`  Token: ${result.token}`);
+      console.log(`  Share this URL with the signer:`);
+      console.log(`  https://humans.thecorporation.ai/sign/${docId}?token=${result.token}`);
+    }
   } catch (err) {
     printError(`Failed to get signing link: ${err}`);
     process.exit(1);
@@ -2057,7 +2220,8 @@ async function documentsGenerateCommand(opts) {
     const result = await client.generateContract({
       entity_id: eid,
       template_type: opts.template,
-      parameters: { counterparty_name: opts.counterparty, effective_date: opts.effectiveDate ?? "" }
+      counterparty_name: opts.counterparty,
+      effective_date: opts.effectiveDate ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
     });
     printSuccess(`Contract generated: ${result.contract_id ?? "OK"}`);
     printJson(result);
@@ -2145,7 +2309,6 @@ __export(agents_exports, {
   agentsSkillCommand: () => agentsSkillCommand
 });
 import chalk6 from "chalk";
-import Table2 from "cli-table3";
 async function agentsListCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
@@ -2164,13 +2327,8 @@ async function agentsShowCommand(agentId, opts) {
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
     const agent = await client.getAgent(agentId);
-    let usage = {};
-    try {
-      usage = await client.getAgentUsage(agentId);
-    } catch {
-    }
     if (opts.json) {
-      printJson({ agent, usage });
+      printJson(agent);
       return;
     }
     console.log(chalk6.magenta("\u2500".repeat(40)));
@@ -2185,12 +2343,8 @@ async function agentsShowCommand(agentId, opts) {
       if (prompt.length > 100) prompt = prompt.slice(0, 97) + "...";
       console.log(`  ${chalk6.bold("Prompt:")} ${prompt}`);
     }
-    if (Object.keys(usage).length > 0) {
-      console.log(`
-  ${chalk6.bold("Usage:")}`);
-      for (const [k, v] of Object.entries(usage)) {
-        if (k !== "agent_id") console.log(`    ${k}: ${v}`);
-      }
+    if (agent.skills && Array.isArray(agent.skills) && agent.skills.length > 0) {
+      console.log(`  ${chalk6.bold("Skills:")} ${agent.skills.map((s2) => s2.name ?? "?").join(", ")}`);
     }
     console.log(chalk6.magenta("\u2500".repeat(40)));
   } catch (err) {
@@ -2255,44 +2409,22 @@ async function agentsMessageCommand(agentId, opts) {
     process.exit(1);
   }
 }
-async function agentsExecutionsCommand(agentId, opts) {
-  const cfg = requireConfig("api_url", "api_key", "workspace_id");
-  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
-  try {
-    const executions = await client.listAgentExecutions(agentId);
-    if (opts.json) {
-      printJson(executions);
-      return;
-    }
-    if (executions.length === 0) {
-      console.log("No executions found.");
-      return;
-    }
-    console.log(`
-${chalk6.bold("Agent Executions")}`);
-    const table = new Table2({ head: [chalk6.dim("ID"), chalk6.dim("Status"), chalk6.dim("Started"), chalk6.dim("Duration")] });
-    for (const ex of executions) {
-      table.push([
-        String(ex.execution_id ?? "").slice(0, 12),
-        String(ex.status ?? ""),
-        String(ex.started_at ?? ""),
-        String(ex.duration ?? "")
-      ]);
-    }
-    console.log(table.toString());
-  } catch (err) {
-    printError(`Failed to fetch executions: ${err}`);
-    process.exit(1);
-  }
+async function agentsExecutionsCommand(agentId, _opts) {
+  printError(
+    `Listing executions is not yet supported.
+  To inspect a specific run, use the execution ID returned by "agents message":
+  GET /v1/agents/${agentId}/executions/<execution-id>`
+  );
+  process.exit(1);
 }
 async function agentsSkillCommand(agentId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
     const result = await client.addAgentSkill(agentId, {
-      skill_name: opts.name,
+      name: opts.name,
       description: opts.description,
-      instructions: opts.instructions ?? ""
+      parameters: opts.instructions ? { instructions: opts.instructions } : {}
     });
     printSuccess(`Skill '${opts.name}' added to agent ${agentId}.`);
     printJson(result);
@@ -2361,13 +2493,13 @@ ${url}`);
 async function billingUpgradeCommand(opts) {
   const client = makeClient();
   try {
-    const result = await client.createBillingCheckout(opts.tier);
+    const result = await client.createBillingCheckout(opts.plan);
     const url = result.checkout_url;
     if (!url) {
       printError("No checkout URL returned.");
       process.exit(1);
     }
-    console.log(`Opening Stripe Checkout for ${opts.tier}...
+    console.log(`Opening Stripe Checkout for ${opts.plan}...
 ${url}`);
     openUrl(url);
     printSuccess("Checkout opened in your browser.");
@@ -2385,45 +2517,6 @@ var init_billing = __esm({
   }
 });
 
-// src/commands/approvals.ts
-var approvals_exports = {};
-__export(approvals_exports, {
-  approvalsListCommand: () => approvalsListCommand,
-  approvalsRespondCommand: () => approvalsRespondCommand
-});
-async function approvalsListCommand(opts) {
-  const cfg = requireConfig("api_url", "api_key", "workspace_id");
-  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
-  try {
-    const approvals = await client.listPendingApprovals();
-    if (opts.json) printJson(approvals);
-    else if (approvals.length === 0) console.log("No pending approvals.");
-    else printApprovalsTable(approvals);
-  } catch (err) {
-    printError(`Failed to fetch approvals: ${err}`);
-    process.exit(1);
-  }
-}
-async function approvalsRespondCommand(approvalId, decision, opts) {
-  const cfg = requireConfig("api_url", "api_key", "workspace_id");
-  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
-  try {
-    await client.respondApproval(approvalId, decision, opts.message);
-    printSuccess(`Approval ${approvalId} ${decision}d.`);
-  } catch (err) {
-    printError(`Failed to respond to approval: ${err}`);
-    process.exit(1);
-  }
-}
-var init_approvals = __esm({
-  "src/commands/approvals.ts"() {
-    "use strict";
-    init_config();
-    init_api_client();
-    init_output();
-  }
-});
-
 // src/commands/form.ts
 var form_exports = {};
 __export(form_exports, {
@@ -2434,7 +2527,7 @@ __export(form_exports, {
 });
 import { input as input2, select, confirm as confirm2, number } from "@inquirer/prompts";
 import chalk7 from "chalk";
-import Table3 from "cli-table3";
+import Table2 from "cli-table3";
 function isCorp(entityType) {
   return entityType === "c_corp" || entityType === "s_corp" || entityType === "corporation";
 }
@@ -2458,13 +2551,12 @@ async function phaseEntityDetails(opts, serverCfg, scripted) {
     if (scripted) {
       entityType = "llc";
     } else {
-      const types = serverCfg.entity_types ?? ["llc", "c_corp"];
       entityType = await select({
         message: "Entity type",
-        choices: types.map((t) => ({
-          value: t,
-          name: t === "c_corp" ? "C Corporation" : t === "s_corp" ? "S Corporation" : t.toUpperCase()
-        }))
+        choices: [
+          { value: "llc", name: "LLC" },
+          { value: "c_corp", name: "C-Corp" }
+        ]
       });
     }
   }
@@ -2627,7 +2719,7 @@ function printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElecti
     console.log(`  ${chalk7.bold("Transfer Restrictions:")} ${transferRestrictions ? "Yes" : "No"}`);
     console.log(`  ${chalk7.bold("Right of First Refusal:")} ${rofr ? "Yes" : "No"}`);
   }
-  const table = new Table3({
+  const table = new Table2({
     head: [chalk7.dim("Name"), chalk7.dim("Email"), chalk7.dim("Role"), chalk7.dim("Equity"), chalk7.dim("Officer")]
   });
   for (const f of founders) {
@@ -2695,7 +2787,7 @@ async function formCommand(opts) {
     const holders = result.holders ?? [];
     if (holders.length > 0) {
       console.log();
-      const table = new Table3({
+      const table = new Table2({
         head: [chalk7.dim("Holder"), chalk7.dim("Shares"), chalk7.dim("Ownership %")]
       });
       for (const h of holders) {
@@ -2719,7 +2811,7 @@ async function formCreateCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const entityType = opts.type === "c_corp" || opts.type === "corporation" ? "corporation" : "llc";
+    const entityType = opts.type === "corporation" ? "c_corp" : opts.type;
     const payload = {
       entity_type: entityType,
       legal_name: opts.name
@@ -2779,7 +2871,7 @@ async function formFinalizeCommand(entityId) {
     const holders = result.holders ?? [];
     if (holders.length > 0) {
       console.log();
-      const table = new Table3({
+      const table = new Table2({
         head: [chalk7.dim("Holder"), chalk7.dim("Shares"), chalk7.dim("Ownership %")]
       });
       for (const h of holders) {
@@ -2813,7 +2905,7 @@ __export(api_keys_exports, {
   apiKeysCommand: () => apiKeysCommand
 });
 import chalk8 from "chalk";
-import Table4 from "cli-table3";
+import Table3 from "cli-table3";
 async function apiKeysCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
@@ -2829,7 +2921,7 @@ async function apiKeysCommand(opts) {
     }
     console.log(`
 ${chalk8.bold("API Keys")}`);
-    const table = new Table4({
+    const table = new Table3({
       head: [chalk8.dim("ID"), chalk8.dim("Name"), chalk8.dim("Key"), chalk8.dim("Created"), chalk8.dim("Last Used")]
     });
     for (const k of keys) {
@@ -2888,6 +2980,38 @@ var serve_exports = {};
 __export(serve_exports, {
   serveCommand: () => serveCommand
 });
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2 } from "fs";
+import { resolve } from "path";
+import { randomBytes } from "crypto";
+function generateFernetKey() {
+  return randomBytes(32).toString("base64url") + "=";
+}
+function generateSecret(length = 32) {
+  return randomBytes(length).toString("hex");
+}
+function loadEnvFile(path) {
+  if (!existsSync2(path)) return;
+  const content = readFileSync2(path, "utf-8");
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
+    if (!process.env[key]) {
+      process.env[key] = value;
+    }
+  }
+}
+function ensureEnvFile(envPath) {
+  if (existsSync2(envPath)) return;
+  console.log("No .env file found. Generating one with dev defaults...\n");
+  const content = ENV_TEMPLATE.replace("{{JWT_SECRET}}", generateSecret()).replace("{{SECRETS_MASTER_KEY}}", generateFernetKey()).replace("{{INTERNAL_WORKER_TOKEN}}", generateSecret());
+  writeFileSync2(envPath, content, "utf-8");
+  console.log(`  Created ${envPath}
+`);
+}
 async function serveCommand(opts) {
   let server;
   try {
@@ -2905,10 +3029,25 @@ async function serveCommand(opts) {
     process.exit(1);
   }
   const port = parseInt(opts.port, 10);
-  if (isNaN(port) || port < 1 || port > 65535) {
+  if (isNaN(port) || port > 65535) {
     console.error(`Error: Invalid port "${opts.port}"`);
     process.exit(1);
   }
+  const envPath = resolve(process.cwd(), ".env");
+  ensureEnvFile(envPath);
+  loadEnvFile(envPath);
+  const localUrl = `http://localhost:${port}`;
+  const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+  const cfg = loadConfig2();
+  const previousUrl = cfg.api_url;
+  if (cfg.api_url !== localUrl) {
+    cfg.api_url = localUrl;
+    saveConfig2(cfg);
+    console.log(`CLI configured to use local server: ${localUrl}`);
+    console.log(`  (previous: ${previousUrl})`);
+    console.log(`  To revert: corp config set api_url ${previousUrl}
+`);
+  }
   console.log(`Starting server on port ${port}...`);
   console.log(`Data directory: ${opts.dataDir}`);
   const child = server.startServer({
@@ -2917,6 +3056,12 @@ async function serveCommand(opts) {
   });
   const shutdown = () => {
     console.log("\nShutting down server...");
+    if (previousUrl !== localUrl) {
+      const current = loadConfig2();
+      current.api_url = previousUrl;
+      saveConfig2(current);
+      console.log(`CLI restored to: ${previousUrl}`);
+    }
     child.kill("SIGTERM");
   };
   process.on("SIGINT", shutdown);
@@ -2925,9 +3070,40 @@ async function serveCommand(opts) {
     process.exit(code ?? 0);
   });
 }
+var ENV_TEMPLATE;
 var init_serve = __esm({
   "src/commands/serve.ts"() {
     "use strict";
+    ENV_TEMPLATE = `# Corporation API server configuration
+# Generated by: corp serve
+
+# Required \u2014 secret for signing JWTs
+JWT_SECRET={{JWT_SECRET}}
+
+# Required \u2014 Fernet key for encrypting secrets at rest (base64url, 32 bytes)
+SECRETS_MASTER_KEY={{SECRETS_MASTER_KEY}}
+
+# Required \u2014 bearer token for internal worker-to-server auth
+INTERNAL_WORKER_TOKEN={{INTERNAL_WORKER_TOKEN}}
+
+# Server port (default: 8000)
+# PORT=8000
+
+# Data directory for git repos (default: ./data/repos)
+# DATA_DIR=./data/repos
+
+# Redis URL for agent job queue (optional)
+# REDIS_URL=redis://localhost:6379/0
+
+# LLM proxy upstream (default: https://openrouter.ai/api/v1)
+# LLM_UPSTREAM_URL=https://openrouter.ai/api/v1
+
+# PEM-encoded Ed25519 key for signing git commits (optional)
+# COMMIT_SIGNING_KEY=
+
+# Max agent queue depth (default: 1000)
+# MAX_QUEUE_DEPTH=1000
+`;
   }
 });
 
@@ -2948,15 +3124,15 @@ program.command("status").description("Workspace summary").action(async () => {
 });
 var configCmd = program.command("config").description("Manage configuration");
 configCmd.command("set <key> <value>").description("Set a config value (dot-path)").action(async (key, value) => {
-  const { configSetCommand: configSetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  const { configSetCommand: configSetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports2));
   configSetCommand2(key, value);
 });
 configCmd.command("get <key>").description("Get a config value (dot-path)").action(async (key) => {
-  const { configGetCommand: configGetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  const { configGetCommand: configGetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports2));
   configGetCommand2(key);
 });
 configCmd.command("list").description("List all config (API keys masked)").action(async () => {
-  const { configListCommand: configListCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  const { configListCommand: configListCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports2));
   configListCommand2();
 });
 program.command("obligations").description("List obligations with urgency tiers").option("--tier <tier>", "Filter by urgency tier").option("--json", "Output as JSON").action(async (opts) => {
@@ -2967,9 +3143,9 @@ program.command("digest").description("View or trigger daily digests").option("-
   const { digestCommand: digestCommand2 } = await Promise.resolve().then(() => (init_digest(), digest_exports));
   await digestCommand2(opts);
 });
-program.command("link").description("Generate a claim code to pair another device").action(async () => {
+program.command("link").description("Link workspace to an external provider").requiredOption("--external-id <id>", "External ID to link").requiredOption("--provider <provider>", "Provider name (e.g. stripe, github)").action(async (opts) => {
   const { linkCommand: linkCommand2 } = await Promise.resolve().then(() => (init_link(), link_exports));
-  await linkCommand2();
+  await linkCommand2(opts);
 });
 program.command("claim <code>").description("Redeem a claim code to join a workspace").action(async (code) => {
   const { claimCommand: claimCommand2 } = await Promise.resolve().then(() => (init_claim(), claim_exports));
@@ -2987,7 +3163,7 @@ entitiesCmd.command("show <entity-id>").option("--json", "Output as JSON").descr
   const { entitiesShowCommand: entitiesShowCommand2 } = await Promise.resolve().then(() => (init_entities(), entities_exports));
   await entitiesShowCommand2(entityId, opts);
 });
-entitiesCmd.command("convert <entity-id>").requiredOption("--to <type>", "Target entity type (llc, corporation)").option("--jurisdiction <jurisdiction>", "New jurisdiction").description("Convert entity to a different type").action(async (entityId, opts) => {
+entitiesCmd.command("convert <entity-id>").requiredOption("--to <type>", "Target entity type (llc, c_corp)").option("--jurisdiction <jurisdiction>", "New jurisdiction").description("Convert entity to a different type").action(async (entityId, opts) => {
   const { entitiesConvertCommand: entitiesConvertCommand2 } = await Promise.resolve().then(() => (init_entities(), entities_exports));
   await entitiesConvertCommand2(entityId, opts);
 });
@@ -2995,23 +3171,26 @@ entitiesCmd.command("dissolve <entity-id>").requiredOption("--reason <reason>",
   const { entitiesDissolveCommand: entitiesDissolveCommand2 } = await Promise.resolve().then(() => (init_entities(), entities_exports));
   await entitiesDissolveCommand2(entityId, opts);
 });
-var contactsCmd = program.command("contacts").description("Contact management").option("--json", "Output as JSON").action(async (opts) => {
+var contactsCmd = program.command("contacts").description("Contact management").option("--entity-id <id>", "Entity ID (overrides active entity)").option("--json", "Output as JSON").action(async (opts) => {
   const { contactsListCommand: contactsListCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
   await contactsListCommand2(opts);
 });
-contactsCmd.command("show <contact-id>").option("--json", "Output as JSON").description("Show contact detail/profile").action(async (contactId, opts) => {
+contactsCmd.command("show <contact-id>").option("--json", "Output as JSON").description("Show contact detail/profile").action(async (contactId, opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { contactsShowCommand: contactsShowCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
-  await contactsShowCommand2(contactId, opts);
+  await contactsShowCommand2(contactId, { ...opts, entityId: parent.entityId });
 });
-contactsCmd.command("add").requiredOption("--name <name>", "Contact name").requiredOption("--email <email>", "Contact email").option("--category <category>", "Contact category").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Add a new contact").action(async (opts) => {
+contactsCmd.command("add").requiredOption("--name <name>", "Contact name").requiredOption("--email <email>", "Contact email").option("--type <type>", "Contact type (individual, organization)", "individual").option("--category <category>", "Category (employee, contractor, board_member, investor, law_firm, valuation_firm, accounting_firm, officer, advisor)").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Add a new contact").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { contactsAddCommand: contactsAddCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
-  await contactsAddCommand2(opts);
+  await contactsAddCommand2({ ...opts, entityId: parent.entityId });
 });
-contactsCmd.command("edit <contact-id>").option("--name <name>", "Contact name").option("--email <email>", "Contact email").option("--category <category>", "Contact category").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Edit an existing contact").action(async (contactId, opts) => {
+contactsCmd.command("edit <contact-id>").option("--name <name>", "Contact name").option("--email <email>", "Contact email").option("--category <category>", "Contact category").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Edit an existing contact").action(async (contactId, opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { contactsEditCommand: contactsEditCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
-  await contactsEditCommand2(contactId, opts);
+  await contactsEditCommand2(contactId, { ...opts, entityId: parent.entityId });
 });
-var capTableCmd = program.command("cap-table").description("Cap table, SAFEs, transfers, valuations").option("--entity-id <id>", "Entity ID (overrides active entity)").option("--json", "Output as JSON").action(async (opts) => {
+var capTableCmd = program.command("cap-table").description("Cap table, equity grants, SAFEs, transfers, and valuations").option("--entity-id <id>", "Entity ID (overrides active entity)").option("--json", "Output as JSON").action(async (opts) => {
   const { capTableCommand: capTableCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await capTableCommand2(opts);
 });
@@ -3035,7 +3214,7 @@ capTableCmd.command("409a").description("Current 409A valuation").action(async (
   const { fourOhNineACommand: fourOhNineACommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await fourOhNineACommand2(parent);
 });
-capTableCmd.command("issue-equity").requiredOption("--grant-type <type>", "Grant type").requiredOption("--shares <n>", "Number of shares", parseInt).requiredOption("--recipient <name>", "Recipient name").description("Issue an equity grant").action(async (opts, cmd) => {
+capTableCmd.command("issue-equity").requiredOption("--grant-type <type>", "Grant type (e.g. founder, advisor, employee, investor)").requiredOption("--shares <n>", "Number of shares", parseInt).requiredOption("--recipient <name>", "Recipient name").option("--email <email>", "Recipient email (auto-creates contact if needed)").option("--instrument-id <id>", "Instrument ID (auto-detected from cap table if omitted)").description("Issue an equity grant (creates a round, adds security, and issues it)").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { issueEquityCommand: issueEquityCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await issueEquityCommand2({ ...opts, entityId: parent.entityId });
@@ -3045,12 +3224,12 @@ capTableCmd.command("issue-safe").requiredOption("--investor <name>", "Investor
   const { issueSafeCommand: issueSafeCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await issueSafeCommand2({ ...opts, entityId: parent.entityId });
 });
-capTableCmd.command("transfer").requiredOption("--from-grant <id>", "Source grant ID").requiredOption("--to <name>", "Recipient name").requiredOption("--shares <n>", "Number of shares", parseInt).option("--type <type>", "Transfer type", "sale").description("Transfer shares").action(async (opts, cmd) => {
+capTableCmd.command("transfer").requiredOption("--from <id>", "Source contact ID (from_contact_id)").requiredOption("--to <id>", "Destination contact ID (to_contact_id)").requiredOption("--shares <n>", "Number of shares to transfer", parseInt).requiredOption("--share-class-id <id>", "Share class ID").requiredOption("--governing-doc-type <type>", "Governing document type").requiredOption("--transferee-rights <rights>", "Transferee rights").requiredOption("--prepare-intent-id <id>", "Prepare intent ID").option("--type <type>", "Transfer type", "sale").option("--price-per-share-cents <n>", "Price per share in cents", parseInt).option("--relationship <rel>", "Relationship to holder").description("Create a share transfer workflow").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { transferSharesCommand: transferSharesCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await transferSharesCommand2({ ...opts, entityId: parent.entityId });
 });
-capTableCmd.command("distribute").requiredOption("--amount <n>", "Total distribution amount in cents", parseInt).option("--type <type>", "Distribution type", "pro_rata").description("Calculate a distribution").action(async (opts, cmd) => {
+capTableCmd.command("distribute").requiredOption("--amount <n>", "Total distribution amount in cents", parseInt).option("--type <type>", "Distribution type (dividend, return, liquidation)", "dividend").requiredOption("--description <desc>", "Distribution description").description("Calculate a distribution").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { distributeCommand: distributeCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await distributeCommand2({ ...opts, entityId: parent.entityId });
@@ -3120,6 +3299,15 @@ var governanceCmd = program.command("governance").description("Governance bodies
   const { governanceListCommand: governanceListCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceListCommand2(opts);
 });
+governanceCmd.command("create-body").requiredOption("--name <name>", "Body name (e.g. 'Board of Directors')").requiredOption("--body-type <type>", "Body type (board_of_directors, llc_member_vote)").option("--quorum <rule>", "Quorum rule (majority, supermajority, unanimous)", "majority").option("--voting <method>", "Voting method (per_capita, per_unit)", "per_capita").description("Create a governance body").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { governanceCreateBodyCommand: governanceCreateBodyCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await governanceCreateBodyCommand2({ ...opts, entityId: parent.entityId });
+});
+governanceCmd.command("add-seat <body-id>").requiredOption("--holder <contact-id>", "Contact ID for the seat holder").option("--title <title>", "Seat title (e.g. 'Director', 'Member')").description("Add a seat to a governance body").action(async (bodyId, opts) => {
+  const { governanceAddSeatCommand: governanceAddSeatCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await governanceAddSeatCommand2(bodyId, opts);
+});
 governanceCmd.command("seats <body-id>").description("Seats for a governance body").action(async (bodyId, _opts, cmd) => {
   const parent = cmd.parent.opts();
   const { governanceSeatsCommand: governanceSeatsCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
@@ -3140,7 +3328,7 @@ governanceCmd.command("convene").requiredOption("--body <id>", "Governance body
   const { governanceConveneCommand: governanceConveneCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceConveneCommand2({ ...opts, meetingType: opts.type, entityId: parent.entityId });
 });
-governanceCmd.command("vote <meeting-id> <item-id>").requiredOption("--voter <name>", "Voter name/ID").requiredOption("--vote <value>", "Vote (yea, nay, abstain)").description("Cast a vote on an agenda item").action(async (meetingId, itemId, opts) => {
+governanceCmd.command("vote <meeting-id> <item-id>").requiredOption("--voter <id>", "Voter contact UUID").requiredOption("--vote <value>", "Vote (for, against, abstain, recusal)").description("Cast a vote on an agenda item").action(async (meetingId, itemId, opts) => {
   const { governanceVoteCommand: governanceVoteCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceVoteCommand2(meetingId, itemId, opts);
 });
@@ -3164,7 +3352,7 @@ governanceCmd.command("agenda-items <meeting-id>").description("List agenda item
   const { listAgendaItemsCommand: listAgendaItemsCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await listAgendaItemsCommand2(meetingId, { entityId: parent.entityId, json: parent.json });
 });
-governanceCmd.command("finalize-item <meeting-id> <item-id>").requiredOption("--status <status>", "Status: Voted, Discussed, Tabled, or Withdrawn").description("Finalize an agenda item").action(async (meetingId, itemId, opts, cmd) => {
+governanceCmd.command("finalize-item <meeting-id> <item-id>").requiredOption("--status <status>", "Status: voted, discussed, tabled, or withdrawn").description("Finalize an agenda item").action(async (meetingId, itemId, opts, cmd) => {
   const parent = cmd.parent.opts();
   const { finalizeAgendaItemCommand: finalizeAgendaItemCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await finalizeAgendaItemCommand2(meetingId, itemId, { ...opts, entityId: parent.entityId });
@@ -3183,11 +3371,12 @@ var documentsCmd = program.command("documents").description("Documents and signi
   const { documentsListCommand: documentsListCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsListCommand2(opts);
 });
-documentsCmd.command("signing-link <doc-id>").description("Get a signing link for a document").action(async (docId) => {
+documentsCmd.command("signing-link <doc-id>").description("Get a signing link for a document").action(async (docId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { documentsSigningLinkCommand: documentsSigningLinkCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
-  await documentsSigningLinkCommand2(docId);
+  await documentsSigningLinkCommand2(docId, { entityId: parent.entityId });
 });
-documentsCmd.command("generate").requiredOption("--template <type>", "Template type").requiredOption("--counterparty <name>", "Counterparty name").option("--effective-date <date>", "Effective date (ISO 8601)").description("Generate a contract from a template").action(async (opts, cmd) => {
+documentsCmd.command("generate").requiredOption("--template <type>", "Template type (consulting_agreement, employment_offer, contractor_agreement, nda, custom)").requiredOption("--counterparty <name>", "Counterparty name").option("--effective-date <date>", "Effective date (ISO 8601, defaults to today)").description("Generate a contract from a template").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { documentsGenerateCommand: documentsGenerateCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsGenerateCommand2({ ...opts, entityId: parent.entityId });
@@ -3252,23 +3441,19 @@ billingCmd.command("portal").description("Open Stripe Customer Portal").action(a
   const { billingPortalCommand: billingPortalCommand2 } = await Promise.resolve().then(() => (init_billing(), billing_exports));
   await billingPortalCommand2();
 });
-billingCmd.command("upgrade").option("--tier <tier>", "Plan to upgrade to", "cloud").description("Open Stripe Checkout to upgrade your plan").action(async (opts) => {
+billingCmd.command("upgrade").option("--plan <plan>", "Plan ID to upgrade to (free, pro, enterprise)", "pro").description("Open Stripe Checkout to upgrade your plan").action(async (opts) => {
   const { billingUpgradeCommand: billingUpgradeCommand2 } = await Promise.resolve().then(() => (init_billing(), billing_exports));
   await billingUpgradeCommand2(opts);
 });
-var approvalsCmd = program.command("approvals").description("Pending approvals and responses").option("--json", "Output as JSON").action(async (opts) => {
-  const { approvalsListCommand: approvalsListCommand2 } = await Promise.resolve().then(() => (init_approvals(), approvals_exports));
-  await approvalsListCommand2(opts);
-});
-approvalsCmd.command("approve <approval-id>").option("--message <msg>", "Optional message").description("Approve a pending approval").action(async (approvalId, opts) => {
-  const { approvalsRespondCommand: approvalsRespondCommand2 } = await Promise.resolve().then(() => (init_approvals(), approvals_exports));
-  await approvalsRespondCommand2(approvalId, "approve", opts);
-});
-approvalsCmd.command("reject <approval-id>").option("--message <msg>", "Optional message").description("Reject a pending approval").action(async (approvalId, opts) => {
-  const { approvalsRespondCommand: approvalsRespondCommand2 } = await Promise.resolve().then(() => (init_approvals(), approvals_exports));
-  await approvalsRespondCommand2(approvalId, "reject", opts);
+program.command("approvals").description("Approvals are managed through governance meetings and execution intents").action(async () => {
+  const { printError: printError2 } = await Promise.resolve().then(() => (init_output(), output_exports));
+  printError2(
+    "Approvals are managed through governance meetings.\n  Use: corp governance convene ... to schedule a board meeting\n  Use: corp governance vote <meeting-id> <item-id> ... to cast votes"
+  );
 });
-var formCmd = program.command("form").description("Form a new entity with founders and cap table (Cooley-style)").option("--type <type>", "Entity type (llc, c_corp)").option("--name <name>", "Legal name").option("--jurisdiction <jurisdiction>", "Jurisdiction (e.g. US-DE, US-WY)").option("--member <member>", "Member as 'name,email,role[,pct]' \u2014 role: director|officer|manager|member|chair (repeatable)", (v, a) => [...a, v], []).option("--address <address>", "Company address as 'street,city,state,zip'").option("--fiscal-year-end <date>", "Fiscal year end (MM-DD)", "12-31").option("--s-corp", "Elect S-Corp status").option("--transfer-restrictions", "Enable transfer restrictions").option("--rofr", "Enable right of first refusal").action(async (opts) => {
+var formCmd = program.command("form").description("Form a new entity with founders and cap table (Cooley-style)").option("--entity-type <type>", "Entity type (llc, c_corp)").option("--legal-name <name>", "Legal name").option("--jurisdiction <jurisdiction>", "Jurisdiction (e.g. US-DE, US-WY)").option("--member <member>", "Member as 'name,email,role[,pct]' \u2014 role: director|officer|manager|member|chair (repeatable)", (v, a) => [...a, v], []).option("--address <address>", "Company address as 'street,city,state,zip'").option("--fiscal-year-end <date>", "Fiscal year end (MM-DD)", "12-31").option("--s-corp", "Elect S-Corp status").option("--transfer-restrictions", "Enable transfer restrictions").option("--rofr", "Enable right of first refusal").action(async (opts) => {
+  if (opts.entityType && !opts.type) opts.type = opts.entityType;
+  if (opts.legalName && !opts.name) opts.name = opts.legalName;
   const { formCommand: formCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
   await formCommand2(opts);
 });