@islamihab/kds 0.2.3 → 0.3.0

package/index.js

@@ -14597,7 +14597,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "cli",
-  version: "0.2.3",
+  version: "0.3.0",
   private: true,
   type: "module",
   bin: {
@@ -15153,7 +15153,17 @@ 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_STATUSES = [
+  "backlog",
+  "todo",
+  "in_progress",
+  "ready_for_review",
+  "in_review",
+  "changes_requested",
+  "approved",
+  "done",
+  "canceled"
+];
 var ISSUE_PRIORITIES = ["urgent", "high", "medium", "low", "none"];
 var ISSUE_DISPOSITIONS = [
   "needs_triage",
@@ -15169,6 +15179,15 @@ var ISSUE_CREATE_DISPOSITIONS = [
 ];
 var ISSUE_ESTIMATES = [1, 2, 3, 5, 8];
 var ISSUE_TERMINAL_STATUSES = ["done", "canceled"];
+var ISSUE_OPEN_STATUSES = [
+  "backlog",
+  "todo",
+  "in_progress",
+  "ready_for_review",
+  "in_review",
+  "changes_requested",
+  "approved"
+];
 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"];
@@ -15176,6 +15195,49 @@ 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 BUILT_IN_ISSUE_VIEWS = {
+  all: {
+    layout: "list",
+    groupBy: "status",
+    orderBy: "updated_at",
+    orderDirection: "desc",
+    filters: {}
+  },
+  active: {
+    layout: "list",
+    groupBy: "status",
+    orderBy: "updated_at",
+    orderDirection: "desc",
+    filters: { statuses: [...ISSUE_OPEN_STATUSES] }
+  },
+  agent_queue: {
+    layout: "list",
+    groupBy: "status",
+    orderBy: "updated_at",
+    orderDirection: "desc",
+    filters: {
+      statuses: [...ISSUE_OPEN_STATUSES],
+      dispositions: ["ready_for_agent"]
+    }
+  },
+  triage: {
+    layout: "list",
+    groupBy: "disposition",
+    orderBy: "updated_at",
+    orderDirection: "desc",
+    filters: {
+      statuses: [...ISSUE_OPEN_STATUSES],
+      dispositions: ["needs_triage", "needs_info"]
+    }
+  },
+  dispatch: {
+    layout: "board",
+    groupBy: "none",
+    orderBy: "updated_at",
+    orderDirection: "desc",
+    filters: { statuses: [...ISSUE_OPEN_STATUSES, "done"] }
+  }
+};
 var issueIsOpen = (status) => !ISSUE_TERMINAL_STATUSES.some((terminal) => terminal === status);
 var MAX_PROJECT_REPO_LENGTH = 200;
 
@@ -17981,7 +18043,7 @@ var runInbox = async (options) => {
   const inbox = await client3.query(api2.inbox.list, {});
   const targetLastSeen = new Map(inbox.targetLastSeen.map((state) => [state.targetId, state.lastSeenAt]));
   const events = options.all ? inbox.events : inbox.events.filter((event) => {
-    const targetId = event.type === "issue" ? event.issue.id : event.project.id;
+    const targetId = event.type === "project" ? event.project.id : event.issue.id;
     return event.at > Math.max(inbox.lastSeenAt, targetLastSeen.get(targetId) ?? 0);
   });
   if (options.json)
@@ -18000,8 +18062,8 @@ var runInbox = async (options) => {
     ...events.map((event) => [
       new Date(event.at).toISOString().slice(0, 16).replace("T", " "),
       actorLabel(event.via, event.agent),
-      event.type === "issue" ? event.issue.identifier : event.project.name,
-      event.type === "issue" ? issueActivityLine(event.detail) : projectActivityLine(event.detail)
+      event.type === "project" ? event.project.name : event.issue.identifier,
+      event.type === "project" ? projectActivityLine(event.detail) : event.type === "comment" ? `commented: ${event.excerpt}` : issueActivityLine(event.detail)
     ])
   ]);
   if (inbox.truncated)
@@ -18259,6 +18321,7 @@ var create = command({
     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)"),
+    parent: exports_external.string().optional().describe("Create as a sub-issue of this issue (identifier, number, or URL)"),
     disposition: exports_external.enum(ISSUE_CREATE_DISPOSITIONS).optional().describe("Route immediately (default needs_triage)")
   },
   run: async ({ positionals: { title }, options }) => {
@@ -18269,6 +18332,7 @@ var create = command({
     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 parent = options.parent ? await resolveIssue(client3, options.parent) : undefined;
     const { identifier } = await client3.mutation(api2.issues.create, {
       title,
       descriptionMarkdown: options.description === undefined ? undefined : await readTextOption(options.description),
@@ -18278,12 +18342,24 @@ var create = command({
       dueDate: options.due,
       projectId: project?._id,
       milestoneId: milestone?._id,
+      parentId: parent?._id,
       disposition: options.disposition
     });
     console.log(identifier);
   }
 });
 
+// src/lib/tasks.ts
+var printTasks = (tasks) => {
+  if (tasks.length === 0)
+    return;
+  const width = String(tasks.length).length;
+  console.log(`Tasks: ${tasks.filter((task2) => task2.isDone).length}/${tasks.length}`);
+  for (const [index, task2] of tasks.entries()) {
+    console.log(`  ${String(index + 1).padStart(width)} [${task2.isDone ? "x" : " "}] ${task2.title}`);
+  }
+};
+
 // src/commands/issues/get.ts
 var get = command({
   name: "get",
@@ -18297,13 +18373,14 @@ var get = command({
   run: async ({ positionals: { id }, options: { json: json2 } }) => {
     const client3 = await backendClient();
     const issue2 = await resolveIssue(client3, id);
-    const [feed, relations, attachments] = await Promise.all([
+    const [feed, relations, attachments, tasks] = 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 })
+      client3.query(api2.issueAttachments.list, { issueId: issue2._id }),
+      client3.query(api2.issueTasks.list, { issueId: issue2._id })
     ]);
     if (json2)
-      return console.log(JSON.stringify({ ...issue2, relations, attachments, feed }, null, 2));
+      return console.log(JSON.stringify({ ...issue2, relations, attachments, tasks, 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}`);
@@ -18341,6 +18418,7 @@ var get = command({
         console.log(`  ${attachment.name} \u2014 ${attachment.url ?? "unavailable"}`);
       }
     }
+    printTasks(tasks);
     if (issue2.descriptionMarkdown)
       console.log(`
 ${issue2.descriptionMarkdown}`);
@@ -18549,20 +18627,115 @@ var set2 = command({
 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",
+  description: "Claim implementation work: move unstarted or changes_requested work to in_progress with its branch",
   positionals: {
     id: exports_external.string().describe("Issue identifier, number, or URL")
   },
-  run: async ({ positionals: { id } }) => {
+  options: {
+    ready: exports_external.boolean().default(false).describe("Also route the issue to ready_for_agent")
+  },
+  run: async ({ positionals: { id }, options: { ready } }) => {
     const client3 = await backendClient();
     const issue2 = await resolveIssue(client3, id);
     const { branch } = await client3.mutation(api2.issues.start, { id: issue2._id });
+    if (ready && issue2.disposition !== "ready_for_agent") {
+      await client3.mutation(api2.issues.route, { id: issue2._id, disposition: "ready_for_agent" });
+    }
     console.log(`Started ${issue2.identifier}: in_progress, branch ${branch}`);
+    if (ready) {
+      console.log("Routed to ready_for_agent.");
+    } else if (issue2.disposition !== "ready_for_agent" && await agentClaim()) {
+      console.log(`Note: disposition is ${issue2.disposition}. Pass --ready if this hand-off was intended.`);
+    }
     console.log(`
   git switch -c ${shellArg(branch)}`);
   }
 });
 
+// src/commands/issues/start-review.ts
+var startReview = command({
+  name: "start-review",
+  description: "Claim review work: move a ready_for_review issue to in_review",
+  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.startReview, { id: issue2._id });
+    console.log(`Reviewing ${issue2.identifier}: in_review`);
+  }
+});
+
+// src/commands/issues/submit.ts
+var submit = command({
+  name: "submit",
+  description: "Hand an issue off for review: move in_progress or changes_requested work to ready_for_review",
+  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.submit, { id: issue2._id });
+    console.log(`Submitted ${issue2.identifier}: ready_for_review`);
+  }
+});
+
+// src/commands/issues/tasks.ts
+var position = exports_external.array(exports_external.coerce.number().int().positive());
+var tasks = command({
+  name: "tasks",
+  description: "Show an issue's checklist, or add, tick, promote, and drop its tasks",
+  positionals: {
+    id: exports_external.string().describe("Issue identifier, number, or URL")
+  },
+  options: {
+    add: exports_external.array(exports_external.string()).optional().describe("Add a task (repeatable)").meta({ short: "a" }),
+    check: position.optional().describe("Tick a task by its number (repeatable)"),
+    uncheck: position.optional().describe("Untick a task by its number (repeatable)"),
+    convert: position.optional().describe("Promote a task into its own issue (repeatable)"),
+    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, check: check2, uncheck, convert, remove: remove2, json: json2 } }) => {
+    const client3 = await backendClient();
+    const issue2 = await resolveIssue(client3, id);
+    const before = await client3.query(api2.issueTasks.list, { issueId: issue2._id });
+    const at = (numbered) => (numbered ?? []).map((number4) => {
+      const task2 = before[number4 - 1];
+      if (!task2)
+        throw new Error(`${issue2.identifier} has no task ${number4}.`);
+      return task2;
+    });
+    const ticked = at(check2);
+    const unticked = at(uncheck);
+    const promoted = at(convert);
+    const dropped = at(remove2);
+    for (const title of add ?? [])
+      await client3.mutation(api2.issueTasks.create, { issueId: issue2._id, title });
+    for (const task2 of ticked)
+      await client3.mutation(api2.issueTasks.update, { id: task2._id, isDone: true });
+    for (const task2 of unticked)
+      await client3.mutation(api2.issueTasks.update, { id: task2._id, isDone: false });
+    for (const task2 of promoted) {
+      const created = await client3.mutation(api2.issueTasks.convert, { id: task2._id });
+      if (!json2) {
+        console.log(`${created.identifier} ${created.nested ? "created as a sub-issue" : "created and related"}: ${task2.title}`);
+      }
+    }
+    for (const task2 of dropped)
+      await client3.mutation(api2.issueTasks.remove, { id: task2._id });
+    const wrote = [add, check2, uncheck, convert, remove2].some((values) => values !== undefined);
+    const after = wrote ? await client3.query(api2.issueTasks.list, { issueId: issue2._id }) : before;
+    if (json2)
+      return console.log(JSON.stringify(after, null, 2));
+    if (after.length === 0)
+      return console.log(`${issue2.identifier} has no tasks.`);
+    printTasks(after);
+  }
+});
+
 // src/commands/issues/unrelate.ts
 var relationEntries = (relations, kind) => {
   switch (kind) {
@@ -18633,7 +18806,22 @@ var update = command({
 var issues = group({
   name: "issues",
   description: "Track and triage issues",
-  commands: [create, list, get, update, set2, route, start, relate, unrelate, comment, remove]
+  commands: [
+    create,
+    list,
+    get,
+    update,
+    set2,
+    route,
+    start,
+    submit,
+    startReview,
+    tasks,
+    relate,
+    unrelate,
+    comment,
+    remove
+  ]
 });
 
 // src/lib/group.ts
@@ -19068,6 +19256,9 @@ var rootCommand = group({
   }
 });
 
+// src/lib/errors.ts
+var errorMessage = (error51) => error51 instanceof ConvexError && typeof error51.data === "string" ? error51.data : error51.message;
+
 // src/lib/update-check.ts
 var latestVersion = async () => {
   const cached2 = await Bun.file(CACHE_PATH).json().catch(() => null).then(cacheSchema.safeParse);
@@ -19105,7 +19296,7 @@ try {
   if (args[0] !== "upgrade")
     await maybeNotifyUpdate();
 } catch (error51) {
-  console.error(error51.message);
+  console.error(errorMessage(error51));
   process.exitCode = 1;
 } finally {
   closePrompts();

package/package.json

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