@islamihab/kds 0.1.4 → 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.1.4",
+  version: "0.2.1",
   private: true,
   type: "module",
   bin: {
@@ -15143,6 +15150,30 @@ var KDS_DEVICE_AUTH_CLIENT_ID = "kds-cli";
 var PAGE_MODES = ["themed", "raw"];
 var PAGE_VISIBILITIES = ["public", "private"];
 var MAX_PAGE_HTML_BYTES = 4000000;
+var ISSUE_STATUSES = ["backlog", "todo", "in_progress", "done", "canceled"];
+var ISSUE_PRIORITIES = ["urgent", "high", "medium", "low", "none"];
+var ISSUE_DISPOSITIONS = [
+  "needs_triage",
+  "needs_info",
+  "ready_for_agent",
+  "ready_for_human",
+  "wontfix"
+];
+var ISSUE_CREATE_DISPOSITIONS = [
+  "needs_triage",
+  "ready_for_agent",
+  "ready_for_human"
+];
+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;
 
 // src/commands/auth/login.ts
@@ -17103,6 +17134,12 @@ var normalizeUrl = (url2, errorMessage) => {
     throw new Error(errorMessage ?? "URL must be a valid URL");
   return new URL(parsed.data).origin;
 };
+var localToday = () => {
+  const now3 = new Date;
+  const month = String(now3.getMonth() + 1).padStart(2, "0");
+  const day = String(now3.getDate()).padStart(2, "0");
+  return `${now3.getFullYear()}-${month}-${day}`;
+};
 
 // src/lib/zod.ts
 var configSchema = exports_external.object({ sessionToken: exports_external.string().optional(), convexUrl: exports_external.url(), convexSiteUrl: exports_external.url() });
@@ -17786,22 +17823,58 @@ var auth = group({
   commands: [login, logout, status]
 });
 
-// src/lib/group.ts
+// src/lib/attachments.ts
 import { basename } 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]);
