@rse/ase 0.0.21 → 0.0.22

package/dst/ase-helloxx.js

@@ -0,0 +1,23 @@
+/*
+**  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";
+/*  command-line handling  */
+export default class HelloxxCommand {
+    log;
+    constructor(log) {
+        this.log = log;
+    }
+    /*  register commands  */
+    register(program) {
+        program
+            .command("helloxx")
+            .description("Print a Hello World greeting")
+            .action(() => {
+            process.stdout.write(chalk.bold.green("Hello, World!") + "\n");
+            process.exit(0);
+        });
+    }
+}

package/dst/ase-hook.js

@@ -8,6 +8,26 @@ import fs from "node:fs";
 import { execaSync } from "execa";
 import Version from "./ase-version.js";
 import { Config, configSchema, parseScope } from "./ase-config.js";
+const toolSpecs = {
+    "claude": {
+        toolNameField: "tool_name",
+        toolInputField: "tool_input",
+        toolInputIsString: false,
+        bashToolName: "Bash",
+        mcpToolNamePattern: /^mcp__plugin_ase_ase__.+/,
+        preToolUseWrapped: true,
+        preToolUseEvent: "PreToolUse"
+    },
+    "copilot": {
+        toolNameField: "toolName",
+        toolInputField: "toolArgs",
+        toolInputIsString: true,
+        bashToolName: "bash",
+        mcpToolNamePattern: /^ase-.+/,
+        preToolUseWrapped: false,
+        preToolUseEvent: "preToolUse"
+    }
+};
 /*  CLI command "ase hook"  */
 export default class HookCommand {
     log;
@@ -38,12 +58,13 @@ export default class HookCommand {
             return this.expandReferences(content, path.dirname(abs), next);
         });
     }
