@thecorporation/cli 1.0.5 → 26.3.2

package/dist/index.js

@@ -1154,7 +1154,7 @@ ${chalk2.bold("Chat Slash Commands")}
           break;
         }
         for (const tc of response.tool_calls) {
-          console.log(chalk2.dim(`  ${isWriteTool(tc.name) ? "\u2699" : "\u2139"} ${tc.name}(${JSON.stringify(tc.arguments).slice(0, 80)})`));
+          console.log(chalk2.dim(`  ${isWriteTool(tc.name, tc.arguments) ? "\u2699" : "\u2139"} ${tc.name}(${JSON.stringify(tc.arguments).slice(0, 80)})`));
           const result = await executeTool(tc.name, tc.arguments, client);
           const short = result.length > 200 ? result.slice(0, 197) + "..." : result;
           console.log(chalk2.dim(`    => ${short}`));
@@ -1382,12 +1382,18 @@ var init_contacts = __esm({
 // src/commands/cap-table.ts
 var cap_table_exports = {};
 __export(cap_table_exports, {
+  addSecurityCommand: () => addSecurityCommand,
+  approveValuationCommand: () => approveValuationCommand,
   capTableCommand: () => capTableCommand,
+  createValuationCommand: () => createValuationCommand,
   distributeCommand: () => distributeCommand,
   fourOhNineACommand: () => fourOhNineACommand,
   issueEquityCommand: () => issueEquityCommand,
+  issueRoundCommand: () => issueRoundCommand,
   issueSafeCommand: () => issueSafeCommand,
   safesCommand: () => safesCommand,
+  startRoundCommand: () => startRoundCommand,
+  submitValuationCommand: () => submitValuationCommand,
   transferSharesCommand: () => transferSharesCommand,
   transfersCommand: () => transfersCommand,
   valuationsCommand: () => valuationsCommand
@@ -1547,6 +1553,108 @@ async function distributeCommand(opts) {
     process.exit(1);
   }
 }
+async function startRoundCommand(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.startEquityRound({
+      entity_id: eid,
+      name: opts.name,
+      issuer_legal_entity_id: opts.issuerLegalEntityId
+    });
+    printSuccess(`Round started: ${result.round_id ?? "OK"}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to start round: ${err}`);
+    process.exit(1);
+  }
+}
+async function addSecurityCommand(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 body = {
+      entity_id: eid,
+      instrument_id: opts.instrumentId,
+      quantity: opts.quantity,
+      recipient_name: opts.recipientName
+    };
+    if (opts.holderId) body.holder_id = opts.holderId;
+    if (opts.email) body.email = opts.email;
+    if (opts.principalCents) body.principal_cents = opts.principalCents;
+    if (opts.grantType) body.grant_type = opts.grantType;
+    const result = await client.addRoundSecurity(opts.roundId, body);
+    printSuccess(`Security added for ${opts.recipientName}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to add security: ${err}`);
+    process.exit(1);
+  }
+}
+async function issueRoundCommand(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.issueRound(opts.roundId, { entity_id: eid });
+    printSuccess("Round issued and closed");
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to issue round: ${err}`);
+    process.exit(1);
+  }
+}
+async function createValuationCommand(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 body = {
+      entity_id: eid,
+      valuation_type: opts.type,
+      effective_date: opts.date,
+      methodology: opts.methodology
+    };
+    if (opts.fmv != null) body.fmv_per_share_cents = opts.fmv;
+    if (opts.enterpriseValue != null) body.enterprise_value_cents = opts.enterpriseValue;
+    const result = await client.createValuation(body);
+    printSuccess(`Valuation created: ${result.valuation_id ?? "OK"}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to create valuation: ${err}`);
+    process.exit(1);
+  }
+}
+async function submitValuationCommand(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.submitValuationForApproval(opts.valuationId, eid);
+    printSuccess(`Valuation submitted for approval: ${result.valuation_id ?? "OK"}`);
+    if (result.meeting_id) console.log(`  Meeting: ${result.meeting_id}`);
+    if (result.agenda_item_id) console.log(`  Agenda Item: ${result.agenda_item_id}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to submit valuation: ${err}`);
+    process.exit(1);
+  }
+}
+async function approveValuationCommand(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.approveValuation(opts.valuationId, eid, opts.resolutionId);
+    printSuccess(`Valuation approved: ${result.valuation_id ?? "OK"}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to approve valuation: ${err}`);
+    process.exit(1);
+  }
+}
 function print409a(data) {
   console.log(chalk5.green("\u2500".repeat(40)));
   console.log(chalk5.green.bold("  409A Valuation"));
@@ -1693,12 +1801,19 @@ var init_finance = __esm({
 // src/commands/governance.ts
 var governance_exports = {};
 __export(governance_exports, {
+  adjournMeetingCommand: () => adjournMeetingCommand,
+  cancelMeetingCommand: () => cancelMeetingCommand,
+  computeResolutionCommand: () => computeResolutionCommand,
+  finalizeAgendaItemCommand: () => finalizeAgendaItemCommand,
   governanceConveneCommand: () => governanceConveneCommand,
   governanceListCommand: () => governanceListCommand,
   governanceMeetingsCommand: () => governanceMeetingsCommand,
   governanceResolutionsCommand: () => governanceResolutionsCommand,
   governanceSeatsCommand: () => governanceSeatsCommand,
-  governanceVoteCommand: () => governanceVoteCommand
+  governanceVoteCommand: () => governanceVoteCommand,
+  listAgendaItemsCommand: () => listAgendaItemsCommand,
+  sendNoticeCommand: () => sendNoticeCommand,
+  writtenConsentCommand: () => writtenConsentCommand
 });
 async function governanceListCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
@@ -1789,6 +1904,108 @@ async function governanceVoteCommand(meetingId, itemId, opts) {
     process.exit(1);
   }
 }
+async function sendNoticeCommand(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 result = await client.sendNotice(meetingId, eid);
+    printSuccess(`Notice sent for meeting ${meetingId}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to send notice: ${err}`);
+    process.exit(1);
+  }
+}
+async function adjournMeetingCommand(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 result = await client.adjournMeeting(meetingId, eid);
+    printSuccess(`Meeting ${meetingId} adjourned`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to adjourn meeting: ${err}`);
+    process.exit(1);
+  }
+}
+async function cancelMeetingCommand(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 result = await client.cancelMeeting(meetingId, eid);
+    printSuccess(`Meeting ${meetingId} cancelled`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to cancel meeting: ${err}`);
+    process.exit(1);
+  }
+}
+async function finalizeAgendaItemCommand(meetingId, itemId, 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.finalizeAgendaItem(meetingId, itemId, {
+      entity_id: eid,
+      status: opts.status
+    });
+    printSuccess(`Agenda item ${itemId} finalized as ${opts.status}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to finalize agenda item: ${err}`);
+    process.exit(1);
+  }
+}
+async function computeResolutionCommand(meetingId, itemId, 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.computeResolution(meetingId, itemId, eid, {
+      resolution_text: opts.text
+    });
+    printSuccess(`Resolution computed for agenda item ${itemId}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to compute resolution: ${err}`);
+    process.exit(1);
+  }
+}
+async function writtenConsentCommand(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.writtenConsent({
+      entity_id: eid,
+      body_id: opts.body,
+      title: opts.title,
+      description: opts.description
+    });
+    printSuccess(`Written consent created: ${result.meeting_id ?? "OK"}`);
+    printJson(result);
+  } catch (err) {
+    printError(`Failed to create written consent: ${err}`);
+    process.exit(1);
+  }
+}
+async function listAgendaItemsCommand(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 items = await client.listAgendaItems(meetingId, eid);
+    if (opts.json) printJson(items);
+    else if (items.length === 0) console.log("No agenda items found.");
+    else printJson(items);
+  } catch (err) {
+    printError(`Failed to list agenda items: ${err}`);
+    process.exit(1);
+  }
+}
 var init_governance = __esm({
   "src/commands/governance.ts"() {
     "use strict";
@@ -1803,6 +2020,7 @@ var documents_exports = {};
 __export(documents_exports, {
   documentsGenerateCommand: () => documentsGenerateCommand,
   documentsListCommand: () => documentsListCommand,
+  documentsPreviewPdfCommand: () => documentsPreviewPdfCommand,
   documentsSigningLinkCommand: () => documentsSigningLinkCommand
 });
 async function documentsListCommand(opts) {
@@ -1848,6 +2066,15 @@ async function documentsGenerateCommand(opts) {
     process.exit(1);
   }
 }
+async function documentsPreviewPdfCommand(opts) {
+  const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
+  const apiUrl = cfg.api_url.replace(/\/+$/, "");
+  const qs = new URLSearchParams({ entity_id: eid, document_id: opts.documentId }).toString();
+  const url = `${apiUrl}/v1/documents/preview/pdf?${qs}`;
+  printSuccess(`Preview PDF URL: ${url}`);
+  console.log("Use your API key to authenticate the download.");
+}
 var init_documents = __esm({
   "src/commands/documents.ts"() {
     "use strict";
@@ -2200,9 +2427,215 @@ var init_approvals = __esm({
 // src/commands/form.ts
 var form_exports = {};
 __export(form_exports, {
-  formCommand: () => formCommand
+  formAddFounderCommand: () => formAddFounderCommand,
+  formCommand: () => formCommand,
+  formCreateCommand: () => formCreateCommand,
+  formFinalizeCommand: () => formFinalizeCommand
 });
-import { input as input2, select } from "@inquirer/prompts";
+import { input as input2, select, confirm as confirm2, number } from "@inquirer/prompts";
+import chalk7 from "chalk";
+import Table3 from "cli-table3";
+function isCorp(entityType) {
+  return entityType === "c_corp" || entityType === "s_corp" || entityType === "corporation";
+}
+function sectionHeader(title) {
+  console.log();
+  console.log(chalk7.blue("\u2500".repeat(50)));
+  console.log(chalk7.blue.bold(`  ${title}`));
+  console.log(chalk7.blue("\u2500".repeat(50)));
+}
+async function promptAddress() {
+  const street = await input2({ message: "    Street address" });
+  const city = await input2({ message: "    City" });
+  const state = await input2({ message: "    State (2-letter)", default: "DE" });
+  const zip = await input2({ message: "    ZIP code" });
+  return { street, city, state, zip };
+}
+async function phaseEntityDetails(opts, serverCfg, scripted) {
+  if (!scripted) sectionHeader("Phase 1: Entity Details");
+  let entityType = opts.type;
+  if (!entityType) {
+    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()
+        }))
+      });
+    }
+  }
+  let name = opts.name;
+  if (!name) {
+    if (scripted) {
+      printError("--name is required in scripted mode");
+      process.exit(1);
+    }
+    name = await input2({ message: "Legal name" });
+  }
+  let jurisdiction = opts.jurisdiction;
+  if (!jurisdiction) {
+    const defaultJ = entityType === "llc" ? "US-WY" : "US-DE";
+    if (scripted) {
+      jurisdiction = defaultJ;
+    } else {
+      jurisdiction = await input2({ message: "Jurisdiction", default: defaultJ });
+    }
+  }
+  let companyAddress;
+  if (opts.address) {
+    const parts = opts.address.split(",").map((p) => p.trim());
+    if (parts.length === 4) {
+      companyAddress = { street: parts[0], city: parts[1], state: parts[2], zip: parts[3] };
+    }
+  }
+  if (!companyAddress && !scripted) {
+    const wantAddress = await confirm2({ message: "Add company address?", default: false });
+    if (wantAddress) {
+      companyAddress = await promptAddress();
+    }
+  }
+  const fiscalYearEnd = opts.fiscalYearEnd ?? "12-31";
+  let sCorpElection = opts.sCorp ?? false;
+  if (!scripted && isCorp(entityType) && opts.sCorp === void 0) {
+    sCorpElection = await confirm2({ message: "S-Corp election?", default: false });
+  }
+  return { entityType, name, jurisdiction, companyAddress, fiscalYearEnd, sCorpElection };
+}
+async function phasePeople(opts, entityType, scripted) {
+  if (!scripted) sectionHeader("Phase 2: Founders & Officers");
+  const founders = [];
+  if (scripted) {
+    for (const m of opts.member) {
+      const parts = m.split(",").map((p) => p.trim());
+      if (parts.length < 3) {
+        printError(`Invalid member format: ${m}. Expected: name,email,role[,pct]`);
+        process.exit(1);
+      }
+      const f = { name: parts[0], email: parts[1], role: parts[2] };
+      if (parts.length >= 4) f.ownership_pct = parseFloat(parts[3]);
+      founders.push(f);
+    }
+    return founders;
+  }
+  const founderCount = await number({ message: "Number of founders (1-6)", default: 1 }) ?? 1;
+  for (let i = 0; i < founderCount; i++) {
+    console.log(chalk7.dim(`
+  Founder ${i + 1} of ${founderCount}:`));
+    const name = await input2({ message: `  Name` });
+    const email = await input2({ message: `  Email` });
+    let role = "member";
+    if (isCorp(entityType)) {
+      role = await select({
+        message: "  Role",
+        choices: [
+          { value: "director", name: "Director" },
+          { value: "officer", name: "Officer" },
+          { value: "member", name: "Shareholder only" }
+        ]
+      });
+    }
+    const wantAddress = await confirm2({ message: "  Add address?", default: false });
+    const address = wantAddress ? await promptAddress() : void 0;
+    let officerTitle;
+    if (isCorp(entityType)) {
+      const wantOfficer = role === "officer" || await confirm2({ message: "  Assign officer title?", default: i === 0 });
+      if (wantOfficer) {
+        officerTitle = await select({
+          message: "  Officer title",
+          choices: [
+            { value: "ceo", name: "CEO" },
+            { value: "cfo", name: "CFO" },
+            { value: "secretary", name: "Secretary" },
+            { value: "president", name: "President" },
+            { value: "vp", name: "VP" }
+          ]
+        });
+      }
+    }
+    let isIncorporator = false;
+    if (isCorp(entityType) && i === 0 && founderCount === 1) {
+      isIncorporator = true;
+    } else if (isCorp(entityType)) {
+      isIncorporator = await confirm2({ message: "  Designate as sole incorporator?", default: i === 0 });
+    }
+    founders.push({ name, email, role, address, officer_title: officerTitle, is_incorporator: isIncorporator });
+  }
+  return founders;
+}
+async function phaseStock(opts, entityType, founders, scripted) {
+  if (!scripted) sectionHeader("Phase 3: Equity & Finalize");
+  const transferRestrictions = opts.transferRestrictions ?? (!scripted && isCorp(entityType) ? await confirm2({ message: "Transfer restrictions on shares?", default: true }) : isCorp(entityType));
+  const rofr = opts.rofr ?? (!scripted && isCorp(entityType) ? await confirm2({ message: "Right of first refusal?", default: true }) : isCorp(entityType));
+  if (!scripted) {
+    for (const f of founders) {
+      console.log(chalk7.dim(`
+  Equity for ${f.name}:`));
+      if (isCorp(entityType)) {
+        const shares = await number({ message: `  Shares to purchase`, default: 0 });
+        f.shares_purchased = shares ?? 0;
+        if (f.shares_purchased === 0) {
+          const pct = await number({ message: `  Ownership % (1-100)`, default: founders.length === 1 ? 100 : 0 });
+          f.ownership_pct = pct ?? 0;
+        }
+      } else {
+        const pct = await number({
+          message: `  Ownership % (1-100)`,
+          default: founders.length === 1 ? 100 : 0
+        });
+        f.ownership_pct = pct ?? 0;
+      }
+      if (isCorp(entityType)) {
+        const wantVesting = await confirm2({ message: "  Add vesting schedule?", default: false });
+        if (wantVesting) {
+          const totalMonths = await number({ message: "  Total vesting months", default: 48 }) ?? 48;
+          const cliffMonths = await number({ message: "  Cliff months", default: 12 }) ?? 12;
+          const acceleration = await select({
+            message: "  Acceleration",
+            choices: [
+              { value: "none", name: "None" },
+              { value: "single_trigger", name: "Single trigger" },
+              { value: "double_trigger", name: "Double trigger" }
+            ]
+          });
+          f.vesting = {
+            total_months: totalMonths,
+            cliff_months: cliffMonths,
+            acceleration: acceleration === "none" ? void 0 : acceleration
+          };
+        }
+      }
+      const wantIp = await confirm2({ message: "  Contributing IP?", default: false });
+      if (wantIp) {
+        f.ip_description = await input2({ message: "  Describe IP being contributed" });
+      }
+    }
+  }
+  return { founders, transferRestrictions, rofr };
+}
+function printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElection, founders, transferRestrictions, rofr) {
+  sectionHeader("Formation Summary");
+  console.log(`  ${chalk7.bold("Entity:")} ${name}`);
+  console.log(`  ${chalk7.bold("Type:")} ${entityType}`);
+  console.log(`  ${chalk7.bold("Jurisdiction:")} ${jurisdiction}`);
+  console.log(`  ${chalk7.bold("Fiscal Year End:")} ${fiscalYearEnd}`);
+  if (isCorp(entityType)) {
+    console.log(`  ${chalk7.bold("S-Corp Election:")} ${sCorpElection ? "Yes" : "No"}`);
+    console.log(`  ${chalk7.bold("Transfer Restrictions:")} ${transferRestrictions ? "Yes" : "No"}`);
+    console.log(`  ${chalk7.bold("Right of First Refusal:")} ${rofr ? "Yes" : "No"}`);
+  }
+  const table = new Table3({
+    head: [chalk7.dim("Name"), chalk7.dim("Email"), chalk7.dim("Role"), chalk7.dim("Equity"), chalk7.dim("Officer")]
+  });
+  for (const f of founders) {
+    const equity = f.shares_purchased ? `${f.shares_purchased.toLocaleString()} shares` : f.ownership_pct ? `${f.ownership_pct}%` : "\u2014";
+    table.push([f.name, f.email, f.role, equity, f.officer_title ?? "\u2014"]);
+  }
+  console.log(table.toString());
+}
 async function formCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
@@ -2212,69 +2645,159 @@ async function formCommand(opts) {
       serverCfg = await client.getConfig();
     } catch {
     }
-    let entityType = opts.type;
-    if (!entityType) {
-      const types = serverCfg.entity_types ?? ["llc", "c_corp", "s_corp"];
-      entityType = await select({ message: "Entity type", choices: types.map((t) => ({ value: t, name: t })) });
+    const scripted = !!(opts.member && opts.member.length > 0);
+    const { entityType, name, jurisdiction, companyAddress, fiscalYearEnd, sCorpElection } = await phaseEntityDetails(opts, serverCfg, scripted);
+    const founders = await phasePeople(opts, entityType, scripted);
+    const { transferRestrictions, rofr } = await phaseStock(opts, entityType, founders, scripted);
+    printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElection, founders, transferRestrictions, rofr);
+    const shouldProceed = scripted ? true : await confirm2({ message: "Proceed with formation?", default: true });
+    if (!shouldProceed) {
+      console.log(chalk7.yellow("Formation cancelled."));
+      return;
     }
-    let name = opts.name;
-    if (!name) {
-      name = await input2({ message: "Entity name" });
+    const members = founders.map((f) => {
+      const m = {
+        name: f.name,
+        email: f.email,
+        role: f.role,
+        investor_type: "natural_person"
+      };
+      if (f.ownership_pct) m.ownership_pct = f.ownership_pct;
+      if (f.shares_purchased) m.shares_purchased = f.shares_purchased;
+      if (f.address) m.address = f.address;
+      if (f.officer_title) m.officer_title = f.officer_title;
+      if (f.is_incorporator) m.is_incorporator = true;
+      if (f.vesting) m.vesting = f.vesting;
+      if (f.ip_description) m.ip_description = f.ip_description;
+      return m;
+    });
+    const payload = {
+      entity_type: entityType,
+      legal_name: name,
+      jurisdiction,
+      members,
+      workspace_id: cfg.workspace_id,
+      fiscal_year_end: fiscalYearEnd,
+      s_corp_election: sCorpElection,
+      transfer_restrictions: transferRestrictions,
+      right_of_first_refusal: rofr
+    };
+    if (companyAddress) payload.company_address = companyAddress;
+    const result = await client.createFormationWithCapTable(payload);
+    printSuccess(`Formation created: ${result.formation_id ?? result.id ?? "OK"}`);
+    if (result.entity_id) console.log(`  Entity ID: ${result.entity_id}`);
+    if (result.legal_entity_id) console.log(`  Legal Entity ID: ${result.legal_entity_id}`);
+    if (result.instrument_id) console.log(`  Instrument ID: ${result.instrument_id}`);
+    const docIds = result.document_ids ?? [];
+    if (docIds.length > 0) {
+      console.log(`  Documents: ${docIds.length} generated`);
     }
-    let jurisdiction = opts.jurisdiction;
-    if (!jurisdiction) {
-      const jurisdictions = serverCfg.jurisdictions ?? ["DE", "WY", "NV", "CA"];
-      jurisdiction = await select({
-        message: "Jurisdiction",
-        choices: jurisdictions.map((j) => ({ value: j, name: j })),
-        default: "DE"
+    const holders = result.holders ?? [];
+    if (holders.length > 0) {
+      console.log();
+      const table = new Table3({
+        head: [chalk7.dim("Holder"), chalk7.dim("Shares"), chalk7.dim("Ownership %")]
       });
-    }
-    const parsedMembers = [];
-    if (opts.member && opts.member.length > 0) {
-      for (const m of opts.member) {
-        const parts = m.split(",").map((p) => p.trim());
-        if (parts.length < 3) {
-          printError(`Invalid member format: ${m}. Expected: name,email,role[,ownership_pct]`);
-          process.exit(1);
-        }
-        const member = { name: parts[0], email: parts[1], role: parts[2] };
-        if (parts.length >= 4) member.ownership_pct = parseFloat(parts[3]);
-        parsedMembers.push(member);
-      }
-    } else {
-      console.log("Add members (leave name blank to finish):");
-      while (true) {
-        const mname = await input2({ message: "  Member name (blank to finish)", default: "" });
-        if (!mname) break;
-        const memail = await input2({ message: "  Email" });
-        const mrole = await input2({ message: "  Role", default: "founder" });
-        const mpctStr = await input2({ message: "  Ownership %", default: "0" });
-        parsedMembers.push({
-          name: mname,
-          email: memail,
-          role: mrole,
-          ownership_pct: parseFloat(mpctStr)
-        });
+      for (const h of holders) {
+        const pct = typeof h.ownership_pct === "number" ? `${h.ownership_pct.toFixed(1)}%` : "\u2014";
+        table.push([String(h.name ?? "?"), String(h.shares ?? 0), pct]);
       }
+      console.log(chalk7.bold("  Cap Table:"));
+      console.log(table.toString());
     }
-    for (const m of parsedMembers) {
-      if (!m.investor_type) m.investor_type = "natural_person";
+    if (result.next_action) {
+      console.log(chalk7.yellow(`
+  Next: ${result.next_action}`));
     }
-    const result = await client.createFormation({
-      entity_type: entityType,
-      legal_name: name,
-      jurisdiction,
-      members: parsedMembers
-    });
-    printSuccess(`Formation created: ${result.formation_id ?? result.id ?? "OK"}`);
-    if (result.entity_id) console.log(`Entity ID: ${result.entity_id}`);
   } catch (err) {
     if (err instanceof Error && err.message.includes("exit")) throw err;
     printError(`Failed to create formation: ${err}`);
     process.exit(1);
   }
 }
+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 payload = {
+      entity_type: entityType,
+      legal_name: opts.name
+    };
+    if (opts.jurisdiction) payload.jurisdiction = opts.jurisdiction;
+    const result = await client.createPendingEntity(payload);
+    printSuccess(`Pending entity created: ${result.entity_id}`);
+    console.log(`  Name: ${result.legal_name}`);
+    console.log(`  Type: ${result.entity_type}`);
+    console.log(`  Jurisdiction: ${result.jurisdiction}`);
+    console.log(`  Status: ${result.formation_status}`);
+    console.log(chalk7.yellow(`
+  Next: corp form add-founder ${result.entity_id} --name "..." --email "..." --role member --pct 50`));
+  } catch (err) {
+    printError(`Failed to create pending entity: ${err}`);
+    process.exit(1);
+  }
+}
+async function formAddFounderCommand(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 payload = {
+      name: opts.name,
+      email: opts.email,
+      role: opts.role,
+      ownership_pct: parseFloat(opts.pct)
+    };
+    if (opts.officerTitle) payload.officer_title = opts.officerTitle;
+    if (opts.incorporator) payload.is_incorporator = true;
+    const result = await client.addFounder(entityId, payload);
+    printSuccess(`Founder added (${result.member_count} total)`);
+    const members = result.members ?? [];
+    for (const m of members) {
+      const pct = typeof m.ownership_pct === "number" ? ` (${m.ownership_pct}%)` : "";
+      console.log(`  - ${m.name} <${m.email ?? "no email"}> [${m.role ?? "member"}]${pct}`);
+    }
+    console.log(chalk7.yellow(`
+  Next: add more founders or run: corp form finalize ${entityId}`));
+  } catch (err) {
+    printError(`Failed to add founder: ${err}`);
+    process.exit(1);
+  }
+}
+async function formFinalizeCommand(entityId) {
+  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.finalizeFormation(entityId);
+    printSuccess(`Formation finalized: ${result.entity_id}`);
+    if (result.legal_entity_id) console.log(`  Legal Entity ID: ${result.legal_entity_id}`);
+    if (result.instrument_id) console.log(`  Instrument ID: ${result.instrument_id}`);
+    const docIds = result.document_ids ?? [];
+    if (docIds.length > 0) {
+      console.log(`  Documents: ${docIds.length} generated`);
+    }
+    const holders = result.holders ?? [];
+    if (holders.length > 0) {
+      console.log();
+      const table = new Table3({
+        head: [chalk7.dim("Holder"), chalk7.dim("Shares"), chalk7.dim("Ownership %")]
+      });
+      for (const h of holders) {
+        const pct = typeof h.ownership_pct === "number" ? `${h.ownership_pct.toFixed(1)}%` : "\u2014";
+        table.push([String(h.name ?? "?"), String(h.shares ?? 0), pct]);
+      }
+      console.log(chalk7.bold("  Cap Table:"));
+      console.log(table.toString());
+    }
+    if (result.next_action) {
+      console.log(chalk7.yellow(`
+  Next: ${result.next_action}`));
+    }
+  } catch (err) {
+    printError(`Failed to finalize formation: ${err}`);
+    process.exit(1);
+  }
+}
 var init_form = __esm({
   "src/commands/form.ts"() {
     "use strict";
@@ -2289,8 +2812,8 @@ var api_keys_exports = {};
 __export(api_keys_exports, {
   apiKeysCommand: () => apiKeysCommand
 });
-import chalk7 from "chalk";
-import Table3 from "cli-table3";
+import chalk8 from "chalk";
+import Table4 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);
@@ -2305,9 +2828,9 @@ async function apiKeysCommand(opts) {
       return;
     }
     console.log(`
-${chalk7.bold("API Keys")}`);
-    const table = new Table3({
-      head: [chalk7.dim("ID"), chalk7.dim("Name"), chalk7.dim("Key"), chalk7.dim("Created"), chalk7.dim("Last Used")]
+${chalk8.bold("API Keys")}`);
+    const table = new Table4({
+      head: [chalk8.dim("ID"), chalk8.dim("Name"), chalk8.dim("Key"), chalk8.dim("Created"), chalk8.dim("Last Used")]
     });
     for (const k of keys) {
       table.push([
@@ -2410,8 +2933,11 @@ var init_serve = __esm({
 
 // src/index.ts
 import { Command } from "commander";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../package.json");
 var program = new Command();
-program.name("corp").description("corp \u2014 Corporate governance from the terminal").version("0.1.0");
+program.name("corp").description("corp \u2014 Corporate governance from the terminal").version(pkg.version);
 program.command("setup").description("Interactive setup wizard").action(async () => {
   const { setupCommand: setupCommand2 } = await Promise.resolve().then(() => (init_setup(), setup_exports));
   await setupCommand2();
@@ -2529,6 +3055,36 @@ capTableCmd.command("distribute").requiredOption("--amount <n>", "Total distribu
   const { distributeCommand: distributeCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await distributeCommand2({ ...opts, entityId: parent.entityId });
 });
+capTableCmd.command("start-round").requiredOption("--name <name>", "Round name").requiredOption("--issuer-legal-entity-id <id>", "Issuer legal entity ID").description("Start a staged equity round").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { startRoundCommand: startRoundCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
+  await startRoundCommand2({ ...opts, entityId: parent.entityId });
+});
+capTableCmd.command("add-security").requiredOption("--round-id <id>", "Round ID").requiredOption("--instrument-id <id>", "Instrument ID").requiredOption("--quantity <n>", "Number of shares/units", parseInt).requiredOption("--recipient-name <name>", "Recipient display name").option("--holder-id <id>", "Existing holder ID").option("--email <email>", "Recipient email (to find or create holder)").option("--principal-cents <n>", "Principal amount in cents", parseInt).option("--grant-type <type>", "Grant type").description("Add a security to a staged equity round").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { addSecurityCommand: addSecurityCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
+  await addSecurityCommand2({ ...opts, entityId: parent.entityId });
+});
+capTableCmd.command("issue-round").requiredOption("--round-id <id>", "Round ID").description("Issue all securities and close a staged round").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { issueRoundCommand: issueRoundCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
+  await issueRoundCommand2({ ...opts, entityId: parent.entityId });
+});
+capTableCmd.command("create-valuation").requiredOption("--type <type>", "Valuation type (four_oh_nine_a, fair_market_value, etc.)").requiredOption("--date <date>", "Effective date (ISO 8601)").requiredOption("--methodology <method>", "Methodology (income, market, asset, backsolve, hybrid)").option("--fmv <cents>", "FMV per share in cents", parseInt).option("--enterprise-value <cents>", "Enterprise value in cents", parseInt).description("Create a valuation").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { createValuationCommand: createValuationCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
+  await createValuationCommand2({ ...opts, entityId: parent.entityId });
+});
+capTableCmd.command("submit-valuation <valuation-id>").description("Submit a valuation for board approval").action(async (valuationId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { submitValuationCommand: submitValuationCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
+  await submitValuationCommand2({ valuationId, entityId: parent.entityId });
+});
+capTableCmd.command("approve-valuation <valuation-id>").option("--resolution-id <id>", "Resolution ID from the board vote").description("Approve a valuation").action(async (valuationId, opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { approveValuationCommand: approveValuationCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
+  await approveValuationCommand2({ ...opts, valuationId, entityId: parent.entityId });
+});
 var financeCmd = program.command("finance").description("Invoicing, payroll, payments, banking").option("--entity-id <id>", "Entity ID (overrides active entity)");
 financeCmd.command("invoice").requiredOption("--customer <name>", "Customer name").requiredOption("--amount <n>", "Amount in cents", parseInt).requiredOption("--due-date <date>", "Due date (ISO 8601)").option("--description <desc>", "Description", "Services rendered").description("Create an invoice").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
@@ -2588,6 +3144,41 @@ governanceCmd.command("vote <meeting-id> <item-id>").requiredOption("--voter <na
   const { governanceVoteCommand: governanceVoteCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceVoteCommand2(meetingId, itemId, opts);
 });
+governanceCmd.command("notice <meeting-id>").description("Send meeting notice").action(async (meetingId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { sendNoticeCommand: sendNoticeCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await sendNoticeCommand2(meetingId, { entityId: parent.entityId });
+});
+governanceCmd.command("adjourn <meeting-id>").description("Adjourn a meeting").action(async (meetingId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { adjournMeetingCommand: adjournMeetingCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await adjournMeetingCommand2(meetingId, { entityId: parent.entityId });
+});
+governanceCmd.command("cancel <meeting-id>").description("Cancel a meeting").action(async (meetingId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { cancelMeetingCommand: cancelMeetingCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await cancelMeetingCommand2(meetingId, { entityId: parent.entityId });
+});
+governanceCmd.command("agenda-items <meeting-id>").description("List agenda items for a meeting").action(async (meetingId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
+  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) => {
+  const parent = cmd.parent.opts();
+  const { finalizeAgendaItemCommand: finalizeAgendaItemCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await finalizeAgendaItemCommand2(meetingId, itemId, { ...opts, entityId: parent.entityId });
+});
+governanceCmd.command("resolve <meeting-id> <item-id>").requiredOption("--text <resolution_text>", "Resolution text").description("Compute a resolution for an agenda item").action(async (meetingId, itemId, opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { computeResolutionCommand: computeResolutionCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await computeResolutionCommand2(meetingId, itemId, { ...opts, entityId: parent.entityId });
+});
+governanceCmd.command("written-consent").requiredOption("--body <id>", "Governance body ID").requiredOption("--title <title>", "Title").requiredOption("--description <desc>", "Description").description("Create a written consent action").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { writtenConsentCommand: writtenConsentCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
+  await writtenConsentCommand2({ ...opts, entityId: parent.entityId });
+});
 var documentsCmd = program.command("documents").description("Documents and signing").option("--entity-id <id>", "Entity ID (overrides active entity)").option("--json", "Output as JSON").action(async (opts) => {
   const { documentsListCommand: documentsListCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsListCommand2(opts);
@@ -2601,6 +3192,11 @@ documentsCmd.command("generate").requiredOption("--template <type>", "Template t
   const { documentsGenerateCommand: documentsGenerateCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsGenerateCommand2({ ...opts, entityId: parent.entityId });
 });
+documentsCmd.command("preview-pdf").requiredOption("--document-id <id>", "AST document definition ID (e.g. 'bylaws')").description("Preview a governance document as PDF").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { documentsPreviewPdfCommand: documentsPreviewPdfCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
+  await documentsPreviewPdfCommand2({ ...opts, entityId: parent.entityId });
+});
 var taxCmd = program.command("tax").description("Tax filings and deadline tracking").option("--entity-id <id>", "Entity ID (overrides active entity)");
 taxCmd.command("file").requiredOption("--type <type>", "Document type").requiredOption("--year <year>", "Tax year", parseInt).description("File a tax document").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
@@ -2672,10 +3268,22 @@ approvalsCmd.command("reject <approval-id>").option("--message <msg>", "Optional
   const { approvalsRespondCommand: approvalsRespondCommand2 } = await Promise.resolve().then(() => (init_approvals(), approvals_exports));
   await approvalsRespondCommand2(approvalId, "reject", opts);
 });
-program.command("form").description("Create a new entity (interactive or scripted)").option("--type <type>", "Entity type (llc, c_corp, etc.)").option("--name <name>", "Entity name").option("--jurisdiction <jurisdiction>", "Jurisdiction (e.g. DE, WY)").option("--member <member>", "Member as 'name,email,role[,pct]' (repeatable)", (v, a) => [...a, v], []).action(async (opts) => {
+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) => {
   const { formCommand: formCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
   await formCommand2(opts);
 });
+formCmd.command("create").description("Create a pending entity (staged flow step 1)").requiredOption("--type <type>", "Entity type (llc, c_corp)").requiredOption("--name <name>", "Legal name").option("--jurisdiction <jurisdiction>", "Jurisdiction (e.g. US-DE, US-WY)").action(async (opts) => {
+  const { formCreateCommand: formCreateCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
+  await formCreateCommand2(opts);
+});
+formCmd.command("add-founder <entity-id>").description("Add a founder to a pending entity (staged flow step 2)").requiredOption("--name <name>", "Founder name").requiredOption("--email <email>", "Founder email").requiredOption("--role <role>", "Role: director|officer|manager|member|chair").requiredOption("--pct <pct>", "Ownership percentage").option("--officer-title <title>", "Officer title (corporations only)").option("--incorporator", "Mark as sole incorporator (corporations only)").action(async (entityId, opts) => {
+  const { formAddFounderCommand: formAddFounderCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
+  await formAddFounderCommand2(entityId, opts);
+});
+formCmd.command("finalize <entity-id>").description("Finalize formation and generate documents + cap table (staged flow step 3)").action(async (entityId) => {
+  const { formFinalizeCommand: formFinalizeCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
+  await formFinalizeCommand2(entityId);
+});
 program.command("api-keys").description("List API keys").option("--json", "Output as JSON").action(async (opts) => {
   const { apiKeysCommand: apiKeysCommand2 } = await Promise.resolve().then(() => (init_api_keys(), api_keys_exports));
   await apiKeysCommand2(opts);