@islamihab/kds 0.11.0 → 0.13.0

package/index.js

@@ -14623,7 +14623,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "cli",
-  version: "0.11.0",
+  version: "0.13.0",
   private: true,
   type: "module",
   bin: {
@@ -15196,9 +15196,22 @@ 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 FILE_VISIBILITIES = ["public", "private"];
+var MAX_FILE_BYTES = 20000000;
 var ISSUE_STATUSES = [
   "backlog",
   "todo",
@@ -15368,7 +15381,16 @@ var issueIsOpen = (status) => !ISSUE_TERMINAL_STATUSES.some((terminal) => termin
 var CURRENCIES = ["EGP", "USD", "EUR", "GBP", "AED", "SAR"];
 var DEFAULT_CURRENCY = "EGP";
 var RECURRING_CHARGE_CADENCES = ["monthly", "yearly"];
+var RECURRING_CHARGE_CADENCE_LABELS = {
+  monthly: "Monthly",
+  yearly: "Yearly"
+};
 var COST_KINDS = ["one_off", "monthly", "yearly"];
+var COST_KIND_LABELS = {
+  one_off: "One-off",
+  monthly: "Monthly",
+  yearly: "Yearly"
+};
 var MAX_PROJECT_REPO_LENGTH = 200;
 var INVOICE_STATUSES = ["draft", "sent", "paid", "void"];
 var invoiceLineTotal = ({ quantity, unitPrice }) => {
@@ -17346,6 +17368,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() });
@@ -24120,6 +24143,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}`;
@@ -24264,6 +24291,15 @@ var readPageId = (value) => {
     return trimmed;
   }
 };
+var readFileRef = (value) => {
+  const trimmed = value.trim();
+  try {
+    const url2 = new URL(trimmed);
+    return url2.pathname.match(/\/f\/([^/]+)\/?$/)?.[1] ?? trimmed;
+  } catch {
+    return trimmed;
+  }
+};
 
 // src/commands/clients/archive.ts
 var archive = command({
@@ -24413,15 +24449,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 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/charges/list.ts
 var monthName = (month) => new Date(Date.UTC(2000, month - 1)).toLocaleString("en-US", { month: "short", timeZone: "UTC" });
@@ -24691,9 +24718,10 @@ 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"')
   },
@@ -24750,9 +24778,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
@@ -24800,7 +24829,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")
@@ -24908,7 +24937,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]
 });
@@ -25153,6 +25182,186 @@ var daemon = group({
   commands: [start, stop, status2, logs]
 });
 
+// src/commands/files/create.ts
+import { basename } from "path";
+
+// src/lib/upload.ts
+var localFile = async (path, maxBytes) => {
+  const file2 = Bun.file(path);
+  if (!await file2.exists())
+    throw new Error(`No file at ${path}.`);
+  if (file2.size <= 0)
+    throw new Error(`${path} is empty.`);
+  if (file2.size > maxBytes)
+    throw new Error(`${path} is too large (${file2.size} bytes; max ${maxBytes}).`);
+  return file2;
+};
+var uploadFile = async (path, file2, uploadUrl) => {
+  const response = await fetch(uploadUrl, { method: "POST", headers: { "Content-Type": file2.type }, body: file2 });
+  if (!response.ok)
+    throw new Error(`Uploading ${path} failed (${response.status}).`);
+  const storageId = exports_external.custom((value) => typeof value === "string");
+  const body = exports_external.object({ storageId }).safeParse(await response.json());
+  if (!body.success)
+    throw new Error("The upload returned no file reference.");
+  return body.data.storageId;
+};
+
+// src/commands/files/create.ts
+var create3 = command({
+  name: "create",
+  description: "Upload one or more files and print their URLs",
+  positionals: {
+    files: exports_external.array(exports_external.string()).min(1).describe("Files to upload")
+  },
+  options: {
+    folder: exports_external.string().optional().describe("Folder to file them under, such as screenshots/2026-09").meta({ short: "f" }),
+    private: exports_external.boolean().default(false).describe("Keep the file to this account: no share URL is issued")
+  },
+  run: async ({ positionals: { files: paths }, options: { folder, private: isPrivate } }) => {
+    const files = await Promise.all(paths.map(async (path) => ({ path, file: await localFile(path, MAX_FILE_BYTES) })));
+    const client3 = await backendClient();
+    const results = await Promise.allSettled(files.map(async ({ path, file: file2 }) => {
+      const uploadUrl = await client3.mutation(api2.files.generateUploadUrl, {});
+      const storageId = await uploadFile(path, file2, uploadUrl);
+      return await client3.action(api2.files.create, {
+        storageId,
+        name: basename(path),
+        folder,
+        visibility: isPrivate ? "private" : "public"
+      });
+    }));
+    for (const result of results) {
+      if (result.status === "fulfilled")
+        console.log(result.value.url ?? result.value.downloadUrl ?? result.value.id);
+    }
+    const failed = results.find((result) => result.status === "rejected");
+    if (failed)
+      throw failed.reason;
+  }
+});
+
+// ../../packages/backend/convex/lib/format.ts
+var formatBytes = (bytes) => bytes < 1024 ? `${bytes} B` : `${Math.round(bytes / 1024)} KB`;
+
+// src/commands/files/get.ts
+var get3 = command({
+  name: "get",
+  description: "Show a file's details and links",
+  positionals: {
+    id: exports_external.string().describe("File id or URL")
+  },
+  options: {
+    json: exports_external.boolean().default(false).describe("Print as JSON")
+  },
+  run: async ({ positionals: { id }, options: { json: json2 } }) => {
+    const file2 = await (await backendClient()).query(api2.files.get, { ref: readFileRef(id) });
+    if (json2)
+      return console.log(JSON.stringify(file2, null, 2));
+    console.log(`Name:      ${file2.name}`);
+    console.log(`Folder:    ${file2.folder ?? "-"}`);
+    console.log(`Access:    ${file2.visibility}`);
+    console.log(`Type:      ${file2.mimeType}`);
+    console.log(`Size:      ${formatBytes(file2.size)}`);
+    console.log(`Created:   ${new Date(file2.createdAt).toISOString()}`);
+    console.log(`Id:        ${file2.id}`);
+    console.log(`URL:       ${file2.url ?? "- (private)"}`);
+    console.log(`Download:  ${file2.downloadUrl ?? "-"}`);
+  }
+});
+
+// src/commands/files/list.ts
+var list4 = command({
+  name: "list",
+  description: "List your files, or one folder and everything beneath it",
+  positionals: {
+    folder: exports_external.string().optional().describe("Folder path to list")
+  },
+  options: {
+    json: exports_external.boolean().default(false).describe("Print as JSON")
+  },
+  run: async ({ positionals: { folder }, options: { json: json2 } }) => {
+    const files = await (await backendClient()).query(api2.files.list, { folder });
+    if (json2)
+      return console.log(JSON.stringify(files, null, 2));
+    if (files.length === 0)
+      return console.log(folder === undefined ? "No files yet." : "No files in that folder.");
+    printTable([
+      ["NAME", "FOLDER", "ACCESS", "TYPE", "SIZE", "CREATED", "URL"],
+      ...files.map((file2) => [
+        file2.name,
+        file2.folder ?? "-",
+        file2.visibility,
+        file2.mimeType,
+        formatBytes(file2.size),
+        new Date(file2.createdAt).toISOString().slice(0, 10),
+        file2.url ?? file2.id
+      ])
+    ]);
+  }
+});
+
+// src/commands/files/remove.ts
+var remove3 = command({
+  name: "delete",
+  description: "Delete a file",
+  positionals: {
+    id: exports_external.string().describe("File id or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    await (await backendClient()).mutation(api2.files.remove, { ref: readFileRef(id) });
+    console.log("Deleted.");
+  }
+});
+
+// src/commands/files/rotate-link.ts
+var rotateLink = command({
+  name: "rotate-link",
+  description: "Reissue a file's share URL; every link handed out so far stops working",
+  positionals: {
+    id: exports_external.string().describe("File id or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const file2 = await (await backendClient()).mutation(api2.files.rotateLink, { ref: readFileRef(id) });
+    console.log(file2.url ?? "Rotated; the file is private, so no share URL is issued.");
+  }
+});
+
+// src/commands/files/update.ts
+var update4 = command({
+  name: "update",
+  description: "Rename a file, move it to a folder, or change who can reach it",
+  positionals: {
+    id: exports_external.string().describe("File id or URL")
+  },
+  options: {
+    name: exports_external.string().optional().describe("New file name").meta({ short: "n" }),
+    folder: exports_external.string().nullable().optional().describe("Move the file to this folder, or --no-folder to move it to the root").meta({ short: "f", negatable: true }),
+    visibility: exports_external.enum(FILE_VISIBILITIES).optional().describe("Who can reach the file")
+  },
+  run: async ({ positionals: { id }, options: { name, folder, visibility } }) => {
+    if (name === undefined && folder === undefined && visibility === undefined)
+      throw new Error("Nothing to update. Pass --name, --folder, --no-folder, or --visibility.");
+    const file2 = await (await backendClient()).mutation(api2.files.update, {
+      ref: readFileRef(id),
+      name,
+      folder,
+      visibility
+    });
+    console.log(file2.url ?? "Updated.");
+  }
+});
+
+// src/commands/files/index.ts
+var files = group({
+  name: "files",
+  description: "Share files at a URL",
+  longDescription: `A file is uploaded as it is and reached at a share URL that renders images, video, audio,
+PDF and plain text in the browser and downloads everything else. Folders are paths such as
+screenshots/2026-09; a private file has no share URL and is reached from this account only.`,
+  commands: [create3, list4, get3, update4, rotateLink, remove3]
+});
+
 // src/commands/inbox/list.ts
 var inboxOptions = {
   all: exports_external.boolean().default(false).describe("Include events already marked seen"),
@@ -25252,10 +25461,34 @@ var parseQuotationLineItem = (value) => {
   const section = parts.length === 5 ? parts.pop()?.trim() : undefined;
   return { ...parseLineItem(parts.join("|")), section: section || undefined };
 };
+var EXPECTED_COST_SYNTAX = 'name|amount|kind[|currency], kind one of one_off, monthly, yearly, e.g. "Hosting|2500|monthly|USD"; currency defaults to EGP';
+var RECURRING_FEE_SYNTAX = 'description|amount|cadence[|currency], cadence monthly or yearly, e.g. "Maintenance|50000|monthly|USD"; currency defaults to EGP';
+var parseCommitment = (value, syntax, kinds) => {
+  const parts = value.split("|");
+  if (parts.length !== 3 && parts.length !== 4)
+    throw new Error(`Entries read as ${syntax}; got "${value}".`);
+  const [label = "", amountPart = "", kindPart = "", currency = ""] = parts;
+  const amount = Number(amountPart.trim());
+  if (!amountPart.trim() || !Number.isSafeInteger(amount)) {
+    throw new Error(`Amounts must be integer minor units (10000 = 100.00), got "${amountPart.trim()}".`);
+  }
+  const kind = kinds.find((candidate) => candidate === kindPart.trim());
+  if (kind === undefined)
+    throw new Error(`Expected one of ${kinds.join(", ")}, got "${kindPart.trim()}".`);
+  return { label: label.trim(), amount, kind, currency: parseLineCurrency(currency) };
+};
+var parseExpectedCost = (value) => {
+  const { label, kind, ...rest } = parseCommitment(value, EXPECTED_COST_SYNTAX, COST_KINDS);
+  return { name: label, kind, ...rest };
+};
+var parseRecurringFee = (value) => {
+  const { label, kind, ...rest } = parseCommitment(value, RECURRING_FEE_SYNTAX, RECURRING_CHARGE_CADENCES);
+  return { description: label, cadence: kind, ...rest };
+};
 var formatPerCurrency = (entries) => entries.length === 0 ? "-" : entries.map(({ amount, currency }) => formatMinorAmount(amount, currency)).join(" + ");
 
 // src/commands/invoices/create.ts
-var create3 = command({
+var create4 = command({
   name: "create",
   description: "Create a draft invoice for a client and print its id",
   positionals: {
@@ -25308,7 +25541,7 @@ var email3 = command({
 });
 
 // src/commands/invoices/get.ts
-var get3 = command({
+var get4 = command({
   name: "get",
   description: "Show an invoice: document, totals, and payments",
   positionals: {
@@ -25398,7 +25631,7 @@ var link = command({
 });
 
 // src/commands/invoices/list.ts
-var list4 = command({
+var list5 = command({
   name: "list",
   description: "List your invoices, newest first",
   options: {
@@ -25468,7 +25701,7 @@ var add2 = command({
 });
 
 // src/commands/invoices/payments/list.ts
-var list5 = command({
+var list6 = command({
   name: "list",
   description: "List the payments recorded on an invoice, oldest first",
   positionals: {
@@ -25496,7 +25729,7 @@ var list5 = command({
 });
 
 // src/commands/invoices/payments/remove.ts
-var remove3 = command({
+var remove4 = command({
   name: "remove",
   description: "Remove a recorded payment (unflips paid when the invoice is no longer covered)",
   positionals: {
@@ -25516,11 +25749,11 @@ var payments = group({
   longDescription: `A payment is money received against a sent invoice, in one currency. Paid flips
 automatically once every currency's total is covered; overpayment is rejected,
 and forgiving a shortfall is a payment with a note.`,
-  commands: [add2, list5, remove3]
+  commands: [add2, list6, remove4]
 });
 
 // src/commands/invoices/rotate-link.ts
-var rotateLink = command({
+var rotateLink2 = command({
   name: "rotate-link",
   description: "Reissue the invoice's public link, which stops every link already shared or emailed working",
   positionals: {
@@ -25534,7 +25767,7 @@ var rotateLink = command({
 });
 
 // src/commands/invoices/update.ts
-var update4 = command({
+var update5 = command({
   name: "update",
   description: "Update a draft invoice (sent invoices are frozen)",
   longDescription: "An omitted flag leaves its field unchanged. Passed --line flags replace the whole line list; --no-notes and --no-due clear their fields.",
@@ -25582,52 +25815,29 @@ 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, email3, voidInvoice, duplicate, link, rotateLink, payments]
+  commands: [create4, list5, get4, update5, issue2, email3, voidInvoice, duplicate, link, rotateLink2, payments]
 });
 
 // src/lib/attachments.ts
-import { basename } from "path";
+import { basename as basename2 } from "path";
 var attachFiles = async (client3, issueId, paths) => {
   if (paths.length === 0)
     return [];
-  const files = paths.map((path) => ({ path, file: Bun.file(path) }));
-  for (const { path, file: file2 } of files) {
-    if (!await file2.exists())
-      throw new Error(`No file at ${path}.`);
-    if (file2.size <= 0)
-      throw new Error(`${path} is empty; an attachment cannot be.`);
-    if (file2.size > MAX_ISSUE_ATTACHMENT_BYTES) {
-      throw new Error(`${path} is too large (${file2.size} bytes; max ${MAX_ISSUE_ATTACHMENT_BYTES}).`);
-    }
-  }
-  const created = new Set;
-  try {
-    for (const { path, file: file2 } of files) {
-      const uploadUrl = await client3.mutation(api2.issueAttachments.generateUploadUrl, { issueId });
-      const response = await fetch(uploadUrl, {
-        method: "POST",
-        headers: { "Content-Type": file2.type },
-        body: file2
-      });
-      if (!response.ok)
-        throw new Error(`Uploading ${path} failed (${response.status}).`);
-      const storageId = exports_external.custom((value) => typeof value === "string");
-      const body = exports_external.object({ storageId }).safeParse(await response.json());
-      if (!body.success)
-        throw new Error("The upload returned no file reference.");
-      created.add(await client3.action(api2.issueAttachments.create, {
-        issueId,
-        storageId: body.data.storageId,
-        name: basename(path)
-      }));
-    }
-  } catch (error51) {
+  const files2 = await Promise.all(paths.map(async (path) => ({ path, file: await localFile(path, MAX_ISSUE_ATTACHMENT_BYTES) })));
+  const results = await Promise.allSettled(files2.map(async ({ path, file: file2 }) => {
+    const uploadUrl = await client3.mutation(api2.issueAttachments.generateUploadUrl, { issueId });
+    const storageId = await uploadFile(path, file2, uploadUrl);
+    return await client3.action(api2.issueAttachments.create, { issueId, storageId, name: basename2(path) });
+  }));
+  const created = new Set(results.flatMap((result) => result.status === "fulfilled" ? [result.value] : []));
+  const failed = results.find((result) => result.status === "rejected");
+  if (failed) {
     for (const id of created) {
       await client3.mutation(api2.issueAttachments.remove, { id }).catch(() => {
         console.error("An attachment from this failed batch could not be removed; check the dashboard.");
       });
     }
-    throw error51;
+    throw failed.reason;
   }
   const attachments = await client3.query(api2.issueAttachments.list, { issueId });
   return attachments.filter((attachment) => created.has(attachment._id));
@@ -25676,7 +25886,7 @@ var agentConfigurationLine = (id) => {
 };
 
 // src/commands/issues/create.ts
-var create4 = command({
+var create5 = command({
   name: "create",
   description: "Create an issue and print its identifier",
   positionals: {
@@ -25739,7 +25949,7 @@ var printTasks = (tasks) => {
 };
 
 // src/commands/issues/get.ts
-var printIssue = ({ relations, attachments, tasks, feed, milestone, ...issue3 }) => {
+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}`);
@@ -25778,6 +25988,12 @@ var printIssue = ({ relations, attachments, tasks, feed, milestone, ...issue3 })
       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(`
@@ -25800,7 +26016,7 @@ Feed:`);
     }
   }
 };
