@rse/ase 0.0.51 → 0.0.52

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.51",
+    "version":                              "0.0.52",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -18,8 +18,8 @@
     "devDependencies": {
         "eslint":                           "9.39.4",
         "@eslint/js":                       "9.39.4",
-        "@typescript-eslint/parser":        "8.59.4",
-        "@typescript-eslint/eslint-plugin": "8.59.4",
+        "@typescript-eslint/parser":        "8.60.0",
+        "@typescript-eslint/eslint-plugin": "8.60.0",
         "eslint-plugin-promise":            "7.3.0",
         "eslint-plugin-import":             "2.32.0",
         "neostandard":                      "0.13.0",
@@ -41,9 +41,9 @@
     },
     "dependencies": {
         "commander":                        "14.0.3",
-        "@dotenvx/dotenvx":                 "1.68.1",
+        "@dotenvx/dotenvx":                 "1.69.0",
         "yaml":                             "2.9.0",
-        "valibot":                          "1.4.0",
+        "valibot":                          "1.4.1",
         "execa":                            "9.6.1",
         "mkdirp":                           "3.0.1",
         "@hapi/hapi":                       "21.4.9",

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

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.0.51",
+    "version":     "0.0.52",
     "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.51",
+    "version":     "0.0.52",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/etc/stx.conf

@@ -4,19 +4,19 @@
 ##  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 ##
 
-#   lint project
+#   [plugin] lint project
 lint
     markdownlint-cli2 --config etc/markdownlint.yaml skills/**/*.md
 
-#   build project
+#   [plugin] build project
 build : lint
     true
 
-#   remove all generated files
+#   [plugin] remove all generated files
 clean
     true
 
-#   remove all built files
+#   [plugin] remove all built files
 distclean: clean
     shx rm -f package-lock.json
     shx rm -rf node_modules

package/plugin/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.51",
+    "version":                              "0.0.52",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",

package/dst/ase-claude.js

@@ -1,116 +0,0 @@
-/*
-**  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 { execa, execaSync } from "execa";
-import which from "which";
-import { Config, configSchema, parseScope } from "./ase-config.js";
-/*  default statusline arguments (claudeX fallback) used when the
-    "agent.statusline" config variable is empty or unset  */
-const DEFAULT_STATUSLINE_ARGS = "-w 0 -m 2 '<blue>%u</blue> <red>%p</red> <black>%T</black> %s' '%m %e %t' '%P %c'";
-/*  CLI command "ase claude"  */
-export default class ClaudeCommand {
-    log;
-    constructor(log) {
-        this.log = log;
-    }
-    /*  ensure a tool is available  */
-    async ensureTool(tool) {
-        return which(tool).catch(() => {
-            throw new Error(`mandatory tool "${tool}" not found in $PATH`);
-        });
-    }
-    /*  resolve the statusline command-line arguments from the layered
-        ASE configuration ("agent.statusline"), falling back to the
-        claudeX default if the value is empty or unavailable  */
-    resolveStatuslineArgs() {
-        let args = "";
-        try {
-            const cfg = new Config("config", configSchema, this.log, parseScope("project"));
-            cfg.read("lenient");
-            args = String(cfg.get("agent.statusline") ?? "").trim();
-        }
-        catch (_e) {
-            /*  cascade unavailable; keep fallback  */
-        }
-        if (args === "")
-            args = DEFAULT_STATUSLINE_ARGS;
-        return args;
-    }
-    /*  register commands  */
-    register(program) {
-        program
-            .command("claude")
-            .description("start Claude Code with bootstrapped ASE environment and settings")
-            .passThroughOptions()
-            .allowUnknownOption()
-            .argument("[args...]", "arguments forwarded verbatim to the \"claude\" CLI")
-            .action(async (args) => {
-            /*  ensure Claude Code CLI is available  */
-            await this.ensureTool("claude");
-            /*  bootstrap ASE_TERM_WIDTH from terminal columns  */
-            if (process.env.ASE_TERM_WIDTH === undefined) {
-                let width = 0;
-                if (process.stdout.isTTY) {
-                    const cols = process.stdout.columns;
-                    if (typeof cols === "number" && cols > 0)
-                        width = cols;
-                }
-                process.env.ASE_TERM_WIDTH = `${width}`;
-            }
-            /*  bootstrap ASE_TERM_HEIGHT from terminal rows  */
-            if (process.env.ASE_TERM_HEIGHT === undefined) {
-                let height = 0;
-                if (process.stdout.isTTY) {
-                    const rows = process.stdout.rows;
-                    if (typeof rows === "number" && rows > 0)
-                        height = rows;
-                }
-                process.env.ASE_TERM_HEIGHT = `${height}`;
-            }
-            /*  bootstrap ASE_TERM_COLORS from "tput colors"  */
-            if (process.env.ASE_TERM_COLORS === undefined) {
-                let colorMode = "none";
-                try {
-                    const { stdout } = execaSync("tput", ["colors"], { reject: false });
-                    const n = parseInt(stdout.trim(), 10);
-                    if (!Number.isNaN(n) && n >= 256)
-                        colorMode = "ansi256";
-                    else if (!Number.isNaN(n) && n >= 16)
-                        colorMode = "ansi16";
-                }
-                catch (_e) {
-                    /*  ignore  */
-                }
-                process.env.ASE_TERM_COLORS = colorMode;
-            }
-            /*  resolve statusline arguments (config or claudeX fallback)  */
-            const statuslineArgs = this.resolveStatuslineArgs();
-            /*  build inline Claude Code settings JSON  */
-            const settings = {
-                env: {
-                    DISABLE_TELEMETRY: "1",
-                    DISABLE_AUTOUPDATER: "1",
-                    DISABLE_BUG_COMMAND: "1",
-                    DISABLE_ERROR_REPORTING: "1"
-                },
-                statusLine: {
-                    type: "command",
-                    command: `ase statusline ${statuslineArgs}`,
-                    padding: 0
-                }
-            };
-            const settingsJSON = JSON.stringify(settings);
-            /*  exec Claude Code with the inline settings prepended
-                and any user-supplied arguments forwarded verbatim  */
-            const result = await execa("claude", ["--settings", settingsJSON, ...args], {
-                stdio: "inherit",
-                env: process.env,
-                reject: false,
-                windowsHide: false
-            });
-            process.exit(result.exitCode ?? 0);
-        });
-    }
-}

package/dst/ase-decision.js

@@ -1,67 +0,0 @@
-/*
-**  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 { z } from "zod";
-/*  reusable functionality: weighted multi-criteria decision matrix  */
-export class Decision {
-    /*  compute the per-alternative product-sum (rating) row from a
-        weighted decision matrix. Each input row has the shape
-        `[weight, eval_1, eval_2, ..., eval_N]`. For each alternative
-        column j (1..N), the result is the sum over all rows K of
-        `weight_K * eval_K_j`. The output array has length N.  */
-    static productSum(matrix) {
-        if (matrix.length === 0)
-            return [];
-        const cols = matrix[0].length;
-        if (cols < 2)
-            throw new Error("each row must contain a weight followed by at least one evaluation column");
-        const N = cols - 1;
-        const ratings = new Array(N).fill(0);
-        for (let i = 0; i < matrix.length; i++) {
-            const row = matrix[i];
-            if (row.length !== cols)
-                throw new Error(`row ${i} has ${row.length} columns, expected ${cols}`);
-            const weight = row[0];
-            for (let j = 0; j < N; j++)
-                ratings[j] += weight * row[j + 1];
-        }
-        return ratings;
-    }
-}
-/*  MCP registration entry point for the decision-matrix tool  */
-export class DecisionMCP {
-    register(mcp) {
-        mcp.registerTool("decision_matrix", {
-            title: "ASE decision matrix",
-            description: "Compute the per-alternative product-sum (rating) row of a weighted " +
-                "multi-criteria decision matrix. The input `matrix` is an array of rows, " +
-                "one row per criterion, where each row has the shape " +
-                "`[weight, eval_1, eval_2, ..., eval_N]` (i.e. the criterion weight " +
-                "followed by N evaluation values, one per alternative). For each " +
-                "alternative column j (1..N), the result is the sum over all rows K of " +
-                "`weight_K * eval_K_j`. Returns a JSON `text` array of length N with " +
-                "the raw, unrounded ratings (one per alternative, in the same column " +
-                "order as the input).",
-            inputSchema: {
-                matrix: z.array(z.array(z.number()))
-                    .describe("Decision matrix rows: each row is `[weight, eval_1, ..., eval_N]`")
-            }
-        }, async (args) => {
-            try {
-                const result = Decision.productSum(args.matrix);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(result) }]
-                };
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : String(err);
-                return {
-                    isError: true,
-                    content: [{ type: "text", text: `ERROR: ${message}` }]
-                };
-            }
-        });
-    }
-}

