@thecorporation/cli 26.3.37 → 26.3.39

package/dist/index.js

@@ -3623,12 +3623,25 @@ async function formCommand(opts) {
   } catch (err) {
     if (err instanceof Error && err.message.includes("exit")) throw err;
     const msg = String(err);
+    const hints = [];
+    if (msg.includes("incorporator_address")) {
+      hints.push('Add an address to a founder: --member "Name,email,director,100,street|city|state|zip,ceo,true"');
+    }
+    if (msg.includes("company_address")) {
+      hints.push('Add --address "street,city,state,zip" for the company address (required for C-Corps)');
+    }
+    if (msg.includes("principal_name")) {
+      hints.push('Add --principal-name "Manager Name" (auto-set from first member for LLCs)');
+    }
     if (msg.includes("officers_list") || msg.includes("officer")) {
+      hints.push('C-Corp directors need an officer_title: --member "Name,email,director,100,,,ceo"');
+    }
+    if (hints.length > 0) {
       printError(
         `Formation failed: ${msg}
-  Hint: C-Corp directors need an officer_title. Use --member with officer_title field, e.g.:
-    --member 'name=Alice,email=a@co.com,role=director,officer_title=ceo,pct=100'
-  Or use --member-json with {"officer_title": "ceo"}`
+
+  Missing fields \u2014 fix all at once:
+` + hints.map((h) => `    - ${h}`).join("\n")
       );
     } else {
       printError(`Failed to create formation: ${err}`);
@@ -4125,11 +4138,31 @@ async function formFinalizeHandler(ctx) {
     }
   } catch (err) {
     const msg = String(err);
+    const hints = [];
+    if (msg.includes("incorporator_address")) {
+      hints.push('--incorporator-address "123 Main St,City,ST,12345"');
+    }
+    if (msg.includes("company_address")) {
+      hints.push('--company-address "123 Main St,City,ST,12345"');
+    }
+    if (msg.includes("principal_name")) {
+      hints.push('--principal-name "Managing Member Name"');
+    }
     if (msg.includes("officers_list") || msg.includes("officer")) {
+      hints.push("Add a founder with --officer-title: corp form add-founder @last --role director --officer-title ceo ...");
+    }
+    if (msg.includes("incorporator_name")) {
+      hints.push('--incorporator-name "Incorporator Name"');
+    }
+    if (hints.length > 0) {
       printError(
         `Finalization failed: ${msg}
-  Hint: C-Corp entities require at least one founder with an officer_title.
-  Add a founder with: corp form add-founder @last:entity --name '...' --email '...' --role director --pct 100 --officer-title ceo`
+
+  To fix, re-run finalize with the missing fields:
+` + hints.map((h) => `    ${h}`).join("\n") + `
+
+  Example:
+    corp form finalize @last ${hints.filter((h) => h.startsWith("--")).join(" ")}`
       );
     } else {
       printError(`Failed to finalize formation: ${err}`);