@rse/ase 0.9.4 → 0.9.6

package/dst/ase-task.js

@@ -7,11 +7,13 @@ import path from "node:path";
 import fs from "node:fs";
 import { execaSync } from "execa";
 import { DateTime } from "luxon";
+import picomatch from "picomatch";
 import { isScalar } from "yaml";
 import { z } from "zod";
 import { Config, configSchema, parseScope } from "./ase-config.js";
 /*  reusable functionality: persisted task plans under
-    <project>/.ase/task/<id>/plan.md  */
+    <project>/<basedir>/TASK-<id>.md (driven by the
+    "project.artifact.task.{basedir,files}" configuration)  */
 export class Task {
     /*  validate the task id to keep it safe as a filename component  */
     static validateId(id) {
@@ -34,100 +36,173 @@ export class Task {
         }
         return process.cwd();
     }
+    /*  read the configured "basedir" anchor and "files" miniglob spec for
+        task storage; "basedir" is project-root-relative (POSIX, defaults
+        to ".ase/task") and "files" constrains the task filenames
+        (defaults to "*.md")  */
+    static spec(log) {
+        const cfg = new Config("config", configSchema, log);
+        cfg.read();
+        const read = (key) => {
+            const val = cfg.get(key);
+            if (val === undefined)
+                return "";
+            return String(isScalar(val) ? val.value : val);
+        };
+        const basedir = (read("project.artifact.task.basedir") || ".ase/task")
+            .replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+        const files = read("project.artifact.task.files") || "*.md";
+        return { basedir, files };
+    }
     /*  resolve the on-disk base directory for task storage  */
-    static baseDir() {
-        return path.join(Task.projectRoot(), ".ase", "task");
+    static baseDir(log) {
+        return path.join(Task.projectRoot(), Task.spec(log).basedir);
     }
-    /*  resolve the on-disk path for a given task id  */
-    static path(id) {
+    /*  resolve the on-disk path for a given task id; as a side effect,
+        eagerly migrate any legacy <basedir>/<id>/plan.md files to the
+        current <basedir>/TASK-<id>.md layout on first access (guarded by
+        a cheap check, so it is a no-op once the store is migrated)  */
+    static path(log, id) {
         Task.validateId(id);
-        return path.join(Task.baseDir(), id, "plan.md");
+        if (Task.needsMigration(log))
+            Task.migrateAll(log);
+        return path.join(Task.baseDir(log), `TASK-${id}.md`);
+    }
+    /*  cheaply check whether any legacy <basedir>/<id>/plan.md file still
+        exists in the task base directory and thus needs migration  */
+    static needsMigration(log) {
+        const dir = Task.baseDir(log);
+        if (!fs.existsSync(dir))
+            return false;
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory() || !/^[A-Za-z0-9-]+$/.test(entry.name))
+                continue;
+            if (fs.existsSync(path.join(dir, entry.name, "plan.md")))
+                return true;
+        }
+        return false;
+    }
+    /*  migrate all legacy <basedir>/<id>/plan.md task files to the current
+        <basedir>/TASK-<id>.md layout; an existing TASK-<id>.md is never
+        overwritten; the now-empty <id>/ directory is removed afterwards;
+        returns the list of migrated task ids in lexicographic order  */
+    static migrateAll(log) {
+        const dir = Task.baseDir(log);
+        if (!fs.existsSync(dir))
+            return [];
+        const migrated = [];
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory() || !/^[A-Za-z0-9-]+$/.test(entry.name))
+                continue;
+            const id = entry.name;
+            const oldFile = path.join(dir, id, "plan.md");
+            const newFile = path.join(dir, `TASK-${id}.md`);
+            if (!fs.existsSync(oldFile))
+                continue;
+            if (fs.existsSync(newFile)) {
+                log.write("warning", `task: not migrating "${id}": target "TASK-${id}.md" already exists`);
+                continue;
+            }
+            fs.renameSync(oldFile, newFile);
+            fs.rmSync(path.join(dir, id), { recursive: true, force: true });
+            migrated.push(id);
+        }
+        migrated.sort((a, b) => a.localeCompare(b));
+        return migrated;
     }
     /*  load a task; returns empty string if no task exists  */
