@lesscap/baton-cli 0.2.3 → 0.2.5

package/dist/baton.mjs

@@ -550,6 +550,7 @@ var requirementClient = (baseUrl) => {
     listByProject: (projectId) => request(u(`/projects/${projectId}/requirements`), { method: "GET" }),
     get: (id) => request(u(`/requirements/${id}`), { method: "GET" }),
     getByCode: (projectId, code) => fetchItemByCode(baseUrl, projectId, code, "requirement"),
+    update: (id, patch2) => request(u(`/requirements/${id}`), { method: "PATCH", body: patch2 }),
     setStatus: (id, status) => request(u(`/requirements/${id}`), { method: "PATCH", body: { status } }),
     remove: (id) => request(u(`/requirements/${id}`), { method: "DELETE" })
   };
@@ -622,6 +623,7 @@ var taskClient = (baseUrl) => {
     listByRequirement: (requirementId) => request(u(`/requirements/${requirementId}/tasks`), { method: "GET" }),
     get: (id) => request(u(`/tasks/${id}`), { method: "GET" }),
     getByCode: (projectId, code) => fetchItemByCode(baseUrl, projectId, code, "task"),
+    update: (id, patch2) => request(u(`/tasks/${id}`), { method: "PATCH", body: patch2 }),
     setStatus: (id, status) => request(u(`/tasks/${id}`), { method: "PATCH", body: { status } }),
     remove: (id) => request(u(`/tasks/${id}`), { method: "DELETE" }),
     listComments: (id) => request(u(`/tasks/${id}/comments`), { method: "GET" }),
@@ -766,7 +768,11 @@ var common = {
   },
   json: { type: "boolean", description: "output JSON" }
 };
-var clientFor = (args) => createClient(resolveBaseUrl(args.url));
+var clientFor = (args) => {
+  const envAuth = process.env.BATON_TOKEN ?? (process.env.BATON_USER && process.env.BATON_PASS);
+  const cfgToken = envAuth ? void 0 : loadProjectConfigOrNull(projectConfigPath())?.worker?.apiToken;
+  return createClient(resolveBaseUrl(args.url), cfgToken ? { bearer: cfgToken } : void 0);
+};
 var resolveProjectId = (args) => {
   if (args.project !== void 0 && args.project !== "") return Number(args.project);
   const cfg = loadProjectConfigOrNull(projectConfigPath());
@@ -781,6 +787,16 @@ var resolveWorkspaceId = (args) => {
     "no workspace in scope. pass --workspace <id> or run `baton init` in this directory."
   );
 };
