@rse/ase 0.0.48 → 0.0.50

package/dst/ase-config.js

@@ -336,10 +336,7 @@ export class Config {
                     doc.deleteIn(segs);
                     progressed = true;
                 }
-                else
-                    /*  root-level issue cannot be deleted; skip it and process
-                        remaining issues so progressed is tracked correctly  */
-                    continue;
+                /*  root-level issues cannot be deleted; processing continues with the remaining issues  */
             }
             if (!progressed)
                 return;

package/dst/ase-diagram.js

@@ -278,9 +278,9 @@ export class DiagramMCP {
                 "Use for visualizing " +
                 "structure/layout/components/dependencies as a Flowchart, " +
                 "control-flow/branching/concurrency as a Flowchart, " +
-                "state-machine/states/transitions as an UML State Diagram, " +
-                "data-flow/actors/messages/protocols as an UML Sequence Diagram, " +
-                "data-structure/classes/methods as an UML Class Diagram, " +
+                "state-machine/states/transitions as a UML State Diagram, " +
+                "data-flow/actors/messages/protocols as a UML Sequence Diagram, " +
+                "data-structure/classes/methods as a UML Class Diagram, " +
                 "data-model/entities/relationships as an ER Diagram, or " +
                 "metrics/distributions/time-series as an XY-Chart. " +
                 "Pass the Mermaid diagram specification as `diagram`. " +

package/dst/ase-getopt.js

@@ -108,9 +108,9 @@ export class GetoptMCP {
                         }
                         ranges.push({ start, end: i });
                     }
-                    const tail = cmd.args.length;
-                    if (tail > 0 && ranges.length >= tail) {
-                        const first = ranges[ranges.length - tail].start;
+                    const consumed = argsVec.length - cmd.args.length;
+                    if (cmd.args.length > 0 && consumed >= 0 && consumed < ranges.length) {
+                        const first = ranges[consumed].start;
                         argsVerbatim = argsRaw.slice(first);
                     }
                 }

package/dst/ase-hook.js

@@ -8,6 +8,7 @@ import fs from "node:fs";
 import os from "node:os";
 import { execaSync } from "execa";
 import { quote } from "shell-quote";
