@rse/ase 1.0.4 → 1.0.6

package/dst/ase-setup.js

@@ -10,12 +10,12 @@ import { fileURLToPath } from "node:url";
 import { execa } from "execa";
 import which from "which";
 import * as dotenvx from "@dotenvx/dotenvx";
-import Table from "cli-table3";
 import chalk from "chalk";
 import writeFileAtomic from "write-file-atomic";
 import { mkdirp } from "mkdirp";
 import JsonAsty from "json-asty";
 import Version from "./ase-version.js";
+import { renderTable } from "./ase-table.js";
 const toolSpecs = {
     "claude": { cli: "claude", label: "Anthropic Claude Code CLI", pInstall: "install", pRemove: "uninstall", pUpdate: "update" },
     "copilot": { cli: "copilot", label: "GitHub Copilot CLI", pInstall: "install", pRemove: "uninstall", pUpdate: "update" },
@@ -143,6 +143,9 @@ export default class SetupCommand {
         const scopeArgs = tool === "claude" && scope !== "user" ? ["--scope", scope] : [];
         await this.run(spec.cli, ["plugin", "marketplace", "add", source, ...scopeArgs]);
         await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase", ...scopeArgs], { retries: 3 });
+        /*  select the plugin-shipped ASE output style (Anthropic Claude Code CLI only)  */
+        if (tool === "claude")
+            await this.outputStyleActivate(`install${dev ? "[dev]" : ""}`, scope);
         return 0;
     }
     /*  handler for "ase setup update" (both tools)  */
@@ -197,6 +200,9 @@ export default class SetupCommand {
                 await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase", ...scopeArgs], { retries: 3 });
             }
         }
+        /*  select the plugin-shipped ASE output style (Anthropic Claude Code CLI only)  */
+        if (tool === "claude")
+            await this.outputStyleActivate(`update${dev ? "[dev]" : ""}`, scope);
         return 0;
     }
     /*  handler for "ase setup enable|disable" (both tools)  */
