@rse/ase 0.0.46 → 0.0.49

package/dst/ase-skills.js

@@ -75,50 +75,184 @@ export class Skills {
             return "N.A.";
         }
     }
+    /*  fetch Maven Central metadata for a single coordinate `groupId:artifactId`:
+        the Solr search endpoint provides the latest version + a `timestamp` (ms
+        epoch) of that release; a second `core=gav` query yields the earliest
+        known release, which we treat as the "created" date. The latest POM is
+        then downloaded directly from the repo to extract the SCM/project URL.  */
+    static async fetchMavenInfo(coord) {
+        const [groupId, artifactId] = coord.split(":", 2);
+        if (groupId === undefined || artifactId === undefined || groupId === "" || artifactId === "")
+            return { version: "", created: "", updated: "", repository: "" };
+        try {
+            const latest = await Skills.httpLimit(() => ofetch("https://search.maven.org/solrsearch/select" +
+                `?q=g:%22${encodeURIComponent(groupId)}%22+AND+a:%22${encodeURIComponent(artifactId)}%22` +
+                "&rows=1&wt=json", { timeout: Skills.HTTP_TIMEOUT_MS, ignoreResponseError: true }));
+            const doc = latest?.response?.docs?.[0];
+            const version = doc?.latestVersion ?? doc?.v ?? "";
+            const updated = typeof doc?.timestamp === "number" ? new Date(doc.timestamp).toISOString() : "";
+            /*  Maven Central caps `rows` at 20 and ignores client `sort`,
+                so paginate via `start=` to walk all versions, accumulate the
+                minimum timestamp client-side  */
+            const baseUrl = "https://search.maven.org/solrsearch/select" +
+                `?q=g:%22${encodeURIComponent(groupId)}%22+AND+a:%22${encodeURIComponent(artifactId)}%22` +
+                "&core=gav&rows=20&wt=json";
+            let firstTs;
+            let start = 0;
+            for (let page = 0; page < 50; page++) {
+                const chunk = await Skills.httpLimit(() => ofetch(`${baseUrl}&start=${start}`, { timeout: Skills.HTTP_TIMEOUT_MS, ignoreResponseError: true }));
+                const docs = chunk?.response?.docs ?? [];
+                for (const d of docs) {
+                    if (typeof d.timestamp === "number" && (firstTs === undefined || d.timestamp < firstTs))
+                        firstTs = d.timestamp;
+                }
+                start += docs.length;
+                const total = chunk?.response?.numFound ?? 0;
+                if (docs.length === 0 || start >= total)
+                    break;
+            }
+            const created = typeof firstTs === "number" ? new Date(firstTs).toISOString() : updated;
+            let repository = "";
+            if (version !== "") {
+                try {
+                    const pom = await Skills.httpLimit(() => ofetch(`https://repo1.maven.org/maven2/${groupId.replace(/\./g, "/")}` +
+                        `/${artifactId}/${version}/${artifactId}-${version}.pom`, { timeout: Skills.HTTP_TIMEOUT_MS, ignoreResponseError: true, responseType: "text" }));
+                    if (typeof pom === "string") {
+                        const scm = /<scm>[\s\S]*?<url>\s*([^<\s]+)\s*<\/url>[\s\S]*?<\/scm>/i.exec(pom);
+                        if (scm !== null)
+                            repository = scm[1];
+                        else {
+                            const url = /<project\b[\s\S]*?<url>\s*([^<\s]+)\s*<\/url>/i.exec(pom);
+                            if (url !== null)
+                                repository = url[1];
+                        }
+                    }
+                }
+                catch {
+                    repository = "";
+                }
+            }
+            return { version, created, updated, repository };
+        }
+        catch {
+            return { version: "", created: "", updated: "", repository: "" };
+        }
+    }
+    /*  fetch the "Used By" count from `mvnrepository.com` as a downloads proxy
+        for a Maven coordinate (Maven Central exposes no per-artifact download
+        counts). The label `Used By (NNK)` on the artifact landing page denotes
+        the number of other published artifacts depending on it. Note: the site
+        is fronted by *Cloudflare* and frequently serves a JS-challenge to
+        non-browser clients regardless of `User-Agent` (the block is driven by
+        TLS/HTTP2 fingerprinting, not headers). A realistic browser UA is
+        best-effort and degrades gracefully to `"N.A."` when blocked.  */
+    static async fetchMavenDownloads(coord) {
+        const [groupId, artifactId] = coord.split(":", 2);
+        if (groupId === undefined || artifactId === undefined || groupId === "" || artifactId === "")
+            return "N.A.";
+        try {
+            const html = await Skills.httpLimit(() => ofetch(`https://mvnrepository.com/artifact/${encodeURIComponent(groupId)}/${encodeURIComponent(artifactId)}`, {
+                timeout: Skills.HTTP_TIMEOUT_MS,
+                ignoreResponseError: true,
+                responseType: "text",
+                headers: {
+                    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) " +
+                        "AppleWebKit/537.36 (KHTML, like Gecko) " +
+                        "Chrome/131.0.0.0 Safari/537.36"
+                }
+            }));
+            if (typeof html !== "string")
+                return "N.A.";
+            const m = /Used\s+By\s*\(\s*([\d.,]+)\s*([KMB]?)\s*\)/i.exec(html);
+            if (m === null)
+                return "N.A.";
+            const base = parseFloat(m[1].replace(/,/g, ""));
+            const mult = m[2] === "K" ? 1_000 : m[2] === "M" ? 1_000_000 : m[2] === "B" ? 1_000_000_000 : 1;
+            const n = Math.round(base * mult);
+            return Number.isFinite(n) ? n : "N.A.";
+        }
+        catch {
+            return "N.A.";
+        }
+    }
     /*  gather metadata for all given components with maximum parallelism,
         dispatching on the technology stack:
         -   "JavaScript"/"TypeScript": NPM registry (pacote) + GitHub stars + npm-downloads
-        -   "Java"/"Kotlin"/"Unknown": not yet supported -- return empty result  */
+        -   "Java"/"Kotlin":           Maven Central + GitHub stars + mvnrepository.com "Used By"
+        -   "Unknown":                 not supported -- return empty result  */
     static async info(stack, components) {
-        /*  FIXME: currently just limited technology stack support  */
-        if (stack !== "JavaScript" && stack !== "TypeScript")
+        if (stack === "JavaScript" || stack === "TypeScript") {
+            /*  per package: kick off packument and downloads in parallel,
+                then stars as soon as the packument resolves; across packages
+                everything runs concurrently via Promise.all  */
+            const results = await Promise.all(components.map(async (name) => {
+                const packumentPromise = Skills.fetchPackument(name);
+                const downloadsPromise = Skills.fetchDownloads(name);
+                const starsPromise = packumentPromise.then((p) => Skills.fetchStars(p.repository));
+                const [p, downloads, stars] = await Promise.all([
+                    packumentPromise, downloadsPromise, starsPromise
+                ]);
+                const created = p.time.created ?? "";
+                const updated = p.version !== "" ? (p.time[p.version] ?? "") : "";
+                const rank = Skills.computeRank(downloads, stars, created, updated);
+                return {
+                    name,
+                    version: p.version,
+                    created,
+                    updated,
+                    repository: p.repository,
+                    stars,
+                    downloads,
+                    rank
+                };
+            }));
+            /*  sort by rank in descending order (best first)  */
+            results.sort((a, b) => b.rank - a.rank);
+            return results;
+        }
+        else if (stack === "Java" || stack === "Kotlin") {
+            /*  per coordinate: kick off Maven Central info and mvnrepository
+                downloads in parallel, then stars as soon as the POM-derived
+                repository is known; across coordinates everything runs
+                concurrently via Promise.all  */
+            const results = await Promise.all(components.map(async (name) => {
+                const infoPromise = Skills.fetchMavenInfo(name);
+                const downloadsPromise = Skills.fetchMavenDownloads(name);
+                const starsPromise = infoPromise.then((i) => Skills.fetchStars(i.repository));
+                const [i, downloads, stars] = await Promise.all([
+                    infoPromise, downloadsPromise, starsPromise
+                ]);
+                const rank = Skills.computeRank(downloads, stars, i.created, i.updated);
+                return {
+                    name,
+                    version: i.version,
+                    created: i.created,
+                    updated: i.updated,
+                    repository: i.repository,
+                    stars,
+                    downloads,
+                    rank
+                };
+            }));
+            /*  sort by rank in descending order (best first)  */
+            results.sort((a, b) => b.rank - a.rank);
+            return results;
+        }
+        else
             return [];
-        /*  per package: kick off packument and downloads in parallel,
-            then stars as soon as the packument resolves; across packages
-            everything runs concurrently via Promise.all  */
-        const results = await Promise.all(components.map(async (name) => {
-            const packumentPromise = Skills.fetchPackument(name);
-            const downloadsPromise = Skills.fetchDownloads(name);
-            const starsPromise = packumentPromise.then((p) => Skills.fetchStars(p.repository));
-            const [p, downloads, stars] = await Promise.all([
-                packumentPromise, downloadsPromise, starsPromise
-            ]);
-            const created = p.time.created ?? "";
-            const updated = p.version !== "" ? (p.time[p.version] ?? "") : "";
-            const rank = Skills.computeRank(downloads, stars, created, updated);
-            return {
-                name,
-                version: p.version,
-                created,
-                updated,
-                repository: p.repository,
-                stars,
-                downloads,
-                rank
-            };
-        }));
-        /*  sort by rank in descending order (best first)  */
-        results.sort((a, b) => b.rank - a.rank);
-        return results;
     }
     /*  compute composite rank score from weighted metrics:
         downloads x
         stars x
         ([lifespan =] (updated - created)) x
-        ([recentness =] exp(-(now - updated) / halfLife))  */
+        ([recentness =] exp(-(now - updated) / halfLife))
+        `"N.A."` factors are treated as neutral `1` so that stacks for which
+        a particular metric is structurally unavailable (e.g. Maven Central
+        exposes no per-artifact download counts) can still be ranked by the
+        remaining metrics, instead of collapsing the entire product to zero.  */
     static computeRank(downloads, stars, created, updated) {
-        const d = typeof downloads === "number" ? downloads : 0;
-        const s = typeof stars === "number" ? stars : 0;
+        const d = typeof downloads === "number" ? downloads : 1;
+        const s = typeof stars === "number" ? stars : 1;
         const cMs = created !== "" ? Date.parse(created) : NaN;
         const uMs = updated !== "" ? Date.parse(updated) : NaN;
         if (Number.isNaN(cMs) || Number.isNaN(uMs))
@@ -160,20 +294,26 @@ export class SkillsMCP {
     register(mcp) {
         mcp.registerTool("component_info", {
             title: "ASE component info",
-            description: "Gather metadata for a list of NPM packages with maximum parallelism. " +
-                "For each package, fetches the full registry packument via `pacote` " +
-                "(in-process, no `npm view` subprocess), the GitHub `stargazers_count` " +
+            description: "Gather metadata for a list of packages with maximum parallelism, " +
+                "dispatching on the technology `stack`. For `JavaScript`/`TypeScript`, " +
+                "components are NPM package names: fetches the full registry packument via " +
+                "`pacote` (in-process, no `npm view` subprocess), the GitHub `stargazers_count` " +
                 "from `api.github.com` (if the repository points to GitHub), and the " +
-                "last-month downloads from `api.npmjs.org`. Returns a JSON `text` array " +
-                "of `{ name, version, created, updated, repository, stars, downloads, rank }` " +
-                "objects, sorted in descending order by `rank`. Failures of " +
-                "individual side calls are isolated and reported as `\"N.A.\"` or empty " +
-                "string so every entry has the full shape.",
+                "last-month downloads from `api.npmjs.org`. For `Java`/`Kotlin`, components " +
+                "are Maven coordinates of the form `groupId:artifactId`: fetches the latest " +
+                "version + earliest/latest release timestamps from the Maven Central Solr " +
+                "search endpoint, the SCM/project URL from the latest POM at `repo1.maven.org`, " +
+                "GitHub stars (if applicable), and the \"Used By\" count from `mvnrepository.com` " +
+                "as the `downloads` proxy. Returns a JSON `text` array of " +
+                "`{ name, version, created, updated, repository, stars, downloads, rank }` " +
+                "objects, sorted in descending order by `rank`. Failures of individual side " +
+                "calls are isolated and reported as `\"N.A.\"` or empty string so every entry " +
+                "has the full shape.",
             inputSchema: {
                 stack: z.string()
                     .describe("Technology stack: \"JavaScript\", \"TypeScript\", \"Java\", \"Kotlin\", or \"Unknown\""),
                 components: z.array(z.string())
-                    .describe("List of package names to gather metadata for")
+                    .describe("List of package names (NPM) or Maven coordinates `groupId:artifactId` (Java/Kotlin)")
             }
         }, async (args) => {
             try {

package/dst/ase-statusline.js

@@ -175,7 +175,7 @@ export default class StatuslineCommand {
     /*  parse and validate the --tool option  */
     parseTool(value) {
         if (value !== "claude" && value !== "copilot")
-            throw new Error(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
+            throw new InvalidArgumentError(`invalid --tool value: "${value}" (expected "claude" or "copilot")`);
         return value;
     }
     /*  register commands  */
@@ -357,7 +357,7 @@ export default class StatuslineCommand {
                 S: () => {
                     const pct5h = data.rate_limits?.five_hour?.used_percentage;
                     if (pct5h !== undefined)
-                        emit(`${prefix("⏲", "session")}${c.bold(`${pct5h.toFixed(1)}%`)}`);
+                        emit(`${prefix("⏲", "session-usage")}${c.bold(`${pct5h.toFixed(1)}%`)}`);
                 },
                 D: () => {
                     const until5h = data.rate_limits?.five_hour?.resets_at ?? "";
@@ -368,7 +368,7 @@ export default class StatuslineCommand {
                 W: () => {
                     const pctWk = data.rate_limits?.seven_day?.used_percentage;
                     if (pctWk !== undefined)
-                        emit(`${prefix("⏲", "weekly")}${c.bold(`${pctWk.toFixed(1)}%`)}`);
+                        emit(`${prefix("⏲", "weekly-usage")}${c.bold(`${pctWk.toFixed(1)}%`)}`);
                 },
                 Q: () => {
                     const untilWk = data.rate_limits?.seven_day?.resets_at ?? "";
@@ -390,11 +390,11 @@ export default class StatuslineCommand {
                 /*  ==== VERSION CONTROL ====  */
                 a: () => {
                     const linesAdded = data.cost?.total_lines_added ?? 0;
-                    emit(`${prefix("⊕", "added")}${c.bold(linesAdded)}`);
+                    emit(`${prefix("⊕", "added")}${c.bold(String(linesAdded))}`);
                 },
                 r: () => {
                     const linesRemoved = data.cost?.total_lines_removed ?? 0;
-                    emit(`${prefix("⊖", "removed")}${c.bold(linesRemoved)}`);
+                    emit(`${prefix("⊖", "removed")}${c.bold(String(linesRemoved))}`);
                 },
                 b: () => {
                     const g = getGit();
@@ -435,6 +435,15 @@ export default class StatuslineCommand {
                 }
             };
             /*  walk each template line and render  */
+            const closeSpan = () => {
+                if (span !== null) {
+                    const wrapped = span.color === "default" ?
+                        span.buf :
+                        (c[span.color])(span.buf);
+                    span = null;
+                    appendOutput(wrapped);
+                }
+            };
             for (const line of tmpl) {
                 let i = 0;
                 while (i < line.length) {
@@ -443,15 +452,8 @@ export default class StatuslineCommand {
                     if (ch === "<") {
                         const m = line.slice(i).match(/^<(\/?)([a-z]+)>/);
                         if (m !== null && COLORS.has(m[2])) {
-                            if (m[1] === "/") {
-                                if (span !== null) {
-                                    const wrapped = span.color === "default" ?
-                                        span.buf :
-                                        (c[span.color])(span.buf);
-                                    span = null;
-                                    appendOutput(wrapped);
-                                }
-                            }
+                            if (m[1] === "/")
+                                closeSpan();
                             else if (span === null)
                                 span = { color: m[2], buf: "" };
                             i += m[0].length;
@@ -468,13 +470,7 @@ export default class StatuslineCommand {
                     }
                 }
                 /*  flush any unterminated span at end of line  */
-                if (span !== null) {
-                    const wrapped = span.color === "default" ?
-                        span.buf :
-                        (c[span.color])(span.buf);
-                    span = null;
-                    appendOutput(wrapped);
-                }
+                closeSpan();
                 out += "\n";
                 col = 0;
             }

package/dst/ase-task.js

@@ -69,6 +69,21 @@ export class Task {
         fs.rmSync(path.dirname(file), { recursive: true, 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))
+            return false;
+        if (fs.existsSync(newDir))
+            throw new Error(`task: target id "${newId}" already exists`);
+        fs.mkdirSync(path.dirname(newDir), { recursive: true });
+        fs.renameSync(oldDir, newDir);
+        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  */
@@ -227,6 +242,20 @@ export default class TaskCommand {
                 this.log.write("info", `task: no task "${id}" to remove`);
             process.exit(removed ? 0 : 1);
         });
+        /*  register CLI sub-command "ase task rename"  */
+        task
+            .command("rename")
+            .description("Rename a task from <old> to <new>")
+            .argument("<old>", "Old task identifier")
+            .argument("<new>", "New task identifier")
+            .action((oldId, newId) => {
+            const renamed = Task.rename(oldId, newId);
+            if (renamed)
+                this.log.write("info", `task: renamed "${oldId}" to "${newId}"`);
+            else
+                this.log.write("info", `task: no task "${oldId}" to rename`);
+            process.exit(renamed ? 0 : 1);
+        });
         /*  register CLI sub-command "ase task purge"  */
         task
             .command("purge")
@@ -289,7 +318,7 @@ export class TaskMCP {
                 const verbose = args.verbose ?? false;
                 const items = Task.list(verbose);
                 const tasks = verbose ?
-                    items.map((item) => ({ id: item.id, mtime: item.mtime })) :
+                    items.map((item) => ({ id: item.id, mtime: item.mtime ?? "" })) :
                     items.map((item) => ({ id: item.id }));
                 const result = { tasks };
                 return {
@@ -381,6 +410,36 @@ export class TaskMCP {
                 };
             }
         });
+        /*  task rename  */
+        mcp.registerTool("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. " +
+                "Fails with an error if the target id already exists.",
+            inputSchema: {
+                old: z.string()
+                    .describe("old task identifier (allowed characters: A-Z, a-z, 0-9, '-')"),
+                new: z.string()
+                    .describe("new task identifier (allowed characters: A-Z, a-z, 0-9, '-')")
+            }
+        }, async (args) => {
+            try {
+                const renamed = Task.rename(args.old, args.new);
+                const msg = renamed ?
+                    `task_rename: OK: renamed task "${args.old}" to "${args.new}"` :
+                    "WARNING: task not found";
+                return {
+                    content: [{ type: "text", text: msg }]
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `ERROR: ${message}` }]
+                };
+            }
+        });
         /*  task id get/set  */
         mcp.registerTool("task_id", {
             title: "ASE task id get/set",

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

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

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