-    /*  handler for "ase hook session-start"  */
-    async doSessionStart() {
-        /*  determine plugin root  */
-        const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT ?? "";
+    /*  handler for "ase hook session-start" (both tools)  */
+    async doSessionStart(tool) {
+        /*  determine plugin root (env var name differs per tool)  */
+        const pluginRootVar = tool === "copilot" ? "COPILOT_PLUGIN_ROOT" : "CLAUDE_PLUGIN_ROOT";
+        const pluginRoot = process.env[pluginRootVar] ?? "";
         if (pluginRoot === "")
-            throw new Error("CLAUDE_PLUGIN_ROOT environment variable is not set");
+            throw new Error(`${pluginRootVar} environment variable is not set`);
         /*  determine path to external files  */
         const filePkg = path.join(pluginRoot, ".claude-plugin", "plugin.json");
         const fileMd = path.join(pluginRoot, "meta", "ase-constitution.md");
@@ -64,11 +85,12 @@ export default class HookCommand {
         if (process.env.ASE_SETUP_DEV !== undefined)
             versionHints.push("**NOTICE:** *development* setup");
         const versionHint = versionHints.length > 0 ? "(" + versionHints.join(", ") + ")" : "";
-        /*  read session information  */
+        /*  read session information (Claude Code uses snake_case fields,
+            Copilot CLI uses camelCase fields)  */
         const stdin = fs.readFileSync(0, "utf8");
         const input = stdin.trim() !== "" ? JSON.parse(stdin) : {};
         /*  determine session id  */
-        const sessionId = input.session_id ?? "";
+        const sessionId = input.session_id ?? input.sessionId ?? "";
         /*  establish config context  */
         const cfg = new Config("config", configSchema, this.log, parseScope(`session:${sessionId}`));
         try {
@@ -107,14 +129,18 @@ export default class HookCommand {
         const val = cfg.get("agent.persona");
         if (typeof val === "string")
             persona = val;
-        /*  provide ASE information to Claude Code shell commands  */
-        const envFile = process.env.CLAUDE_ENV_FILE ?? "";
+        /*  determine headless mode  */
+        const headless = (process.env.ASE_HEADLESS ?? "false") === "true" ? "true" : "false";
+        /*  provide ASE information to Claude Code shell commands
+            (Claude Code only -- Copilot CLI has no equivalent mechanism)  */
+        const envFile = tool === "claude" ? (process.env.CLAUDE_ENV_FILE ?? "") : "";
         if (envFile !== "") {
             const script = `export ASE_VERSION="${versionCurrentPlugin}"\n` +
                 `export ASE_USER_ID="${userId}"\n` +
                 `export ASE_PROJECT_ID="${projectId}"\n` +
                 `export ASE_TASK_ID="${taskId}"\n` +
-                `export ASE_SESSION_ID="${sessionId}"\n`;
+                `export ASE_SESSION_ID="${sessionId}"\n` +
+                `export ASE_HEADLESS="${headless}"\n`;
             fs.appendFileSync(envFile, script, "utf8");
         }
         /*  prepend ASE information to constitution markdown  */
@@ -126,30 +152,49 @@ export default class HookCommand {
                 `<ase-project-id>${projectId}</ase-project-id>\n` +
                 `<ase-task-id>${taskId}</ase-task-id>\n` +
                 `<ase-session-id>${sessionId}</ase-session-id>\n` +
+                `<ase-headless>${headless}</ase-headless>\n` +
                 "\n" + md;
         /*  expand all @<file> references manually  */
         md = this.expandReferences(md, path.dirname(fileMd));
-        fs.writeFileSync("/tmp/xxx", md, "utf8");
-        /*  inject markdown into session context  */
-        process.stdout.write(JSON.stringify({
+        /*  inject markdown into session context.
+            Claude Code expects the context nested in "hookSpecificOutput";
+            Copilot CLI expects a flat top-level "additionalContext" field.  */
+        const payload = tool === "claude" ? {
             "hookSpecificOutput": {
                 "hookEventName": "SessionStart",
                 "additionalContext": md
             }
-        }));
+        } : {
+            "additionalContext": md
+        };
+        process.stdout.write(JSON.stringify(payload));
         return 0;
     }
-    /*  handler for "ase hook pre-tool-use"  */
-    doPreToolUse() {
+    /*  handler for "ase hook pre-tool-use" (both tools)  */
+    doPreToolUse(tool) {
+        const spec = toolSpecs[tool];
         /*  read tool invocation information  */
         const stdin = fs.readFileSync(0, "utf8");
         const input = stdin.trim() !== "" ? JSON.parse(stdin) : {};
-        /*  determine whether to auto-approve the tool invocation  */
-        const toolName = input.tool_name ?? "";
-        const toolInput = input.tool_input ?? {};
+        /*  determine whether to auto-approve the tool invocation
+            (field names and value shapes differ between tools)  */
+        const toolName = typeof input[spec.toolNameField] === "string" ?
+            input[spec.toolNameField] : "";
+        let toolInput = {};
+        const rawInput = input[spec.toolInputField];
+        if (spec.toolInputIsString && typeof rawInput === "string") {
+            try {
+                toolInput = JSON.parse(rawInput);
+            }
+            catch (_e) {
+                /*  best-effort: leave toolInput empty on parse failure  */
+            }
+        }
+        else if (!spec.toolInputIsString && typeof rawInput === "object" && rawInput !== null)
+            toolInput = rawInput;
         let approve = false;
         let reason = "";
-        if (toolName === "Bash" && /^ase(\s|$)/.test(toolInput.command ?? "")) {
+        if (toolName === spec.bashToolName && /^ase(\s|$)/.test(toolInput.command ?? "")) {
             approve = true;
             reason = "ASE CLI invocation auto-approved";
         }
@@ -157,28 +202,43 @@ export default class HookCommand {
             approve = true;
             reason = "ASE skill invocation auto-approved";
         }
-        else if (/^mcp__plugin_ase_ase__.+/.test(toolName)) {
+        else if (spec.mcpToolNamePattern.test(toolName)) {
             approve = true;
             reason = "ASE MCP tool invocation auto-approved";
         }
-        /*  emit permission decision (or stay silent to defer to default flow)  */
+        /*  emit permission decision (or stay silent to defer to default flow).
+            Claude Code expects the decision nested in "hookSpecificOutput";
+            Copilot CLI expects flat top-level fields.  */
         if (approve) {
-            process.stdout.write(JSON.stringify({
+            const payload = spec.preToolUseWrapped ? {
                 "hookSpecificOutput": {
-                    "hookEventName": "PreToolUse",
+                    "hookEventName": spec.preToolUseEvent,
                     "permissionDecision": "allow",
                     "permissionDecisionReason": reason
                 }
-            }));
+            } : {
+                "permissionDecision": "allow",
+                "permissionDecisionReason": reason
+            };
+            process.stdout.write(JSON.stringify(payload));
         }
         return 0;
     }
+    /*  parse and validate the --tool option  */
+    parseTool(value) {
+        if (value !== "claude" && value !== "copilot")
+            throw new Error(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
+        return value;
+    }
     /*  register commands  */
     register(program) {
+        /*  default for --tool derived from ASE_TOOL environment variable  */
+        const envTool = process.env.ASE_TOOL ?? "";
+        const toolDflt = envTool !== "" ? envTool : "claude";
         /*  register CLI top-level command "ase hook"  */
         const hookCmd = program
             .command("hook")
-            .description("Claude Code hook entry points")
+            .description("Claude Code and Copilot CLI hook entry points")
             .action(() => {
             hookCmd.outputHelp();
             process.exit(1);
@@ -186,16 +246,18 @@ export default class HookCommand {
         /*  register CLI sub-command "ase hook session-start"  */
         hookCmd
             .command("session-start")
-            .description("handle Claude Code SessionStart hook event")
-            .action(async () => {
-            process.exit(await this.doSessionStart());
+            .description("handle SessionStart hook event")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .action(async (opts) => {
+            process.exit(await this.doSessionStart(this.parseTool(opts.tool)));
         });
         /*  register CLI sub-command "ase hook pre-tool-use"  */
         hookCmd
             .command("pre-tool-use")
-            .description("handle Claude Code PreToolUse hook event")
-            .action(() => {
-            process.exit(this.doPreToolUse());
+            .description("handle tool PreToolUse hook event")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .action((opts) => {
+            process.exit(this.doPreToolUse(this.parseTool(opts.tool)));
         });
     }
 }

package/dst/ase-log.js

@@ -61,7 +61,7 @@ export default class Log {
                 line += `[${levels[idx].name.toUpperCase()}]`;
             line += `: ${msg}\n`;
             if (this._logFile === "-")
-                process.stdout.write(line);
+                process.stderr.write(line);
             else if (this.stream !== null)
                 this.stream.write(line);
         }

package/dst/ase-setup.js

@@ -8,6 +8,10 @@ import { fileURLToPath } from "node:url";
 import { execa } from "execa";
 import which from "which";
 import Version from "./ase-version.js";
+const toolSpecs = {
+    "claude": { cli: "claude", label: "Claude Code" },
+    "copilot": { cli: "copilot", label: "Copilot CLI" }
+};
 /*  CLI command "ase setup"  */
 export default class SetupCommand {
     log;
@@ -65,21 +69,24 @@ export default class SetupCommand {
             }
         }
     }
-    /*  handler for "ase setup install"  */
-    async doInstall(dev) {
+    /*  handler for "ase setup install" (both tools)  */
+    async doInstall(tool, dev) {
+        const spec = toolSpecs[tool];
         await this.ensureTool("npm");
-        await this.ensureTool("claude");
+        await this.ensureTool(spec.cli);
         this.log.write("info", `setup: install${dev ? "[dev]" : ""}: ` +
-            `installing ASE Claude Code plugin (origin: ${dev ? "local" : "remote"})`);
-        const source = dev ? process.cwd() : "rse/ase";
-        await this.run("claude", ["plugin", "marketplace", "add", source]);
-        await this.run("claude", ["plugin", "install", "ase@ase"], { retries: 3 });
+            `installing ASE ${spec.label} plugin (origin: ${dev ? "local" : "remote"})`);
+        const basedir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+        const source = dev ? basedir : "rse/ase";
+        await this.run(spec.cli, ["plugin", "marketplace", "add", source]);
+        await this.run(spec.cli, ["plugin", "install", "ase@ase"], { retries: 3 });
         return 0;
     }
-    /*  handler for "ase setup update"  */
-    async doUpdate(force, dev) {
+    /*  handler for "ase setup update" (both tools)  */
+    async doUpdate(tool, force, dev) {
+        const spec = toolSpecs[tool];
         await this.ensureTool("npm");
-        await this.ensureTool("claude");
+        await this.ensureTool(spec.cli);
         /*  best-effort stop of background service  */
         this.log.write("info", `setup: update${dev ? "[dev]" : ""}: ` +
             "stopping potentially running ASE service");
@@ -92,10 +99,10 @@ export default class SetupCommand {
             await this.run("npm", ["start", "build"], { cwd: tooldir });
             /*  in development mode the local plugin files are already current
                 but there is no version change in the plugin manifest,
-                so just re-install the plugin to let Claude Code update its copy  */
-            this.log.write("info", "setup: update[dev]: re-install ASE Claude Code plugin (origin: local)");
-            await this.run("claude", ["plugin", "uninstall", "ase@ase"], { ignoreError: "ASE Claude Code plugin not installed" });
-            await this.run("claude", ["plugin", "install", "ase@ase"], { retries: 3 });
+                so just re-install the plugin to let the tool update its copy  */
+            this.log.write("info", `setup: update[dev]: re-install ASE ${spec.label} plugin (origin: local)`);
+            await this.run(spec.cli, ["plugin", "uninstall", "ase@ase"], { ignoreError: `ASE ${spec.label} plugin not installed` });
+            await this.run(spec.cli, ["plugin", "install", "ase@ase"], { retries: 3 });
         }
         else {
             /*  perform NPM version check  */
@@ -108,26 +115,27 @@ export default class SetupCommand {
             /*  update ASE CLI tool  */
             this.log.write("info", `setup: update: updating ASE CLI tool: ${current} -> ${latest}`);
             await this.run("npm", ["update", "-g", "@rse/ase"]);
-            /*  update ASE Claude Code plugin  */
-            this.log.write("info", "setup: update: updating ASE Claude Code plugin");
-            await this.run("claude", ["plugin", "marketplace", "update", "ase"]);
-            await this.run("claude", ["plugin", "update", "ase@ase"]);
+            /*  update ASE plugin  */
+            this.log.write("info", `setup: update: updating ASE ${spec.label} plugin`);
+            await this.run(spec.cli, ["plugin", "marketplace", "update", "ase"]);
+            await this.run(spec.cli, ["plugin", "update", "ase@ase"]);
         }
         return 0;
     }
-    /*  handler for "ase setup uninstall"  */
-    async doUninstall(dev) {
+    /*  handler for "ase setup uninstall" (both tools)  */
+    async doUninstall(tool, dev) {
+        const spec = toolSpecs[tool];
         await this.ensureTool("npm");
-        await this.ensureTool("claude");
+        await this.ensureTool(spec.cli);
         /*  best-effort stop of background service  */
         this.log.write("info", `setup: uninstall${dev ? "[dev]" : ""}: ` +
             "stopping potentially running ASE service");
         await this.run("ase", ["service", "stop"], { quiet: true });
-        /*  uninstall ASE Claude Code plugin  */
+        /*  uninstall ASE plugin  */
         this.log.write("info", `setup: uninstall${dev ? "[dev]" : ""}: ` +
-            `uninstalling ASE Claude Code plugin (origin: ${dev ? "local" : "remote"})`);
-        await this.run("claude", ["plugin", "uninstall", "ase@ase"], { ignoreError: "ASE Claude Code plugin not installed" });
-        await this.run("claude", ["plugin", "marketplace", "remove", "ase"], { ignoreError: "ASE Claude Code plugin marketplace not registered" });
+            `uninstalling ASE ${spec.label} plugin (origin: ${dev ? "local" : "remote"})`);
+        await this.run(spec.cli, ["plugin", "uninstall", "ase@ase"], { ignoreError: `ASE ${spec.label} plugin not installed` });
+        await this.run(spec.cli, ["plugin", "marketplace", "remove", "ase"], { ignoreError: `ASE ${spec.label} plugin marketplace not registered` });
         /*  uninstall ASE CLI tool (non-development only)  */
         if (!dev) {
             this.log.write("info", "setup: uninstall: uninstalling ASE CLI tool (origin: remote)");
@@ -135,11 +143,20 @@ export default class SetupCommand {
         }
         return 0;
     }
+    /*  parse and validate the --tool option  */
+    parseTool(value) {
+        if (value !== "claude" && value !== "copilot")
+            throw new Error(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
+        return value;
+    }
     /*  register commands  */
     register(program) {
         /*  default for --dev derived from ASE_SETUP_DEV environment variable  */
         const envDev = process.env.ASE_SETUP_DEV ?? "";
         const devDflt = envDev !== "" && envDev !== "0" && envDev.toLowerCase() !== "false";
+        /*  default for --tool derived from ASE_TOOL environment variable  */
+        const envTool = process.env.ASE_TOOL ?? "";
+        const toolDflt = envTool !== "" ? envTool : "claude";
         /*  register CLI top-level command "ase setup"  */
         const setupCmd = program
             .command("setup")
@@ -151,27 +168,30 @@ export default class SetupCommand {
         /*  register CLI sub-command "ase setup install"  */
         setupCmd
             .command("install")
-            .description("install the ASE Claude Code plugin")
+            .description("install the ASE plugin for a tool")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
             .option("-d, --dev", "use local working copy instead of remote repository", devDflt)
             .action(async (opts) => {
-            process.exit(await this.doInstall(opts.dev));
+            process.exit(await this.doInstall(this.parseTool(opts.tool), opts.dev));
         });
         /*  register CLI sub-command "ase setup update"  */
         setupCmd
             .command("update")
-            .description("update the ASE tool and the ASE Claude Code plugin")
+            .description("update the ASE tool and the ASE plugin for a tool")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
             .option("-f, --force", "always perform the update, even if already at latest version", false)
             .option("-d, --dev", "use local working copy instead of remote repository", devDflt)
             .action(async (opts) => {
-            process.exit(await this.doUpdate(opts.force, opts.dev));
+            process.exit(await this.doUpdate(this.parseTool(opts.tool), opts.force, opts.dev));
         });
         /*  register CLI sub-command "ase setup uninstall"  */
         setupCmd
             .command("uninstall")
-            .description("uninstall the ASE Claude Code plugin and the ASE tool")
+            .description("uninstall the ASE plugin for a tool and the ASE tool")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
             .option("-d, --dev", "use local working copy instead of remote repository", devDflt)
             .action(async (opts) => {
-            process.exit(await this.doUninstall(opts.dev));
+            process.exit(await this.doUninstall(this.parseTool(opts.tool), opts.dev));
         });
     }
 }

package/dst/ase-statusline.js

@@ -161,11 +161,21 @@ export default class StatuslineCommand {
     constructor(log) {
         this.log = log;
     }
+    /*  parse and validate the --tool option  */
+    parseTool(value) {
+        if (value !== "claude" && value !== "copilot")
+            throw new Error(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
+        return value;
+    }
     /*  register commands  */
     register(program) {
+        /*  default for --tool derived from ASE_TOOL environment variable  */
+        const envTool = process.env.ASE_TOOL ?? "";
+        const toolDflt = envTool !== "" ? envTool : "claude";
         program
             .command("statusline")
-            .description("Render Claude Code statusline from stdin JSON")
+            .description("Render Claude Code or GitHub Copilot CLI statusline from stdin JSON")
+            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
             .option("-w, --width <n>", "force terminal width to <n> characters (0 = auto-detect via /dev/tty)", parseInteger("--width"), 0)
             .option("-m, --margin <n>", "reduce maximum used terminal width by <n> characters on each side", parseInteger("--margin"), 2)
             .option("--no-icons", "disable icons in placeholder rendering")
@@ -175,6 +185,8 @@ export default class StatuslineCommand {
             "(color: black, red, green, yellow, blue, magenta, cyan, white, default) " +
             "(default: single line \"%m %e %t\")")
             .action(async (lines, opts) => {
+            /*  validate target tool  */
+            const tool = this.parseTool(opts.tool);
             /*  read all of stdin  */
             const input = await readStdin();
             /*  parse JSON data  */
@@ -187,6 +199,13 @@ export default class StatuslineCommand {
                 this.log.write("error", `statusline: invalid JSON on stdin: ${message}`);
                 process.exit(1);
             }
+            /*  normalize Copilot CLI's top-level "cwd" into the
+                "workspace.current_dir" structure shared with Claude Code  */
+            if (tool === "copilot"
+                && (data.workspace?.current_dir === undefined || data.workspace.current_dir === "")
+                && typeof data.cwd === "string" && data.cwd !== "") {
+                data.workspace = { ...(data.workspace ?? {}), current_dir: data.cwd };
+            }
             /*  determine effective terminal width and budget  */
             const width = opts.width > 0 ? opts.width : detectTermWidth();
             const budget = width > 0 ? width - 2 * opts.margin : 0;
@@ -228,7 +247,7 @@ export default class StatuslineCommand {
             let sessCache = null;
             const getSession = () => {
                 if (sessCache === null)
-                    sessCache = data.session_name ?? data.session_id ?? "unknown";
+                    sessCache = data.session_id ?? "unknown";
                 return sessCache;
             };
             let cfgCache = null;

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