@thecorporation/cli 26.3.7 → 26.3.10

package/dist/index.js

@@ -154,7 +154,8 @@ __export(output_exports, {
   printSuccess: () => printSuccess,
   printTransfersTable: () => printTransfersTable,
   printValuationsTable: () => printValuationsTable,
-  printWarning: () => printWarning
+  printWarning: () => printWarning,
+  printWorkItemsTable: () => printWorkItemsTable
 });
 import chalk from "chalk";
 import Table from "cli-table3";
@@ -201,14 +202,23 @@ function s(val, maxLen) {
   if (maxLen && str.length > maxLen) return str.slice(0, maxLen);
   return str;
 }
-function money(val) {
-  if (typeof val === "number") return `$${val.toLocaleString()}`;
+function money(val, cents = true) {
+  if (typeof val === "number") {
+    const dollars = cents ? val / 100 : val;
+    return `$${dollars.toLocaleString(void 0, { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+  }
   return String(val ?? "");
 }
+function date(val) {
+  const str = s(val);
+  if (!str) return "";
+  const parsed = new Date(str);
+  return Number.isNaN(parsed.getTime()) ? str : parsed.toISOString().slice(0, 10);
+}
 function printEntitiesTable(entities) {
   const table = makeTable("Entities", ["ID", "Name", "Type", "Jurisdiction", "Status"]);
   for (const e of entities) {
-    table.push([s(e.entity_id, 12), s(e.name), s(e.entity_type), s(e.jurisdiction), s(e.status)]);
+    table.push([s(e.entity_id, 12), s(e.legal_name ?? e.name), s(e.entity_type), s(e.jurisdiction), s(e.formation_status ?? e.status)]);
   }
   console.log(table.toString());
 }
@@ -279,7 +289,7 @@ function printSafesTable(safes) {
     table.push([
       s(s_.safe_id ?? s_.id, 12),
       s(s_.investor_name ?? s_.investor),
-      money(s_.investment_amount ?? s_.amount),
+      money(s_.investment_amount ?? s_.amount, false),
       s(s_.valuation_cap ?? s_.cap),
       s(s_.discount_rate ?? s_.discount),
       s(s_.date ?? s_.created_at)
@@ -305,10 +315,10 @@ function printValuationsTable(valuations) {
   const table = makeTable("Valuations", ["Date", "Type", "Valuation", "PPS"]);
   for (const v of valuations) {
     table.push([
-      s(v.valuation_date ?? v.date),
+      date(v.effective_date ?? v.valuation_date ?? v.date),
       s(v.valuation_type ?? v.type),
-      s(v.enterprise_value ?? v.valuation),
-      s(v.price_per_share ?? v.pps ?? v.fmv_per_share)
+      money(v.enterprise_value_cents ?? v.enterprise_value ?? v.valuation),
+      money(v.fmv_per_share_cents ?? v.price_per_share ?? v.pps ?? v.fmv_per_share)
     ]);
   }
   console.log(table.toString());
@@ -339,7 +349,7 @@ function printMeetingsTable(meetings) {
     table.push([
       s(m.meeting_id ?? m.id, 12),
       s(m.title ?? m.name),
-      s(m.meeting_date ?? m.date),
+      s(m.scheduled_date ?? m.meeting_date ?? m.date),
       s(m.status),
       s(m.resolution_count ?? m.resolutions)
     ]);
@@ -376,6 +386,22 @@ function printDocumentsTable(docs) {
   }
   console.log(table.toString());
 }
+function printWorkItemsTable(items) {
+  const table = makeTable("Work Items", ["ID", "Title", "Category", "Status", "Deadline", "Claimed By"]);
+  for (const w of items) {
+    const status = s(w.effective_status ?? w.status);
+    const colored = status === "completed" ? chalk.green(status) : status === "claimed" ? chalk.yellow(status) : status === "cancelled" ? chalk.dim(status) : status;
+    table.push([
+      s(w.work_item_id ?? w.id, 12),
+      s(w.title),
+      s(w.category),
+      colored,
+      w.asap ? chalk.red.bold("ASAP") : s(w.deadline ?? ""),
+      s(w.claimed_by ?? "")
+    ]);
+  }
+  console.log(table.toString());
+}
 function printAgentsTable(agents) {
   const table = makeTable("Agents", ["ID", "Name", "Status", "Model"]);
   for (const a of agents) {
@@ -404,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)));
@@ -790,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);
@@ -1220,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.");
@@ -1240,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);
@@ -1247,16 +1295,17 @@ 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)));
       console.log(chalk3.blue.bold("  Entity Detail"));
       console.log(chalk3.blue("\u2500".repeat(40)));
-      console.log(`  ${chalk3.bold("Name:")} ${entity.name ?? "N/A"}`);
+      console.log(`  ${chalk3.bold("Name:")} ${entity.legal_name ?? entity.name ?? "N/A"}`);
       console.log(`  ${chalk3.bold("Type:")} ${entity.entity_type ?? "N/A"}`);
       console.log(`  ${chalk3.bold("Jurisdiction:")} ${entity.jurisdiction ?? "N/A"}`);
-      console.log(`  ${chalk3.bold("Status:")} ${entity.status ?? "N/A"}`);
+      console.log(`  ${chalk3.bold("Status:")} ${entity.formation_status ?? entity.status ?? "N/A"}`);
+      console.log(`  ${chalk3.bold("State:")} ${entity.formation_state ?? "N/A"}`);
       console.log(`  ${chalk3.bold("ID:")} ${entity.entity_id ?? "N/A"}`);
       if (entity.formation_date) console.log(`  ${chalk3.bold("Formation Date:")} ${entity.formation_date}`);
       if (entity.ein) console.log(`  ${chalk3.bold("EIN:")} ${entity.ein}`);
@@ -1790,9 +1839,11 @@ function print409a(data) {
   console.log(chalk5.green("\u2500".repeat(40)));
   console.log(chalk5.green.bold("  409A Valuation"));
   console.log(chalk5.green("\u2500".repeat(40)));
-  console.log(`  ${chalk5.bold("FMV/Share:")} $${data.fmv_per_share ?? "N/A"}`);
-  console.log(`  ${chalk5.bold("Enterprise Value:")} $${data.enterprise_value ?? "N/A"}`);
-  console.log(`  ${chalk5.bold("Valuation Date:")} ${data.valuation_date ?? "N/A"}`);
+  const fmv = typeof data.fmv_per_share_cents === "number" ? data.fmv_per_share_cents / 100 : data.fmv_per_share;
+  const enterpriseValue = typeof data.enterprise_value_cents === "number" ? data.enterprise_value_cents / 100 : data.enterprise_value;
+  console.log(`  ${chalk5.bold("FMV/Share:")} $${fmv ?? "N/A"}`);
+  console.log(`  ${chalk5.bold("Enterprise Value:")} $${enterpriseValue ?? "N/A"}`);
+  console.log(`  ${chalk5.bold("Valuation Date:")} ${data.effective_date ?? data.valuation_date ?? "N/A"}`);
   if (data.provider) console.log(`  ${chalk5.bold("Provider:")} ${data.provider}`);
   console.log(chalk5.green("\u2500".repeat(40)));
 }
@@ -1860,6 +1911,7 @@ async function financePayCommand(opts) {
       entity_id: eid,
       amount_cents: opts.amount,
       recipient: opts.recipient,
+      payment_method: opts.method,
       description: `Payment via ${opts.method}`
     });
     printSuccess(`Payment submitted: ${result.payment_id ?? "OK"}`);
@@ -1948,6 +2000,7 @@ __export(governance_exports, {
   sendNoticeCommand: () => sendNoticeCommand,
   writtenConsentCommand: () => writtenConsentCommand
 });
+import chalk6 from "chalk";
 async function governanceCreateBodyCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const eid = resolveEntityId(cfg, opts.entityId);
@@ -1960,8 +2013,12 @@ async function governanceCreateBodyCommand(opts) {
       quorum_rule: opts.quorum,
       voting_method: opts.voting
     });
-    printSuccess(`Governance body created: ${result.body_id ?? "OK"}`);
+    const bodyId = result.body_id ?? "OK";
+    printSuccess(`Governance body created: ${bodyId}`);
     printJson(result);
+    console.log(chalk6.dim("\n  Next steps:"));
+    console.log(chalk6.dim(`    corp governance add-seat ${bodyId} --holder <contact-id>`));
+    console.log(chalk6.dim(`    corp governance seats ${bodyId}`));
   } catch (err) {
     printError(`Failed to create governance body: ${err}`);
     process.exit(1);
@@ -2050,8 +2107,12 @@ async function governanceConveneCommand(opts) {
       scheduled_date: opts.date,
       agenda_item_titles: opts.agenda
     });
-    printSuccess(`Meeting scheduled: ${result.meeting_id ?? "OK"}`);
+    const meetingId = result.meeting_id ?? "OK";
+    printSuccess(`Meeting scheduled: ${meetingId}`);
     printJson(result);
+    console.log(chalk6.dim("\n  Next steps:"));
+    console.log(chalk6.dim(`    corp governance notice ${meetingId}`));
+    console.log(chalk6.dim(`    corp governance agenda-items ${meetingId}`));
   } catch (err) {
     printError(`Failed to schedule meeting: ${err}`);
     process.exit(1);
@@ -2154,8 +2215,12 @@ async function writtenConsentCommand(opts) {
       title: opts.title,
       description: opts.description
     });
-    printSuccess(`Written consent created: ${result.meeting_id ?? "OK"}`);
+    const meetingId = result.meeting_id ?? "OK";
+    printSuccess(`Written consent created: ${meetingId}`);
     printJson(result);
+    console.log(chalk6.dim("\n  Next steps:"));
+    console.log(chalk6.dim(`    corp governance agenda-items ${meetingId}`));
+    console.log(chalk6.dim(`    corp governance vote ${meetingId} <item-id> --voter <contact-uuid> --vote for`));
   } catch (err) {
     printError(`Failed to create written consent: ${err}`);
     process.exit(1);
@@ -2169,7 +2234,22 @@ async function listAgendaItemsCommand(meetingId, opts) {
     const items = await client.listAgendaItems(meetingId, eid);
     if (opts.json) printJson(items);
     else if (items.length === 0) console.log("No agenda items found.");
-    else printJson(items);
+    else {
+      const Table4 = (await import("cli-table3")).default;
+      const chalk11 = (await import("chalk")).default;
+      console.log(`
+${chalk11.bold("Agenda Items")}`);
+      const table = new Table4({ head: [chalk11.dim("ID"), chalk11.dim("Title"), chalk11.dim("Status"), chalk11.dim("Type")] });
+      for (const item of items) {
+        table.push([
+          String(item.item_id ?? item.agenda_item_id ?? item.id ?? "").slice(0, 12),
+          String(item.title ?? ""),
+          String(item.status ?? ""),
+          String(item.item_type ?? item.type ?? "")
+        ]);
+      }
+      console.log(table.toString());
+    }
   } catch (err) {
     printError(`Failed to list agenda items: ${err}`);
     process.exit(1);
@@ -2212,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);
@@ -2244,11 +2321,16 @@ async function documentsGenerateCommand(opts) {
 async function documentsPreviewPdfCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const eid = resolveEntityId(cfg, opts.entityId);
-  const apiUrl = cfg.api_url.replace(/\/+$/, "");
-  const qs = new URLSearchParams({ entity_id: eid, document_id: opts.documentId }).toString();
-  const url = `${apiUrl}/v1/documents/preview/pdf?${qs}`;
-  printSuccess(`Preview PDF URL: ${url}`);
-  console.log("Use your API key to authenticate the download.");
+  const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
+  try {
+    await client.validatePreviewPdf(eid, opts.documentId);
+    const url = client.getPreviewPdfUrl(eid, opts.documentId);
+    printSuccess(`Preview PDF URL: ${url}`);
+    console.log("The document definition was validated successfully. Use your API key to download the PDF.");
+  } catch (err) {
+    printError(`Failed to validate preview PDF: ${err}`);
+    process.exit(1);
+  }
 }
 var init_documents = __esm({
   "src/commands/documents.ts"() {
@@ -2265,6 +2347,11 @@ __export(tax_exports, {
   taxDeadlineCommand: () => taxDeadlineCommand,
   taxFileCommand: () => taxFileCommand
 });
+function normalizeRecurrence(recurrence) {
+  if (!recurrence) return void 0;
+  if (recurrence === "yearly") return "annual";
+  return recurrence;
+}
 async function taxFileCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const eid = resolveEntityId(cfg, opts.entityId);
@@ -2283,13 +2370,15 @@ async function taxDeadlineCommand(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.trackDeadline({
+    const payload = {
       entity_id: eid,
       deadline_type: opts.type,
       due_date: opts.dueDate,
-      description: opts.description,
-      recurrence: opts.recurrence ?? ""
-    });
+      description: opts.description
+    };
+    const recurrence = normalizeRecurrence(opts.recurrence);
+    if (recurrence) payload.recurrence = recurrence;
+    const result = await client.trackDeadline(payload);
     printSuccess(`Deadline tracked: ${result.deadline_id ?? "OK"}`);
     printJson(result);
   } catch (err) {
@@ -2319,7 +2408,7 @@ __export(agents_exports, {
   agentsShowCommand: () => agentsShowCommand,
   agentsSkillCommand: () => agentsSkillCommand
 });
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 async function agentsListCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   const client = new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
@@ -2342,22 +2431,22 @@ async function agentsShowCommand(agentId, opts) {
       printJson(agent);
       return;
     }
-    console.log(chalk6.magenta("\u2500".repeat(40)));
-    console.log(chalk6.magenta.bold("  Agent Detail"));
-    console.log(chalk6.magenta("\u2500".repeat(40)));
-    console.log(`  ${chalk6.bold("Name:")} ${agent.name ?? "N/A"}`);
-    console.log(`  ${chalk6.bold("Status:")} ${agent.status ?? "N/A"}`);
-    console.log(`  ${chalk6.bold("Model:")} ${agent.model ?? "N/A"}`);
-    console.log(`  ${chalk6.bold("ID:")} ${agent.agent_id ?? "N/A"}`);
+    console.log(chalk7.magenta("\u2500".repeat(40)));
+    console.log(chalk7.magenta.bold("  Agent Detail"));
+    console.log(chalk7.magenta("\u2500".repeat(40)));
+    console.log(`  ${chalk7.bold("Name:")} ${agent.name ?? "N/A"}`);
+    console.log(`  ${chalk7.bold("Status:")} ${agent.status ?? "N/A"}`);
+    console.log(`  ${chalk7.bold("Model:")} ${agent.model ?? "N/A"}`);
+    console.log(`  ${chalk7.bold("ID:")} ${agent.agent_id ?? "N/A"}`);
     if (agent.system_prompt) {
       let prompt = String(agent.system_prompt);
       if (prompt.length > 100) prompt = prompt.slice(0, 97) + "...";
-      console.log(`  ${chalk6.bold("Prompt:")} ${prompt}`);
+      console.log(`  ${chalk7.bold("Prompt:")} ${prompt}`);
     }
     if (agent.skills && Array.isArray(agent.skills) && agent.skills.length > 0) {
-      console.log(`  ${chalk6.bold("Skills:")} ${agent.skills.map((s2) => s2.name ?? "?").join(", ")}`);
+      console.log(`  ${chalk7.bold("Skills:")} ${agent.skills.map((s2) => s2.name ?? "?").join(", ")}`);
     }
-    console.log(chalk6.magenta("\u2500".repeat(40)));
+    console.log(chalk7.magenta("\u2500".repeat(40)));
   } catch (err) {
     printError(`Failed to fetch agent: ${err}`);
     process.exit(1);
@@ -2371,6 +2460,7 @@ async function agentsCreateCommand(opts) {
     if (opts.model) data.model = opts.model;
     const result = await client.createAgent(data);
     printSuccess(`Agent created: ${result.agent_id ?? result.id ?? "OK"}`);
+    printJson(result);
   } catch (err) {
     printError(`Failed to create agent: ${err}`);
     process.exit(1);
@@ -2453,6 +2543,146 @@ var init_agents = __esm({
   }
 });
 
+// src/commands/work-items.ts
+var work_items_exports = {};
+__export(work_items_exports, {
+  workItemsCancelCommand: () => workItemsCancelCommand,
+  workItemsClaimCommand: () => workItemsClaimCommand,
+  workItemsCompleteCommand: () => workItemsCompleteCommand,
+  workItemsCreateCommand: () => workItemsCreateCommand,
+  workItemsListCommand: () => workItemsListCommand,
+  workItemsReleaseCommand: () => workItemsReleaseCommand,
+  workItemsShowCommand: () => workItemsShowCommand
+});
+import chalk8 from "chalk";
+async function workItemsListCommand(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 params = {};
+    if (opts.status) params.status = opts.status;
+    if (opts.category) params.category = opts.category;
+    const items = await client.listWorkItems(eid, Object.keys(params).length > 0 ? params : void 0);
+    if (opts.json) printJson(items);
+    else if (items.length === 0) console.log("No work items found.");
+    else printWorkItemsTable(items);
+  } catch (err) {
+    printError(`Failed to fetch work items: ${err}`);
+    process.exit(1);
+  }
+}
+async function workItemsShowCommand(workItemId, 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 w = await client.getWorkItem(eid, workItemId);
+    if (opts.json) {
+      printJson(w);
+      return;
+    }
+    console.log(chalk8.cyan("\u2500".repeat(40)));
+    console.log(chalk8.cyan.bold("  Work Item Detail"));
+    console.log(chalk8.cyan("\u2500".repeat(40)));
+    console.log(`  ${chalk8.bold("Title:")} ${w.title ?? "N/A"}`);
+    console.log(`  ${chalk8.bold("Category:")} ${w.category ?? "N/A"}`);
+    console.log(`  ${chalk8.bold("Status:")} ${w.effective_status ?? w.status ?? "N/A"}`);
+    if (w.description) console.log(`  ${chalk8.bold("Description:")} ${w.description}`);
+    if (w.deadline) console.log(`  ${chalk8.bold("Deadline:")} ${w.deadline}`);
+    if (w.asap) console.log(`  ${chalk8.bold("Priority:")} ${chalk8.red.bold("ASAP")}`);
+    if (w.claimed_by) console.log(`  ${chalk8.bold("Claimed by:")} ${w.claimed_by}`);
+    if (w.claimed_at) console.log(`  ${chalk8.bold("Claimed at:")} ${w.claimed_at}`);
+    if (w.claim_ttl_seconds) console.log(`  ${chalk8.bold("Claim TTL:")} ${w.claim_ttl_seconds}s`);
+    if (w.completed_by) console.log(`  ${chalk8.bold("Completed by:")} ${w.completed_by}`);
+    if (w.completed_at) console.log(`  ${chalk8.bold("Completed at:")} ${w.completed_at}`);
+    if (w.result) console.log(`  ${chalk8.bold("Result:")} ${w.result}`);
+    if (w.created_by) console.log(`  ${chalk8.bold("Created by:")} ${w.created_by}`);
+    console.log(`  ${chalk8.bold("Created at:")} ${w.created_at ?? "N/A"}`);
+    console.log(chalk8.cyan("\u2500".repeat(40)));
+  } catch (err) {
+    printError(`Failed to fetch work item: ${err}`);
+    process.exit(1);
+  }
+}
+async function workItemsCreateCommand(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 = { title: opts.title, category: opts.category };
+    if (opts.description) data.description = opts.description;
+    if (opts.deadline) data.deadline = opts.deadline;
+    if (opts.asap) data.asap = true;
+    if (opts.createdBy) data.created_by = opts.createdBy;
+    const result = await client.createWorkItem(eid, data);
+    printSuccess(`Work item created: ${result.work_item_id ?? result.id ?? "OK"}`);
+  } catch (err) {
+    printError(`Failed to create work item: ${err}`);
+    process.exit(1);
+  }
+}
+async function workItemsClaimCommand(workItemId, 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 = { claimed_by: opts.claimedBy };
+    if (opts.ttl != null) data.ttl_seconds = opts.ttl;
+    await client.claimWorkItem(eid, workItemId, data);
+    printSuccess(`Work item ${workItemId} claimed by ${opts.claimedBy}.`);
+  } catch (err) {
+    printError(`Failed to claim work item: ${err}`);
+    process.exit(1);
+  }
+}
+async function workItemsCompleteCommand(workItemId, 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 = { completed_by: opts.completedBy };
+    if (opts.result) data.result = opts.result;
+    await client.completeWorkItem(eid, workItemId, data);
+    printSuccess(`Work item ${workItemId} completed.`);
+  } catch (err) {
+    printError(`Failed to complete work item: ${err}`);
+    process.exit(1);
+  }
+}
+async function workItemsReleaseCommand(workItemId, 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 {
+    await client.releaseWorkItem(eid, workItemId);
+    printSuccess(`Work item ${workItemId} claim released.`);
+  } catch (err) {
+    printError(`Failed to release work item: ${err}`);
+    process.exit(1);
+  }
+}
+async function workItemsCancelCommand(workItemId, 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 {
+    await client.cancelWorkItem(eid, workItemId);
+    printSuccess(`Work item ${workItemId} cancelled.`);
+  } catch (err) {
+    printError(`Failed to cancel work item: ${err}`);
+    process.exit(1);
+  }
+}
+var init_work_items = __esm({
+  "src/commands/work-items.ts"() {
+    "use strict";
+    init_config();
+    init_api_client();
+    init_output();
+  }
+});
+
 // src/commands/billing.ts
 var billing_exports = {};
 __export(billing_exports, {
@@ -2460,24 +2690,29 @@ __export(billing_exports, {
   billingPortalCommand: () => billingPortalCommand,
   billingUpgradeCommand: () => billingUpgradeCommand
 });
-import { execSync } from "child_process";
 function makeClient() {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
   return new CorpAPIClient(cfg.api_url, cfg.api_key, cfg.workspace_id);
 }
-function openUrl(url) {
-  try {
-    const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-    execSync(`${cmd} ${JSON.stringify(url)}`, { stdio: "ignore" });
-  } catch {
+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);
@@ -2492,10 +2727,8 @@ async function billingPortalCommand() {
       printError("No portal URL returned. Ensure you have an active subscription.");
       process.exit(1);
     }
-    console.log(`Opening Stripe Customer Portal...
-${url}`);
-    openUrl(url);
-    printSuccess("Portal opened in your browser.");
+    printSuccess("Stripe Customer Portal URL:");
+    console.log(url);
   } catch (err) {
     printError(`Failed to create portal session: ${err}`);
     process.exit(1);
@@ -2510,10 +2743,8 @@ async function billingUpgradeCommand(opts) {
       printError("No checkout URL returned.");
       process.exit(1);
     }
-    console.log(`Opening Stripe Checkout for ${opts.plan}...
-${url}`);
-    openUrl(url);
-    printSuccess("Checkout opened in your browser.");
+    printSuccess(`Stripe Checkout URL for ${opts.plan}:`);
+    console.log(url);
   } catch (err) {
     printError(`Failed to create checkout session: ${err}`);
     process.exit(1);
@@ -2537,16 +2768,17 @@ __export(form_exports, {
   formFinalizeCommand: () => formFinalizeCommand
 });
 import { input as input2, select, confirm as confirm2, number } from "@inquirer/prompts";
-import chalk7 from "chalk";
+import chalk9 from "chalk";
 import Table2 from "cli-table3";
+import { OfficerTitle } from "@thecorporation/corp-tools";
 function isCorp(entityType) {
   return entityType === "c_corp" || entityType === "s_corp" || entityType === "corporation";
 }
 function sectionHeader(title) {
   console.log();
-  console.log(chalk7.blue("\u2500".repeat(50)));
-  console.log(chalk7.blue.bold(`  ${title}`));
-  console.log(chalk7.blue("\u2500".repeat(50)));
+  console.log(chalk9.blue("\u2500".repeat(50)));
+  console.log(chalk9.blue.bold(`  ${title}`));
+  console.log(chalk9.blue("\u2500".repeat(50)));
 }
 async function promptAddress() {
   const street = await input2({ message: "    Street address" });
@@ -2626,7 +2858,7 @@ async function phasePeople(opts, entityType, scripted) {
   }
   const founderCount = await number({ message: "Number of founders (1-6)", default: 1 }) ?? 1;
   for (let i = 0; i < founderCount; i++) {
-    console.log(chalk7.dim(`
+    console.log(chalk9.dim(`
   Founder ${i + 1} of ${founderCount}:`));
     const name = await input2({ message: `  Name` });
     const email = await input2({ message: `  Email` });
@@ -2649,13 +2881,10 @@ async function phasePeople(opts, entityType, scripted) {
       if (wantOfficer) {
         officerTitle = await select({
           message: "  Officer title",
-          choices: [
-            { value: "ceo", name: "CEO" },
-            { value: "cfo", name: "CFO" },
-            { value: "secretary", name: "Secretary" },
-            { value: "president", name: "President" },
-            { value: "vp", name: "VP" }
-          ]
+          choices: OfficerTitle.map((t) => ({
+            value: t,
+            name: t === "ceo" ? "CEO" : t === "cfo" ? "CFO" : t === "vp" ? "VP" : t.charAt(0).toUpperCase() + t.slice(1)
+          }))
         });
       }
     }
@@ -2675,7 +2904,7 @@ async function phaseStock(opts, entityType, founders, scripted) {
   const rofr = opts.rofr ?? (!scripted && isCorp(entityType) ? await confirm2({ message: "Right of first refusal?", default: true }) : isCorp(entityType));
   if (!scripted) {
     for (const f of founders) {
-      console.log(chalk7.dim(`
+      console.log(chalk9.dim(`
   Equity for ${f.name}:`));
       if (isCorp(entityType)) {
         const shares = await number({ message: `  Shares to purchase`, default: 0 });
@@ -2721,17 +2950,17 @@ async function phaseStock(opts, entityType, founders, scripted) {
 }
 function printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElection, founders, transferRestrictions, rofr) {
   sectionHeader("Formation Summary");
-  console.log(`  ${chalk7.bold("Entity:")} ${name}`);
-  console.log(`  ${chalk7.bold("Type:")} ${entityType}`);
-  console.log(`  ${chalk7.bold("Jurisdiction:")} ${jurisdiction}`);
-  console.log(`  ${chalk7.bold("Fiscal Year End:")} ${fiscalYearEnd}`);
+  console.log(`  ${chalk9.bold("Entity:")} ${name}`);
+  console.log(`  ${chalk9.bold("Type:")} ${entityType}`);
+  console.log(`  ${chalk9.bold("Jurisdiction:")} ${jurisdiction}`);
+  console.log(`  ${chalk9.bold("Fiscal Year End:")} ${fiscalYearEnd}`);
   if (isCorp(entityType)) {
-    console.log(`  ${chalk7.bold("S-Corp Election:")} ${sCorpElection ? "Yes" : "No"}`);
-    console.log(`  ${chalk7.bold("Transfer Restrictions:")} ${transferRestrictions ? "Yes" : "No"}`);
-    console.log(`  ${chalk7.bold("Right of First Refusal:")} ${rofr ? "Yes" : "No"}`);
+    console.log(`  ${chalk9.bold("S-Corp Election:")} ${sCorpElection ? "Yes" : "No"}`);
+    console.log(`  ${chalk9.bold("Transfer Restrictions:")} ${transferRestrictions ? "Yes" : "No"}`);
+    console.log(`  ${chalk9.bold("Right of First Refusal:")} ${rofr ? "Yes" : "No"}`);
   }
   const table = new Table2({
-    head: [chalk7.dim("Name"), chalk7.dim("Email"), chalk7.dim("Role"), chalk7.dim("Equity"), chalk7.dim("Officer")]
+    head: [chalk9.dim("Name"), chalk9.dim("Email"), chalk9.dim("Role"), chalk9.dim("Equity"), chalk9.dim("Officer")]
   });
   for (const f of founders) {
     const equity = f.shares_purchased ? `${f.shares_purchased.toLocaleString()} shares` : f.ownership_pct ? `${f.ownership_pct}%` : "\u2014";
@@ -2755,7 +2984,7 @@ async function formCommand(opts) {
     printSummary(entityType, name, jurisdiction, fiscalYearEnd, sCorpElection, founders, transferRestrictions, rofr);
     const shouldProceed = scripted ? true : await confirm2({ message: "Proceed with formation?", default: true });
     if (!shouldProceed) {
-      console.log(chalk7.yellow("Formation cancelled."));
+      console.log(chalk9.yellow("Formation cancelled."));
       return;
     }
     const members = founders.map((f) => {
@@ -2787,7 +3016,7 @@ async function formCommand(opts) {
     };
     if (companyAddress) payload.company_address = companyAddress;
     const result = await client.createFormationWithCapTable(payload);
-    printSuccess(`Formation created: ${result.formation_id ?? result.id ?? "OK"}`);
+    printSuccess(`Formation created: ${result.formation_id ?? "OK"}`);
     if (result.entity_id) console.log(`  Entity ID: ${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}`);
@@ -2799,17 +3028,17 @@ async function formCommand(opts) {
     if (holders.length > 0) {
       console.log();
       const table = new Table2({
-        head: [chalk7.dim("Holder"), chalk7.dim("Shares"), chalk7.dim("Ownership %")]
+        head: [chalk9.dim("Holder"), chalk9.dim("Shares"), chalk9.dim("Ownership %")]
       });
       for (const h of holders) {
         const pct = typeof h.ownership_pct === "number" ? `${h.ownership_pct.toFixed(1)}%` : "\u2014";
         table.push([String(h.name ?? "?"), String(h.shares ?? 0), pct]);
       }
-      console.log(chalk7.bold("  Cap Table:"));
+      console.log(chalk9.bold("  Cap Table:"));
       console.log(table.toString());
     }
     if (result.next_action) {
-      console.log(chalk7.yellow(`
+      console.log(chalk9.yellow(`
   Next: ${result.next_action}`));
     }
   } catch (err) {
@@ -2818,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);
@@ -2828,13 +3065,22 @@ 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}`);
     console.log(`  Type: ${result.entity_type}`);
     console.log(`  Jurisdiction: ${result.jurisdiction}`);
     console.log(`  Status: ${result.formation_status}`);
-    console.log(chalk7.yellow(`
+    console.log(chalk9.yellow(`
   Next: corp form add-founder ${result.entity_id} --name "..." --email "..." --role member --pct 50`));
   } catch (err) {
     printError(`Failed to create pending entity: ${err}`);
@@ -2851,8 +3097,10 @@ async function formAddFounderCommand(entityId, opts) {
       role: opts.role,
       ownership_pct: parseFloat(opts.pct)
     };
-    if (opts.officerTitle) payload.officer_title = opts.officerTitle;
+    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 ?? [];
@@ -2860,18 +3108,36 @@ async function formAddFounderCommand(entityId, opts) {
       const pct = typeof m.ownership_pct === "number" ? ` (${m.ownership_pct}%)` : "";
       console.log(`  - ${m.name} <${m.email ?? "no email"}> [${m.role ?? "member"}]${pct}`);
     }
-    console.log(chalk7.yellow(`
+    console.log(chalk9.yellow(`
   Next: add more founders or run: corp form finalize ${entityId}`));
   } catch (err) {
     printError(`Failed to add founder: ${err}`);
     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}`);
@@ -2883,17 +3149,17 @@ async function formFinalizeCommand(entityId) {
     if (holders.length > 0) {
       console.log();
       const table = new Table2({
-        head: [chalk7.dim("Holder"), chalk7.dim("Shares"), chalk7.dim("Ownership %")]
+        head: [chalk9.dim("Holder"), chalk9.dim("Shares"), chalk9.dim("Ownership %")]
       });
       for (const h of holders) {
         const pct = typeof h.ownership_pct === "number" ? `${h.ownership_pct.toFixed(1)}%` : "\u2014";
         table.push([String(h.name ?? "?"), String(h.shares ?? 0), pct]);
       }
-      console.log(chalk7.bold("  Cap Table:"));
+      console.log(chalk9.bold("  Cap Table:"));
       console.log(table.toString());
     }
     if (result.next_action) {
-      console.log(chalk7.yellow(`
+      console.log(chalk9.yellow(`
   Next: ${result.next_action}`));
     }
   } catch (err) {
@@ -2915,7 +3181,7 @@ var api_keys_exports = {};
 __export(api_keys_exports, {
   apiKeysCommand: () => apiKeysCommand
 });
-import chalk8 from "chalk";
+import chalk10 from "chalk";
 import Table3 from "cli-table3";
 async function apiKeysCommand(opts) {
   const cfg = requireConfig("api_url", "api_key", "workspace_id");
@@ -2923,7 +3189,11 @@ async function apiKeysCommand(opts) {
   try {
     const keys = await client.listApiKeys();
     if (opts.json) {
-      printJson(keys);
+      printJson(keys.map((k) => ({
+        ...k,
+        ...k.key != null ? { key: maskKey(String(k.key)) } : {},
+        ...k.api_key != null ? { api_key: maskKey(String(k.api_key)) } : {}
+      })));
       return;
     }
     if (keys.length === 0) {
@@ -2931,17 +3201,16 @@ async function apiKeysCommand(opts) {
       return;
     }
     console.log(`
-${chalk8.bold("API Keys")}`);
+${chalk10.bold("API Keys")}`);
     const table = new Table3({
-      head: [chalk8.dim("ID"), chalk8.dim("Name"), chalk8.dim("Key"), chalk8.dim("Created"), chalk8.dim("Last Used")]
+      head: [chalk10.dim("ID"), chalk10.dim("Name"), chalk10.dim("Key"), chalk10.dim("Created")]
     });
     for (const k of keys) {
       table.push([
-        String(k.id ?? k.api_key_id ?? "").slice(0, 12),
+        String(k.key_id ?? k.id ?? k.api_key_id ?? "").slice(0, 12),
         String(k.name ?? ""),
         maskKey(String(k.key ?? k.api_key ?? "")),
-        String(k.created_at ?? ""),
-        String(k.last_used_at ?? "")
+        String(k.created_at ?? "")
       ]);
     }
     console.log(table.toString());
@@ -3119,7 +3388,7 @@ INTERNAL_WORKER_TOKEN={{INTERNAL_WORKER_TOKEN}}
 });
 
 // src/index.ts
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
@@ -3170,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));
@@ -3340,7 +3609,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 <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) => {
+governanceCmd.command("vote <meeting-id> <item-id>").requiredOption("--voter <id>", "Voter contact UUID").addOption(new Option("--vote <value>", "Vote (for, against, abstain, recusal)").choices(["for", "against", "abstain", "recusal"]).makeOptionMandatory()).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);
 });
@@ -3364,7 +3633,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, 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 });
@@ -3383,17 +3652,17 @@ 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();
   const { documentsGenerateCommand: documentsGenerateCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsGenerateCommand2({ ...opts, entityId: parent.entityId });
 });
