@rse/ase 0.9.66 → 0.9.68

package/dst/ase-setup.js

@@ -240,6 +240,87 @@ export default class SetupCommand {
         }
         return 0;
     }
+    /*  handler for "ase setup status"  */
+    async doStatus(tool) {
+        const spec = toolSpecs[tool];
+        await this.ensureTool(spec.cli);
+        this.log.write("info", `setup: status: probing ASE registrations for ${spec.label}`);
+        const table = new Table({
+            head: ["KIND", "ID", "SCOPE", "STATUS"],
+            colWidths: [13, 34, 10, 16],
+            wordWrap: true,
+            chars: { "mid": "", "left-mid": "", "mid-mid": "", "right-mid": "" },
+            style: { head: ["blue"] }
+        });
+        /*  report the ASE plugin registrations, with an absent plugin
+            still rendered as an explicit row instead of being omitted  */
+        const plugins = await this.pluginStatus(tool);
+        if (plugins.length === 0)
+            table.push(["PLUGIN", chalk.bold("ase@ase"), "(n/a)", "not installed"]);
+        else
+            for (const plugin of plugins)
+                table.push(["PLUGIN", chalk.bold("ase@ase"), plugin.scope, plugin.status]);
+        /*  report the registered MCP servers, probed concurrently and
+            silently skipping every server which is not registered at all  */
+        const scopes = await Promise.all(this.mcpServers.map((handle) => this.mcpScope(tool, handle.server)));
+        for (let i = 0; i < this.mcpServers.length; i++) {
+            const scope = scopes[i];
+            if (scope === undefined)
+                continue;
+            table.push(["MCP", chalk.bold(this.mcpServers[i].server), scope, "registered"]);
+        }
+        /*  report the ASE statusline registrations  */
+        for (const statusline of await this.statuslineStatus(tool))
+            table.push(["STATUSLINE", chalk.bold(statusline.file), statusline.scope, statusline.status]);
+        process.stdout.write(`${table.toString()}\n`);
+        return 0;
+    }
+    /*  probe the ASE plugin registrations by scraping the human-readable
+        output of "<cli> plugin list", whose format differs per tool  */
+    async pluginStatus(tool) {
+        const result = await execa(toolSpecs[tool].cli, ["plugin", "list"], { stdio: "pipe", reject: false });
+        const lines = (result.stdout ?? "").split(/\r?\n/);
+        const entries = [];
+        if (tool === "claude") {
+            /*  the Anthropic Claude Code CLI renders one indented block per
+                plugin, carrying an explicit "Scope:" and "Status:" field  */
+            for (let i = 0; i < lines.length; i++) {
+                if (!/(^|\s)ase@ase\s*$/.test(lines[i]))
+                    continue;
+                let scope = "(unknown)";
+                let status = "(unknown)";
+                for (let j = i + 1; j < lines.length; j++) {
+                    const m = lines[j].match(/^\s+(\w+):\s*(.+?)\s*$/);
+                    if (m === null)
+                        break;
+                    /*  strip the leading "✔"/"✘" glyph of the status value  */
+                    const value = m[2].replace(/^[^\p{L}\p{N}]+/u, "");
+                    if (m[1] === "Scope")
+                        scope = value;
+                    else if (m[1] === "Status")
+                        status = value;
+                }
+                entries.push({ scope, status });
+            }
+        }
+        else if (tool === "copilot") {
+            /*  the GitHub Copilot CLI renders a flat bullet list which
+                carries neither a scope nor an enabled/disabled state  */
+            for (const line of lines)
+                if (/(^|\s)ase@ase(\s|\(|$)/.test(line))
+                    entries.push({ scope: "(n/a)", status: "installed" });
+        }
+        else {
+            /*  the OpenAI Codex CLI renders a per-marketplace table whose
+                second column carries the combined installation status  */
+            for (const line of lines) {
+                const m = line.match(/^ase@ase\s+(not installed|installed(?:,\s*\w+)?)/);
+                if (m !== null && m[1] !== "not installed")
+                    entries.push({ scope: "(n/a)", status: m[1] });
+            }
+        }
+        return entries;
+    }
     /*  handler for "ase setup mcp list"  */
     async doMcpList() {
         const table = new Table({
@@ -335,6 +416,19 @@ export default class SetupCommand {
         const result = await execa(toolSpecs[tool].cli, ["mcp", "get", name], { stdio: "ignore", reject: false });
         return result.exitCode === 0;
     }
+    /*  probe the registration scope of an MCP server by scraping the
+        human-readable output of "<cli> mcp get <name>"; returns "undefined"
+        for a server which is not registered with the tool at all  */
+    async mcpScope(tool, name) {
+        const result = await execa(toolSpecs[tool].cli, ["mcp", "get", name], { stdio: "pipe", reject: false });
+        if (result.exitCode !== 0)
+            return undefined;
+        /*  the Anthropic Claude Code CLI reports "Scope: <scope> config (...)",
+            the GitHub Copilot CLI reports "Source: <scope>", and the
+            OpenAI Codex CLI reports no scope information at all  */
+        const m = (result.stdout ?? "").match(/^\s*(?:Scope|Source):\s*(\S+)/m);
+        return m !== null ? m[1].toLowerCase() : "(n/a)";
+    }
     /*  register an MCP server with the tool, supporting both the "stdio"
         (a local subprocess command) and "http" (a remote URL, optionally
         with HTTP headers) transports; the per-tool command line differs
@@ -785,6 +879,36 @@ export default class SetupCommand {
         this.log.write("info", `setup: statusline: deactivate: removing ASE "statusLine" from ${file}`);
         return 0;
     }
+    /*  probe the ASE statusline registrations by inspecting the tool
+        settings files of all applicable installation scopes  */
+    async statuslineStatus(tool) {
+        /*  the OpenAI Codex CLI has no scriptable statusline mechanism at all  */
+        if (tool === "codex")
+            return [];
+        const home = os.homedir();
+        const scopes = tool === "claude" ? ["user", "project", "local"] : ["user"];
+        const entries = [];
+        for (const scope of scopes) {
+            const file = this.statuslineSettingsFile(tool, scope);
+            let root;
+            try {
+                root = await this.statuslineReadAst(file);
+            }
+            catch {
+                /*  an unparsable settings file carries no usable state  */
+                continue;
+            }
+            const member = this.statuslineFindMember(root);
+            if (member === undefined)
+                continue;
+            entries.push({
+                file: file.startsWith(home + path.sep) ? `~${file.slice(home.length)}` : file,
+                scope: tool === "claude" ? scope : "(n/a)",
+                status: this.statuslineIsOwned(member) ? "activated" : "foreign"
+            });
+        }
+        return entries;
+    }
     /*  parse and validate the --tool option  */
     parseTool(value) {
         if (value !== "claude" && value !== "copilot" && value !== "codex")
@@ -870,6 +994,14 @@ export default class SetupCommand {
             .action(async (opts) => {
             process.exit(await this.doToggle(this.parseTool(opts.tool), this.parseScope(opts.scope), "disable"));
         });
+        /*  register CLI sub-command "ase setup status"  */
+        setupCmd
+            .command("status")
+            .description("report the ASE plugin, MCP server, and statusline registrations for a tool")
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .action(async (opts) => {
+            process.exit(await this.doStatus(this.parseTool(opts.tool)));
+        });
         /*  register CLI sub-command "ase setup mcp"  */
         const mcpCmd = setupCmd
             .command("mcp")

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.66",
+    "version":                              "0.9.68",
     "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.66",
+    "version":     "0.9.68",
     "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.66",
+    "version":     "0.9.68",
     "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.66",
+    "version":     "0.9.68",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

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