+var parseWorkerHandle = (handle) => {
+  const m = handle.trim().match(/^(?:[wW]-)?(\d+)$/);
+  return m ? Number(m[1]) : null;
+};
+var parseIssueUrl = (url) => {
+  const m = url.match(/^https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/(\d+)/);
+  if (!m)
+    throw new Error(`expected a GitHub issue url (https://github.com/o/r/issues/N), got "${url}"`);
+  return { source: "github", number: Number(m[1]), url: url.split(/[?#]/)[0] };
+};
 var splitCsv = (s) => s ? s.split(",").map((x) => x.trim()).filter(Boolean) : void 0;
 
 // src/commands/init.ts
@@ -855,7 +871,7 @@ var fmtComment = (c) => `${c.workerId !== void 0 ? `worker#${c.workerId}` : "you
 var fmtSession = (s) => `${s.id}  ${s.name}  ${s.attached ? "[active]" : "[inactive]"}  ${s.worktreePath ?? "(pending)"}`;
 var fmtWorker = (w) => {
   const offline = w.alive === false ? "  [offline]" : "";
-  return `${w.id}  ${w.name}  ${w.hostname}${offline}`;
+  return `W-${w.id}  ${w.name}  ${w.hostname}${offline}`;
 };
 var renderOne = (item, fmt, json) => json ? toJson(item) : fmt(item);
 var renderList = (items, fmt, json) => {
@@ -940,6 +956,7 @@ var project = defineCommand({
 
 // src/commands/requirement.ts
 var createRequirement = (c, input, json) => c.requirements.create(input).then((r) => renderOne(r, fmtRequirement, json));
+var updateRequirement = (c, id, patch2, json) => c.requirements.update(id, patch2).then((r) => renderOne(r, fmtRequirement, json));
 var listRequirements = (c, projectId, json) => c.requirements.listByProject(projectId).then((rs) => renderList(rs, fmtRequirement, json));
 var getRequirement = (c, id, json) => c.requirements.get(id).then((r) => renderOne(r, fmtRequirement, json));
 var setRequirementStatus = (c, id, status, json) => c.requirements.setStatus(id, status).then((r) => renderOne(r, fmtRequirement, json));
@@ -955,6 +972,7 @@ var requirement = defineCommand({
         project: { type: "string", description: "project id (overrides .baton.json)" },
         desc: { type: "string", description: "description" },
         body: { type: "string", description: "requirement body (markdown)" },
+        github: { type: "string", description: "link a GitHub issue url (light association)" },
         ...common
       },
       run: async ({ args }) => {
@@ -965,13 +983,69 @@ var requirement = defineCommand({
               projectId: resolveProjectId(args),
               title: args.title,
               description: args.desc,
-              body: args.body
+              body: args.body,
+              external: args.github ? parseIssueUrl(args.github) : void 0
             },
             Boolean(args.json)
           )
         );
       }
     }),
+    update: defineCommand({
+      meta: { name: "update", description: "update a requirement title / body" },
+      args: {
+        code: { type: "positional", required: true, description: "requirement code (R-N)" },
+        title: { type: "string", description: "new title" },
+        body: { type: "string", description: "new body (markdown)" },
+        project: { type: "string", description: "project id (overrides .baton.json)" },
+        ...common
+      },
+      run: async ({ args }) => {
+        const patch2 = {
+          ...args.title !== void 0 ? { title: args.title } : {},
+          ...args.body !== void 0 ? { body: args.body } : {}
+        };
+        if (Object.keys(patch2).length === 0) throw new Error("pass --title and/or --body");
+        const c = clientFor(args);
+        const id = await resolveByCode(c, resolveProjectId(args), args.code);
+        console.log(await updateRequirement(c, id, patch2, Boolean(args.json)));
+      }
+    }),
+    link: defineCommand({
+      meta: { name: "link", description: "link a requirement to a GitHub issue url" },
+      args: {
+        code: { type: "positional", required: true, description: "requirement code (R-N)" },
+        // Named `issue` (not `url`) — `url` would collide with the common --url flag.
+        issue: { type: "positional", required: true, description: "GitHub issue url" },
+        project: { type: "string", description: "project id (overrides .baton.json)" },
+        ...common
+      },
+      run: async ({ args }) => {
+        const c = clientFor(args);
+        const id = await resolveByCode(c, resolveProjectId(args), args.code);
+        console.log(
+          await updateRequirement(
+            c,
+            id,
+            { external: parseIssueUrl(args.issue) },
+            Boolean(args.json)
+          )
+        );
+      }
+    }),
+    unlink: defineCommand({
+      meta: { name: "unlink", description: "clear a requirement\u2019s GitHub issue association" },
+      args: {
+        code: { type: "positional", required: true, description: "requirement code (R-N)" },
+        project: { type: "string", description: "project id (overrides .baton.json)" },
+        ...common
+      },
+      run: async ({ args }) => {
+        const c = clientFor(args);
+        const id = await resolveByCode(c, resolveProjectId(args), args.code);
+        console.log(await updateRequirement(c, id, { external: null }, Boolean(args.json)));
+      }
+    }),
     ls: defineCommand({
       meta: { name: "ls", description: "list requirements in a project" },
       args: {
@@ -1047,7 +1121,10 @@ var resolveSession = async (client, projectId, handle) => {
 
 // src/commands/session/abort.ts
 var sessionAbortCommand = defineCommand({
-  meta: { name: "abort", description: "interrupt the in-flight turn (like Esc); keeps the session" },
+  meta: {
+    name: "abort",
+    description: "interrupt the in-flight turn (like Esc); keeps the session"
+  },
   args: {
     session: { type: "positional", required: true, description: "session int id or name" },
     project: { type: "string", description: "project id (overrides .baton.json)" },
@@ -1063,7 +1140,10 @@ var sessionAbortCommand = defineCommand({
 
 // src/commands/session/clear.ts
 var sessionClearCommand = defineCommand({
-  meta: { name: "clear", description: "reset the conversation context (keeps the session + worktree)" },
+  meta: {
+    name: "clear",
+    description: "reset the conversation context (keeps the session + worktree)"
+  },
   args: {
     session: { type: "positional", required: true, description: "session int id or name" },
     project: { type: "string", description: "project id (overrides .baton.json)" },
@@ -1082,16 +1162,24 @@ var sessionCreateCommand = defineCommand({
   meta: { name: "create", description: "create + start a session on a worker" },
   args: {
     name: { type: "positional", required: true, description: "session name" },
-    worker: { type: "string", description: "worker id (default: this machine's worker)" },
-    project: { type: "string", description: "project id (overrides .baton.json)" },
+    worker: {
+      type: "string",
+      description: "worker handle: W-N or int id (default: this machine's worker)"
+    },
+    project: {
+      type: "string",
+      description: "project id (default: the worker's own project, else .baton.json)"
+    },
     ...common
   },
   run: async ({ args }) => {
     const c = clientFor(args);
-    const projectId = resolveProjectId(args);
-    const workerId = args.worker ? Number(args.worker) : loadProjectConfigOrNull(projectConfigPath())?.worker?.id;
-    if (!workerId)
-      throw new Error("no worker id \u2014 pass --worker or run `baton worker register` first");
+    const workerId = args.worker ? parseWorkerHandle(args.worker) : loadProjectConfigOrNull(projectConfigPath())?.worker?.id ?? null;
+    if (workerId === null)
+      throw new Error(
+        "no worker \u2014 pass --worker <W-N|id> or run `baton worker register` first (names need --project)"
+      );
+    const projectId = args.project !== void 0 && args.project !== "" ? Number(args.project) : args.worker ? (await c.workers.get(workerId)).projectId : resolveProjectId(args);
     const s = await c.sessions.create({ projectId, workerId, name: args.name });
     console.log(renderOne(s, fmtSession, Boolean(args.json)));
   }
@@ -2222,6 +2310,7 @@ var session = defineCommand({
 
 // src/commands/task.ts
 var createTask = (c, input, json) => c.tasks.create(input).then((t) => renderOne(t, fmtTask, json));
+var updateTask = (c, id, patch2, json) => c.tasks.update(id, patch2).then((t) => renderOne(t, fmtTask, json));
 var listTasks = (c, requirementId, json) => c.tasks.listByRequirement(requirementId).then((ts) => renderList(ts, fmtTask, json));
 var getTask = (c, id, json) => c.tasks.get(id).then((t) => renderOne(t, fmtTask, json));
 var setTaskStatus = (c, id, status, json) => c.tasks.setStatus(id, status).then((t) => renderOne(t, fmtTask, json));
@@ -2241,6 +2330,7 @@ var task = defineCommand({
         project: { type: "string", description: "project id (overrides .baton.json)" },
         body: { type: "string", description: "task body (markdown)" },
         deps: { type: "string", description: "comma-separated dependency task codes (T-N,T-N)" },
+        github: { type: "string", description: "link a GitHub issue url (light association)" },
         ...common
       },
       run: async ({ args }) => {
@@ -2258,13 +2348,64 @@ var task = defineCommand({
               requirementId,
               title: args.title,
               body: args.body,
-              dependsOn: dependsOn.length ? dependsOn : void 0
+              dependsOn: dependsOn.length ? dependsOn : void 0,
+              external: args.github ? parseIssueUrl(args.github) : void 0
             },
             Boolean(args.json)
           )
         );
       }
     }),
+    update: defineCommand({
+      meta: { name: "update", description: "update a task title / body" },
+      args: {
+        code: { type: "positional", required: true, description: "task code (T-N)" },
+        title: { type: "string", description: "new title" },
+        body: { type: "string", description: "new body (markdown)" },
+        project: { type: "string", description: "project id (overrides .baton.json)" },
+        ...common
+      },
+      run: async ({ args }) => {
+        const patch2 = {
+          ...args.title !== void 0 ? { title: args.title } : {},
+          ...args.body !== void 0 ? { body: args.body } : {}
+        };
+        if (Object.keys(patch2).length === 0) throw new Error("pass --title and/or --body");
+        const c = clientFor(args);
+        const id = await resolveTaskByCode(c, resolveProjectId(args), args.code);
+        console.log(await updateTask(c, id, patch2, Boolean(args.json)));
+      }
+    }),
+    link: defineCommand({
+      meta: { name: "link", description: "link a task to a GitHub issue url" },
+      args: {
+        code: { type: "positional", required: true, description: "task code (T-N)" },
+        // Named `issue` (not `url`) — `url` would collide with the common --url flag.
+        issue: { type: "positional", required: true, description: "GitHub issue url" },
+        project: { type: "string", description: "project id (overrides .baton.json)" },
+        ...common
+      },
+      run: async ({ args }) => {
+        const c = clientFor(args);
+        const id = await resolveTaskByCode(c, resolveProjectId(args), args.code);
+        console.log(
+          await updateTask(c, id, { external: parseIssueUrl(args.issue) }, Boolean(args.json))
+        );
+      }
+    }),
+    unlink: defineCommand({
+      meta: { name: "unlink", description: "clear a task\u2019s GitHub issue association" },
+      args: {
+        code: { type: "positional", required: true, description: "task code (T-N)" },
+        project: { type: "string", description: "project id (overrides .baton.json)" },
+        ...common
+      },
+      run: async ({ args }) => {
+        const c = clientFor(args);
+        const id = await resolveTaskByCode(c, resolveProjectId(args), args.code);
+        console.log(await updateTask(c, id, { external: null }, Boolean(args.json)));
+      }
+    }),
     ls: defineCommand({
       meta: { name: "ls", description: "list tasks in a requirement" },
       args: {
@@ -2294,7 +2435,7 @@ var task = defineCommand({
     "set-status": defineCommand({
       meta: {
         name: "set-status",
-        description: "set task status (todo|in_progress|done|failed|cancelled)"
+        description: "set task status (todo|in_progress|blocked|done|failed|cancelled)"
       },
       args: {
         code: { type: "positional", required: true, description: "task code (T-N)" },
@@ -2372,7 +2513,7 @@ import { query as query2 } from "@anthropic-ai/claude-agent-sdk";
 // src/session/runner/title.ts
 var clip = (s, max) => s.length > max ? s.slice(0, max) : s;
 var isDeclined = (title) => title.replace(/[^a-z]/gi, "").toUpperCase() === "NONE";
-var sanitizeTitle = (raw) => raw.replace(/[\r\n]+/g, " ").replace(/["'`]/g, "").replace(/^\s*(title|session)\s*[:-]\s*/i, "").replace(/\s+/g, " ").trim().slice(0, 40).trim();
+var sanitizeTitle = (raw) => raw.replace(/[\r\n]+/g, " ").replace(/[*_`~#>]/g, "").replace(/["']/g, "").replace(/^\s*(?:title|session|标题)\s*[:：-]\s*/i, "").replace(/^\s*(?:[-*•]|\d+[.)、])\s+/, "").replace(/\s+/g, " ").trim().slice(0, 30).replace(/[\s。．，,、；;：:!！?？.]+$/, "").trim();
 var TITLE_TIMEOUT_MS = 3e4;
 var generateTitle = async (input) => {
   const { worktreePath, userText, assistantText, queryFn } = input;
@@ -2381,7 +2522,8 @@ var generateTitle = async (input) => {
     `User: ${clip(userText, 800)}`,
     assistantText ? `Assistant: ${clip(assistantText, 800)}` : ""
   ].filter(Boolean).join("\n");
-  const prompt = `Reply with ONLY a 2-5 word title (no quotes, no punctuation) summarizing this coding session. If it is too short or generic to title meaningfully, reply with exactly NONE:
+  const prompt = `Reply with ONLY a short title for this session: a noun phrase like a filename \u2014 at most 6 words or ~12 Chinese characters. It must NOT be a sentence, no punctuation, no markdown, no quotes, and never an opener like "\u597D\u7684"/"\u6536\u5230"/"I'll". If it is too thin or generic to title meaningfully, reply with exactly NONE.
+
 ${exchange}`;
   const exe = claudeExecutable();
   const abort = new AbortController();
@@ -2392,6 +2534,9 @@ ${exchange}`;
       prompt,
       options: {
         cwd: worktreePath,
+        // Don't load the worktree's CLAUDE.md / project settings — they steer the
+        // model into verbose summaries instead of a terse title.
+        settingSources: [],
         permissionMode: "bypassPermissions",
         allowedTools: [],
         includePartialMessages: false,
@@ -2627,9 +2772,9 @@ var readOrCreateMachineId = (path = machineIdPath()) => {
 
 // src/commands/worker.ts
 var resolveWorker = async (client, projectId, handle) => {
-  const asInt = Number(handle);
-  if (Number.isInteger(asInt) && asInt > 0) {
-    const byId = await client.workers.get(asInt).catch(() => null);
+  const asId = parseWorkerHandle(handle);
+  if (asId !== null) {
+    const byId = await client.workers.get(asId).catch(() => null);
     if (byId) return { id: byId.id, name: byId.name };
   }
   const byName = await client.workers.findByName(projectId, handle);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lesscap/baton-cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "description": "baton CLI — register/run a worker, manage projects/requirements/tasks/sessions",
   "bin": {