@thecorporation/cli 26.3.9 → 26.3.10

package/dist/index.js

@@ -430,12 +430,14 @@ function printBillingPanel(status, plans) {
   const plan = s(status.plan ?? status.tier) || "free";
   const subStatus = s(status.status) || "active";
   const periodEnd = s(status.current_period_end);
+  const explanation = s(status.status_explanation);
   console.log(chalk.green("\u2500".repeat(50)));
   console.log(chalk.green.bold("  Billing Status"));
   console.log(chalk.green("\u2500".repeat(50)));
   console.log(`  ${chalk.bold("Plan:")} ${plan}`);
   console.log(`  ${chalk.bold("Status:")} ${subStatus}`);
   if (periodEnd) console.log(`  ${chalk.bold("Current Period End:")} ${periodEnd}`);
+  if (explanation) console.log(`  ${chalk.bold("Explanation:")} ${explanation}`);
   console.log(chalk.dim("  Manage:  corp billing portal"));
   console.log(chalk.dim("  Upgrade: corp billing upgrade --plan <plan>"));
   console.log(chalk.green("\u2500".repeat(50)));
@@ -816,7 +818,14 @@ async function digestCommand(opts) {
   try {
     if (opts.trigger) {
       const result = await client.triggerDigest();
-      printSuccess("Digest triggered.");
+      const message = (() => {
+        const value = result.message;
+        return typeof value === "string" && value.trim() ? value : null;
+      })();
+      printSuccess(result.digest_count > 0 ? "Digest triggered." : "Digest trigger accepted.");
+      if (message) {
+        printWarning(message);
+      }
       printJson(result);
     } else if (opts.key) {
       const result = await client.getDigest(opts.key);
@@ -1246,12 +1255,24 @@ __export(entities_exports, {
   entitiesShowCommand: () => entitiesShowCommand
 });
 import chalk3 from "chalk";
+function wantsJsonOutput(opts) {
+  if (opts && typeof opts === "object") {
+    const json = opts.json;
+    if (typeof json === "boolean") return json;
+    const commandOpts = opts.opts;
+    if (typeof commandOpts === "function") {
+      return Boolean(commandOpts().json);
+    }
+  }
+  return false;
+}
 async function entitiesCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  const jsonOutput = wantsJsonOutput(opts);
   try {
-    const entities = await withSpinner("Loading", () => client.listEntities(), opts.json);
-    if (opts.json) {
+    const entities = await withSpinner("Loading", () => client.listEntities(), jsonOutput);
+    if (jsonOutput) {
       printJson(entities);
     } else if (entities.length === 0) {
       console.log("No entities found.");
@@ -1266,6 +1287,7 @@ async function entitiesCommand(opts) {
 async function entitiesShowCommand(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 jsonOutput = wantsJsonOutput(opts);
   try {
     const entities = await client.listEntities();
     const entity = entities.find((e) => e.entity_id === entityId);
@@ -1273,7 +1295,7 @@ async function entitiesShowCommand(entityId, opts) {
       printError(`Entity not found: ${entityId}`);
       process.exit(1);
     }
-    if (opts.json) {
+    if (jsonOutput) {
       printJson(entity);
     } else {
       console.log(chalk3.blue("\u2500".repeat(40)));
@@ -1407,11 +1429,9 @@ async function contactsAddCommand(opts) {
       category: opts.category ?? "employee"
     };
     if (opts.phone) data.phone = opts.phone;
+    if (opts.notes) data.notes = opts.notes;
     const result = await client.createContact(data);
     printSuccess(`Contact created: ${result.contact_id ?? result.id ?? "OK"}`);
-    if (opts.notes) {
-      console.log(chalk4.dim('  Tip: To add notes, use: corp contacts edit <contact-id> --notes "..."'));
-    }
   } catch (err) {
     printError(`Failed to create contact: ${err}`);
     process.exit(1);
@@ -2272,12 +2292,9 @@ async function documentsSigningLinkCommand(docId, opts) {
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   try {
     const result = await client.getSigningLink(docId, eid);
-    printSuccess(`Signing link: ${result.signing_url}`);
-    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}`);
-    }
+    const shareUrl = result.token ? `https://humans.thecorporation.ai/sign/${docId}?token=${result.token}` : result.signing_url ?? `https://humans.thecorporation.ai/sign/${docId}`;
+    printSuccess("Signing link generated.");
+    console.log(shareUrl);
   } catch (err) {
     printError(`Failed to get signing link: ${err}`);
     process.exit(1);
@@ -2677,12 +2694,25 @@ function makeClient() {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   return new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
 }
+function enrichBillingStatus(status) {
+  if (typeof status.status_explanation === "string" && status.status_explanation.trim()) {
+    return status;
+  }
+  const plan = String(status.plan ?? status.tier ?? "").trim();
+  const subStatus = String(status.status ?? "").trim();
+  if (subStatus !== "pending_checkout") {
+    return status;
+  }
+  const statusExplanation = plan ? `Checkout for the ${plan} plan has started, but billing will not become active until Stripe checkout is completed.` : "Checkout has started, but billing will not become active until Stripe checkout is completed.";
+  return { ...status, status_explanation: statusExplanation };
+}
 async function billingCommand(opts) {
   const client = makeClient();
   try {
     const [status, plans] = await Promise.all([client.getBillingStatus(), client.getBillingPlans()]);
-    if (opts.json) printJson({ status, plans });
-    else printBillingPanel(status, plans);
+    const enrichedStatus = enrichBillingStatus(status);
+    if (opts.json) printJson({ status: enrichedStatus, plans });
+    else printBillingPanel(enrichedStatus, plans);
   } catch (err) {
     printError(`Failed to fetch billing info: ${err}`);
     process.exit(1);
@@ -3017,6 +3047,14 @@ async function formCommand(opts) {
     process.exit(1);
   }
 }
+function parseCsvAddress(raw) {
+  if (!raw) return void 0;
+  const parts = raw.split(",").map((p) => p.trim()).filter(Boolean);
+  if (parts.length !== 4) {
+    throw new Error(`Invalid address format: ${raw}. Expected 'street,city,state,zip'`);
+  }
+  return { street: parts[0], city: parts[1], state: parts[2], zip: parts[3] };
+}
 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);
@@ -3027,6 +3065,15 @@ async function formCreateCommand(opts) {
       legal_name: opts.name
     };
     if (opts.jurisdiction) payload.jurisdiction = opts.jurisdiction;
+    if (opts.registeredAgentName) payload.registered_agent_name = opts.registeredAgentName;
+    if (opts.registeredAgentAddress) payload.registered_agent_address = opts.registeredAgentAddress;
+    if (opts.formationDate) payload.formation_date = opts.formationDate;
+    if (opts.fiscalYearEnd) payload.fiscal_year_end = opts.fiscalYearEnd;
+    if (opts.sCorp !== void 0) payload.s_corp_election = opts.sCorp;
+    if (opts.transferRestrictions !== void 0) payload.transfer_restrictions = opts.transferRestrictions;
+    if (opts.rofr !== void 0) payload.right_of_first_refusal = opts.rofr;
+    const companyAddress = parseCsvAddress(opts.companyAddress);
+    if (companyAddress) payload.company_address = companyAddress;
     const result = await client.createPendingEntity(payload);
     printSuccess(`Pending entity created: ${result.entity_id}`);
     console.log(`  Name: ${result.legal_name}`);
@@ -3052,6 +3099,8 @@ async function formAddFounderCommand(entityId, opts) {
     };
     if (opts.officerTitle) payload.officer_title = opts.officerTitle.toLowerCase();
     if (opts.incorporator) payload.is_incorporator = true;
+    const address = parseCsvAddress(opts.address);
+    if (address) payload.address = address;
     const result = await client.addFounder(entityId, payload);
     printSuccess(`Founder added (${result.member_count} total)`);
     const members = result.members ?? [];
@@ -3066,11 +3115,29 @@ async function formAddFounderCommand(entityId, opts) {
     process.exit(1);
   }
 }
-async function formFinalizeCommand(entityId) {
+async function formFinalizeCommand(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 result = await client.finalizeFormation(entityId);
+    const payload = {};
+    if (opts.authorizedShares) {
+      const authorizedShares = parseInt(opts.authorizedShares, 10);
+      if (!Number.isFinite(authorizedShares)) {
+        throw new Error(`Invalid authorized shares: ${opts.authorizedShares}`);
+      }
+      payload.authorized_shares = authorizedShares;
+    }
+    if (opts.parValue) payload.par_value = opts.parValue;
+    if (opts.registeredAgentName) payload.registered_agent_name = opts.registeredAgentName;
+    if (opts.registeredAgentAddress) payload.registered_agent_address = opts.registeredAgentAddress;
+    if (opts.formationDate) payload.formation_date = opts.formationDate;
+    if (opts.fiscalYearEnd) payload.fiscal_year_end = opts.fiscalYearEnd;
+    if (opts.sCorp !== void 0) payload.s_corp_election = opts.sCorp;
+    if (opts.transferRestrictions !== void 0) payload.transfer_restrictions = opts.transferRestrictions;
+    if (opts.rofr !== void 0) payload.right_of_first_refusal = opts.rofr;
+    const companyAddress = parseCsvAddress(opts.companyAddress);
+    if (companyAddress) payload.company_address = companyAddress;
+    const result = await client.finalizeFormation(entityId, payload);
     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}`);
@@ -3372,9 +3439,9 @@ var entitiesCmd = program.command("entities").description("List entities, show d
   const { entitiesCommand: entitiesCommand2 } = await Promise.resolve().then(() => (init_entities(), entities_exports));
   await entitiesCommand2(opts);
 });
-entitiesCmd.command("show <entity-id>").option("--json", "Output as JSON").description("Show entity detail").action(async (entityId, opts) => {
+entitiesCmd.command("show <entity-id>").option("--json", "Output as JSON").description("Show entity detail").action(async (entityId, opts, cmd) => {
   const { entitiesShowCommand: entitiesShowCommand2 } = await Promise.resolve().then(() => (init_entities(), entities_exports));
-  await entitiesShowCommand2(entityId, opts);
+  await entitiesShowCommand2(entityId, { ...cmd.opts(), ...opts });
 });
 entitiesCmd.command("convert <entity-id>").requiredOption("--to <type>", "Target entity type (llc, c_corp)").option("--jurisdiction <jurisdiction>", "New jurisdiction").description("Convert entity to a different type").action(async (entityId, opts) => {
   const { entitiesConvertCommand: entitiesConvertCommand2 } = await Promise.resolve().then(() => (init_entities(), entities_exports));
@@ -3585,10 +3652,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, _opts, cmd) => {
+documentsCmd.command("signing-link <doc-id>").option("--entity-id <id>", "Entity ID (overrides active entity and parent command)").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, { entityId: parent.entityId });
+  await documentsSigningLinkCommand2(docId, { entityId: opts.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();
@@ -3701,17 +3768,17 @@ var formCmd = program.command("form").description("Form a new entity with founde
   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) => {
+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'").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) => {
+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)").option("--address <address>", "Founder address as 'street,city,state,zip'").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) => {
+formCmd.command("finalize <entity-id>").description("Finalize formation and generate documents + cap table (staged flow step 3)").option("--authorized-shares <count>", "Authorized shares for corporations").option("--par-value <value>", "Par value per share, e.g. 0.0001").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'").action(async (entityId, opts) => {
   const { formFinalizeCommand: formFinalizeCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
-  await formFinalizeCommand2(entityId);
+  await formFinalizeCommand2(entityId, opts);
 });
 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));