@islamihab/kds 0.12.0 → 0.13.0

package/index.js

@@ -14623,7 +14623,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "cli",
-  version: "0.12.0",
+  version: "0.13.0",
   private: true,
   type: "module",
   bin: {
@@ -15210,6 +15210,8 @@ var PAGE_STYLES = {
 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",
@@ -15379,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 }) => {
@@ -24280,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({
@@ -25162,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"),
@@ -25261,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: {
@@ -25317,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: {
@@ -25407,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: {
@@ -25477,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: {
@@ -25505,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: {
@@ -25525,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: {
@@ -25543,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.",
@@ -25591,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));
@@ -25685,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: {
@@ -25815,7 +26016,7 @@ Feed:`);
     }
   }
 };
-var get4 = command({
+var get5 = command({
   name: "get",
   description: "Show one or more issues: properties, description, and feed",
   positionals: {
@@ -25853,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: {
@@ -25870,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: {
@@ -25887,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: {
@@ -25901,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: {
@@ -25924,7 +26125,7 @@ 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
@@ -25971,7 +26172,7 @@ var resolveScope = async (client3, { project, here, milestone }) => {
     return { projectId: (await repoProject(client3))._id };
   return;
 };
-var list7 = command({
+var list8 = command({
   name: "list",
   description: "List open issues, most recently updated first",
   options: {
@@ -26087,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: {
@@ -26323,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),
@@ -26333,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) {
@@ -26377,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: {
@@ -26422,10 +26623,10 @@ changes_requested, an approval to approved (one outstanding change request outwe
 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,
@@ -26439,7 +26640,7 @@ request the branch name does not point at; from there the same tracking applies.
     relate,
     unrelate,
     comment,
-    remove5
+    remove6
   ]
 });
 
@@ -26447,7 +26648,7 @@ request the branch name does not point at; from there the same tracking applies.
 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]);
@@ -26459,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: {
@@ -26494,7 +26695,7 @@ var create6 = command({
 });
 
 // src/commands/pages/get.ts
-var get5 = command({
+var get6 = command({
   name: "get",
   description: "Print a page's HTML",
   positionals: {
@@ -26513,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: {
@@ -26547,7 +26745,7 @@ var list8 = command({
 });
 
 // src/commands/pages/remove.ts
-var remove6 = command({
+var remove7 = command({
   name: "delete",
   description: "Delete a page",
   positionals: {
@@ -26583,7 +26781,7 @@ var revert = command({
 });
 
 // src/commands/pages/update.ts
-var update7 = command({
+var update8 = command({
   name: "update",
   description: "Replace a page's HTML, title, group, style, or visibility",
   positionals: {
@@ -26651,7 +26849,7 @@ var pages = group({
   ${describeChoices(PAGE_STYLES, `
   `)}
 Basic is the default. A page keeps its URL across updates and reverts.`,
-  commands: [create6, list8, get5, update7, versions2, revert, remove6]
+  commands: [create7, list9, get6, update8, versions2, revert, remove7]
 });
 
 // src/commands/project.ts
@@ -26684,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: {
@@ -26716,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: {
@@ -26760,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: {
@@ -26803,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: {
@@ -26848,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: {
@@ -26879,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
@@ -26938,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: {
@@ -26946,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 })
@@ -26956,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()
@@ -26992,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: {
@@ -27038,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);
@@ -27099,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: {
@@ -27163,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: {
@@ -27177,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
     });
@@ -27227,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,
@@ -27239,7 +27469,7 @@ quotation converts into any number of draft invoices, each tracing back to it.`,
     duplicate2,
     convert,
     link2,
-    rotateLink2
+    rotateLink3
   ]
 });
 
@@ -27258,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" })
   },

package/package.json

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