@rse/ase 0.0.36 → 0.0.37

package/dst/ase-hello.js

@@ -3,7 +3,11 @@
 **  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";
+import { Chalk } from "chalk";
+/*  forced-color chalk instance: stdout may be a pipe, so chalk
+    auto-detection would yield level 0; force level 1 to keep
+    emitting ANSI sequences as in "ase statusline"  */
+const c = new Chalk({ level: 1 });
 /*  command-line handling  */
 export default class HelloCommand {
     log;
@@ -14,9 +18,10 @@ export default class HelloCommand {
     register(program) {
         program
             .command("hello")
-            .description("Print \"Hello World\" in red")
-            .action(async () => {
-            process.stdout.write(chalk.red("Hello World") + "\n");
+            .description("print a colored greeting message")
+            .option("-s, --subject <name>", "subject to greet", "Universe")
+            .action((opts) => {
+            process.stdout.write(`${c.red(`${opts.subject} World!`)}\n`);
         });
     }
 }

package/dst/ase-hook.js

@@ -106,6 +106,8 @@ export default class HookCommand {
                 cfg.set("agent.task", taskId);
                 cfg.write();
             });
+        /*  initialize agent activity status  */
+        this.writeAgentStatus("ready");
         /*  determine project id  */
         const cwd = input.cwd ?? process.cwd();
         let projectDir = cwd;
@@ -170,6 +172,32 @@ export default class HookCommand {
         process.stdout.write(JSON.stringify(payload));
         return 0;
     }
+    /*  publish the agent activity marker to tmux as a per-pane user
+        option, so tmux can render the live state via
+        #{@ase_agent_status} (refreshed on tmux's own interval,
+        independent of Claude Code's statusline repaint cadence).
+        Notice: the Claude Code statusline is not usable for this case
+        here at all, as it is not repainted during agent processing! */
+    writeAgentStatus(status) {
+        const icon = status === "busy" ? "▶" : "⏸";
+        if (process.env.TMUX !== undefined
+            && process.env.TMUX !== ""
+            && process.env.TMUX_PANE !== undefined
+            && process.env.TMUX_PANE !== "") {
+            execaSync("tmux", ["set-option", "-p", "-t", process.env.TMUX_PANE,
+                "@ase_agent_status", icon], { stdio: "ignore", reject: false });
+        }
+    }
+    /*  handler for "ase hook user-prompt-submit" (both tools)  */
+    doUserPromptSubmit(_tool) {
+        this.writeAgentStatus("busy");
+        return 0;
+    }
+    /*  handler for "ase hook stop" (both tools)  */
+    doStop(_tool) {
+        this.writeAgentStatus("ready");
+        return 0;
+    }
     /*  handler for "ase hook session-end" (both tools)  */
     doSessionEnd(_tool) {
         /*  read session information (Claude Code uses snake_case fields,
@@ -287,5 +315,21 @@ export default class HookCommand {
             .action((opts) => {
             process.exit(this.doPreToolUse(this.parseTool(opts.tool)));
         });
+        /*  register CLI sub-command "ase hook user-prompt-submit"  */
+        hookCmd
+            .command("user-prompt-submit")
+            .description("handle UserPromptSubmit hook event (mark agent as busy)")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .action((opts) => {
+            process.exit(this.doUserPromptSubmit(this.parseTool(opts.tool)));
+        });
+        /*  register CLI sub-command "ase hook stop"  */
+        hookCmd
+            .command("stop")
+            .description("handle Stop hook event (mark agent as ready)")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .action((opts) => {
+            process.exit(this.doStop(this.parseTool(opts.tool)));
+        });
     }
 }

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

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

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

package/plugin/hooks/hooks-copilot.json

@@ -3,20 +3,37 @@
     "hooks": {
         "sessionStart": [
             {
-                "type":   "command",
-                "bash":   "ase hook session-start --tool copilot"
+                "type":       "command",
+                "bash":       "ase hook session-start --tool copilot",
+                "powershell": "ase hook session-start --tool copilot"
             }
         ],
         "sessionEnd": [
             {
-                "type":   "command",
-                "bash":   "ase hook session-end --tool copilot"
+                "type":       "command",
+                "bash":       "ase hook session-end --tool copilot",
+                "powershell": "ase hook session-end --tool copilot"
             }
         ],
         "preToolUse": [
             {
-                "type":   "command",
-                "bash":   "ase hook pre-tool-use --tool copilot"
+                "type":       "command",
+                "bash":       "ase hook pre-tool-use --tool copilot",
+                "powershell": "ase hook pre-tool-use --tool copilot"
+            }
+        ],
+        "userPromptSubmitted": [
+            {
+                "type":       "command",
+                "bash":       "ase hook user-prompt-submit --tool copilot",
+                "powershell": "ase hook user-prompt-submit --tool copilot"
+            }
+        ],
+        "agentStop": [
+            {
+                "type":       "command",
+                "bash":       "ase hook stop --tool copilot",
+                "powershell": "ase hook stop --tool copilot"
             }
         ]
     }

package/plugin/hooks/hooks.json

@@ -2,7 +2,6 @@
     "hooks": {
         "SessionStart": [
             {
-                "matcher": "startup|resume|clear|compact",
                 "hooks": [
                     {
                         "type": "command",
@@ -14,7 +13,6 @@
         ],
         "SessionEnd": [
             {
-                "matcher": "",
                 "hooks": [
                     {
                         "type": "command",
@@ -26,7 +24,6 @@
         ],
         "PreToolUse": [
             {
-                "matcher": "",
                 "hooks": [
                     {
                         "type": "command",
@@ -35,6 +32,26 @@
                     }
                 ]
             }
+        ],
+        "UserPromptSubmit": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook user-prompt-submit"
+                    }
+                ]
+            }
+        ],
+        "Stop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook stop"
+                    }
+                ]
+            }
         ]
     }
 }

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

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

