@islamihab/kds 0.2.0 → 0.2.1

package/index.js

@@ -14450,7 +14450,12 @@ var isHidden = (field) => field.meta()?.hidden === true;
 var isNegatable = (field) => field.meta()?.negatable === true;
 var isHelpFlag = (arg) => arg === "-h" || arg === "--help";
 var valuePlaceholder = (field) => {
-  const base = baseType(field);
+  let base = baseType(field);
+  if (base instanceof exports_external.ZodArray) {
+    const element = base.element;
+    if (element instanceof exports_external.ZodType)
+      base = element;
+  }
   if (base instanceof exports_external.ZodBoolean)
     return "";
   if (base instanceof exports_external.ZodEnum)
@@ -14496,8 +14501,10 @@ var parseArgs = ({
 }) => {
   const options = {};
   for (const { key, field, short, negatedKey } of optionsEntries) {
-    const type = baseType(field) instanceof exports_external.ZodBoolean ? "boolean" : "string";
-    options[key] = short ? { short, type } : { type };
+    const base = baseType(field);
+    const type = base instanceof exports_external.ZodBoolean ? "boolean" : "string";
+    const multiple = base instanceof exports_external.ZodArray ? true : undefined;
+    options[key] = short ? { short, type, multiple } : { type, multiple };
     if (negatedKey)
       options[negatedKey] = { type: "boolean" };
   }
@@ -14587,7 +14594,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "cli",
-  version: "0.2.0",
+  version: "0.2.1",
   private: true,
   type: "module",
   bin: {
@@ -15159,10 +15166,12 @@ var ISSUE_CREATE_DISPOSITIONS = [
 ];
 var ISSUE_ESTIMATES = [1, 2, 3, 5, 8];
 var ISSUE_TERMINAL_STATUSES = ["done", "canceled"];
+var ISSUE_RELATION_KINDS = ["blocks", "blocked_by", "duplicate_of", "duplicated_by", "relates_to"];
 var PROJECT_STATUSES = ["planned", "in_progress", "paused", "completed", "canceled"];
 var PROJECT_HEALTHS = ["on_track", "at_risk", "off_track"];
 var ISSUE_IDENTIFIER_PREFIX = "KAI";
 var ISSUE_LIST_PAGE_SIZE = 50;
+var MAX_ISSUE_ATTACHMENT_BYTES = 1e7;
 var ISSUE_DUE_DATE_MODES = ["overdue", "due_today", "due_soon", "no_due_date"];
 var issueIsOpen = (status) => !ISSUE_TERMINAL_STATUSES.some((terminal) => terminal === status);
 var MAX_PROJECT_REPO_LENGTH = 200;
@@ -17814,6 +17823,59 @@ var auth = group({
   commands: [login, logout, status]
 });
 
+// src/lib/attachments.ts
+import { basename } 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) {
+    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;
+  }
+  const attachments = await client3.query(api2.issueAttachments.list, { issueId });
+  return attachments.filter((attachment) => created.has(attachment._id));
+};
+var printAttachments = (attachments) => {
+  for (const attachment of attachments) {
+    console.log(`Attached ${attachment.name}${attachment.url ? ` \u2014 ${attachment.url}` : ""}`);
+  }
+};
+
 // src/lib/input.ts
 var assertSize = (size) => {
   if (size > MAX_PAGE_HTML_BYTES)
@@ -17924,6 +17986,20 @@ var repoProject = async (client3) => {
     throw new Error(`No project is connected to ${repo}. Connect one on the project in the dashboard.`);
   return project;
 };
+var resolveIssueLabels = async (client3, names) => {
+  if (names.length === 0)
+    return [];
+  const labels = await client3.query(api2.issueLabels.list, {});
+  return names.map((name) => {
+    const wanted = name.trim().toLowerCase();
+    const label = labels.find((candidate) => candidate.name.toLowerCase() === wanted);
+    if (!label) {
+      const available = labels.map((candidate) => candidate.name).join(", ");
+      throw new Error(available ? `No label named "${name}". The labels are: ${available}.` : "There are no labels yet.");
+    }
+    return label;
+  });
+};
 var resolveMilestone = async (client3, projectId, name) => {
   const milestones = await client3.query(api2.milestones.listByProject, { projectId, today: localToday() });
   const wanted = name.trim().toLowerCase();
@@ -17943,9 +18019,13 @@ var comment = command({
     id: exports_external.string().describe("Issue identifier, number, or URL"),
     body: exports_external.string().describe("Comment markdown, or - for stdin")
   },
-  run: async ({ positionals: { id, body } }) => {
+  options: {
+    attach: exports_external.array(exports_external.string()).optional().describe("Attach a file to the issue (repeatable)").meta({ short: "a" })
+  },
+  run: async ({ positionals: { id, body }, options: { attach } }) => {
     const client3 = await backendClient();
     const issue2 = await resolveIssue(client3, id);
+    printAttachments(await attachFiles(client3, issue2._id, attach ?? []));
     await client3.mutation(api2.issueComments.create, { issueId: issue2._id, bodyMarkdown: await readTextOption(body) });
     console.log(`Commented on ${issue2.identifier}.`);
   }
@@ -17993,6 +18073,7 @@ var create = command({
 });
 
 // src/commands/issues/get.ts
+var SOURCE_LABELS = { github: "GitHub" };
 var activityLine = (detail) => {
   const label = detail.kind.replaceAll("_", " ");
   switch (detail.kind) {
@@ -18005,6 +18086,8 @@ var activityLine = (detail) => {
     case "disposition_changed":
     case "estimate_changed":
     case "due_date_changed":
+    case "branch_changed":
+    case "pr_changed":
     case "project_changed":
     case "milestone_changed":
     case "parent_changed":
@@ -18034,9 +18117,13 @@ var get = command({
   run: async ({ positionals: { id }, options: { json: json2 } }) => {
     const client3 = await backendClient();
     const issue2 = await resolveIssue(client3, id);
-    const feed = await client3.query(api2.issues.feed, { id: issue2._id });
+    const [feed, relations, attachments] = await Promise.all([
+      client3.query(api2.issues.feed, { id: issue2._id }),
+      client3.query(api2.issues.relations, { id: issue2._id }),
+      client3.query(api2.issueAttachments.list, { issueId: issue2._id })
+    ]);
     if (json2)
-      return console.log(JSON.stringify({ ...issue2, feed }, null, 2));
+      return console.log(JSON.stringify({ ...issue2, relations, attachments, feed }, null, 2));
     const project = issue2.projectId ? await client3.query(api2.projects.get, { id: issue2.projectId, today: localToday() }) : null;
     const milestone = issue2.milestoneId ? await client3.query(api2.milestones.get, { id: issue2.milestoneId, today: localToday() }) : null;
     console.log(`${issue2.identifier} ${issue2.title}`);
@@ -18045,6 +18132,10 @@ var get = command({
       console.log(`Estimate: ${issue2.estimate}`);
     if (issue2.dueDate)
       console.log(`Due: ${issue2.dueDate}`);
+    if (issue2.branch)
+      console.log(`Branch: ${issue2.branch}`);
+    if (issue2.prUrl)
+      console.log(`PR: ${issue2.prUrl}`);
     if (project)
       console.log(`Project: ${project.name}${milestone ? ` \xB7 Milestone: ${milestone.name}` : ""}`);
     if (issue2.parent)
@@ -18053,6 +18144,23 @@ var get = command({
       console.log(`Labels: ${issue2.labels.map((label) => label.name).join(", ")}`);
     if (issue2.children.total > 0)
       console.log(`Sub-issues: ${issue2.children.done}/${issue2.children.total} done`);
+    const related = (entries) => entries.map((entry) => `${entry.issue.identifier} (${entry.issue.status})`).join(", ");
+    if (relations.blockedBy.length > 0)
+      console.log(`Blocked by: ${related(relations.blockedBy)}`);
+    if (relations.blocks.length > 0)
+      console.log(`Blocks: ${related(relations.blocks)}`);
+    if (relations.duplicateOf)
+      console.log(`Duplicate of: ${related([relations.duplicateOf])}`);
+    if (relations.duplicates.length > 0)
+      console.log(`Duplicated by: ${related(relations.duplicates)}`);
+    if (relations.relatesTo.length > 0)
+      console.log(`Related: ${related(relations.relatesTo)}`);
+    if (attachments.length > 0) {
+      console.log("Attachments:");
+      for (const attachment of attachments) {
+        console.log(`  ${attachment.name} \u2014 ${attachment.url ?? "unavailable"}`);
+      }
+    }
     if (issue2.descriptionMarkdown)
       console.log(`
 ${issue2.descriptionMarkdown}`);
@@ -18064,7 +18172,8 @@ Feed:`);
     for (const event of feed.events) {
       const at = new Date(event.at).toISOString().slice(0, 16).replace("T", " ");
       if (event.type === "activity") {
-        console.log(`${at}  ${activityLine(event.detail)}`);
+        const via = event.via === undefined ? "" : ` (via ${SOURCE_LABELS[event.via]})`;
+        console.log(`${at}  ${activityLine(event.detail)}${via}`);
       } else {
         console.log(`${at}  comment${event.editedAt ? " (edited)" : ""}:`);
         for (const line of event.bodyMarkdown.split(`
@@ -18155,6 +18264,24 @@ More issues match; raise --limit past ${options.limit}.`);
   }
 });
 
+// src/commands/issues/relate.ts
+var relate = command({
+  name: "relate",
+  description: "Relate two issues, stated from the first one's side (duplicate_of also cancels it)",
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL"),
+    kind: exports_external.enum(ISSUE_RELATION_KINDS).describe(`How the first issue relates to the second (${ISSUE_RELATION_KINDS.join("|")})`),
+    other: exports_external.string().describe("The other issue's identifier, number, or URL")
+  },
+  run: async ({ positionals: { id, kind, other } }) => {
+    const client3 = await backendClient();
+    const issue2 = await resolveIssue(client3, id);
+    const otherIssue = await resolveIssue(client3, other);
+    await client3.mutation(api2.issues.addRelation, { id: issue2._id, kind, otherIssueId: otherIssue._id });
+    console.log(`${issue2.identifier} ${kind.replaceAll("_", " ")} ${otherIssue.identifier}.`);
+  }
+});
+
 // src/commands/issues/remove.ts
 var remove = command({
   name: "delete",
@@ -18196,7 +18323,7 @@ var route = command({
 // src/commands/issues/set.ts
 var set2 = command({
   name: "set",
-  description: "Set an issue's status, priority, estimate, due date, project, milestone, or parent",
+  description: "Set an issue's status, priority, estimate, due date, project, milestone, parent, or labels",
   positionals: {
     id: exports_external.string().describe("Issue identifier, number, or URL")
   },
@@ -18207,12 +18334,14 @@ var set2 = command({
     due: exports_external.iso.date().nullable().optional().describe("Due date (YYYY-MM-DD), or --no-due to clear").meta({ negatable: true }),
     project: exports_external.string().nullable().optional().describe("Move to this project (id or URL), or --no-project to make the issue projectless").meta({ negatable: true }),
     milestone: exports_external.string().nullable().optional().describe("Move to this milestone of the issue's project (name), or --no-milestone to clear").meta({ negatable: true }),
-    parent: exports_external.string().nullable().optional().describe("Make this a sub-issue of another issue, or --no-parent to promote it").meta({ negatable: true })
+    parent: exports_external.string().nullable().optional().describe("Make this a sub-issue of another issue, or --no-parent to promote it").meta({ negatable: true }),
+    label: exports_external.array(exports_external.string()).optional().describe("Add a label by name (repeatable)"),
+    "no-label": exports_external.array(exports_external.string()).optional().describe("Remove a label by name (repeatable)")
   },
   run: async ({ positionals: { id }, options }) => {
-    const { status: status2, priority, estimate, due, project, milestone, parent } = options;
+    const { status: status2, priority, estimate, due, project, milestone, parent, label, "no-label": noLabel } = options;
     if (Object.values(options).every((value) => value === undefined))
-      throw new Error("Nothing to set. Pass --status, --priority, --estimate, --due, --project, --milestone, or --parent.");
+      throw new Error("Nothing to set. Pass --status, --priority, --estimate, --due, --project, --milestone, --parent, or --label.");
     const client3 = await backendClient();
     const issue2 = await resolveIssue(client3, id);
     const projectId = project === undefined ? issue2.projectId : project === null ? undefined : (await resolveProject(client3, project))._id;
@@ -18225,8 +18354,14 @@ var set2 = command({
       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: issue2._id, parentId });
+    for (const { _id } of addLabels)
+      await client3.mutation(api2.issues.addLabel, { issueId: issue2._id, labelId: _id });
+    for (const { _id } of removeLabels)
+      await client3.mutation(api2.issues.removeLabel, { issueId: issue2._id, labelId: _id });
     if (status2 !== undefined)
       await client3.mutation(api2.issues.setStatus, { id: issue2._id, status: status2 });
     if (priority !== undefined)
@@ -18241,27 +18376,86 @@ var set2 = command({
   }
 });
 
+// src/commands/issues/start.ts
+var shellArg = (value) => /^[\w./-]+$/.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
+var start = command({
+  name: "start",
+  description: "Claim an issue: move it to in_progress and record the branch to work under",
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const client3 = await backendClient();
+    const issue2 = await resolveIssue(client3, id);
+    const { branch } = await client3.mutation(api2.issues.start, { id: issue2._id });
+    console.log(`Started ${issue2.identifier}: in_progress, branch ${branch}`);
+    console.log(`
+  git switch -c ${shellArg(branch)}`);
+  }
+});
+
+// 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)",
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL"),
+    kind: exports_external.enum(ISSUE_RELATION_KINDS).describe(`How the first issue relates to the second (${ISSUE_RELATION_KINDS.join("|")})`),
+    other: exports_external.string().describe("The other issue's identifier, number, or URL")
+  },
+  run: async ({ positionals: { id, kind, other } }) => {
+    const client3 = await backendClient();
+    const issue2 = await resolveIssue(client3, id);
+    const otherIssue = await resolveIssue(client3, other);
+    const relations = await client3.query(api2.issues.relations, { id: issue2._id });
+    const relation = relationEntries(relations, kind).find((entry) => entry.issue._id === otherIssue._id);
+    const label = kind.replaceAll("_", " ");
+    if (!relation)
+      throw new Error(`${issue2.identifier} has no "${label}" relation to ${otherIssue.identifier}.`);
+    await client3.mutation(api2.issues.removeRelation, { id: relation._id });
+    console.log(`Removed: ${issue2.identifier} ${label} ${otherIssue.identifier}.`);
+  }
+});
+
 // src/commands/issues/update.ts
 var update = command({
   name: "update",
-  description: "Rewrite an issue's title or description",
+  description: "Rewrite an issue's title or description, or attach files",
   positionals: {
     id: exports_external.string().describe("Issue identifier, number, or URL")
   },
   options: {
     title: exports_external.string().optional().describe("New title").meta({ short: "t" }),
-    description: exports_external.string().optional().describe("New markdown description, or - for stdin").meta({ short: "d" })
+    description: exports_external.string().optional().describe("New markdown description, or - for stdin").meta({ short: "d" }),
+    attach: exports_external.array(exports_external.string()).optional().describe("Attach a file to the issue (repeatable)").meta({ short: "a" })
   },
-  run: async ({ positionals: { id }, options: { title, description } }) => {
-    if (title === undefined && description === undefined)
-      throw new Error("Nothing to update. Pass --title or --description.");
+  run: async ({ positionals: { id }, options: { title, description, attach } }) => {
+    if (title === undefined && description === undefined && attach === undefined)
+      throw new Error("Nothing to update. Pass --title, --description, or --attach.");
     const client3 = await backendClient();
     const issue2 = await resolveIssue(client3, id);
-    await client3.mutation(api2.issues.update, {
-      id: issue2._id,
-      title,
-      descriptionMarkdown: description === undefined ? undefined : await readTextOption(description)
-    });
+    printAttachments(await attachFiles(client3, issue2._id, attach ?? []));
+    if (title !== undefined || description !== undefined) {
+      await client3.mutation(api2.issues.update, {
+        id: issue2._id,
+        title,
+        descriptionMarkdown: description === undefined ? undefined : await readTextOption(description)
+      });
+    }
     console.log(`Updated ${issue2.identifier}.`);
   }
 });
@@ -18270,11 +18464,11 @@ var update = command({
 var issues = group({
   name: "issues",
   description: "Track and triage issues",
-  commands: [create, list, get, update, set2, route, comment, remove]
+  commands: [create, list, get, update, set2, route, start, relate, unrelate, comment, remove]
 });
 
 // src/lib/group.ts
-import { basename } from "path";
+import { basename as basename2 } 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]);
@@ -18286,7 +18480,7 @@ var detectRepoGroup = async () => {
   if (remote)
     return repoNameFromRemote(remote);
   const root = await git("rev-parse", "--show-toplevel");
-  return root ? basename(root) : undefined;
+  return root ? basename2(root) : undefined;
 };
 var groupForCreate = async (group2) => group2 === null ? undefined : group2 ?? await detectRepoGroup();
 

package/package.json

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