package/dst/ase-foo.js

@@ -1,21 +0,0 @@
-/*
-**  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>
-*/
-/*  command-line handling  */
-export default class FooCommand {
-    log;
-    constructor(log) {
-        this.log = log;
-    }
-    /*  register commands  */
-    register(program) {
-        program
-            .command("foo")
-            .description("Print a nice Hello World message")
-            .action(() => {
-            process.stdout.write("Hello, World!\n");
-        });
-    }
-}

package/dst/ase-hello.js

@@ -1,23 +0,0 @@
-/*
-**  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 chalk from "chalk";
-/*  command-line handling  */
-export default class HelloCommand {
-    log;
-    constructor(log) {
-        this.log = log;
-    }
-    /*  register commands  */
-    register(program) {
-        program
-            .command("hello")
-            .description("Print a nice greeting in red")
-            .option("-s, --subject <subject>", "subject to greet", "Hello")
-            .action((opts) => {
-            process.stdout.write(chalk.red(`${opts.subject} Universe!`) + "\n");
-        });
-    }
-}

package/dst/ase-helloxx.js

@@ -1,23 +0,0 @@
-/*
-**  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 chalk from "chalk";
-/*  command-line handling  */
-export default class HelloxxCommand {
-    log;
-    constructor(log) {
-        this.log = log;
-    }
-    /*  register commands  */
-    register(program) {
-        program
-            .command("helloxx")
-            .description("Print a Hello World greeting")
-            .action(() => {
-            process.stdout.write(chalk.bold.green("Hello, World!") + "\n");
-            process.exit(0);
-        });
-    }
-}

