@islamihab/kds 0.10.0 → 0.12.0

package/index.js

@@ -14406,7 +14406,10 @@ var printHelp = (help) => {
     label: key,
     description: `${field.description ?? ""}${isRequired(field) ? " (required)" : ""}`
   }));
-  const usagePositionals = help.positionals?.map(([key, field]) => isRequired(field) ? ` <${key}>` : ` [${key}]`).join("") ?? "";
+  const usagePositionals = help.positionals?.map(([key, field]) => {
+    const name = isRest(field) ? `${key}...` : key;
+    return isRequired(field) ? ` <${name}>` : ` [${name}]`;
+  }).join("") ?? "";
   const options = help.options?.filter(({ field }) => !isHidden(field)).concat([
     {
       key: "help",
@@ -14451,6 +14454,7 @@ var baseType = (field) => {
   return t;
 };
 var isRequired = (field) => !(field instanceof exports_external.ZodOptional || field instanceof exports_external.ZodDefault);
+var isRest = (field) => baseType(field) instanceof exports_external.ZodArray;
 var isHidden = (field) => field.meta()?.hidden === true;
 var isNegatable = (field) => field.meta()?.negatable === true;
 var isHelpFlag = (arg) => arg === "-h" || arg === "--help";
@@ -14519,7 +14523,8 @@ var parseArgs = ({
       options,
       allowPositionals: (positionalEntries?.length ?? 0) > 0
     });
-    if (positionalEntries && positionals.length > positionalEntries.length) {
+    const hasRest = positionalEntries?.some(([, field]) => isRest(field)) ?? false;
+    if (positionalEntries && !hasRest && positionals.length > positionalEntries.length) {
       help();
       throw new Error(`Unexpected argument '${positionals[positionalEntries.length]}'`);
     }
@@ -14552,6 +14557,10 @@ var parseArgs = ({
 var command = (def) => {
   const inputShape = exports_external.object({ positionals: exports_external.object(def.positionals), options: exports_external.object(def.options) });
   const positionalEntries = Object.entries(inputShape.shape.positionals.shape);
+  const restIndex = positionalEntries.findIndex(([, field]) => isRest(field));
+  if (restIndex !== -1 && restIndex !== positionalEntries.length - 1) {
+    throw new Error(`Positional '${positionalEntries[restIndex]?.[0]}' collects the rest, so it must come last`);
+  }
   const optionsEntries = optionEntries(inputShape.shape.options.shape);
   const run = async (args, path) => {
     const help = () => printHelp({
@@ -14567,7 +14576,10 @@ var command = (def) => {
     await def.run({
       ...inputShape.parse({
         options: values,
-        positionals: Object.fromEntries(positionalEntries.map(([key], index) => [key, positionals[index]]))
+        positionals: Object.fromEntries(positionalEntries.map(([key], index) => [
+          key,
+          index === restIndex && positionals.length > index ? positionals.slice(index) : positionals[index]
+        ]))
       }),
       help
     });
@@ -14611,7 +14623,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "cli",
-  version: "0.10.0",
+  version: "0.12.0",
   private: true,
   type: "module",
   bin: {
@@ -15184,9 +15196,20 @@ var components = componentsGeneric();
 
 // ../../packages/backend/convex/constants.ts
 var KDS_DEVICE_AUTH_CLIENT_ID = "kds-cli";
-var PAGE_MODES = ["themed", "raw"];
+var PAGE_STYLES = {
+  basic: {
+    description: "a report in the house theme with a light/dark toggle and the credit line, where you write only what goes inside the page"
+  },
+  mockup: {
+    description: "an interactive prototype where the fragment is the screen of a phone, its own <style> and <script> tags do the rest, it fills the display on a real phone, and its manifest and apple-touch-icon install it under its own name and icon"
+  },
+  unthemed: {
+    description: "a blank document where the fragment is served as written with nothing added, so its own <style> and <script> tags decide everything"
+  }
+};
 var PAGE_VISIBILITIES = ["public", "private"];
 var MAX_PAGE_HTML_BYTES = 4000000;
+var MAX_PAGE_VERSIONS = 20;
 var ISSUE_STATUSES = [
   "backlog",
   "todo",
@@ -15306,6 +15329,7 @@ var PROJECT_STATUSES = ["planned", "in_progress", "paused", "completed", "cancel
 var PROJECT_HEALTHS = ["on_track", "at_risk", "off_track"];
 var ISSUE_IDENTIFIER_PREFIX = "KAI";
 var ISSUE_LIST_PAGE_SIZE = 50;
+var MAX_ISSUES_PER_BATCH_READ = 20;
 var MAX_ISSUE_ATTACHMENT_BYTES = 1e7;
 var ISSUE_DUE_DATE_MODES = ["overdue", "due_today", "due_soon", "no_due_date"];
 var BUILT_IN_ISSUE_VIEWS = {
@@ -15352,13 +15376,8 @@ var BUILT_IN_ISSUE_VIEWS = {
   }
 };
 var issueIsOpen = (status) => !ISSUE_TERMINAL_STATUSES.some((terminal) => terminal === status);
-var MAX_CLIENT_NAME_LENGTH = 200;
-var MAX_CLIENT_LEGAL_NAME_LENGTH = 200;
-var MAX_CLIENT_BILLING_ADDRESS_LENGTH = 2000;
-var MAX_CLIENT_BILLING_EMAIL_LENGTH = 320;
-var MAX_CLIENT_TAX_ID_LENGTH = 100;
-var MAX_CLIENT_PAYMENT_TERMS_DAYS = 365;
-var MAX_BILLING_DAY = 31;
+var CURRENCIES = ["EGP", "USD", "EUR", "GBP", "AED", "SAR"];
+var DEFAULT_CURRENCY = "EGP";
 var RECURRING_CHARGE_CADENCES = ["monthly", "yearly"];
 var COST_KINDS = ["one_off", "monthly", "yearly"];
 var MAX_PROJECT_REPO_LENGTH = 200;
@@ -17338,6 +17357,7 @@ var localDateString = (timestamp) => {
   return `${date5.getFullYear()}-${month}-${day}`;
 };
 var localToday = () => localDateString(Date.now());
+var describeChoices = (choices, separator = "; ") => Object.entries(choices).map(([key, { description }]) => `${key}: ${description}`).join(separator);
 
 // src/lib/zod.ts
 var configSchema = exports_external.object({ sessionToken: exports_external.string().optional(), convexUrl: exports_external.url(), convexSiteUrl: exports_external.url() });
@@ -24112,6 +24132,10 @@ var issueActivityLine = (detail) => {
     case "attachment_added":
     case "attachment_removed":
       return `${label}: ${detail.name}`;
+    case "page_linked":
+    case "page_unlinked":
+    case "page_updated":
+      return `${label}: ${detail.title}`;
     case "child_added":
     case "child_removed":
       return `${label}: ${detail.identifier}`;
@@ -24257,6 +24281,73 @@ var readPageId = (value) => {
   }
 };
 
+// src/commands/clients/archive.ts
+var archive = command({
+  name: "archive",
+  description: "Archive a client: it leaves pickers and default lists, and every existing reference stays intact",
+  positionals: {
+    id: exports_external.string().describe("Client id or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const backend = await backendClient();
+    const { name } = await backend.mutation(api2.clients.archive, { id: readClientRef(id) });
+    console.log(`Archived ${name}.`);
+  }
+});
+
+// src/lib/currency.ts
+var CURRENCY_CHOICES = CURRENCIES.join(", ");
+var currencyCode = exports_external.preprocess((value) => typeof value === "string" ? value.toUpperCase() : value, exports_external.enum(CURRENCIES));
+var parseLineCurrency = (raw) => {
+  const code2 = raw.trim().toUpperCase();
+  if (!code2)
+    return DEFAULT_CURRENCY;
+  const codes = CURRENCIES;
+  if (!codes.includes(code2))
+    throw new Error(`Line currency must be one of ${CURRENCY_CHOICES}; got "${raw.trim()}".`);
+  return code2;
+};
+
+// src/commands/clients/charges/add.ts
+var add = command({
+  name: "add",
+  description: "Add a recurring charge to a client and print its id",
+  positionals: {
+    client: exports_external.string().describe("Client id or URL"),
+    description: exports_external.string().describe('What the charge is for, e.g. "Maintenance retainer"')
+  },
+  options: {
+    amount: exports_external.coerce.number().int().describe("Amount in integer minor units (2500 = 25.00)").meta({ short: "a" }),
+    currency: currencyCode.default(DEFAULT_CURRENCY).describe(`One of ${CURRENCY_CHOICES}`).meta({ short: "c" }),
+    cadence: exports_external.enum(RECURRING_CHARGE_CADENCES).default("monthly").describe("monthly or yearly"),
+    "due-month": exports_external.coerce.number().int().optional().describe("Month (1-12) a yearly charge falls due; defaults to the current month")
+  },
+  run: async ({ positionals: { client: ref, description }, options }) => {
+    const backend = await backendClient();
+    const chargeId = await backend.mutation(api2.recurringCharges.create, {
+      clientId: readClientRef(ref),
+      description,
+      amount: options.amount,
+      currency: options.currency,
+      cadence: options.cadence,
+      dueMonth: options["due-month"]
+    });
+    console.log(chargeId);
+  }
+});
+
+// src/lib/output.ts
+var formatMinorAmount = (amount, currency) => `${(amount / 100).toFixed(2)} ${currency}`;
+var printTable = (rows) => {
+  if (rows.length === 0)
+    return;
+  const columnCount = Math.max(...rows.map((row) => row.length));
+  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
+  for (const row of rows) {
+    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
+  }
+};
+
 // ../../packages/backend/convex/lib/projectRepo.ts
 var DEFAULT_REPO_HOST = "github.com";
 var REPO_FORMAT_ERROR = "Enter a repository like github.com/owner/name.";
@@ -24329,24 +24420,6 @@ var resolveQuotation = async (client3, ref) => {
     throw new Error(`No quotation matches ${ref}.`);
   return quotation;
 };
-var resolvePayment = async (client3, ref) => {
-  const payment = await client3.query(api2.invoices.getPayment, { id: ref.trim() });
-  if (!payment)
-    throw new Error(`No payment matches ${ref}.`);
-  return payment;
-};
-var resolveRecurringCharge = async (client3, ref) => {
-  const charge = await client3.query(api2.recurringCharges.get, { id: ref.trim() });
-  if (!charge)
-    throw new Error(`No recurring charge matches ${ref}.`);
-  return charge;
-};
-var resolveCost = async (client3, ref) => {
-  const cost = await client3.query(api2.costs.get, { id: ref.trim(), today: localToday() });
-  if (!cost)
-    throw new Error(`No cost matches ${ref}.`);
-  return cost;
-};
 var repoProject = async (client3) => {
   const repo = await currentRepoKey();
   if (!repo)
@@ -24356,88 +24429,6 @@ var repoProject = async (client3) => {
     throw new Error(`No project is connected to ${repo}. Connect one on the project in the dashboard.`);
   return project;
 };
-var missingLabelError = async (client3, lead) => {
-  const labels = await client3.query(api2.issueLabels.list, {});
-  const available = labels.map((candidate) => candidate.name).join(", ");
-  return new Error(available ? `${lead} The labels are: ${available}.` : "There are no labels yet.");
-};
-var resolveIssueLabels = async (client3, names) => await Promise.all(names.map(async (name) => {
-  const label = await client3.query(api2.issueLabels.find, { ref: name });
-  if (!label)
-    throw await missingLabelError(client3, `No label named "${name}".`);
-  return label;
-}));
-var resolveIssueLabel = async (client3, ref) => {
-  const label = await client3.query(api2.issueLabels.find, { ref });
-  if (!label)
-    throw await missingLabelError(client3, `No label matches "${ref}".`);
-  return label;
-};
-var resolveMilestone = async (client3, projectId, name) => {
-  const milestone = await client3.query(api2.milestones.find, { projectId, name });
-  if (!milestone) {
-    const milestones = await client3.query(api2.milestones.listByProject, { projectId, today: localToday() });
-    const names = milestones.map((candidate) => candidate.name).join(", ");
-    throw new Error(names ? `No milestone named "${name}". The project has: ${names}.` : "The project has no milestones.");
-  }
-  return milestone;
-};
-
-// src/commands/clients/archive.ts
-var archive = command({
-  name: "archive",
-  description: "Archive a client: it leaves pickers and default lists, and every existing reference stays intact",
-  positionals: {
-    id: exports_external.string().describe("Client id or URL")
-  },
-  run: async ({ positionals: { id } }) => {
-    const backend = await backendClient();
-    const client3 = await resolveClient(backend, id);
-    await backend.mutation(api2.clients.archive, { id: client3._id });
-    console.log(`Archived ${client3.name}.`);
-  }
-});
-
-// src/commands/clients/charges/add.ts
-var add = command({
-  name: "add",
-  description: "Add a recurring charge to a client and print its id",
-  positionals: {
-    client: exports_external.string().describe("Client id or URL"),
-    description: exports_external.string().describe('What the charge is for, e.g. "Maintenance retainer"')
-  },
-  options: {
-    amount: exports_external.coerce.number().int().describe("Amount in integer minor units (2500 = 25.00)").meta({ short: "a" }),
-    currency: exports_external.string().describe("Three-letter code like USD or EUR").meta({ short: "c" }),
-    cadence: exports_external.enum(RECURRING_CHARGE_CADENCES).default("monthly").describe("monthly or yearly"),
-    "due-month": exports_external.coerce.number().int().optional().describe("Month (1-12) a yearly charge falls due; defaults to the current month")
-  },
-  run: async ({ positionals: { client: ref, description }, options }) => {
-    const backend = await backendClient();
-    const client3 = await resolveClient(backend, ref);
-    const chargeId = await backend.mutation(api2.recurringCharges.create, {
-      clientId: client3._id,
-      description,
-      amount: options.amount,
-      currency: options.currency,
-      cadence: options.cadence,
-      dueMonth: options["due-month"]
-    });
-    console.log(chargeId);
-  }
-});
-
-// src/lib/output.ts
-var formatMinorAmount = (amount, currency) => `${(amount / 100).toFixed(2)} ${currency}`;
-var printTable = (rows) => {
-  if (rows.length === 0)
-    return;
-  const columnCount = Math.max(...rows.map((row) => row.length));
-  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
-  for (const row of rows) {
-    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
-  }
-};
 
 // src/commands/clients/charges/list.ts
 var monthName = (month) => new Date(Date.UTC(2000, month - 1)).toLocaleString("en-US", { month: "short", timeZone: "UTC" });
@@ -24480,9 +24471,8 @@ var pause = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const charge = await resolveRecurringCharge(backend, id);
-    await backend.mutation(api2.recurringCharges.pause, { id: charge._id });
-    console.log(`Paused ${charge.description}.`);
+    const { description } = await backend.mutation(api2.recurringCharges.pause, { id: id.trim() });
+    console.log(`Paused ${description}.`);
   }
 });
 
@@ -24495,9 +24485,8 @@ var remove = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const charge = await resolveRecurringCharge(backend, id);
-    await backend.mutation(api2.recurringCharges.remove, { id: charge._id });
-    console.log(`Removed ${charge.description}.`);
+    const { description } = await backend.mutation(api2.recurringCharges.remove, { id: id.trim() });
+    console.log(`Removed ${description}.`);
   }
 });
 
@@ -24510,9 +24499,8 @@ var resume = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const charge = await resolveRecurringCharge(backend, id);
-    await backend.mutation(api2.recurringCharges.resume, { id: charge._id });
-    console.log(`Resumed ${charge.description}.`);
+    const { description } = await backend.mutation(api2.recurringCharges.resume, { id: id.trim() });
+    console.log(`Resumed ${description}.`);
   }
 });
 
@@ -24526,7 +24514,7 @@ var update = command({
   options: {
     description: exports_external.string().optional().describe("New description").meta({ short: "d" }),
     amount: exports_external.coerce.number().int().optional().describe("Amount in integer minor units").meta({ short: "a" }),
-    currency: exports_external.string().optional().describe("Three-letter code like USD or EUR").meta({ short: "c" }),
+    currency: currencyCode.optional().describe(`One of ${CURRENCY_CHOICES}`).meta({ short: "c" }),
     cadence: exports_external.enum(RECURRING_CHARGE_CADENCES).optional().describe("monthly or yearly"),
     "due-month": exports_external.coerce.number().int().optional().describe("Month (1-12) a yearly charge falls due")
   },
@@ -24535,16 +24523,15 @@ var update = command({
       throw new Error("Nothing to update. Pass --description, --amount, --currency, --cadence, or --due-month.");
     }
     const backend = await backendClient();
-    const charge = await resolveRecurringCharge(backend, id);
-    await backend.mutation(api2.recurringCharges.update, {
-      id: charge._id,
+    const { description } = await backend.mutation(api2.recurringCharges.update, {
+      id: id.trim(),
       description: options.description,
       amount: options.amount,
       currency: options.currency,
       cadence: options.cadence,
       dueMonth: options["due-month"]
     });
-    console.log(`Updated ${options.description ?? charge.description}.`);
+    console.log(`Updated ${description}.`);
   }
 });
 
@@ -24658,65 +24645,6 @@ More clients exist; raise --limit past ${limit}.`);
   }
 });
 
-// ../../packages/backend/convex/lib/clientProfile.ts
-var normalizeClientName = (value) => {
-  const name = value.trim();
-  if (!name)
-    throw new ConvexError("Client name is required.");
-  if (name.length > MAX_CLIENT_NAME_LENGTH) {
-    throw new ConvexError(`Client name must be ${MAX_CLIENT_NAME_LENGTH} characters or fewer.`);
-  }
-  return name;
-};
-var normalizeOptionalText = (value, label, max) => {
-  const text = value?.trim();
-  if (!text)
-    return;
-  if (text.length > max)
-    throw new ConvexError(`${label} must be ${max} characters or fewer.`);
-  return text;
-};
-var normalizeLegalName = (value) => normalizeOptionalText(value, "Legal name", MAX_CLIENT_LEGAL_NAME_LENGTH);
-var normalizeBillingAddress = (value) => normalizeOptionalText(value, "Billing address", MAX_CLIENT_BILLING_ADDRESS_LENGTH);
-var normalizeTaxId = (value) => normalizeOptionalText(value, "Tax ID", MAX_CLIENT_TAX_ID_LENGTH);
-var normalizeBillingEmail = (value) => {
-  const email3 = normalizeOptionalText(value, "Billing email", MAX_CLIENT_BILLING_EMAIL_LENGTH);
-  if (email3 === undefined)
-    return;
-  if (!/^[^\s@]+@[^\s@]+$/.test(email3))
-    throw new ConvexError("Billing email must be a single valid address.");
-  return email3;
-};
-var assertPaymentTermsDays = (value) => {
-  if (value === undefined)
-    return;
-  if (!Number.isInteger(value) || value < 0 || value > MAX_CLIENT_PAYMENT_TERMS_DAYS) {
-    throw new ConvexError(`Payment terms must be a whole number of days between 0 and ${MAX_CLIENT_PAYMENT_TERMS_DAYS}.`);
-  }
-  return value;
-};
-var normalizeCurrencyCode = (value) => {
-  const code2 = value?.trim().toUpperCase();
-  if (!code2)
-    return;
-  if (!/^[A-Z]{3}$/.test(code2))
-    throw new ConvexError("Currency must be a three-letter code like USD or EUR.");
-  return code2;
-};
-
-// ../../node_modules/.bun/convex-helpers@0.1.120+1dd148a8b8056605/node_modules/convex-helpers/index.js
-var _error = Symbol();
-
-// ../../packages/backend/convex/lib/billingRun.ts
-var assertBillingDay = (value) => {
-  if (value === undefined)
-    return;
-  if (!Number.isInteger(value) || value < 1 || value > MAX_BILLING_DAY) {
-    throw new ConvexError(`Billing day must be a whole number from 1 to ${MAX_BILLING_DAY}.`);
-  }
-  return value;
-};
-
 // src/commands/clients/update.ts
 var update2 = command({
   name: "update",
@@ -24740,42 +24668,19 @@ var update2 = command({
       throw new Error("Nothing to update. Pass a profile flag, or a --no form to clear one.");
     }
     const text = (value) => value === null ? "" : value;
-    const profile = {
-      name: options.name,
-      legalName: text(options["legal-name"]),
-      billingAddress: text(options.address),
-      billingEmail: text(options.email),
-      taxId: text(options["tax-id"])
-    };
-    const terms = options["payment-terms"];
-    const billingDay = options["billing-day"];
-    if (profile.name !== undefined)
-      normalizeClientName(profile.name);
-    normalizeLegalName(profile.legalName);
-    normalizeBillingAddress(profile.billingAddress);
-    normalizeBillingEmail(profile.billingEmail);
-    normalizeTaxId(profile.taxId);
-    assertPaymentTermsDays(terms ?? undefined);
-    normalizeCurrencyCode(options.currency ?? undefined);
-    assertBillingDay(billingDay ?? undefined);
     const backend = await backendClient();
-    const client3 = await resolveClient(backend, id);
-    if (Object.values(profile).some((value) => value !== undefined)) {
-      await backend.mutation(api2.clients.update, { id: client3._id, ...profile });
-    }
-    if (terms !== undefined) {
-      await backend.mutation(api2.clients.setPaymentTerms, { id: client3._id, paymentTermsDays: terms ?? undefined });
-    }
-    if (options.currency !== undefined) {
-      await backend.mutation(api2.clients.setDefaultCurrency, {
-        id: client3._id,
-        defaultCurrency: options.currency ?? undefined
-      });
-    }
-    if (billingDay !== undefined) {
-      await backend.mutation(api2.clients.setBillingDay, { id: client3._id, billingDay: billingDay ?? undefined });
-    }
-    console.log(`Updated ${options.name?.trim() ?? client3.name}.`);
+    const { name } = await backend.mutation(api2.clients.edit, {
+      id: readClientRef(id),
+      ...options.name !== undefined ? { name: options.name } : {},
+      ...options["legal-name"] !== undefined ? { legalName: text(options["legal-name"]) } : {},
+      ...options.address !== undefined ? { billingAddress: text(options.address) } : {},
+      ...options.email !== undefined ? { billingEmail: text(options.email) } : {},
+      ...options["tax-id"] !== undefined ? { taxId: text(options["tax-id"]) } : {},
+      ...options["payment-terms"] !== undefined ? { paymentTermsDays: options["payment-terms"] } : {},
+      ...options.currency !== undefined ? { defaultCurrency: options.currency } : {},
+      ...options["billing-day"] !== undefined ? { billingDay: options["billing-day"] } : {}
+    });
+    console.log(`Updated ${name}.`);
   }
 });
 
@@ -24793,15 +24698,16 @@ var create2 = command({
   name: "create",
   description: "Record a cost and print its id",
   longDescription: `One record per real-world bill, never one per project. A cost links to any number
-of projects, each carrying the full amount; no links at all is overhead. Billable
-costs pass through onto a client's invoices, so their projects must all belong to
-the same client.`,
+of projects, each carrying the full amount; until a client's project carries it, it
+is overhead. Billable
+costs pass through onto the invoices of whichever client their projects belong to,
+so the links cannot span two clients; with no links, billable waits for one.`,
   positionals: {
     name: exports_external.string().describe('What the bill is for, e.g. "Figma seats"')
   },
   options: {
     amount: exports_external.coerce.number().int().describe("Amount in integer minor units (2500 = 25.00)").meta({ short: "a" }),
-    currency: exports_external.string().describe("Three-letter code like USD or EUR").meta({ short: "c" }),
+    currency: currencyCode.default(DEFAULT_CURRENCY).describe(`One of ${CURRENCY_CHOICES}`).meta({ short: "c" }),
     kind: exports_external.enum(COST_KINDS).default("one_off").describe("one_off, monthly, or yearly").meta({ short: "k" }),
     date: exports_external.string().optional().describe("The one-off's date, or a subscription's start (YYYY-MM-DD); default today"),
     end: exports_external.string().optional().describe("Last date a subscription is committed to (YYYY-MM-DD)"),
@@ -24811,7 +24717,6 @@ the same client.`,
   },
   run: async ({ positionals: { name }, options }) => {
     const backend = await backendClient();
-    const projects = await Promise.all((options.project ?? []).map((ref) => resolveProject(backend, ref)));
     const costId = await backend.mutation(api2.costs.create, {
       name,
       note: options.note,
@@ -24820,7 +24725,7 @@ the same client.`,
       endDate: options.end,
       amount: options.amount,
       currency: options.currency,
-      projectIds: projects.map((project) => project._id),
+      projectIds: options.project?.map(readProjectRef),
       billable: options.billable
     });
     console.log(costId);
@@ -24840,10 +24745,9 @@ var end = command({
   },
   run: async ({ positionals: { id }, options }) => {
     const backend = await backendClient();
-    const cost = await resolveCost(backend, id);
     const today = localToday();
-    await backend.mutation(api2.costs.end, { id: cost._id, endDate: options.date, today });
-    console.log(`Ended ${cost.name} on ${options.date ?? today}.`);
+    const { name } = await backend.mutation(api2.costs.end, { id: id.trim(), endDate: options.date, today });
+    console.log(`Ended ${name} on ${options.date ?? today}.`);
   }
 });
 
@@ -24854,9 +24758,10 @@ var costKindLabel = (cost) => {
   return cost.endDate === undefined ? cost.kind : `${cost.kind} \u2192 ${cost.endDate}`;
 };
 var costProjectsLabel = (cost) => {
-  if (cost.overhead)
-    return "overhead";
-  return cost.projects.length === 0 ? "(deleted project)" : cost.projects.map((project) => project.name).join(", ");
+  const names = cost.projects.map((project) => project.name).join(", ");
+  if (!cost.overhead)
+    return names;
+  return names === "" ? "overhead" : `overhead (${names})`;
 };
 
 // src/commands/costs/get.ts
@@ -24904,7 +24809,7 @@ after an edit. A yearly cost lands whole in its renewal month, never amortized.`
     month: exports_external.string().optional().describe("Derive one month's costs (YYYY-MM)").meta({ short: "m" }),
     kind: exports_external.enum(COST_KINDS).optional().describe("Only one_off, monthly, or yearly").meta({ short: "k" }),
     project: exports_external.string().optional().describe("Only costs linked to this project (id, URL, or repo)").meta({ short: "p" }),
-    overhead: exports_external.boolean().default(false).describe("Only costs with no project links"),
+    overhead: exports_external.boolean().default(false).describe("Only costs no client's project carries"),
     billable: exports_external.boolean().optional().describe("Only billable costs, or --no-billable").meta({ negatable: true }),
     limit: exports_external.coerce.number().int().positive().default(50).describe("Most costs to print"),
     json: exports_external.boolean().default(false).describe("Print as JSON")
@@ -24954,9 +24859,8 @@ var remove2 = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const cost = await resolveCost(backend, id);
-    await backend.mutation(api2.costs.remove, { id: cost._id });
-    console.log(`Deleted ${cost.name}.`);
+    const { name } = await backend.mutation(api2.costs.remove, { id: id.trim() });
+    console.log(`Deleted ${name}.`);
   }
 });
 
@@ -24975,7 +24879,7 @@ is fixed at creation \u2014 delete and re-record to change it.`,
   options: {
     name: exports_external.string().optional().describe("New name"),
     amount: exports_external.coerce.number().int().optional().describe("Amount in integer minor units").meta({ short: "a" }),
-    currency: exports_external.string().optional().describe("Three-letter code like USD or EUR").meta({ short: "c" }),
+    currency: currencyCode.optional().describe(`One of ${CURRENCY_CHOICES}`).meta({ short: "c" }),
     date: exports_external.string().optional().describe("The one-off's date, or a subscription's start (YYYY-MM-DD)"),
     end: exports_external.string().nullable().optional().describe("End date (YYYY-MM-DD), or --no-end to resume").meta({
       negatable: true
@@ -24991,10 +24895,8 @@ is fixed at creation \u2014 delete and re-record to change it.`,
       throw new Error("Nothing to update. Pass --name, --amount, --currency, --date, --end, --project, --billable, or --note.");
     }
     const backend = await backendClient();
-    const cost = await resolveCost(backend, id);
-    const projects = options.project ? await Promise.all(options.project.map((ref) => resolveProject(backend, ref))) : [];
-    await backend.mutation(api2.costs.update, {
-      id: cost._id,
+    const { name } = await backend.mutation(api2.costs.update, {
+      id: id.trim(),
       today: localToday(),
       name: options.name,
       note: options.note === null ? "" : options.note,
@@ -25002,10 +24904,10 @@ is fixed at creation \u2014 delete and re-record to change it.`,
       endDate: options.end === null ? "" : options.end,
       amount: options.amount,
       currency: options.currency,
-      projectIds: options.project === undefined ? undefined : projects.map((project) => project._id),
+      projectIds: options.project === null ? [] : options.project?.map(readProjectRef),
       billable: options.billable
     });
-    console.log(`Updated ${options.name ?? cost.name}.`);
+    console.log(`Updated ${name}.`);
   }
 });
 
@@ -25015,7 +24917,7 @@ var costs = group({
   description: "Manage costs",
   longDescription: `A cost is money the studio spends, recorded once per real-world bill. It links to any
 number of projects \u2014 each carrying the full amount, so per-project figures never sum
-to the studio total \u2014 and no links at all is overhead. Occurrences are always derived
+to the studio total. A cost no client's project carries is overhead. Occurrences are always derived
 from the record, so \`costs list --month\` answers for any month, past or future.`,
   commands: [create2, list3, get2, update3, end, remove2]
 });
@@ -25309,9 +25211,10 @@ var seen = command({
   },
   run: async ({ positionals: { id } }) => {
     const client3 = await backendClient();
-    const issue2 = id === undefined ? undefined : await resolveIssue(client3, id);
-    await client3.mutation(api2.inbox.markSeen, { targetId: issue2?._id });
-    console.log(issue2 ? `${issue2.identifier} marked seen.` : "Inbox marked seen.");
+    const { identifier } = await client3.mutation(api2.inbox.markSeen, {
+      targetId: id === undefined ? undefined : readIssueRef(id)
+    });
+    console.log(identifier ? `${identifier} marked seen.` : "Inbox marked seen.");
   }
 });
 
@@ -25325,10 +25228,10 @@ var inbox = group({
 });
 
 // src/lib/line-items.ts
-var LINE_ITEM_SYNTAX = 'description|quantity[ unit]|unit price|currency, e.g. "Development|2.5 hours|10000|EUR"';
+var LINE_ITEM_SYNTAX = 'description|quantity[ unit]|unit price[|currency], e.g. "Development|2.5 hours|10000|USD"; currency defaults to EGP';
 var parseLineItem = (value) => {
   const parts = value.split("|");
-  if (parts.length !== 4)
+  if (parts.length !== 3 && parts.length !== 4)
     throw new Error(`Line items read as ${LINE_ITEM_SYNTAX}; got "${value}".`);
   const [description = "", quantityPart = "", pricePart = "", currency = ""] = parts;
   const [rawQuantity = "", ...unitWords] = quantityPart.trim().split(/\s+/);
@@ -25341,12 +25244,18 @@ var parseLineItem = (value) => {
     throw new Error(`Unit prices must be integer minor units (10000 = 100.00), got "${pricePart.trim()}".`);
   }
   const unit = unitWords.join(" ");
-  return { description: description.trim(), quantity, unit: unit || undefined, unitPrice, currency: currency.trim() };
+  return {
+    description: description.trim(),
+    quantity,
+    unit: unit || undefined,
+    unitPrice,
+    currency: parseLineCurrency(currency)
+  };
 };
-var QUOTATION_LINE_ITEM_SYNTAX = 'description|quantity[ unit]|unit price|currency[|section], e.g. "Prototype|1|100000|EUR|Phase 1"';
+var QUOTATION_LINE_ITEM_SYNTAX = 'description|quantity[ unit]|unit price[|currency[|section]], e.g. "Prototype|1|100000|USD|Phase 1"; an empty currency part defaults to EGP';
 var parseQuotationLineItem = (value) => {
   const parts = value.split("|");
-  if (parts.length !== 4 && parts.length !== 5) {
+  if (parts.length < 3 || parts.length > 5) {
     throw new Error(`Quotation line items read as ${QUOTATION_LINE_ITEM_SYNTAX}; got "${value}".`);
   }
   const section = parts.length === 5 ? parts.pop()?.trim() : undefined;
@@ -25369,11 +25278,9 @@ var create3 = command({
   },
   run: async ({ positionals: { client: ref }, options }) => {
     const backend = await backendClient();
-    const client3 = await resolveClient(backend, ref);
-    const project = options.project === undefined ? undefined : await resolveProject(backend, options.project);
     const invoiceId = await backend.mutation(api2.invoices.create, {
-      clientId: client3._id,
-      projectId: project?._id,
+      clientId: readClientRef(ref),
+      projectId: options.project === undefined ? undefined : readProjectRef(options.project),
       lineItems: options.line?.map(parseLineItem),
       notes: options.notes,
       dueDate: options.due
@@ -25391,8 +25298,21 @@ var duplicate = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const invoice = await resolveInvoice(backend, id);
-    console.log(await backend.mutation(api2.invoices.duplicate, { id: invoice._id }));
+    console.log(await backend.mutation(api2.invoices.duplicate, { id: readInvoiceRef(id) }));
+  }
+});
+
+// src/commands/invoices/email.ts
+var email3 = command({
+  name: "email",
+  description: "Email the invoice's link to the client's billing address; repeatable, and never required",
+  positionals: {
+    id: exports_external.string().describe("Invoice id or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const backend = await backendClient();
+    const { to, number: number4 } = await backend.mutation(api2.invoices.email, { id: readInvoiceRef(id) });
+    console.log(`Emailed ${number4} to ${to}.`);
   }
 });
 
@@ -25421,6 +25341,9 @@ var get3 = command({
       console.log(`Due: ${invoice.dueDate}`);
     if (invoice.publicUrl)
       console.log(`Link: ${invoice.publicUrl}`);
+    if (invoice.status !== "draft") {
+      console.log(`Emailed: ${invoice.lastEmailedAt === undefined ? "never" : localDateString(invoice.lastEmailedAt)}`);
+    }
     if (invoice.lineItems.length > 0) {
       console.log("");
       printTable([
@@ -25460,9 +25383,7 @@ var issue2 = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const invoice = await resolveInvoice(backend, id);
-    await backend.mutation(api2.invoices.issue, { id: invoice._id, today: localToday() });
-    const issued = await resolveInvoice(backend, invoice._id);
+    const issued = await backend.mutation(api2.invoices.issue, { id: readInvoiceRef(id), today: localToday() });
     console.log(`Issued ${issued.number}, due ${issued.dueDate}.`);
   }
 });
@@ -25477,10 +25398,11 @@ var link = command({
   },
   run: async ({ positionals: { id, project: projectRef } }) => {
     const backend = await backendClient();
-    const invoice = await resolveInvoice(backend, id);
-    const project = projectRef === undefined ? undefined : await resolveProject(backend, projectRef);
-    await backend.mutation(api2.invoices.setProject, { id: invoice._id, projectId: project?._id });
-    console.log(project ? `Linked to ${project.name}.` : "Cleared the project link.");
+    const { projectName } = await backend.mutation(api2.invoices.setProject, {
+      id: readInvoiceRef(id),
+      projectId: projectRef === undefined ? undefined : readProjectRef(projectRef)
+    });
+    console.log(projectName === undefined ? "Cleared the project link." : `Linked to ${projectName}.`);
   }
 });
 
@@ -25508,7 +25430,7 @@ var list4 = command({
     if (result.page.length === 0)
       return console.log("No invoices yet.");
     printTable([
-      ["NUMBER", "CLIENT", "PROJECT", "STATUS", "TOTAL", "DUE", "ID"],
+      ["NUMBER", "CLIENT", "PROJECT", "STATUS", "TOTAL", "DUE", "EMAILED", "ID"],
       ...result.page.map((invoice) => [
         invoice.number ?? "draft",
         invoice.clientName,
@@ -25516,6 +25438,7 @@ var list4 = command({
         invoice.derivedStatus,
         formatPerCurrency(invoice.totals.map(({ currency, total }) => ({ currency, amount: total }))),
         invoice.dueDate ?? "-",
+        invoice.lastEmailedAt === undefined ? "-" : localDateString(invoice.lastEmailedAt),
         invoice._id
       ])
     ]);
@@ -25540,18 +25463,16 @@ var add2 = command({
   },
   run: async ({ positionals: { invoice: ref }, options }) => {
     const backend = await backendClient();
-    const invoice = await resolveInvoice(backend, ref);
-    const paymentId = await backend.mutation(api2.invoices.addPayment, {
-      invoiceId: invoice._id,
+    const payment = await backend.mutation(api2.invoices.addPayment, {
+      invoiceId: readInvoiceRef(ref),
       amount: options.amount,
       currency: options.currency,
       paidOn: options.date ?? localToday(),
       note: options.note
     });
-    console.log(paymentId);
-    if ((await resolveInvoice(backend, invoice._id)).status === "paid") {
-      console.log(`${invoice.number} is now fully paid.`);
-    }
+    console.log(payment.id);
+    if (payment.paid)
+      console.log(`${payment.number} is now fully paid.`);
   }
 });
 
@@ -25592,8 +25513,7 @@ var remove3 = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const payment = await resolvePayment(backend, id);
-    await backend.mutation(api2.invoices.removePayment, { id: payment._id });
+    await backend.mutation(api2.invoices.removePayment, { id: id.trim() });
     console.log("Removed the payment.");
   }
 });
@@ -25617,9 +25537,8 @@ var rotateLink = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const invoice = await resolveInvoice(backend, id);
-    const url2 = await backend.mutation(api2.invoices.rotateLink, { id: invoice._id });
-    console.log(`${invoice.number} now reads at ${url2}. Send it again \u2014 the previous link is dead.`);
+    const { url: url2, number: number4 } = await backend.mutation(api2.invoices.rotateLink, { id: readInvoiceRef(id) });
+    console.log(`${number4} now reads at ${url2}. Send it again \u2014 the previous link is dead.`);
   }
 });
 
@@ -25641,14 +25560,13 @@ var update4 = command({
       throw new Error("Nothing to update. Pass --line, --notes, or --due (or a --no form to clear).");
     }
     const backend = await backendClient();
-    const invoice = await resolveInvoice(backend, id);
-    await backend.mutation(api2.invoices.update, {
-      id: invoice._id,
+    const { number: number4 } = await backend.mutation(api2.invoices.update, {
+      id: readInvoiceRef(id),
       lineItems: options.line?.map(parseLineItem),
       notes: options.notes === null ? "" : options.notes,
       dueDate: options.due === null ? "" : options.due
     });
-    console.log(`Updated ${invoice.number ?? "draft"}.`);
+    console.log(`Updated ${number4 ?? "draft"}.`);
   }
 });
 
@@ -25661,9 +25579,8 @@ var voidInvoice = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const invoice = await resolveInvoice(backend, id);
-    await backend.mutation(api2.invoices.voidInvoice, { id: invoice._id });
-    console.log(`Voided ${invoice.number}.`);
+    const { number: number4 } = await backend.mutation(api2.invoices.voidInvoice, { id: readInvoiceRef(id) });
+    console.log(`Voided ${number4}.`);
   }
 });
 
@@ -25674,7 +25591,7 @@ var invoices = group({
   longDescription: `An invoice is a draft until issued: issuing assigns its gapless number, freezes the
 document, and snapshots the client's billing details. Sent invoices are immutable \u2014
 the fix path is void + duplicate into a fresh draft. Drafts delete outright.`,
-  commands: [create3, list4, get3, update4, issue2, voidInvoice, duplicate, link, rotateLink, payments]
+  commands: [create3, list4, get3, update4, issue2, email3, voidInvoice, duplicate, link, rotateLink, payments]
 });
 
 // src/lib/attachments.ts
@@ -25743,10 +25660,15 @@ var comment = command({
   },
   run: async ({ positionals: { id, body }, options: { attach } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    printAttachments(await attachFiles(client3, issue3._id, attach ?? []));
-    await client3.mutation(api2.issueComments.create, { issueId: issue3._id, bodyMarkdown: await readTextOption(body) });
-    console.log(`Commented on ${issue3.identifier}.`);
+    if (attach !== undefined && attach.length > 0) {
+      const issue3 = await resolveIssue(client3, id);
+      printAttachments(await attachFiles(client3, issue3._id, attach));
+    }
+    const { identifier } = await client3.mutation(api2.issueComments.create, {
+      issueId: readIssueRef(id),
+      bodyMarkdown: await readTextOption(body)
+    });
+    console.log(`Commented on ${identifier}.`);
   }
 });
 
@@ -25766,7 +25688,6 @@ var agentConfigurationLine = (id) => {
 var create4 = command({
   name: "create",
   description: "Create an issue and print its identifier",
-  longDescription: "--disposition ready_for_agent requires --agent-config; the agent queue refuses an issue without one.",
   positionals: {
     title: exports_external.string().describe("Issue title")
   },
@@ -25781,17 +25702,22 @@ var create4 = command({
     milestone: exports_external.string().optional().describe("Milestone name (needs --project or --here)"),
     parent: exports_external.string().optional().describe("Create as a sub-issue of this issue (identifier, number, or URL)"),
     disposition: exports_external.enum(ISSUE_CREATE_DISPOSITIONS).optional().describe("Route immediately (default needs_triage)"),
+    label: exports_external.array(exports_external.string()).optional().describe("Add a label by name (repeatable)"),
     "agent-config": exports_external.enum(AGENT_CONFIGURATION_IDS).optional().describe(`Agent configuration${agentConfigurationLegacyNote()}`)
   },
   run: async ({ positionals: { title }, options }) => {
     if (options.project && options.here)
       throw new Error("Pass --project or --here, not both.");
-    const client3 = await backendClient();
-    const project = options.project ? await resolveProject(client3, options.project) : options.here ? await repoProject(client3) : undefined;
-    if (options.milestone && !project)
+    let projectRef = options.project === undefined ? undefined : readProjectRef(options.project);
+    if (options.here) {
+      const repo = await currentRepoKey();
+      if (!repo)
+        throw new Error("No repository here: not a git checkout with an origin remote.");
+      projectRef = repo;
+    }
+    if (options.milestone && projectRef === undefined)
       throw new Error("A milestone needs --project or --here.");
-    const milestone = project && options.milestone ? await resolveMilestone(client3, project._id, options.milestone) : undefined;
-    const parent = options.parent ? await resolveIssue(client3, options.parent) : undefined;
+    const client3 = await backendClient();
     const { identifier } = await client3.mutation(api2.issues.create, {
       title,
       descriptionMarkdown: options.description === undefined ? undefined : await readTextOption(options.description),
@@ -25799,11 +25725,12 @@ var create4 = command({
       priority: options.priority,
       estimate: options.estimate,
       dueDate: options.due,
-      projectId: project?._id,
-      milestoneId: milestone?._id,
-      parentId: parent?._id,
+      projectId: projectRef,
+      milestoneId: options.milestone,
+      parentId: options.parent === undefined ? undefined : readIssueRef(options.parent),
       disposition: options.disposition,
-      agentConfigurationId: options["agent-config"]
+      agentConfigurationId: options["agent-config"],
+      labels: options.label
     });
     console.log(identifier);
   }
@@ -25821,86 +25748,107 @@ var printTasks = (tasks) => {
 };
 
 // src/commands/issues/get.ts
+var printIssue = ({ relations, attachments, pages, tasks, feed, milestone, ...issue3 }) => {
+  const project = issue3.project;
+  console.log(`${issue3.identifier} ${issue3.title}`);
+  console.log(`Status: ${issue3.status} \xB7 Priority: ${issue3.priority} \xB7 Disposition: ${issue3.disposition}`);
+  if (issue3.estimate !== undefined)
+    console.log(`Estimate: ${issue3.estimate}`);
+  if (issue3.dueDate)
+    console.log(`Due: ${issue3.dueDate}`);
+  if (issue3.agentConfigurationId)
+    console.log(`Agent: ${agentConfigurationLine(issue3.agentConfigurationId)}`);
+  if (issue3.branch)
+    console.log(`Branch: ${issue3.branch}`);
+  if (issue3.prUrl)
+    console.log(`PR: ${issue3.prUrl}`);
+  if (project)
+    console.log(`Project: ${project.name}${milestone ? ` \xB7 Milestone: ${milestone.name}` : ""}`);
+  if (issue3.parent)
+    console.log(`Parent: ${issue3.parent.identifier} ${issue3.parent.title}`);
+  if (issue3.labels.length > 0)
+    console.log(`Labels: ${issue3.labels.map((label) => label.name).join(", ")}`);
+  if (issue3.children.total > 0)
+    console.log(`Sub-issues: ${issue3.children.done}/${issue3.children.total} done`);
+  const related = (entries) => entries.map((entry) => `${entry.issue.identifier} (${entry.issue.status})`).join(", ");
+  if (relations.blockedBy.length > 0)
+    console.log(`Blocked by: ${related(relations.blockedBy)}`);
+  if (relations.blocks.length > 0)
+    console.log(`Blocks: ${related(relations.blocks)}`);
+  if (relations.duplicateOf)
+    console.log(`Duplicate of: ${related([relations.duplicateOf])}`);
+  if (relations.duplicates.length > 0)
+    console.log(`Duplicated by: ${related(relations.duplicates)}`);
+  if (relations.relatesTo.length > 0)
+    console.log(`Related: ${related(relations.relatesTo)}`);
+  if (attachments.length > 0) {
+    console.log("Attachments:");
+    for (const attachment of attachments) {
+      console.log(`  ${attachment.name} \u2014 ${attachment.url ?? "unavailable"}`);
+    }
+  }
+  if (pages.length > 0) {
+    console.log("Pages:");
+    for (const page of pages) {
+      console.log(`  ${page.title} (${page.style}, ${page.visibility}) \u2014 ${page.url}`);
+    }
+  }
+  printTasks(tasks);
+  if (issue3.descriptionMarkdown)
+    console.log(`
+${issue3.descriptionMarkdown}`);
+  if (feed.events.length > 0)
+    console.log(`
+Feed:`);
+  if (feed.truncated)
+    console.log("(older events truncated)");
+  for (const event of feed.events) {
+    const at = new Date(event.at).toISOString().slice(0, 16).replace("T", " ");
+    if (event.type === "activity") {
+      const via = event.via === undefined ? "" : ` \u2014 ${actorLabel(event.via, event.agent)}`;
+      console.log(`${at}  ${issueActivityLine(event.detail)}${via}`);
+    } else {
+      console.log(`${at}  comment${event.editedAt ? " (edited)" : ""}:`);
+      for (const line of event.bodyMarkdown.split(`
+`))
+        console.log(`  ${line}`);
+    }
+  }
+};
 var get4 = command({
   name: "get",
-  description: "Show an issue: properties, description, and its feed",
+  description: "Show one or more issues: properties, description, and feed",
   positionals: {
-    id: exports_external.string().describe("Issue identifier, number, or URL")
+    ids: exports_external.array(exports_external.string()).min(1).describe(`Issue identifiers, numbers, or URLs (up to ${MAX_ISSUES_PER_BATCH_READ} per call)`)
   },
   options: {
-    json: exports_external.boolean().default(false).describe("Print as JSON")
+    json: exports_external.boolean().default(false).describe("Print as JSON (an array when given several issues)")
   },
-  run: async ({ positionals: { id }, options: { json: json2 } }) => {
+  run: async ({ positionals: { ids }, options: { json: json2 } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const [feed, relations, attachments, tasks] = await Promise.all([
-      client3.query(api2.issues.feed, { id: issue3._id }),
-      client3.query(api2.issues.relations, { id: issue3._id }),
-      client3.query(api2.issueAttachments.list, { issueId: issue3._id }),
-      client3.query(api2.issueTasks.list, { issueId: issue3._id })
-    ]);
-    if (json2)
-      return console.log(JSON.stringify({ ...issue3, relations, attachments, tasks, feed }, null, 2));
-    const project = issue3.project;
-    const milestone = issue3.milestoneId ? await client3.query(api2.milestones.get, { id: issue3.milestoneId, today: localToday() }) : null;
-    console.log(`${issue3.identifier} ${issue3.title}`);
-    console.log(`Status: ${issue3.status} \xB7 Priority: ${issue3.priority} \xB7 Disposition: ${issue3.disposition}`);
-    if (issue3.estimate !== undefined)
-      console.log(`Estimate: ${issue3.estimate}`);
-    if (issue3.dueDate)
-      console.log(`Due: ${issue3.dueDate}`);
-    if (issue3.agentConfigurationId)
-      console.log(`Agent: ${agentConfigurationLine(issue3.agentConfigurationId)}`);
-    if (issue3.branch)
-      console.log(`Branch: ${issue3.branch}`);
-    if (issue3.prUrl)
-      console.log(`PR: ${issue3.prUrl}`);
-    if (project)
-      console.log(`Project: ${project.name}${milestone ? ` \xB7 Milestone: ${milestone.name}` : ""}`);
-    if (issue3.parent)
-      console.log(`Parent: ${issue3.parent.identifier} ${issue3.parent.title}`);
-    if (issue3.labels.length > 0)
-      console.log(`Labels: ${issue3.labels.map((label) => label.name).join(", ")}`);
-    if (issue3.children.total > 0)
-      console.log(`Sub-issues: ${issue3.children.done}/${issue3.children.total} done`);
-    const related = (entries) => entries.map((entry) => `${entry.issue.identifier} (${entry.issue.status})`).join(", ");
-    if (relations.blockedBy.length > 0)
-      console.log(`Blocked by: ${related(relations.blockedBy)}`);
-    if (relations.blocks.length > 0)
-      console.log(`Blocks: ${related(relations.blocks)}`);
-    if (relations.duplicateOf)
-      console.log(`Duplicate of: ${related([relations.duplicateOf])}`);
-    if (relations.duplicates.length > 0)
-      console.log(`Duplicated by: ${related(relations.duplicates)}`);
-    if (relations.relatesTo.length > 0)
-      console.log(`Related: ${related(relations.relatesTo)}`);
-    if (attachments.length > 0) {
-      console.log("Attachments:");
-      for (const attachment of attachments) {
-        console.log(`  ${attachment.name} \u2014 ${attachment.url ?? "unavailable"}`);
-      }
-    }
-    printTasks(tasks);
-    if (issue3.descriptionMarkdown)
-      console.log(`
-${issue3.descriptionMarkdown}`);
-    if (feed.events.length > 0)
-      console.log(`
-Feed:`);
-    if (feed.truncated)
-      console.log("(older events truncated)");
-    for (const event of feed.events) {
-      const at = new Date(event.at).toISOString().slice(0, 16).replace("T", " ");
-      if (event.type === "activity") {
-        const via = event.via === undefined ? "" : ` \u2014 ${actorLabel(event.via, event.agent)}`;
-        console.log(`${at}  ${issueActivityLine(event.detail)}${via}`);
-      } else {
-        console.log(`${at}  comment${event.editedAt ? " (edited)" : ""}:`);
-        for (const line of event.bodyMarkdown.split(`
-`))
-          console.log(`  ${line}`);
-      }
+    const found = await client3.query(api2.issues.getMany, { identifiers: ids.map(readIssueRef) });
+    const missing = ids.filter((_, index) => !found[index]);
+    if (missing.length === 1)
+      throw new Error(`No issue matches ${missing[0]}.`);
+    if (missing.length > 1)
+      throw new Error(`No issues match ${missing.join(", ")}.`);
+    const details = found.flatMap((detail) => detail ? [detail] : []);
+    if (json2) {
+      const objects = details.map(({ relations, attachments, pages, tasks, feed, milestone: _, ...issue3 }) => ({
+        ...issue3,
+        relations,
+        attachments,
+        pages,
+        tasks,
+        feed
+      }));
+      return console.log(JSON.stringify(details.length === 1 ? objects[0] : objects, null, 2));
     }
+    details.forEach((detail, index) => {
+      if (index > 0)
+        console.log("---");
+      printIssue(detail);
+    });
   }
 });
 
@@ -25947,9 +25895,8 @@ var remove4 = command({
   },
   run: async ({ positionals: { label: ref } }) => {
     const client3 = await backendClient();
-    const label = await resolveIssueLabel(client3, ref);
-    await client3.mutation(api2.issueLabels.remove, { id: label._id });
-    console.log(`Deleted ${label.name}.`);
+    const removed = await client3.mutation(api2.issueLabels.remove, { id: ref });
+    console.log(`Deleted ${removed.name}.`);
   }
 });
 
@@ -25968,9 +25915,8 @@ var update5 = command({
     if (name === undefined && color === undefined)
       throw new Error("Nothing to update. Pass --name or --color.");
     const client3 = await backendClient();
-    const label = await resolveIssueLabel(client3, ref);
-    await client3.mutation(api2.issueLabels.update, { id: label._id, name, color });
-    console.log(`Updated ${name ?? label.name}.`);
+    const updated = await client3.mutation(api2.issueLabels.update, { id: ref, name, color });
+    console.log(`Updated ${updated.name}.`);
   }
 });
 
@@ -25981,7 +25927,50 @@ var labels = group({
   commands: [create5, list6, update5, remove4]
 });
 
+// src/commands/issues/link-pr.ts
+var linkPr = command({
+  name: "link-pr",
+  description: "Link a pull request to an issue by hand",
+  longDescription: `For a pull request the webhook cannot match on its own: work that started before
+its issue existed, so the branch never carried the identifier, or a second issue the
+same pull request lands. From here reviews and the merge move the issue as usual.
+--claim applies what opening the pull request would have: unstarted work moves to
+in_progress; any other status is kept.`,
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL"),
+    url: exports_external.string().describe("Pull request URL")
+  },
+  options: {
+    claim: exports_external.boolean().default(false).describe("Move backlog or todo work to in_progress along with the link")
+  },
+  run: async ({ positionals: { id, url: url2 }, options: { claim: claim2 } }) => {
+    const client3 = await backendClient();
+    const { identifier, linked, status: status3 } = await client3.mutation(api2.issues.linkPr, {
+      id: readIssueRef(id),
+      prUrl: url2,
+      ...claim2 ? { claim: claim2 } : {}
+    });
+    console.log(`${linked ? "Linked" : "Already linked"} ${url2} to ${identifier}: ${status3}`);
+  }
+});
+
 // src/commands/issues/list.ts
+var resolveScope = async (client3, { project, here, milestone }) => {
+  if (milestone) {
+    if (!project && !here)
+      throw new Error("A milestone filter needs --project or --here.");
+    const ref = project ? readProjectRef(project) : await currentRepoKey();
+    if (!ref)
+      throw new Error("No repository here: not a git checkout with an origin remote.");
+    const resolved = await client3.query(api2.milestones.resolve, { project: ref, name: milestone });
+    return { projectId: resolved.projectId, milestoneId: resolved._id };
+  }
+  if (project)
+    return { projectId: (await resolveProject(client3, project))._id };
+  if (here)
+    return { projectId: (await repoProject(client3))._id };
+  return;
+};
 var list7 = command({
   name: "list",
   description: "List open issues, most recently updated first",
@@ -26002,10 +25991,7 @@ var list7 = command({
     if (options.project && options.here)
       throw new Error("Pass --project or --here, not both.");
     const client3 = await backendClient();
-    const project = options.project ? await resolveProject(client3, options.project) : options.here ? await repoProject(client3) : undefined;
-    if (options.milestone && !project)
-      throw new Error("A milestone filter needs --project or --here.");
-    const milestone = project && options.milestone ? await resolveMilestone(client3, project._id, options.milestone) : undefined;
+    const scope = await resolveScope(client3, options);
     const result = await client3.query(api2.issueViews.query, {
       source: {
         type: "custom",
@@ -26019,8 +26005,8 @@ var list7 = command({
             statuses: options.status ? [options.status] : options.all ? undefined : ISSUE_STATUSES.filter(issueIsOpen),
             priorities: options.priority ? [options.priority] : undefined,
             dispositions: options.disposition ? [options.disposition] : undefined,
-            projectIds: project ? [project._id] : undefined,
-            milestoneIds: milestone ? [milestone._id] : undefined,
+            projectIds: scope ? [scope.projectId] : undefined,
+            milestoneIds: scope?.milestoneId ? [scope.milestoneId] : undefined,
             dueDate: options.due
           }
         }
@@ -26069,9 +26055,8 @@ var markAddressed = command({
   },
   run: async ({ positionals: { id }, options: { commit, finding } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
     const result = await client3.action(api2.githubReviewer.markAddressed, {
-      id: issue3._id,
+      id: readIssueRef(id),
       commitSha: commit,
       findings: finding?.map(parseFindingRef)
     });
@@ -26092,10 +26077,12 @@ var relate = command({
   },
   run: async ({ positionals: { id, kind, other } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const otherIssue = await resolveIssue(client3, other);
-    await client3.mutation(api2.issues.addRelation, { id: issue3._id, kind, otherIssueId: otherIssue._id });
-    console.log(`${issue3.identifier} ${kind.replaceAll("_", " ")} ${otherIssue.identifier}.`);
+    const { identifier, otherIdentifier } = await client3.mutation(api2.issues.addRelation, {
+      id: readIssueRef(id),
+      kind,
+      otherIssueId: readIssueRef(other)
+    });
+    console.log(`${identifier} ${kind.replaceAll("_", " ")} ${otherIdentifier}.`);
   }
 });
 
@@ -26108,9 +26095,8 @@ var remove5 = command({
   },
   run: async ({ positionals: { id } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    await client3.mutation(api2.issues.remove, { id: issue3._id });
-    console.log(`Deleted ${issue3.identifier}.`);
+    const { identifier } = await client3.mutation(api2.issues.remove, { id: readIssueRef(id) });
+    console.log(`Deleted ${identifier}.`);
   }
 });
 
@@ -26118,8 +26104,7 @@ var remove5 = command({
 var route = command({
   name: "route",
   description: "Route an issue to a disposition (wontfix also cancels it)",
-  longDescription: `The disposition says who acts next; needs_triage is the default. Routing to
-ready_for_agent requires the issue to carry an agent configuration (set --agent-config).`,
+  longDescription: "The disposition says who acts next; needs_triage is the default.",
   positionals: {
     id: exports_external.string().describe("Issue identifier, number, or URL"),
     disposition: exports_external.enum(ISSUE_DISPOSITIONS).describe("Where the issue goes next")
@@ -26129,13 +26114,12 @@ ready_for_agent requires the issue to carry an agent configuration (set --agent-
   },
   run: async ({ positionals: { id, disposition }, options: { comment: comment2 } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    await client3.mutation(api2.issues.route, {
-      id: issue3._id,
+    const { identifier } = await client3.mutation(api2.issues.route, {
+      id: readIssueRef(id),
       disposition,
       comment: comment2 === undefined ? undefined : await readTextOption(comment2)
     });
-    console.log(`Routed ${issue3.identifier} to ${disposition}.`);
+    console.log(`Routed ${identifier} to ${disposition}.`);
   }
 });
 
@@ -26144,8 +26128,7 @@ var set2 = command({
   name: "set",
   description: "Set an issue's status, priority, estimate, due date, project, milestone, parent, agent configuration, or labels",
   longDescription: `Status normally moves through the workflow commands and the linked pull request;
---status is the correction path. Clearing the agent configuration is refused while
-the issue sits in ready_for_agent.`,
+--status is the correction path.`,
   positionals: {
     id: exports_external.string().describe("Issue identifier, number, or URL")
   },
@@ -26177,41 +26160,20 @@ the issue sits in ready_for_agent.`,
     if (Object.values(options).every((value) => value === undefined))
       throw new Error("Nothing to set. Pass --status, --priority, --estimate, --due, --project, --milestone, --parent, --agent-config, or --label.");
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const projectId = project === undefined ? issue3.project?._id : project === null ? undefined : (await resolveProject(client3, project))._id;
-    let milestoneId;
-    if (milestone === undefined) {
-      milestoneId = projectId === issue3.project?._id ? issue3.milestoneId : undefined;
-    } else if (milestone !== null) {
-      if (projectId === undefined)
-        throw new Error("A milestone needs a project. Pass --project too.");
-      milestoneId = (await resolveMilestone(client3, projectId, milestone))._id;
-    }
-    const parentId = parent == null ? undefined : (await resolveIssue(client3, parent))._id;
-    const addLabels = await resolveIssueLabels(client3, label ?? []);
-    const removeLabels = await resolveIssueLabels(client3, noLabel ?? []);
-    if (parent !== undefined)
-      await client3.mutation(api2.issues.setParent, { id: issue3._id, parentId });
-    for (const { _id } of addLabels)
-      await client3.mutation(api2.issues.addLabel, { issueId: issue3._id, labelId: _id });
-    for (const { _id } of removeLabels)
-      await client3.mutation(api2.issues.removeLabel, { issueId: issue3._id, labelId: _id });
-    if (agentConfig !== undefined)
-      await client3.mutation(api2.issues.setAgentConfiguration, {
-        id: issue3._id,
-        agentConfigurationId: agentConfig ?? undefined
-      });
-    if (status3 !== undefined)
-      await client3.mutation(api2.issues.setStatus, { id: issue3._id, status: status3 });
-    if (priority !== undefined)
-      await client3.mutation(api2.issues.setPriority, { id: issue3._id, priority });
-    if (estimate !== undefined)
-      await client3.mutation(api2.issues.setEstimate, { id: issue3._id, estimate: estimate ?? undefined });
-    if (due !== undefined)
-      await client3.mutation(api2.issues.setDueDate, { id: issue3._id, dueDate: due ?? undefined });
-    if (project !== undefined || milestone !== undefined)
-      await client3.mutation(api2.issues.setMembership, { id: issue3._id, projectId, milestoneId });
-    console.log(`Updated ${issue3.identifier}.`);
+    const { identifier } = await client3.mutation(api2.issues.edit, {
+      issue: readIssueRef(id),
+      ...parent !== undefined ? { parent: parent === null ? null : readIssueRef(parent) } : {},
+      ...label !== undefined ? { addLabels: label } : {},
+      ...noLabel !== undefined ? { removeLabels: noLabel } : {},
+      ...agentConfig !== undefined ? { agentConfigurationId: agentConfig } : {},
+      ...status3 !== undefined ? { status: status3 } : {},
+      ...priority !== undefined ? { priority } : {},
+      ...estimate !== undefined ? { estimate } : {},
+      ...due !== undefined ? { dueDate: due } : {},
+      ...project !== undefined ? { project: project === null ? null : readProjectRef(project) } : {},
+      ...milestone !== undefined ? { milestone } : {}
+    });
+    console.log(`Updated ${identifier}.`);
   }
 });
 
@@ -26229,29 +26191,18 @@ ready_for_agent is informational, and --ready belongs only to an explicit hand-o
     ready: exports_external.boolean().default(false).describe("Also route the issue to ready_for_agent, assigning the running agent when it is identifiable")
   },
   run: async ({ positionals: { id }, options: { ready } }) => {
+    const actor = await agentClaim();
+    const configurationId = actor && agentConfigurationForActor(actor);
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const { branch } = await client3.mutation(api2.issues.start, { id: issue3._id });
-    let assigned;
-    if (ready) {
-      const actor = await agentClaim();
-      const configurationId = actor && agentConfigurationForActor(actor);
-      if (configurationId && configurationId !== issue3.agentConfigurationId) {
-        await client3.mutation(api2.issues.setAgentConfiguration, {
-          id: issue3._id,
-          agentConfigurationId: configurationId
-        });
-        assigned = configurationId;
-      }
-    }
-    if (ready && issue3.disposition !== "ready_for_agent") {
-      await client3.mutation(api2.issues.route, { id: issue3._id, disposition: "ready_for_agent" });
-    }
-    console.log(`Started ${issue3.identifier}: in_progress, branch ${branch}`);
+    const { identifier, branch, disposition, assigned } = await client3.mutation(api2.issues.start, {
+      issue: readIssueRef(id),
+      ...ready ? { ready: { agentConfigurationId: configurationId || undefined } } : {}
+    });
+    console.log(`Started ${identifier}: in_progress, branch ${branch}`);
     if (ready) {
       console.log(`Routed to ready_for_agent${assigned ? `, assigned ${agentConfiguration(assigned).label}` : ""}.`);
-    } else if (issue3.disposition !== "ready_for_agent" && await agentClaim()) {
-      console.log(`Note: disposition is ${issue3.disposition}. Pass --ready if this hand-off was intended.`);
+    } else if (disposition !== "ready_for_agent" && actor) {
+      console.log(`Note: disposition is ${disposition}. Pass --ready if this hand-off was intended.`);
     }
     console.log(`
   git switch -c ${shellArg(branch)}`);
@@ -26267,8 +26218,7 @@ var startReview = command({
   },
   run: async ({ positionals: { id } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const started = await client3.action(api2.githubReviewer.startReview, { id: issue3._id });
+    const started = await client3.action(api2.githubReviewer.startReview, { id: readIssueRef(id) });
     console.log(`Reviewing ${started.identifier}: in_review`);
     console.log(`Announced on ${started.prUrl}; check run open.`);
   }
@@ -26283,9 +26233,8 @@ var submit = command({
   },
   run: async ({ positionals: { id } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    await client3.mutation(api2.issues.submit, { id: issue3._id });
-    console.log(`Submitted ${issue3.identifier}: ready_for_review`);
+    const { identifier } = await client3.mutation(api2.issues.submit, { id: readIssueRef(id) });
+    console.log(`Submitted ${identifier}: ready_for_review`);
   }
 });
 
@@ -26349,8 +26298,7 @@ Categories: ${REVIEW_FINDING_CATEGORIES.join(", ")}; severities: ${REVIEW_FINDIN
       verdict = { kind: "request_changes", findings: await readFindings(options.findings) };
     }
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const submitted = await client3.action(api2.githubReviewer.submitReview, { id: issue3._id, verdict });
+    const submitted = await client3.action(api2.githubReviewer.submitReview, { id: readIssueRef(id), verdict });
     console.log(`Submitted review on ${submitted.identifier}: ${submitted.prUrl}`);
     console.log(submitted.summary);
   }
@@ -26377,57 +26325,38 @@ address several rows even as removals renumber it.`,
   },
   run: async ({ positionals: { id }, options: { add: add3, check: check2, uncheck, convert, remove: remove6, json: json2 } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const before = await client3.query(api2.issueTasks.list, { issueId: issue3._id });
-    const at = (numbered) => (numbered ?? []).map((number4) => {
-      const task2 = before[number4 - 1];
-      if (!task2)
-        throw new Error(`${issue3.identifier} has no task ${number4}.`);
-      return task2;
-    });
-    const ticked = at(check2);
-    const unticked = at(uncheck);
-    const promoted = at(convert);
-    const dropped = at(remove6);
-    for (const title of add3 ?? [])
-      await client3.mutation(api2.issueTasks.create, { issueId: issue3._id, title });
-    for (const task2 of ticked)
-      await client3.mutation(api2.issueTasks.update, { id: task2._id, isDone: true });
-    for (const task2 of unticked)
-      await client3.mutation(api2.issueTasks.update, { id: task2._id, isDone: false });
-    for (const task2 of promoted) {
-      const created = await client3.mutation(api2.issueTasks.convert, { id: task2._id });
+    const wrote = [add3, check2, uncheck, convert, remove6].some((values) => values !== undefined);
+    if (wrote) {
+      const { identifier, converted, tasks: tasks3 } = await client3.mutation(api2.issueTasks.edit, {
+        issue: readIssueRef(id),
+        ...add3 !== undefined ? { add: add3 } : {},
+        ...check2 !== undefined ? { check: check2 } : {},
+        ...uncheck !== undefined ? { uncheck } : {},
+        ...convert !== undefined ? { convert } : {},
+        ...remove6 !== undefined ? { remove: remove6 } : {}
+      });
       if (!json2) {
-        console.log(`${created.identifier} ${created.nested ? "created as a sub-issue" : "created and related"}: ${task2.title}`);
+        for (const created of converted) {
+          console.log(`${created.identifier} ${created.nested ? "created as a sub-issue" : "created and related"}: ${created.title}`);
+        }
       }
+      if (json2)
+        return console.log(JSON.stringify(tasks3, null, 2));
+      if (tasks3.length === 0)
+        return console.log(`${identifier} has no tasks.`);
+      return printTasks(tasks3);
     }
-    for (const task2 of dropped)
-      await client3.mutation(api2.issueTasks.remove, { id: task2._id });
-    const wrote = [add3, check2, uncheck, convert, remove6].some((values) => values !== undefined);
-    const after = wrote ? await client3.query(api2.issueTasks.list, { issueId: issue3._id }) : before;
+    const issue3 = await resolveIssue(client3, id);
+    const tasks2 = await client3.query(api2.issueTasks.list, { issueId: issue3._id });
     if (json2)
-      return console.log(JSON.stringify(after, null, 2));
-    if (after.length === 0)
+      return console.log(JSON.stringify(tasks2, null, 2));
+    if (tasks2.length === 0)
       return console.log(`${issue3.identifier} has no tasks.`);
-    printTasks(after);
+    printTasks(tasks2);
   }
 });
 
 // src/commands/issues/unrelate.ts
-var relationEntries = (relations, kind) => {
-  switch (kind) {
-    case "blocks":
-      return relations.blocks;
-    case "blocked_by":
-      return relations.blockedBy;
-    case "duplicate_of":
-      return relations.duplicateOf ? [relations.duplicateOf] : [];
-    case "duplicated_by":
-      return relations.duplicates;
-    case "relates_to":
-      return relations.relatesTo;
-  }
-};
 var unrelate = command({
   name: "unrelate",
   description: "Remove a relation between two issues (a canceled duplicate stays canceled)",
@@ -26438,15 +26367,12 @@ var unrelate = command({
   },
   run: async ({ positionals: { id, kind, other } }) => {
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    const otherIssue = await resolveIssue(client3, other);
-    const relations = await client3.query(api2.issues.relations, { id: issue3._id });
-    const relation = relationEntries(relations, kind).find((entry) => entry.issue._id === otherIssue._id);
-    const label = kind.replaceAll("_", " ");
-    if (!relation)
-      throw new Error(`${issue3.identifier} has no "${label}" relation to ${otherIssue.identifier}.`);
-    await client3.mutation(api2.issues.removeRelation, { id: relation._id });
-    console.log(`Removed: ${issue3.identifier} ${label} ${otherIssue.identifier}.`);
+    const { identifier, otherIdentifier } = await client3.mutation(api2.issues.removeRelation, {
+      id: readIssueRef(id),
+      kind,
+      otherIssueId: readIssueRef(other)
+    });
+    console.log(`Removed: ${identifier} ${kind.replaceAll("_", " ")} ${otherIdentifier}.`);
   }
 });
 
@@ -26466,16 +26392,18 @@ var update6 = command({
     if (title === undefined && description === undefined && attach === undefined)
       throw new Error("Nothing to update. Pass --title, --description, or --attach.");
     const client3 = await backendClient();
-    const issue3 = await resolveIssue(client3, id);
-    printAttachments(await attachFiles(client3, issue3._id, attach ?? []));
-    if (title !== undefined || description !== undefined) {
-      await client3.mutation(api2.issues.update, {
-        id: issue3._id,
-        title,
-        descriptionMarkdown: description === undefined ? undefined : await readTextOption(description)
-      });
-    }
-    console.log(`Updated ${issue3.identifier}.`);
+    let attached;
+    if (attach !== undefined && attach.length > 0) {
+      const issue3 = await resolveIssue(client3, id);
+      printAttachments(await attachFiles(client3, issue3._id, attach));
+      attached = issue3.identifier;
+    }
+    const identifier = title !== undefined || description !== undefined ? (await client3.mutation(api2.issues.update, {
+      id: readIssueRef(id),
+      title,
+      descriptionMarkdown: description === undefined ? undefined : await readTextOption(description)
+    })).identifier : attached;
+    console.log(`Updated ${identifier}.`);
   }
 });
 
@@ -26488,11 +26416,11 @@ todo, in_progress, ready_for_review, in_review, changes_requested, approved, don
 canceled), priority, and disposition (who acts next). The workflow commands \u2014 start,
 submit, start-review, submit-review \u2014 and the linked pull request move the status;
 each refuses an issue outside its own status, and \`set -s\` is for corrections.
-The repo link is never set by hand: work on a branch whose name contains the issue
-identifier and the branch, pull request, and status track automatically \u2014 a change
-request moves the issue to changes_requested, an approval to approved (one
-outstanding change request outweighs any number of approvals), and a merge lands
-it as done.`,
+Work on a branch whose name contains the issue identifier and the branch, pull
+request, and status track automatically \u2014 a change request moves the issue to
+changes_requested, an approval to approved (one outstanding change request outweighs
+any number of approvals), and a merge lands it as done. link-pr covers the pull
+request the branch name does not point at; from there the same tracking applies.`,
   commands: [
     create4,
     list7,
@@ -26506,6 +26434,7 @@ it as done.`,
     startReview,
     submitReview,
     markAddressed,
+    linkPr,
     tasks,
     relate,
     unrelate,
@@ -26514,6 +26443,9 @@ it as done.`,
   ]
 });
 
+// ../../packages/backend/convex/lib/object.ts
+var keys = (object2) => Object.keys(object2);
+
 // src/lib/group.ts
 import { basename as basename2 } from "path";
 var git = async (...args) => {
@@ -26541,20 +26473,21 @@ var create6 = command({
   options: {
     title: exports_external.string().describe("Page title").meta({ short: "t" }),
     group: exports_external.string().nullable().optional().describe("Group to list the page under (default: the current repo)").meta({ short: "g", negatable: true }),
-    raw: exports_external.boolean().default(false).describe("Serve a full document verbatim (may run JS)"),
-    private: exports_external.boolean().default(false).describe("Require the publishing account to view the page")
+    style: exports_external.enum(keys(PAGE_STYLES)).default("basic").describe(`Style to render in \u2014 ${describeChoices(PAGE_STYLES)}`),
+    private: exports_external.boolean().default(false).describe("Require the publishing account to view the page"),
+    issue: exports_external.string().optional().describe("Link the page to an issue (KAI-N, number, or URL)")
   },
-  run: async ({ positionals: { file: file2 }, options: { title, group: group2, raw, private: isPrivate } }) => {
+  run: async ({ positionals: { file: file2 }, options: { title, group: group2, style, private: isPrivate, issue: issue3 } }) => {
     const newGroup = await groupForCreate(group2);
     const html = await readBody(file2);
-    const mode = raw ? "raw" : "themed";
     const visibility = isPrivate ? "private" : "public";
     const { url: url2 } = await (await backendClient()).action(api2.pages.create, {
       title,
       group: newGroup,
       html,
-      mode,
-      visibility
+      style,
+      visibility,
+      issue: issue3 === undefined ? undefined : readIssueRef(issue3)
     });
     console.log(url2);
   }
@@ -26598,12 +26531,12 @@ var list8 = command({
     if (pages.length === 0)
       return console.log(group2 === undefined ? "No pages yet." : "No pages in that group.");
     printTable([
-      ["TITLE", "GROUP", "ACCESS", "MODE", "SIZE", "VERSIONS", "CREATED", "URL"],
+      ["TITLE", "GROUP", "ACCESS", "STYLE", "SIZE", "VERSIONS", "CREATED", "URL"],
       ...pages.map((page) => [
         page.title,
         page.group ?? "-",
         page.visibility,
-        page.mode,
+        page.style,
         formatBytes(page.size),
         page.versions === 0 ? "-" : String(page.versions),
         new Date(page.createdAt).toISOString().slice(0, 10),
@@ -26626,6 +26559,14 @@ var remove6 = command({
   }
 });
 
+// src/lib/pages.ts
+var warnPruned = (pruned) => {
+  if (pruned.length === 0)
+    return;
+  const versions2 = pruned.length === 1 ? `version ${pruned[0]}` : `versions ${pruned.join(", ")}`;
+  console.error(`Pruned ${versions2}; the history keeps the newest ${MAX_PAGE_VERSIONS}.`);
+};
+
 // src/commands/pages/revert.ts
 var revert = command({
   name: "revert",
@@ -26635,7 +26576,8 @@ var revert = command({
     version: exports_external.coerce.number().int().positive().describe("Version number from `kds pages versions`")
   },
   run: async ({ positionals: { id, version: version4 } }) => {
-    const { url: url2 } = await (await backendClient()).mutation(api2.pages.revert, { id: readPageId(id), version: version4 });
+    const { url: url2, pruned } = await (await backendClient()).mutation(api2.pages.revert, { id: readPageId(id), version: version4 });
+    warnPruned(pruned);
     console.log(url2);
   }
 });
@@ -26643,7 +26585,7 @@ var revert = command({
 // src/commands/pages/update.ts
 var update7 = command({
   name: "update",
-  description: "Replace a page's HTML, title, group, mode, or visibility",
+  description: "Replace a page's HTML, title, group, style, or visibility",
   positionals: {
     id: exports_external.string().describe("Page id or URL"),
     file: exports_external.string().optional().describe("HTML file, or - for stdin")
@@ -26651,21 +26593,24 @@ var update7 = command({
   options: {
     title: exports_external.string().optional().describe("New page title").meta({ short: "t" }),
     group: exports_external.string().nullable().optional().describe("Move the page to this group, or --no-group to remove it from one").meta({ short: "g", negatable: true }),
-    mode: exports_external.enum(PAGE_MODES).optional().describe("New serving mode"),
-    visibility: exports_external.enum(PAGE_VISIBILITIES).optional().describe("Who can view the page")
+    style: exports_external.enum(keys(PAGE_STYLES)).optional().describe(`New style \u2014 ${describeChoices(PAGE_STYLES)}`),
+    visibility: exports_external.enum(PAGE_VISIBILITIES).optional().describe("Who can view the page"),
+    issue: exports_external.string().nullable().optional().describe("Link the page to an issue (KAI-N, number, or URL), or --no-issue to unlink it").meta({ negatable: true })
   },
-  run: async ({ positionals: { id, file: file2 }, options: { title, group: group2, mode, visibility } }) => {
-    if (!file2 && title === undefined && group2 === undefined && mode === undefined && visibility === undefined)
-      throw new Error("Nothing to update. Pass a file, --title, --group, --no-group, --mode, or --visibility.");
+  run: async ({ positionals: { id, file: file2 }, options: { title, group: group2, style, visibility, issue: issue3 } }) => {
+    if (!file2 && title === undefined && group2 === undefined && style === undefined && visibility === undefined && issue3 === undefined)
+      throw new Error("Nothing to update. Pass a file, --title, --group, --no-group, --style, --visibility, --issue, or --no-issue.");
     const html = file2 ? await readBody(file2) : undefined;
-    const { url: url2 } = await (await backendClient()).action(api2.pages.update, {
+    const { url: url2, pruned } = await (await backendClient()).action(api2.pages.update, {
       id: readPageId(id),
       html,
       title,
       group: group2,
-      mode,
-      visibility
+      style,
+      visibility,
+      issue: typeof issue3 === "string" ? readIssueRef(issue3) : issue3
     });
+    warnPruned(pruned);
     console.log(url2);
   }
 });
@@ -26687,10 +26632,10 @@ var versions2 = command({
     if (archived.length === 0)
       return console.log("No previous versions.");
     printTable([
-      ["VERSION", "MODE", "SIZE", "ARCHIVED"],
+      ["VERSION", "STYLE", "SIZE", "ARCHIVED"],
       ...archived.map((version4) => [
         String(version4.version),
-        version4.mode,
+        version4.style,
         formatBytes(version4.size),
         new Date(version4.archivedAt).toISOString().slice(0, 10)
       ])
@@ -26702,10 +26647,10 @@ var versions2 = command({
 var pages = group({
   name: "pages",
   description: "Publish HTML documents to the web",
-  longDescription: `Themed pages (the default) render inside the site chrome under a strict CSP: only
-the site theme's styles apply \u2014 inline style attributes and author scripts are
-dropped. A self-contained document with its own CSS or JS needs raw mode, which
-serves it verbatim. A page keeps its URL across updates and reverts.`,
+  longDescription: `A page is an HTML fragment rendered in one of the site's styles:
+  ${describeChoices(PAGE_STYLES, `
+  `)}
+Basic is the default. A page keeps its URL across updates and reverts.`,
   commands: [create6, list8, get5, update7, versions2, revert, remove6]
 });
 
@@ -26764,7 +26709,7 @@ var create7 = command({
       health: options.health,
       targetDate: options.target,
       repo: options.repo,
-      clientId: options.client === undefined ? undefined : (await resolveClient(backend, options.client))._id
+      clientId: options.client === undefined ? undefined : readClientRef(options.client)
     });
     console.log(projectId);
   }
@@ -26866,9 +26811,8 @@ var remove7 = command({
   },
   run: async ({ positionals: { id } }) => {
     const client3 = await backendClient();
-    const project2 = await resolveProject(client3, id);
-    await client3.mutation(api2.projects.remove, { id: project2._id });
-    console.log(`Deleted ${project2.name}.`);
+    const removed = await client3.mutation(api2.projects.remove, { id: readProjectRef(id) });
+    console.log(`Deleted ${removed.name}.`);
   }
 });
 
@@ -26891,21 +26835,15 @@ var set3 = command({
     if (Object.values(options).every((value) => value === undefined))
       throw new Error("Nothing to set. Pass --status, --health, --target, --repo, or --client.");
     const backend = await backendClient();
-    const project2 = await resolveProject(backend, id);
-    const linkedClient = typeof client3 === "string" ? await resolveClient(backend, client3) : undefined;
-    if (linkedClient?.archivedAt !== undefined)
-      throw new Error(`${linkedClient.name} is archived and takes no new work.`);
-    if (repo !== undefined)
-      await backend.mutation(api2.projects.setRepo, { id: project2._id, repo: repo ?? undefined });
-    if (client3 !== undefined)
-      await backend.mutation(api2.projects.setClient, { id: project2._id, clientId: linkedClient?._id });
-    if (status3 !== undefined)
-      await backend.mutation(api2.projects.setStatus, { id: project2._id, status: status3 });
-    if (health !== undefined)
-      await backend.mutation(api2.projects.setHealth, { id: project2._id, health: health ?? undefined });
-    if (target !== undefined)
-      await backend.mutation(api2.projects.setTargetDate, { id: project2._id, targetDate: target ?? undefined });
-    console.log(`Updated ${project2.name}.`);
+    const { name } = await backend.mutation(api2.projects.edit, {
+      id: readProjectRef(id),
+      ...repo !== undefined ? { repo } : {},
+      ...client3 !== undefined ? { client: client3 === null ? null : readClientRef(client3) } : {},
+      ...status3 !== undefined ? { status: status3 } : {},
+      ...health !== undefined ? { health } : {},
+      ...target !== undefined ? { targetDate: target } : {}
+    });
+    console.log(`Updated ${name}.`);
   }
 });
 
@@ -26925,14 +26863,13 @@ var update8 = command({
     if (name === undefined && summary === undefined && description === undefined)
       throw new Error("Nothing to update. Pass --name, --summary, or --description.");
     const client3 = await backendClient();
-    const project2 = await resolveProject(client3, id);
-    await client3.mutation(api2.projects.update, {
-      id: project2._id,
+    const updated = await client3.mutation(api2.projects.update, {
+      id: readProjectRef(id),
       name,
       summary,
       descriptionMarkdown: description === undefined ? undefined : await readTextOption(description)
     });
-    console.log(`Updated ${name ?? project2.name}.`);
+    console.log(`Updated ${updated.name}.`);
   }
 });
 
@@ -26958,13 +26895,12 @@ var accept = command({
   },
   run: async ({ positionals: { id }, options }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    await backend.mutation(api2.quotations.accept, {
-      id: quotation._id,
+    const accepted = await backend.mutation(api2.quotations.accept, {
+      id: readQuotationRef(id),
       on: options.date ?? localToday(),
       note: options.note
     });
-    console.log(`Accepted ${quotation.number}. Draw invoices from it with: kds quotations convert ${quotation._id}`);
+    console.log(`Accepted ${accepted.number}. Draw invoices from it with: kds quotations convert ${accepted.id}`);
   }
 });
 
@@ -26985,7 +26921,6 @@ Nothing blocks over- or under-invoicing; left to bill is advisory.`,
   },
   run: async ({ positionals: { id }, options }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
     const lineIndexes = options.lines?.split(",").map((part) => {
       const lineNumber = Number(part.trim());
       if (!Number.isInteger(lineNumber) || lineNumber < 1) {
@@ -26994,7 +26929,7 @@ Nothing blocks over- or under-invoicing; left to bill is advisory.`,
       return lineNumber - 1;
     });
     const invoiceId = await backend.mutation(api2.quotations.convert, {
-      id: quotation._id,
+      id: readQuotationRef(id),
       lineIndexes,
       percentage: options.percentage
     });
@@ -27017,11 +26952,9 @@ var create8 = command({
   },
   run: async ({ positionals: { client: ref }, options }) => {
     const backend = await backendClient();
-    const client3 = await resolveClient(backend, ref);
-    const project2 = options.project === undefined ? undefined : await resolveProject(backend, options.project);
     const quotationId = await backend.mutation(api2.quotations.create, {
-      clientId: client3._id,
-      projectId: project2?._id,
+      clientId: readClientRef(ref),
+      projectId: options.project === undefined ? undefined : readProjectRef(options.project),
       lineItems: options.line?.map(parseQuotationLineItem),
       notes: options.notes,
       validUntil: options.validUntil === null ? "" : options.validUntil,
@@ -27040,8 +26973,21 @@ var duplicate2 = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    console.log(await backend.mutation(api2.quotations.duplicate, { id: quotation._id, today: localToday() }));
+    console.log(await backend.mutation(api2.quotations.duplicate, { id: readQuotationRef(id), today: localToday() }));
+  }
+});
+
+// src/commands/quotations/email.ts
+var email4 = command({
+  name: "email",
+  description: "Email the quotation's link to the client's billing address; repeatable, and never required",
+  positionals: {
+    id: exports_external.string().describe("Quotation id or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const backend = await backendClient();
+    const { to, number: number4 } = await backend.mutation(api2.quotations.email, { id: readQuotationRef(id) });
+    console.log(`Emailed ${number4} to ${to}.`);
   }
 });
 
@@ -27070,6 +27016,9 @@ var get7 = command({
       console.log(`Valid until: ${quotation.validUntil}`);
     if (quotation.publicUrl)
       console.log(`Link: ${quotation.publicUrl}`);
+    if (quotation.status !== "draft") {
+      console.log(`Emailed: ${quotation.lastEmailedAt === undefined ? "never" : localDateString(quotation.lastEmailedAt)}`);
+    }
     if (quotation.outcome) {
       console.log(`${quotation.status === "accepted" ? "Accepted" : "Rejected"}: ${quotation.outcome.on}${quotation.outcome.note ? ` \u2014 ${quotation.outcome.note}` : ""}`);
     }
@@ -27126,9 +27075,7 @@ var issue3 = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    await backend.mutation(api2.quotations.issue, { id: quotation._id, today: localToday() });
-    const issued = await resolveQuotation(backend, quotation._id);
+    const issued = await backend.mutation(api2.quotations.issue, { id: readQuotationRef(id), today: localToday() });
     console.log(`Issued ${issued.number}, ${issued.validUntil ? `valid until ${issued.validUntil}` : "with no expiry"}.`);
   }
 });
@@ -27143,10 +27090,11 @@ var link2 = command({
   },
   run: async ({ positionals: { id, project: projectRef } }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    const project2 = projectRef === undefined ? undefined : await resolveProject(backend, projectRef);
-    await backend.mutation(api2.quotations.setProject, { id: quotation._id, projectId: project2?._id });
-    console.log(project2 ? `Linked to ${project2.name}.` : "Cleared the project link.");
+    const { projectName } = await backend.mutation(api2.quotations.setProject, {
+      id: readQuotationRef(id),
+      projectId: projectRef === undefined ? undefined : readProjectRef(projectRef)
+    });
+    console.log(projectName === undefined ? "Cleared the project link." : `Linked to ${projectName}.`);
   }
 });
 
@@ -27174,7 +27122,7 @@ var list10 = command({
     if (result.page.length === 0)
       return console.log("No quotations yet.");
     printTable([
-      ["NUMBER", "CLIENT", "PROJECT", "STATUS", "TOTAL", "VALID UNTIL", "ID"],
+      ["NUMBER", "CLIENT", "PROJECT", "STATUS", "TOTAL", "VALID UNTIL", "EMAILED", "ID"],
       ...result.page.map((quotation) => [
         quotation.number ?? "draft",
         quotation.clientName,
@@ -27182,6 +27130,7 @@ var list10 = command({
         quotation.derivedStatus,
         formatPerCurrency(quotation.totals.map(({ currency, total }) => ({ currency, amount: total }))),
         quotation.validUntil ?? "-",
+        quotation.lastEmailedAt === undefined ? "-" : localDateString(quotation.lastEmailedAt),
         quotation._id
       ])
     ]);
@@ -27204,13 +27153,12 @@ var reject2 = command({
   },
   run: async ({ positionals: { id }, options }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    await backend.mutation(api2.quotations.reject, {
-      id: quotation._id,
+    const { number: number4 } = await backend.mutation(api2.quotations.reject, {
+      id: readQuotationRef(id),
       on: options.date ?? localToday(),
       note: options.note
     });
-    console.log(`Rejected ${quotation.number}.`);
+    console.log(`Rejected ${number4}.`);
   }
 });
 
@@ -27223,9 +27171,8 @@ var rotateLink2 = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    const url2 = await backend.mutation(api2.quotations.rotateLink, { id: quotation._id });
-    console.log(`${quotation.number} now reads at ${url2}. Send it again \u2014 the previous link is dead.`);
+    const { url: url2, number: number4 } = await backend.mutation(api2.quotations.rotateLink, { id: readQuotationRef(id) });
+    console.log(`${number4} now reads at ${url2}. Send it again \u2014 the previous link is dead.`);
   }
 });
 
@@ -27247,14 +27194,13 @@ var update9 = command({
       throw new Error("Nothing to update. Pass --line, --notes, or --valid-until (or a --no form to clear).");
     }
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    await backend.mutation(api2.quotations.update, {
-      id: quotation._id,
+    const { number: number4 } = await backend.mutation(api2.quotations.update, {
+      id: readQuotationRef(id),
       lineItems: options.line?.map(parseQuotationLineItem),
       notes: options.notes === null ? "" : options.notes,
       validUntil: options.validUntil === null ? "" : options.validUntil
     });
-    console.log(`Updated ${quotation.number ?? "draft"}.`);
+    console.log(`Updated ${number4 ?? "draft"}.`);
   }
 });
 
@@ -27267,9 +27213,8 @@ var voidQuotation = command({
   },
   run: async ({ positionals: { id } }) => {
     const backend = await backendClient();
-    const quotation = await resolveQuotation(backend, id);
-    await backend.mutation(api2.quotations.voidQuotation, { id: quotation._id });
-    console.log(`Voided ${quotation.number}.`);
+    const { number: number4 } = await backend.mutation(api2.quotations.voidQuotation, { id: readQuotationRef(id) });
+    console.log(`Voided ${number4}.`);
   }
 });
 
@@ -27281,7 +27226,21 @@ var quotations = group({
 document awaiting the client's answer. Accept and reject are manual records;
 expiry is derived from valid-until and never blocks accepting. An accepted
 quotation converts into any number of draft invoices, each tracing back to it.`,
-  commands: [create8, list10, get7, update9, issue3, accept, reject2, voidQuotation, duplicate2, convert, link2, rotateLink2]
+  commands: [
+    create8,
+    list10,
+    get7,
+    update9,
+    issue3,
+    email4,
+    accept,
+    reject2,
+    voidQuotation,
+    duplicate2,
+    convert,
+    link2,
+    rotateLink2
+  ]
 });
 
 // src/commands/upgrade.ts
@@ -27312,6 +27271,7 @@ var rootCommand = group({
 
 // src/lib/errors.ts
 var errorMessage = (error51) => error51 instanceof ConvexError && typeof error51.data === "string" ? error51.data : error51.message;
+var isRedactedServerError = (error51) => error51 instanceof Error && !(error51 instanceof ConvexError) && /^\[Request ID: \w+\] Server Error$/.test(error51.message);
 
 // src/lib/update-check.ts
 var latestVersion = async () => {
@@ -27342,6 +27302,12 @@ var maybeNotifyUpdate = async () => {
   if (latest && Bun.semver.order(latest, CLI_VERSION) === 1)
     console.error(`kds v${latest} available (you have v${CLI_VERSION}) \u2014 run 'kds upgrade'`);
 };
+var staleCliHint = async (current = CLI_VERSION) => {
+  const latest = env.KDS_NO_UPDATE_CHECK ? undefined : await latestVersion().catch(() => {
+    return;
+  });
+  return latest && Bun.semver.order(latest, current) === 1 ? `kds v${current} is behind v${latest}, so the server likely refused a request this version still sends \u2014 run 'kds upgrade' and retry.` : "The server gave no details. If kds was installed a while ago, try 'kds upgrade'; otherwise report the request id.";
+};
 
 // src/index.ts
 var args = Bun.argv.slice(2);
@@ -27351,6 +27317,8 @@ try {
     await maybeNotifyUpdate();
 } catch (error51) {
   console.error(errorMessage(error51));
+  if (isRedactedServerError(error51))
+    console.error(await staleCliHint());
   process.exitCode = 1;
 } finally {
   closePrompts();