@rse/ase 0.0.51 → 0.0.53

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-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;
-    }
-};