@meterapp/glossa 0.5.0 → 0.6.0

package/README.md

@@ -39,3 +39,12 @@ open the printed URL on any device (`--no-browser` skips opening one). To save
 an existing key instead, run `login --key gls_…`.
 
 In CI set `GLOSSA_API_KEY` (a workspace key, `gls_…`).
+
+### Cancel a background job
+
+`glossa cancel <job-id>` cancels queued or running work. `glossa cancel_job --job <job-id>`
+is the equivalent registry op. Completed translations remain in place, and repeated
+cancellation is safe. An in-flight model request may finish; translation workers
+check cancellation before storing its results or beginning the next batch.
+Use `glossa get_job --job <job-id>` to inspect progress and final status, or
+`glossa list_jobs --status cancelled` to list cancelled jobs.

package/bin/glossa.mjs

@@ -9,7 +9,7 @@ import { dirname, join, relative, resolve } from "node:path";
 import { createInterface } from "node:readline";
 import { brotliCompressSync, brotliDecompressSync, constants as zlib } from "node:zlib";
 
-const VERSION = "0.5.0";
+const VERSION = "0.6.0";
 const DEFAULT_HOST = "https://getglossa.dev";
 const CONFIG_PATH = join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "glossa", "config.json");
 /** The last failed call, so `glossa feedback report --last` can attach it. */
@@ -495,6 +495,14 @@ async function fill(positional, flags) {
   if (totals.rejected.length) process.exitCode = 1;
 }
 
+export function cancelJobInput(positional, flags) {
+  const job = positional[0] ?? flags.job;
+  if (positional.length > 1 || typeof job !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(job)) {
+    throw new Error("Usage: glossa cancel <job-id> (or --job <job-id>)");
+  }
+  return { job };
+}
+
 async function tasks(flags) {
   const { tasks: list, total } = await call("list_tasks", coerceFlags(flags, { properties: { limit: { type: "integer" }, kind: { type: "string" }, status: { type: "string" } } }));
   if (flags.json || !isTTY) return print({ total, tasks: list }, flags);
@@ -717,6 +725,7 @@ ${bold("Usage")}
                                             their keys and file paths, for an agent
   glossa fill <file.json|->                 write translations: [{"unit","locale","text"}]
                                             [--status reviewed|needs_review] [--overwrite missing|machine|all]
+  glossa cancel <job-id>                   cancel queued or running work; keeps completed translations
   glossa tasks [--kind k] [--limit n]       the review queue
   glossa mcp                                stdio MCP bridge to the hosted server
   glossa pricing [--json]                   plans, prices and limits (no key needed)
@@ -767,6 +776,8 @@ async function main() {
       return missing(flags);
     case "fill":
       return fill(positional, flags);
+    case "cancel":
+      return print(await call("cancel_job", cancelJobInput(positional, flags)), flags);
     case "tasks":
       return tasks(flags);
     case "mcp":

package/bin/glossa.test.mjs

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { coerceFlags, deviceLogin, feedbackCall, fileBody, fileText, parseArgs, readJsonArg, fillBatches, pricingLines, reportInput, reviewInput, subscribeInput } from "./glossa.mjs";
+import { cancelJobInput, coerceFlags, deviceLogin, feedbackCall, fileBody, fileText, parseArgs, readJsonArg, fillBatches, pricingLines, reportInput, reviewInput, subscribeInput } from "./glossa.mjs";
 import { pricingDocument } from "../../../lib/billing/pricing";
 
 describe("cli args", () => {
@@ -147,3 +147,15 @@ describe("feedback", () => {
     expect(() => reviewInput({})).toThrow(/rate 1 to 5/);
   });
 });
+
+
+describe("cancel", () => {
+  const job = "bcae2e7c-cbc6-466b-8d97-c21ac165d099";
+  it("accepts one job id as a positional or flag", () => {
+    expect(cancelJobInput([job], {})).toEqual({ job });
+    expect(cancelJobInput([], { job })).toEqual({ job });
+  });
+  it("rejects missing, malformed or extra ids", () => {
+    for (const ids of [[], ["invalid"], [job, job]]) expect(() => cancelJobInput(ids, {})).toThrow(/Usage/);
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meterapp/glossa",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Glossa CLI: push and pull translation files, run the AI review queue, and every other Glossa op from your terminal or CI. Includes a stdio MCP bridge.",
   "type": "module",
   "bin": { "glossa": "bin/glossa.mjs" },