@rse/ase 0.9.46 → 0.9.48

package/dst/ase-statusline.js

@@ -11,7 +11,7 @@ import { InvalidArgumentError } from "commander";
 import { execaSync } from "execa";
 import { Chalk } from "chalk";
 import { Config, configSchema, parseScope } from "./ase-config.js";
-import { writeStdout } from "./ase-stdout.js";
+import { readStdin, writeStdout } from "./ase-stdio.js";
 import pkg from "../package.json" with { type: "json" };
 /*  forced-color chalk instance: stdout is a pipe under Anthropic Claude Code CLI,
     so chalk auto-detection would yield level 0; force level 1 to keep
@@ -28,13 +28,6 @@ const parseInteger = (name) => (value) => {
         throw new InvalidArgumentError(`${name} must be a non-negative integer`);
     return n;
 };
-/*  read stdin into a single string  */
-const readStdin = async () => {
-    const chunks = [];
-    for await (const chunk of process.stdin)
-        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
-    return Buffer.concat(chunks).toString("utf8");
-};
 /*  detect terminal column width via /dev/tty (stdout is a pipe under Anthropic Claude Code CLI)  */
 const detectTermWidth = () => {
     let width = 0;
@@ -166,6 +159,11 @@ const probeMemory = () => {
         return { used: 0, total: 0 };
     }
 };
