@islamihab/kds 0.10.0 → 0.11.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.11.0",
   private: true,
   type: "module",
   bin: {
@@ -15306,6 +15318,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 +15365,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;
@@ -24257,6 +24265,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 +24404,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,23 +24413,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) {
@@ -24383,62 +24423,6 @@ var resolveMilestone = async (client3, projectId, name) => {
   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" });
 var list = command({
@@ -24480,9 +24464,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 +24478,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 +24492,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 +24507,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 +24516,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 +24638,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 +24661,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}.`);
   }
 });
 
@@ -24801,7 +24699,7 @@ the same client.`,
   },
   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 +24709,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 +24717,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 +24737,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}.`);
   }
 });
 
@@ -24954,9 +24850,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 +24870,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 +24886,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 +24895,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}.`);
   }
 });
 
@@ -25309,9 +25202,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 +25219,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 +25235,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 +25269,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 +25289,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 +25332,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 +25374,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 +25389,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 +25421,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 +25429,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 +25454,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 +25504,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 +25528,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 +25551,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 +25570,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 +25582,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 +25651,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 +25679,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 +25693,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 +25716,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 +25739,100 @@ var printTasks = (tasks) => {
 };
 
 // src/commands/issues/get.ts
+var printIssue = ({ relations, attachments, 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"}`);
+    }
+  }
+  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, tasks, feed, milestone: _, ...issue3 }) => ({
+        ...issue3,
+        relations,
+        attachments,
+        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 +25879,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 +25899,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}.`);
   }
 });
 
@@ -26069,9 +25999,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 +26021,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 +26039,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 +26048,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 +26058,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 +26072,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 +26104,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 +26135,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 +26162,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 +26177,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 +26242,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 +26269,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 +26311,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 +26336,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}.`);
   }
 });
 
@@ -26764,7 +26636,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 +26738,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 +26762,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 +26790,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 +26822,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 +26848,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 +26856,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 +26879,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 +26900,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 +26943,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 +27002,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 +27017,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 +27049,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 +27057,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 +27080,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 +27098,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 +27121,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 +27140,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 +27153,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