@thecorporation/cli 26.3.20 → 26.3.21

package/dist/index.js

@@ -292,7 +292,9 @@ function requireSupportedConfigKey(dotPath) {
 }
 function validateSensitiveConfigUpdate(dotPath, forceSensitive = false) {
   if (SENSITIVE_CONFIG_KEYS.has(dotPath) && !forceSensitive) {
-    throw new Error(`refusing to update security-sensitive key '${dotPath}' without --force`);
+    throw new Error(
+      `refusing to update security-sensitive key '${dotPath}' without --force; this key controls authentication or API routing, so explicit confirmation is required`
+    );
   }
 }
 function setKnownConfigValue(cfg, dotPath, value) {
@@ -775,6 +777,29 @@ var init_references = __esm({
       async resolveContact(entityId, ref) {
         return this.resolve("contact", ref, { entityId });
       }
+      async resolveWorkItemActor(entityId, ref) {
+        const trimmed = validateReferenceInput(ref, "actor reference");
+        const [contactResult, agentResult] = await Promise.allSettled([
+          this.resolveContact(entityId, trimmed),
+          this.resolveAgent(trimmed)
+        ]);
+        const contactId = contactResult.status === "fulfilled" ? contactResult.value : void 0;
+        const agentId = agentResult.status === "fulfilled" ? agentResult.value : void 0;
+        if (contactId && agentId && contactId !== agentId) {
+          throw new Error(
+            `Actor reference '${trimmed}' is ambiguous between a contact and an agent. Use a unique ref or explicit @last:contact / @last:agent.`
+          );
+        }
+        if (contactId) {
+          return { actor_type: "contact", actor_id: contactId };
+        }
+        if (agentId) {
+          return { actor_type: "agent", actor_id: agentId };
+        }
+        throw new Error(
+          `No matching contact or agent found for '${trimmed}'. Try 'corp find contact <query>' or 'corp find agent <query>'.`
+        );
+      }
       async resolveShareTransfer(entityId, ref) {
         return this.resolve("share_transfer", ref, { entityId });
       }
@@ -1300,46 +1325,6 @@ var init_references = __esm({
 });
 
 // src/output.ts
-var output_exports = {};
-__export(output_exports, {
-  printAgendaItemsTable: () => printAgendaItemsTable,
-  printAgentsTable: () => printAgentsTable,
-  printApprovalsTable: () => printApprovalsTable,
-  printBankAccountsTable: () => printBankAccountsTable,
-  printBillingPanel: () => printBillingPanel,
-  printCapTable: () => printCapTable,
-  printClassificationsTable: () => printClassificationsTable,
-  printContactsTable: () => printContactsTable,
-  printDeadlinesTable: () => printDeadlinesTable,
-  printDistributionsTable: () => printDistributionsTable,
-  printDocumentsTable: () => printDocumentsTable,
-  printDryRun: () => printDryRun,
-  printEntitiesTable: () => printEntitiesTable,
-  printError: () => printError,
-  printGovernanceTable: () => printGovernanceTable,
-  printInstrumentsTable: () => printInstrumentsTable,
-  printInvoicesTable: () => printInvoicesTable,
-  printJson: () => printJson,
-  printMeetingsTable: () => printMeetingsTable,
-  printObligationsTable: () => printObligationsTable,
-  printPaymentsTable: () => printPaymentsTable,
-  printPayrollRunsTable: () => printPayrollRunsTable,
-  printReconciliationsTable: () => printReconciliationsTable,
-  printReferenceSummary: () => printReferenceSummary,
-  printResolutionsTable: () => printResolutionsTable,
-  printRoundsTable: () => printRoundsTable,
-  printSafesTable: () => printSafesTable,
-  printSeatsTable: () => printSeatsTable,
-  printShareClassesTable: () => printShareClassesTable,
-  printStatusPanel: () => printStatusPanel,
-  printSuccess: () => printSuccess,
-  printTaxFilingsTable: () => printTaxFilingsTable,
-  printTransfersTable: () => printTransfersTable,
-  printValuationsTable: () => printValuationsTable,
-  printWarning: () => printWarning,
-  printWorkItemsTable: () => printWorkItemsTable,
-  printWriteResult: () => printWriteResult
-});
 import chalk from "chalk";
 import Table from "cli-table3";
 function printError(msg) {
@@ -1420,6 +1405,30 @@ function printStatusPanel(data) {
   }
   console.log(chalk.blue("\u2500".repeat(50)));
 }
+function printFinanceSummaryPanel(data) {
+  const invoices = data.invoices ?? {};
+  const bankAccounts = data.bank_accounts ?? {};
+  const payments = data.payments ?? {};
+  const payrollRuns = data.payroll_runs ?? {};
+  const distributions = data.distributions ?? {};
+  const reconciliations = data.reconciliations ?? {};
+  const classifications = data.contractor_classifications ?? {};
+  console.log(chalk.green("\u2500".repeat(54)));
+  console.log(chalk.green.bold("  Finance Summary"));
+  console.log(chalk.green("\u2500".repeat(54)));
+  console.log(`  ${chalk.bold("Entity:")} ${s(data.entity_id) || "N/A"}`);
+  console.log(`  ${chalk.bold("Invoices:")} ${s(invoices.count)} total, ${s(invoices.open_count)} open, ${money(invoices.total_amount_cents)}`);
+  if (invoices.latest_due_date) {
+    console.log(`  ${chalk.bold("Invoice Horizon:")} next due ${date(invoices.latest_due_date)}`);
+  }
+  console.log(`  ${chalk.bold("Bank Accounts:")} ${s(bankAccounts.active_count)}/${s(bankAccounts.count)} active`);
+  console.log(`  ${chalk.bold("Payments:")} ${s(payments.count)} total, ${s(payments.pending_count)} pending, ${money(payments.total_amount_cents)}`);
+  console.log(`  ${chalk.bold("Payroll Runs:")} ${s(payrollRuns.count)} total${payrollRuns.latest_period_end ? `, latest ${date(payrollRuns.latest_period_end)}` : ""}`);
+  console.log(`  ${chalk.bold("Distributions:")} ${s(distributions.count)} total, ${money(distributions.total_amount_cents)}`);
+  console.log(`  ${chalk.bold("Reconciliations:")} ${s(reconciliations.balanced_count)}/${s(reconciliations.count)} balanced`);
+  console.log(`  ${chalk.bold("Contractors:")} ${s(classifications.count)} classifications, ${s(classifications.high_risk_count)} high risk`);
+  console.log(chalk.green("\u2500".repeat(54)));
+}
 function makeTable(title, columns) {
   console.log(`
 ${chalk.bold(title)}`);
@@ -1443,6 +1452,17 @@ function date(val) {
   const parsed = new Date(str);
   return Number.isNaN(parsed.getTime()) ? str : parsed.toISOString().slice(0, 10);
 }
+function actorLabel(record, field) {
+  const actor = record[`${field}_actor`];
+  if (actor && typeof actor === "object" && !Array.isArray(actor)) {
+    const label = s(actor.label);
+    const actorType = s(actor.actor_type);
+    if (label) {
+      return actorType ? `${label} (${actorType})` : label;
+    }
+  }
+  return s(record[field]);
+}
 function printEntitiesTable(entities) {
   const table = makeTable("Entities", ["Ref", "Name", "Type", "Jurisdiction", "Status"]);
   for (const e of entities) {
@@ -1848,7 +1868,7 @@ function printWorkItemsTable(items) {
       s(w.category),
       colored,
       w.asap ? chalk.red.bold("ASAP") : s(w.deadline ?? ""),
-      s(w.claimed_by ?? "")
+      actorLabel(w, "claimed_by")
     ]);
   }
   console.log(table.toString());
@@ -1862,21 +1882,6 @@ function printAgentsTable(agents) {
   }
   console.log(table.toString());
 }
-function printApprovalsTable(approvals) {
-  const table = makeTable("Pending Approvals", ["ID", "Type", "Requested By", "Description", "Created"]);
-  for (const a of approvals) {
-    let desc = s(a.description ?? a.summary);
-    if (desc.length > 60) desc = desc.slice(0, 57) + "...";
-    table.push([
-      s(a.approval_id ?? a.id, 12),
-      s(a.approval_type ?? a.type),
-      s(a.requested_by ?? a.requester),
-      desc,
-      s(a.created_at)
-    ]);
-  }
-  console.log(table.toString());
-}
 function printBillingPanel(status, plans) {
   const plan = s(status.plan ?? status.tier) || "free";
   const subStatus = s(status.status) || "active";
@@ -3828,7 +3833,26 @@ async function fourOhNineACommand(opts) {
   } catch (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>");
+      try {
+        const eid = await resolver.resolveEntity(opts.entityId);
+        const valuations = await client.getValuations(eid);
+        const pending409a = valuations.filter((valuation) => valuation.valuation_type === "four_oh_nine_a").find((valuation) => valuation.status === "pending_approval");
+        if (pending409a) {
+          const effectiveDate = pending409a.effective_date ?? "unknown date";
+          console.log(
+            `No current approved 409A valuation found. A 409A valuation is pending approval (${effectiveDate}).
+  Complete board approval, then re-run: corp cap-table 409a`
+          );
+        } else {
+          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>"
+          );
+        }
+      } catch {
+        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}`);
     }
@@ -4361,8 +4385,112 @@ __export(finance_exports, {
   financePayrollCommand: () => financePayrollCommand,
   financePayrollRunsCommand: () => financePayrollRunsCommand,
   financeReconcileCommand: () => financeReconcileCommand,
-  financeReconciliationsCommand: () => financeReconciliationsCommand
-});
+  financeReconciliationsCommand: () => financeReconciliationsCommand,
+  financeSummaryCommand: () => financeSummaryCommand
+});
+function sumAmounts(records, candidates) {
+  return records.reduce((sum, record) => {
+    for (const key of candidates) {
+      if (typeof record[key] === "number" && Number.isFinite(record[key])) {
+        return sum + Number(record[key]);
+      }
+    }
+    return sum;
+  }, 0);
+}
+function latestDate(records, candidates) {
+  const values = records.flatMap((record) => candidates.map((key) => record[key])).filter((value) => typeof value === "string" && value.trim().length > 0).map((value) => ({ raw: value, time: new Date(value).getTime() })).filter((value) => Number.isFinite(value.time)).sort((a, b) => b.time - a.time);
+  return values[0]?.raw;
+}
+function countByStatus(records, statuses) {
+  const expected = new Set(statuses.map((status) => status.toLowerCase()));
+  return records.filter((record) => expected.has(String(record.status ?? "").toLowerCase())).length;
+}
+function countByField(records, field, values) {
+  const expected = new Set(values.map((value) => value.toLowerCase()));
+  return records.filter((record) => expected.has(String(record[field] ?? "").toLowerCase())).length;
+}
+async function financeSummaryCommand(opts) {
+  const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  const resolver = new ReferenceResolver(client, cfg);
+  try {
+    const eid = await resolver.resolveEntity(opts.entityId);
+    const [
+      invoices,
+      accounts,
+      payments,
+      payrollRuns,
+      distributions,
+      reconciliations,
+      classifications
+    ] = await Promise.all([
+      client.listInvoices(eid),
+      client.listBankAccounts(eid),
+      client.listPayments(eid),
+      client.listPayrollRuns(eid),
+      client.listDistributions(eid),
+      client.listReconciliations(eid),
+      client.listContractorClassifications(eid)
+    ]);
+    await Promise.all([
+      resolver.stabilizeRecords("invoice", invoices, eid),
+      resolver.stabilizeRecords("bank_account", accounts, eid),
+      resolver.stabilizeRecords("payment", payments, eid),
+      resolver.stabilizeRecords("payroll_run", payrollRuns, eid),
+      resolver.stabilizeRecords("distribution", distributions, eid),
+      resolver.stabilizeRecords("reconciliation", reconciliations, eid),
+      resolver.stabilizeRecords("classification", classifications, eid)
+    ]);
+    const summary = {
+      entity_id: eid,
+      invoices: {
+        count: invoices.length,
+        open_count: invoices.length - countByStatus(invoices, ["paid", "cancelled", "void"]),
+        overdue_count: countByStatus(invoices, ["overdue"]),
+        total_amount_cents: sumAmounts(invoices, ["amount_cents", "total_amount_cents"]),
+        latest_due_date: latestDate(invoices, ["due_date", "created_at"])
+      },
+      bank_accounts: {
+        count: accounts.length,
+        active_count: countByStatus(accounts, ["active", "approved", "open"])
+      },
+      payments: {
+        count: payments.length,
+        pending_count: countByStatus(payments, ["pending", "submitted", "queued"]),
+        total_amount_cents: sumAmounts(payments, ["amount_cents"]),
+        latest_submitted_at: latestDate(payments, ["submitted_at", "created_at"])
+      },
+      payroll_runs: {
+        count: payrollRuns.length,
+        latest_period_end: latestDate(payrollRuns, ["pay_period_end", "created_at"])
+      },
+      distributions: {
+        count: distributions.length,
+        total_amount_cents: sumAmounts(distributions, ["amount_cents", "distribution_amount_cents"]),
+        latest_declared_at: latestDate(distributions, ["declared_at", "created_at"])
+      },
+      reconciliations: {
+        count: reconciliations.length,
+        balanced_count: reconciliations.filter((record) => record.is_balanced === true).length,
+        latest_as_of_date: latestDate(reconciliations, ["as_of_date", "created_at"])
+      },
+      contractor_classifications: {
+        count: classifications.length,
+        high_risk_count: countByField(classifications, "risk_level", ["high"]),
+        medium_risk_count: countByField(classifications, "risk_level", ["medium"])
+      }
+    };
+    if (opts.json) {
+      printJson(summary);
+      return;
+    }
+    printFinanceSummaryPanel(summary);
+  } catch (err) {
+    printError(`Failed to fetch finance summary: ${err}`);
+    process.exit(1);
+  }
+}
 async function financeInvoicesCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
@@ -5102,12 +5230,206 @@ var init_governance = __esm({
   }
 });
 
+// src/formation-automation.ts
+function normalizeRole(value) {
+  return String(value ?? "").trim().toLowerCase();
+}
+function fallbackSignerEmail(requirement) {
+  const slug = String(requirement.signer_name ?? "signer").toLowerCase().replace(/[^a-z0-9]+/g, ".").replace(/^\.+|\.+$/g, "");
+  return `${slug || "signer"}@example.com`;
+}
+function getSignatureRequirements(document) {
+  const content = document.content;
+  if (!content || typeof content !== "object" || Array.isArray(content)) {
+    return [];
+  }
+  const requirements = content.signature_requirements;
+  if (!Array.isArray(requirements)) {
+    return [];
+  }
+  return requirements.filter((item) => typeof item === "object" && item !== null && !Array.isArray(item)).map((item) => ({
+    role: String(item.role ?? "").trim(),
+    signer_name: String(item.signer_name ?? "").trim(),
+    signer_email: typeof item.signer_email === "string" && item.signer_email.trim() ? item.signer_email.trim() : void 0
+  })).filter((item) => item.role.length > 0 && item.signer_name.length > 0);
+}
+function getSignedRoles(document) {
+  const signatures = Array.isArray(document.signatures) ? document.signatures : [];
+  return new Set(
+    signatures.filter((item) => typeof item === "object" && item !== null && !Array.isArray(item)).map((item) => normalizeRole(item.signer_role)).filter(Boolean)
+  );
+}
+function deterministicEin(entityId) {
+  const digits = entityId.replace(/\D/g, "");
+  const nineDigits = `${digits}123456789`.slice(0, 9).padEnd(9, "0");
+  return `${nineDigits.slice(0, 2)}-${nineDigits.slice(2)}`;
+}
+function filingIdentifier(prefix, entityId) {
+  const token = entityId.replace(/[^a-zA-Z0-9]/g, "").slice(0, 12).toLowerCase() || "formation";
+  return `${prefix}-${token}`;
+}
+async function autoSignFormationDocument(client, entityId, documentId) {
+  const document = await client.getDocument(documentId, entityId);
+  const requiredSignatures = getSignatureRequirements(document);
+  if (requiredSignatures.length === 0) {
+    return { document, signatures_added: 0 };
+  }
+  const signedRoles = getSignedRoles(document);
+  let signaturesAdded = 0;
+  for (const requirement of requiredSignatures) {
+    if (signedRoles.has(normalizeRole(requirement.role))) {
+      continue;
+    }
+    await client.signDocument(documentId, entityId, {
+      signer_name: requirement.signer_name,
+      signer_role: requirement.role,
+      signer_email: requirement.signer_email ?? fallbackSignerEmail(requirement),
+      signature_text: requirement.signer_name,
+      consent_text: DEFAULT_SIGNATURE_CONSENT
+    });
+    signedRoles.add(normalizeRole(requirement.role));
+    signaturesAdded += 1;
+  }
+  const refreshed = await client.getDocument(documentId, entityId);
+  return { document: refreshed, signatures_added: signaturesAdded };
+}
+async function autoSignFormationDocuments(client, resolver, entityId) {
+  const summaries = await client.getEntityDocuments(entityId);
+  await resolver.stabilizeRecords("document", summaries, entityId);
+  let signaturesAdded = 0;
+  let documentsSigned = 0;
+  const documents = [];
+  for (const summary of summaries) {
+    const documentId = String(summary.document_id ?? "");
+    if (!documentId) {
+      continue;
+    }
+    const { document, signatures_added } = await autoSignFormationDocument(
+      client,
+      entityId,
+      documentId
+    );
+    signaturesAdded += signatures_added;
+    if (signatures_added > 0) {
+      documentsSigned += 1;
+    }
+    documents.push(document);
+  }
+  return {
+    documents_seen: summaries.length,
+    documents_signed: documentsSigned,
+    signatures_added: signaturesAdded,
+    documents
+  };
+}
+async function activateFormationEntity(client, resolver, entityId, options = {}) {
+  let formation = await client.getFormation(entityId);
+  const initialStatus = String(formation.formation_status ?? "");
+  const steps = [];
+  let signaturesAdded = 0;
+  let documentsSigned = 0;
+  for (let i = 0; i < 10; i += 1) {
+    const status = String(formation.formation_status ?? "");
+    if (status === "active") {
+      return {
+        entity_id: entityId,
+        initial_status: initialStatus,
+        final_status: status,
+        signatures_added: signaturesAdded,
+        documents_signed: documentsSigned,
+        steps,
+        formation
+      };
+    }
+    if (status === "pending") {
+      throw new Error("Formation is still pending. Finalize it before activation.");
+    }
+    if (status === "documents_generated") {
+      const signed = await autoSignFormationDocuments(client, resolver, entityId);
+      signaturesAdded += signed.signatures_added;
+      documentsSigned += signed.documents_signed;
+      await client.markFormationDocumentsSigned(entityId);
+      steps.push(`signed ${signed.signatures_added} signatures across ${signed.documents_signed} documents`);
+      formation = await client.getFormation(entityId);
+      continue;
+    }
+    if (status === "documents_signed") {
+      const gates = await client.getFormationGates(entityId);
+      if (gates.requires_natural_person_attestation && !gates.attestation_recorded) {
+        await client.recordFilingAttestation(entityId, {
+          signer_name: gates.designated_attestor_name,
+          signer_role: gates.designated_attestor_role,
+          signer_email: gates.designated_attestor_email ?? fallbackSignerEmail({
+            role: String(gates.designated_attestor_role ?? "attestor"),
+            signer_name: String(gates.designated_attestor_name ?? "attestor")
+          }),
+          consent_text: DEFAULT_ATTESTATION_CONSENT,
+          notes: "Recorded automatically by corp form activate"
+        });
+        steps.push("recorded filing attestation");
+      }
+      const gatesAfterAttestation = await client.getFormationGates(entityId);
+      if (gatesAfterAttestation.requires_registered_agent_consent_evidence && Number(gatesAfterAttestation.registered_agent_consent_evidence_count ?? 0) === 0) {
+        await client.addRegisteredAgentConsentEvidence(entityId, {
+          evidence_uri: options.evidenceUri ?? `generated://registered-agent-consent/${entityId}`,
+          evidence_type: options.evidenceType ?? "generated",
+          notes: "Recorded automatically by corp form activate"
+        });
+        steps.push("recorded registered-agent consent evidence");
+      }
+      const finalGates = await client.getFormationGates(entityId);
+      if (Array.isArray(finalGates.filing_submission_blockers) && finalGates.filing_submission_blockers.length > 0) {
+        throw new Error(
+          `Formation filing is still blocked: ${finalGates.filing_submission_blockers.join("; ")}`
+        );
+      }
+      await client.submitFiling(entityId);
+      steps.push("submitted filing");
+      formation = await client.getFormation(entityId);
+      continue;
+    }
+    if (status === "filing_submitted") {
+      await client.confirmFiling(entityId, {
+        external_filing_id: options.filingId ?? filingIdentifier("sim", entityId),
+        receipt_reference: options.receiptReference ?? filingIdentifier("receipt", entityId)
+      });
+      steps.push("confirmed filing");
+      formation = await client.getFormation(entityId);
+      continue;
+    }
+    if (status === "filed") {
+      await client.applyEin(entityId);
+      steps.push("submitted EIN application");
+      formation = await client.getFormation(entityId);
+      continue;
+    }
+    if (status === "ein_applied") {
+      await client.confirmEin(entityId, { ein: options.ein ?? deterministicEin(entityId) });
+      steps.push("confirmed EIN");
+      formation = await client.getFormation(entityId);
+      continue;
+    }
+    throw new Error(`Unsupported formation status for activation: ${status || "unknown"}`);
+  }
+  throw new Error("Formation activation did not converge within 10 steps.");
+}
+var DEFAULT_SIGNATURE_CONSENT, DEFAULT_ATTESTATION_CONSENT;
+var init_formation_automation = __esm({
+  "src/formation-automation.ts"() {
+    "use strict";
+    DEFAULT_SIGNATURE_CONSENT = "I agree to sign this document electronically.";
+    DEFAULT_ATTESTATION_CONSENT = "I attest the filing information is accurate and authorized.";
+  }
+});
+
 // src/commands/documents.ts
 var documents_exports = {};
 __export(documents_exports, {
   documentsGenerateCommand: () => documentsGenerateCommand,
   documentsListCommand: () => documentsListCommand,
   documentsPreviewPdfCommand: () => documentsPreviewPdfCommand,
+  documentsSignAllCommand: () => documentsSignAllCommand,
+  documentsSignCommand: () => documentsSignCommand,
   documentsSigningLinkCommand: () => documentsSigningLinkCommand
 });
 function formatSigningLink(docId, result) {
@@ -5213,7 +5535,78 @@ function coerceParamValue(raw) {
   }
   return raw;
 }