-documentsCmd.command("preview-pdf").requiredOption("--document-id <id>", "AST document definition ID (e.g. 'bylaws')").description("Preview a governance document as PDF").action(async (opts, cmd) => {
+documentsCmd.command("preview-pdf").requiredOption("--document-id <id>", "AST document definition ID (e.g. 'bylaws')").description("Validate and print the authenticated PDF preview URL for a governance document").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { documentsPreviewPdfCommand: documentsPreviewPdfCommand2 } = await Promise.resolve().then(() => (init_documents(), documents_exports));
   await documentsPreviewPdfCommand2({ ...opts, entityId: parent.entityId });
@@ -3404,7 +3673,7 @@ taxCmd.command("file").requiredOption("--type <type>", "Document type").required
   const { taxFileCommand: taxFileCommand2 } = await Promise.resolve().then(() => (init_tax(), tax_exports));
   await taxFileCommand2({ ...opts, entityId: parent.entityId });
 });
-taxCmd.command("deadline").requiredOption("--type <type>", "Deadline type").requiredOption("--due-date <date>", "Due date (ISO 8601)").requiredOption("--description <desc>", "Description").option("--recurrence <recurrence>", "Recurrence").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)").description("Track a compliance deadline").action(async (opts, cmd) => {
   const parent = cmd.parent.opts();
   const { taxDeadlineCommand: taxDeadlineCommand2 } = await Promise.resolve().then(() => (init_tax(), tax_exports));
   await taxDeadlineCommand2({ ...opts, entityId: parent.entityId });
