tines 0.0.111 → 0.0.113

package/dist/index.js

@@ -3408,6 +3408,17 @@ function actorLabel(actor) {
   }
   return actor.api_key_name ? `${actor.user_name} via ${actor.api_key_name}` : actor.user_name;
 }
+var LABEL_COLORS = [
+  "slate",
+  "red",
+  "orange",
+  "amber",
+  "green",
+  "teal",
+  "blue",
+  "violet",
+  "pink"
+];
 var PROMPT_MAX_BYTES = 32 * 1024;
 var SKILL_MAX_TOTAL_BYTES = 100 * 1024;
 var AGENT_GUIDELINES_NAME = "agent-guidelines";
@@ -3590,6 +3601,11 @@ var DESCRIBERS = {
   "issue.comment_deleted": () => [text("deleted a comment on"), selfRef()],
   "issue.link_added": linkSegments,
   "issue.link_removed": linkSegments,
+  "issue.labeled": (_ev, p) => [text("labeled"), selfRef(), name(p.name)],
+  "issue.unlabeled": (_ev, p) => [text("removed label"), name(p.name), text("from"), selfRef()],
+  "label.created": (ev, p) => [text(`${action(ev.type)} label`), name(p.name)],
+  "label.updated": (ev, p) => [text(`${action(ev.type)} label`), name(p.name)],
+  "label.deleted": (ev, p) => [text(`${action(ev.type)} label`), name(p.name)],
   "issue.parked": (_ev, p) => [
     text("parked"),
     selfRef(),
@@ -3712,7 +3728,9 @@ var ApiError = class extends Error {
 function query(params) {
   const search = new URLSearchParams();
   for (const [key, value] of Object.entries(params)) {
-    if (value !== void 0 && value !== "" && value !== null) search.set(key, String(value));
+    if (value === void 0 || value === "" || value === null) continue;
+    if (Array.isArray(value)) for (const v of value) search.append(key, String(v));
+    else search.set(key, String(value));
   }
   const s = search.toString();
   return s ? `?${s}` : "";
@@ -3776,6 +3794,12 @@ function createApiClient(options) {
     deleteWorkflow: (id, body) => request("DELETE", `/api/v1/workflows/${id}`, body),
     // Issues
     listIssues: (filters = {}) => get(`/api/v1/issues${query(filters)}`),
+    listLabels: () => get("/api/v1/labels"),
+    createLabel: (body) => request("POST", "/api/v1/labels", body),
+    updateLabel: (labelRef, body) => request("PATCH", `/api/v1/labels/${encodeURIComponent(labelRef)}`, body),
+    deleteLabel: (labelRef) => request("DELETE", `/api/v1/labels/${encodeURIComponent(labelRef)}`),
+    addIssueLabels: (issueId, labels) => request("POST", `/api/v1/issues/${issueId}/labels`, { labels }),
+    removeIssueLabel: (issueId, labelRef) => request("DELETE", `/api/v1/issues/${issueId}/labels/${encodeURIComponent(labelRef)}`),
     listProjectIssues: (projectId, filters = {}) => get(`/api/v1/projects/${projectId}/issues${query(filters)}`),
     createIssue: (projectId, body) => request("POST", `/api/v1/projects/${projectId}/issues`, body),
     getIssue: (id) => get(`/api/v1/issues/${id}`),
@@ -4764,6 +4788,9 @@ function printIssueDetail(issue) {
       `own state: ${issue.state.name} (${issue.state.category}) \u2014 dormant while this is a duplicate`
     );
   }
+  if (issue.labels.length > 0) {
+    console.log(`labels: ${issue.labels.map((l) => l.name).join(", ")}`);
+  }
   console.log(`id: ${issue.id}`);
   printIssueLinks(issue.links);
   if (issue.description) {
@@ -4850,7 +4877,7 @@ function register2(program3) {
     issues.command("list").description("List issues across projects (hides done issues unless --all)").option("-p, --project <name>", "filter by project name or id").option("-s, --state <name>", "filter by state name or id").option("-c, --category <cat>", "filter by state category").option("-w, --workflow <id-or-name>", "filter by workflow").option("-a, --all", "include issues in done states").option(
       "--ready",
       "only issues that are actionable now (not done, not a duplicate, no open blockers)"
-    ).option("-q, --search <text>", "search titles and descriptions").option("--brief", "omit description bodies (saves tokens when scanning)")
+    ).option("-q, --search <text>", "search titles and descriptions").option("-l, --label <name>", "filter by label; repeat to require all of them", collect, []).option("--brief", "omit description bodies (saves tokens when scanning)")
   ).action(
     async (opts) => {
       const api = client(opts);
@@ -4864,6 +4891,7 @@ function register2(program3) {
           hide_done: !opts.all,
           ready: opts.ready,
           q: opts.search,
+          label: opts.label,
           // The table below never prints descriptions, so --brief only
           // ever changes --json; it is off by default so existing
           // consumers of the JSON keep the field.
@@ -4883,7 +4911,11 @@ function register2(program3) {
             i.effective_state.name,
             i.effective_state.category,
             timestamp(i.last_activity_at),
-            [i.open_blockers.length > 0 ? "blocked" : "", i.duplicate_of ? "dup" : ""].filter(Boolean).join(" ")
+            [
+              i.open_blockers.length > 0 ? "blocked" : "",
+              i.duplicate_of ? "dup" : "",
+              ...i.labels.map((l) => `[${l.name}]`)
+            ].filter(Boolean).join(" ")
           ])
         ]);
       });
@@ -4902,7 +4934,12 @@ function register2(program3) {
     ).option(
       "--at <when>",
       "preset time of day HH:MM (default 09:00); for hourly, the minute past the hour :MM (default :00)"
-    ).option("--on <when>", "weekday (weekly) or day of month (monthly)").option("--cron <expr>", "5-field cron expression (alternative to --every/--at/--on)").option("--tz <iana>", "schedule timezone (defaults to the system timezone)").option("--if-closed", "only create a new instance when all previous instances are closed").option("--schedule-name <name>", "schedule name, unique per project (defaults to the title)")
+    ).option("--on <when>", "weekday (weekly) or day of month (monthly)").option("--cron <expr>", "5-field cron expression (alternative to --every/--at/--on)").option("--tz <iana>", "schedule timezone (defaults to the system timezone)").option("--if-closed", "only create a new instance when all previous instances are closed").option("--schedule-name <name>", "schedule name, unique per project (defaults to the title)").option(
+      "-l, --label <name>",
+      "attach a label; repeat for several (created if new)",
+      collect,
+      []
+    )
   ).action(
     async (projectRef, opts) => {
       const description = opts.description !== void 0 ? readBodyValue(opts.description) : void 0;
@@ -4924,11 +4961,12 @@ function register2(program3) {
         description,
         workflow_id: workflowId,
         state: opts.state,
-        schedule
+        schedule,
+        labels: opts.label
       });
       if (opts.json) return printJson(issue);
       console.log(
-        `created ${issue.project_name}/#${issue.number} "${issue.title}" in state "${issue.state.name}"`
+        `created ${issue.project_name}/#${issue.number} "${issue.title}" in state "${issue.state.name}"` + (issue.labels.length > 0 ? ` labeled ${issue.labels.map((l) => l.name).join(", ")}` : "")
       );
       if (issue.schedule) {
         console.log(
@@ -5021,6 +5059,47 @@ function register2(program3) {
     if (opts.json) return printJson({ id: commentId, deleted: true });
     console.log(`deleted comment ${commentId} from ${issue.project_name}/#${issue.number}`);
   });
+  withCommon(
+    issues.command("label <ref> <name...>").description("Add labels to an issue (a label that does not exist yet is created)")
+  ).action(async (ref, names, opts) => {
+    const api = client(opts);
+    const issue = await resolveIssue(api, ref);
+    const res = await api.addIssueLabels(issue.id, names);
+    if (opts.json) return printJson(res);
+    const target = `${issue.project_name}/#${issue.number}`;
+    if (res.added.length === 0) {
+      console.log(`${target} already had ${names.join(", ")} \u2014 nothing to do`);
+    } else {
+      console.log(`labeled ${target}: ${res.added.map((l) => l.name).join(", ")}`);
+    }
+    if (res.created.length > 0) {
+      console.log(
+        `created new label${res.created.length > 1 ? "s" : ""} ${res.created.map((l) => l.name).join(", ")}`
+      );
+    }
+  });
+  withCommon(
+    issues.command("unlabel <ref> <name...>").description("Remove labels from an issue")
+  ).action(async (ref, names, opts) => {
+    const api = client(opts);
+    const issue = await resolveIssue(api, ref);
+    const removed = [];
+    const missing = [];
+    for (const name2 of names) {
+      try {
+        await api.removeIssueLabel(issue.id, name2);
+        removed.push(name2);
+      } catch (err) {
+        if (err instanceof ApiError && err.status === 404) missing.push(name2);
+        else throw err;
+      }
+    }
+    if (opts.json) return printJson({ removed, missing });
+    const target = `${issue.project_name}/#${issue.number}`;
+    if (removed.length > 0) console.log(`unlabeled ${target}: ${removed.join(", ")}`);
+    if (missing.length > 0) console.log(`not on ${target}: ${missing.join(", ")}`);
+    if (removed.length === 0 && missing.length === 0) console.log("nothing to do");
+  });
   withCommon(
     issues.command("block <blocker> <blocked>").description("Record that <blocker> blocks <blocked> (advisory: transitions stay allowed)")
   ).action(async (blockerRef, blockedRef, opts) => {
@@ -5548,6 +5627,79 @@ start one: tines journal append ${issue.project_name}/${issue.number} "- <date>:
   );
 }
 
+// src/commands/labels.ts
+import { createInterface } from "node:readline/promises";
+function parseLabelColor(value) {
+  if (value === void 0) return void 0;
+  if (!LABEL_COLORS.includes(value)) {
+    die(`unknown color "${value}" \u2014 pick one of: ${LABEL_COLORS.join(", ")}`);
+  }
+  return value;
+}
+function register4(program3) {
+  const labels = program3.command("labels").description("Manage the label library");
+  withCommon(
+    labels.command("list").description("List labels with how many issues carry each")
+  ).action(async (opts) => {
+    const res = await client(opts).listLabels();
+    if (opts.json) return printJson(res);
+    if (res.items.length === 0) return console.log("no labels");
+    table([
+      ["NAME", "COLOR", "ISSUES", "DESCRIPTION"],
+      ...res.items.map((l) => [l.name, l.color, String(l.issue_count), l.description])
+    ]);
+  });
+  withCommon(
+    labels.command("create <name>").description("Create a label").option(
+      "--color <key>",
+      `chip color (${LABEL_COLORS.join(", ")}); defaults to one derived from the name`
+    ).option("-d, --description <text>", "what the label means")
+  ).action(async (name2, opts) => {
+    const color = parseLabelColor(opts.color);
+    const label = await client(opts).createLabel({ name: name2, color, description: opts.description });
+    if (opts.json) return printJson(label);
+    console.log(`created label "${label.name}" (${label.color})`);
+  });
+  withCommon(
+    labels.command("edit <name>").description("Rename or restyle a label").option("--name <new>", "new name").option("--color <key>", `chip color (${LABEL_COLORS.join(", ")})`).option("-d, --description <text>", "what the label means")
+  ).action(
+    async (name2, opts) => {
+      if (opts.name === void 0 && opts.color === void 0 && opts.description === void 0) {
+        die("nothing to change: pass --name, --color, or --description");
+      }
+      const label = await client(opts).updateLabel(name2, {
+        name: opts.name,
+        color: parseLabelColor(opts.color),
+        description: opts.description
+      });
+      if (opts.json) return printJson(label);
+      console.log(`updated label "${label.name}" (${label.color})`);
+    }
+  );
+  withCommon(
+    labels.command("delete <name>").description("Delete a label and detach it from every issue").option("-y, --yes", "skip the confirmation")
+  ).action(async (name2, opts) => {
+    const api = client(opts);
+    if (!opts.yes) {
+      const existing = (await api.listLabels()).items.find(
+        (l) => l.name.toLowerCase() === name2.toLowerCase() || l.id === name2
+      );
+      if (!existing) die(`no such label: ${name2}`);
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      const answer = await rl.question(
+        `Delete label "${existing.name}"? It is on ${existing.issue_count} issue${existing.issue_count === 1 ? "" : "s"}. [y/N] `
+      );
+      rl.close();
+      if (!/^y(es)?$/i.test(answer.trim())) die("aborted");
+    }
+    const res = await api.deleteLabel(name2);
+    if (opts.json) return printJson(res);
+    console.log(
+      `deleted label "${name2}" (was on ${res.issue_count} issue${res.issue_count === 1 ? "" : "s"})`
+    );
+  });
+}
+
 // src/commands/login.ts
 import { readFileSync as readFileSync5 } from "node:fs";
 function maskKey(key) {
@@ -5559,7 +5711,7 @@ function readKeyArg(value) {
   if (!key) die("no API key on stdin");
   return key;
 }
-function register4(program3) {
+function register5(program3) {
   program3.command("login").description("Store the API URL and key for this machine, so commands need no env vars").option("-u, --url <url>", `base URL of the Tines API to store (default ${DEFAULT_URL})`).option("--api-key <key>", 'API key from Settings \u2192 API keys ("-" reads it from stdin)').option("--no-verify", "store without checking the key against the API").action(async (opts) => {
     if (!opts.url && !opts.apiKey) die("pass --url and/or --api-key");
     const dir = defaultConfigDir();
@@ -5650,7 +5802,7 @@ function registerEvents(program3) {
 }
 
 // src/commands/projects.ts
-function register5(program3) {
+function register6(program3) {
   const projects = program3.command("projects").description("Manage projects");
   withList(projects.command("list").description("List projects")).action(async (opts) => {
     const api = client(opts);
@@ -5744,7 +5896,7 @@ async function resolveRoutingScope(api, opts) {
   if (opts.state) parts.push(`state ${opts.state}`);
   return { projectId, stateId, label: parts.length > 0 ? parts.join(" \xB7 ") : "global" };
 }
-function register6(program3) {
+function register7(program3) {
   const routing = program3.command("routing").description(
     "Scoped routing rules: which runner takes which issues (most specific scope wins)"
   );
@@ -6869,7 +7021,7 @@ function printTierTable(runner) {
     );
   }
 }
-function register7(program3) {
+function register8(program3) {
   const runners = program3.command("runners").description("Manage the runner registry");
   withCommon(runners.command("list").description("List runners")).action(
     async (opts) => {
@@ -7273,7 +7425,7 @@ function register7(program3) {
 }
 
 // src/commands/schedules.ts
-import { createInterface } from "node:readline/promises";
+import { createInterface as createInterface2 } from "node:readline/promises";
 async function resolveSchedule(api, ref) {
   const { project, name: name2 } = parseScheduleRef(ref);
   const proj = await resolveProject(api, project);
@@ -7302,7 +7454,7 @@ title template: ${s.title_template}`);
     for (const line of s.description_template.split("\n")) console.log(`  ${line}`);
   }
 }
-function register8(program3) {
+function register9(program3) {
   const schedules = program3.command("schedules").description("Manage scheduled tasks (addressed as <project>/<name>)");
   withList(
     schedules.command("list").description("List scheduled tasks (hides paused schedules unless --all)").option("-p, --project <name>", "filter by project name or id").option("-a, --all", "include paused schedules")
@@ -7437,7 +7589,7 @@ recent instances:`);
     const api = client(opts);
     const schedule = await resolveSchedule(api, ref);
     if (!opts.yes) {
-      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      const rl = createInterface2({ input: process.stdin, output: process.stdout });
       const answer = await rl.question(
         `Delete schedule "${scheduleRef(schedule)}"? Its ${schedule.run_count} existing issue${schedule.run_count === 1 ? "" : "s"} will be kept. [y/N] `
       );
@@ -7450,7 +7602,7 @@ recent instances:`);
 }
 
 // src/commands/supervisor.ts
-function register9(program3) {
+function register10(program3) {
   const supervisor = program3.command("supervisor").description("The automation kill switch, quota policy, and attempt limit");
   withCommon(
     supervisor.command("status").description("One-screen overview: kill switch, quota, utilization, runners")
@@ -7645,7 +7797,7 @@ function printWorkflowDetail(wf) {
   for (const w of wf.warnings ?? []) console.log(`
 warning: ${w}`);
 }
-function register10(program3) {
+function register11(program3) {
   const workflows = program3.command("workflows").description("Manage the workflow library");
   withList(workflows.command("list").description("List the workflow library")).action(
     async (opts) => {
@@ -7730,16 +7882,17 @@ see \`tines workflows create --help\` for the expected shape`
 var program2 = new Command();
 program2.name("tines").description("CLI for Tines").version(cliVersion()).enablePositionalOptions();
 registerTime(program2);
-register4(program2);
 register5(program2);
-register10(program2);
+register6(program2);
+register11(program2);
 register2(program2);
+register4(program2);
 register(program2);
 register3(program2);
+register9(program2);
 register8(program2);
 register7(program2);
-register6(program2);
-register9(program2);
+register10(program2);
 registerEvents(program2);
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.111",
+  "version": "0.0.113",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",