+import * as v from "valibot";
 import Version from "./ase-version.js";
 import { Config, configSchema, parseScope } from "./ase-config.js";
 const toolSpecs = {
@@ -36,10 +37,36 @@ export default class HookCommand {
     constructor(log) {
         this.log = log;
     }
+    /*  validate a session id against the accepted character set  */
+    isValidSessionId(id) {
+        return /^[A-Za-z0-9._-]+$/.test(id);
+    }
+    /*  best-effort JSON parse with valibot schema validation: returns
+        an empty object on blank input, malformed JSON, or schema
+        mismatch, so callers can treat the result uniformly. Extra
+        properties in the data are tolerated; only the declared schema
+        entries are required to match.  */
+    parseJSON(text, schema) {
+        const empty = {};
+        if (text.trim() === "")
+            return empty;
+        let raw;
+        try {
+            raw = JSON.parse(text);
+        }
+        catch (_e) {
+            /*  best-effort: return empty object on malformed JSON  */
+            return empty;
+        }
+        const result = v.safeParse(schema, raw);
+        if (!result.success)
+            return empty;
+        return result.output;
+    }
     /*  recursively expand "@<path>" file references in a Markdown text,
         resolving paths relative to the directory of the containing file  */
     expandReferences(text, baseDir, visited = new Set()) {
-        return text.replace(/@([^\s]+)/g, (match, ref) => {
+        return text.replace(/@(\S+)/g, (match, ref) => {
             let resolved = ref;
             if (resolved.startsWith("~/"))
                 resolved = path.join(process.env.HOME ?? "", resolved.slice(2));
@@ -71,10 +98,23 @@ export default class HookCommand {
         const filePkg = path.join(pluginRoot, ".claude-plugin", "plugin.json");
         const fileMd = path.join(pluginRoot, "meta", "ase-constitution.md");
         /*  read external files  */
-        const pkg = fs.readFileSync(filePkg, "utf8");
-        let md = fs.readFileSync(fileMd, "utf8");
+        let pkg;
+        let md;
+        try {
+            pkg = fs.readFileSync(filePkg, "utf8");
+        }
+        catch (_e) {
+            throw new Error(`failed to read plugin manifest: ${filePkg}`);
+        }
+        try {
+            md = fs.readFileSync(fileMd, "utf8");
+        }
+        catch (_e) {
+            throw new Error(`failed to read constitution file: ${fileMd}`);
+        }
         /*  determine own version  */
-        const versionCurrentPlugin = JSON.parse(pkg).version ?? "";
+        const pkgObj = this.parseJSON(pkg, v.object({ version: v.optional(v.string()) }));
+        const versionCurrentPlugin = pkgObj.version ?? "";
         const versionCurrentTool = Version.current();
         const versionLatestTool = await Version.latest();
         /*  sanity check situation  */
@@ -90,11 +130,15 @@ export default class HookCommand {
         /*  read session information (Claude Code uses snake_case fields,
             Copilot CLI uses camelCase fields)  */
         const stdin = fs.readFileSync(0, "utf8");
-        const input = stdin.trim() !== "" ? JSON.parse(stdin) : {};
+        const input = this.parseJSON(stdin, v.object({
+            session_id: v.optional(v.string()),
+            sessionId: v.optional(v.string()),
+            cwd: v.optional(v.string())
+        }));
         /*  determine session id  */
-        const sessionId = input.session_id ?? input.sessionId ?? "";
+        const sessionId = this.pickSessionId(input);
         /*  establish config context (session-scoped only if a valid sessionId is present)  */
-        const hasSession = /^[A-Za-z0-9._-]+$/.test(sessionId);
+        const hasSession = this.isValidSessionId(sessionId);
         const cfg = new Config("config", configSchema, this.log, hasSession ? parseScope(`session:${sessionId}`) : parseScope(undefined));
         cfg.lock(() => {
             cfg.read();
@@ -103,6 +147,7 @@ export default class HookCommand {
         const taskId = process.env.ASE_TASK_ID ?? "default";
         if (hasSession)
             cfg.lock(() => {
+                cfg.read();
                 cfg.set("agent.task", taskId);
                 cfg.write();
             });
@@ -198,10 +243,8 @@ export default class HookCommand {
         this.writeAgentStatus("ready");
         /*  safety net: clear any lingering "agent.skill" marker so a
             crashed or aborted skill loop does not leave information active  */
-        const stdin = fs.readFileSync(0, "utf8");
-        const input = stdin.trim() !== "" ? JSON.parse(stdin) : {};
-        const sessionId = input.session_id ?? input.sessionId ?? "";
-        if (/^[A-Za-z0-9._-]+$/.test(sessionId)) {
+        const sessionId = this.readSessionIdFromStdin();
+        if (this.isValidSessionId(sessionId)) {
             try {
                 const cfg = new Config("config", configSchema, this.log, parseScope(`session:${sessionId}`));
                 cfg.lock(() => {
@@ -220,14 +263,10 @@ export default class HookCommand {
     }
     /*  handler for "ase hook session-end" (both tools)  */
     doSessionEnd(_tool) {
-        /*  read session information (Claude Code uses snake_case fields,
-            Copilot CLI uses camelCase fields)  */
-        const stdin = fs.readFileSync(0, "utf8");
-        const input = stdin.trim() !== "" ? JSON.parse(stdin) : {};
         /*  determine session id  */
-        const sessionId = input.session_id ?? input.sessionId ?? "";
+        const sessionId = this.readSessionIdFromStdin();
         /*  remove the session directory ~/.ase/session/<id> (only for a valid sessionId)  */
-        if (/^[A-Za-z0-9._-]+$/.test(sessionId)) {
+        if (this.isValidSessionId(sessionId)) {
             const dir = path.join(os.homedir(), ".ase", "session", sessionId);
             try {
                 fs.rmSync(dir, { recursive: true, force: true });
@@ -238,18 +277,32 @@ export default class HookCommand {
         }
         return 0;
     }
+    /*  pick the session id from a parsed payload (Claude Code uses
+        snake_case fields, Copilot CLI uses camelCase fields)  */
+    pickSessionId(input) {
+        return input.session_id ?? input.sessionId ?? "";
+    }
+    /*  read session id from stdin JSON payload  */
+    readSessionIdFromStdin() {
+        const stdin = fs.readFileSync(0, "utf8");
+        const input = this.parseJSON(stdin, v.object({
+            session_id: v.optional(v.string()),
+            sessionId: v.optional(v.string())
+        }));
+        return this.pickSessionId(input);
+    }
     /*  read the session-scoped "agent.skill" config value  */
     readActiveSkill(sessionId) {
-        if (!/^[A-Za-z0-9._-]+$/.test(sessionId))
+        if (!this.isValidSessionId(sessionId))
             return "";
         try {
             const cfg = new Config("config", configSchema, this.log, parseScope(`session:${sessionId}`));
             let val = "";
             cfg.lock(() => {
                 cfg.read();
-                const v = cfg.get("agent.skill");
-                if (typeof v === "string")
-                    val = v;
+                const skill = cfg.get("agent.skill");
+                if (typeof skill === "string")
+                    val = skill;
             });
             return val;
         }
@@ -262,21 +315,21 @@ export default class HookCommand {
         const spec = toolSpecs[tool];
         /*  read tool invocation information  */
         const stdin = fs.readFileSync(0, "utf8");
-        const input = stdin.trim() !== "" ? JSON.parse(stdin) : {};
+        const input = this.parseJSON(stdin, v.looseObject({
+            session_id: v.optional(v.string()),
+            sessionId: v.optional(v.string())
+        }));
         /*  determine whether to auto-approve the tool invocation
             (field names and value shapes differ between tools)  */
         const toolName = typeof input[spec.toolNameField] === "string" ?
             input[spec.toolNameField] : "";
         let toolInput = {};
         const rawInput = input[spec.toolInputField];
-        if (spec.toolInputIsString && typeof rawInput === "string") {
-            try {
-                toolInput = JSON.parse(rawInput);
-            }
-            catch (_e) {
-                /*  best-effort: leave toolInput empty on parse failure  */
-            }
-        }
+        if (spec.toolInputIsString && typeof rawInput === "string")
+            toolInput = this.parseJSON(rawInput, v.object({
+                command: v.optional(v.string()),
+                skill: v.optional(v.string())
+            }));
         else if (!spec.toolInputIsString && typeof rawInput === "object" && rawInput !== null)
             toolInput = rawInput;
         let approve = false;
@@ -294,9 +347,9 @@ export default class HookCommand {
             reason = "ASE MCP tool invocation auto-approved";
         }
         else if (toolName === "Edit") {
-            const sessionId = input.session_id ?? input.sessionId ?? "";
+            const sessionId = this.pickSessionId(input);
             const activeSkill = this.readActiveSkill(sessionId);
-            if (activeSkill === "ase-docs-proofread") {
+            if (activeSkill === "ase-docs-proofread" || activeSkill === "ase-code-lint") {
                 approve = true;
                 reason = `${activeSkill}: user already consented via AskUserQuestion`;
             }
@@ -329,7 +382,7 @@ export default class HookCommand {
     register(program) {
         /*  default for --tool derived from ASE_TOOL environment variable  */
         const envTool = process.env.ASE_TOOL ?? "";
-        const toolDflt = envTool !== "" ? envTool : "claude";
+        const toolDflt = envTool !== "" ? this.parseTool(envTool) : "claude";
         /*  register CLI top-level command "ase hook"  */
         const hookCmd = program
             .command("hook")

package/dst/ase-mcp.js

@@ -26,9 +26,9 @@ export default class MCPCommand {
         const projectId = rawId ?? path.basename(process.cwd());
         const rawPort = svc.get("port");
         const port = rawPort ?? null;
-        return { projectId, port, svc };
+        return { projectId, port };
     }
-    /*  spawn "ase service start" detached and wait for it to come up  */
+    /*  run "ase service start" and wait for the service to come up  */
     async ensureService() {
         let ctx = this.loadContext();
         /*  fast path: already running  */
@@ -52,6 +52,10 @@ export default class MCPCommand {
             throw new Error(`mcp: service not responding on port ${ctx.port} after start`);
         return { projectId: ctx.projectId, port: ctx.port };
     }
+    /*  coerce an unknown thrown value into an Error  */
+    asError(e) {
+        return e instanceof Error ? e : new Error(String(e));
+    }
     /*  bridge stdio to a Streamable HTTP MCP endpoint on the local service  */
     async runBridge() {
         /*  ensure the service is running  */
@@ -60,8 +64,9 @@ export default class MCPCommand {
         const server = new StdioServerTransport();
         /*  track active client and bridge-level closed state  */
         let client = null;
-        let closedByUs = false; /* set when we initiated the client close */
-        let bridgeDone = false; /* set when stdio side closes             */
+        let closedByUs = false; /*  set when we initiated the client close  */
+        let bridgeDone = false; /*  set when stdio side closes              */
+        let reconnecting = false; /*  set while a reconnect chain is active   */
         /*  cleanly shut down the whole bridge  */
         const shutdown = async () => {
             if (bridgeDone)
@@ -79,11 +84,9 @@ export default class MCPCommand {
         const connectClient = async () => {
             const url = new URL(`http://${HOST}:${port}/mcp`);
             const next = new StreamableHTTPClientTransport(url);
-            client = next;
             next.onmessage = (msg) => {
-                server.send(msg).catch((_err) => {
-                    const err = _err instanceof Error ? _err : new Error(String(_err));
-                    this.log.write("error", `mcp: stdout send: ${err.message}`);
+                server.send(msg).catch((err) => {
+                    this.log.write("error", `mcp: stdout send: ${this.asError(err).message}`);
                 });
             };
             next.onerror = (err) => {
@@ -91,12 +94,14 @@ export default class MCPCommand {
             };
             /*  service closed the connection — try to recover  */
             next.onclose = () => {
-                if (closedByUs || bridgeDone)
+                if (client !== next || closedByUs || bridgeDone || reconnecting)
                     return;
+                reconnecting = true;
                 this.log.write("warning", "mcp: http connection lost — reconnecting");
-                reconnect().catch(() => { });
+                reconnect(0, () => { reconnecting = false; }).catch(() => { });
             };
             await next.start();
+            client = next;
         };
         /*  reconnect loop: restart service if needed, then reconnect client  */
         const reconnect = async (attempt = 0, done) => {
@@ -111,22 +116,21 @@ export default class MCPCommand {
                 port = ctx.port;
                 closedByUs = true;
                 await client?.close();
-                closedByUs = false;
                 await connectClient();
+                closedByUs = false;
                 this.log.write("info", "mcp: reconnected to service");
                 done?.();
             }
-            catch (_err) {
-                const err = _err instanceof Error ? _err : new Error(String(_err));
-                this.log.write("error", `mcp: reconnect failed: ${err.message}`);
+            catch (err) {
+                closedByUs = false;
+                this.log.write("error", `mcp: reconnect failed: ${this.asError(err).message}`);
                 reconnect(attempt + 1, done).catch(() => { });
             }
         };
         /*  wire stdio server  */
         server.onmessage = (msg) => {
-            client?.send(msg).catch((_err) => {
-                const err = _err instanceof Error ? _err : new Error(String(_err));
-                this.log.write("error", `mcp: http send: ${err.message}`);
+            client?.send(msg).catch((err) => {
+                this.log.write("error", `mcp: http send: ${this.asError(err).message}`);
             });
         };
         server.onerror = (err) => {
@@ -140,7 +144,6 @@ export default class MCPCommand {
         await connectClient();
         /*  periodically probe the service; trigger reconnect if it is gone  */
         const HEALTH_INTERVAL_MS = 30_000;
-        let reconnecting = false;
         const healthTimer = setInterval(async () => {
             if (bridgeDone || reconnecting)
                 return;
@@ -153,7 +156,10 @@ export default class MCPCommand {
                     reconnect(0, () => { reconnecting = false; }).catch(() => { });
                 }
             }
-            catch { /* ignore probe errors */ }
+            catch (err) {
+                /*  ignore transient probe/context errors but record them  */
+                this.log.write("debug", `mcp: health check error: ${this.asError(err).message}`);
+            }
         }, HEALTH_INTERVAL_MS);
         healthTimer.unref();
         /*  await stdio to be closed  */
@@ -165,7 +171,7 @@ export default class MCPCommand {
         /*  shutdown services  */
         clearInterval(healthTimer);
         await shutdown();
-        return 0;
+        return 0; /*  unreachable, kept only to satisfy the Promise<number> return type  */
     }
     /*  register commands  */
     register(program) {

package/dst/ase-service.js

@@ -258,7 +258,13 @@ export default class ServiceCommand {
             handler: (_request, h) => {
                 this.log.write("info", "service: stop requested");
                 setImmediate(async () => {
-                    await server.stop({ timeout: 1000 });
+                    try {
+                        await server.stop({ timeout: 1000 });
+                    }
+                    catch (err) {
+                        const e = err;
+                        this.log.write("error", `service: stop failed: ${e.message}`);
+                    }
                     process.exit(0);
                 });
                 return h.response({ ok: true }).code(200);
@@ -439,7 +445,6 @@ export default class ServiceCommand {
                 lastErr = new Error(`${reason}${detail}`);
             }
             finally {
-                child.removeListener("exit", onExit);
                 if (!success && !exited) {
                     child.kill("SIGTERM");
                     await Promise.race([
@@ -455,6 +460,7 @@ export default class ServiceCommand {
                         child.unref();
                     }
                 }
+                child.removeListener("exit", onExit);
                 if (!success)
                     Service.clearPort(ctx.svc);
             }

package/dst/ase-statusline.js

@@ -175,7 +175,7 @@ export default class StatuslineCommand {
     /*  parse and validate the --tool option  */
     parseTool(value) {
         if (value !== "claude" && value !== "copilot")
-            throw new Error(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
+            throw new InvalidArgumentError(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
         return value;
     }
     /*  register commands  */
@@ -191,8 +191,8 @@ export default class StatuslineCommand {
             .option("-m, --margin <n>", "reduce maximum used terminal width by <n> characters on each side", parseInteger("--margin"), 2)
             .option("--no-icons", "disable icons in placeholder rendering")
             .option("--no-labels", "disable labels in front of bold values")
-            .argument("[lines...]", "one or more template lines with %u %p %T %s %m %e %t %P %c %C %L %N %a %r " +
-            "%S %D %W %Q %H %X %b %g %G %d %M %V %o placeholders and <color>...</color> markup " +
+            .argument("[lines...]", "one or more template lines with %u %p %T %s %m %e %t %O %P %c %C %a %r " +
+            "%S %D %W %Q %H %X %b %g %G %d %M %V placeholders and <color>...</color> markup " +
             "(color: black, red, green, yellow, blue, magenta, cyan, white, default) " +
             "(default: single line \"%m %e %t\")")
             .action(async (lines, opts) => {
@@ -357,7 +357,7 @@ export default class StatuslineCommand {
                 S: () => {
                     const pct5h = data.rate_limits?.five_hour?.used_percentage;
                     if (pct5h !== undefined)
-                        emit(`${prefix("⏲", "session")}${c.bold(`${pct5h.toFixed(1)}%`)}`);
+                        emit(`${prefix("⏲", "session-usage")}${c.bold(`${pct5h.toFixed(1)}%`)}`);
                 },
                 D: () => {
                     const until5h = data.rate_limits?.five_hour?.resets_at ?? "";
@@ -368,7 +368,7 @@ export default class StatuslineCommand {
                 W: () => {
                     const pctWk = data.rate_limits?.seven_day?.used_percentage;
                     if (pctWk !== undefined)
-                        emit(`${prefix("⏲", "weekly")}${c.bold(`${pctWk.toFixed(1)}%`)}`);
+                        emit(`${prefix("⏲", "weekly-usage")}${c.bold(`${pctWk.toFixed(1)}%`)}`);
                 },
                 Q: () => {
                     const untilWk = data.rate_limits?.seven_day?.resets_at ?? "";
@@ -390,11 +390,11 @@ export default class StatuslineCommand {
                 /*  ==== VERSION CONTROL ====  */
                 a: () => {
                     const linesAdded = data.cost?.total_lines_added ?? 0;
-                    emit(`${prefix("⊕", "added")}${c.bold(linesAdded)}`);
+                    emit(`${prefix("⊕", "added")}${c.bold(String(linesAdded))}`);
                 },
                 r: () => {
                     const linesRemoved = data.cost?.total_lines_removed ?? 0;
-                    emit(`${prefix("⊖", "removed")}${c.bold(linesRemoved)}`);
+                    emit(`${prefix("⊖", "removed")}${c.bold(String(linesRemoved))}`);
                 },
                 b: () => {
                     const g = getGit();
@@ -435,6 +435,15 @@ export default class StatuslineCommand {
                 }
             };
             /*  walk each template line and render  */
+            const closeSpan = () => {
+                if (span !== null) {
+                    const wrapped = span.color === "default" ?
+                        span.buf :
+                        (c[span.color])(span.buf);
+                    span = null;
+                    appendOutput(wrapped);
+                }
+            };
             for (const line of tmpl) {
                 let i = 0;
                 while (i < line.length) {
@@ -443,15 +452,8 @@ export default class StatuslineCommand {
                     if (ch === "<") {
                         const m = line.slice(i).match(/^<(\/?)([a-z]+)>/);
                         if (m !== null && COLORS.has(m[2])) {
-                            if (m[1] === "/") {
-                                if (span !== null) {
-                                    const wrapped = span.color === "default" ?
-                                        span.buf :
-                                        (c[span.color])(span.buf);
-                                    span = null;
-                                    appendOutput(wrapped);
-                                }
-                            }
+                            if (m[1] === "/")
+                                closeSpan();
                             else if (span === null)
                                 span = { color: m[2], buf: "" };
                             i += m[0].length;
@@ -468,13 +470,7 @@ export default class StatuslineCommand {
                     }
                 }
                 /*  flush any unterminated span at end of line  */
-                if (span !== null) {
-                    const wrapped = span.color === "default" ?
-                        span.buf :
-                        (c[span.color])(span.buf);
-                    span = null;
-                    appendOutput(wrapped);
-                }
+                closeSpan();
                 out += "\n";
                 col = 0;
             }

package/dst/ase-task.js

@@ -69,6 +69,21 @@ export class Task {
         fs.rmSync(path.dirname(file), { recursive: true, force: true });
         return true;
     }
+    /*  rename a task by moving the entire task home directory
+        <project>/.ase/task/<oldId>/ to <project>/.ase/task/<newId>/;
+        returns true on success, false if the source task does not exist;
+        throws if the target id already exists  */
+    static rename(oldId, newId) {
+        const oldDir = path.dirname(Task.path(oldId));
+        const newDir = path.dirname(Task.path(newId));
+        if (!fs.existsSync(oldDir))
+            return false;
+        if (fs.existsSync(newDir))
+            throw new Error(`task: target id "${newId}" already exists`);
+        fs.mkdirSync(path.dirname(newDir), { recursive: true });
+        fs.renameSync(oldDir, newDir);
+        return true;
+    }
     /*  list all persisted tasks in lexicographic id order; if verbose is true,
         each entry's `mtime` is set to the `plan.md` modification time formatted
         as "YYYY-MM-DD HH:MM", otherwise it is left undefined  */
@@ -227,6 +242,20 @@ export default class TaskCommand {
                 this.log.write("info", `task: no task "${id}" to remove`);
             process.exit(removed ? 0 : 1);
         });
+        /*  register CLI sub-command "ase task rename"  */
+        task
+            .command("rename")
+            .description("Rename a task from <old> to <new>")
+            .argument("<old>", "Old task identifier")
+            .argument("<new>", "New task identifier")
+            .action((oldId, newId) => {
+            const renamed = Task.rename(oldId, newId);
+            if (renamed)
+                this.log.write("info", `task: renamed "${oldId}" to "${newId}"`);
+            else
+                this.log.write("info", `task: no task "${oldId}" to rename`);
+            process.exit(renamed ? 0 : 1);
+        });
         /*  register CLI sub-command "ase task purge"  */
         task
             .command("purge")
@@ -289,7 +318,7 @@ export class TaskMCP {
                 const verbose = args.verbose ?? false;
                 const items = Task.list(verbose);
                 const tasks = verbose ?
-                    items.map((item) => ({ id: item.id, mtime: item.mtime })) :
+                    items.map((item) => ({ id: item.id, mtime: item.mtime ?? "" })) :
                     items.map((item) => ({ id: item.id }));
                 const result = { tasks };
                 return {
@@ -381,6 +410,36 @@ export class TaskMCP {
                 };
             }
         });
+        /*  task rename  */
+        mcp.registerTool("task_rename", {
+            title: "ASE task rename",
+            description: "Rename a previously persisted task from `old` to `new` by atomically moving the " +
+                "task home directory. Returns a status `text` indicating whether the rename succeeded. " +
+                "Fails with an error if the target id already exists.",
+            inputSchema: {
+                old: z.string()
+                    .describe("old task identifier (allowed characters: A-Z, a-z, 0-9, '-')"),
+                new: z.string()
+                    .describe("new task identifier (allowed characters: A-Z, a-z, 0-9, '-')")
+            }
+        }, async (args) => {
+            try {
+                const renamed = Task.rename(args.old, args.new);
+                const msg = renamed ?
+                    `task_rename: OK: renamed task "${args.old}" to "${args.new}"` :
+                    "WARNING: task not found";
+                return {
+                    content: [{ type: "text", text: msg }]
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `ERROR: ${message}` }]
+                };
+            }
+        });
         /*  task id get/set  */
         mcp.registerTool("task_id", {
             title: "ASE task id get/set",

package/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "http://github.com/rse/ase",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "http://github.com/rse/ase/issues" },
-    "version":                              "0.0.48",
+    "version":                              "0.0.50",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.0.48",
+    "version":     "0.0.50",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.github/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.0.48",
+    "version":     "0.0.50",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",