@@ -168,8 +168,9 @@ permitted way to persist artifacts is via `task_save(...)`.
 4.  **Choose Feature Crafting Approach**:
 
     1.  If <getopt-option-auto/> is equal `false`:
-        Let the *user interactively choose* the preferred feature approach A<n/>
-        with the help of the <user-dialog-tool/> tool. Use *single-selection* only
+        Let the *user interactively choose* the preferred feature
+        approach A<n/> with the help of the <user-dialog-tool/> tool.
+        Use the header `Select Approach` and *single-selection* only
         and provide small *code change previews*. Mark your recommended
         feature approach with ` ⚝ **RECOMMENDATION** ⚝` here again.
 

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

@@ -172,11 +172,13 @@ permitted way to persist artifacts is via `task_save(...)`.
 4.  **Choose Refactoring Approach**:
 
     1.  If <getopt-option-auto/> is equal `false`:
-        Let the *user interactively choose* the preferred refactoring approach A<n/>
-        with the help of the <user-dialog-tool/> tool. Use *single-selection* only
+        Let the *user interactively choose* the preferred refactoring
+        approach A<n/> with the help of the <user-dialog-tool/> tool.
+        Use the header `Select Approach` and *single-selection* only
         and provide small *code change previews*. Mark your recommended
         refactoring approach with ` ⚝ **RECOMMENDATION** ⚝` here again.
-        Except for the interactive selection, do not output anything in this step.
+        Except for the interactive selection, do not output anything in
+        this step.
 
     2.  If <getopt-option-auto/> is equal `true`:
         Set <n/> to the number of the refactoring approach A<n/> you recommend.

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

@@ -224,8 +224,9 @@ permitted way to persist artifacts is via `task_save(...)`.
 4.  **Choose Problem Resolution Approach**:
 
     1.  If <getopt-option-auto/> is equal `false`:
-        Let the *user interactively choose* the preferred resolution approach A<n/>
-        with the help of the <user-dialog-tool/> tool. Use *single-selection* only
+        Let the *user interactively choose* the preferred resolution
+        approach A<n/> with the help of the <user-dialog-tool/> tool.
+        Use the header `Select Approach` and *single-selection* only
         and provide small *code change previews*. Mark your recommended
         resolution approach with ` ⚝ **RECOMMENDATION** ⚝` here again.
 

package/plugin/skills/ase-task-list/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-task-list
-argument-hint: ""
+argument-hint: "[-v|--verbose]"
 description: >
     List all available task ids.
     Use when user wants to see all tasks.
@@ -11,6 +11,7 @@ effort: low
 
 @${CLAUDE_SKILL_DIR}/../../meta/ase-persona.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
+@${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
 Task List
 =========
@@ -19,10 +20,17 @@ Task List
 List Task Plans
 </skill>
 
-1.  Call the `task_list(verbose: true)` tool from the `ase` MCP service.
-    The result is a structured object with a `tasks` array where each
-    entry has an `id` field and an `mtime` field (formatted as
-    `YYYY-MM-DD HH:MM`).
+<expand name="getopt"
+    arg1="ase-task-list"
+    arg2="--verbose|-v">
+    $ARGUMENTS
+</expand>
+
+1.  Call the `task_list(verbose: <getopt-option-verbose/>)` tool from
+    the `ase` MCP service. The result is a structured object with a
+    `tasks` array where each entry has an `id` field, and -- if
+    <getopt-option-verbose/> is `true` -- additionally an `mtime` field
+    (formatted as `YYYY-MM-DD HH:MM`).
 
 2.  If the `tasks` array is empty, output the following <template/>:
 
@@ -30,16 +38,33 @@ List Task Plans
     ⧉ **ASE**: ◉ tasks: *(none)*
     </template>
 
-    Else, output the list of tasks with the following <template/>, where
-    each <id/> and <mtime/> correspond to an entry in the task list:
+    Else, dispatch on <getopt-option-verbose/>:
 
-    <template>
-    ⧉ **ASE**: ◉ tasks:
+    -   If <getopt-option-verbose/> is `true`, output the list of tasks
+        with the following <template/>, where each <id/> and <mtime/>
+        correspond to an entry in the task list:
 
-    | *Task Id* | *Last Modified*    |
-    |-----------|--------------------|
-    | **<id/>** | `<mtime/>`         |
-    | [...]     | [...]              |
+        <template>
+        ⧉ **ASE**: ◉ tasks:
 
-    </template>
+        | *Task Id* | *Last Modified*    |
+        |-----------|--------------------|
+        | **<id/>** | `<mtime/>`         |
+        | [...]     | [...]              |
+
+        </template>
+
+    -   If <getopt-option-verbose/> is `false`, output the list of tasks
+        with the following <template/>, where each <id/> corresponds to
+        an entry in the task list:
+
+        <template>
+        ⧉ **ASE**: ◉ tasks:
+
+        | *Task Id* |
+        |-----------|
+        | **<id/>** |
+        | [...]     |
+
+        </template>