@@ -227,6 +233,9 @@ export default class SetupCommand {
         this.log.write("info", `setup: uninstall${dev ? "[dev]" : ""}: ` +
             "stopping potentially running ASE service");
         await this.run("ase", ["service", "stop"], { quiet: true, ignoreError: "ASE service not running" });
+        /*  deselect the plugin-shipped ASE output style (Anthropic Claude Code CLI only)  */
+        if (tool === "claude")
+            await this.outputStyleDeactivate(`uninstall${dev ? "[dev]" : ""}`, scope);
         /*  uninstall ASE plugin  */
         this.log.write("info", `setup: uninstall${dev ? "[dev]" : ""}: ` +
             `uninstalling ASE ${spec.label} plugin (origin: ${dev ? "local" : "remote/bundled"})`);
@@ -245,21 +254,15 @@ export default class SetupCommand {
         const spec = toolSpecs[tool];
         await this.ensureTool(spec.cli);
         this.log.write("info", `setup: status: probing ASE registrations for ${spec.label}`);
-        const table = new Table({
-            head: ["KIND", "ID", "SCOPE", "STATUS"],
-            colWidths: [13, 34, 10, 16],
-            wordWrap: true,
-            chars: { "mid": "", "left-mid": "", "mid-mid": "", "right-mid": "" },
-            style: { head: ["blue"] }
-        });
+        const rows = [];
         /*  report the ASE plugin registrations, with an absent plugin
             still rendered as an explicit row instead of being omitted  */
         const plugins = await this.pluginStatus(tool);
         if (plugins.length === 0)
-            table.push(["PLUGIN", chalk.bold("ase@ase"), "(n/a)", "not installed"]);
+            rows.push(["PLUGIN", chalk.bold("ase@ase"), "(n/a)", "not installed"]);
         else
             for (const plugin of plugins)
-                table.push(["PLUGIN", chalk.bold("ase@ase"), plugin.scope, plugin.status]);
+                rows.push(["PLUGIN", chalk.bold("ase@ase"), plugin.scope, plugin.status]);
         /*  report the registered MCP servers, probed concurrently and
             silently skipping every server which is not registered at all  */
         const scopes = await Promise.all(this.mcpServers.map((handle) => this.mcpScope(tool, handle.server)));
@@ -267,12 +270,15 @@ export default class SetupCommand {
             const scope = scopes[i];
             if (scope === undefined)
                 continue;
-            table.push(["MCP", chalk.bold(this.mcpServers[i].server), scope, "registered"]);
+            rows.push(["MCP", chalk.bold(this.mcpServers[i].server), scope, "registered"]);
         }
+        /*  report the ASE output style selections  */
+        for (const outputStyle of await this.outputStyleStatus(tool))
+            rows.push(["OUTPUTSTYLE", chalk.bold(outputStyle.file), outputStyle.scope, outputStyle.status]);
         /*  report the ASE statusline registrations  */
         for (const statusline of await this.statuslineStatus(tool))
-            table.push(["STATUSLINE", chalk.bold(statusline.file), statusline.scope, statusline.status]);
-        process.stdout.write(`${table.toString()}\n`);
+            rows.push(["STATUSLINE", chalk.bold(statusline.file), statusline.scope, statusline.status]);
+        process.stdout.write(renderTable(["KIND", "ID", "SCOPE", "STATUS"], rows));
         return 0;
     }
     /*  probe the ASE plugin registrations by scraping the human-readable
@@ -323,15 +329,9 @@ export default class SetupCommand {
     }
     /*  handler for "ase setup mcp list"  */
     async doMcpList() {
-        const table = new Table({
-            head: ["ID", "NAME", "VERS", "MCP", "KEY", "SKILLS"],
-            colWidths: [16, 16, 8, 21, 17, 20],
-            wordWrap: true,
-            chars: { "mid": "", "left-mid": "", "mid-mid": "", "right-mid": "" },
-            style: { head: ["blue"] }
-        });
+        const rows = [];
         for (const handle of this.mcpServers)
-            table.push([
+            rows.push([
                 chalk.bold(handle.id),
                 handle.name,
                 handle.version ?? "(unknown)",
@@ -339,7 +339,7 @@ export default class SetupCommand {
                 handle.env.join(", "),
                 handle.skills.join(", ")
             ]);
-        process.stdout.write(`${table.toString()}\n`);
+        process.stdout.write(renderTable(["ID", "NAME", "VERS", "MCP", "KEY", "SKILLS"], rows));
         return 0;
     }
     /*  handler for "ase setup mcp activate|deactivate [<servers>]"  */
@@ -672,7 +672,7 @@ export default class SetupCommand {
         "%P %h %B %c"
     ];
     /*  resolve the tool settings file for a given installation scope  */
-    statuslineSettingsFile(tool, scope) {
+    settingsFile(tool, scope) {
         if (tool === "copilot") {
             const home = process.env.COPILOT_HOME ?? "";
             const base = home !== "" ? home : path.join(os.homedir(), ".copilot");
@@ -728,11 +728,11 @@ export default class SetupCommand {
         }
         return false;
     }
-    /*  locate the top-level "statusLine" member node within the root object  */
-    statuslineFindMember(root) {
+    /*  locate a top-level member node by key within the root object  */
+    settingsFindMember(root, name) {
         for (const m of root.query("/ member")) {
             const key = m.query("/ string [ pos() == 1 ]")[0];
-            if (key !== undefined && key.get("value") === "statusLine")
+            if (key !== undefined && key.get("value") === name)
                 return m;
         }
         return undefined;
@@ -761,7 +761,7 @@ export default class SetupCommand {
         return root.create("member").add(key, obj);
     }
     /*  normalize the previous-last member so a following ",\n    " comma reads cleanly  */
-    statuslineMakeNonLast(member) {
+    settingsMakeNonLast(member) {
         const val = member.query("/ * [ pos() == 2 ]")[0];
         if (val !== undefined) {
             const ep = val.get("epilog");
@@ -770,8 +770,42 @@ export default class SetupCommand {
         }
         member.set({ epilog: ",\n    " });
     }
+    /*  append a member to the root object, repairing the whitespace at
+        the seam: a scalar value carries no pre-"}" newline of its own
+        (a container value carries it in its own epilog already), so the
+        root epilog has to supply it  */
+    settingsAddMember(root, member, scalar) {
+        const members = root.query("/ member");
+        if (members.length === 0)
+            root.set({ prolog: "{\n    " });
+        else
+            this.settingsMakeNonLast(members[members.length - 1]);
+        root.set({ epilog: scalar ? "\n}\n" : "}\n" });
+        root.add(member);
+    }
+    /*  remove a member from the root object, repairing the whitespace at the seam  */
+    settingsRemoveMember(root, target) {
+        const members = root.query("/ member");
+        const wasLast = members[members.length - 1] === target;
+        root.del(target);
+        if (wasLast) {
+            if (members.length > 1) {
+                /*  promote the new last member: strip its comma epilog and
+                    restore the pre-"}" newline into the root epilog when the
+                    new-last value is a scalar (a container value carries the
+                    newline in its own epilog already)  */
+                const newLast = members[members.length - 2];
+                newLast.set({ epilog: undefined });
+                const val = newLast.query("/ * [ pos() == 2 ]")[0];
+                const ep = val !== undefined ? val.get("epilog") : undefined;
+                root.set({ epilog: (typeof ep === "string" && ep.endsWith("\n")) ? "}\n" : "\n}\n" });
+            }
+            else
+                root.set({ epilog: "}\n" });
+        }
+    }
     /*  read a settings.json file into a JSON-ASTy AST  */
-    async statuslineReadAst(file) {
+    async settingsReadAst(file) {
         let text = "";
         try {
             text = await fs.readFile(file, "utf8");
@@ -784,7 +818,7 @@ export default class SetupCommand {
         return JsonAsty.parse(text);
     }
     /*  write a JSON-ASTy AST back to a settings.json file  */
-    async statuslineWriteAst(file, root) {
+    async settingsWriteAst(file, root) {
         await mkdirp(path.dirname(file));
         const text = JsonAsty.unparse(root);
         await writeFileAtomic(file, text, { encoding: "utf8" });
@@ -793,10 +827,10 @@ export default class SetupCommand {
     async doStatuslineActivate(tool, scope, opts, format) {
         this.requireStatuslineTool(tool);
         this.requireStatuslineScope(tool, scope);
-        const file = this.statuslineSettingsFile(tool, scope);
+        const file = this.settingsFile(tool, scope);
         const command = this.statuslineCommand(tool, opts, format);
-        const root = await this.statuslineReadAst(file);
-        const existing = this.statuslineFindMember(root);
+        const root = await this.settingsReadAst(file);
+        const existing = this.settingsFindMember(root, "statusLine");
         if (existing !== undefined) {
             /*  preserve a foreign, hand-crafted statusLine: skip and warn  */
             if (!this.statuslineIsOwned(existing)) {
@@ -813,27 +847,17 @@ export default class SetupCommand {
         }
         else {
             /*  insert a fresh statusLine member  */
-            const members = root.query("/ member");
-            const member = this.statuslineBuildMember(root, command);
-            if (members.length === 0) {
-                root.set({ prolog: "{\n    ", epilog: "}\n" });
-                root.add(member);
-            }
-            else {
-                root.set({ epilog: "}\n" });
-                this.statuslineMakeNonLast(members[members.length - 1]);
-                root.add(member);
-            }
+            this.settingsAddMember(root, this.statuslineBuildMember(root, command), false);
             this.log.write("info", `setup: statusline: activate: adding ASE "statusLine" to ${file}`);
         }
-        await this.statuslineWriteAst(file, root);
+        await this.settingsWriteAst(file, root);
         return 0;
     }
     /*  handler for "ase setup statusline deactivate"  */
     async doStatuslineDeactivate(tool, scope) {
         this.requireStatuslineTool(tool);
         this.requireStatuslineScope(tool, scope);
-        const file = this.statuslineSettingsFile(tool, scope);
+        const file = this.settingsFile(tool, scope);
         /*  a missing settings file means nothing to remove  */
         try {
             await fs.access(file);
@@ -843,8 +867,8 @@ export default class SetupCommand {
             return 0;
         }
         /*  read file  */
-        const root = await this.statuslineReadAst(file);
-        const target = this.statuslineFindMember(root);
+        const root = await this.settingsReadAst(file);
+        const target = this.settingsFindMember(root, "statusLine");
         if (target === undefined) {
             this.log.write("info", `setup: statusline: deactivate: no "statusLine" in ${file} (skipped)`);
             return 0;
@@ -856,26 +880,8 @@ export default class SetupCommand {
             return 0;
         }
         /*  remove the member and repair the whitespace at the seam  */
-        const members = root.query("/ member");
-        const wasLast = members[members.length - 1] === target;
-        root.del(target);
-        if (wasLast) {
-            if (members.length > 1) {
-                /*  promote the new last member: strip its comma epilog and
-                    restore the pre-"}" newline into the root epilog when the
-                    new-last value is a scalar (a container value carries the
-                    newline in its own epilog already)  */
-                const newLast = members[members.length - 2];
-                newLast.set({ epilog: undefined });
-                const val = newLast.query("/ * [ pos() == 2 ]")[0];
-                const ep = val !== undefined ? val.get("epilog") : undefined;
-                if (!(typeof ep === "string" && ep.endsWith("\n")))
-                    root.set({ epilog: "\n}\n" });
-            }
-            else
-                root.set({ epilog: "}\n" });
-        }
-        await this.statuslineWriteAst(file, root);
+        this.settingsRemoveMember(root, target);
+        await this.settingsWriteAst(file, root);
         this.log.write("info", `setup: statusline: deactivate: removing ASE "statusLine" from ${file}`);
         return 0;
     }
@@ -889,16 +895,16 @@ export default class SetupCommand {
         const scopes = tool === "claude" ? ["user", "project", "local"] : ["user"];
         const entries = [];
         for (const scope of scopes) {
-            const file = this.statuslineSettingsFile(tool, scope);
+            const file = this.settingsFile(tool, scope);
             let root;
             try {
-                root = await this.statuslineReadAst(file);
+                root = await this.settingsReadAst(file);
             }
             catch {
                 /*  an unparsable settings file carries no usable state  */
                 continue;
             }
-            const member = this.statuslineFindMember(root);
+            const member = this.settingsFindMember(root, "statusLine");
             if (member === undefined)
                 continue;
             entries.push({
@@ -909,6 +915,90 @@ export default class SetupCommand {
         }
         return entries;
     }
+    /*  determine whether an existing "outputStyle" value is owned by us  */
+    outputStyleIsOwned(member) {
+        const val = member.query("/ string [ pos() == 2 ]")[0];
+        return val !== undefined && val.get("value") === "ase:ase-terse";
+    }
+    /*  build the "outputStyle" member subtree natively inside the target AST  */
+    outputStyleBuildMember(root) {
+        const key = root.create("string").set({ body: JSON.stringify("outputStyle"), value: "outputStyle", epilog: ": " });
+        const val = root.create("string").set({ body: JSON.stringify("ase:ase-terse"), value: "ase:ase-terse" });
+        return root.create("member").add(key, val);
+    }
+    /*  activate the plugin-shipped ASE output style by selecting it in
+        the settings file of the scope (Anthropic Claude Code CLI only:
+        the other tools have no output style concept, so the session-start
+        hook injects the style into their session context instead)  */
+    async outputStyleActivate(action, scope) {
+        const file = this.settingsFile("claude", scope);
+        const root = await this.settingsReadAst(file);
+        const existing = this.settingsFindMember(root, "outputStyle");
+        if (existing !== undefined) {
+            /*  preserve a foreign, hand-selected outputStyle: skip and warn  */
+            if (!this.outputStyleIsOwned(existing))
+                this.log.write("warning", `setup: ${action}: a non-ASE "outputStyle" ` +
+                    `is already selected in ${file}: preserving it (skipped)`);
+            return;
+        }
+        this.settingsAddMember(root, this.outputStyleBuildMember(root), true);
+        await this.settingsWriteAst(file, root);
+        this.log.write("info", `setup: ${action}: selecting ASE "outputStyle" in ${file}`);
+    }
+    /*  deactivate the plugin-shipped ASE output style by removing its
+        selection from the settings file of the scope (Anthropic Claude Code CLI only)  */
+    async outputStyleDeactivate(action, scope) {
+        const file = this.settingsFile("claude", scope);
+        /*  a missing settings file means nothing to remove  */
+        try {
+            await fs.access(file);
+        }
+        catch {
+            return;
+        }
+        const root = await this.settingsReadAst(file);
+        const target = this.settingsFindMember(root, "outputStyle");
+        if (target === undefined)
+            return;
+        /*  preserve a foreign, hand-selected outputStyle: skip and warn  */
+        if (!this.outputStyleIsOwned(target)) {
+            this.log.write("warning", `setup: ${action}: a non-ASE "outputStyle" ` +
+                `is selected in ${file}: preserving it (skipped)`);
+            return;
+        }
+        this.settingsRemoveMember(root, target);
+        await this.settingsWriteAst(file, root);
+        this.log.write("info", `setup: ${action}: deselecting ASE "outputStyle" in ${file}`);
+    }
+    /*  probe the output style selections by inspecting the tool
+        settings files of all installation scopes (Anthropic Claude Code CLI only)  */
+    async outputStyleStatus(tool) {
+        if (tool !== "claude")
+            return [];
+        const home = os.homedir();
+        const scopes = ["user", "project", "local"];
+        const entries = [];
+        for (const scope of scopes) {
+            const file = this.settingsFile(tool, scope);
+            let root;
+            try {
+                root = await this.settingsReadAst(file);
+            }
+            catch {
+                /*  an unparsable settings file carries no usable state  */
+                continue;
+            }
+            const member = this.settingsFindMember(root, "outputStyle");
+            if (member === undefined)
+                continue;
+            entries.push({
+                file: file.startsWith(home + path.sep) ? `~${file.slice(home.length)}` : file,
+                scope,
+                status: this.outputStyleIsOwned(member) ? "selected" : "foreign"
+            });
+        }
+        return entries;
+    }
     /*  parse and validate the --tool option  */
     parseTool(value) {
         if (value !== "claude" && value !== "copilot" && value !== "codex")
@@ -997,7 +1087,7 @@ export default class SetupCommand {
         /*  register CLI sub-command "ase setup status"  */
         setupCmd
             .command("status")
-            .description("report the ASE plugin, MCP server, and statusline registrations for a tool")
+            .description("report the ASE plugin, MCP server, output style, and statusline registrations for a tool")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
             .action(async (opts) => {
             process.exit(await this.doStatus(this.parseTool(opts.tool)));

package/dst/ase-spec.js

@@ -18,18 +18,22 @@ import { writeStdout } from "./ase-stdio.js";
     project specification, located via the "project.artifact.spec.basedir"
     and "project.artifact.spec.schema" configuration  */
 export class Spec {
-    /*  resolve the YAML schema configuration files: the configured
-        "project.artifact.spec.schema" relative to the project root, or
-        the bundled standard "ase-format-specbook.yaml" plugin meta file
-        if unset or empty  */
+    /*  resolve the YAML schema configuration files: the whitespace-separated
+        entries of the configured "project.artifact.spec.schema", merged in
+        the given order, where each entry is either the literal "std" for the
+        bundled standard "ase-format-specbook.yaml" plugin meta file or a file
+        path relative to the project root, and an unset or empty value means "std"  */
     static configFiles(log) {
         const cfg = new Config("config", configSchema, log);
         cfg.read();
         const val = cfg.get("project.artifact.spec.schema");
-        const file = val === undefined ? "" : String(isScalar(val) ? val.value : val);
-        if (file === "")
-            return [Meta.resolve("ase-format-specbook.yaml")];
-        return [path.resolve(Task.projectRoot(), file)];
+        const list = val === undefined ? "" : String(isScalar(val) ? val.value : val);
+        const entries = list.split(/\s+/).filter((entry) => entry !== "");
+        if (entries.length === 0)
+            entries.push("std");
+        return entries.map((entry) => entry === "std" ?
+            Meta.resolve("ase-format-specbook.yaml") :
+            path.resolve(Task.projectRoot(), entry));
     }
     /*  the ASE log level each SpecBook verbosity level maps onto: the
         "none" level carries the messages a bare SpecBook CLI run always
@@ -80,12 +84,19 @@ export class Spec {
             return file;
         return rel.replace(/\\/g, "/");
     }
+    /*  every specification command honors the Git exclude rules, so that
+        SpecBook resolves the very same artifact files as "ase artifact
+        list --kind spec": both consult ".gitignore", so a specification
+        the project does not track is invisible to both instead of only
+        to one of them  */
+    static gitignore = true;
     /*  lint the specification Markdown files below the "spec" artifact
         base directory against the schema configuration  */
     static async lint(log) {
         const result = await Spec.unmarked(Spec.api(log).lint({
             config: Spec.configFiles(log),
-            basedir: Artifact.basedir(log, "spec")
+            basedir: Artifact.basedir(log, "spec"),
+            gitignore: Spec.gitignore
         }));
         return result.diagnostics.map((d) => ({ ...d, file: Spec.relativize(d.file) }));
     }
@@ -120,6 +131,7 @@ export class Spec {
         return Spec.unmarked(Spec.api(log, notices).export({
             config: Spec.configFiles(log),
             basedir: Artifact.basedir(log, "spec"),
+            gitignore: Spec.gitignore,
             formats
         }));
     }
@@ -131,6 +143,7 @@ export class Spec {
         return Spec.unmarked(Spec.api(log).watch({
             config: Spec.configFiles(log),
             basedir: Artifact.basedir(log, "spec"),
+            gitignore: Spec.gitignore,
             formats,
             outputs,
             onExport
@@ -143,6 +156,7 @@ export class Spec {
         return Spec.unmarked(Spec.api(log).preview({
             config: Spec.configFiles(log),
             basedir: Artifact.basedir(log, "spec"),
+            gitignore: Spec.gitignore,
             addr,
             port
         }));
@@ -246,7 +260,9 @@ export class SpecMCP {
             title: "ASE SpecBook lint",
             description: "Lint the SpecBook specification Markdown files of the project (located via the " +
                 "`project.artifact.spec.basedir` configuration) against the SpecBook YAML schema " +
-                "configuration (`project.artifact.spec.schema`, defaulting to the bundled `ase-format-specbook.yaml`). " +
+                "configuration (`project.artifact.spec.schema`, a whitespace-separated list of schema files " +
+                "merged in order, with `std` naming the bundled standard `ase-format-specbook.yaml`, " +
+                "which is also the default). " +
                 "Returns a `diagnostics` array of `{ file, line, column, severity, message }` objects (with " +
                 "project-relative `file` and a `severity` of `error` or `warning`), rendered as bullet " +
                 "points in `text`. With `verbose`, " +

package/dst/ase-table.js

@@ -0,0 +1,80 @@
+/*
+**  Agentic Software Engineering (ASE)
+**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Licensed under Apache 2.0 <https://spdx.org/licenses/Apache-2.0>
+*/
+import Table from "cli-table3";
+import { Diagram } from "./ase-diagram.js";
+/*  assumed terminal width in case the output is not a terminal at all  */
+const termWidthFallback = 80;
+/*  content width a column is at most shrunk down to, unless its own
+    content or its column head already is narrower anyway  */
+const colWidthMinimum = 8;
+/*  measure the visible width of a cell content, ignoring ANSI escape
+    sequences and honoring the longest line of a multi-line content  */
+const cellWidth = (text) => text.split("\n").reduce((width, line) => 
+/*  eslint-disable-next-line no-control-regex  */
+Math.max(width, line.replace(/\x1b\[[0-9;]*[A-Za-z]/g, "").length), 0);
+/*  check whether a cell content carries a single token which does not
+    fit the column and hence can be wrapped on character boundaries only  */
+const hasOverlongToken = (text, width) => text.split(/\s+/).some((token) => cellWidth(token) > width);
+/*  hard-break all over-long tokens of a cell content, so the content as
+    a whole can still be wrapped on its regular word boundaries; tokens
+    carrying ANSI escape sequences are left alone, as breaking them
+    would tear apart their escape sequences  */
+const breakOverlongTokens = (text, width) => text.split(/(\s+)/).map((token) => {
+    if (cellWidth(token) <= width || /\s/.test(token) || token.includes("\x1b"))
+        return token;
+    const chunks = [];
+    for (let i = 0; i < token.length; i += width)
+        chunks.push(token.slice(i, i + width));
+    return chunks.join("\n");
+}).join("");
+/*  reduce the column content widths until their sum fits the available
+    budget, by binary-searching the largest common upper cap which still
+    fits and which never cuts a column below its individual minimum  */
+const capWidths = (natural, minimum, budget) => {
+    const capped = (cap) => natural.map((width, i) => Math.max(Math.min(width, cap), Math.min(width, minimum[i])));
+    const total = (widths) => widths.reduce((sum, width) => sum + width, 0);
+    let lo = 1;
+    let hi = Math.max(...natural, 1);
+    while (lo < hi) {
+        const mid = Math.floor((lo + hi + 1) / 2);
+        if (total(capped(mid)) <= budget)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return capped(lo);
+};
+/*  render a table which never exceeds the terminal width, by wrapping
+    over-wide cell contents over multiple lines instead  */
+export const renderTable = (head, rows) => {
+    const cols = head.length;
+    /*  determine the natural, still unwrapped content width per column  */
+    const natural = head.map((text, i) => rows.reduce((width, row) => Math.max(width, cellWidth(row[i] ?? "")), cellWidth(text)));
+    /*  shrink the columns down to the width still remaining after the
+        border characters and the padding spaces of all columns  */
+    const term = Diagram.detectTermWidth() || termWidthFallback;
+    const budget = Math.max(term - (3 * cols + 1), cols);
+    const minimum = head.map((text) => Math.max(cellWidth(text), colWidthMinimum));
+    const widths = capWidths(natural, minimum, budget);
+    /*  render the table, falling back to wrapping on character
+        boundaries in just those cells where a token still overflows  */
+    const table = new Table({
+        head,
+        colWidths: widths.map((width) => width + 2),
+        wordWrap: true,
+        chars: { "mid": "", "left-mid": "", "mid-mid": "", "right-mid": "" },
+        style: { head: ["blue"] }
+    });
+    for (const row of rows)
+        table.push(row.map((text, i) => {
+            const content = breakOverlongTokens(text, widths[i]);
+            return {
+                content,
+                wrapOnWordBoundary: !hasOverlongToken(content, widths[i])
+            };
+        }));
+    return `${table.toString()}\n`;
+};

package/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "https://ase.tools",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "https://github.com/rse/ase/issues" },
-    "version":                              "1.0.4",
+    "version":                              "1.0.6",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -26,11 +26,11 @@
         "globals":                          "17.12.0",
         "typescript":                       "6.0.3",
 
-        "@rse/stx":                         "1.1.6",
+        "@rse/stx":                         "1.1.7",
         "nodemon":                          "3.1.14",
         "shx":                              "0.4.0",
 
-        "@types/node":                      "26.5.0",
+        "@types/node":                      "26.5.1",
         "@types/luxon":                     "3.7.5",
         "@types/which":                     "3.0.4",
         "@types/update-notifier":           "6.0.8",
@@ -42,8 +42,8 @@
     },
     "dependencies": {
         "commander":                        "15.0.0",
-        "@dotenvx/dotenvx":                 "2.23.0",
-        "yaml":                             "2.9.0",
+        "@dotenvx/dotenvx":                 "2.24.1",
+        "yaml":                             "2.9.1",
         "valibot":                          "1.5.0",
         "execa":                            "10.0.1",
         "mkdirp":                           "3.0.1",
@@ -55,7 +55,7 @@
         "luxon":                            "3.7.2",
         "@modelcontextprotocol/sdk":        "1.30.0",
         "json-asty":                        "1.3.4",
-        "zod":                              "4.6.1",
+        "zod":                              "4.6.5",
         "which":                            "7.0.0",
         "update-notifier":                  "7.3.1",
         "shell-quote":                      "1.10.0",
@@ -66,7 +66,7 @@
         "ofetch":                           "1.5.1",
         "picomatch":                        "4.0.7",
         "lru-cache":                        "11.5.2",
-        "@rse/specbook":                    "1.2.9",
+        "@rse/specbook":                    "1.2.13",
         "source-code-error":                "1.2.0",
         "pure-uuid":                        "2.0.0"
     },

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

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

package/plugin/.codex-plugin/plugin.json

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