@thecorporation/cli 26.3.36 → 26.3.38

package/dist/index.js

@@ -3552,6 +3552,10 @@ async function formCommand(opts) {
       right_of_first_refusal: rofr
     };
     if (companyAddress) payload.company_address = companyAddress;
+    if (entityType === "llc") {
+      const principalName = opts.principalName ?? founders[0]?.name;
+      if (principalName) payload.principal_name = principalName;
+    }
     if (opts.dryRun) {
       printDryRun("formation.create_with_cap_table", payload);
       return;
@@ -3619,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}`);
@@ -3976,7 +3993,9 @@ async function formCreateHandler(ctx) {
     await ctx.resolver.stabilizeRecord("entity", result);
     ctx.resolver.rememberFromRecord("entity", result);
     if (result.entity_id) {
-      setActiveEntityId(cfg, String(result.entity_id));
+      const newEntityId = String(result.entity_id);
+      setActiveEntityId(cfg, newEntityId);
+      ctx.resolver.remember("entity", newEntityId);
       saveConfig(cfg);
     }
     if (ctx.quiet) {
@@ -4119,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}`);
@@ -4210,7 +4249,8 @@ var init_formation = __esm({
           { flags: "--fiscal-year-end <date>", description: "Fiscal year end (MM-DD)", default: "12-31" },
           { flags: "--s-corp", description: "Elect S-Corp status" },
           { flags: "--transfer-restrictions", description: "Enable transfer restrictions" },
-          { flags: "--rofr", description: "Enable right of first refusal" }
+          { flags: "--rofr", description: "Enable right of first refusal" },
+          { flags: "--principal-name <name>", description: "Managing member name for LLCs (auto-set from first member if omitted)" }
         ],
         handler: formHandler,
         produces: { kind: "entity", trackEntity: true },
@@ -4250,7 +4290,7 @@ var init_formation = __esm({
         successTemplate: "Pending entity created: {legal_name}",
         examples: [
           'corp form create --type c_corp --name "Acme Inc" --jurisdiction US-DE --address "123 Main,City,ST,12345"',
-          'corp form create --type llc --name "My LLC" --jurisdiction US-WY'
+          'corp form create --type llc --name "My LLC" --jurisdiction US-WY --principal-name "Carlos"'
         ]
       },
       {