@rse/ase 0.9.32 → 0.9.34

package/dst/ase-hook.js

@@ -25,8 +25,8 @@ const addonMcpServers = [
     "search-perplexity"
 ];
 /*  build a per-tool regular expression matching the tool names exposed
-    by the addon MCP servers: Claude Code prefixes them as
-    "mcp__<server>__<tool>", whereas Copilot CLI prefixes them as
+    by the addon MCP servers: Anthropic Claude Code CLI prefixes them as
+    "mcp__<server>__<tool>", whereas GitHub Copilot CLI prefixes them as
     "<server>-<tool>"  */
 const addonMcpToolNamePattern = (prefix, suffix) => {
     const alternatives = addonMcpServers
@@ -202,8 +202,8 @@ 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 (Claude Code uses snake_case fields,
-            Copilot CLI uses camelCase fields)  */
+        /*  read session information (Anthropic Claude Code CLI uses snake_case fields,
+            GitHub Copilot CLI uses camelCase fields)  */
         const stdin = await this.readStdin();
         const input = this.parseJSON(stdin, v.object({
             session_id: v.optional(v.string()),
@@ -252,8 +252,8 @@ export default class HookCommand {
             persona = val;
         /*  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)  */
+        /*  provide ASE information to Anthropic Claude Code CLI shell commands
+            (Anthropic Claude Code CLI only -- GitHub Copilot CLI has no equivalent mechanism)  */
         const envFile = tool === "claude" ? (process.env.CLAUDE_ENV_FILE ?? "") : "";
         if (envFile !== "") {
             const script = `export ASE_VERSION=${quote([versionCurrentPlugin])}\n` +
@@ -284,15 +284,15 @@ export default class HookCommand {
         /*  build the deterministic ASE banner (rendered directly by the
             agent harness, independent of any model decision, so it is
             guaranteed to appear once in every non-headless session;
-            Claude Code and OpenAI Codex CLI surface a top-level
-            "systemMessage" field for this -- Copilot CLI has no equivalent)  */
+            Anthropic Claude Code CLI and OpenAI Codex CLI surface a top-level
+            "systemMessage" field for this -- GitHub Copilot CLI has no equivalent)  */
         const banner = `\n⧉ ASE: ⎈ version: ${versionCurrentPlugin}${versionHint !== "" ? " " + versionHint.replaceAll(/\*/g, "") : ""}` +
             `\n⧉ ASE: ※ user: ${userId}, ⚑ project: ${projectId}` +
             `\n⧉ ASE: ◉ task: ${taskId}, ⏻ session: ${sessionId}` +
             `\n⧉ ASE: ☯ persona: ${persona}`;
         /*  inject markdown into session context.
-            Claude Code and OpenAI Codex CLI expect the context nested in
-            "hookSpecificOutput"; Copilot CLI expects a flat top-level
+            Anthropic Claude Code CLI and OpenAI Codex CLI expect the context nested in
+            "hookSpecificOutput"; GitHub Copilot CLI expects a flat top-level
             "additionalContext" field.  */
         const payload = tool !== "copilot" ? {
             "hookSpecificOutput": {
@@ -313,8 +313,8 @@ export default class HookCommand {
     /*  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
+        independent of Anthropic Claude Code CLI's statusline repaint cadence).
+        Notice: the Anthropic Claude Code CLI statusline is not usable for this case
         at all, as it is not repainted during agent processing!  */
     writeAgentStatus(status) {
         const icon = status === "busy" ? "▶" : "⏸";
@@ -354,8 +354,8 @@ export default class HookCommand {
         }
         return 0;
     }
-    /*  pick the session id from a parsed payload (Claude Code uses
-        snake_case fields, Copilot CLI uses camelCase fields)  */
+    /*  pick the session id from a parsed payload (Anthropic Claude Code CLI uses
+        snake_case fields, GitHub Copilot CLI uses camelCase fields)  */
     pickSessionId(input) {
         return input.session_id ?? input.sessionId ?? "";
     }
@@ -444,7 +444,7 @@ export default class HookCommand {
         return { approve: false, reason: "" };
     }
     /*  handler for "ase hook pre-tool-use" (all tools).
-        For Claude Code and Copilot CLI this is where ASE tool
+        For Anthropic Claude Code CLI and GitHub Copilot CLI this is where ASE tool
         invocations are auto-approved (via "permissionDecision: allow").
         OpenAI Codex CLI rejects that mechanism in "PreToolUse", so for
         Codex this handler stays silent and approval is granted in the
@@ -465,8 +465,8 @@ export default class HookCommand {
         /*  determine whether to auto-approve the tool invocation  */
         const { approve, reason } = this.decideApproval(tool, spec, input);
         /*  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.  */
+            Anthropic Claude Code CLI expects the decision nested in "hookSpecificOutput";
+            GitHub Copilot CLI expects flat top-level fields.  */
         if (approve) {
             const payload = spec.preToolUseWrapped ? {
                 "hookSpecificOutput": {
@@ -524,7 +524,7 @@ export default class HookCommand {
         /*  register CLI top-level command "ase hook"  */
         const hookCmd = program
             .command("hook")
-            .description("Claude Code and Copilot CLI hook entry points")
+            .description("Anthropic Claude Code CLI and GitHub Copilot CLI hook entry points")
             .action(() => {
             hookCmd.outputHelp();
             process.exit(1);

package/dst/ase-kv.js

@@ -7,7 +7,7 @@ import { z } from "zod";
 /*  reusable functionality: in-memory key/value store living inside the
     "ase service" process; per-project (one service per project) and
     not persisted; intended for sharing information between skills
-    across multiple Claude Code instances connected to the same service  */
+    across multiple Anthropic Claude Code CLI instances connected to the same service  */
 export class KV {
     /*  the actual in-memory store  */
     static store = new Map();

package/dst/ase-setup.js

@@ -13,8 +13,8 @@ import Table from "cli-table3";
 import chalk from "chalk";
 import Version from "./ase-version.js";
 const toolSpecs = {
-    "claude": { cli: "claude", label: "Claude Code", pInstall: "install", pRemove: "uninstall", pUpdate: "update" },
-    "copilot": { cli: "copilot", label: "Copilot CLI", pInstall: "install", pRemove: "uninstall", pUpdate: "update" },
+    "claude": { cli: "claude", label: "Anthropic Claude Code CLI", pInstall: "install", pRemove: "uninstall", pUpdate: "update" },
+    "copilot": { cli: "copilot", label: "GitHub Copilot CLI", pInstall: "install", pRemove: "uninstall", pUpdate: "update" },
     "codex": { cli: "codex", label: "OpenAI Codex CLI", pInstall: "add", pRemove: "remove", pUpdate: "upgrade" }
 };
 /*  CLI command "ase setup"  */
@@ -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;
     }
@@ -361,11 +372,11 @@ export default class SetupCommand {
     /*  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
-        between Claude Code, GitHub Copilot CLI, and OpenAI Codex CLI  */
-    async mcpAdd(tool, name, env, transport) {
+        between Anthropic Claude Code CLI, GitHub Copilot CLI, and OpenAI Codex CLI  */
+    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))
@@ -416,10 +427,10 @@ export default class SetupCommand {
         await this.run(toolSpecs[tool].cli, args);
     }
     /*  unregister an MCP server from the tool; the per-tool command line
-        differs between Claude Code, GitHub Copilot CLI, and OpenAI Codex CLI  */
-    async mcpRemove(tool, name) {
+        differs between Anthropic Claude Code CLI, GitHub Copilot CLI, and OpenAI Codex CLI  */
+    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/dst/ase-statusline.js

@@ -12,7 +12,7 @@ import { execaSync } from "execa";
 import { Chalk } from "chalk";
 import { Config, configSchema, parseScope } from "./ase-config.js";
 import pkg from "../package.json" with { type: "json" };
-/*  forced-color chalk instance: stdout is a pipe under Claude Code,
+/*  forced-color chalk instance: stdout is a pipe under Anthropic Claude Code CLI,
     so chalk auto-detection would yield level 0; force level 1 to keep
     emitting ANSI sequences as the original implementation did  */
 const c = new Chalk({ level: 1 });
@@ -34,7 +34,7 @@ const readStdin = async () => {
         chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
     return Buffer.concat(chunks).toString("utf8");
 };
-/*  detect terminal column width via /dev/tty (stdout is a pipe under Claude Code)  */
+/*  detect terminal column width via /dev/tty (stdout is a pipe under Anthropic Claude Code CLI)  */
 const detectTermWidth = () => {
     let width = 0;
     let tty = null;
@@ -195,7 +195,7 @@ export default class StatuslineCommand {
         const toolDflt = envTool !== "" ? this.parseTool(envTool) : "claude";
         program
             .command("statusline")
-            .description("Render Claude Code or GitHub Copilot CLI statusline from stdin JSON")
+            .description("Render Anthropic Claude Code CLI or GitHub Copilot CLI statusline from stdin JSON")
             .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\"; \"codex\" is unsupported)", 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)
@@ -225,7 +225,7 @@ export default class StatuslineCommand {
                 process.exit(1);
             }
             /*  normalize Copilot CLI's top-level "cwd" into the
-                "workspace.current_dir" structure shared with Claude Code  */
+                "workspace.current_dir" structure shared with Anthropic Claude Code CLI  */
             if (tool === "copilot"
                 && (data.workspace?.current_dir === undefined || data.workspace.current_dir === "")
                 && typeof data.cwd === "string" && data.cwd !== "") {

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

package/plugin/meta/ase-constitution.md

@@ -2,8 +2,8 @@
 ASE Constitution
 ================
 
-You are **Claude Code**, an expert-level AI coding assistant.
-You have the **Agentic Software Engineering (ASE)** facility enabled,
+You are an expert-level AI coding assistant.
+You have the **Agentic Software Engineering (ASE)** companion toolkit enabled,
 which boosts you to an expert-level Software Engineering AI agent.
 
 If ((<ase-agent-tool/> is equal `codex`) *AND* (<ase-headless/> is empty

package/plugin/meta/ase-skill.md

@@ -28,7 +28,7 @@ Skill Output
 -   *IMPORTANT*: For *Final-Message-Only Display* ("focus mode"):
     some agent harnesses show the user only the *final* text message of
     a turn and *hide* all text emitted *between* tool calls. If your
-    harness instructions indicate such a mode (e.g. *Claude Code* with
+    harness instructions indicate such a mode (e.g. *Anthropic Claude Code CLI* with
     "focus mode" enabled), you *MUST* repeat *all* <template/> outputs
     emitted since the last shown final text message -- *verbatim*, in
     their *original order*, and each only *once* -- at the *top* of the

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