@rse/ase 0.9.11 → 0.9.13

package/dst/ase-setup.js

@@ -13,8 +13,9 @@ import Table from "cli-table3";
 import chalk from "chalk";
 import Version from "./ase-version.js";
 const toolSpecs = {
-    "claude": { cli: "claude", label: "Claude Code" },
-    "copilot": { cli: "copilot", label: "Copilot CLI" }
+    "claude": { cli: "claude", label: "Claude Code", pInstall: "install", pRemove: "uninstall", pUpdate: "update" },
+    "copilot": { cli: "copilot", label: "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"  */
 export default class SetupCommand {
@@ -162,7 +163,7 @@ export default class SetupCommand {
         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", "install", "ase@ase"], { retries: 3 });
+        await this.run(spec.cli, ["plugin", spec.pInstall, "ase@ase"], { retries: 3 });
         return 0;
     }
     /*  handler for "ase setup update" (both tools)  */
@@ -185,8 +186,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", "uninstall", "ase@ase"], { ignoreError: `ASE ${spec.label} plugin not installed` });
-            await this.run(spec.cli, ["plugin", "install", "ase@ase"], { retries: 3 });
+            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 });
         }
         else {
             /*  perform NPM version check  */
@@ -201,10 +202,17 @@ export default class SetupCommand {
             this.log.write("info", `setup: update: updating ASE CLI tool: ${current} -> ${latest}`);
             const updateCmd = await this.npmCmd(["update", "-g", "@rse/ase"], true);
             await this.run(updateCmd.cmd, updateCmd.args);
-            /*  update ASE plugin  */
+            /*  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)  */
             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"]);
+            await this.run(spec.cli, ["plugin", "marketplace", spec.pUpdate, "ase"]);
+            if (tool !== "codex")
+                await this.run(spec.cli, ["plugin", "update", "ase@ase"]);
+            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 });
+            }
         }
         return 0;
     }
@@ -213,9 +221,11 @@ export default class SetupCommand {
         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", "install", "ase@ase"];
+            ["plugin", spec.pInstall, "ase@ase"];
         await this.run(spec.cli, args, { retries: tool === "claude" ? 1 : 3 });
         return 0;
     }
@@ -224,9 +234,11 @@ export default class SetupCommand {
         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", "uninstall", "ase@ase"];
+            ["plugin", spec.pRemove, "ase@ase"];
         await this.run(spec.cli, args, { retries: tool === "claude" ? 1 : 3 });
         return 0;
     }