-    static load(id) {
-        const file = Task.path(id);
+    static load(log, id) {
+        const file = Task.path(log, id);
         if (!fs.existsSync(file))
             return "";
         return fs.readFileSync(file, "utf8");
     }
-    /*  save a task as UTF-8 text under the given id; the task's home
-        directory <project>/.ase/task/<id>/ is owned by ASE and removed
-        in full by Task.delete, so callers must not place foreign files there  */
-    static save(id, text) {
+    /*  save a task as UTF-8 text under the given id into the
+        <project>/<basedir>/TASK-<id>.md file  */
+    static save(log, id, text) {
         if (typeof text !== "string")
             throw new Error("task: text must be a string");
-        const file = Task.path(id);
+        const file = Task.path(log, id);
         fs.mkdirSync(path.dirname(file), { recursive: true });
         fs.writeFileSync(file, text, "utf8");
     }
-    /*  delete a task by id; removes the entire task home directory
-        <project>/.ase/task/<id>/ (owned by ASE); returns true if a task existed  */
-    static delete(id) {
-        const file = Task.path(id);
+    /*  delete a task by id; removes the single
+        <project>/<basedir>/TASK-<id>.md file; returns true if a task existed  */
+    static delete(log, id) {
+        const file = Task.path(log, id);
         if (!fs.existsSync(file))
             return false;
-        fs.rmSync(path.dirname(file), { recursive: true, force: true });
+        fs.rmSync(file, { force: true });
         return true;
     }
-    /*  rename a task by moving the entire task home directory
-        <project>/.ase/task/<oldId>/ to <project>/.ase/task/<newId>/;
-        returns true on success, false if the source task does not exist;
-        throws if the target id already exists  */
-    static rename(oldId, newId) {
-        const oldDir = path.dirname(Task.path(oldId));
-        const newDir = path.dirname(Task.path(newId));
-        if (!fs.existsSync(oldDir))
+    /*  rename a task by moving its <project>/<basedir>/TASK-<oldId>.md file
+        to <project>/<basedir>/TASK-<newId>.md; the embedded
+        "# ✪ TASK <id>:" heading inside the plan content is rewritten to
+        the new id; returns true on success, false if the source task does
+        not exist; throws if the target id already exists  */
+    static rename(log, oldId, newId) {
+        const oldFile = Task.path(log, oldId);
+        const newFile = Task.path(log, newId);
+        if (!fs.existsSync(oldFile))
             return false;
-        if (fs.existsSync(newDir))
+        if (fs.existsSync(newFile))
             throw new Error(`task: target id "${newId}" already exists`);
-        fs.mkdirSync(path.dirname(newDir), { recursive: true });
-        fs.renameSync(oldDir, newDir);
+        const text = fs.readFileSync(oldFile, "utf8");
+        const updated = text.replace(/(^#\s+(?:✪\s+)?TASK\s+)[A-Za-z0-9-]+(\s*:)/m, `$1${newId}$2`);
+        fs.mkdirSync(path.dirname(newFile), { recursive: true });
+        fs.writeFileSync(newFile, updated, "utf8");
+        fs.rmSync(oldFile, { force: true });
         return true;
     }
     /*  list all persisted tasks in lexicographic id order; if verbose is true,
-        each entry's `mtime` is set to the `plan.md` modification time formatted
-        as "YYYY-MM-DD HH:MM", otherwise it is left undefined  */
-    static list(verbose = false) {
-        const dir = Task.baseDir();
+        each entry's `mtime` is set to the task file's modification time
+        formatted as "YYYY-MM-DD HH:MM", otherwise it is left undefined  */
+    static list(log, verbose = false) {
+        if (Task.needsMigration(log))
+            Task.migrateAll(log);
+        const { basedir, files } = Task.spec(log);
+        const dir = path.join(Task.projectRoot(), basedir);
         if (!fs.existsSync(dir))
             return [];
+        const isMatch = picomatch(files, { dot: true });
         const out = [];
         for (const entry of fs.readdirSync(dir)) {
-            if (!/^[A-Za-z0-9-]+$/.test(entry))
-                continue;
-            const file = path.join(dir, entry, "plan.md");
-            if (!fs.existsSync(file))
+            const m = /^TASK-([A-Za-z0-9-]+)\.md$/.exec(entry);
+            if (m === null || !isMatch(entry))
                 continue;
+            const file = path.join(dir, entry);
             const st = fs.statSync(file);
             if (!st.isFile())
                 continue;
             const mtime = verbose ? DateTime.fromJSDate(st.mtime).toFormat("yyyy-LL-dd HH:mm") : undefined;
-            out.push({ id: entry, mtime });
+            out.push({ id: m[1], mtime });
         }
         out.sort((a, b) => a.id.localeCompare(b.id));
         return out;
     }
     /*  purge tasks whose modification time is older than the given cutoff in
         milliseconds; returns the list of removed task ids  */
-    static purge(maxAgeMs) {
-        const dir = Task.baseDir();
+    static purge(log, maxAgeMs) {
+        if (Task.needsMigration(log))
+            Task.migrateAll(log);
+        const { basedir, files } = Task.spec(log);
+        const dir = path.join(Task.projectRoot(), basedir);
         if (!fs.existsSync(dir))
             return [];
+        const isMatch = picomatch(files, { dot: true });
         const cutoff = Date.now() - maxAgeMs;
         const removed = [];
         for (const entry of fs.readdirSync(dir)) {
-            if (!/^[A-Za-z0-9-]+$/.test(entry))
-                continue;
-            const sub = path.join(dir, entry);
-            const file = path.join(sub, "plan.md");
-            if (!fs.existsSync(file))
+            const m = /^TASK-([A-Za-z0-9-]+)\.md$/.exec(entry);
+            if (m === null || !isMatch(entry))
                 continue;
+            const file = path.join(dir, entry);
             const st = fs.statSync(file);
             if (!st.isFile())
                 continue;
             if (st.mtimeMs < cutoff) {
-                fs.rmSync(sub, { recursive: true, force: true });
-                removed.push(entry);
+                fs.rmSync(file, { force: true });
+                removed.push(m[1]);
             }
         }
         return removed;
@@ -173,7 +248,7 @@ export default class TaskCommand {
         /*  register CLI top-level command "ase task"  */
         const task = program
             .command("task")
-            .description("Manage persisted tasks under <project>/.ase/task/<id>/plan.md")
+            .description("Manage persisted tasks under <project>/<basedir>/TASK-<id>.md")
             .action(() => {
             task.outputHelp();
             process.exit(1);
@@ -182,9 +257,9 @@ export default class TaskCommand {
         task
             .command("list")
             .description("List all persisted task ids, one per line")
-            .option("-v, --verbose", "also show the plan.md modification time as (YYYY-MM-DD HH:MM)")
+            .option("-v, --verbose", "also show the task file modification time as (YYYY-MM-DD HH:MM)")
             .action((opts) => {
-            const items = Task.list(opts.verbose ?? false);
+            const items = Task.list(this.log, opts.verbose ?? false);
             for (const item of items) {
                 if (opts.verbose)
                     process.stdout.write(`${item.id}\t(${item.mtime})\n`);
@@ -199,7 +274,7 @@ export default class TaskCommand {
             .description("Load a task by id and write it to stdout")
             .argument("<id>", "Task identifier")
             .action((id) => {
-            const text = Task.load(id);
+            const text = Task.load(this.log, id);
             process.stdout.write(text);
             process.exit(0);
         });
@@ -209,7 +284,7 @@ export default class TaskCommand {
             .description("Edit a task by id with $EDITOR")
             .argument("<id>", "Task identifier")
             .action((id) => {
-            const file = Task.path(id);
+            const file = Task.path(this.log, id);
             const editor = process.env.EDITOR ?? process.env.VISUAL ?? "vi";
             fs.mkdirSync(path.dirname(file), { recursive: true });
             if (!fs.existsSync(file))
@@ -225,7 +300,7 @@ export default class TaskCommand {
             .argument("<id>", "Task identifier")
             .action(async (id) => {
             const text = await readStdin();
-            Task.save(id, text);
+            Task.save(this.log, id, text);
             this.log.write("info", `task: saved "${id}"`);
             process.exit(0);
         });
@@ -235,7 +310,7 @@ export default class TaskCommand {
             .description("Delete a task by id")
             .argument("<id>", "Task identifier")
             .action((id) => {
-            const removed = Task.delete(id);
+            const removed = Task.delete(this.log, id);
             if (removed)
                 this.log.write("info", `task: removed "${id}"`);
             else
@@ -249,7 +324,7 @@ export default class TaskCommand {
             .argument("<old>", "Old task identifier")
             .argument("<new>", "New task identifier")
             .action((oldId, newId) => {
-            const renamed = Task.rename(oldId, newId);
+            const renamed = Task.rename(this.log, oldId, newId);
             if (renamed)
                 this.log.write("info", `task: renamed "${oldId}" to "${newId}"`);
             else
@@ -276,7 +351,7 @@ export default class TaskCommand {
                 unit === "d" ? day :
                     unit === "m" ? month :
                         year;
-            const removed = Task.purge(n * factor);
+            const removed = Task.purge(this.log, n * factor);
             if (removed.length === 0)
                 this.log.write("info", "task: no tasks to purge");
             else
@@ -300,7 +375,7 @@ export class TaskMCP {
             description: "List all persisted tasks. " +
                 "Returns a `tasks` array (in lexicographic `id` order) where each item has the " +
                 "task `id`. If `verbose` is `true`, each item additionally has an `mtime` field " +
-                "(last modification time of the task's `plan.md`, formatted as `YYYY-MM-DD HH:MM`). " +
+                "(last modification time of the task's `TASK-<id>.md` file, formatted as `YYYY-MM-DD HH:MM`). " +
                 "Returns an empty array if no tasks exist.",
             inputSchema: {
                 verbose: z.boolean().optional()
@@ -310,13 +385,13 @@ export class TaskMCP {
                 tasks: z.array(z.object({
                     id: z.string().describe("task identifier"),
                     mtime: z.string().optional()
-                        .describe("plan.md modification time (`YYYY-MM-DD HH:MM`); only present if `verbose` is true")
+                        .describe("`TASK-<id>.md` modification time (`YYYY-MM-DD HH:MM`); only present if `verbose` is true")
                 })).describe("all persisted tasks in lexicographic id order")
             }
         }, async (args) => {
             try {
                 const verbose = args.verbose ?? false;
-                const items = Task.list(verbose);
+                const items = Task.list(this.log, verbose);
                 const tasks = verbose ?
                     items.map((item) => ({ id: item.id, mtime: item.mtime ?? "" })) :
                     items.map((item) => ({ id: item.id }));
@@ -345,7 +420,7 @@ export class TaskMCP {
             }
         }, async (args) => {
             try {
-                const text = Task.load(args.id);
+                const text = Task.load(this.log, args.id);
                 return {
                     content: [{ type: "text", text }]
                 };
@@ -371,7 +446,7 @@ export class TaskMCP {
             }
         }, async (args) => {
             try {
-                Task.save(args.id, args.text);
+                Task.save(this.log, args.id, args.text);
                 return {
                     content: [{ type: "text", text: `task_save: OK: saved task "${args.id}"` }]
                 };
@@ -395,7 +470,7 @@ export class TaskMCP {
             }
         }, async (args) => {
             try {
-                const removed = Task.delete(args.id);
+                const removed = Task.delete(this.log, args.id);
                 const msg = removed ?
                     `task_delete: OK: removed task "${args.id}"` :
                     `task_delete: WARNING: no task "${args.id}" to remove`;
@@ -415,7 +490,7 @@ export class TaskMCP {
         mcp.registerTool("ase_task_rename", {
             title: "ASE task rename",
             description: "Rename a previously persisted task from `old` to `new` by atomically moving the " +
-                "task home directory. Returns a status `text` indicating whether the rename succeeded. " +
+                "task `TASK-<id>.md` file. Returns a status `text` indicating whether the rename succeeded. " +
                 "Fails with an error if the target id already exists.",
             inputSchema: {
                 old: z.string()
@@ -425,7 +500,7 @@ export class TaskMCP {
             }
         }, async (args) => {
             try {
-                const renamed = Task.rename(args.old, args.new);
+                const renamed = Task.rename(this.log, args.old, args.new);
                 const msg = renamed ?
                     `task_rename: OK: renamed task "${args.old}" to "${args.new}"` :
                     `task_rename: WARNING: no task "${args.old}" to rename`;

package/dst/ase.js

@@ -14,6 +14,7 @@ import DiagramCommand from "./ase-diagram.js";
 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 pkg from "../package.json" with { type: "json" };
 /*  globally initialize logger  */
 const log = new Log("ase", "warning", "-");
@@ -49,6 +50,7 @@ const main = async () => {
     new HookCommand(log).register(program);
     new StatuslineCommand(log).register(program);
     new TaskCommand(log).register(program);
+    new ArtifactCommand(log).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.4",
+    "version":                              "0.9.6",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -37,7 +37,8 @@
         "@types/shell-quote":               "1.7.5",
         "@types/proper-lockfile":           "4.1.4",
         "@types/write-file-atomic":         "4.0.3",
-        "@types/pacote":                    "11.1.8"
+        "@types/pacote":                    "11.1.8",
+        "@types/picomatch":                 "4.0.3"
     },
     "dependencies": {
         "commander":                        "15.0.0",
@@ -60,7 +61,8 @@
         "proper-lockfile":                  "4.1.2",
         "write-file-atomic":                "8.0.0",
         "pacote":                           "21.5.0",
-        "ofetch":                           "1.5.1"
+        "ofetch":                           "1.5.1",
+        "picomatch":                        "4.0.4"
     },
     "engines": {
         "npm":                              ">=10.0.0",

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

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.9.4",
+    "version":     "0.9.6",
     "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.4",
+    "version":     "0.9.6",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

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

@@ -16,12 +16,15 @@ Artifact Meta Information
         (SAS)", "Architecture Description", or "Architecture Decision
         Record (ADR)".
 
-    -   `Software` (`SOFT`), aka "Software Implementation Results (IMP)".
+    -   `Source Code` (`CODE`), aka "Software Implementation Results (IMP)",
+        "Code", or "Software".
 
     -   `Documentation` (`DOCS`), aka "Software Documentation Results (DOC)".
 
+    -   `Tasks` (`TASK`), aka "Task Plans", "Issues", or "User Stories".
+
     Each **Artifact Set** has a unique identifier <artifact-set-id/>,
-    which is one of `SPEC`, `ARCH`, `SOFT`, or `DOCS`.
+    which is one of `SPEC`, `ARCH`, `CODE`, `DOCS`, or `TASK`.
 
 -   **Artifact**:
 

package/plugin/meta/{ase-format-plan.md → ase-format-task.md}

@@ -1,14 +1,15 @@
 
-Plan Format
------------
+Task
+----
 
-Every *task plan* uses a strict and fixed format:
+Every *task* uses a strict and fixed format:
 
 <format>
 
-# ✪ TASK PLAN: **<title/>**
+# ✪ TASK <task-id/>: <title/>
 
-◉ task id: **<task-id/>** // ✳ created: **<timestamp-created/>** // ✎ modified: **<timestamp-modified/>**
+✳ Created:  **<timestamp-created/>**
+✎ Modified: **<timestamp-modified/>**
 
 ## ※ CONTEXT
 
@@ -30,7 +31,7 @@ Every *task plan* uses a strict and fixed format:
 
 </format>
 
-You *MUST* honor the following hints on this *task plan* format:
+You *MUST* honor the following hints on this *task* format:
 
 -   You *MUST* always keep the first empty line and the last empty line.
     If one of them is missing, add it back.

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

package/plugin/skills/ase-arch-analyze/SKILL.md

@@ -299,7 +299,7 @@ interface quality, quality attributes, and architecture governance.
       specification <mermaid-spec/> for a `flowchart TB` of the
       high-level component or layer structure and dispatch the rendering
       to the `ase-meta-diagram` sub-agent by calling the tool
-      `Agent(name: "ase:ase-meta-diagram", description: "Diagram Rendering",
+      `Agent(name: "ase-meta-diagram", description: "Diagram Rendering",
       subagent_type: "ase:ase-meta-diagram", prompt: <mermaid-spec/>)`,
       using its returned fenced code block verbatim. Show layers /
       slices / major components and their dependency direction.

package/plugin/skills/ase-arch-discover/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-arch-discover
-argument-hint: "[--help|-h] <functionality>"
+argument-hint: "[--help|-h] [--limit|-l=12] <functionality>"
 description: >
     Discover additional, third-party components (libraries/frameworks) for
     the technology stack to provide needed functionality.
@@ -16,15 +16,23 @@ allowed-tools:
 
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
+@${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
+@${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
 <skill name="ase-arch-discover">
 Discover Components
 </skill>
 
+<expand name="getopt"
+    arg1="ase-arch-discover"
+    arg2="--limit|-l=12">
+    $ARGUMENTS
+</expand>
+
 <objective>
 *Discover* additional, *third-party components* (libraries/frameworks)
 for the technology stack to *provide* the *needed functionality*
-<request>$ARGUMENTS</request>.
+<request><getopt-arguments/></request>.
 </objective>
 
 <flow>
@@ -93,13 +101,13 @@ for the technology stack to *provide* the *needed functionality*
 
         -   Based on the essential keywords <keyword-L/> (L=1-M),
             use the `ase-meta-search` skill in a subagent to *generally*
-            discover an initial set of a maximum of 12 *NPM packages*
+            discover an initial set of a maximum of <getopt-option-limit/> *NPM packages*
             <component-K/> and at least their real name <name-K/> and
             their unique package names <package-K/>.
 
-        -   Use the shell command `npm search --json --searchlimit 12
+        -   Use the shell command `npm search --json --searchlimit <getopt-option-limit/>
             "<keyword-1/>" [...] "<keyword-M/>"` to *specifically*
-            discover an additional set of a maximum of 12 *NPM packages*
+            discover an additional set of a maximum of <getopt-option-limit/> *NPM packages*
             <component-K/> and at least their unique package names
             <package-K/>, based on the essential keywords <keyword-L/>
             (L=1-M). Merge the results into the already existing result
@@ -109,14 +117,14 @@ for the technology stack to *provide* the *needed functionality*
 
         -   Based on the essential keywords <keyword-L/> (L=1-M),
             use the `ase-meta-search` skill in a subagent to *generally*
-            discover an initial set of a maximum of 12 *Maven packages*
+            discover an initial set of a maximum of <getopt-option-limit/> *Maven packages*
             <component-K/> and at least their real name <name-K/> and
             their unique Maven coordinates <package-K/> of the form
             `groupId:artifactId`.
 
-        -   Use the shell command `curl -s 'https://search.maven.org/solrsearch/select?q=<keyword-1/>+<keyword-M/>&rows=12&wt=json'`
+        -   Use the shell command `curl -s 'https://search.maven.org/solrsearch/select?q=<keyword-1/>+<keyword-M/>&rows=<getopt-option-limit/>&wt=json'`
             to *specifically* discover an additional set of a maximum
-            of 12 *Maven packages* <component-K/> and at least their
+            of <getopt-option-limit/> *Maven packages* <component-K/> and at least their
             unique Maven coordinates <package-K/> (i.e. `<g/>:<a/>` from
             each result document's `g` and `a` fields), based on the
             essential keywords <keyword-L/> (L=1-M). Merge the results
@@ -139,7 +147,7 @@ for the technology stack to *provide* the *needed functionality*
 
     -   Sort, in descending order, the discovered components
         <component-K/> (K=1-N) by their `rank` field and trim the result
-        list to just a maximum of 12 total components.
+        list to just a maximum of <getopt-option-limit/> total components.
 
     -   For each component <component-K/> (K=1-N), research and then
         decide which *one* of *USP* (Unique Selling Point -- what makes

package/plugin/skills/ase-arch-discover/help.md

@@ -7,6 +7,7 @@
 
 `ase-arch-discover`
     [`--help`|`-h`]
+    [`--limit`|`-l=12`]
     *functionality*
 
 ##  DESCRIPTION
@@ -23,6 +24,13 @@ stars, dates) via the `ase_component_info` MCP tool, and reports
 the top-ranked components as a Markdown table together with a single
 distinguishing hint (USP, Crux, or Gotcha) per component.
 
+##  OPTIONS
+
+`--limit`|`-l=12`:
+    The *maximum* number of components searched per source and retained
+    in the final ranking (default: 12). Raise it for a broader, more
+    exhaustive survey, lower it for a quicker, narrower lookup.
+
 ##  ARGUMENTS
 
 *functionality*:
@@ -43,6 +51,12 @@ Discover components for HTTP client functionality:
 ❯ /ase-arch-discover HTTP client with retries
 ```
 
+Discover a broader set of up to 20 HTTP client components:
+
+```text
+❯ /ase-arch-discover --limit 20 HTTP client with retries
+```
+
 ##  SEE ALSO
 
 `ase-arch-analyze`, `ase-meta-search`, `ase-meta-evaluate`.

package/plugin/skills/ase-code-craft/SKILL.md

@@ -38,7 +38,7 @@ From scratch *craft* the following feature:
 <feature><getopt-arguments/></feature>
 </objective>
 
-@${CLAUDE_SKILL_DIR}/../../meta/ase-format-plan.md
+@${CLAUDE_SKILL_DIR}/../../meta/ase-format-task.md
 
 Procedure
 ---------
@@ -228,7 +228,7 @@ permitted way to persist artifacts is via `ase_task_save(...)`.
             TB`, `stateDiagram-v2`, `sequenceDiagram`, `classDiagram`,
             or `erDiagram`, depending on intent) and dispatching the
             rendering to the `ase-meta-diagram` sub-agent by calling
-            the tool `Agent(name: "ase:ase-meta-diagram", description:
+            the tool `Agent(name: "ase-meta-diagram", description:
             "Diagram Rendering", subagent_type: "ase:ase-meta-diagram",
             prompt: <mermaid-spec/>)`, reproducing its returned fenced
             code block verbatim. For *current vs. proposed* comparisons,

package/plugin/skills/ase-code-insight/SKILL.md

@@ -89,7 +89,7 @@ Give *insights* into the project through the source code of $ARGUMENTS.
     <mermaid-spec/> for a `flowchart TB` diagram with all modules as
     boxes and the imports between modules as the directed edges. Then
     dispatch the rendering to the `ase-meta-diagram` sub-agent by
-    calling the tool `Agent(name: "ase:ase-meta-diagram", description:
+    calling the tool `Agent(name: "ase-meta-diagram", description:
     "Diagram Rendering", subagent_type: "ase:ase-meta-diagram", prompt:
     <mermaid-spec/>)` and reproduce its returned fenced code block
     verbatim in the response text. Do not display any further