@@ -3437,14 +3706,44 @@ agentsCmd.command("message <agent-id>").requiredOption("--body <text>", "Message
   const { agentsMessageCommand: agentsMessageCommand2 } = await Promise.resolve().then(() => (init_agents(), agents_exports));
   await agentsMessageCommand2(agentId, opts);
 });
-agentsCmd.command("executions <agent-id>").option("--json", "Output as JSON").description("List agent execution history").action(async (agentId, opts) => {
-  const { agentsExecutionsCommand: agentsExecutionsCommand2 } = await Promise.resolve().then(() => (init_agents(), agents_exports));
-  await agentsExecutionsCommand2(agentId, opts);
-});
 agentsCmd.command("skill <agent-id>").requiredOption("--name <name>", "Skill name").requiredOption("--description <desc>", "Skill description").option("--instructions <text>", "Instructions").description("Add a skill to an agent").action(async (agentId, opts) => {
   const { agentsSkillCommand: agentsSkillCommand2 } = await Promise.resolve().then(() => (init_agents(), agents_exports));
   await agentsSkillCommand2(agentId, opts);
 });
+var workItemsCmd = program.command("work-items").description("Long-term work item coordination").option("--entity-id <id>", "Entity ID (overrides active entity)").option("--json", "Output as JSON").option("--status <status>", "Filter by status (open, claimed, completed, cancelled)").option("--category <category>", "Filter by category").action(async (opts) => {
+  const { workItemsListCommand: workItemsListCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
+  await workItemsListCommand2(opts);
+});
+workItemsCmd.command("show <item-id>").option("--json", "Output as JSON").description("Show work item detail").action(async (itemId, opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { workItemsShowCommand: workItemsShowCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
+  await workItemsShowCommand2(itemId, { ...opts, entityId: parent.entityId });
+});
+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").description("Create a new work item").action(async (opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { workItemsCreateCommand: workItemsCreateCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
+  await workItemsCreateCommand2({ ...opts, entityId: parent.entityId });
+});
+workItemsCmd.command("claim <item-id>").requiredOption("--by <name>", "Agent or user claiming the item").option("--ttl <seconds>", "Auto-release TTL in seconds", parseInt).description("Claim a work item").action(async (itemId, opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { workItemsClaimCommand: workItemsClaimCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
+  await workItemsClaimCommand2(itemId, { claimedBy: opts.by, ttl: opts.ttl, entityId: parent.entityId });
+});
+workItemsCmd.command("complete <item-id>").requiredOption("--by <name>", "Agent or user completing the item").option("--result <text>", "Completion result or notes").description("Mark a work item as completed").action(async (itemId, opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { workItemsCompleteCommand: workItemsCompleteCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
+  await workItemsCompleteCommand2(itemId, { completedBy: opts.by, result: opts.result, entityId: parent.entityId });
+});
+workItemsCmd.command("release <item-id>").description("Release a claimed work item").action(async (itemId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { workItemsReleaseCommand: workItemsReleaseCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
+  await workItemsReleaseCommand2(itemId, { entityId: parent.entityId });
+});
+workItemsCmd.command("cancel <item-id>").description("Cancel a work item").action(async (itemId, _opts, cmd) => {
+  const parent = cmd.parent.opts();
+  const { workItemsCancelCommand: workItemsCancelCommand2 } = await Promise.resolve().then(() => (init_work_items(), work_items_exports));
+  await workItemsCancelCommand2(itemId, { entityId: parent.entityId });
+});
 var billingCmd = program.command("billing").description("Billing status, plans, and subscription management").option("--json", "Output as JSON").action(async (opts) => {
   const { billingCommand: billingCommand2 } = await Promise.resolve().then(() => (init_billing(), billing_exports));
   await billingCommand2(opts);
@@ -3463,23 +3762,23 @@ 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("--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) => {
+var formCmd = program.command("form").description("Form a new entity with founders and cap table").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);
 });
-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));