@rse/ase 0.0.26 → 0.0.27

package/dst/ase-config.js

@@ -325,14 +325,15 @@ export class Config {
     /*  enumerate all full dotted leaf paths from the attached valibot schema  */
     schemaLeafPaths() {
         const unwrap = (s) => {
-            while (s !== undefined && s !== null && (s.type === "optional" || s.type === "nullish"
-                || s.type === "nullable" || s.type === "undefinedable"))
-                s = s.wrapped;
-            return s;
+            let cur = s;
+            while (cur !== undefined && cur !== null && (cur.type === "optional" || cur.type === "nullish"
+                || cur.type === "nullable" || cur.type === "undefinedable"))
+                cur = cur.wrapped;
+            return cur ?? null;
         };
         const walk = (s, prefix) => {
             const u = unwrap(s);
-            if (u !== undefined && u !== null
+            if (u !== null
                 && (u.type === "object" || u.type === "strict_object" || u.type === "loose_object")
                 && u.entries !== undefined) {
                 const paths = [];

package/dst/ase-hook.js

@@ -79,7 +79,7 @@ export default class HookCommand {
         const versionHints = [];
         if (versionCurrentPlugin !== versionCurrentTool)
             versionHints.push("**WARNING:** version *mismatch*: " +
-                `tool: **${versionCurrentPlugin}**, plugin: **${versionCurrentTool}**`);
+                `tool: **${versionCurrentTool}**, plugin: **${versionCurrentPlugin}**`);
         if (versionCurrentTool !== versionLatestTool)
             versionHints.push(`**NOTICE:** *latest* version: **${versionLatestTool}**, please update!`);
         if (process.env.ASE_SETUP_DEV !== undefined)
@@ -91,22 +91,25 @@ export default class HookCommand {
         const input = stdin.trim() !== "" ? JSON.parse(stdin) : {};
         /*  determine session id  */
         const sessionId = input.session_id ?? input.sessionId ?? "";
-        /*  establish config context  */
-        const cfg = new Config("config", configSchema, this.log, parseScope(`session:${sessionId}`));
+        /*  establish config context (session-scoped only if a valid sessionId is present)  */
+        const hasSession = /^[A-Za-z0-9._-]+$/.test(sessionId);
+        const cfg = new Config("config", configSchema, this.log, hasSession ? parseScope(`session:${sessionId}`) : parseScope(undefined));
         try {
             cfg.read();
         }
         catch (_e) {
             /*  best-effort: ignore failures  */
         }
-        /*  determine task id  */
+        /*  determine task id (only persist when scoped to a real session)  */
         const taskId = process.env.ASE_TASK_ID ?? "default";
-        try {
-            cfg.set("agent.task", taskId);
-            cfg.write();
-        }
-        catch (_e) {
-            /*  best-effort: ignore failures  */
+        if (hasSession) {
+            try {
+                cfg.set("agent.task", taskId);
+                cfg.write();
+            }
+            catch (_e) {
+                /*  best-effort: ignore failures  */
+            }
         }
         /*  determine project id  */
         const cwd = input.cwd ?? process.cwd();

package/dst/ase-mcp.js

@@ -5,42 +5,11 @@
 */
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import axios from "axios";
-import * as v from "valibot";
 import { execa } from "execa";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import { Config, configSchema } from "./ase-config.js";
-const HOST = "127.0.0.1";
-/*  schema for ".ase/service.yaml" (same shape as in ase-service.ts)  */
-const serviceSchema = v.nullish(v.strictObject({
-    port: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1024), v.maxValue(65535)))
-}));
-/*  distinguish ECONNREFUSED from other Axios transport errors  */
-const isConnRefused = (err) => {
-    const e = err;
-    return e?.code === "ECONNREFUSED" || e?.cause?.code === "ECONNREFUSED";
-};
-/*  probe the service and verify ASE identity banner  */
-const probe = async (port, projectId) => {
-    try {
-        const r = await axios.request({
-            method: "OPTIONS",
-            url: `http://${HOST}:${port}/`,
-            timeout: 2000,
-            validateStatus: () => true
-        });
-        if (r.status < 200 || r.status >= 300)
-            return false;
-        const d = r.data;
-        return d?.ase === true && d?.projectId === projectId;
-    }
-    catch (err) {
-        if (isConnRefused(err))
-            return null;
-        throw err;
-    }
-};
+import { SERVICE_HOST as HOST, serviceSchema, probe } from "./ase-service-probe.js";
 /*  CLI command "ase mcp"  */
 export default class MCPCommand {
     log;

package/dst/ase-service-probe.js

@@ -0,0 +1,38 @@
+/*
+**  Agentic Software Engineering (ASE)
+**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
+*/
+import axios from "axios";
+import * as v from "valibot";
+/*  shared service host  */
+export const SERVICE_HOST = "127.0.0.1";
+/*  schema for ".ase/service.yaml"  */
+export const serviceSchema = v.nullish(v.strictObject({
+    port: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1024), v.maxValue(65535)))
+}));
+/*  distinguish ECONNREFUSED from other Axios transport errors  */
+export const isConnRefused = (err) => {
+    const e = err;
+    return e?.code === "ECONNREFUSED" || e?.cause?.code === "ECONNREFUSED";
+};
+/*  probe the service and verify ASE identity banner  */
+export const probe = async (port, projectId) => {
+    try {
+        const r = await axios.request({
+            method: "OPTIONS",
+            url: `http://${SERVICE_HOST}:${port}/`,
+            timeout: 2000,
+            validateStatus: () => true
+        });
+        if (r.status < 200 || r.status >= 300)
+            return false;
+        const d = r.data;
+        return d?.ase === true && d?.projectId === projectId;
+    }
+    catch (err) {
+        if (isConnRefused(err))
+            return null;
+        throw err;
+    }
+};

package/dst/ase-service.js

@@ -11,7 +11,6 @@ import { spawn } from "node:child_process";
 import Hapi from "@hapi/hapi";
 import axios from "axios";
 import { isMap, isScalar } from "yaml";
-import * as v from "valibot";
 import prettyMs from "pretty-ms";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
@@ -20,19 +19,15 @@ import { DateTime } from "luxon";
 import { Config, configSchema, parseScope } from "./ase-config.js";
 import { renderDiagram, detectTermWidth, detectTermHeight } from "./ase-diagram.js";
 import { taskLoad, taskSave, taskDelete, taskList } from "./ase-task.js";
+import { SERVICE_HOST as HOST, serviceSchema, probe } from "./ase-service-probe.js";
 import pkg from "../package.json" with { type: "json" };
 const SERVE_ENV = "ASE_SERVICE_SERVE";
 const PORT_ENV = "ASE_SERVICE_PORT";
-const HOST = "127.0.0.1";
 const IDLE_MS = 30 * 60 * 1000;
 const TICK_MS = 60 * 1000;
 const PORT_MIN = 42000;
 const PORT_MAX = 44000;
 const PORT_TRIES = 20;
-/*  schema for ".ase/service.yaml"  */
-const serviceSchema = v.nullish(v.strictObject({
-    port: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1024), v.maxValue(65535)))
-}));
 /*  try binding a single candidate port to verify availability  */
 const tryBind = (port) => {
     return new Promise((resolve) => {
@@ -72,31 +67,6 @@ const clearPort = (svc) => {
     else
         svc.write();
 };
-/*  distinguish ECONNREFUSED from other Axios transport errors  */
-const isConnRefused = (err) => {
-    const e = err;
-    return e?.code === "ECONNREFUSED" || e?.cause?.code === "ECONNREFUSED";
-};
-/*  probe the service and verify ASE identity banner  */
-const probe = async (port, projectId) => {
-    try {
-        const r = await axios.request({
-            method: "OPTIONS",
-            url: `http://${HOST}:${port}/`,
-            timeout: 2000,
-            validateStatus: () => true
-        });
-        if (r.status < 200 || r.status >= 300)
-            return false;
-        const d = r.data;
-        return d?.ase === true && d?.projectId === projectId;
-    }
-    catch (err) {
-        if (isConnRefused(err))
-            return null;
-        throw err;
-    }
-};
 /*  spawn the current executable detached as a background service  */
 const spawnDetached = (aseDir, port) => {
     fs.mkdirSync(aseDir, { recursive: true });
@@ -234,9 +204,9 @@ export default class ServiceCommand {
                     "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 " +
+                    "data-structure/classes/methods as an UML Class Diagram, " +
                     "data-model/entities/relationships as an ER Diagram, or " +
-                    "metrics/distributions/time-series as a XY-Charts. " +
+                    "metrics/distributions/time-series as an XY-Chart. " +
                     "Pass the Mermaid diagram specification as `diagram`. " +
                     "Returns the rendered art as `text`.",
                 inputSchema: {
@@ -288,15 +258,33 @@ export default class ServiceCommand {
             });
             mcp.registerTool("task_list", {
                 title: "ASE task list",
-                description: "List all persisted task `id`s. " +
-                    "Returns the ids as `text`, one per line, in lexicographic order; " +
-                    "returns an empty string if no tasks exist.",
-                inputSchema: {}
-            }, async () => {
+                description: "List all persisted tasks. " +
+                    "Returns a `tasks` array (in lexicographic `id` order) where each item has the " +
+                    "task `id`. If `verbose` is `true`, each item additionally has an `mtime` field " +
+                    "(last modification time of the task's `plan.md`, formatted as `YYYY-MM-DD HH:MM`). " +
+                    "Returns an empty array if no tasks exist.",
+                inputSchema: {
+                    verbose: z.boolean().optional()
+                        .describe("if true, also include the `mtime` field per task (default: false)")
+                },
+                outputSchema: {
+                    tasks: z.array(z.object({
+                        id: z.string().describe("task identifier"),
+                        mtime: z.string().optional()
+                            .describe("plan.md modification time (`YYYY-MM-DD HH:MM`); only present if `verbose` is true")
+                    })).describe("all persisted tasks in lexicographic id order")
+                }
+            }, async (args) => {
                 try {
-                    const ids = taskList();
+                    const verbose = args.verbose ?? false;
+                    const items = taskList(verbose);
+                    const tasks = verbose ?
+                        items.map((item) => ({ id: item.id, mtime: item.mtime })) :
+                        items.map((item) => ({ id: item.id }));
+                    const result = { tasks };
                     return {
-                        content: [{ type: "text", text: ids.join("\n") }]
+                        structuredContent: result,
+                        content: [{ type: "text", text: JSON.stringify(result) }]
                     };
                 }
                 catch (err) {

package/dst/ase-setup.js

@@ -55,15 +55,16 @@ export default class SetupCommand {
                     this.log.write("info", `setup: ${ignoreError} (skipped)`);
                     return;
                 }
-                const exitCode = typeof err?.exitCode === "number" ? err.exitCode : -1;
+                const e = err;
+                const exitCode = typeof e.exitCode === "number" ? e.exitCode : -1;
                 this.log.write("error", `setup: command failed: exit code: ${exitCode}`);
-                if (typeof err?.stdout === "string" && err.stdout.length > 0) {
+                if (typeof e.stdout === "string" && e.stdout.length > 0) {
                     this.log.write("error", "setup: command failed: stdout:");
-                    process.stdout.write(err.stdout);
+                    process.stdout.write(e.stdout);
                 }
-                if (typeof err?.stderr === "string" && err.stderr.length > 0) {
+                if (typeof e.stderr === "string" && e.stderr.length > 0) {
                     this.log.write("error", "setup: command failed: stderr:");
-                    process.stderr.write(err.stderr);
+                    process.stderr.write(e.stderr);
                 }
                 throw err;
             }

package/dst/ase-statusline.js

@@ -37,15 +37,25 @@ const readStdin = async () => {
 /*  detect terminal column width via /dev/tty (stdout is a pipe under Claude Code)  */
 const detectTermWidth = () => {
     let width = 0;
+    let tty = null;
     try {
-        const tty = fs.openSync("/dev/tty", "r");
+        tty = fs.openSync("/dev/tty", "r");
         const out = execFileSync("tput", ["cols"], { stdio: [tty, "pipe", "ignore"] });
-        fs.closeSync(tty);
-        width = parseInt(out.toString("utf8").trim()) || 0;
+        width = Number.parseInt(out.toString("utf8").trim(), 10) || 0;
     }
     catch (_e) {
         /*  no controlling terminal  */
     }
+    finally {
+        if (tty !== null) {
+            try {
+                fs.closeSync(tty);
+            }
+            catch (_e) {
+                /*  best-effort  */
+            }
+        }
+    }
     return width;
 };
 /*  format a token count as a compact human-readable string (e.g. 334k, 104.9M)  */

package/dst/ase-task.js

@@ -7,6 +7,7 @@ import path from "node:path";
 import os from "node:os";
 import fs from "node:fs";
 import { execaSync } from "execa";
+import { DateTime } from "luxon";
 /*  validate the task id to keep it safe as a filename component  */
 const validateId = (id) => {
     if (typeof id !== "string" || id.length === 0)
@@ -45,12 +46,14 @@ export const taskDelete = (id) => {
     fs.rmSync(path.dirname(file), { recursive: true, force: true });
     return true;
 };
-/*  list all persisted task ids in lexicographic order  */
-export const taskList = () => {
+/*  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  */
+export const taskList = (verbose = false) => {
     const dir = path.join(os.homedir(), ".ase", "task");
     if (!fs.existsSync(dir))
         return [];
-    const ids = [];
+    const out = [];
     for (const entry of fs.readdirSync(dir)) {
         if (!/^[A-Za-z0-9-]+$/.test(entry))
             continue;
@@ -60,10 +63,11 @@ export const taskList = () => {
         const st = fs.statSync(file);
         if (!st.isFile())
             continue;
-        ids.push(entry);
+        const mtime = verbose ? DateTime.fromJSDate(st.mtime).toFormat("yyyy-LL-dd HH:mm") : undefined;
+        out.push({ id: entry, mtime });
     }
-    ids.sort();
-    return ids;
+    out.sort((a, b) => a.id.localeCompare(b.id));
+    return out;
 };
 /*  purge tasks whose modification time is older than the given cutoff in
     milliseconds; returns the list of removed task ids  */
@@ -119,10 +123,15 @@ export default class TaskCommand {
         task
             .command("list")
             .description("List all persisted task ids, one per line")
-            .action(() => {
-            const ids = taskList();
-            for (const id of ids)
-                process.stdout.write(`${id}\n`);
+            .option("-v, --verbose", "also show the plan.md modification time as (YYYY-MM-DD HH:MM)")
+            .action((opts) => {
+            const items = taskList(opts.verbose ?? false);
+            for (const item of items) {
+                if (opts.verbose)
+                    process.stdout.write(`${item.id}\t(${item.mtime})\n`);
+                else
+                    process.stdout.write(`${item.id}\n`);
+            }
             process.exit(0);
         });
         /*  register CLI sub-command "ase task load"  */

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.26",
+    "version":                              "0.0.27",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -30,7 +30,7 @@
         "nodemon":                          "3.1.14",
         "shx":                              "0.4.0",
 
-        "@types/node":                      "25.7.0",
+        "@types/node":                      "25.8.0",
         "@types/luxon":                     "3.7.1",
         "@types/which":                     "3.0.4",
         "@types/update-notifier":           "6.0.8"
@@ -42,7 +42,7 @@
         "execa":                            "9.6.1",
         "mkdirp":                           "3.0.1",
         "@hapi/hapi":                       "21.4.9",
-        "axios":                            "1.16.0",
+        "axios":                            "1.16.1",
         "beautiful-mermaid":                "1.1.3",
         "cli-table3":                       "0.6.5",
         "chalk":                            "5.6.2",