@rse/ase 0.9.33 → 0.9.34

package/dst/ase-setup.js

@@ -153,7 +153,8 @@ export default class SetupCommand {
         }
     }
     /*  handler for "ase setup install" (both tools)  */
-    async doInstall(tool, dev) {
+    async doInstall(tool, dev, scope) {
+        this.requireClaudeScope(tool, scope);
         const spec = toolSpecs[tool];
         await this.ensureTool("npm");
         await this.ensureTool(spec.cli);
@@ -162,15 +163,18 @@ export default class SetupCommand {
             `installing ASE ${spec.label} plugin (origin: ${dev ? "local" : "remote/bundled"})`);
         const pkgdir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
         const source = dev ? path.resolve(pkgdir, "..") : pkgdir;
-        await this.run(spec.cli, ["plugin", "marketplace", "add", source]);
-        await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase"], { retries: 3 });
+        const scopeArgs = tool === "claude" ? ["--scope", scope] : [];
+        await this.run(spec.cli, ["plugin", "marketplace", "add", source, ...scopeArgs]);
+        await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase", ...scopeArgs], { retries: 3 });
         return 0;
     }
     /*  handler for "ase setup update" (both tools)  */
-    async doUpdate(tool, force, dev) {
+    async doUpdate(tool, force, dev, scope) {
+        this.requireClaudeScope(tool, scope);
         const spec = toolSpecs[tool];
         await this.ensureTool("npm");
         await this.ensureTool(spec.cli);
+        const scopeArgs = tool === "claude" ? ["--scope", scope] : [];
         /*  best-effort stop of background service  */
         this.log.write("info", `setup: update${dev ? "[dev]" : ""}: ` +
             "stopping potentially running ASE service");
@@ -186,8 +190,8 @@ export default class SetupCommand {
                 but there is no version change in the plugin manifest,
                 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", spec.pRemove, "ase@ase"], { ignoreError: `ASE ${spec.label} plugin not installed` });
-            await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase"], { retries: 3 });
+            await this.run(spec.cli, ["plugin", spec.pRemove, "ase@ase", ...scopeArgs], { ignoreError: `ASE ${spec.label} plugin not installed` });
+            await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase", ...scopeArgs], { retries: 3 });
         }
         else {
             /*  perform NPM version check  */
@@ -204,49 +208,55 @@ export default class SetupCommand {
             await this.run(updateCmd.cmd, updateCmd.args);
             /*  update ASE plugin (refresh the marketplace snapshot, then
                 update the plugin itself; the OpenAI Codex CLI has no
-                "plugin update" subcommand, so re-install it instead)  */
+                "plugin update" subcommand, so re-install it instead;
+                "plugin marketplace update" has no "--scope" option at all,
+                so it never receives one)  */
             this.log.write("info", `setup: update: updating ASE ${spec.label} plugin`);
             await this.run(spec.cli, ["plugin", "marketplace", spec.pUpdate, "ase"]);
             if (tool !== "codex")
-                await this.run(spec.cli, ["plugin", "update", "ase@ase"]);
+                await this.run(spec.cli, ["plugin", "update", "ase@ase", ...scopeArgs]);
             else {
-                await this.run(spec.cli, ["plugin", spec.pRemove, "ase@ase"], { ignoreError: `ASE ${spec.label} plugin not installed` });
-                await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase"], { retries: 3 });
+                await this.run(spec.cli, ["plugin", spec.pRemove, "ase@ase", ...scopeArgs], { ignoreError: `ASE ${spec.label} plugin not installed` });
+                await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase", ...scopeArgs], { retries: 3 });
             }
         }
         return 0;
     }
     /*  handler for "ase setup enable" (both tools)  */
-    async doEnable(tool) {
+    async doEnable(tool, scope) {
+        this.requireClaudeScope(tool, scope);
         const spec = toolSpecs[tool];
         await this.ensureTool(spec.cli);
         this.log.write("info", `setup: enable: enabling ASE ${spec.label} plugin`);
         /*  the GitHub Copilot CLI and OpenAI Codex CLI have no "plugin
             enable" subcommand, so (re-)install the plugin instead  */
         const args = tool === "claude" ?
-            ["plugin", "enable", "ase@ase"] :
+            ["plugin", "enable", "ase@ase", "--scope", scope] :
             ["plugin", spec.pInstall, "ase@ase"];
         await this.run(spec.cli, args, { retries: tool === "claude" ? 1 : 3 });
         return 0;
     }
     /*  handler for "ase setup disable" (both tools)  */
-    async doDisable(tool) {
+    async doDisable(tool, scope) {
+        this.requireClaudeScope(tool, scope);
         const spec = toolSpecs[tool];
         await this.ensureTool(spec.cli);
         this.log.write("info", `setup: disable: disabling ASE ${spec.label} plugin`);
         /*  the GitHub Copilot CLI and OpenAI Codex CLI have no "plugin
             disable" subcommand, so uninstall the plugin instead  */
         const args = tool === "claude" ?
-            ["plugin", "disable", "ase@ase"] :
+            ["plugin", "disable", "ase@ase", "--scope", scope] :
             ["plugin", spec.pRemove, "ase@ase"];
         await this.run(spec.cli, args, { retries: tool === "claude" ? 1 : 3 });
         return 0;
     }
     /*  handler for "ase setup uninstall" (both tools)  */
-    async doUninstall(tool, dev) {
+    async doUninstall(tool, dev, scope) {
+        this.requireClaudeScope(tool, scope);
         const spec = toolSpecs[tool];
         await this.ensureTool("npm");
         await this.ensureTool(spec.cli);
+        const scopeArgs = tool === "claude" ? ["--scope", scope] : [];
         /*  best-effort stop of background service  */
         this.log.write("info", `setup: uninstall${dev ? "[dev]" : ""}: ` +
             "stopping potentially running ASE service");
@@ -254,8 +264,8 @@ export default class SetupCommand {
         /*  uninstall ASE plugin  */
         this.log.write("info", `setup: uninstall${dev ? "[dev]" : ""}: ` +
             `uninstalling ASE ${spec.label} plugin (origin: ${dev ? "local" : "remote/bundled"})`);
-        await this.run(spec.cli, ["plugin", spec.pRemove, "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` });
+        await this.run(spec.cli, ["plugin", spec.pRemove, "ase@ase", ...scopeArgs], { ignoreError: `ASE ${spec.label} plugin not installed` });
+        await this.run(spec.cli, ["plugin", "marketplace", "remove", "ase", ...scopeArgs], { 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)");
@@ -286,7 +296,8 @@ export default class SetupCommand {
         return 0;
     }
     /*  handler for "ase setup mcp activate|deactivate [<servers>]"  */
-    async doMcp(action, tool, servers) {
+    async doMcp(action, tool, servers, scope) {
+        this.requireClaudeScope(tool, scope);
         await this.ensureTool(toolSpecs[tool].cli);
         /*  source .env files into the environment so the per-server
             API keys (ASE_MCP_KEY_<XXX>) can live in a .env file instead
@@ -336,7 +347,7 @@ export default class SetupCommand {
                 if (installed) {
                     this.log.write("info", `setup: mcp: activate: [${id}]: MCP server "${handle.server}" ` +
                         "already registered: removing stale registration first");
-                    await this.mcpRemove(tool, handle.server);
+                    await this.mcpRemove(tool, handle.server, scope);
                 }
             }
             else if (!installed) {
@@ -348,7 +359,7 @@ export default class SetupCommand {
             /*  call the handler  */
             this.log.write("info", `setup: mcp: ${action}: [${id}]: MCP server "${handle.server}" ` +
                 `(name: ${handle.name}${handle.version ? (", version: " + handle.version) : ""})`);
-            await handle.handler(handle, tool, action, envKey, envVal);
+            await handle.handler(handle, tool, scope, action, envKey, envVal);
         }
         return 0;
     }
@@ -362,10 +373,10 @@ export default class SetupCommand {
         (a local subprocess command) and "http" (a remote URL, optionally
         with HTTP headers) transports; the per-tool command line differs
         between Anthropic Claude Code CLI, GitHub Copilot CLI, and OpenAI Codex CLI  */
-    async mcpAdd(tool, name, env, transport) {
+    async mcpAdd(tool, name, env, transport, scope) {
         const args = ["mcp", "add"];
         if (tool === "claude") {
-            args.push("--scope", "user");
+            args.push("--scope", scope);
             args.push("--transport", transport.type);
             if (transport.type === "stdio") {
                 for (const [key, val] of Object.entries(env))
@@ -417,9 +428,9 @@ export default class SetupCommand {
     }
     /*  unregister an MCP server from the tool; the per-tool command line
         differs between Anthropic Claude Code CLI, GitHub Copilot CLI, and OpenAI Codex CLI  */
-    async mcpRemove(tool, name) {
+    async mcpRemove(tool, name, scope) {
         const args = tool === "claude" ?
-            ["mcp", "remove", "--scope", "user", name] :
+            ["mcp", "remove", "--scope", scope, name] :
             ["mcp", "remove", name];
         await this.run(toolSpecs[tool].cli, args, { ignoreError: `MCP server "${name}" not registered` });
     }
@@ -427,7 +438,7 @@ export default class SetupCommand {
         OPENROUTER url/api/model triples, factoring out the shared
         mcp-to-openai stdio scaffold common to all chat-model servers  */
     chatMcpHandler(direct, router) {
-        return async (spec, tool, action, envKey, envVal) => {
+        return async (spec, tool, scope, action, envKey, envVal) => {
             if (action === "activate")
                 await this.mcpAdd(tool, spec.server, { OPENAI_KEY: envVal }, {
                     type: "stdio", command: [
@@ -444,9 +455,9 @@ export default class SetupCommand {
                             "--openai-model", direct.model
                         ])
                     ]
-                });
+                }, scope);
             else
-                await this.mcpRemove(tool, spec.server);
+                await this.mcpRemove(tool, spec.server, scope);
         };
     }
     /*  registry of pre-defined MCP servers: maps each server id onto its
@@ -513,14 +524,14 @@ export default class SetupCommand {
             env: ["BRAVE"],
             server: "search-brave",
             skills: ["ase-meta-search", "ase-meta-evaluate", "ase-arch-discover"],
-            handler: async (spec, tool, action, _envKey, envVal) => {
+            handler: async (spec, tool, scope, action, _envKey, envVal) => {
                 if (action === "activate")
                     await this.mcpAdd(tool, spec.server, {
                         "BRAVE_API_KEY": envVal,
                         "BRAVE_MCP_ENABLED_TOOLS": "brave_web_search"
-                    }, { type: "stdio", command: ["npx", "-y", "@brave/brave-search-mcp-server"] });
+                    }, { type: "stdio", command: ["npx", "-y", "@brave/brave-search-mcp-server"] }, scope);
                 else
-                    await this.mcpRemove(tool, spec.server);
+                    await this.mcpRemove(tool, spec.server, scope);
             }
         },
         {
@@ -530,13 +541,13 @@ export default class SetupCommand {
             env: ["PERPLEXITY"],
             server: "search-perplexity",
             skills: ["ase-meta-search", "ase-meta-evaluate", "ase-arch-discover"],
-            handler: async (spec, tool, action, _envKey, envVal) => {
+            handler: async (spec, tool, scope, action, _envKey, envVal) => {
                 if (action === "activate")
                     await this.mcpAdd(tool, spec.server, {
                         "PERPLEXITY_API_KEY": envVal
-                    }, { type: "stdio", command: ["npx", "-y", "@perplexity-ai/mcp-server"] });
+                    }, { type: "stdio", command: ["npx", "-y", "@perplexity-ai/mcp-server"] }, scope);
                 else
-                    await this.mcpRemove(tool, spec.server);
+                    await this.mcpRemove(tool, spec.server, scope);
             }
         },
         {
@@ -546,11 +557,11 @@ export default class SetupCommand {
             env: ["EXA"],
             server: "search-exa",
             skills: ["ase-meta-search", "ase-meta-evaluate", "ase-arch-discover"],
-            handler: async (spec, tool, action, _envKey, envVal) => {
+            handler: async (spec, tool, scope, action, _envKey, envVal) => {
                 if (action === "activate")
-                    await this.mcpAdd(tool, spec.server, {}, { type: "http", url: `https://mcp.exa.ai/mcp?exaApiKey=${envVal}` });
+                    await this.mcpAdd(tool, spec.server, {}, { type: "http", url: `https://mcp.exa.ai/mcp?exaApiKey=${envVal}` }, scope);
                 else
-                    await this.mcpRemove(tool, spec.server);
+                    await this.mcpRemove(tool, spec.server, scope);
             }
         }
     ];
@@ -560,6 +571,18 @@ export default class SetupCommand {
             throw new Error(`invalid --tool value: "${value}" (expected "claude", "copilot", or "codex")`);
         return value;
     }
+    /*  parse and validate the --scope option  */
+    parseScope(value) {
+        if (value !== "user" && value !== "project" && value !== "local")
+            throw new Error(`invalid --scope value: "${value}" (expected "user", "project", or "local")`);
+        return value;
+    }
+    /*  reject a non-default --scope for tools which have no scope concept
+        at all (only Anthropic Claude Code CLI supports plugin/MCP scopes)  */
+    requireClaudeScope(tool, scope) {
+        if (tool !== "claude" && scope !== "user")
+            throw new Error("--scope is only supported for --tool claude");
+    }
     /*  register commands  */
     register(program) {
         /*  default for --dev derived from ASE_SETUP_DEV environment variable  */
@@ -581,44 +604,49 @@ export default class SetupCommand {
             .command("install")
             .description("install the ASE plugin for a tool")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .option("-s, --scope <scope>", "target scope (\"user\", \"project\", or \"local\")", "user")
             .option("-d, --dev", "use local working copy instead of remote/bundled repository", devDflt)
             .action(async (opts) => {
-            process.exit(await this.doInstall(this.parseTool(opts.tool), opts.dev));
+            process.exit(await this.doInstall(this.parseTool(opts.tool), opts.dev, this.parseScope(opts.scope)));
         });
         /*  register CLI sub-command "ase setup update"  */
         setupCmd
             .command("update")
             .description("update the ASE tool and the ASE plugin for a tool")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .option("-s, --scope <scope>", "target scope (\"user\", \"project\", or \"local\")", "user")
             .option("-f, --force", "always perform the update, even if already at latest version", false)
             .option("-d, --dev", "use local working copy instead of remote/bundled repository", devDflt)
             .action(async (opts) => {
-            process.exit(await this.doUpdate(this.parseTool(opts.tool), opts.force, opts.dev));
+            process.exit(await this.doUpdate(this.parseTool(opts.tool), opts.force, opts.dev, this.parseScope(opts.scope)));
         });
         /*  register CLI sub-command "ase setup uninstall"  */
         setupCmd
             .command("uninstall")
             .description("uninstall the ASE plugin for a tool and the ASE tool")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .option("-s, --scope <scope>", "target scope (\"user\", \"project\", or \"local\")", "user")
             .option("-d, --dev", "use local working copy instead of remote/bundled repository", devDflt)
             .action(async (opts) => {
-            process.exit(await this.doUninstall(this.parseTool(opts.tool), opts.dev));
+            process.exit(await this.doUninstall(this.parseTool(opts.tool), opts.dev, this.parseScope(opts.scope)));
         });
         /*  register CLI sub-command "ase setup enable"  */
         setupCmd
             .command("enable")
             .description("enable the ASE plugin for a tool")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .option("-s, --scope <scope>", "target scope (\"user\", \"project\", or \"local\")", "user")
             .action(async (opts) => {
-            process.exit(await this.doEnable(this.parseTool(opts.tool)));
+            process.exit(await this.doEnable(this.parseTool(opts.tool), this.parseScope(opts.scope)));
         });
         /*  register CLI sub-command "ase setup disable"  */
         setupCmd
             .command("disable")
             .description("disable the ASE plugin for a tool")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .option("-s, --scope <scope>", "target scope (\"user\", \"project\", or \"local\")", "user")
             .action(async (opts) => {
-            process.exit(await this.doDisable(this.parseTool(opts.tool)));
+            process.exit(await this.doDisable(this.parseTool(opts.tool), this.parseScope(opts.scope)));
         });
         /*  register CLI sub-command "ase setup mcp"  */
         const mcpCmd = setupCmd
@@ -640,16 +668,18 @@ export default class SetupCommand {
             .command("activate [servers]")
             .description("activate pre-defined MCP servers (comma-separated list, or \"all\")")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .option("-s, --scope <scope>", "target scope (\"user\", \"project\", or \"local\")", "user")
             .action(async (servers, opts) => {
-            process.exit(await this.doMcp("activate", this.parseTool(opts.tool), servers ?? "all"));
+            process.exit(await this.doMcp("activate", this.parseTool(opts.tool), servers ?? "all", this.parseScope(opts.scope)));
         });
         /*  register CLI sub-command "ase setup mcp deactivate"  */
         mcpCmd
             .command("deactivate [servers]")
             .description("deactivate pre-defined MCP servers (comma-separated list, or \"all\")")
             .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
+            .option("-s, --scope <scope>", "target scope (\"user\", \"project\", or \"local\")", "user")
             .action(async (servers, opts) => {
-            process.exit(await this.doMcp("deactivate", this.parseTool(opts.tool), servers ?? "all"));
+            process.exit(await this.doMcp("deactivate", this.parseTool(opts.tool), servers ?? "all", this.parseScope(opts.scope)));
         });
     }
 }

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

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