+async function documentsSignCommand(docId, opts) {
+  const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  const resolver = new ReferenceResolver(client, cfg);
+  try {
+    const eid = await resolver.resolveEntity(opts.entityId);
+    const resolvedDocumentId = await resolver.resolveDocument(eid, docId);
+    if (opts.signerName || opts.signerRole || opts.signerEmail || opts.signatureText) {
+      if (!opts.signerName || !opts.signerRole || !opts.signerEmail) {
+        throw new Error("Manual signing requires --signer-name, --signer-role, and --signer-email.");
+      }
+      const result2 = await client.signDocument(resolvedDocumentId, eid, {
+        signer_name: opts.signerName,
+        signer_role: opts.signerRole,
+        signer_email: opts.signerEmail,
+        signature_text: opts.signatureText ?? opts.signerName
+      });
+      await resolver.stabilizeRecord("document", { document_id: resolvedDocumentId, title: docId }, eid);
+      printWriteResult(result2, `Document ${resolvedDocumentId} signed.`, opts.json);
+      return;
+    }
+    const result = await autoSignFormationDocument(client, eid, resolvedDocumentId);
+    await resolver.stabilizeRecord("document", result.document, eid);
+    resolver.rememberFromRecord("document", result.document, eid);
+    if (opts.json) {
+      printJson({
+        document_id: resolvedDocumentId,
+        signatures_added: result.signatures_added,
+        document: result.document
+      });
+      return;
+    }
+    printSuccess(
+      result.signatures_added > 0 ? `Applied ${result.signatures_added} signature(s) to ${resolvedDocumentId}.` : `No signatures were needed for ${resolvedDocumentId}.`
+    );
+    printReferenceSummary("document", result.document, { showReuseHint: true });
+    printJson(result.document);
+  } catch (err) {
+    printError(`Failed to sign document: ${err}`);
+    process.exit(1);
+  }
+}
+async function documentsSignAllCommand(opts) {
+  const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  const resolver = new ReferenceResolver(client, cfg);
+  try {
+    const eid = await resolver.resolveEntity(opts.entityId);
+    const result = await autoSignFormationDocuments(client, resolver, eid);
+    if (opts.json) {
+      printJson(result);
+      return;
+    }
+    printSuccess(
+      `Processed ${result.documents_seen} formation document(s); added ${result.signatures_added} signature(s) across ${result.documents_signed} document(s).`
+    );
+    printJson(result.documents.map((document) => ({
+      document_id: document.document_id,
+      title: document.title,
+      status: document.status,
+      signatures: Array.isArray(document.signatures) ? document.signatures.length : document.signatures
+    })));
+  } catch (err) {
+    printError(`Failed to sign formation documents: ${err}`);
+    process.exit(1);
+  }
+}
 async function documentsPreviewPdfCommand(opts) {
+  if (!opts.documentId || opts.documentId.trim().length === 0) {
+    printError("preview-pdf requires --definition-id (or deprecated alias --document-id)");
+    process.exit(1);
+  }
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   const resolver = new ReferenceResolver(client, cfg);
@@ -5236,6 +5629,7 @@ var init_documents = __esm({
     init_api_client();
     init_output();
     init_references();
+    init_formation_automation();
     HUMANS_APP_ORIGIN = "https://humans.thecorporation.ai";
   }
 });
