@thecorporation/cli 26.3.23 → 26.3.24

package/dist/index.js

@@ -3077,8 +3077,15 @@ async function digestCommand(opts) {
       printJson(result);
     } else {
       const digests = await client.listDigests();
-      if (digests.length === 0) console.log("No digest history found.");
-      else printJson(digests);
+      if (digests.length === 0) {
+        if (opts.json) {
+          printJson([]);
+        } else {
+          console.log("No digest history found.");
+        }
+      } else {
+        printJson(digests);
+      }
     }
   } catch (err) {
     printError2(`Failed: ${err}`);
@@ -3128,6 +3135,12 @@ __export(claim_exports, {
 async function claimCommand(code) {
   const cfg = loadConfig();
   const apiUrl = (cfg.api_url || "https://api.thecorporation.ai").replace(/\/+$/, "");
+  if (apiUrl.startsWith("process://")) {
+    printError2(
+      "Claim codes require a remote API server.\n  Run: npx corp config set api_url https://api.thecorporation.ai --force\n  Or use: npx corp setup"
+    );
+    process.exit(1);
+  }
   try {
     const resp = await fetch(`${apiUrl}/v1/workspaces/claim`, {
       method: "POST",
@@ -4125,6 +4138,16 @@ async function issueEquityCommand(opts) {
       grant_type: opts.grantType
     };
     if (opts.email) securityData.email = opts.email;
+    const existingHolders = capTable.holders ?? [];
+    const matchingHolder = existingHolders.find((h) => {
+      const nameMatch = String(h.name ?? "").toLowerCase() === opts.recipient.toLowerCase();
+      const emailMatch = opts.email && String(h.email ?? "").toLowerCase() === opts.email.toLowerCase();
+      return nameMatch || emailMatch;
+    });
+    if (matchingHolder) {
+      const holderId = matchingHolder.holder_id ?? matchingHolder.contact_id ?? matchingHolder.id;
+      if (holderId) securityData.holder_id = holderId;
+    }
     await client.addRoundSecurity(roundId, securityData);
     const issuePayload = { entity_id: eid };
     if (meetingId) issuePayload.meeting_id = meetingId;
@@ -4613,6 +4636,10 @@ async function dilutionPreviewCommand(opts) {
       printJson(result);
       return;
     }
+    if (result.round_status === "closed" || result.round_status === "issued") {
+      console.log(chalk7.yellow("Note: This round is already closed. Dilution preview reflects the finalized state, not a scenario model."));
+      console.log(chalk7.dim("  For scenario modeling, create a new round with: corp cap-table start-round --name '...' --issuer-legal-entity-id '...'"));
+    }
     printJson(result);
   } catch (err) {
     printError2(`Failed to preview dilution: ${err}`);
@@ -4626,14 +4653,42 @@ async function controlMapCommand(opts) {
   try {
     const eid = await resolver.resolveEntity(opts.entityId);
     const rootEntityId = opts.rootEntityId ? await resolver.resolveEntity(opts.rootEntityId) : eid;
-    const result = await client.getControlMap(eid, rootEntityId);
+    let result;
+    try {
+      result = await client.getControlMap(eid, rootEntityId);
+    } catch (firstErr) {
+      const msg = String(firstErr);
+      if (msg.includes("404") && !opts.rootEntityId) {
+        try {
+          const capTable = await client.getCapTable(eid);
+          const issuerLegalEntityId = capTable.issuer_legal_entity_id;
+          if (issuerLegalEntityId && issuerLegalEntityId !== eid) {
+            result = await client.getControlMap(eid, issuerLegalEntityId);
+          } else {
+            throw firstErr;
+          }
+        } catch {
+          throw firstErr;
+        }
+      } else {
+        throw firstErr;
+      }
+    }
     if (opts.json) {
       printJson(result);
       return;
     }
     printJson(result);
   } catch (err) {
-    printError2(`Failed to fetch control map: ${err}`);
+    const msg = String(err);
+    if (msg.includes("404") && (msg.includes("root_entity_id") || msg.includes("not found"))) {
+      printError2(
+        `Control map: entity not found. Ensure the entity is active and has a cap table.
+  Try: corp cap-table control-map --root-entity-id <legal-entity-id>`
+      );
+    } else {
+      printError2(`Failed to fetch control map: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -5521,12 +5576,22 @@ async function writtenConsentCommand(opts) {
     const result = await client.writtenConsent(payload);
     await resolver.stabilizeRecord("meeting", result, eid);
     resolver.rememberFromRecord("meeting", result, eid);
-    const meetingId = result.meeting_id ?? "OK";
+    const meetingId = String(result.meeting_id ?? "");
+    if (meetingId) {
+      try {
+        const seats = await client.getGovernanceSeats(resolvedBodyId, eid);
+        const seatIds = seats.map((s2) => String(s2.seat_id ?? s2.id ?? "")).filter((id) => id.length > 0);
+        if (seatIds.length > 0) {
+          await client.conveneMeeting(meetingId, eid, { present_seat_ids: seatIds });
+        }
+      } catch {
+      }
+    }
     if (opts.json) {
       printJson(result);
       return;
     }
-    printSuccess(`Written consent created: ${meetingId}`);
+    printSuccess(`Written consent created: ${meetingId || "OK"}`);
     printReferenceSummary("meeting", result, { showReuseHint: true });
     console.log(chalk8.dim("\n  Next steps:"));
     console.log(chalk8.dim(`    corp governance agenda-items @last:meeting`));
@@ -5895,7 +5960,17 @@ async function documentsSigningLinkCommand(docId, opts) {
   const resolver = new ReferenceResolver(client, cfg);
   try {
     const eid = await resolver.resolveEntity(opts.entityId);
-    const resolvedDocumentId = await resolver.resolveDocument(eid, docId);
+    let resolvedDocumentId;
+    try {
+      resolvedDocumentId = await resolver.resolveDocument(eid, docId);
+    } catch {
+      printError2(
+        `Could not resolve '${docId}' as a document. If you just generated a contract, use the document_id from the generate output, not @last (which may reference the contract_id).
+  List documents with: corp documents`
+      );
+      process.exit(1);
+      return;
+    }
     const result = await client.getSigningLink(resolvedDocumentId, eid);
     const shareUrl = formatSigningLink(resolvedDocumentId, result);
     if (process.stdout.isTTY) {
@@ -5940,13 +6015,33 @@ async function documentsGenerateCommand(opts) {
     });
     await resolver.stabilizeRecord("document", result, eid);
     resolver.rememberFromRecord("document", result, eid);
+    if (result.document_id) {
+      resolver.remember("document", String(result.document_id), eid);
+    }
     printWriteResult(result, `Contract generated: ${result.contract_id ?? "OK"}`, {
       jsonOnly: opts.json,
       referenceKind: "document",
       showReuseHint: true
     });
   } catch (err) {
-    printError2(`Failed to generate contract: ${err}`);
+    const msg = String(err);
+    if (opts.template === "employment_offer" && (msg.includes("department") || msg.includes("required"))) {
+      printError2(
+        `Failed to generate employment_offer: ${msg}
+  Hint: employment_offer requires additional parameters. Use --param for each:
+    --param department=Engineering --param dispute_resolution_terms=arbitration
+    --param equity_grant_type=stock_option --param equity_shares=10000
+  Or pass --base-salary 150000`
+      );
+    } else if (opts.template === "safe_agreement" && (msg.includes("purchase_amount") || msg.includes("required"))) {
+      printError2(
+        `Failed to generate safe_agreement: ${msg}
+  Hint: safe_agreement requires purchase_amount. Use:
+    --param purchase_amount=50000000`
+      );
+    } else {
+      printError2(`Failed to generate contract: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -6283,7 +6378,15 @@ async function agentsCreateCommand(opts) {
       showReuseHint: true
     });
   } catch (err) {
-    printError2(`Failed to create agent: ${err}`);
+    const msg = String(err);
+    if (msg.includes("409") || msg.includes("conflict") || msg.includes("already exists")) {
+      printError2(
+        `Agent name '${opts.name}' is already in use (deleted agents still reserve their name).
+  Choose a different name, e.g.: corp agents create --name '...-v2' --prompt '...'`
+      );
+    } else {
+      printError2(`Failed to create agent: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -6309,7 +6412,16 @@ async function agentsResumeCommand(agentId, opts) {
     const result = await client.updateAgent(resolvedAgentId, { status: "active" });
     printWriteResult(result, `Agent ${resolvedAgentId} resumed.`, opts.json);
   } catch (err) {
-    printError2(`Failed to resume agent: ${err}`);
+    const msg = String(err);
+    if (msg.includes("409") || msg.includes("disabled") || msg.includes("deleted")) {
+      printError2(
+        `Cannot resume agent ${agentId}: the agent may be disabled or deleted.
+  Disabled/deleted agents cannot be resumed. Create a new agent instead:
+    corp agents create --name '...' --prompt '...'`
+      );
+    } else {
+      printError2(`Failed to resume agent: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -6372,7 +6484,15 @@ async function agentsMessageCommand(agentId, opts) {
     const result = await client.sendAgentMessage(resolvedAgentId, body);
     printWriteResult(result, `Message sent. Execution: ${result.execution_id ?? "OK"}`, opts.json);
   } catch (err) {
-    printError2(`Failed to send message: ${err}`);
+    const msg = String(err);
+    if (msg.includes("409")) {
+      printError2(
+        `Cannot message agent: the agent must be active or paused (not disabled/deleted).
+  Check agent status: corp agents show ` + agentId + "\n  Resume a paused agent: corp agents resume " + agentId
+      );
+    } else {
+      printError2(`Failed to send message: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -7297,18 +7417,33 @@ async function formCommand(opts) {
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
   const resolver = new ReferenceResolver(client, cfg);
   try {
+    if (opts.type && !SUPPORTED_ENTITY_TYPES.includes(opts.type)) {
+      printError2(`Unsupported entity type '${opts.type}'. Supported types: ${SUPPORTED_ENTITY_TYPES.join(", ")}`);
+      process.exit(1);
+    }
+    if (opts.name != null && !opts.name.trim()) {
+      printError2("--name cannot be empty or whitespace");
+      process.exit(1);
+    }
     let serverCfg = {};
     try {
       serverCfg = await client.getConfig();
     } catch {
     }
-    const scripted = Boolean(
+    const hasMembers = Boolean(
       opts.member && opts.member.length > 0 || opts.memberJson && opts.memberJson.length > 0 || opts.membersFile
     );
+    const scripted = hasMembers || opts.json || opts.dryRun || !process.stdout.isTTY;
+    if (scripted && !hasMembers) {
+      printError2("At least one --member, --member-json, or --members-file is required in non-interactive mode.");
+      process.exit(1);
+    }
     const { entityType, name, jurisdiction, companyAddress, fiscalYearEnd, sCorpElection } = await phaseEntityDetails(opts, serverCfg, scripted);
     const founders = await phasePeople(opts, entityType, scripted);
     const { transferRestrictions, rofr } = await phaseStock(opts, entityType, founders, scripted);
-    printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElection, founders, transferRestrictions, rofr);
+    if (!opts.quiet) {
+      printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElection, founders, transferRestrictions, rofr);
+    }
     const shouldProceed = scripted ? true : await confirm6({ message: "Proceed with formation?", default: true });
     if (!shouldProceed) {
       console.log(chalk13.yellow("Formation cancelled."));
@@ -7354,6 +7489,11 @@ async function formCommand(opts) {
       saveConfig(cfg);
       console.log(chalk13.dim(`  Active entity set to ${result.entity_id}`));
     }
+    if (opts.quiet) {
+      const id = result.entity_id ?? result.formation_id;
+      if (id) console.log(String(id));
+      return;
+    }
     if (opts.json) {
       printJson(result);
       return;
@@ -7387,7 +7527,17 @@ async function formCommand(opts) {
     }
   } catch (err) {
     if (err instanceof Error && err.message.includes("exit")) throw err;
-    printError2(`Failed to create formation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("officers_list") || msg.includes("officer")) {
+      printError2(
+        `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"}`
+      );
+    } else {
+      printError2(`Failed to create formation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -7447,6 +7597,11 @@ async function formCreateCommand(opts) {
       setActiveEntityId(cfg, String(result.entity_id));
       saveConfig(cfg);
     }
+    if (opts.quiet) {
+      const id = result.entity_id;
+      if (id) console.log(String(id));
+      return;
+    }
     if (opts.json) {
       printJson(result);
       return;
@@ -7573,7 +7728,16 @@ async function formFinalizeCommand(entityId, opts) {
   Next: ${result.next_action}`));
     }
   } catch (err) {
-    printError2(`Failed to finalize formation: ${err}`);
+    const msg = String(err);
+    if (msg.includes("officers_list") || msg.includes("officer")) {
+      printError2(
+        `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`
+      );
+    } else {
+      printError2(`Failed to finalize formation: ${err}`);
+    }
     process.exit(1);
   }
 }
@@ -7625,6 +7789,7 @@ async function formActivateCommand(entityId, opts) {
     process.exit(1);
   }
 }
+var SUPPORTED_ENTITY_TYPES;
 var init_form = __esm({
   "src/commands/form.ts"() {
     "use strict";
@@ -7633,6 +7798,7 @@ var init_form = __esm({
     init_output();
     init_references();
     init_formation_automation();
+    SUPPORTED_ENTITY_TYPES = ["llc", "c_corp", "s_corp", "corporation"];
   }
 });
 
@@ -7750,14 +7916,26 @@ function scenarioConfig(name, scenario) {
             email: "alice@example.com",
             role: "member",
             investor_type: "natural_person",
-            ownership_pct: 60
+            ownership_pct: 60,
+            address: {
+              street: "251 Little Falls Dr",
+              city: "Wilmington",
+              state: "DE",
+              zip: "19808"
+            }
           },
           {
             name: "Bob Martinez",
             email: "bob@example.com",
             role: "member",
             investor_type: "natural_person",
-            ownership_pct: 40
+            ownership_pct: 40,
+            address: {
+              street: "251 Little Falls Dr",
+              city: "Wilmington",
+              state: "DE",
+              zip: "19808"
+            }
           }
         ],
         fiscal_year_end: "12-31",
@@ -7779,14 +7957,26 @@ function scenarioConfig(name, scenario) {
             email: "rosa@example.com",
             role: "manager",
             investor_type: "natural_person",
-            ownership_pct: 55
+            ownership_pct: 55,
+            address: {
+              street: "18 Market St",
+              city: "Wilmington",
+              state: "DE",
+              zip: "19801"
+            }
           },
           {
             name: "Noah Patel",
             email: "noah@example.com",
             role: "member",
             investor_type: "natural_person",
-            ownership_pct: 45
+            ownership_pct: 45,
+            address: {
+              street: "18 Market St",
+              city: "Wilmington",
+              state: "DE",
+              zip: "19801"
+            }
           }
         ],
         fiscal_year_end: "12-31",
@@ -7815,7 +8005,13 @@ function scenarioConfig(name, scenario) {
             investor_type: "natural_person",
             shares_purchased: 6e6,
             officer_title: "ceo",
-            is_incorporator: true
+            is_incorporator: true,
+            address: {
+              street: "251 Little Falls Dr",
+              city: "Wilmington",
+              state: "DE",
+              zip: "19808"
+            }
           },
           {
             name: "Bob Martinez",
@@ -7823,7 +8019,13 @@ function scenarioConfig(name, scenario) {
             role: "director",
             investor_type: "natural_person",
             shares_purchased: 4e6,
-            officer_title: "cto"
+            officer_title: "cto",
+            address: {
+              street: "251 Little Falls Dr",
+              city: "Wilmington",
+              state: "DE",
+              zip: "19808"
+            }
           }
         ],
         fiscal_year_end: "12-31",
@@ -8134,8 +8336,11 @@ var FINALIZE_ITEM_STATUS_CHOICES = [
   "withdrawn"
 ];
 var program = new Command();
-program.name("corp").description("corp \u2014 Corporate governance from the terminal").version(pkg.version);
+program.name("corp").description("corp \u2014 Corporate governance from the terminal").version(pkg.version).enablePositionalOptions();
 program.option("-q, --quiet", "Only output the resource ID (for scripting)");
+program.action(() => {
+  program.outputHelp();
+});
 program.command("setup").description("Interactive setup wizard").action(async () => {
   const { setupCommand: setupCommand2 } = await Promise.resolve().then(() => (init_setup(), setup_exports));
   await setupCommand2();
@@ -8181,7 +8386,7 @@ program.command("obligations").description("List obligations with urgency tiers"
   const { obligationsCommand: obligationsCommand2 } = await Promise.resolve().then(() => (init_obligations(), obligations_exports));
   await obligationsCommand2(opts);
 });
-program.command("digest").description("View or trigger daily digests").option("--trigger", "Trigger digest now").option("--key <key>", "Get specific digest by key").option("--json", "Output as JSON").action(async (opts) => {
+program.command("digest").description("View or trigger daily digests").option("--trigger", "Trigger digest now").option("--key <key>", "Get specific digest by key").option("--entity-id <ref>", "Entity reference (ID, short ID, @last, or unique name)").option("--json", "Output as JSON").action(async (opts) => {
   const { digestCommand: digestCommand2 } = await Promise.resolve().then(() => (init_digest(), digest_exports));
   await digestCommand2(opts);
 });
@@ -8469,12 +8674,17 @@ financeCmd.command("invoices").option("--json", "Output as JSON").description("L
     json: inheritOption(opts.json, parent.json)
   });
 });
-financeCmd.command("invoice").requiredOption("--customer <name>", "Customer name").requiredOption("--amount-cents <n>", "Amount in cents (e.g. 500000 = $5,000.00)", parseInt).option("--amount <n>", "", parseInt).requiredOption("--due-date <date>", "Due date (ISO 8601)").option("--description <desc>", "Description", "Services rendered").option("--json", "Output as JSON").description("Create an invoice").action(async (opts, cmd) => {
+financeCmd.command("invoice").requiredOption("--customer <name>", "Customer name").option("--amount-cents <n>", "Amount in cents (e.g. 500000 = $5,000.00)", parseInt).option("--amount <n>", "Amount in dollars (converted to cents)", parseInt).requiredOption("--due-date <date>", "Due date (ISO 8601)").option("--description <desc>", "Description", "Services rendered").option("--json", "Output as JSON").description("Create an invoice").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
+  const amountCents = opts.amountCents ?? (opts.amount != null ? opts.amount * 100 : void 0);
+  if (amountCents == null) {
+    cmd.error("required option '--amount-cents <n>' or '--amount <n>' not specified");
+    return;
+  }
   const { financeInvoiceCommand: financeInvoiceCommand2 } = await Promise.resolve().then(() => (init_finance(), finance_exports));
   await financeInvoiceCommand2({
     ...opts,
-    amountCents: opts.amountCents ?? opts.amount,
+    amountCents,
     entityId: parent.entityId,
     json: inheritOption(opts.json, parent.json)
   });
@@ -8506,12 +8716,17 @@ financeCmd.command("payments").option("--json", "Output as JSON").description("L
     json: inheritOption(opts.json, parent.json)
   });
 });
-financeCmd.command("pay").requiredOption("--amount-cents <n>", "Amount in cents (e.g. 500000 = $5,000.00)", parseInt).option("--amount <n>", "", parseInt).requiredOption("--recipient <name>", "Recipient name").option("--method <method>", "Payment method", "ach").option("--json", "Output as JSON").description("Submit a payment").action(async (opts, cmd) => {
+financeCmd.command("pay").option("--amount-cents <n>", "Amount in cents (e.g. 500000 = $5,000.00)", parseInt).option("--amount <n>", "Amount in dollars (converted to cents)", parseInt).requiredOption("--recipient <name>", "Recipient name").option("--method <method>", "Payment method", "ach").option("--json", "Output as JSON").description("Submit a payment").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
+  const amountCents = opts.amountCents ?? (opts.amount != null ? opts.amount * 100 : void 0);
+  if (amountCents == null) {
+    cmd.error("required option '--amount-cents <n>' or '--amount <n>' not specified");
+    return;
+  }
   const { financePayCommand: financePayCommand2 } = await Promise.resolve().then(() => (init_finance(), finance_exports));
   await financePayCommand2({
     ...opts,
-    amountCents: opts.amountCents ?? opts.amount,
+    amountCents,
     entityId: parent.entityId,
     json: inheritOption(opts.json, parent.json)
   });
@@ -8570,7 +8785,7 @@ financeCmd.command("reconciliations").option("--json", "Output as JSON").descrip
     json: inheritOption(opts.json, parent.json)
   });
 });
-financeCmd.command("reconcile").requiredOption("--start-date <date>", "Period start").requiredOption("--end-date <date>", "Period end").option("--json", "Output as JSON").description("Reconcile ledger").action(async (opts, cmd) => {
+financeCmd.command("reconcile").requiredOption("--start-date <date>", "Period start (required, ISO 8601)").requiredOption("--end-date <date>", "Period end (required, ISO 8601)").option("--json", "Output as JSON").description("Reconcile ledger (requires --start-date and --end-date)").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { financeReconcileCommand: financeReconcileCommand2 } = await Promise.resolve().then(() => (init_finance(), finance_exports));
   await financeReconcileCommand2({
@@ -8872,11 +9087,16 @@ taxCmd.command("deadlines").option("--json", "Output as JSON").description("List
     json: inheritOption(opts.json, parent.json)
   });
 });
-taxCmd.command("deadline").requiredOption("--type <type>", "Deadline type").requiredOption("--due-date <date>", "Due date (ISO 8601)").requiredOption("--description <desc>", "Description").option("--recurrence <recurrence>", "Recurrence (e.g. annual; 'yearly' is normalized)").option("--json", "Output as JSON").description("Track a compliance deadline").action(async (opts, cmd) => {
+taxCmd.command("deadline").requiredOption("--type <type>", "Deadline type").requiredOption("--due-date <date>", "Due date (ISO 8601)").requiredOption("--description <desc>", "Description").option("--recurrence <recurrence>", "Recurrence (e.g. annual; 'yearly' is normalized). Required for annual_report type.").option("--json", "Output as JSON").description("Track a compliance deadline").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
+  let recurrence = opts.recurrence;
+  if (!recurrence && opts.type === "annual_report") {
+    recurrence = "annual";
+  }
   const { taxDeadlineCommand: taxDeadlineCommand2 } = await Promise.resolve().then(() => (init_tax(), tax_exports));
   await taxDeadlineCommand2({
     ...opts,
+    recurrence,
     entityId: parent.entityId,
     json: inheritOption(opts.json, parent.json)
   });
@@ -8983,12 +9203,17 @@ workItemsCmd.command("show <item-ref>").option("--json", "Output as JSON").descr
     json: inheritOption(opts.json, parent.json)
   });
 });
-workItemsCmd.command("create").requiredOption("--title <title>", "Work item title").requiredOption("--category <category>", "Work item category").option("--description <desc>", "Description").option("--deadline <date>", "Deadline (YYYY-MM-DD)").option("--asap", "Mark as ASAP priority").option("--created-by <name>", "Creator identifier").option("--json", "Output as JSON").description("Create a new work item").action(async (opts, cmd) => {
+workItemsCmd.command("create").requiredOption("--title <title>", "Work item title").option("--category <category>", "Work item category").option("--description <desc>", "Description").option("--deadline <date>", "Deadline (YYYY-MM-DD)").option("--asap", "Mark as ASAP priority").option("--created-by <name>", "Creator identifier").option("--json", "Output as JSON").description("Create a new work item").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
+  const resolvedCategory = inheritOption(opts.category, parent.category);
+  if (!resolvedCategory) {
+    cmd.error("required option '--category <category>' not specified");
+    return;
+  }
   const { workItemsCreateCommand: workItemsCreateCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
   await workItemsCreateCommand2({
     ...opts,
-    category: inheritOption(opts.category, parent.category),
+    category: resolvedCategory,
     entityId: parent.entityId,
     json: inheritOption(opts.json, parent.json)
   });
@@ -9119,22 +9344,44 @@ program.command("approvals").description("Approvals are managed through governan
   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("--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>", "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) => {
+var formCmd = program.command("form").enablePositionalOptions().passThroughOptions().description("Form a new entity with founders and cap table").option("--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>", "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, cmd) => {
   const { formCommand: formCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
-  await formCommand2(opts);
+  await formCommand2({ ...opts, quiet: program.opts().quiet });
 });
-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) => {
+formCmd.command("create").description("Create a pending entity (staged flow step 1)").option("--type <type>", "Entity type (llc, c_corp)").option("--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 resolvedType = inheritOption(opts.type, parent.type);
+  const resolvedName = inheritOption(opts.name, parent.name);
+  if (!resolvedType) {
+    cmd.error("required option '--type <type>' not specified");
+    return;
+  }
+  const SUPPORTED_ENTITY_TYPES2 = ["llc", "c_corp", "s_corp", "corporation"];
+  if (!SUPPORTED_ENTITY_TYPES2.includes(resolvedType)) {
+    cmd.error(`unsupported entity type '${resolvedType}'. Supported types: ${SUPPORTED_ENTITY_TYPES2.join(", ")}`);
+    return;
+  }
+  if (!resolvedName) {
+    cmd.error("required option '--name <name>' not specified");
+    return;
+  }
+  if (!resolvedName.trim()) {
+    cmd.error("--name cannot be empty or whitespace");
+    return;
+  }
   const { formCreateCommand: formCreateCommand2 } = await Promise.resolve().then(() => (init_form(), form_exports));
   await formCreateCommand2({
     ...opts,
+    type: resolvedType,
+    name: resolvedName,
     jurisdiction: inheritOption(opts.jurisdiction, parent.jurisdiction),
     fiscalYearEnd: inheritOption(opts.fiscalYearEnd, parent.fiscalYearEnd),
     sCorp: inheritOption(opts.sCorp, parent.sCorp),
     transferRestrictions: inheritOption(opts.transferRestrictions, parent.transferRestrictions),
     rofr: inheritOption(opts.rofr, parent.rofr),
     json: inheritOption(opts.json, parent.json),
-    dryRun: inheritOption(opts.dryRun, parent.dryRun)
+    dryRun: inheritOption(opts.dryRun, parent.dryRun),
+    quiet: program.opts().quiet
   });
 });
 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) => {