-  return exitCode === 0 ? output.trim() || null : null;
+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 repoNameFromRemote = (remote) => remote.replace(/\/+$/, "").replace(/\.git$/, "").split(/[/:]/).pop() || undefined;
-var detectRepoGroup = async () => {
-  const remote = await git("remote", "get-url", "origin");
-  if (remote)
-    return repoNameFromRemote(remote);
-  const root = await git("rev-parse", "--show-toplevel");
-  return root ? basename(root) : undefined;
+var printAttachments = (attachments) => {
+  for (const attachment of attachments) {
+    console.log(`Attached ${attachment.name}${attachment.url ? ` \u2014 ${attachment.url}` : ""}`);
+  }
 };
-var groupForCreate = async (group2) => group2 === null ? undefined : group2 ?? await detectRepoGroup();
 
 // src/lib/input.ts
 var assertSize = (size) => {
@@ -17818,6 +17891,27 @@ var readBody = async (path) => {
   assertSize(file2.size);
   return await file2.text();
 };
+var readTextOption = async (value) => value === "-" ? await Bun.stdin.text() : value;
+var readIssueRef = (value) => {
+  const trimmed = value.trim();
+  if (/^\d+$/.test(trimmed))
+    return `${ISSUE_IDENTIFIER_PREFIX}-${trimmed}`;
+  try {
+    const url2 = new URL(trimmed);
+    return url2.pathname.match(/\/issues\/([^/]+)\/?$/)?.[1] ?? trimmed;
+  } catch {
+    return trimmed;
+  }
+};
+var readProjectRef = (value) => {
+  const trimmed = value.trim();
+  try {
+    const url2 = new URL(trimmed);
+    return url2.pathname.match(/\/projects\/([^/]+)\/?$/)?.[1] ?? trimmed;
+  } catch {
+    return trimmed;
+  }
+};
 var readPageId = (value) => {
   const trimmed = value.trim();
   try {
@@ -17829,8 +17923,569 @@ var readPageId = (value) => {
   }
 };
 
-// src/commands/pages/create.ts
+// ../../packages/backend/convex/lib/projectRepo.ts
+var DEFAULT_REPO_HOST = "github.com";
+var REPO_FORMAT_ERROR = "Enter a repository like github.com/owner/name.";
+var HOST_PATTERN = /^[a-z0-9][a-z0-9.-]*\.[a-z]{2,}$/;
+var SEGMENT_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
+var normalizeProjectRepo = (value) => {
+  const trimmed = value?.trim();
+  if (!trimmed)
+    return;
+  if (trimmed.length > MAX_PROJECT_REPO_LENGTH) {
+    throw new ConvexError(`Repository must be ${MAX_PROJECT_REPO_LENGTH} characters or fewer.`);
+  }
+  const path = trimmed.toLowerCase().replace(/^(https?|ssh|git):\/\//, "").replace(/^[^/@:]+@/, "").replace(":", "/").replace(/\/+$/, "").replace(/\.git$/, "");
+  const segments = path.split("/");
+  const [host, owner, name] = segments.length === 2 ? [DEFAULT_REPO_HOST, ...segments] : segments.length === 3 ? segments : [];
+  if (!host || !owner || !name)
+    throw new ConvexError(REPO_FORMAT_ERROR);
+  if (!HOST_PATTERN.test(host) || !SEGMENT_PATTERN.test(owner) || !SEGMENT_PATTERN.test(name)) {
+    throw new ConvexError(REPO_FORMAT_ERROR);
+  }
+  const key = `${host}/${owner}/${name}`;
+  if (key.length > MAX_PROJECT_REPO_LENGTH) {
+    throw new ConvexError(`Repository must be ${MAX_PROJECT_REPO_LENGTH} characters or fewer.`);
+  }
+  return key;
+};
+var tryNormalizeProjectRepo = (value) => {
+  try {
+    return normalizeProjectRepo(value);
+  } catch {
+    return;
+  }
+};
+
+// src/lib/repo.ts
+var currentRepoKey = async () => {
+  const proc = Bun.spawn(["git", "remote", "get-url", "origin"], { stdout: "pipe", stderr: "ignore" });
+  const url2 = await new Response(proc.stdout).text();
+  return await proc.exited === 0 ? tryNormalizeProjectRepo(url2) : undefined;
+};
+
+// src/lib/resolve.ts
+var resolveIssue = async (client3, ref) => {
+  const issue2 = await client3.query(api2.issues.get, { identifier: readIssueRef(ref) });
+  if (!issue2)
+    throw new Error(`No issue matches ${ref}.`);
+  return issue2;
+};
+var resolveProject = async (client3, ref) => {
+  const project = await client3.query(api2.projects.get, { id: readProjectRef(ref), today: localToday() });
+  if (!project)
+    throw new Error(`No project matches ${ref}.`);
+  return project;
+};
+var repoProject = async (client3) => {
+  const repo = await currentRepoKey();
+  if (!repo)
+    throw new Error("No repository here: not a git checkout with an origin remote.");
+  const project = await client3.query(api2.projects.findByRepo, { repo });
+  if (!project)
+    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();
+  const milestone = milestones.find((candidate) => candidate.name.toLowerCase() === wanted);
+  if (!milestone) {
+    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/issues/comment.ts
+var comment = command({
+  name: "comment",
+  description: "Comment on an issue",
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL"),
+    body: exports_external.string().describe("Comment markdown, or - for stdin")
+  },
+  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}.`);
+  }
+});
+
+// src/commands/issues/create.ts
 var create = command({
+  name: "create",
+  description: "Create an issue and print its identifier",
+  positionals: {
+    title: exports_external.string().describe("Issue title")
+  },
+  options: {
+    description: exports_external.string().optional().describe("Markdown description, or - for stdin").meta({ short: "d" }),
+    status: exports_external.enum(ISSUE_STATUSES).optional().describe("Starting status (default backlog)").meta({ short: "s" }),
+    priority: exports_external.enum(ISSUE_PRIORITIES).optional().describe("Priority (default none)").meta({ short: "p" }),
+    estimate: exports_external.coerce.number().pipe(exports_external.literal([...ISSUE_ESTIMATES])).optional().describe(`Points (${ISSUE_ESTIMATES.join("|")})`),
+    due: exports_external.iso.date().optional().describe("Due date (YYYY-MM-DD)"),
+    project: exports_external.string().optional().describe("Project to create the issue in (id or URL)"),
+    here: exports_external.boolean().default(false).describe("Create in the checkout's connected project"),
+    milestone: exports_external.string().optional().describe("Milestone name (needs --project or --here)"),
+    disposition: exports_external.enum(ISSUE_CREATE_DISPOSITIONS).optional().describe("Route immediately (default needs_triage)")
+  },
+  run: async ({ positionals: { title }, options }) => {
+    if (options.project && options.here)
+      throw new Error("Pass --project or --here, not both.");
+    const client3 = await backendClient();
+    const project = options.project ? await resolveProject(client3, options.project) : options.here ? await repoProject(client3) : undefined;
+    if (options.milestone && !project)
+      throw new Error("A milestone needs --project or --here.");
+    const milestone = project && options.milestone ? await resolveMilestone(client3, project._id, options.milestone) : undefined;
+    const { identifier } = await client3.mutation(api2.issues.create, {
+      title,
+      descriptionMarkdown: options.description === undefined ? undefined : await readTextOption(options.description),
+      status: options.status,
+      priority: options.priority,
+      estimate: options.estimate,
+      dueDate: options.due,
+      projectId: project?._id,
+      milestoneId: milestone?._id,
+      disposition: options.disposition
+    });
+    console.log(identifier);
+  }
+});
+
+// src/commands/issues/get.ts
+var SOURCE_LABELS = { github: "GitHub" };
+var activityLine = (detail) => {
+  const label = detail.kind.replaceAll("_", " ");
+  switch (detail.kind) {
+    case "created":
+    case "description_changed":
+      return label;
+    case "title_changed":
+    case "status_changed":
+    case "priority_changed":
+    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":
+      return `${label}: ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
+    case "label_added":
+    case "label_removed":
+    case "attachment_added":
+    case "attachment_removed":
+      return `${label}: ${detail.name}`;
+    case "child_added":
+    case "child_removed":
+      return `${label}: ${detail.identifier}`;
+    case "relation_added":
+    case "relation_removed":
+      return `${label}: ${detail.relation.replaceAll("_", " ")} ${detail.identifier}`;
+  }
+};
+var get = command({
+  name: "get",
+  description: "Show an issue: properties, description, and its feed",
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL")
+  },
+  options: {
+    json: exports_external.boolean().default(false).describe("Print as JSON")
+  },
+  run: async ({ positionals: { id }, options: { json: json2 } }) => {
+    const client3 = await backendClient();
+    const issue2 = await resolveIssue(client3, 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, 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}`);
+    console.log(`Status: ${issue2.status} \xB7 Priority: ${issue2.priority} \xB7 Disposition: ${issue2.disposition}`);
+    if (issue2.estimate !== undefined)
+      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)
+      console.log(`Parent: ${issue2.parent.identifier} ${issue2.parent.title}`);
+    if (issue2.labels.length > 0)
+      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}`);
+    if (feed.events.length > 0)
+      console.log(`
+Feed:`);
+    if (feed.truncated)
+      console.log("(older events truncated)");
+    for (const event of feed.events) {
+      const at = new Date(event.at).toISOString().slice(0, 16).replace("T", " ");
+      if (event.type === "activity") {
+        const via = event.via === undefined ? "" : ` (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(`
+`))
+          console.log(`  ${line}`);
+      }
+    }
+  }
+});
+
+// src/lib/output.ts
+var printTable = (rows) => {
+  if (rows.length === 0)
+    return;
+  const columnCount = Math.max(...rows.map((row) => row.length));
+  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
+  for (const row of rows) {
+    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
+  }
+};
+
+// src/commands/issues/list.ts
+var list = command({
+  name: "list",
+  description: "List open issues, most recently updated first",
+  options: {
+    all: exports_external.boolean().default(false).describe("Include done and canceled issues"),
+    status: exports_external.enum(ISSUE_STATUSES).optional().describe("Only this status").meta({ short: "s" }),
+    priority: exports_external.enum(ISSUE_PRIORITIES).optional().describe("Only this priority").meta({ short: "p" }),
+    disposition: exports_external.enum(ISSUE_DISPOSITIONS).optional().describe("Only this disposition").meta({ short: "d" }),
+    project: exports_external.string().optional().describe("Only this project (id or URL)"),
+    here: exports_external.boolean().default(false).describe("Only the checkout's connected project"),
+    milestone: exports_external.string().optional().describe("Only this milestone (name; needs --project or --here)"),
+    due: exports_external.enum(ISSUE_DUE_DATE_MODES).optional().describe("Only this due-date state"),
+    search: exports_external.string().optional().describe("Free-text search (results come in relevance order)"),
+    limit: exports_external.coerce.number().int().positive().default(ISSUE_LIST_PAGE_SIZE).describe("Most issues to print"),
+    json: exports_external.boolean().default(false).describe("Print as JSON")
+  },
+  run: async ({ options }) => {
+    if (options.project && options.here)
+      throw new Error("Pass --project or --here, not both.");
+    const client3 = await backendClient();
+    const project = options.project ? await resolveProject(client3, options.project) : options.here ? await repoProject(client3) : undefined;
+    if (options.milestone && !project)
+      throw new Error("A milestone filter needs --project or --here.");
+    const milestone = project && options.milestone ? await resolveMilestone(client3, project._id, options.milestone) : undefined;
+    const result = await client3.query(api2.issueViews.query, {
+      source: {
+        type: "custom",
+        query: {
+          layout: "list",
+          groupBy: "none",
+          orderBy: "updated_at",
+          orderDirection: "desc",
+          filters: {
+            query: options.search,
+            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,
+            dueDate: options.due
+          }
+        }
+      },
+      paginationOpts: { numItems: options.limit, cursor: null },
+      today: localToday()
+    });
+    if (options.json)
+      return console.log(JSON.stringify(result.page, null, 2));
+    if (result.page.length === 0)
+      return console.log("No issues match.");
+    printTable([
+      ["ID", "TITLE", "STATUS", "PRIORITY", "DISPOSITION", "DUE", "UPDATED"],
+      ...result.page.map((issue2) => [
+        issue2.identifier,
+        issue2.title,
+        issue2.status,
+        issue2.priority,
+        issue2.disposition,
+        issue2.dueDate ?? "-",
+        new Date(issue2.updatedAt).toISOString().slice(0, 10)
+      ])
+    ]);
+    if (!result.isDone)
+      console.log(`
+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",
+  description: "Delete an issue permanently (sub-issues survive as top-level issues)",
+  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);
+    await client3.mutation(api2.issues.remove, { id: issue2._id });
+    console.log(`Deleted ${issue2.identifier}.`);
+  }
+});
+
+// src/commands/issues/route.ts
+var route = command({
+  name: "route",
+  description: "Route an issue to a disposition (wontfix also cancels it)",
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL"),
+    disposition: exports_external.enum(ISSUE_DISPOSITIONS).describe("Where the issue goes next")
+  },
+  options: {
+    comment: exports_external.string().optional().describe("Why, as a comment (required for needs_info and wontfix), or - for stdin").meta({ short: "c" })
+  },
+  run: async ({ positionals: { id, disposition }, options: { comment: comment2 } }) => {
+    const client3 = await backendClient();
+    const issue2 = await resolveIssue(client3, id);
+    await client3.mutation(api2.issues.route, {
+      id: issue2._id,
+      disposition,
+      comment: comment2 === undefined ? undefined : await readTextOption(comment2)
+    });
+    console.log(`Routed ${issue2.identifier} to ${disposition}.`);
+  }
+});
+
+// src/commands/issues/set.ts
+var set2 = command({
+  name: "set",
+  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")
+  },
+  options: {
+    status: exports_external.enum(ISSUE_STATUSES).optional().describe("New status").meta({ short: "s" }),
+    priority: exports_external.enum(ISSUE_PRIORITIES).optional().describe("New priority").meta({ short: "p" }),
+    estimate: exports_external.coerce.number().pipe(exports_external.literal([...ISSUE_ESTIMATES])).nullable().optional().describe(`Points (${ISSUE_ESTIMATES.join("|")}), or --no-estimate to clear`).meta({ negatable: true }),
+    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 }),
+    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, 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, --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;
+    let milestoneId;
+    if (milestone === undefined) {
+      milestoneId = projectId === issue2.projectId ? issue2.milestoneId : undefined;
+    } else if (milestone !== null) {
+      if (projectId === undefined)
+        throw new Error("A milestone needs a project. Pass --project too.");
+      milestoneId = (await resolveMilestone(client3, projectId, milestone))._id;
+    }
+    const parentId = parent == null ? undefined : (await resolveIssue(client3, parent))._id;
+    const addLabels = await resolveIssueLabels(client3, label ?? []);
+    const removeLabels = await resolveIssueLabels(client3, noLabel ?? []);
+    if (parent !== undefined)
+      await client3.mutation(api2.issues.setParent, { id: 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)
+      await client3.mutation(api2.issues.setPriority, { id: issue2._id, priority });
+    if (estimate !== undefined)
+      await client3.mutation(api2.issues.setEstimate, { id: issue2._id, estimate: estimate ?? undefined });
+    if (due !== undefined)
+      await client3.mutation(api2.issues.setDueDate, { id: issue2._id, dueDate: due ?? undefined });
+    if (project !== undefined || milestone !== undefined)
+      await client3.mutation(api2.issues.setMembership, { id: issue2._id, projectId, milestoneId });
+    console.log(`Updated ${issue2.identifier}.`);
+  }
+});
+
+// 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, 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" }),
+    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, 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);
+    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}.`);
+  }
+});
+
+// src/commands/issues/index.ts
+var issues = group({
+  name: "issues",
+  description: "Track and triage issues",
+  commands: [create, list, get, update, set2, route, start, relate, unrelate, comment, remove]
+});
+
+// src/lib/group.ts
+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]);
+  return exitCode === 0 ? output.trim() || null : null;
+};
+var repoNameFromRemote = (remote) => remote.replace(/\/+$/, "").replace(/\.git$/, "").split(/[/:]/).pop() || undefined;
+var detectRepoGroup = async () => {
+  const remote = await git("remote", "get-url", "origin");
+  if (remote)
+    return repoNameFromRemote(remote);
+  const root = await git("rev-parse", "--show-toplevel");
+  return root ? basename2(root) : undefined;
+};
+var groupForCreate = async (group2) => group2 === null ? undefined : group2 ?? await detectRepoGroup();
+
+// src/commands/pages/create.ts
+var create2 = command({
   name: "create",
   description: "Publish a page and print its URL",
   positionals: {
@@ -17859,7 +18514,7 @@ var create = command({
 });
 
 // src/commands/pages/get.ts
-var get = command({
+var get2 = command({
   name: "get",
   description: "Print a page's HTML",
   positionals: {
@@ -17881,19 +18536,8 @@ var get = command({
 // ../../packages/backend/convex/lib/format.ts
 var formatBytes = (bytes) => bytes < 1024 ? `${bytes} B` : `${Math.round(bytes / 1024)} KB`;
 
-// src/lib/output.ts
-var printTable = (rows) => {
-  if (rows.length === 0)
-    return;
-  const columnCount = Math.max(...rows.map((row) => row.length));
-  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
-  for (const row of rows) {
-    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
-  }
-};
-
 // src/commands/pages/list.ts
-var list = command({
+var list2 = command({
   name: "list",
   description: "List your published pages",
   options: {
@@ -17923,7 +18567,7 @@ var list = command({
 });
 
 // src/commands/pages/remove.ts
-var remove = command({
+var remove2 = command({
   name: "delete",
   description: "Delete a page",
   positionals: {
@@ -17950,7 +18594,7 @@ var revert = command({
 });
 
 // src/commands/pages/update.ts
-var update = command({
+var update2 = command({
   name: "update",
   description: "Replace a page's HTML, title, group, mode, or visibility",
   positionals: {
@@ -18011,50 +18655,9 @@ var versions2 = command({
 var pages = group({
   name: "pages",
   description: "Publish HTML documents to the web",
-  commands: [create, list, get, update, versions2, revert, remove]
+  commands: [create2, list2, get2, update2, versions2, revert, remove2]
 });
 
-// ../../packages/backend/convex/lib/projectRepo.ts
-var DEFAULT_REPO_HOST = "github.com";
-var REPO_FORMAT_ERROR = "Enter a repository like github.com/owner/name.";
-var HOST_PATTERN = /^[a-z0-9][a-z0-9.-]*\.[a-z]{2,}$/;
-var SEGMENT_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
-var normalizeProjectRepo = (value) => {
-  const trimmed = value?.trim();
-  if (!trimmed)
-    return;
-  if (trimmed.length > MAX_PROJECT_REPO_LENGTH) {
-    throw new ConvexError(`Repository must be ${MAX_PROJECT_REPO_LENGTH} characters or fewer.`);
-  }
-  const path = trimmed.toLowerCase().replace(/^(https?|ssh|git):\/\//, "").replace(/^[^/@:]+@/, "").replace(":", "/").replace(/\/+$/, "").replace(/\.git$/, "");
-  const segments = path.split("/");
-  const [host, owner, name] = segments.length === 2 ? [DEFAULT_REPO_HOST, ...segments] : segments.length === 3 ? segments : [];
-  if (!host || !owner || !name)
-    throw new ConvexError(REPO_FORMAT_ERROR);
-  if (!HOST_PATTERN.test(host) || !SEGMENT_PATTERN.test(owner) || !SEGMENT_PATTERN.test(name)) {
-    throw new ConvexError(REPO_FORMAT_ERROR);
-  }
-  const key = `${host}/${owner}/${name}`;
-  if (key.length > MAX_PROJECT_REPO_LENGTH) {
-    throw new ConvexError(`Repository must be ${MAX_PROJECT_REPO_LENGTH} characters or fewer.`);
-  }
-  return key;
-};
-var tryNormalizeProjectRepo = (value) => {
-  try {
-    return normalizeProjectRepo(value);
-  } catch {
-    return;
-  }
-};
-
-// src/lib/repo.ts
-var currentRepoKey = async () => {
-  const proc = Bun.spawn(["git", "remote", "get-url", "origin"], { stdout: "pipe", stderr: "ignore" });
-  const url2 = await new Response(proc.stdout).text();
-  return await proc.exited === 0 ? tryNormalizeProjectRepo(url2) : undefined;
-};
-
 // src/commands/project.ts
 var project = command({
   name: "project",
@@ -18084,6 +18687,192 @@ var project = command({
   }
 });
 
+// src/commands/projects/create.ts
+var create3 = command({
+  name: "create",
+  description: "Create a project and print its id",
+  positionals: {
+    name: exports_external.string().describe("Project name")
+  },
+  options: {
+    summary: exports_external.string().optional().describe("One-line summary").meta({ short: "s" }),
+    description: exports_external.string().optional().describe("Markdown description, or - for stdin").meta({ short: "d" }),
+    status: exports_external.enum(PROJECT_STATUSES).optional().describe("Starting status (default planned)"),
+    health: exports_external.enum(PROJECT_HEALTHS).optional().describe("Health"),
+    target: exports_external.iso.date().optional().describe("Target date (YYYY-MM-DD)"),
+    repo: exports_external.string().optional().describe("Repository to connect (owner/name or any remote URL)")
+  },
+  run: async ({ positionals: { name }, options }) => {
+    const projectId = await (await backendClient()).mutation(api2.projects.create, {
+      name,
+      summary: options.summary,
+      descriptionMarkdown: options.description === undefined ? undefined : await readTextOption(options.description),
+      status: options.status,
+      health: options.health,
+      targetDate: options.target,
+      repo: options.repo
+    });
+    console.log(projectId);
+  }
+});
+
+// src/commands/projects/get.ts
+var get3 = command({
+  name: "get",
+  description: "Show a project: properties, description, and milestones",
+  positionals: {
+    id: exports_external.string().describe("Project id or URL")
+  },
+  options: {
+    json: exports_external.boolean().default(false).describe("Print as JSON")
+  },
+  run: async ({ positionals: { id }, options: { json: json2 } }) => {
+    const client3 = await backendClient();
+    const project2 = await resolveProject(client3, id);
+    const milestones = await client3.query(api2.milestones.listByProject, {
+      projectId: project2._id,
+      today: localToday()
+    });
+    if (json2)
+      return console.log(JSON.stringify({ ...project2, milestones }, null, 2));
+    console.log(project2.name);
+    if (project2.summary)
+      console.log(project2.summary);
+    if (project2.repo)
+      console.log(`Repo: ${project2.repo}`);
+    console.log(`Status: ${project2.status}${project2.health ? ` \xB7 Health: ${project2.health}` : ""}`);
+    console.log(`Progress: ${project2.progress.done}/${project2.progress.total} issues done`);
+    if (project2.targetDate)
+      console.log(`Target date: ${project2.targetDate}${project2.isOverdue ? " (overdue)" : ""}`);
+    if (project2.descriptionMarkdown)
+      console.log(`
+${project2.descriptionMarkdown}`);
+    if (milestones.length > 0) {
+      console.log(`
+Milestones:`);
+      for (const milestone of milestones) {
+        const target = milestone.targetDate ? ` \xB7 target ${milestone.targetDate}${milestone.isOverdue ? " (overdue)" : ""}` : "";
+        console.log(`  ${milestone.name} \u2014 ${milestone.progress.done}/${milestone.progress.total} done${target}`);
+      }
+    }
+  }
+});
+
+// src/commands/projects/list.ts
+var list3 = command({
+  name: "list",
+  description: "List your projects, most recently updated first",
+  options: {
+    limit: exports_external.coerce.number().int().positive().default(50).describe("Most projects to print"),
+    json: exports_external.boolean().default(false).describe("Print as JSON")
+  },
+  run: async ({ options: { limit, json: json2 } }) => {
+    const result = await (await backendClient()).query(api2.projects.listPaginated, {
+      paginationOpts: { numItems: limit, cursor: null },
+      today: localToday()
+    });
+    if (json2)
+      return console.log(JSON.stringify(result.page, null, 2));
+    if (result.page.length === 0)
+      return console.log("No projects yet.");
+    printTable([
+      ["NAME", "STATUS", "HEALTH", "PROGRESS", "TARGET", "REPO", "ID"],
+      ...result.page.map((project2) => [
+        project2.name,
+        project2.status,
+        project2.health ?? "-",
+        `${project2.progress.done}/${project2.progress.total}`,
+        project2.targetDate ? `${project2.targetDate}${project2.isOverdue ? " (overdue)" : ""}` : "-",
+        project2.repo ?? "-",
+        project2._id
+      ])
+    ]);
+    if (!result.isDone)
+      console.log(`
+More projects exist; raise --limit past ${limit}.`);
+  }
+});
+
+// src/commands/projects/remove.ts
+var remove3 = command({
+  name: "delete",
+  description: "Delete a project and its milestones (its issues survive, projectless)",
+  positionals: {
+    id: exports_external.string().describe("Project id or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const client3 = await backendClient();
+    const project2 = await resolveProject(client3, id);
+    await client3.mutation(api2.projects.remove, { id: project2._id });
+    console.log(`Deleted ${project2.name}.`);
+  }
+});
+
+// src/commands/projects/set.ts
+var set3 = command({
+  name: "set",
+  description: "Set a project's status, health, target date, or repository",
+  positionals: {
+    id: exports_external.string().describe("Project id or URL")
+  },
+  options: {
+    status: exports_external.enum(PROJECT_STATUSES).optional().describe("New status").meta({ short: "s" }),
+    health: exports_external.enum(PROJECT_HEALTHS).nullable().optional().describe("New health, or --no-health to clear").meta({ negatable: true }),
+    target: exports_external.iso.date().nullable().optional().describe("Target date (YYYY-MM-DD), or --no-target to clear").meta({ negatable: true }),
+    repo: exports_external.string().nullable().optional().describe("Repository to connect (owner/name or any remote URL), or --no-repo to disconnect").meta({ negatable: true })
+  },
+  run: async ({ positionals: { id }, options }) => {
+    const { status: status2, health, target, repo } = options;
+    if (Object.values(options).every((value) => value === undefined))
+      throw new Error("Nothing to set. Pass --status, --health, --target, or --repo.");
+    const client3 = await backendClient();
+    const project2 = await resolveProject(client3, id);
+    if (repo !== undefined)
+      await client3.mutation(api2.projects.setRepo, { id: project2._id, repo: repo ?? undefined });
+    if (status2 !== undefined)
+      await client3.mutation(api2.projects.setStatus, { id: project2._id, status: status2 });
+    if (health !== undefined)
+      await client3.mutation(api2.projects.setHealth, { id: project2._id, health: health ?? undefined });
+    if (target !== undefined)
+      await client3.mutation(api2.projects.setTargetDate, { id: project2._id, targetDate: target ?? undefined });
+    console.log(`Updated ${project2.name}.`);
+  }
+});
+
+// src/commands/projects/update.ts
+var update3 = command({
+  name: "update",
+  description: "Rewrite a project's name, summary, or description",
+  positionals: {
+    id: exports_external.string().describe("Project id or URL")
+  },
+  options: {
+    name: exports_external.string().optional().describe("New name").meta({ short: "n" }),
+    summary: exports_external.string().optional().describe("New one-line summary").meta({ short: "s" }),
+    description: exports_external.string().optional().describe("New markdown description, or - for stdin").meta({ short: "d" })
+  },
+  run: async ({ positionals: { id }, options: { name, summary, description } }) => {
+    if (name === undefined && summary === undefined && description === undefined)
+      throw new Error("Nothing to update. Pass --name, --summary, or --description.");
+    const client3 = await backendClient();
+    const project2 = await resolveProject(client3, id);
+    await client3.mutation(api2.projects.update, {
+      id: project2._id,
+      name,
+      summary,
+      descriptionMarkdown: description === undefined ? undefined : await readTextOption(description)
+    });
+    console.log(`Updated ${name ?? project2.name}.`);
+  }
+});
+
+// src/commands/projects/index.ts
+var projects = group({
+  name: "projects",
+  description: "Manage projects",
+  commands: [create3, list3, get3, update3, set3, remove3]
+});
+
 // src/commands/upgrade.ts
 var upgrade = command({
   name: "upgrade",
@@ -18099,7 +18888,7 @@ var upgrade = command({
 var rootCommand = group({
   name: "kds",
   description: "KDS CLI",
-  commands: [auth, pages, project, upgrade],
+  commands: [auth, issues, pages, project, projects, 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.1.4",
+  "version": "0.2.1",
   "description": "Command-line client for Kai Dev Studio",
   "license": "MIT",
   "publishConfig": {