@@ -5560,6 +5954,18 @@ __export(work_items_exports, {
   workItemsShowCommand: () => workItemsShowCommand
 });
 import chalk10 from "chalk";
+function actorLabel2(record, key) {
+  const actor = record[`${key}_actor`];
+  if (actor && typeof actor === "object" && !Array.isArray(actor)) {
+    const label = actor.label;
+    const actorType = actor.actor_type;
+    if (typeof label === "string" && label.trim()) {
+      return typeof actorType === "string" && actorType.trim() ? `${label} (${actorType})` : label;
+    }
+  }
+  const legacy = record[key];
+  return typeof legacy === "string" && legacy.trim() ? legacy : void 0;
+}
 async function workItemsListCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
@@ -5602,13 +6008,16 @@ async function workItemsShowCommand(workItemId, opts) {
     if (w.description) console.log(`  ${chalk10.bold("Description:")} ${w.description}`);
     if (w.deadline) console.log(`  ${chalk10.bold("Deadline:")} ${w.deadline}`);
     if (w.asap) console.log(`  ${chalk10.bold("Priority:")} ${chalk10.red.bold("ASAP")}`);
-    if (w.claimed_by) console.log(`  ${chalk10.bold("Claimed by:")} ${w.claimed_by}`);
+    const claimedBy = actorLabel2(w, "claimed_by");
+    const completedBy = actorLabel2(w, "completed_by");
+    const createdBy = actorLabel2(w, "created_by");
+    if (claimedBy) console.log(`  ${chalk10.bold("Claimed by:")} ${claimedBy}`);
     if (w.claimed_at) console.log(`  ${chalk10.bold("Claimed at:")} ${w.claimed_at}`);
     if (w.claim_ttl_seconds) console.log(`  ${chalk10.bold("Claim TTL:")} ${w.claim_ttl_seconds}s`);
-    if (w.completed_by) console.log(`  ${chalk10.bold("Completed by:")} ${w.completed_by}`);
+    if (completedBy) console.log(`  ${chalk10.bold("Completed by:")} ${completedBy}`);
     if (w.completed_at) console.log(`  ${chalk10.bold("Completed at:")} ${w.completed_at}`);
     if (w.result) console.log(`  ${chalk10.bold("Result:")} ${w.result}`);
-    if (w.created_by) console.log(`  ${chalk10.bold("Created by:")} ${w.created_by}`);
+    if (createdBy) console.log(`  ${chalk10.bold("Created by:")} ${createdBy}`);
     console.log(`  ${chalk10.bold("Created at:")} ${w.created_at ?? "N/A"}`);
     console.log(chalk10.cyan("\u2500".repeat(40)));
   } catch (err) {
@@ -5630,7 +6039,7 @@ async function workItemsCreateCommand(opts) {
     if (opts.description) data.description = opts.description;
     if (opts.deadline) data.deadline = opts.deadline;
     if (opts.asap) data.asap = true;
-    if (opts.createdBy) data.created_by = await resolver.resolveContact(eid, opts.createdBy);
+    if (opts.createdBy) data.created_by_actor = await resolver.resolveWorkItemActor(eid, opts.createdBy);
     const result = await client.createWorkItem(eid, data);
     await resolver.stabilizeRecord("work_item", result, eid);
     resolver.rememberFromRecord("work_item", result, eid);
@@ -5652,7 +6061,7 @@ async function workItemsClaimCommand(workItemId, opts) {
     const eid = await resolver.resolveEntity(opts.entityId);
     const resolvedWorkItemId = await resolver.resolveWorkItem(eid, workItemId);
     const data = {
-      claimed_by: await resolver.resolveContact(eid, opts.claimedBy)
+      claimed_by_actor: await resolver.resolveWorkItemActor(eid, opts.claimedBy)
     };
     if (opts.ttl != null) data.ttl_seconds = opts.ttl;
     const result = await client.claimWorkItem(eid, resolvedWorkItemId, data);
@@ -5670,7 +6079,7 @@ async function workItemsCompleteCommand(workItemId, opts) {
     const eid = await resolver.resolveEntity(opts.entityId);
     const resolvedWorkItemId = await resolver.resolveWorkItem(eid, workItemId);
     const data = {
-      completed_by: await resolver.resolveContact(eid, opts.completedBy)
+      completed_by_actor: await resolver.resolveWorkItemActor(eid, opts.completedBy)
     };
     if (opts.result) data.result = opts.result;
     const result = await client.completeWorkItem(eid, resolvedWorkItemId, data);
@@ -5794,9 +6203,35 @@ var init_billing = __esm({
   }
 });
 
+// src/commands/approvals.ts
+var approvals_exports = {};
+__export(approvals_exports, {
+  approvalsListCommand: () => approvalsListCommand,
+  approvalsRespondCommand: () => approvalsRespondCommand
+});
+async function approvalsListCommand(_opts) {
+  printError(
+    "Approvals are managed through governance meetings.\n  Use: corp governance convene ... to schedule a board meeting\n  Use: corp governance vote <meeting-ref> <item-ref> ... to cast votes"
+  );
+  process.exit(1);
+}
+async function approvalsRespondCommand(_approvalId, _decision, _opts) {
+  printError(
+    "Approvals are managed through governance meetings.\n  Use: corp governance vote <meeting-ref> <item-ref> --voter <contact-ref> --vote for"
+  );
+  process.exit(1);
+}
+var init_approvals = __esm({
+  "src/commands/approvals.ts"() {
+    "use strict";
+    init_output();
+  }
+});
+
 // src/commands/form.ts
 var form_exports = {};
 __export(form_exports, {
+  formActivateCommand: () => formActivateCommand,
   formAddFounderCommand: () => formAddFounderCommand,
   formCommand: () => formCommand,
   formCreateCommand: () => formCreateCommand,
@@ -6420,6 +6855,55 @@ async function formFinalizeCommand(entityId, opts) {
     process.exit(1);
   }
 }
+async function formActivateCommand(entityId, opts) {
+  const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  const resolver = new ReferenceResolver(client, cfg);
+  try {
+    const resolvedEntityId = await resolveEntityRefForFormCommand(resolver, entityId, opts.dryRun);
+    const payload = { entity_id: resolvedEntityId };
+    if (opts.evidenceUri) payload.evidence_uri = opts.evidenceUri;
+    if (opts.evidenceType) payload.evidence_type = opts.evidenceType;
+    if (opts.filingId) payload.filing_id = opts.filingId;
+    if (opts.receiptReference) payload.receipt_reference = opts.receiptReference;
+    if (opts.ein) payload.ein = opts.ein;
+    if (opts.dryRun) {
+      printDryRun("formation.activate", payload);
+      return;
+    }
+    const result = await activateFormationEntity(client, resolver, resolvedEntityId, {
+      evidenceUri: opts.evidenceUri,
+      evidenceType: opts.evidenceType,
+      filingId: opts.filingId,
+      receiptReference: opts.receiptReference,
+      ein: opts.ein
+    });
+    const formation = await client.getFormation(resolvedEntityId);
+    await resolver.stabilizeRecord("entity", formation);
+    resolver.rememberFromRecord("entity", formation);
+    if (opts.json) {
+      printJson({
+        ...result,
+        formation
+      });
+      return;
+    }
+    printSuccess(`Formation advanced to ${result.final_status}.`);
+    printReferenceSummary("entity", formation, { showReuseHint: true });
+    if (result.steps.length > 0) {
+      console.log("  Steps:");
+      for (const step of result.steps) {
+        console.log(`    - ${step}`);
+      }
+    }
+    console.log(`  Signatures added: ${result.signatures_added}`);
+    console.log(`  Documents updated: ${result.documents_signed}`);
+    printJson(formation);
+  } catch (err) {
+    printError(`Failed to activate formation: ${err}`);
+    process.exit(1);
+  }
+}
 var init_form = __esm({
   "src/commands/form.ts"() {
     "use strict";
@@ -6427,6 +6911,7 @@ var init_form = __esm({
     init_api_client();
     init_output();
     init_references();
+    init_formation_automation();
   }
 });
 
@@ -6487,12 +6972,235 @@ var demo_exports = {};
 __export(demo_exports, {
   demoCommand: () => demoCommand
 });
+function scenarioConfig(name, scenario) {
+  switch (scenario) {
+    case "llc":
+      return {
+        entity_type: "llc",
+        legal_name: name,
+        jurisdiction: "US-WY",
+        members: [
+          {
+            name: "Alice Chen",
+            email: "alice@example.com",
+            role: "member",
+            investor_type: "natural_person",
+            ownership_pct: 60
+          },
+          {
+            name: "Bob Martinez",
+            email: "bob@example.com",
+            role: "member",
+            investor_type: "natural_person",
+            ownership_pct: 40
+          }
+        ],
+        fiscal_year_end: "12-31",
+        company_address: {
+          street: "251 Little Falls Dr",
+          city: "Wilmington",
+          state: "DE",
+          zip: "19808"
+        }
+      };
+    case "restaurant":
+      return {
+        entity_type: "llc",
+        legal_name: name,
+        jurisdiction: "US-DE",
+        members: [
+          {
+            name: "Rosa Alvarez",
+            email: "rosa@example.com",
+            role: "manager",
+            investor_type: "natural_person",
+            ownership_pct: 55
+          },
+          {
+            name: "Noah Patel",
+            email: "noah@example.com",
+            role: "member",
+            investor_type: "natural_person",
+            ownership_pct: 45
+          }
+        ],
+        fiscal_year_end: "12-31",
+        company_address: {
+          street: "18 Market St",
+          city: "Wilmington",
+          state: "DE",
+          zip: "19801"
+        }
+      };
+    case "startup":
+    default:
+      return {
+        entity_type: "c_corp",
+        legal_name: name,
+        jurisdiction: "US-DE",
+        authorized_shares: 1e7,
+        par_value: "0.0001",
+        transfer_restrictions: true,
+        right_of_first_refusal: true,
+        members: [
+          {
+            name: "Alice Chen",
+            email: "alice@example.com",
+            role: "chair",
+            investor_type: "natural_person",
+            shares_purchased: 6e6,
+            officer_title: "ceo",
+            is_incorporator: true
+          },
+          {
+            name: "Bob Martinez",
+            email: "bob@example.com",
+            role: "director",
+            investor_type: "natural_person",
+            shares_purchased: 4e6,
+            officer_title: "cto"
+          }
+        ],
+        fiscal_year_end: "12-31",
+        company_address: {
+          street: "251 Little Falls Dr",
+          city: "Wilmington",
+          state: "DE",
+          zip: "19808"
+        }
+      };
+  }
+}
+function meetingTypeForBody(body) {
+  return String(body.body_type) === "llc_member_vote" ? "member_meeting" : "board_meeting";
+}
 async function demoCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  const resolver = new ReferenceResolver(client, cfg);
+  const scenario = opts.scenario ?? "startup";
   try {
-    const result = await withSpinner("Loading", () => client.seedDemo(opts.name));
-    printSuccess(`Demo seeded: ${result.entity_id ?? "OK"}`);
+    if (opts.minimal) {
+      const result2 = await withSpinner("Loading", () => client.seedDemo({
+        name: opts.name,
+        scenario
+      }));
+      if (opts.json) {
+        printJson(result2);
+        return;
+      }
+      printSuccess("Minimal demo seeded.");
+      printJson(result2);
+      return;
+    }
+    const formationPayload = scenarioConfig(opts.name, scenario);
+    const created = await withSpinner(
+      "Creating demo entity",
+      () => client.createFormationWithCapTable(formationPayload)
+    );
+    const entityId = String(created.entity_id ?? created.formation_id ?? "");
+    if (!entityId) {
+      throw new Error("demo formation did not return an entity_id");
+    }
+    await resolver.stabilizeRecord("entity", created);
+    resolver.rememberFromRecord("entity", created);
+    const activation = await withSpinner(
+      "Activating formation",
+      () => activateFormationEntity(client, resolver, entityId)
+    );
+    const agent = await withSpinner(
+      "Creating demo agent",
+      () => client.createAgent({
+        name: `${opts.name} Operator`,
+        entity_id: entityId,
+        system_prompt: `Operate ${opts.name} and keep the workspace data clean.`,
+        scopes: []
+      })
+    );
+    await resolver.stabilizeRecord("agent", agent);
+    resolver.rememberFromRecord("agent", agent);
+    const bodies = await client.listGovernanceBodies(entityId);
+    await resolver.stabilizeRecords("body", bodies, entityId);
+    let meeting;
+    if (bodies.length > 0) {
+      meeting = await client.scheduleMeeting({
+        entity_id: entityId,
+        body_id: bodies[0].body_id,
+        meeting_type: meetingTypeForBody(bodies[0]),
+        title: "Demo kickoff meeting",
+        agenda_item_titles: [
+          "Approve demo operating budget",
+          "Review founder vesting and cap table"
+        ]
+      });
+      await resolver.stabilizeRecord("meeting", meeting, entityId);
+      resolver.rememberFromRecord("meeting", meeting, entityId);
+    }
+    const workItem = await client.createWorkItem(entityId, {
+      title: "Review demo workspace",
+      description: "Check documents, governance, cap table, and treasury setup.",
+      category: "ops",
+      created_by_actor: {
+        actor_type: "agent",
+        actor_id: String(agent.agent_id)
+      }
+    });
+    await resolver.stabilizeRecord("work_item", workItem, entityId);
+    resolver.rememberFromRecord("work_item", workItem, entityId);
+    const claimedWorkItem = await client.claimWorkItem(entityId, String(workItem.work_item_id), {
+      claimed_by_actor: {
+        actor_type: "agent",
+        actor_id: String(agent.agent_id)
+      }
+    });
+    const bankAccount = await client.openBankAccount({
+      entity_id: entityId,
+      bank_name: "Mercury"
+    });
+    await resolver.stabilizeRecord("bank_account", bankAccount, entityId);
+    resolver.rememberFromRecord("bank_account", bankAccount, entityId);
+    const invoice = await client.createInvoice({
+      entity_id: entityId,
+      customer_name: "Acme Customer",
+      amount_cents: 25e4,
+      due_date: "2026-04-01",
+      description: "Demo advisory services"
+    });
+    await resolver.stabilizeRecord("invoice", invoice, entityId);
+    resolver.rememberFromRecord("invoice", invoice, entityId);
+    const contract = await client.generateContract({
+      entity_id: entityId,
+      template_type: "nda",
+      counterparty_name: "Example Counterparty",
+      effective_date: "2026-03-12",
+      parameters: {}
+    });
+    await resolver.stabilizeRecord("document", contract, entityId);
+    resolver.rememberFromRecord("document", contract, entityId);
+    const result = {
+      scenario,
+      entity: created,
+      activation,
+      agent,
+      meeting,
+      work_item: claimedWorkItem,
+      bank_account: bankAccount,
+      invoice,
+      contract
+    };
+    if (opts.json) {
+      printJson(result);
+      return;
+    }
+    printSuccess(`Demo environment created for ${opts.name}.`);
+    printReferenceSummary("entity", created, { showReuseHint: true });
+    printReferenceSummary("agent", agent, { showReuseHint: true });
+    if (meeting) {
+      printReferenceSummary("meeting", meeting, { showReuseHint: true });
+    }
+    printReferenceSummary("work_item", claimedWorkItem, { showReuseHint: true });
+    printReferenceSummary("invoice", invoice, { showReuseHint: true });
+    printReferenceSummary("bank_account", bankAccount, { showReuseHint: true });
     printJson(result);
   } catch (err) {
     printError(`Failed to seed demo: ${err}`);
@@ -6506,6 +7214,8 @@ var init_demo = __esm({
     init_api_client();
     init_output();
     init_spinner();
+    init_references();
+    init_formation_automation();
   }
 });
 
@@ -6535,7 +7245,15 @@ async function feedbackCommand(message, opts) {
     console.log(`
 ${chalk13.green("\u2713")} Feedback submitted (${chalk13.dim(result.feedback_id)})`);
   } catch (err) {
-    printError("Failed to submit feedback", err);
+    const detail = String(err);
+    if (detail.includes("404")) {
+      printError(
+        `Failed to submit feedback: ${detail}
+  This server does not expose /v1/feedback. Local api-rs dev servers currently do not support feedback submission.`
+      );
+    } else {
+      printError(`Failed to submit feedback: ${detail}`);
+    }
     process.exit(1);
   }
 }
@@ -6699,6 +7417,12 @@ var TAX_DOCUMENT_TYPE_CHOICES = [
   "w2",
   "form_w2"
 ];
+var FINALIZE_ITEM_STATUS_CHOICES = [
+  "discussed",
+  "voted",
+  "tabled",
+  "withdrawn"
+];
 var program = new Command();
 program.name("corp").description("corp \u2014 Corporate governance from the terminal").version(pkg.version);
 program.command("setup").description("Interactive setup wizard").action(async () => {
@@ -6949,7 +7673,10 @@ capTableCmd.command("approve-valuation <valuation-ref>").option("--resolution-id
     json: inheritOption(opts.json, parent.json)
   });
 });
-var financeCmd = program.command("finance").description("Invoicing, payroll, payments, banking").option("--entity-id <ref>", "Entity reference (ID, short ID, @last, or unique name)").option("--json", "Output as JSON");
+var financeCmd = program.command("finance").description("Invoicing, payroll, payments, banking").option("--entity-id <ref>", "Entity reference (ID, short ID, @last, or unique name)").option("--json", "Output as JSON").action(async (opts) => {
+  const { financeSummaryCommand: financeSummaryCommand2 } = await Promise.resolve().then(() => (init_finance(), finance_exports));
+  await financeSummaryCommand2(opts);
+});
 financeCmd.command("invoices").option("--json", "Output as JSON").description("List invoices").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { financeInvoicesCommand: financeInvoicesCommand2 } = await Promise.resolve().then(() => (init_finance(), finance_exports));
@@ -7173,7 +7900,12 @@ governanceCmd.command("agenda-items <meeting-ref>").description("List agenda ite
   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-ref> <item-ref>").requiredOption("--status <status>", "Status: voted, discussed, tabled, withdrawn").option("--json", "Output as JSON").option("--dry-run", "Show the request without finalizing the item").description("Finalize an agenda item").action(async (meetingId, itemId, opts, cmd) => {
+governanceCmd.command("finalize-item <meeting-ref> <item-ref>").addOption(
+  new Option(
+    "--status <status>",
+    `Status (${FINALIZE_ITEM_STATUS_CHOICES.join(", ")})`
+  ).choices([...FINALIZE_ITEM_STATUS_CHOICES]).makeOptionMandatory()
+).option("--json", "Output as JSON").option("--dry-run", "Show the request without finalizing the item").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, {
@@ -7209,6 +7941,24 @@ documentsCmd.command("signing-link <doc-ref>").option("--entity-id <ref>", "Enti
   const { documentsSigningLinkCommand: documentsSigningLinkCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsSigningLinkCommand2(docId, { entityId: opts.entityId ?? parent.entityId });
 });
+documentsCmd.command("sign <doc-ref>").option("--entity-id <ref>", "Entity reference (overrides active entity and parent command)").option("--signer-name <name>", "Manual signer name").option("--signer-role <role>", "Manual signer role").option("--signer-email <email>", "Manual signer email").option("--signature-text <text>", "Manual signature text (defaults to signer name)").option("--json", "Output as JSON").description("Sign a formation document, or auto-sign all missing required signatures").action(async (docId, opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { documentsSignCommand: documentsSignCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
+  await documentsSignCommand2(docId, {
+    ...opts,
+    entityId: opts.entityId ?? parent.entityId,
+    json: inheritOption(opts.json, parent.json)
+  });
+});
+documentsCmd.command("sign-all").option("--entity-id <ref>", "Entity reference (overrides active entity and parent command)").option("--json", "Output as JSON").description("Auto-sign all outstanding formation documents for an entity").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { documentsSignAllCommand: documentsSignAllCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
+  await documentsSignAllCommand2({
+    ...opts,
+    entityId: opts.entityId ?? parent.entityId,
+    json: inheritOption(opts.json, parent.json)
+  });
+});
 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)").option("--base-salary <amount>", "Employment offer base salary (for employment_offer)").option("--param <key=value>", "Additional template parameter (repeatable)", (value, values) => [...values, value], []).option("--json", "Output as JSON").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));
@@ -7218,7 +7968,7 @@ documentsCmd.command("generate").requiredOption("--template <type>", "Template t
     json: inheritOption(opts.json, parent.json)
   });
 });
-documentsCmd.command("preview-pdf").requiredOption("--definition-id <id>", "AST document definition ID (e.g. 'bylaws')").option("--document-id <id>", "Deprecated alias for --definition-id").description("Validate and print the authenticated PDF preview URL for a governance document").action(async (opts, cmd) => {
+documentsCmd.command("preview-pdf").option("--definition-id <id>", "AST document definition ID (e.g. 'bylaws')").option("--document-id <id>", "Deprecated alias for --definition-id").description("Validate and print the authenticated PDF preview URL for a governance document").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { documentsPreviewPdfCommand: documentsPreviewPdfCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsPreviewPdfCommand2({
@@ -7403,10 +8153,8 @@ billingCmd.command("upgrade").option("--plan <plan>", "Plan ID to upgrade to (fr
   await billingUpgradeCommand2(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-ref> <item-ref> ... to cast votes"
-  );
+  const { approvalsListCommand: approvalsListCommand2 } = await Promise.resolve().then(() => (init_approvals(), approvals_exports));
+  await approvalsListCommand2({});
 });
 var formCmd = program.command("form").description("Form a new entity with founders and cap table").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>", "Founder as 'name,email,role[,pct[,address[,officer_title[,is_incorporator]]]]' with address as street|city|state|zip, or key=value pairs like 'name=...,email=...,role=...,officer_title=cto,is_incorporator=true,address=street|city|state|zip' (repeatable)", (v, a) => [...a, v], []).option("--member-json <json>", "Founder JSON object (repeatable)", (v, a) => [...a, v], []).option("--members-file <path>", 'Path to a JSON array of founders or {"members": [...]}').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").option("--json", "Output as JSON").option("--dry-run", "Show the request without creating the entity").action(async (opts) => {
   if (opts.entityType && !opts.type) opts.type = opts.entityType;
@@ -7415,11 +8163,13 @@ var formCmd = program.command("form").description("Form a new entity with founde
   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)").option("--registered-agent-name <name>", "Registered agent legal name").option("--registered-agent-address <address>", "Registered agent address line").option("--formation-date <date>", "Formation date (RFC3339 or YYYY-MM-DD)").option("--fiscal-year-end <date>", "Fiscal year end (MM-DD)").option("--s-corp", "Elect S-Corp status").option("--transfer-restrictions", "Enable transfer restrictions").option("--rofr", "Enable right of first refusal").option("--company-address <address>", "Company address as 'street,city,state,zip'").option("--json", "Output as JSON").option("--dry-run", "Show the request without creating the pending entity").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { formCreateCommand: formCreateCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
   await formCreateCommand2({
     ...opts,
-    json: inheritOption(opts.json, cmd.parent.opts().json),
-    dryRun: inheritOption(opts.dryRun, cmd.parent.opts().dryRun)
+    jurisdiction: inheritOption(opts.jurisdiction, parent.jurisdiction),
+    json: inheritOption(opts.json, parent.json),
+    dryRun: inheritOption(opts.dryRun, parent.dryRun)
   });
 });
 formCmd.command("add-founder <entity-ref>").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").addOption(new Option("--officer-title <title>", "Officer title (corporations only)").choices(["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"])).option("--incorporator", "Mark as sole incorporator (corporations only)").option("--address <address>", "Founder address as 'street,city,state,zip'").option("--json", "Output as JSON").option("--dry-run", "Show the request without adding the founder").action(async (entityId, opts, cmd) => {
@@ -7438,11 +8188,19 @@ formCmd.command("finalize <entity-ref>").description("Finalize formation and gen
     dryRun: inheritOption(opts.dryRun, cmd.parent.opts().dryRun)
   });
 });
+formCmd.command("activate <entity-ref>").description("Programmatically sign formation documents and advance an entity to active").option("--evidence-uri <uri>", "Registered-agent consent evidence URI placeholder").option("--evidence-type <type>", "Registered-agent consent evidence type", "generated").option("--filing-id <id>", "External filing identifier to record").option("--receipt-reference <ref>", "External receipt reference to record").option("--ein <ein>", "EIN to confirm (defaults to a deterministic simulated EIN)").option("--json", "Output as JSON").option("--dry-run", "Show the activation plan without mutating").action(async (entityId, opts, cmd) => {
+  const { formActivateCommand: formActivateCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
+  await formActivateCommand2(entityId, {
+    ...opts,
+    json: inheritOption(opts.json, cmd.parent.opts().json),
+    dryRun: inheritOption(opts.dryRun, cmd.parent.opts().dryRun)
+  });
+});
 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);
 });
-program.command("demo").description("Seed a fully-populated demo corporation").requiredOption("--name <name>", "Corporation name").action(async (opts) => {
+program.command("demo").description("Create a usable demo workspace environment").requiredOption("--name <name>", "Corporation name").option("--scenario <scenario>", "Scenario to create (startup, llc, restaurant)", "startup").option("--minimal", "Use the minimal server-side demo seed instead of the full CLI workflow").option("--json", "Output as JSON").action(async (opts) => {
   const { demoCommand: demoCommand2 } = await Promise.resolve().then(() => (init_demo(), demo_exports));
   await demoCommand2(opts);
 });