@rse/ase 0.9.59 → 0.9.61

package/dst/ase-hook.js

@@ -75,6 +75,10 @@ const toolInputSchema = v.object({
     skill: v.optional(v.string()),
     file_path: v.optional(v.string())
 });
+/*  maximum tolerated age of an idle session directory: the session-end hook
+    removes it regularly, but a crashed or SIGKILLed agent leaves it behind
+    forever, so orphans are garbage-collected once they exceed this age  */
+const SESSION_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;
 /*  CLI command "ase hook"  */
 export default class HookCommand {
     log;
@@ -85,6 +89,40 @@ export default class HookCommand {
     isValidSessionId(id) {
         return /^[A-Za-z0-9._-]+$/.test(id);
     }
+    /*  resolve the base directory holding all per-session state  */
+    sessionBaseDir() {
+        return path.join(os.homedir(), ".ase", "session");
+    }
+    /*  garbage-collect orphaned session directories left behind by agents
+        which died before their session-end hook could run; a live session
+        keeps its directory's mtime current, as every tool call acquires a
+        lock file inside it, so plain age is a reliable liveness signal  */
+    pruneStaleSessions(currentSessionId) {
+        const base = this.sessionBaseDir();
+        let entries;
+        try {
+            entries = fs.readdirSync(base, { withFileTypes: true });
+        }
+        catch (_e) {
+            /*  best-effort: no base directory yet, or unreadable  */
+            return;
+        }
+        const deadline = Date.now() - SESSION_MAX_AGE_MS;
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name === currentSessionId)
+                continue;
+            const dir = path.join(base, entry.name);
+            try {
+                if (fs.statSync(dir).mtimeMs >= deadline)
+                    continue;
+                fs.rmSync(dir, { recursive: true, force: true });
+                this.log.write("debug", `hook: pruned stale session directory: ${dir}`);
+            }
+            catch (_e) {
+                /*  best-effort: ignore vanished or undeletable directories  */
+            }
+        }
+    }
     /*  drain and discard the stdin event payload  */
     async drainStdin() {
         await readStdin().catch(() => "");
@@ -176,14 +214,14 @@ export default class HookCommand {
         try {
             pkg = fs.readFileSync(filePkg, "utf8");
         }
-        catch (_e) {
-            throw new Error(`failed to read plugin manifest: ${filePkg}`);
+        catch (err) {
+            throw new Error(`failed to read plugin manifest: ${filePkg}`, { cause: err });
         }
         try {
             md = fs.readFileSync(fileMd, "utf8");
         }
-        catch (_e) {
-            throw new Error(`failed to read constitution file: ${fileMd}`);
+        catch (err) {
+            throw new Error(`failed to read constitution file: ${fileMd}`, { cause: err });
         }
         /*  determine own version  */
         const pkgObj = this.parseJSON(pkg, v.object({ version: v.optional(v.string()) }));
@@ -210,6 +248,8 @@ export default class HookCommand {
         }));
         /*  determine session id  */
         const sessionId = this.pickSessionId(input);
+        /*  garbage-collect orphaned session directories of previous agent runs  */
+        this.pruneStaleSessions(sessionId);
         /*  establish config context (session-scoped only if a valid sessionId is present)  */
         const hasSession = this.isValidSessionId(sessionId);
         const cfg = new Config("config", configSchema, this.log, hasSession ? parseScope(`session:${sessionId}`) : parseScope(undefined));
@@ -363,7 +403,7 @@ export default class HookCommand {
         const sessionId = await this.readSessionIdFromStdin();
         /*  remove the session directory ~/.ase/session/<id> (only for a valid sessionId)  */
         if (this.isValidSessionId(sessionId)) {
-            const dir = path.join(os.homedir(), ".ase", "session", sessionId);
+            const dir = path.join(this.sessionBaseDir(), sessionId);
             try {
                 fs.rmSync(dir, { recursive: true, force: true });
             }

package/dst/ase-markdown.js

@@ -215,7 +215,7 @@ export class Markdown {
             }
             if (fence > 0 && (ch === "\r" || ch === "\n")) {
                 /*  consume optional CR followed by mandatory LF  */
-                let nl = "";
+                let nl;
                 if (ch === "\r" && i + 1 < text.length && text[i + 1] === "\n") {
                     nl = "\r\n";
                     i += 2;

package/dst/ase-meta.js

@@ -41,7 +41,7 @@ export class Meta {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            throw new Error(`meta: failed to read file: ${abs} (${message})`);
+            throw new Error(`meta: failed to read file: ${abs} (${message})`, { cause: err });
         }
     }
 }

package/dst/ase-setup.js

@@ -47,7 +47,7 @@ export default class SetupCommand {
             return false;
         /*  determine the npm global prefix and probe writability of the
             directories that "npm -g" actually mutates  */
-        let prefix = "";
+        let prefix;
         try {
             const result = await execa("npm", ["prefix", "-g"], { stdio: "pipe" });
             prefix = result.stdout.trim();

package/dst/ase-statusline.js

@@ -229,7 +229,7 @@ export default class StatuslineCommand {
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
-                throw new Error(`statusline: invalid JSON on stdin: ${message}`);
+                throw new Error(`statusline: invalid JSON on stdin: ${message}`, { cause: err });
             }
             /*  normalize Copilot CLI's top-level "cwd" into the
                 "workspace.current_dir" structure shared with Anthropic Claude Code CLI  */

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.59",
+    "version":                              "0.9.61",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -16,22 +16,22 @@
     "type":                                 "module",
     "bin":                                  { "ase": "bin/ase" },
     "devDependencies": {
-        "eslint":                           "9.39.4",
-        "@eslint/js":                       "9.39.4",
-        "@typescript-eslint/parser":        "8.66.0",
-        "@typescript-eslint/eslint-plugin": "8.66.0",
+        "eslint":                           "10.9.0",
+        "@eslint/js":                       "10.0.1",
+        "@typescript-eslint/parser":        "8.67.0",
+        "@typescript-eslint/eslint-plugin": "8.67.0",
+        "typescript-eslint":                "8.67.0",
         "eslint-plugin-promise":            "7.3.0",
-        "eslint-plugin-import":             "2.32.0",
-        "neostandard":                      "0.13.0",
-        "globals":                          "17.9.0",
+        "neostandard":                      "0.14.0-next.1",
+        "globals":                          "17.11.0",
         "typescript":                       "6.0.3",
 
         "@rse/stx":                         "1.1.6",
         "nodemon":                          "3.1.14",
         "shx":                              "0.4.0",
 
-        "@types/node":                      "26.1.2",
-        "@types/luxon":                     "3.7.3",
+        "@types/node":                      "26.2.0",
+        "@types/luxon":                     "3.7.5",
         "@types/which":                     "3.0.4",
         "@types/update-notifier":           "6.0.8",
         "@types/shell-quote":               "1.7.5",
@@ -42,7 +42,7 @@
     },
     "dependencies": {
         "commander":                        "15.0.0",
-        "@dotenvx/dotenvx":                 "2.19.2",
+        "@dotenvx/dotenvx":                 "2.21.0",
         "yaml":                             "2.9.0",
         "valibot":                          "1.4.2",
         "execa":                            "10.0.1",
@@ -72,9 +72,8 @@
     },
     "engines": {
         "npm":                              ">=10.0.0",
-        "node":                             ">=22.0.0"
+        "node":                             ">=22.13.0"
     },
-    "upd":                                  [ "!eslint", "!@eslint/js" ],
     "files": [
         "dst/**/*",
         "bin/**/*",

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

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

package/plugin/meta/ase-common-code.md

@@ -138,7 +138,7 @@ Set <args>--int-reuse-task</args>.
     <template/> and then *STOP*. Do *not* implement the plan.
 
     <template>
-    ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan finalized -- done**
+    ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **plan finalized -- done**
     </template>
     </if>
 

package/plugin/meta/ase-common-task.md

@@ -83,16 +83,14 @@ Task Skill Common Steps
 
 -   If <text/> starts with `ERROR:` or `WARNING:`:
     Set <task-content></task-content> (set task content to empty).
-    Set <words/> to "0".
 
 -   If <text/> does NOT start with `ERROR:` and NOT with `WARNING:`:
     Set <task-content><text/></task-content> (set task content to text).
-    Calculate the number of words <words/> of <task-content/>.
 
 Only output the following <template/>:
 
 <template>
-⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **<status/>**
+⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **<status/>**
 </template>
 
 </define>
@@ -109,16 +107,18 @@ had no `Created:` frontmatter key), set
 (fall back to the modified timestamp). Re-insert the current
 <ase-task-id/>, the original <timestamp-created/>, and the
 refreshed <timestamp-modified/> into the frontmatter keys `Id:`,
-`Created:`, and `Modified:` of <task-content/> and calculate
-the number of words <words/> of <task-content/>.
+`Created:`, and `Modified:` of <task-content/>.
 
 Call the `ase_task_save(id: "<ase-task-id/>", text:
 "<task-content/>")` tool of the `ase` MCP server to save the task
-plan content in its *authoring form*. Do not output anything
+plan content in its *authoring form*. This `ase_task_save` MCP
+tool call is the *only* permitted way to persist the task plan --
+you *MUST* *NEVER* write the plan file via `Write`/`Edit` or by
+executing a shell command. Do not output anything
 related to this MCP call except the following <template/>:
 
 <template>
-⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **<arg1/>**
+⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **<arg1/>**
 </template>
 
 </define>
@@ -169,7 +169,7 @@ Only output the following <template/> and then call the tool
 stop processing the current skill once the `Skill` tool was used.
 
 <template>
-⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **<arg2/>**
+⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **<arg2/>**
 </template>
 
 </define>

package/plugin/meta/ase-dialog.md

@@ -102,8 +102,10 @@ following procedure:
         </ase-tpl-boxed>
         </text>
 
-        If <n/> is less than 2:
-        Set <result>ERROR: custom-dialog requires 2-9 answer lines, got <n/></result>
+        If <n/> is less than 2 -- or less than 1 when <opts/> contains
+        `--other` and does *not* contain `--no-other`, as the free-text
+        path then complements a single answer option:
+        Set <result>ERROR: custom-dialog requires 2-9 (with free-text: 1-9) answer lines, got <n/></result>
         and *SKIP* the following step 2.2 and continue with step 2.3 dispatch.
 
     2.  Output the following <template/>, end the current turn, wait for 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.59",
+    "version":                              "0.9.61",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -17,13 +17,13 @@
         "@rse/stx":                         "1.1.6",
         "markdownlint":                     "0.41.1",
         "markdownlint-cli2":                "0.23.2",
-        "eslint":                           "10.8.0",
+        "eslint":                           "10.9.0",
         "@eslint/markdown":                 "8.0.3",
-        "eslint-markdown":                  "0.13.0"
+        "eslint-markdown":                  "0.14.0"
     },
     "engines": {
         "npm":                              ">=10.0.0",
-        "node":                             ">=22.0.0"
+        "node":                             ">=22.13.0"
     },
     "scripts": {
         "start":                            "stx -v4 -l warning -c etc/stx.conf"

package/plugin/skills/ase-code-craft/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-code-craft
-argument-hint: "[--help|-h] [--auto|-a] [--dry|-d] [--direct|-D] [--quick|-Q] [--next|-n <option>[,...]] [<task-id>:] <feature>"
+argument-hint: "[--help|-h] [--auto|-a] [--dry|-d] [--direct|-D] [--interactive|-i] [--quick|-Q] [--next|-n <option>[,...]] [<task-id>:] <feature>"
 description: >
     Craft Source Code:
     Use when user wants to "create", "add", or "craft" a new feature from scratch.
@@ -24,7 +24,7 @@ Craft Source Code
 
 <expand name="getopt"
     arg1="ase-code-craft"
-    arg2="--auto|-a --dry|-d --direct|-D --quick|-Q --next|-n=(none|DONE|EDIT|GRILL|PREFLIGHT|IMPLEMENT)...">
+    arg2="--auto|-a --dry|-d --direct|-D --interactive|-i --quick|-Q --next|-n=(none|DONE|EDIT|GRILL|PREFLIGHT|IMPLEMENT)...">
     $ARGUMENTS
 </expand>
 
@@ -34,6 +34,11 @@ to `true`, <getopt-option-dry/> to `true`, and <getopt-option-next/> to
 `IMPLEMENT,DELETE`. Do not output anything.
 </if>
 
+<if condition="<getopt-option-interactive/> is equal `true`">
+The `--interactive`/`-i` flag *implies* the `--direct`/`-D` mode: set
+<getopt-option-direct/> to `true`. Do not output anything.
+</if>
+
 <objective>
 From scratch *craft* the following feature:
 <feature><getopt-arguments/></feature>
@@ -48,8 +53,9 @@ Procedure
 
 <if condition="<getopt-option-direct/> is not equal to 'true'">
 You *MUST* *NOT* call `Edit`, `Write`, `NotebookEdit`, or any
-filesystem-modifying tool during this entire skill. The *only*
-permitted way to persist artifacts is via `ase_task_save(...)`.
+filesystem-modifying tool, nor execute any filesystem-modifying
+shell command, during this entire skill. The *only* permitted way
+to persist artifacts is via the `ase_task_save(...)` MCP tool.
 </if>
 <else>
 The `--direct`/`-D` mode applies the crafting *in place*, so STEP 4
@@ -162,7 +168,35 @@ crafting actually demands, and you *MUST* *NOT* call
         ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **changes directly applied**
         </template>
 
-    3.  Then *IMMEDIATELY* *STOP* all further skill processing. You
+    3.  <if condition="<getopt-option-interactive/> is equal `true`">
+        Enter the *interactive crafting loop*:
+
+        <while condition="`true`">
+
+        1.  In the following, you *MUST* *NOT* use your built-in
+            <user-dialog-tool/> tool! Instead, you *MUST* just show a
+            custom dialog according to the expanded `custom-dialog`
+            definition. You *MUST* closely follow this definition.
+
+            Ask the user for the next change with the following
+            custom dialog:
+
+            <expand name="custom-dialog" arg1="--other">
+                Next Change: What is the next change to craft?
+                DONE: Finish the interactive crafting loop
+            </expand>
+
+        2.  If <result/> is `DONE` or `CANCEL`, <break/>.
+
+        3.  Otherwise <result/> has the format `OTHER: <text/>`: set
+            <feature/> to <text/>, then directly craft it and report
+            it exactly as specified by the items 1 and 2 above
+            (including the CHANGELOG.md entry).
+
+        </while>
+        </if>
+
+    4.  Then *IMMEDIATELY* *STOP* all further skill processing. You
         *MUST* *NOT* output anything else in this STEP 4 or after it --
         *independent* of <ase-project-boxing/>, whose exposure rules
         are explicitly *overridden* here. Especially, do not output a
@@ -207,16 +241,16 @@ crafting actually demands, and you *MUST* *NOT* call
         `ase` MCP server and use the `text` field of its response for
         <timestamp-created/> and <timestamp-modified/> information. Then
         insert the current <ase-task-id/>, <timestamp-created/>,
-        <timestamp-modified/>, and <task-kind/> information and calculate
-        the number of words <words/> of <task-content/>.
+        <timestamp-modified/>, and <task-kind/> information.
 
     3.  You then *MUST* *save* the resulting plan content with the
-        `ase_task_save(id: "<ase-task-id/>", text: "<task-content/>")`.
+        `ase_task_save(id: "<ase-task-id/>", text: "<task-content/>")`
+        MCP tool call only -- *NEVER* by executing a shell command.
 
     4.  Output a hint with the following <template/>:
 
         <template>
-        ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan created**
+        ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **plan created**
         </template>
 
     5.  Directly pass-through control to the next skill:

package/plugin/skills/ase-code-craft/help.md

@@ -10,6 +10,7 @@
     [`--auto`|`-a`]
     [`--dry`|`-d`]
     [`--direct`|`-D`]
+    [`--interactive`|`-i`]
     [`--quick`|`-Q`]
     [`--next`|`-n` *option*[,...]]
     [*task-id*:] *feature*
@@ -51,6 +52,12 @@ entirely and applies the change set to the affected artifacts itself.
     `--next` have no effect, as neither approaches are proposed nor a
     plan is composed.
 
+`--interactive`|`-i`:
+    Craft *interactively*: implies `--direct` and, once the initial
+    *feature* has been applied, repeatedly asks for the *next change*
+    with a free-text dialog and immediately applies it in place, too,
+    until the user stops the loop by answering `DONE`.
+
 `--quick`|`-Q`:
     Shorthand alias for `-a -d -n IMPLEMENT,DELETE`: automatically pick
     the recommended feature approach, compose the plan *without* the
@@ -96,6 +103,12 @@ Craft a feature under a named task and directly hand off to implementation:
 ❯ /ase-code-craft --next IMPLEMENT auth: add JWT authentication middleware
 ```
 
+Craft interactively, applying one change after the other in place:
+
+```text
+❯ /ase-code-craft -i add a --verbose option to the CLI
+```
+
 ##  SEE ALSO
 
 [`ase-code-refactor`](../ase-code-refactor/help.md), [`ase-code-resolve`](../ase-code-resolve/help.md), [`ase-task-edit`](../ase-task-edit/help.md),