@rse/ase 0.0.61 → 0.9.0

package/dst/ase-diagram.js

@@ -20,6 +20,15 @@ const parseColorMode = (name) => (value) => {
         throw new InvalidArgumentError(`${name} must be "none", "ansi16", or "ansi256"`);
     return value;
 };
+/*  scan a CSI escape sequence starting at line[i] (where line[i]===ESC and
+    line[i+1]==="["); return the index just past the terminating letter, or
+    -1 if the sequence is unterminated within the line  */
+const scanAnsiSeq = (line, i) => {
+    let j = i + 2;
+    while (j < line.length && !/[A-Za-z]/.test(line[j]))
+        j++;
+    return j < line.length ? j + 1 : -1;
+};
 /*  truncate a single rendered line to a maximum visible column,
     preserving ANSI escape sequences (CSI ...m) and appending an ANSI
     reset sequence if any styling was active at the truncation point  */
@@ -33,20 +42,15 @@ const truncateAnsiLine = (line, budget) => {
     while (i < line.length) {
         const ch = line[i];
         if (ch === "\x1b" && line[i + 1] === "[") {
-            let j = i + 2;
-            while (j < line.length && !/[A-Za-z]/.test(line[j]))
-                j++;
-            if (j < line.length) {
-                const seq = line.slice(i, j + 1);
+            const j = scanAnsiSeq(line, i);
+            if (j >= 0) {
+                const seq = line.slice(i, j);
                 out += seq;
                 if (seq.endsWith("m")) {
                     const body = seq.slice(2, -1);
-                    if (body === "" || body === "0")
-                        styled = false;
-                    else
-                        styled = true;
+                    styled = !(body === "" || body === "0");
                 }
-                i = j + 1;
+                i = j;
                 continue;
             }
             i++;
@@ -70,11 +74,9 @@ const visibleWidth = (line) => {
     while (i < line.length) {
         const ch = line[i];
         if (ch === "\x1b" && line[i + 1] === "[") {
-            let j = i + 2;
-            while (j < line.length && !/[A-Za-z]/.test(line[j]))
-                j++;
-            if (j < line.length) {
-                i = j + 1;
+            const j = scanAnsiSeq(line, i);
+            if (j >= 0) {
+                i = j;
                 continue;
             }
             i++;
@@ -87,39 +89,30 @@ const visibleWidth = (line) => {
 };
 /*  reusable functionality: Mermaid diagram rendering as Unicode/ASCII art  */
 export class Diagram {
-    /*  detect terminal column width  */
-    static detectTermWidth() {
-        let width = 0;
+    static detectTermDimension(envVar, stdoutProp) {
+        let value = 0;
         /*  attempt 1: query environment variable  */
-        if (process.env.ASE_TERM_WIDTH !== undefined) {
-            const cols = Number.parseInt(process.env.ASE_TERM_WIDTH, 10);
-            if (Number.isFinite(cols) && cols > 0)
-                width = cols;
+        const env = process.env[envVar];
+        if (env !== undefined) {
+            const n = Number.parseInt(env, 10);
+            if (Number.isFinite(n) && n > 0)
+                value = n;
         }
         /*  attempt 2: query stdout  */
-        if (width === 0 && process.stdout.isTTY) {
-            const cols = process.stdout.columns;
-            if (typeof cols === "number" && cols > 0)
-                width = cols;
+        if (value === 0 && process.stdout.isTTY) {
+            const n = process.stdout[stdoutProp];
+            if (typeof n === "number" && n > 0)
+                value = n;
         }
-        return width;
+        return value;
+    }
+    /*  detect terminal column width  */
+    static detectTermWidth() {
+        return Diagram.detectTermDimension("ASE_TERM_WIDTH", "columns");
     }
     /*  detect terminal row height  */
     static detectTermHeight() {
-        let height = 0;
-        /*  attempt 1: query environment variable  */
-        if (process.env.ASE_TERM_HEIGHT !== undefined) {
-            const rows = Number.parseInt(process.env.ASE_TERM_HEIGHT, 10);
-            if (Number.isFinite(rows) && rows > 0)
-                height = rows;
-        }
-        /*  attempt 2: query stdout  */
-        if (height === 0 && process.stdout.isTTY) {
-            const rows = process.stdout.rows;
-            if (typeof rows === "number" && rows > 0)
-                height = rows;
-        }
-        return height;
+        return Diagram.detectTermDimension("ASE_TERM_HEIGHT", "rows");
     }
     /*  detect terminal color capability  */
     static detectColorMode() {

package/dst/ase-mcp.js

@@ -22,10 +22,8 @@ export default class MCPCommand {
         cfg.read();
         const svc = new Config("service", serviceSchema, this.log);
         svc.read();
-        const rawId = cfg.get("project.id");
-        const projectId = rawId ?? path.basename(process.cwd());
-        const rawPort = svc.get("port");
-        const port = rawPort ?? null;
+        const projectId = cfg.get("project.id") ?? path.basename(process.cwd());
+        const port = svc.get("port") ?? null;
         return { projectId, port };
     }
     /*  run "ase service start" and wait for the service to come up  */
@@ -59,7 +57,7 @@ export default class MCPCommand {
     /*  bridge stdio to a Streamable HTTP MCP endpoint on the local service  */
     async runBridge() {
         /*  ensure the service is running  */
-        let { port } = await this.ensureService();
+        let { projectId, port } = await this.ensureService();
         /*  create MCP STDIO server (lives for the entire bridge lifetime)  */
         const server = new StdioServerTransport();
         /*  track active client and bridge-level closed state  */
@@ -96,19 +94,17 @@ export default class MCPCommand {
             next.onclose = () => {
                 if (client !== next || closedByUs || bridgeDone || reconnecting)
                     return;
-                reconnecting = true;
-                this.log.write("warning", "mcp: http connection lost — reconnecting");
-                reconnect(0, () => { reconnecting = false; }).catch(() => { });
+                triggerReconnect("http connection lost");
             };
             await next.start();
             client = next;
         };
         /*  reconnect loop: restart service if needed, then reconnect client  */
-        const reconnect = async (attempt = 0, done) => {
+        const reconnect = async (attempt = 0) => {
             const delay = Math.min(500 * 2 ** attempt, 10000);
             await new Promise((resolve) => setTimeout(resolve, delay));
             if (bridgeDone) {
-                done?.();
+                reconnecting = false;
                 return;
             }
             try {
@@ -118,15 +114,21 @@ export default class MCPCommand {
                 await client?.close();
                 await connectClient();
                 closedByUs = false;
+                reconnecting = false;
                 this.log.write("info", "mcp: reconnected to service");
-                done?.();
             }
             catch (err) {
                 closedByUs = false;
                 this.log.write("error", `mcp: reconnect failed: ${this.asError(err).message}`);
-                reconnect(attempt + 1, done).catch(() => { });
+                reconnect(attempt + 1).catch(() => { });
             }
         };
+        /*  trigger a reconnect chain (idempotent while one is active)  */
+        const triggerReconnect = (reason) => {
+            reconnecting = true;
+            this.log.write("warning", `mcp: ${reason} — reconnecting`);
+            reconnect(0).catch(() => { });
+        };
         /*  wire stdio server  */
         server.onmessage = (msg) => {
             client?.send(msg).catch((err) => {
@@ -148,16 +150,12 @@ export default class MCPCommand {
             if (bridgeDone || reconnecting)
                 return;
             try {
-                const { projectId } = this.loadContext();
                 const match = await probe(port, projectId);
-                if (match !== true) {
-                    reconnecting = true;
-                    this.log.write("warning", "mcp: health check failed — reconnecting");
-                    reconnect(0, () => { reconnecting = false; }).catch(() => { });
-                }
+                if (match !== true)
+                    triggerReconnect("health check failed");
             }
             catch (err) {
-                /*  ignore transient probe/context errors but record them  */
+                /*  ignore transient probe errors but record them  */
                 this.log.write("debug", `mcp: health check error: ${this.asError(err).message}`);
             }
         }, HEALTH_INTERVAL_MS);
@@ -171,7 +169,6 @@ export default class MCPCommand {
         /*  shutdown services  */
         clearInterval(healthTimer);
         await shutdown();
-        return 0; /*  unreachable, kept only to satisfy the Promise<number> return type  */
     }
     /*  register commands  */
     register(program) {
@@ -179,7 +176,8 @@ export default class MCPCommand {
             .command("mcp")
             .description("Bridge stdio MCP to the per-project background service over Streamable HTTP")
             .action(async () => {
-            process.exit(await this.runBridge());
+            await this.runBridge();
+            process.exit(0);
         });
     }
 }

package/dst/ase-persona.js

@@ -51,14 +51,14 @@ export default class PersonaMCP {
                 "If `session` is provided, the operation is scoped to that session, " +
                 "otherwise it operates on the strongest/closest scope (user/project cascade). " +
                 "Allowed styles: \"writer\" (decorative, eloquent, explaining), " +
-                "\"engineer\" (brief, factual, accurate), " +
+                "\"engineer\" (concise, factual, accurate), " +
                 "\"telegrapher\" (very brief, factual, abbreviating), " +
                 "\"caveman\" (ultra brief, rough, stuttering).",
             inputSchema: {
                 style: z.enum(Persona.styles).optional()
                     .describe("persona style to set; if omitted, the current persona style is returned"),
                 session: z.string().optional()
-                    .describe("session identifier (allowed characters: A-Z, a-z, 0-9, '-'); " +
+                    .describe("session identifier (allowed characters: A-Z, a-z, 0-9, '.', '_', '-'); " +
                     "if omitted, the operation is not scoped to a specific session")
             }
         }, async (args) => {

package/dst/ase-statusline.js

@@ -346,10 +346,10 @@ export default class StatuslineCommand {
                     emit(`${prefix("◔", "context")}${bar} ${pct}%`);
                 },
                 C: () => {
-                    const context = Math.floor(data.context_window?.used_percentage ?? 0);
+                    const pct = Math.floor(data.context_window?.used_percentage ?? 0);
                     const tokensCur = (data.context_window?.total_input_tokens ?? 0) +
                         (data.context_window?.total_output_tokens ?? 0);
-                    const tokensLim = context > 0 && tokensCur > 0 ? Math.round(tokensCur * 100 / context) : 0;
+                    const tokensLim = pct > 0 && tokensCur > 0 ? Math.round(tokensCur * 100 / pct) : 0;
                     if (tokensLim > 0)
                         emit(`${prefix("◆", "tokens")}${c.bold(formatTokens(tokensCur) + "/" + formatTokens(tokensLim))}`);
                 },

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.61",
+    "version":                              "0.9.0",
     "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.60.0",
-        "@typescript-eslint/eslint-plugin": "8.60.0",
+        "@typescript-eslint/parser":        "8.60.1",
+        "@typescript-eslint/eslint-plugin": "8.60.1",
         "eslint-plugin-promise":            "7.3.0",
         "eslint-plugin-import":             "2.32.0",
         "neostandard":                      "0.13.0",
@@ -40,8 +40,8 @@
         "@types/pacote":                    "11.1.8"
     },
     "dependencies": {
-        "commander":                        "14.0.3",
-        "@dotenvx/dotenvx":                 "1.69.0",
+        "commander":                        "15.0.0",
+        "@dotenvx/dotenvx":                 "1.71.0",
         "yaml":                             "2.9.0",
         "valibot":                          "1.4.1",
         "execa":                            "9.6.1",

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

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

package/plugin/agents/ase-code-lint.md

@@ -269,6 +269,7 @@ Workflow
 
         <template>
         ● **WHAT**: [...]
+
         ○ **WHY**:  [...]
         </template>
 
@@ -279,6 +280,11 @@ Workflow
         text with Markdown based on the following <template/>:
         <template>"`<words/>`"</template>.
 
+        For all code references, always use a relative filename and
+        append the related single 1-based line number N as `:N` or the
+        related 1-based line number range as `:N-M` to the end of the
+        filename.
+
     4.  Create the change set.
         For this, set <change-set></change-set> (set changes to empty).
 

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.61",
+    "version":                              "0.9.0",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",

package/plugin/skills/ase-docs-proofread/help.md

@@ -51,4 +51,4 @@ Proofread an entire documentation directory automatically:
 
 ##  SEE ALSO
 
-`ase-code-lint`, `ase-meta-changes`.
+`ase-code-lint`, `ase-meta-changelog`.

package/plugin/skills/{ase-meta-changes → ase-meta-changelog}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ase-meta-changes
+name: ase-meta-changelog
 argument-hint: "[--help|-h]"
 description: >
     Update changes entries in CHANGELOG.md files
@@ -17,7 +17,7 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-<skill name="ase-meta-changes">
+<skill name="ase-meta-changelog">
 Update ChangeLog Entries
 </skill>
 

package/plugin/skills/{ase-meta-changes → ase-meta-changelog}/help.md

@@ -1,16 +1,16 @@
 
 ##  NAME
 
-`ase-meta-changes` - Update ChangeLog Entries
+`ase-meta-changelog` - Update ChangeLog Entries
 
 ##  SYNOPSIS
 
-`ase-meta-changes`
+`ase-meta-changelog`
     [`--help`|`-h`]
 
 ##  DESCRIPTION
 
-The `ase-meta-changes` skill helps to *complete*, *consolidate*, and
+The `ase-meta-changelog` skill helps to *complete*, *consolidate*, and
 *sort* the entries of the most recent section of a `CHANGELOG.md`
 file, based on the underlying *Git* commits and the currently staged
 changes in the Git *index*.
@@ -25,7 +25,7 @@ date in the section header is also updated to the current date.
 Update the most recent ChangeLog section:
 
 ```text
-❯ /ase-meta-changes
+❯ /ase-meta-changelog
 ```
 
 ##  SEE ALSO

package/plugin/skills/ase-meta-commit/help.md

@@ -28,4 +28,4 @@ Craft a commit message for the currently staged changes:
 
 ##  SEE ALSO
 
-`ase-meta-changes`.
+`ase-meta-changelog`.

package/plugin/skills/ase-meta-diff/help.md

@@ -78,4 +78,4 @@ Summarize the staged changes and append a blast-radius map:
 
 ##  SEE ALSO
 
-`ase-meta-commit`, `ase-meta-changes`, `ase-arch-analyze`.
+`ase-meta-commit`, `ase-meta-changelog`, `ase-arch-analyze`.

package/dst/ase-hello.js

@@ -1,27 +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";
-/*  forced-color chalk instance: stdout is a pipe under Claude Code,
-    so chalk auto-detection would yield level 0; force level 1 to keep
-    emitting ANSI sequences as the original implementation did  */
-const c = new Chalk({ level: 1 });
-/*  command-line handling  */
-export default class HelloCommand {
-    log;
-    constructor(log) {
-        this.log = log;
-    }
-    /*  register commands  */
-    register(program) {
-        program
-            .command("hello")
-            .description("Show a greeting message")
-            .option("-s, --subject <subject>", "subject to greet", "Universe")
-            .action(async (opts) => {
-            process.stdout.write(c.red(`${opts.subject} World!`) + "\n");
-        });
-    }
-}