package/dst/ase-launch.js

@@ -1,109 +0,0 @@
-/*
-**  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 { execa, execaSync } from "execa";
-import which from "which";
-import { Config, configSchema, parseScope } from "./ase-config.js";
-/*  list of supported tools for "ase launch <tool>"  */
-const SUPPORTED_TOOLS = ["claude"];
-/*  default statusline arguments (used when "agent.statusline" is empty/unset)  */
-const DEFAULT_STATUSLINE_ARGS = "-w 0 -m 2 '<blue>%u</blue> <red>%p</red> <black>%T</black> %s' '%m %e %t' '%P %c'";
-/*  CLI command "ase launch"  */
-export default class LaunchCommand {
-    log;
-    constructor(log) {
-        this.log = log;
-    }
-    /*  resolve the effective "agent.statusline" from the layered
-        configuration cascade (default < user < project)  */
-    readStatuslineConfig() {
-        let statusline = "";
-        try {
-            const cfg = new Config("config", configSchema, this.log, parseScope(undefined));
-            cfg.read("lenient");
-            statusline = String(cfg.get("agent.statusline") ?? "").trim();
-        }
-        catch (_e) {
-            /*  cascade unavailable; leave default  */
-        }
-        /*  reject shell metacharacters to prevent command injection through
-            the configured value when later interpolated into a shell command  */
-        if (statusline !== "" && /[;&|`$\n\r]/.test(statusline))
-            throw new Error("invalid \"agent.statusline\" configuration value: " +
-                "must not contain shell metacharacters (; & | ` $ newline)");
-        return statusline;
-    }
-    /*  populate ASE_TERM_* environment variables (only if unset),
-        so downstream tools (e.g. the diagram renderer) get reliable
-        terminal sizing/color information regardless of the launched tool  */
-    populateTermEnv() {
-        const tty = process.stdout.isTTY;
-        if (process.env.ASE_TERM_WIDTH === undefined) {
-            const cols = tty ? process.stdout.columns : 0;
-            process.env.ASE_TERM_WIDTH = `${typeof cols === "number" && cols > 0 ? cols : 0}`;
-        }
-        if (process.env.ASE_TERM_HEIGHT === undefined) {
-            const rows = tty ? process.stdout.rows : 0;
-            process.env.ASE_TERM_HEIGHT = `${typeof rows === "number" && rows > 0 ? rows : 0}`;
-        }
-        if (process.env.ASE_TERM_COLORS === undefined) {
-            let colorMode = "none";
-            try {
-                const { stdout } = execaSync("tput", ["colors"], { reject: false });
-                const n = parseInt(stdout.trim(), 10);
-                if (!Number.isNaN(n) && n >= 256)
-                    colorMode = "ansi256";
-                else if (!Number.isNaN(n) && n >= 16)
-                    colorMode = "ansi16";
-            }
-            catch (_e) {
-                /*  ignore  */
-            }
-            process.env.ASE_TERM_COLORS = colorMode;
-        }
-    }
-    /*  handler for "ase launch <tool> [<options>...]"  */
-    async run(tool, args) {
-        /*  populate ASE_TERM_* environment variables (always, regardless of tool)  */
-        this.populateTermEnv();
-        /*  dispatch by tool name  */
-        if (tool === "claude") {
-            await which("claude").catch(() => {
-                throw new Error("required tool \"claude\" not found in $PATH");
-            });
-            let statusline = this.readStatuslineConfig();
-            if (statusline === "")
-                statusline = DEFAULT_STATUSLINE_ARGS;
-            const settingsJson = JSON.stringify({
-                statusLine: {
-                    type: "command",
-                    command: `ase statusline ${statusline}`,
-                    padding: 0
-                }
-            });
-            const result = await execa("claude", ["--settings", settingsJson, ...args], {
-                stdio: "inherit",
-                env: process.env,
-                reject: false
-            });
-            return result.exitCode ?? 0;
-        }
-        else
-            throw new Error(`unsupported tool "${tool}" ` +
-                `(expected one of: ${SUPPORTED_TOOLS.join(", ")})`);
-    }
-    /*  register commands  */
-    register(program) {
-        program
-            .command("launch <tool> [options...]")
-            .description("launch a supported tool with bootstrapped environment and settings " +
-            `(supported tools: ${SUPPORTED_TOOLS.join(", ")})`)
-            .passThroughOptions()
-            .allowUnknownOption()
-            .action(async (tool, options) => {
-            process.exit(await this.run(tool, options));
-        });
-    }
-}

package/dst/ase-plan.js

@@ -1,143 +0,0 @@
-/*
-**  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 path from "node:path";
-import os from "node:os";
-import fs from "node:fs";
-/*  validate the plan id to keep it safe as a filename component  */
-const validateId = (id) => {
-    if (typeof id !== "string" || id.length === 0)
-        throw new Error("plan: id must be a non-empty string");
-    if (!/^[A-Za-z0-9-]+$/.test(id))
-        throw new Error("plan: id must match [A-Za-z0-9-]+");
-};
-/*  resolve the on-disk path for a given plan id  */
-const planPath = (id) => {
-    validateId(id);
-    return path.join(os.homedir(), ".ase", "plan", `${id}.md`);
-};
-/*  load a plan; returns empty string if no plan exists  */
-export const planLoad = (id) => {
-    const file = planPath(id);
-    if (!fs.existsSync(file))
-        return "";
-    return fs.readFileSync(file, "utf8");
-};
-/*  save a plan as UTF-8 text under the given id  */
-export const planSave = (id, text) => {
-    if (typeof text !== "string")
-        throw new Error("plan: text must be a string");
-    const file = planPath(id);
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, text, "utf8");
-};
-/*  delete a plan by id; returns true if a plan existed and was removed  */
-export const planDelete = (id) => {
-    const file = planPath(id);
-    if (!fs.existsSync(file))
-        return false;
-    fs.rmSync(file);
-    return true;
-};
-/*  purge plans whose modification time is older than the given cutoff in
-    milliseconds; returns the list of removed plan ids  */
-export const planPurge = (maxAgeMs) => {
-    const dir = path.join(os.homedir(), ".ase", "plan");
-    if (!fs.existsSync(dir))
-        return [];
-    const cutoff = Date.now() - maxAgeMs;
-    const removed = [];
-    for (const entry of fs.readdirSync(dir)) {
-        if (!entry.endsWith(".md"))
-            continue;
-        const file = path.join(dir, entry);
-        const st = fs.statSync(file);
-        if (!st.isFile())
-            continue;
-        if (st.mtimeMs < cutoff) {
-            fs.rmSync(file);
-            removed.push(entry.slice(0, -3));
-        }
-    }
-    return removed;
-};
-/*  read all of stdin as a UTF-8 string  */
-const readStdin = () => {
-    return new Promise((resolve, reject) => {
-        const chunks = [];
-        process.stdin.on("data", (chunk) => chunks.push(chunk));
-        process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
-        process.stdin.on("error", (err) => reject(err));
-    });
-};
-/*  CLI command "ase plan"  */
-export default class PlanCommand {
-    log;
-    constructor(log) {
-        this.log = log;
-    }
-    /*  register commands  */
-    register(program) {
-        /*  register CLI top-level command "ase plan"  */
-        const plan = program
-            .command("plan")
-            .description("Manage persisted plans under ~/.ase/plan/<id>.md")
-            .action(() => {
-            plan.outputHelp();
-            process.exit(1);
-        });
-        /*  register CLI sub-command "ase plan load"  */
-        plan
-            .command("load")
-            .description("Load a plan by id and write it to stdout")
-            .argument("<id>", "Plan identifier")
-            .action((id) => {
-            const text = planLoad(id);
-            process.stdout.write(text);
-            process.exit(0);
-        });
-        /*  register CLI sub-command "ase plan save"  */
-        plan
-            .command("save")
-            .description("Save a plan by id, reading content from stdin")
-            .argument("<id>", "Plan identifier")
-            .action(async (id) => {
-            const text = await readStdin();
-            planSave(id, text);
-            this.log.write("info", `plan: saved "${id}"`);
-            process.exit(0);
-        });
-        /*  register CLI sub-command "ase plan delete"  */
-        plan
-            .command("delete")
-            .description("Delete a plan by id")
-            .argument("<id>", "Plan identifier")
-            .action((id) => {
-            const removed = planDelete(id);
-            if (removed)
-                this.log.write("info", `plan: removed "${id}"`);
-            else
-                this.log.write("info", `plan: no plan "${id}" to remove`);
-            process.exit(removed ? 0 : 1);
-        });
-        /*  register CLI sub-command "ase plan purge"  */
-        plan
-            .command("purge")
-            .description("Remove all plans with a modification time older than <days> (default: 31)")
-            .argument("[<days>]", "Maximum plan age in days", "31")
-            .action((days) => {
-            const n = Number.parseInt(days, 10);
-            if (!Number.isFinite(n) || n < 0)
-                throw new Error("plan: <days> must be a non-negative integer");
-            const removed = planPurge(n * 24 * 60 * 60 * 1000);
-            if (removed.length === 0)
-                this.log.write("info", "plan: no plans to purge");
-            else
-                for (const id of removed)
-                    this.log.write("info", `plan: purged "${id}"`);
-            process.exit(0);
-        });
-    }
-}

package/dst/ase-service-probe.js

@@ -1,38 +0,0 @@
-/*
-**  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;
-    }
-};