-var get4 = command({
+var get5 = command({
   name: "get",
   description: "Show one or more issues: properties, description, and feed",
   positionals: {
@@ -25819,10 +26035,11 @@ var get4 = command({
       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 }) => ({
+      const objects = details.map(({ relations, attachments, pages, tasks, feed, milestone: _, ...issue3 }) => ({
         ...issue3,
         relations,
         attachments,
+        pages,
         tasks,
         feed
       }));
@@ -25837,7 +26054,7 @@ var get4 = command({
 });
 
 // src/commands/issues/labels/create.ts
-var create5 = command({
+var create6 = command({
   name: "create",
   description: "Create an issue label and print its id",
   positionals: {
@@ -25854,7 +26071,7 @@ var create5 = command({
 });
 
 // src/commands/issues/labels/list.ts
-var list6 = command({
+var list7 = command({
   name: "list",
   description: "List issue labels alphabetically",
   options: {
@@ -25871,7 +26088,7 @@ var list6 = command({
 });
 
 // src/commands/issues/labels/remove.ts
-var remove4 = command({
+var remove5 = command({
   name: "delete",
   description: "Delete an issue label and remove it from every issue",
   positionals: {
@@ -25885,7 +26102,7 @@ var remove4 = command({
 });
 
 // src/commands/issues/labels/update.ts
-var update5 = command({
+var update6 = command({
   name: "update",
   description: "Rename or recolor an issue label",
   positionals: {
@@ -25908,11 +26125,54 @@ var update5 = command({
 var labels = group({
   name: "labels",
   description: "Manage issue labels",
-  commands: [create5, list6, update5, remove4]
+  commands: [create6, list7, update6, remove5]
+});
+
+// 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 list7 = command({
+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 list8 = command({
   name: "list",
   description: "List open issues, most recently updated first",
   options: {
@@ -25932,10 +26192,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",
@@ -25949,8 +26206,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
           }
         }
@@ -26031,7 +26288,7 @@ var relate = command({
 });
 
 // src/commands/issues/remove.ts
-var remove5 = command({
+var remove6 = command({
   name: "delete",
   description: "Delete an issue permanently (sub-issues survive as top-level issues)",
   positionals: {
@@ -26267,9 +26524,9 @@ address several rows even as removals renumber it.`,
     remove: position.optional().describe("Drop a task by its number (repeatable)"),
     json: exports_external.boolean().default(false).describe("Print as JSON")
   },
-  run: async ({ positionals: { id }, options: { add: add3, check: check2, uncheck, convert, remove: remove6, json: json2 } }) => {
+  run: async ({ positionals: { id }, options: { add: add3, check: check2, uncheck, convert, remove: remove7, json: json2 } }) => {
     const client3 = await backendClient();
-    const wrote = [add3, check2, uncheck, convert, remove6].some((values) => values !== undefined);
+    const wrote = [add3, check2, uncheck, convert, remove7].some((values) => values !== undefined);
     if (wrote) {
       const { identifier, converted, tasks: tasks3 } = await client3.mutation(api2.issueTasks.edit, {
         issue: readIssueRef(id),
@@ -26277,7 +26534,7 @@ address several rows even as removals renumber it.`,
         ...check2 !== undefined ? { check: check2 } : {},
         ...uncheck !== undefined ? { uncheck } : {},
         ...convert !== undefined ? { convert } : {},
-        ...remove6 !== undefined ? { remove: remove6 } : {}
+        ...remove7 !== undefined ? { remove: remove7 } : {}
       });
       if (!json2) {
         for (const created of converted) {
@@ -26321,7 +26578,7 @@ var unrelate = command({
 });
 
 // src/commands/issues/update.ts
-var update6 = command({
+var update7 = command({
   name: "update",
   description: "Rewrite an issue's title or description, or attach files",
   positionals: {
@@ -26360,16 +26617,16 @@ 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,
-    get4,
-    update6,
+    create5,
+    list8,
+    get5,
+    update7,
     set2,
     labels,
     route,
@@ -26378,16 +26635,20 @@ it as done.`,
     startReview,
     submitReview,
     markAddressed,
+    linkPr,
     tasks,
     relate,
     unrelate,
     comment,
-    remove5
+    remove6
   ]
 });
 
+// ../../packages/backend/convex/lib/object.ts
+var keys = (object2) => Object.keys(object2);
+
 // src/lib/group.ts
-import { basename as basename2 } from "path";
+import { basename as basename3 } from "path";
 var git = async (...args) => {
   const proc = Bun.spawn(["git", ...args], { stdout: "pipe", stderr: "ignore" });
   const [output, exitCode] = await Promise.all([new Response(proc.stdout).text(), proc.exited]);
@@ -26399,12 +26660,12 @@ var detectRepoGroup = async () => {
   if (remote)
     return repoNameFromRemote(remote);
   const root = await git("rev-parse", "--show-toplevel");
-  return root ? basename2(root) : undefined;
+  return root ? basename3(root) : undefined;
 };
 var groupForCreate = async (group2) => group2 === null ? undefined : group2 ?? await detectRepoGroup();
 
 // src/commands/pages/create.ts
-var create6 = command({
+var create7 = command({
   name: "create",
   description: "Publish a page and print its URL",
   positionals: {
@@ -26413,27 +26674,28 @@ 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);
   }
 });
 
 // src/commands/pages/get.ts
-var get5 = command({
+var get6 = command({
   name: "get",
   description: "Print a page's HTML",
   positionals: {
@@ -26452,11 +26714,8 @@ var get5 = command({
   }
 });
 
-// ../../packages/backend/convex/lib/format.ts
-var formatBytes = (bytes) => bytes < 1024 ? `${bytes} B` : `${Math.round(bytes / 1024)} KB`;
-
 // src/commands/pages/list.ts
-var list8 = command({
+var list9 = command({
   name: "list",
   description: "List your published pages",
   options: {
@@ -26470,12 +26729,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),
@@ -26486,7 +26745,7 @@ var list8 = command({
 });
 
 // src/commands/pages/remove.ts
-var remove6 = command({
+var remove7 = command({
   name: "delete",
   description: "Delete a page",
   positionals: {
@@ -26498,6 +26757,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",
@@ -26507,15 +26774,16 @@ 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);
   }
 });
 
 // src/commands/pages/update.ts
-var update7 = command({
+var update8 = 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")
@@ -26523,21 +26791,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);
   }
 });
@@ -26559,10 +26830,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)
       ])
@@ -26574,11 +26845,11 @@ 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.`,
-  commands: [create6, list8, get5, update7, versions2, revert, remove6]
+  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: [create7, list9, get6, update8, versions2, revert, remove7]
 });
 
 // src/commands/project.ts
@@ -26611,7 +26882,7 @@ var project = command({
 });
 
 // src/commands/projects/create.ts
-var create7 = command({
+var create8 = command({
   name: "create",
   description: "Create a project and print its id",
   positionals: {
@@ -26643,7 +26914,7 @@ var create7 = command({
 });
 
 // src/commands/projects/get.ts
-var get6 = command({
+var get7 = command({
   name: "get",
   description: "Show a project: properties, description, and milestones",
   positionals: {
@@ -26687,7 +26958,7 @@ Milestones:`);
 });
 
 // src/commands/projects/list.ts
-var list9 = command({
+var list10 = command({
   name: "list",
   description: "List your projects, most recently updated first",
   options: {
@@ -26730,7 +27001,7 @@ More projects exist; raise --limit past ${limit}.`);
 });
 
 // src/commands/projects/remove.ts
-var remove7 = command({
+var remove8 = command({
   name: "delete",
   description: "Delete a project and its milestones (its issues survive, projectless)",
   positionals: {
@@ -26775,7 +27046,7 @@ var set3 = command({
 });
 
 // src/commands/projects/update.ts
-var update8 = command({
+var update9 = command({
   name: "update",
   description: "Rewrite a project's name, summary, or description",
   positionals: {
@@ -26806,7 +27077,7 @@ var projects = group({
   description: "Manage projects",
   longDescription: `Connect a repository (set --repo) to make --here resolve in that checkout and to
 let issue branches and pull requests link automatically.`,
-  commands: [create7, list9, get6, update8, set3, remove7]
+  commands: [create8, list10, get7, update9, set3, remove8]
 });
 
 // src/commands/quotations/accept.ts
@@ -26865,7 +27136,7 @@ Nothing blocks over- or under-invoicing; left to bill is advisory.`,
 });
 
 // src/commands/quotations/create.ts
-var create8 = command({
+var create9 = command({
   name: "create",
   description: "Create a draft quotation for a client and print its id",
   positionals: {
@@ -26873,6 +27144,8 @@ var create8 = command({
   },
   options: {
     line: exports_external.array(exports_external.string()).optional().describe(`Line item as ${QUOTATION_LINE_ITEM_SYNTAX}; repeatable`).meta({ short: "l" }),
+    cost: exports_external.array(exports_external.string()).optional().describe(`Expected cost as ${EXPECTED_COST_SYNTAX}; repeatable`),
+    fee: exports_external.array(exports_external.string()).optional().describe(`Recurring fee as ${RECURRING_FEE_SYNTAX}; repeatable`),
     project: exports_external.string().optional().describe("Project id or URL to link (must belong to the same client)"),
     notes: exports_external.string().optional().describe("Free text rendered at the document foot"),
     validUntil: exports_external.string().nullable().optional().describe("Last valid day (YYYY-MM-DD); defaults from the profile's validity days, --no-valid-until never expires").meta({ negatable: true })
@@ -26883,6 +27156,8 @@ var create8 = command({
       clientId: readClientRef(ref),
       projectId: options.project === undefined ? undefined : readProjectRef(options.project),
       lineItems: options.line?.map(parseQuotationLineItem),
+      expectedCosts: options.cost?.map(parseExpectedCost),
+      recurringFees: options.fee?.map(parseRecurringFee),
       notes: options.notes,
       validUntil: options.validUntil === null ? "" : options.validUntil,
       today: localToday()
@@ -26919,7 +27194,7 @@ var email4 = command({
 });
 
 // src/commands/quotations/get.ts
-var get7 = command({
+var get8 = command({
   name: "get",
   description: "Show a quotation: document, totals, and \u2014 once accepted \u2014 its billing progress",
   positionals: {
@@ -26965,6 +27240,30 @@ var get7 = command({
     }
     console.log(`
 Total: ${formatPerCurrency(quotation.totals.map(({ currency, total }) => ({ currency, amount: total })))}`);
+    if (quotation.expectedCosts.length > 0) {
+      console.log(`
+Expected costs (estimates, billed at cost):`);
+      printTable([
+        ["NAME", "KIND", "AMOUNT"],
+        ...quotation.expectedCosts.map((cost) => [
+          cost.name,
+          COST_KIND_LABELS[cost.kind],
+          formatMinorAmount(cost.amount, cost.currency)
+        ])
+      ]);
+    }
+    if (quotation.recurringFees.length > 0) {
+      console.log(`
+Recurring fees:`);
+      printTable([
+        ["DESCRIPTION", "CADENCE", "AMOUNT"],
+        ...quotation.recurringFees.map((fee) => [
+          fee.description,
+          RECURRING_CHARGE_CADENCE_LABELS[fee.cadence],
+          formatMinorAmount(fee.amount, fee.currency)
+        ])
+      ]);
+    }
     if (quotation.billing) {
       console.log(`Invoiced: ${formatPerCurrency(quotation.billing.progress.map(({ currency, invoiced }) => ({ currency, amount: invoiced })))}`);
       const leftToBill = quotation.billing.progress.filter(({ remaining }) => remaining > 0);
@@ -27026,7 +27325,7 @@ var link2 = command({
 });
 
 // src/commands/quotations/list.ts
-var list10 = command({
+var list11 = command({
   name: "list",
   description: "List your quotations, newest first (expired is derived, never stored)",
   options: {
@@ -27090,7 +27389,7 @@ var reject2 = command({
 });
 
 // src/commands/quotations/rotate-link.ts
-var rotateLink2 = command({
+var rotateLink3 = command({
   name: "rotate-link",
   description: "Reissue the quotation's public link, which stops every link already shared or emailed working",
   positionals: {
@@ -27104,26 +27403,30 @@ var rotateLink2 = command({
 });
 
 // src/commands/quotations/update.ts
-var update9 = command({
+var update10 = command({
   name: "update",
   description: "Update a draft quotation (sent quotations are frozen)",
-  longDescription: "An omitted flag leaves its field unchanged. Passed --line flags replace the whole line list; --no-notes clears the notes and --no-valid-until makes the quotation never expire.",
+  longDescription: "An omitted flag leaves its field unchanged. Passed --line, --cost, or --fee flags replace that whole list (--no-cost or --no-fee empties it); --no-notes clears the notes and --no-valid-until makes the quotation never expire.",
   positionals: {
     id: exports_external.string().describe("Quotation id or URL")
   },
   options: {
     line: exports_external.array(exports_external.string()).optional().describe(`Line item as ${QUOTATION_LINE_ITEM_SYNTAX}; repeatable`).meta({ short: "l" }),
+    cost: exports_external.array(exports_external.string()).nullable().optional().describe(`Expected cost as ${EXPECTED_COST_SYNTAX}; repeatable, or --no-cost to clear`).meta({ negatable: true }),
+    fee: exports_external.array(exports_external.string()).nullable().optional().describe(`Recurring fee as ${RECURRING_FEE_SYNTAX}; repeatable, or --no-fee to clear`).meta({ negatable: true }),
     notes: exports_external.string().nullable().optional().describe("Document-foot notes, or --no-notes").meta({ negatable: true }),
     validUntil: exports_external.string().nullable().optional().describe("Last valid day (YYYY-MM-DD), or --no-valid-until to never expire").meta({ negatable: true })
   },
   run: async ({ positionals: { id }, options }) => {
-    if (options.line === undefined && options.notes === undefined && options.validUntil === undefined) {
-      throw new Error("Nothing to update. Pass --line, --notes, or --valid-until (or a --no form to clear).");
+    if (options.line === undefined && options.cost === undefined && options.fee === undefined && options.notes === undefined && options.validUntil === undefined) {
+      throw new Error("Nothing to update. Pass --line, --cost, --fee, --notes, or --valid-until (or a --no form to clear).");
     }
     const backend = await backendClient();
     const { number: number4 } = await backend.mutation(api2.quotations.update, {
       id: readQuotationRef(id),
       lineItems: options.line?.map(parseQuotationLineItem),
+      expectedCosts: options.cost === null ? [] : options.cost?.map(parseExpectedCost),
+      recurringFees: options.fee === null ? [] : options.fee?.map(parseRecurringFee),
       notes: options.notes === null ? "" : options.notes,
       validUntil: options.validUntil === null ? "" : options.validUntil
     });
@@ -27154,10 +27457,10 @@ 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,
+    create9,
+    list11,
+    get8,
+    update10,
     issue3,
     email4,
     accept,
@@ -27166,7 +27469,7 @@ quotation converts into any number of draft invoices, each tracing back to it.`,
     duplicate2,
     convert,
     link2,
-    rotateLink2
+    rotateLink3
   ]
 });
 
@@ -27185,7 +27488,21 @@ var upgrade = command({
 var rootCommand = group({
   name: "kds",
   description: "KDS CLI",
-  commands: [auth, clients, costs, daemon, inbox, invoices, issues, pages, project, projects, quotations, upgrade],
+  commands: [
+    auth,
+    clients,
+    costs,
+    daemon,
+    files,
+    inbox,
+    invoices,
+    issues,
+    pages,
+    project,
+    projects,
+    quotations,
+    upgrade
+  ],
   options: {
     version: exports_external.boolean().default(false).describe("Show the version").meta({ short: "v" })
   },
@@ -27198,6 +27515,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 () => {
@@ -27228,6 +27546,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);
@@ -27237,6 +27561,8 @@ try {
     await maybeNotifyUpdate();
 } catch (error51) {
   console.error(errorMessage(error51));
+  if (isRedactedServerError(error51))
+    console.error(await staleCliHint());
   process.exitCode = 1;
 } finally {
   closePrompts();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@islamihab/kds",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Command-line client for Kai Dev Studio",
   "license": "MIT",
   "publishConfig": {