+/*  memoize a zero-argument function, computing its value at most once on first use  */
+const memoize = (fn) => {
+    let cache = null;
+    return () => (cache ??= { value: fn() }).value;
+};
 /*  command-line handling  */
 export default class StatuslineCommand {
     log;
@@ -213,8 +211,7 @@ export default class StatuslineCommand {
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
-                this.log.write("error", `statusline: invalid JSON on stdin: ${message}`);
-                process.exit(1);
+                throw new Error(`statusline: invalid JSON on stdin: ${message}`);
             }
             /*  normalize Copilot CLI's top-level "cwd" into the
                 "workspace.current_dir" structure shared with Anthropic Claude Code CLI  */
@@ -263,16 +260,8 @@ export default class StatuslineCommand {
             /*  lazy memoized probes for cross-renderer values: each is computed at most
                 once per run and only when first requested by a renderer (or by the
                 post-loop tmux publish for the Config cascade)  */
-            let sessCache = null;
-            const getSession = () => {
-                if (sessCache === null)
-                    sessCache = data.session_id ?? "unknown";
-                return sessCache;
-            };
-            let cfgCache = null;
-            const getCfg = () => {
-                if (cfgCache !== null)
-                    return cfgCache;
+            const getSession = memoize(() => data.session_id ?? "unknown");
+            const getCfg = memoize(() => {
                 let taskId = process.env.ASE_TASK_ID ?? "";
                 let persona = process.env.ASE_PERSONA_STYLE ?? "";
                 try {
@@ -288,21 +277,10 @@ export default class StatuslineCommand {
                 catch (_e) {
                     /*  cascade unavailable; keep env-var fallbacks  */
                 }
-                cfgCache = { taskId, persona };
-                return cfgCache;
-            };
-            let gitCache = null;
-            const getGit = () => {
-                if (gitCache === null)
-                    gitCache = probeGit(data.workspace?.current_dir ?? "");
-                return gitCache;
-            };
-            let memCache = null;
-            const getMem = () => {
-                if (memCache === null)
-                    memCache = probeMemory();
-                return memCache;
-            };
+                return { taskId, persona };
+            });
+            const getGit = memoize(() => probeGit(data.workspace?.current_dir ?? ""));
+            const getMem = memoize(() => probeMemory());
             /*  identifier to renderer map: each callback fetches its own information
                 directly from data (or via the lazy helpers above for shared values)  */
             const renderers = {
@@ -354,10 +332,18 @@ export default class StatuslineCommand {
                     emit(`${prefix("◔", "context")}${bar} ${pct}%`);
                 },
                 C: () => {
-                    const pct = data.context_window?.used_percentage ?? 0;
-                    const tokensCur = (data.context_window?.total_input_tokens ?? 0) +
-                        (data.context_window?.total_output_tokens ?? 0);
-                    const tokensLim = pct > 0 && tokensCur > 0 ? Math.round(tokensCur * 100 / pct) : 0;
+                    /*  probe the live-context fields first and fall back to the
+                        cumulative ones, so each harness contributes its own view:
+                        GitHub Copilot CLI reports the live window separately (its
+                        "total_*" are session sums), whereas Anthropic Claude Code CLI
+                        folds it into "total_input_tokens". Output tokens stay out --
+                        "used_percentage" is input-side only.  */
+                    const cw = data.context_window;
+                    const pct = cw?.used_percentage ?? 0;
+                    const tokensCur = cw?.current_context_tokens ??
+                        cw?.last_call_input_tokens ?? cw?.total_input_tokens ?? 0;
+                    const tokensLim = cw?.displayed_context_limit ?? cw?.context_window_size ??
+                        (pct > 0 && tokensCur > 0 ? Math.round(tokensCur * 100 / pct) : 0);
                     if (tokensLim > 0)
                         emit(`${prefix("◆", "tokens")}${c.bold(formatTokens(tokensCur) + "/" + formatTokens(tokensLim))}`);
                 },
@@ -432,11 +418,11 @@ export default class StatuslineCommand {
                 },
                 /*  ==== VERSIONS ====  */
                 V: () => {
-                    const ccVersion = data.version ?? "";
+                    const toolVersion = data.version ?? "";
                     const aseVersion = pkg.version ?? "";
                     let version = "";
-                    if (ccVersion !== "")
-                        version += `claude/${ccVersion}`;
+                    if (toolVersion !== "")
+                        version += `${tool}/${toolVersion}`;
                     if (aseVersion !== "")
                         version += `${version !== "" ? " " : ""}ase/${aseVersion}`;
                     emit(`${prefix("⎈", "version")}${c.bold(version)}`);

package/dst/ase-stdio.js

@@ -0,0 +1,25 @@
+/*
+**  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 getStdin from "get-stdin";
+/*  read the entire stdin payload as a UTF-8 string, treating an
+    interactive terminal as empty input so callers never block on a
+    user which is not going to type anything  */
+export const readStdin = () => {
+    return getStdin();
+};
+/*  write a string to stdout, awaiting the write callback which only
+    fires once the data has been flushed to the underlying pipe, so a
+    subsequent "process.exit" cannot truncate the output  */
+export const writeStdout = (text) => {
+    return new Promise((resolve, reject) => {
+        process.stdout.write(text, (err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        });
+    });
+};

package/dst/ase-task.js

@@ -13,7 +13,7 @@ import { z } from "zod";
 import { LRUCache } from "lru-cache";
 import { Config, configSchema, parseScope } from "./ase-config.js";
 import { Markdown } from "./ase-markdown.js";
-import { writeStdout } from "./ase-stdout.js";
+import { readStdin, writeStdout } from "./ase-stdio.js";
 /*  reusable functionality: persisted task plans under
     <project>/<basedir>/TASK-<id>.md (driven by the
     "project.artifact.task.{basedir,files}" configuration)  */
@@ -56,11 +56,18 @@ export class Task {
         Task.projectRootCache.set(cwd, root);
         return root;
     }
+    /*  cached task storage specification (TTL-bounded, mirroring the project
+        root cache, as each read parses the whole layered YAML config chain)  */
+    static specCache = new LRUCache({ max: 4, ttl: 2 * 1000 });
     /*  read the configured "basedir" anchor and "files" miniglob spec for
         task storage; "basedir" is project-root-relative (POSIX, defaults
         to ".ase/task") and "files" constrains the task filenames
         (defaults to "*.md")  */
     static spec(log) {
+        const root = Task.projectRoot();
+        const cached = Task.specCache.get(root);
+        if (cached !== undefined)
+            return cached;
         const cfg = new Config("config", configSchema, log);
         cfg.read();
         const read = (key) => {
@@ -71,8 +78,12 @@ export class Task {
         };
         const basedir = (read("project.artifact.task.basedir") || ".ase/task")
             .replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+        if (basedir.split("/").includes(".."))
+            throw new Error(`task: configured "basedir" "${basedir}" must not escape the project root`);
         const files = read("project.artifact.task.files") || "*.md";
-        return { basedir, files };
+        const result = { basedir, files };
+        Task.specCache.set(root, result);
+        return result;
     }
     /*  resolve the on-disk base directory for task storage  */
     static baseDir(log) {
@@ -89,33 +100,18 @@ export class Task {
     }
     /*  resolve the on-disk path for a given task id; as a side effect,
         eagerly migrate any legacy <basedir>/<id>/plan.md files to the
-        current <basedir>/TASK-<id>.md layout on first access (guarded by
-        a cheap check, so it is a no-op once the store is migrated)  */
+        current <basedir>/TASK-<id>.md layout ("migrateAll" is a cheap
+        no-op once the store is migrated)  */
     static path(log, id) {
         Task.validateId(id);
         Task.enforceFiles(log, id);
-        if (Task.needsMigration(log))
-            Task.migrateAll(log);
+        Task.migrateAll(log);
         return path.join(Task.baseDir(log), `TASK-${id}.md`);
     }
-    /*  cheaply check whether any legacy <basedir>/<id>/plan.md file still
-        exists in the task base directory and thus needs migration  */
-    static needsMigration(log) {
-        const dir = Task.baseDir(log);
-        if (!fs.existsSync(dir))
-            return false;
-        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-            if (!entry.isDirectory() || !/^[A-Za-z0-9_-]+$/.test(entry.name))
-                continue;
-            if (fs.existsSync(path.join(dir, entry.name, "plan.md")))
-                return true;
-        }
-        return false;
-    }
     /*  migrate all legacy <basedir>/<id>/plan.md task files to the current
         <basedir>/TASK-<id>.md layout; an existing TASK-<id>.md is never
-        overwritten; the now-empty <id>/ directory is removed afterwards;
-        returns the list of migrated task ids in lexicographic order  */
+        overwritten; the legacy <id>/ directory is removed only if it is
+        empty afterwards; returns the migrated task ids in lexicographic order  */
     static migrateAll(log) {
         const dir = Task.baseDir(log);
         if (!fs.existsSync(dir))
@@ -134,7 +130,12 @@ export class Task {
                 continue;
             }
             fs.renameSync(oldFile, newFile);
-            fs.rmSync(path.join(dir, id), { recursive: true, force: true });
+            /*  drop the legacy directory, but only if it is really empty  */
+            const legacyDir = path.dirname(oldFile);
+            if (fs.readdirSync(legacyDir).length === 0)
+                fs.rmdirSync(legacyDir);
+            else
+                log.write("warning", `task: keeping non-empty legacy directory "${legacyDir}"`);
             migrated.push(id);
         }
         migrated.sort((a, b) => a.localeCompare(b));
@@ -187,8 +188,7 @@ export class Task {
     /*  scan the task base directory (after eager migration) for
         "TASK-<id>.md" files matching the configured "files" miniglob  */
     static scan(log) {
-        if (Task.needsMigration(log))
-            Task.migrateAll(log);
+        Task.migrateAll(log);
         const { basedir, files } = Task.spec(log);
         const dir = path.join(Task.projectRoot(), basedir);
         if (!fs.existsSync(dir))
@@ -254,15 +254,6 @@ export class Task {
         });
     }
 }
-/*  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 task"  */
 export default class TaskCommand {
     log;

package/dst/ase.js

@@ -59,12 +59,16 @@ const main = async () => {
     /*  parse program arguments  */
     await program.parseAsync(process.argv);
     /*  gracefully terminate  */
-    process.exit(0);
+    await log.close();
+    process.exit(process.exitCode ?? 0);
 };
-main().catch((err) => {
-    if (err instanceof CommanderError)
+main().catch(async (err) => {
+    if (err instanceof CommanderError) {
+        await log.close();
         process.exit(err.exitCode);
+    }
     const message = err instanceof Error ? err.message : String(err);
     log.write("error", message);
+    await log.close();
     process.exit(1);
 });

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":                              "0.9.46",
+    "version":                              "0.9.48",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",

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

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

package/plugin/etc/stx.conf

@@ -11,12 +11,12 @@ lint
 
 #   [plugin] build project
 build : lint
-    (   for name in $(cd skills; ls -1 | grep -v ase-meta-intent | sort); do
+    (   for name in $(cd skills; ls -1 | grep -v ase-help-intent | sort); do
             echo "<skill name=\"$name\">"
             cat skills/$name/help.md | sed -e '/^##  SEE ALSO/,$d'
             echo "</skill>"
         done
-    ) >skills/ase-meta-intent/data.md
+    ) >skills/ase-help-intent/data.md
 
 #   [plugin] remove all generated files
 clean

package/plugin/meta/ase-skill.md

@@ -140,6 +140,15 @@ Skill Sequential Processing
 -   *IMPORTANT*: For each <step/> you *MUST* use the `TaskUpdate` tool
     for updating its status *during* processing, once a <step/> finished.
 
+-   *IMPORTANT*: Whenever a skill *stops early* -- because a <step/>
+    instructed you to *STOP* processing (on an error, a cancelled
+    dialog, a short-circuit branch, or any other early exit) -- you
+    *MUST*, *before* emitting the final <template/>, use the `TaskUpdate`
+    tool to set the status of *every* still `pending` or `in_progress`
+    task of the current <flow/> to `deleted`, so that no task of a
+    finished skill remains open. Steps that were *skipped* because their
+    `condition` attribute was not met *MUST* be treated the same way.
+
 -   *IMPORTANT*: You *MUST* *strictly sequentially* execute every <step/> in
     a <flow/>. You *MUST* not implicitly skip any <step/> during
     processing, except you were explicitly requested to do this or the

package/plugin/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":                              "0.9.46",
+    "version":                              "0.9.48",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",

package/plugin/skills/{ase-meta-intent → ase-help-intent}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ase-meta-intent
+name: ase-help-intent
 argument-hint: "[--help|-h] <intent>"
 description: >
     Match a free-text intent against the accumulated help of all ASE
@@ -20,12 +20,12 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-intent">
+<skill name="ase-help-intent">
 Match an Intent to an ASE Command
 </skill>
 
 <expand name="getopt"
-    arg1="ase-meta-intent"
+    arg1="ase-help-intent"
     arg2="">
     $ARGUMENTS
 </expand>
@@ -54,7 +54,7 @@ catalog you match <intent/> against:
     processing the entire current skill:
 
     <template>
-    ⧉ **ASE**: ✪ skill: **ase-meta-intent**, ▶ ERROR: expected a `<intent>` argument
+    ⧉ **ASE**: ✪ skill: **ase-help-intent**, ▶ ERROR: expected a `<intent>` argument
     </template>
     </if>
 
@@ -102,16 +102,11 @@ catalog you match <intent/> against:
         <template>
         <ase-tpl-head title="SKILL COMMAND PROPOSAL"/>
 
-        ●   **INTENT**:
-        ○   <intent/>
-
-        ●   **COMMAND**:
-        ⌘   `<command/>`
-
-        ●   **RATIONALE**:
-        ○   <rationale/>
+        ❯ `<command/>`
 
         <ase-tpl-foot title="SKILL COMMAND PROPOSAL"/>
+
+        **RATIONALE**: <rationale/>
         </template>
 
     4.  *Dispatch Command*:

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

@@ -1,19 +1,19 @@
 
 ##  NAME
 
-`ase-meta-intent` - Match an Intent to an ASE Command
+`ase-help-intent` - Match an Intent to an ASE Command
 
 ##  SYNOPSIS
 
-`ase-meta-intent`
+`ase-help-intent`
     [`--help`|`-h`]
     *intent*
 
 ##  DESCRIPTION
 
-The `ase-meta-intent` skill matches a free-text *intent* against the
+The `ase-help-intent` skill matches a free-text *intent* against the
 *accumulated help* of all ASE skills -- the concatenation of every
-skill's `help.md` file into `skills/ase-meta-intent/data.md`, built by
+skill's `help.md` file into `skills/ase-help-intent/data.md`, built by
 `npm start build` in `plugin/` -- and generates the *single* best-fitting
 `/ase:ase-xxx-xxx` command that realizes the intent, complete with
 concrete option flags and positional arguments derived from the selected
@@ -42,15 +42,16 @@ entirely through the intent argument and the interactive dialog.
 Route an intent to the matching command and pick from the dialog:
 
 ```text
-❯ /ase-meta-intent lint the TypeScript sources for high-severity issues only
+❯ /ase-help-intent lint the TypeScript sources for high-severity issues only
 ```
 
 Route a planning intent to the matching command:
 
 ```text
-❯ /ase-meta-intent explain how the authentication module works
+❯ /ase-help-intent explain how the authentication module works
 ```
 
 ##  SEE ALSO
 
-[`ase-meta-proximity`](../ase-meta-proximity/help.md), [`ase-meta-search`](../ase-meta-search/help.md), [`ase-code-craft`](../ase-code-craft/help.md).
+[`ase-help-skill`](../ase-help-skill/help.md), [`ase-meta-proximity`](../ase-meta-proximity/help.md), [`ase-meta-search`](../ase-meta-search/help.md),
+[`ase-code-craft`](../ase-code-craft/help.md).