@thecorporation/cli 26.3.3 → 26.3.5

package/dist/index.js

@@ -819,19 +819,13 @@ var link_exports = {};
 __export(link_exports, {
   linkCommand: () => linkCommand
 });
-async function linkCommand() {
+async function linkCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const data = await client.createLink();
-    const code = data.code;
-    const expires = data.expires_in_seconds ?? 900;
-    console.log();
-    console.log(`  ${code}`);
-    console.log();
-    console.log(`Run this on the other device (expires in ${Math.floor(expires / 60)} minutes):`);
-    console.log(`  corp claim ${code}`);
-    console.log();
+    const data = await client.createLink(opts.externalId, opts.provider);
+    printSuccess(`Workspace linked to ${opts.provider} (external ID: ${opts.externalId})`);
+    if (data.workspace_id) console.log(`  Workspace: ${data.workspace_id}`);
   } catch (err) {
     printError(`${err}`);
     process.exit(1);
@@ -1297,7 +1291,12 @@ async function entitiesDissolveCommand(entityId, opts) {
     printSuccess(`Dissolution initiated: ${result.dissolution_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
-    printError(`Failed to dissolve entity: ${err}`);
+    const msg = String(err);
+    if (msg.includes("InvalidTransition") || msg.includes("422")) {
+      printError(`Cannot dissolve entity: only entities with 'active' status can be dissolved. Check the entity's current status with: corp entities show ${entityId}`);
+    } else {
+      printError(`Failed to dissolve entity: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1336,9 +1335,10 @@ async function contactsListCommand(opts) {
 }
 async function contactsShowCommand(contactId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const profile = await client.getContactProfile(contactId);
+    const profile = await client.getContactProfile(contactId, eid);
     if (opts.json) {
       printJson(profile);
     } else {
@@ -1390,9 +1390,10 @@ async function contactsAddCommand(opts) {
 }
 async function contactsEditCommand(contactId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const data = {};
+    const data = { entity_id: eid };
     if (opts.name != null) data.name = opts.name;
     if (opts.email != null) data.email = opts.email;
     if (opts.category != null) data.category = opts.category;
@@ -1515,7 +1516,12 @@ async function fourOhNineACommand(opts) {
     else if (!data || Object.keys(data).length === 0) console.log("No 409A valuation found.");
     else print409a(data);
   } catch (err) {
-    printError(`Failed to fetch 409A valuation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("404")) {
+      console.log("No 409A valuation found for this entity. Create one with:\n  corp cap-table create-valuation --type four_oh_nine_a --date YYYY-MM-DD --methodology <method>");
+    } else {
+      printError(`Failed to fetch 409A valuation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1618,13 +1624,20 @@ async function transferSharesCommand(opts) {
   const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const result = await client.transferShares({
+    const body = {
       entity_id: eid,
-      from_holder_id: opts.fromGrant,
-      to_holder_id: opts.to,
-      quantity: opts.shares,
-      transfer_type: opts.type
-    });
+      share_class_id: opts.shareClassId,
+      from_contact_id: opts.from,
+      to_contact_id: opts.to,
+      transfer_type: opts.type,
+      share_count: opts.shares,
+      governing_doc_type: opts.governingDocType,
+      transferee_rights: opts.transfereeRights,
+      prepare_intent_id: opts.prepareIntentId
+    };
+    if (opts.pricePerShareCents != null) body.price_per_share_cents = opts.pricePerShareCents;
+    if (opts.relationship) body.relationship_to_holder = opts.relationship;
+    const result = await client.transferShares(body);
     printSuccess(`Transfer workflow created: ${result.workflow_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
@@ -1735,7 +1748,12 @@ async function submitValuationCommand(opts) {
     if (result.agenda_item_id) console.log(`  Agenda Item: ${result.agenda_item_id}`);
     printJson(result);
   } catch (err) {
-    printError(`Failed to submit valuation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("404")) {
+      printError(`Valuation not found. List valuations with: corp cap-table valuations`);
+    } else {
+      printError(`Failed to submit valuation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1748,7 +1766,12 @@ async function approveValuationCommand(opts) {
     printSuccess(`Valuation approved: ${result.valuation_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
-    printError(`Failed to approve valuation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("400")) {
+      printError(`Bad request \u2014 a --resolution-id from a board vote may be required. Submit for approval first: corp cap-table submit-valuation <id>`);
+    } else {
+      printError(`Failed to approve valuation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -1937,8 +1960,7 @@ async function governanceAddSeatCommand(bodyId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const data = { holder_id: opts.holder };
-    if (opts.title) data.title = opts.title;
+    const data = { holder_id: opts.holder, role: opts.role ?? "member" };
     const result = await client.createGovernanceSeat(bodyId, data);
     printSuccess(`Seat added: ${result.seat_id ?? "OK"}`);
     printJson(result);
@@ -1963,9 +1985,10 @@ async function governanceListCommand(opts) {
 }
 async function governanceSeatsCommand(bodyId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const seats = await client.getGovernanceSeats(bodyId);
+    const seats = await client.getGovernanceSeats(bodyId, eid);
     if (opts.json) printJson(seats);
     else if (seats.length === 0) console.log("No seats found.");
     else printSeatsTable(seats);
@@ -1976,9 +1999,10 @@ async function governanceSeatsCommand(bodyId, opts) {
 }
 async function governanceMeetingsCommand(bodyId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const meetings = await client.listMeetings(bodyId);
+    const meetings = await client.listMeetings(bodyId, eid);
     if (opts.json) printJson(meetings);
     else if (meetings.length === 0) console.log("No meetings found.");
     else printMeetingsTable(meetings);
@@ -1989,9 +2013,10 @@ async function governanceMeetingsCommand(bodyId, opts) {
 }
 async function governanceResolutionsCommand(meetingId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const resolutions = await client.getMeetingResolutions(meetingId);
+    const resolutions = await client.getMeetingResolutions(meetingId, eid);
     if (opts.json) printJson(resolutions);
     else if (resolutions.length === 0) console.log("No resolutions found.");
     else printResolutionsTable(resolutions);
@@ -2169,13 +2194,18 @@ async function documentsListCommand(opts) {
     process.exit(1);
   }
 }
-async function documentsSigningLinkCommand(docId) {
+async function documentsSigningLinkCommand(docId, opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
+  const eid = resolveEntityId(cfg, opts.entityId);
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
-    const result = client.getSigningLink(docId);
+    const result = await client.getSigningLink(docId, eid);
     printSuccess(`Signing link: ${result.signing_url}`);
-    console.log("Open this link in your browser to sign the document.");
+    if (result.token) {
+      console.log(`  Token: ${result.token}`);
+      console.log(`  Share this URL with the signer:`);
+      console.log(`  https://humans.thecorporation.ai/sign/${docId}?token=${result.token}`);
+    }
   } catch (err) {
     printError(`Failed to get signing link: ${err}`);
     process.exit(1);
@@ -3112,9 +3142,9 @@ program.command("digest").description("View or trigger daily digests").option("-
   const { digestCommand: digestCommand2 } = await Promise.resolve().then(() => (init_digest(), digest_exports));
   await digestCommand2(opts);
 });
-program.command("link").description("Generate a claim code to pair another device").action(async () => {
+program.command("link").description("Link workspace to an external provider").requiredOption("--external-id <id>", "External ID to link").requiredOption("--provider <provider>", "Provider name (e.g. stripe, github)").action(async (opts) => {
   const { linkCommand: linkCommand2 } = await Promise.resolve().then(() => (init_link(), link_exports));
-  await linkCommand2();
+  await linkCommand2(opts);
 });
 program.command("claim <code>").description("Redeem a claim code to join a workspace").action(async (code) => {
   const { claimCommand: claimCommand2 } = await Promise.resolve().then(() => (init_claim(), claim_exports));
@@ -3144,18 +3174,20 @@ var contactsCmd = program.command("contacts").description("Contact management").
   const { contactsListCommand: contactsListCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
   await contactsListCommand2(opts);
 });
-contactsCmd.command("show <contact-id>").option("--json", "Output as JSON").description("Show contact detail/profile").action(async (contactId, opts) => {
+contactsCmd.command("show <contact-id>").option("--json", "Output as JSON").description("Show contact detail/profile").action(async (contactId, opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { contactsShowCommand: contactsShowCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
-  await contactsShowCommand2(contactId, opts);
+  await contactsShowCommand2(contactId, { ...opts, entityId: parent.entityId });
 });
-contactsCmd.command("add").requiredOption("--name <name>", "Contact name").requiredOption("--email <email>", "Contact email").option("--type <type>", "Contact type (individual, organization)", "individual").option("--category <category>", "Category (employee, contractor, board_member, investor, law_firm, valuation_firm, accounting_firm, officer, advisor)").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Add a new contact").action(async (opts, cmd) => {
+contactsCmd.command("add").requiredOption("--name <name>", "Contact name").requiredOption("--email <email>", "Contact email").option("--type <type>", "Contact type (individual, organization)", "individual").option("--category <category>", "Category (employee, contractor, board_member, investor, law_firm, valuation_firm, accounting_firm, officer, founder, member, other)").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Add a new contact").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { contactsAddCommand: contactsAddCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
   await contactsAddCommand2({ ...opts, entityId: parent.entityId });
 });
-contactsCmd.command("edit <contact-id>").option("--name <name>", "Contact name").option("--email <email>", "Contact email").option("--category <category>", "Contact category").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Edit an existing contact").action(async (contactId, opts) => {
+contactsCmd.command("edit <contact-id>").option("--name <name>", "Contact name").option("--email <email>", "Contact email").option("--category <category>", "Contact category").option("--phone <phone>", "Phone number").option("--notes <notes>", "Notes").description("Edit an existing contact").action(async (contactId, opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { contactsEditCommand: contactsEditCommand2 } = await Promise.resolve().then(() => (init_contacts(), contacts_exports));
-  await contactsEditCommand2(contactId, opts);
+  await contactsEditCommand2(contactId, { ...opts, entityId: parent.entityId });
 });
 var capTableCmd = program.command("cap-table").description("Cap table, equity grants, SAFEs, transfers, and valuations").option("--entity-id <id>", "Entity ID (overrides active entity)").option("--json", "Output as JSON").action(async (opts) => {
   const { capTableCommand: capTableCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
@@ -3181,7 +3213,7 @@ capTableCmd.command("409a").description("Current 409A valuation").action(async (
   const { fourOhNineACommand: fourOhNineACommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await fourOhNineACommand2(parent);
 });
-capTableCmd.command("issue-equity").requiredOption("--grant-type <type>", "Grant type (e.g. founder, advisor, employee, investor)").requiredOption("--shares <n>", "Number of shares", parseInt).requiredOption("--recipient <name>", "Recipient name").option("--email <email>", "Recipient email (auto-creates contact if needed)").option("--instrument-id <id>", "Instrument ID (auto-detected from cap table if omitted)").description("Issue an equity grant (creates a round, adds security, and issues it)").action(async (opts, cmd) => {
+capTableCmd.command("issue-equity").requiredOption("--grant-type <type>", "Grant type (common, preferred, membership_unit, stock_option, iso, nso, rsa)").requiredOption("--shares <n>", "Number of shares", parseInt).requiredOption("--recipient <name>", "Recipient name").option("--email <email>", "Recipient email (auto-creates contact if needed)").option("--instrument-id <id>", "Instrument ID (auto-detected from cap table if omitted)").description("Issue an equity grant (creates a round, adds security, and issues it)").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { issueEquityCommand: issueEquityCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await issueEquityCommand2({ ...opts, entityId: parent.entityId });
@@ -3191,7 +3223,7 @@ capTableCmd.command("issue-safe").requiredOption("--investor <name>", "Investor
   const { issueSafeCommand: issueSafeCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await issueSafeCommand2({ ...opts, entityId: parent.entityId });
 });
-capTableCmd.command("transfer").requiredOption("--from-grant <id>", "Source grant ID").requiredOption("--to <name>", "Recipient name").requiredOption("--shares <n>", "Number of shares", parseInt).option("--type <type>", "Transfer type", "sale").description("Transfer shares").action(async (opts, cmd) => {
+capTableCmd.command("transfer").requiredOption("--from <id>", "Source contact ID (from_contact_id)").requiredOption("--to <id>", "Destination contact ID (to_contact_id)").requiredOption("--shares <n>", "Number of shares to transfer", parseInt).requiredOption("--share-class-id <id>", "Share class ID").requiredOption("--governing-doc-type <type>", "Governing document type").requiredOption("--transferee-rights <rights>", "Transferee rights").requiredOption("--prepare-intent-id <id>", "Prepare intent ID").option("--type <type>", "Transfer type", "sale").option("--price-per-share-cents <n>", "Price per share in cents", parseInt).option("--relationship <rel>", "Relationship to holder").description("Create a share transfer workflow").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { transferSharesCommand: transferSharesCommand2 } = await Promise.resolve().then(() => (init_cap_table(), cap_table_exports));
   await transferSharesCommand2({ ...opts, entityId: parent.entityId });
@@ -3271,7 +3303,7 @@ governanceCmd.command("create-body").requiredOption("--name <name>", "Body name
   const { governanceCreateBodyCommand: governanceCreateBodyCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceCreateBodyCommand2({ ...opts, entityId: parent.entityId });
 });
-governanceCmd.command("add-seat <body-id>").requiredOption("--holder <contact-id>", "Contact ID for the seat holder").option("--title <title>", "Seat title (e.g. 'Director', 'Member')").description("Add a seat to a governance body").action(async (bodyId, opts) => {
+governanceCmd.command("add-seat <body-id>").requiredOption("--holder <contact-id>", "Contact ID for the seat holder").option("--role <role>", "Seat role (chair, member, officer, observer)", "member").description("Add a seat to a governance body").action(async (bodyId, opts) => {
   const { governanceAddSeatCommand: governanceAddSeatCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceAddSeatCommand2(bodyId, opts);
 });
@@ -3295,7 +3327,7 @@ governanceCmd.command("convene").requiredOption("--body <id>", "Governance body
   const { governanceConveneCommand: governanceConveneCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceConveneCommand2({ ...opts, meetingType: opts.type, entityId: parent.entityId });
 });
-governanceCmd.command("vote <meeting-id> <item-id>").requiredOption("--voter <name>", "Voter name/ID").requiredOption("--vote <value>", "Vote (yea, nay, abstain)").description("Cast a vote on an agenda item").action(async (meetingId, itemId, opts) => {
+governanceCmd.command("vote <meeting-id> <item-id>").requiredOption("--voter <id>", "Voter contact UUID").requiredOption("--vote <value>", "Vote (for, against, abstain, recusal)").description("Cast a vote on an agenda item").action(async (meetingId, itemId, opts) => {
   const { governanceVoteCommand: governanceVoteCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await governanceVoteCommand2(meetingId, itemId, opts);
 });
@@ -3319,7 +3351,7 @@ governanceCmd.command("agenda-items <meeting-id>").description("List agenda item
   const { listAgendaItemsCommand: listAgendaItemsCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await listAgendaItemsCommand2(meetingId, { entityId: parent.entityId, json: parent.json });
 });
-governanceCmd.command("finalize-item <meeting-id> <item-id>").requiredOption("--status <status>", "Status: Voted, Discussed, Tabled, or Withdrawn").description("Finalize an agenda item").action(async (meetingId, itemId, opts, cmd) => {
+governanceCmd.command("finalize-item <meeting-id> <item-id>").requiredOption("--status <status>", "Status: voted, discussed, tabled, or withdrawn").description("Finalize an agenda item").action(async (meetingId, itemId, opts, cmd) => {
   const parent = cmd.parent.opts();
   const { finalizeAgendaItemCommand: finalizeAgendaItemCommand2 } = await Promise.resolve().then(() => (init_governance(), governance_exports));
   await finalizeAgendaItemCommand2(meetingId, itemId, { ...opts, entityId: parent.entityId });
@@ -3338,9 +3370,10 @@ var documentsCmd = program.command("documents").description("Documents and signi
   const { documentsListCommand: documentsListCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsListCommand2(opts);
 });
-documentsCmd.command("signing-link <doc-id>").description("Get a signing link for a document").action(async (docId) => {
+documentsCmd.command("signing-link <doc-id>").description("Get a signing link for a document").action(async (docId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
   const { documentsSigningLinkCommand: documentsSigningLinkCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
-  await documentsSigningLinkCommand2(docId);
+  await documentsSigningLinkCommand2(docId, { entityId: parent.entityId });
 });
 documentsCmd.command("generate").requiredOption("--template <type>", "Template type (consulting_agreement, employment_offer, contractor_agreement, nda, custom)").requiredOption("--counterparty <name>", "Counterparty name").option("--effective-date <date>", "Effective date (ISO 8601, defaults to today)").description("Generate a contract from a template").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
@@ -3417,8 +3450,9 @@ program.command("approvals").description("Approvals are managed through governan
     "Approvals are managed through governance meetings.\n  Use: corp governance convene ... to schedule a board meeting\n  Use: corp governance vote <meeting-id> <item-id> ... to cast votes"
   );
 });
-var formCmd = program.command("form").description("Form a new entity with founders and cap table (Cooley-style)").option("--entity-type <type>", "Entity type (llc, c_corp)").option("--name <name>", "Legal name").option("--jurisdiction <jurisdiction>", "Jurisdiction (e.g. US-DE, US-WY)").option("--member <member>", "Member as 'name,email,role[,pct]' \u2014 role: director|officer|manager|member|chair (repeatable)", (v, a) => [...a, v], []).option("--address <address>", "Company address as 'street,city,state,zip'").option("--fiscal-year-end <date>", "Fiscal year end (MM-DD)", "12-31").option("--s-corp", "Elect S-Corp status").option("--transfer-restrictions", "Enable transfer restrictions").option("--rofr", "Enable right of first refusal").action(async (opts) => {
+var formCmd = program.command("form").description("Form a new entity with founders and cap table (Cooley-style)").option("--entity-type <type>", "Entity type (llc, c_corp)").option("--legal-name <name>", "Legal name").option("--jurisdiction <jurisdiction>", "Jurisdiction (e.g. US-DE, US-WY)").option("--member <member>", "Member as 'name,email,role[,pct]' \u2014 role: director|officer|manager|member|chair (repeatable)", (v, a) => [...a, v], []).option("--address <address>", "Company address as 'street,city,state,zip'").option("--fiscal-year-end <date>", "Fiscal year end (MM-DD)", "12-31").option("--s-corp", "Elect S-Corp status").option("--transfer-restrictions", "Enable transfer restrictions").option("--rofr", "Enable right of first refusal").action(async (opts) => {
   if (opts.entityType && !opts.type) opts.type = opts.entityType;
+  if (opts.legalName && !opts.name) opts.name = opts.legalName;
   const { formCommand: formCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
   await formCommand2(opts);
 });