@thecorporation/cli 26.3.7 → 26.3.9

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) {
@@ -1253,10 +1279,11 @@ async function entitiesShowCommand(entityId, opts) {
       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}`);
@@ -1380,9 +1407,11 @@ async function contactsAddCommand(opts) {
       category: opts.category ?? "employee"
     };
     if (opts.phone) data.phone = opts.phone;
-    if (opts.notes) data.notes = opts.notes;
     const result = await client.createContact(data);
     printSuccess(`Contact created: ${result.contact_id ?? result.id ?? "OK"}`);
+    if (opts.notes) {
+      console.log(chalk4.dim('  Tip: To add notes, use: corp contacts edit <contact-id> --notes "..."'));
+    }
   } catch (err) {
     printError(`Failed to create contact: ${err}`);
     process.exit(1);
@@ -1790,9 +1819,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 +1891,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 +1980,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 +1993,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 +2087,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 +2195,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 +2214,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);
@@ -2244,11 +2304,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 +2330,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 +2353,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 +2391,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 +2414,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 +2443,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 +2526,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,18 +2673,10 @@ __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 {
-  }
-}
 async function billingCommand(opts) {
   const client = makeClient();
   try {
@@ -2492,10 +2697,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 +2713,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 +2738,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 +2828,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 +2851,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 +2874,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 +2920,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 +2954,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 +2986,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 +2998,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) {
@@ -2834,7 +3033,7 @@ async function formCreateCommand(opts) {
     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,7 +3050,7 @@ 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 result = await client.addFounder(entityId, payload);
     printSuccess(`Founder added (${result.member_count} total)`);
@@ -2860,7 +3059,7 @@ 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}`);
@@ -2883,17 +3082,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 +3114,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 +3122,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 +3134,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 +3321,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");
@@ -3340,7 +3542,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 +3566,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 });
@@ -3393,7 +3595,7 @@ documentsCmd.command("generate").requiredOption("--template <type>", "Template t
   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 +3606,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 +3639,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,7 +3695,7 @@ 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));