@@ -242,7 +254,7 @@ 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", "uninstall", "ase@ase"], { ignoreError: `ASE ${spec.label} plugin not installed` });
+        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` });
         /*  uninstall ASE CLI tool (non-development only)  */
         if (!dev) {
@@ -349,7 +361,7 @@ 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 and GitHub Copilot CLI  */
+        between Claude Code, GitHub Copilot CLI, and OpenAI Codex CLI  */
     async mcpAdd(tool, name, env, transport) {
         const args = ["mcp", "add"];
         if (tool === "claude") {
@@ -366,7 +378,7 @@ export default class SetupCommand {
                 args.push(name, transport.url);
             }
         }
-        else {
+        else if (tool === "copilot") {
             /*  GitHub Copilot CLI implies the stdio transport when the
                 command is provided after "--"; only "http"/"sse" servers
                 need an explicit "--transport" flag and take the URL as a
@@ -384,10 +396,27 @@ export default class SetupCommand {
                 args.push(name, transport.url);
             }
         }
+        else {
+            /*  OpenAI Codex CLI takes the server name as the first
+                positional argument and implies the stdio transport when the
+                command is provided after "--"; "http" servers take the URL
+                via the "--url" option (with optional "--header" flags)  */
+            if (transport.type === "stdio") {
+                args.push(name);
+                for (const [key, val] of Object.entries(env))
+                    args.push("--env", `${key}=${val}`);
+                args.push("--", ...transport.command);
+            }
+            else {
+                for (const [key, val] of Object.entries(transport.headers ?? {}))
+                    args.push("--header", `${key}: ${val}`);
+                args.push(name, "--url", transport.url);
+            }
+        }
         await this.run(toolSpecs[tool].cli, args);
     }
     /*  unregister an MCP server from the tool; the per-tool command line
-        differs between Claude Code and GitHub Copilot CLI  */
+        differs between Claude Code, GitHub Copilot CLI, and OpenAI Codex CLI  */
     async mcpRemove(tool, name) {
         const args = tool === "claude" ?
             ["mcp", "remove", "--scope", "user", name] :
@@ -527,8 +556,8 @@ export default class SetupCommand {
     ];
     /*  parse and validate the --tool option  */
     parseTool(value) {
-        if (value !== "claude" && value !== "copilot")
-            throw new Error(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
+        if (value !== "claude" && value !== "copilot" && value !== "codex")
+            throw new Error(`invalid --tool value: "${value}" (expected "claude", "copilot", or "codex")`);
         return value;
     }
     /*  register commands  */
@@ -551,7 +580,7 @@ export default class SetupCommand {
         setupCmd
             .command("install")
             .description("install the ASE plugin for a tool")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
             .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));
@@ -560,7 +589,7 @@ export default class SetupCommand {
         setupCmd
             .command("update")
             .description("update the ASE tool and the ASE plugin for a tool")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", 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/bundled repository", devDflt)
             .action(async (opts) => {
@@ -570,7 +599,7 @@ export default class SetupCommand {
         setupCmd
             .command("uninstall")
             .description("uninstall the ASE plugin for a tool and the ASE tool")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
             .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));
@@ -579,7 +608,7 @@ export default class SetupCommand {
         setupCmd
             .command("enable")
             .description("enable the ASE plugin for a tool")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
             .action(async (opts) => {
             process.exit(await this.doEnable(this.parseTool(opts.tool)));
         });
@@ -587,7 +616,7 @@ export default class SetupCommand {
         setupCmd
             .command("disable")
             .description("disable the ASE plugin for a tool")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
             .action(async (opts) => {
             process.exit(await this.doDisable(this.parseTool(opts.tool)));
         });
@@ -610,7 +639,7 @@ export default class SetupCommand {
         mcpCmd
             .command("activate [servers]")
             .description("activate pre-defined MCP servers (comma-separated list, or \"all\")")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
             .action(async (servers, opts) => {
             process.exit(await this.doMcp("activate", this.parseTool(opts.tool), servers ?? "all"));
         });
@@ -618,7 +647,7 @@ export default class SetupCommand {
         mcpCmd
             .command("deactivate [servers]")
             .description("deactivate pre-defined MCP servers (comma-separated list, or \"all\")")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .option("-t, --tool <tool>", "target tool (\"claude\", \"copilot\", or \"codex\")", toolDflt)
             .action(async (servers, opts) => {
             process.exit(await this.doMcp("deactivate", this.parseTool(opts.tool), servers ?? "all"));
         });

package/dst/ase-skills.js

@@ -263,10 +263,20 @@ export class Skills {
         const halfLife = 365 / 2;
         /*  lifespan requires both timestamps; recentness requires the
             updated timestamp -- any unavailable date-derived factor is
-            treated as neutral `1` so the entry can still be ranked by the
-            remaining metrics, instead of collapsing the product to zero  */
+            given a neutral default so the entry can still be ranked by the
+            remaining metrics, instead of collapsing the product to zero.
+            For `lifespan` (an unbounded duration) the multiplicative-neutral
+            `1` is also the low floor, so a missing value cannot unfairly
+            inflate the rank. For `recentness`, however, the value is an
+            exp-decay factor bounded in `(0,1]` where `1` is the *ceiling*
+            (a just-now update), not a floor -- defaulting a missing update
+            date to `1` would hand packages with absent metadata the highest
+            possible recentness and let them outrank genuinely fresh ones.
+            We therefore default a missing `recentness` to the decay value at
+            one half-life (`0.5`), a conservative midpoint that keeps the
+            entry rankable without rewarding the missing date.  */
         const lifespan = (!Number.isNaN(cMs) && !Number.isNaN(uMs)) ? Math.max(0, uMs - cMs) : 1;
-        const recentness = !Number.isNaN(uMs) ? Math.exp(-Math.max(0, (now - uMs) / msPerDay) / halfLife) : 1;
+        const recentness = !Number.isNaN(uMs) ? Math.exp(-Math.max(0, (now - uMs) / msPerDay) / halfLife) : 0.5;
         return d * s * lifespan * recentness;
     }
     /*  compute the per-alternative product-sum (rating) row from a

package/dst/ase-statusline.js

@@ -67,7 +67,7 @@ const formatTokens = (n) => {
     if (n >= 1_000_000)
         return `${(n / 1_000_000).toFixed(1)}M`;
     if (n >= 1_000)
-        return `${Math.round(n / 1_000)}k`;
+        return `${(n / 1_000).toFixed(1)}k`;
     return `${n}`;
 };
 /*  format a millisecond duration as a compact human-readable string (e.g. 6d 12hr 7m, 4hr 27m, 12m 30s)  */
@@ -184,8 +184,8 @@ export default class StatuslineCommand {
     }
     /*  parse and validate the --tool option  */
     parseTool(value) {
-        if (value !== "claude" && value !== "copilot")
-            throw new InvalidArgumentError(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
+        if (value !== "claude" && value !== "copilot" && value !== "codex")
+            throw new InvalidArgumentError(`invalid --tool value: "${value}" (expected "claude", "copilot", or "codex")`);
         return value;
     }
     /*  register commands  */
@@ -196,7 +196,7 @@ export default class StatuslineCommand {
         program
             .command("statusline")
             .description("Render Claude Code or GitHub Copilot CLI statusline from stdin JSON")
-            .option("-t, --tool <tool>", "target tool (\"claude\" or \"copilot\")", toolDflt)
+            .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)
             .option("--no-icons", "disable icons in placeholder rendering")
@@ -208,6 +208,10 @@ export default class StatuslineCommand {
             .action(async (lines, opts) => {
             /*  validate target tool  */
             const tool = this.parseTool(opts.tool);
+            /*  OpenAI Codex CLI has no scriptable custom statusline
+                mechanism, so reject the request explicitly  */
+            if (tool === "codex")
+                throw new Error("OpenAI Codex CLI does not support a custom statusline");
             /*  read all of stdin  */
             const input = await readStdin();
             /*  parse JSON data  */
@@ -358,7 +362,7 @@ export default class StatuslineCommand {
                     emit(`${prefix("◔", "context")}${bar} ${pct}%`);
                 },
                 C: () => {
-                    const pct = Math.floor(data.context_window?.used_percentage ?? 0);
+                    const pct = data.context_window?.used_percentage ?? 0;
                     const tokensCur = (data.context_window?.total_input_tokens ?? 0) +
                         (data.context_window?.total_output_tokens ?? 0);
                     const tokensLim = pct > 0 && tokensCur > 0 ? Math.round(tokensCur * 100 / pct) : 0;

package/dst/ase.js

@@ -15,9 +15,10 @@ import SetupCommand from "./ase-setup.js";
 import StatuslineCommand from "./ase-statusline.js";
 import TaskCommand from "./ase-task.js";
 import ArtifactCommand from "./ase-artifact.js";
+import CompatCommand from "./ase-compat.js";
 import pkg from "../package.json" with { type: "json" };
 /*  globally initialize logger  */
-const log = new Log("ase", "warning", "-");
+const log = new Log("ase", "info", "-");
 /*  main entry point (wrapped in a regular async function to avoid
     top-level await, which would be reported as "unsettled" by Node in
     the long-running daemon process spawned by "ase service start")  */
@@ -51,6 +52,7 @@ const main = async () => {
     new StatuslineCommand(log).register(program);
     new TaskCommand(log).register(program);
     new ArtifactCommand(log).register(program);
+    new CompatCommand().register(program);
     new DiagramCommand(log).register(program);
     /*  parse program arguments  */
     await program.parseAsync(process.argv);

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.11",
+    "version":                              "0.9.13",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -58,6 +58,7 @@
         "which":                            "7.0.0",
         "update-notifier":                  "7.3.1",
         "shell-quote":                      "1.8.4",
+        "get-stdin":                        "10.0.0",
         "proper-lockfile":                  "4.1.2",
         "write-file-atomic":                "8.0.0",
         "pacote":                           "21.5.1",

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

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.9.11",
+    "version":     "0.9.13",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.codex-plugin/mcp.json

@@ -0,0 +1,8 @@
+{
+    "mcpServers": {
+        "ase": {
+            "command": "ase",
+            "args":    [ "mcp" ]
+        }
+    }
+}

package/plugin/.codex-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+    "name":        "ase",
+    "version":     "0.9.13",
+    "description": "Agentic Software Engineering (ASE)",
+    "keywords":    [ "agentic", "software", "engineering" ],
+    "homepage":    "https://ase.tools",
+    "repository":  "https://github.com/rse/ase",
+    "license":     "GPL-3.0",
+    "author": {
+        "name":    "Dr. Ralf S. Engelschall",
+        "email":   "rse@engelschall.com",
+        "url":     "https://engelschall.com"
+    },
+    "skills":      "./skills/",
+    "hooks":       "./hooks/hooks-codex.json",
+    "mcpServers":  "./.codex-plugin/mcp.json"
+}

package/plugin/.github/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.9.11",
+    "version":     "0.9.13",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/hooks/hooks-codex.json

@@ -0,0 +1,67 @@
+{
+    "hooks": {
+        "SessionStart": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook session-start --tool codex",
+                        "statusMessage": "Loading ASE..."
+                    }
+                ]
+            }
+        ],
+        "SessionEnd": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook session-end --tool codex",
+                        "statusMessage": "Cleaning up ASE..."
+                    }
+                ]
+            }
+        ],
+        "PreToolUse": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook pre-tool-use --tool codex"
+                    }
+                ]
+            }
+        ],
+        "PermissionRequest": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook permission-request --tool codex",
+                        "statusMessage": "Approve ASE..."
+                    }
+                ]
+            }
+        ],
+        "UserPromptSubmit": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook user-prompt-submit --tool codex"
+                    }
+                ]
+            }
+        ],
+        "Stop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "ase hook stop --tool codex"
+                    }
+                ]
+            }
+        ]
+    }
+}

package/plugin/meta/ase-dialog.md

@@ -9,6 +9,9 @@ User Dialog
 <if condition="<ase-agent-tool/> is 'copilot'">
     <user-dialog-tool>ask_user</user-dialog-tool>
 </if>
+<if condition="<ase-agent-tool/> is 'codex'">
+    <user-dialog-tool>none</user-dialog-tool>
+</if>
 
 <define name="user-dialog">
 
@@ -138,6 +141,23 @@ Let the *user interactively choose* an answer.
 
         </if>
 
+    -   <if condition="<ase-agent-tool/> is 'codex'">
+
+        OpenAI Codex CLI has *no* interactive user-dialog tool, so you
+        *MUST* *NOT* call any tool here. Instead, render the question and
+        answers as a custom Markdown dialog and let the user reply with a
+        free-text choice -- exactly as defined by the following expansion,
+        passing <spec/> as its question specification, and set <result/> to
+        the result of that custom dialog:
+
+        <expand name="custom-dialog" arg1="--other">
+            <spec/>
+        </expand>
+
+        Do not output anything in this step!
+
+        </if>
+
 </define>
 
 <define name="custom-dialog">
@@ -165,7 +185,7 @@ following procedure:
 
     Do not output anything in this step!
 
-2.  Dispatch according to the agent tool:
+2.  Render the custom dialog, collect the user input, and dispatch on the result:
 
     1.  You *MUST* not output anything in this step.
 

package/plugin/meta/ase-format-arch.md

@@ -243,7 +243,7 @@ at runtime.
         for the component's existence and boundary.
 
     -   In case a component has no dependencies at all, the
-        entire `- Depends On:` bullet point is omitted.
+        entire `-   Depends On:` bullet point is omitted.
 
     -   In case the rationale is not present, the
         entire `, **BECAUSE** [...]` clause is omitted.
@@ -666,8 +666,16 @@ How the Non-Functional Requirements (NR) are addressed.
         perspective addresses, one of `Performance`, `Scalability`,
         `Reliability`, `Availability`, `Security`, `Privacy`,
         `Usability`, `Accessibility`, `Maintainability`, `Portability`,
-        `Compatibility`, or `Compliance` (aligned with the Non-Functional
-        Requirements categories).
+        `Compatibility`, or `Compliance`. This enumeration is a
+        solution-oriented refinement of the Non-Functional Requirements
+        (NR) categories and intentionally differs from them: the NR
+        categories follow the ISO/IEC 25010:2023 top-level characteristics
+        (and include `Safety` and `Flexibility`), whereas the perspective
+        qualities decompose some of these into the finer-grained,
+        architecturally actionable attributes `Scalability`,
+        `Availability`, `Privacy`, `Accessibility`, and `Portability`. A
+        perspective's quality therefore need not match the category of the
+        `SPEC-NR-<spec-nr-requirement-id/>` it addresses.
 
     -   <arch-qp-perspective-requirement/> is a
         `SPEC-NR-<spec-nr-requirement-id/>` reference to the corresponding
@@ -722,10 +730,11 @@ forces at play, the chosen response, and the reasoning that justifies it.
 
     ##  DECISION: <arch-dr-decision-name/> <a id="ARCH-DR-<arch-dr-decision-id/>"></a>
 
-    -   Status:    <arch-dr-decision-status/>
-    -   Affects:   <arch-dr-decision-element/>, [...]
-    -   Created:   <arch-dr-decision-created/>
-    -   Modified:  <arch-dr-decision-modified/>
+    -   Status:        <arch-dr-decision-status/>
+    -   Affects:       <arch-dr-decision-element/>, [...]
+    -   Superseded-By: <arch-dr-decision-superseded-by/>
+    -   Created:       <arch-dr-decision-created/>
+    -   Modified:      <arch-dr-decision-modified/>
 
     -   WHEN (Context):
         <arch-dr-decision-context/>
@@ -752,12 +761,17 @@ forces at play, the chosen response, and the reasoning that justifies it.
         <arch-dr-decision-decision/>, not longer than 80 characters.
 
     -   <arch-dr-decision-status/> is one of `proposed`, `accepted`,
-        `deprecated`, or `superseded by ARCH-DR-<arch-dr-decision-id/>`.
+        `deprecated`, or `superseded`.
 
     -   <arch-dr-decision-element/> is an `ARCH-FV-<arch-fv-component-id/>`
         or `ARCH-DP-<arch-dp-node-id/>` reference to the functional
         element or deployment node the decision affects.
 
+    -   <arch-dr-decision-superseded-by/> is an
+        `ARCH-DR-<arch-dr-decision-id/>` reference to the decision that
+        supersedes this decision. It is present if and only if the
+        <arch-dr-decision-status/> is `superseded`.
+
     -   <arch-dr-decision-created/> is the timestamp when this decision was
         created, and <arch-dr-decision-modified/> is the timestamp when
         this decision was last modified, both in the same ISO-style format
@@ -832,7 +846,10 @@ forces at play, the chosen response, and the reasoning that justifies it.
         job.
 
     -   In case the element reference is not present, the
-        entire `- Affects:` bullet point is omitted.
+        entire `-   Affects:` bullet point is omitted.
+
+    -   In case the <arch-dr-decision-status/> is not `superseded`, the
+        entire `-   Superseded-By:` bullet point is omitted.
 
     -   In case the `NOTES (Background)` content is not present, the
         entire `NOTES (Background)` chunk is omitted.

package/plugin/meta/ase-format-meta.md

@@ -29,9 +29,13 @@ Artifact Meta Information
 -   **Artifact**:
 
     At level 2, each **Artifact Set** is composed of many **Artifact**s.
-    Each **Artifact** has a unique identifier <artifact-id/>, which is
-    an upper-case, two-letter identifier (e.g. `CJ` for `Customer
-    Journey`) derived from the **Artifact** name.
+    Each **Artifact** has an identifier <artifact-id/>, which is an
+    upper-case, two-letter identifier (e.g. `CJ` for `Customer Journey`)
+    derived from the **Artifact** name. The <artifact-id/> is unique
+    only *within* its **Artifact Set**; the globally-unique handle of an
+    **Artifact** is the qualified form <artifact-set-id/>-<artifact-id/>
+    (e.g. `SPEC-DP` and `ARCH-DP` are distinct artifacts). All
+    references to an **Artifact** *MUST* use this qualified form.
 
     Each **Artifact** also has a sequence number <artifact-no/>, which
     is the zero-padded, two-digit position of the **Artifact** (starting

package/plugin/meta/ase-format-spec.md

@@ -871,8 +871,8 @@ for main, alternative, and exceptional paths.
 
     -   <spec-uc-usecase-description/>: a concise paragraph (1-3
         sentences) of prose describing the use case at a glance, without
-        prescribing the step-by-step flow (which belongs to the **Use
-        Case Scenarios** **Artifact**).
+        prescribing the step-by-step flow (which belongs to the
+        **SCENARIO** blocks of this use case).
 
     -   In case the use case realizes no specific functional requirement,
         the entire `- Requirements:` bullet point is omitted.
@@ -884,7 +884,7 @@ for main, alternative, and exceptional paths.
 
     <format>
 
-    ### SCENARIO: <spec-uc-usecase-scenario-name/> (<spec-uc-usecase-scenario-type/>)
+    ### SCENARIO: <spec-uc-usecase-scenario-name/> (<spec-uc-usecase-scenario-type/>) <a id="SPEC-UC-<spec-uc-usecase-id/>-<spec-uc-usecase-scenario-id/>"></a>
 
     1.  <spec-uc-usecase-scenario-step/>
     2.  <spec-uc-usecase-scenario-step/>
@@ -894,6 +894,11 @@ for main, alternative, and exceptional paths.
 
 -   <spec-uc-usecase-scenario/> details:
 
+    -   <spec-uc-usecase-scenario-id/>: per-use-case unique "slug" of
+        always 1-3 lower-cased words (concatenated with "-" characters
+        and in total not longer than 30 characters), derived from
+        <spec-uc-usecase-scenario-name/>.
+
     -   <spec-uc-usecase-scenario-name/>: a short (3-8 word) summary of the
         scenario.
 
@@ -1213,9 +1218,9 @@ turn.
         visualizes (optional).
 
     -   <spec-ds-storyboard-scenario/> is a
-        Use Case scenario type `<spec-uc-usecase-scenario-type/>` of
-        the corresponding **Aspect** of the Use Case **Artifact** the
-        storyboard visualizes (optional).
+        `SPEC-UC-<spec-uc-usecase-id/>-<spec-uc-usecase-scenario-id/>`
+        reference to the corresponding scenario **Aspect** of the Use
+        Case **Artifact** the storyboard visualizes (optional).
 
     -   <spec-ds-frame-name/>: a short (2-5 word) label for the screen,
         turn, or state depicted by the storyboard frame. Frames are

package/plugin/meta/ase-getopt.md

@@ -27,8 +27,8 @@ set placeholders into the context as a side-effect.
         `--<long/>[|-<short/>][=<default/>|=(<c1/>|<c2/>|...)[...]]`, set
         <getopt-option-<long/>/> to <default/> (for `=<default/>`
         form), or to the *single token* <c1/> (the first choice, both
-        for the choice form `=(<c1/>|<c2>/|...)` and for the list form
-        `=(<c1/>|<c2>/|...)...` -- an *unsupplied* list-option always
+        for the choice form `=(<c1/>|<c2/>|...)` and for the list form
+        `=(<c1/>|<c2/>|...)...` -- an *unsupplied* list-option always
         defaults to the single token <c1/>, *not* to a whole list),
         or to `false` (for value-less options). Then set
         <getopt-arguments><getopt-args/></getopt-arguments>.
@@ -63,6 +63,10 @@ set placeholders into the context as a side-effect.
     validate each remaining token themselves as they consume it).
 
 4.  **Short-Circuit for Error**:
+    This step is the *sole* and *authoritative* handler for an
+    `ERROR:`-prefixed `ase_getopt` response; the generic MCP-Tool-Calls
+    error rule (see `ase-skill.md`) explicitly does *NOT* apply here, so
+    only the <template/> below is emitted (never both).
     If <text/> starts with `ERROR:`:
     Remove all `ERROR:` or `error:` prefixes from <text/>.
     Then only output the following <template/> and