@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/lobsters/read-domain.js

@@ -0,0 +1,306 @@
+/**
+ * @owner   src/adapters/lobsters/read-domain.ts
+ * @does    Register agent-facing Lobsters read and domain commands.
+ * @needs   Public lobste.rs JSON endpoints, strict ids/domains, bounded comment tree rendering.
+ * @feeds   surface coverage ledger, Lobsters story readers, source-domain research workflows.
+ * @breaks  Lobsters JSON shape drift, weak tree bounds, or lossy HTML conversion degrades reads.
+ */
+import { cli, Strategy } from "../../registry.js";
+const LOBSTERS_BASE = "https://lobste.rs";
+const DOMAIN_PATTERN = /^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?(\.[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?)+$/i;
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function numberOrNull(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function numberOrBlank(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : "";
+}
+export function requireLobstersShortId(value) {
+    const id = String(value ?? "").trim();
+    if (!/^[a-z0-9]+$/.test(id)) {
+        throw new Error(`Invalid Lobsters short_id: ${String(value)}.`);
+    }
+    return id;
+}
+export function requireLobstersDomain(value) {
+    const domain = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    if (!domain)
+        throw new Error("lobsters domain is required.");
+    if (!DOMAIN_PATTERN.test(domain)) {
+        throw new Error(`lobsters domain "${String(value)}" is not a valid hostname.`);
+    }
+    return domain;
+}
+export function requireLobstersLimit(value, fallback, max, label) {
+    const raw = value === undefined || value === null || value === "" ? fallback : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit <= 0) {
+        throw new Error(`lobsters ${label} must be a positive integer.`);
+    }
+    if (max !== null && limit > max) {
+        throw new Error(`lobsters ${label} must be <= ${max}.`);
+    }
+    return limit;
+}
+export function requireLobstersMinInt(value, fallback, min, label) {
+    const raw = value === undefined || value === null || value === "" ? fallback : value;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < min) {
+        throw new Error(`lobsters ${label} must be an integer >= ${min}.`);
+    }
+    return n;
+}
+export function lobstersHtmlToText(value) {
+    return String(value ?? "")
+        .replace(/<p>/gi, "\n\n")
+        .replace(/<\/p>/gi, "")
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<i>(.*?)<\/i>/gi, "$1")
+        .replace(/<em>(.*?)<\/em>/gi, "$1")
+        .replace(/<strong>(.*?)<\/strong>/gi, "$1")
+        .replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi, "$2 ($1)")
+        .replace(/<pre><code>([\s\S]*?)<\/code><\/pre>/gi, "\n$1\n")
+        .replace(/<code>(.*?)<\/code>/gi, "`$1`")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&#x27;/g, "'")
+        .replace(/&apos;/g, "'")
+        .replace(/&quot;/g, '"')
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&#x2F;/g, "/")
+        .trim();
+}
+function truncate(text, maxLength, suffix) {
+    return text.length > maxLength
+        ? `${text.slice(0, maxLength)}${suffix}`
+        : text;
+}
+function indentLines(text, depth) {
+    if (depth <= 0)
+        return text;
+    const prefix = `${"  ".repeat(depth)}> `;
+    return text
+        .split("\n")
+        .map((line) => `${prefix}${line}`)
+        .join("\n");
+}
+function commentShortId(comment) {
+    return stringField(comment.short_id);
+}
+function commentParentId(comment) {
+    return stringField(comment.parent_comment);
+}
+function commentBody(comment) {
+    return (stringField(comment.comment_plain) || lobstersHtmlToText(comment.comment));
+}
+function storyBody(story) {
+    return (stringField(story.description_plain) ||
+        lobstersHtmlToText(story.description));
+}
+function visibleComments(story) {
+    return Array.isArray(story.comments)
+        ? story.comments.filter((comment) => {
+            return typeof comment === "object" && comment !== null;
+        })
+        : [];
+}
+export function buildLobstersReadRows(story, options) {
+    if (!story || !story.short_id)
+        throw new Error("Lobsters story not found.");
+    const rows = [];
+    const body = truncate(storyBody(story).trim(), options.maxLength, "\n... [truncated]");
+    const storyParts = [stringField(story.title)];
+    if (body)
+        storyParts.push(`\n${body}`);
+    if (story.url)
+        storyParts.push(`\n${stringField(story.url)}`);
+    rows.push({
+        type: "POST",
+        author: stringField(story.submitter_user) || "[deleted]",
+        score: numberOrNull(story.score) ?? 0,
+        text: storyParts.join("").trim(),
+    });
+    const children = new Map();
+    for (const comment of visibleComments(story)) {
+        const parent = commentParentId(comment);
+        const bucket = children.get(parent) ?? [];
+        bucket.push(comment);
+        children.set(parent, bucket);
+    }
+    function emit(comment, depth) {
+        if (comment.is_deleted || comment.is_moderated)
+            return;
+        const id = commentShortId(comment);
+        rows.push({
+            type: depth === 0 ? "L0" : `L${depth}`,
+            author: stringField(comment.commenting_user) || "[deleted]",
+            score: numberOrBlank(comment.score),
+            text: indentLines(truncate(commentBody(comment).trim(), options.maxLength, "..."), depth),
+        });
+        const kids = id ? (children.get(id) ?? []) : [];
+        if (depth + 1 >= options.maxDepth) {
+            if (kids.length > 0) {
+                rows.push({
+                    type: `L${depth + 1}`,
+                    author: "",
+                    score: "",
+                    text: `${"  ".repeat(depth + 1)}[+${kids.length} more replies]`,
+                });
+            }
+            return;
+        }
+        const visible = kids.slice(0, options.maxReplies);
+        for (const kid of visible)
+            emit(kid, depth + 1);
+        const hidden = kids.length - visible.length;
+        if (hidden > 0) {
+            rows.push({
+                type: `L${depth + 1}`,
+                author: "",
+                score: "",
+                text: `${"  ".repeat(depth + 1)}[+${hidden} more replies]`,
+            });
+        }
+    }
+    const topLevel = children.get("") ?? [];
+    const visibleTop = topLevel.slice(0, options.limit);
+    for (const comment of visibleTop)
+        emit(comment, 0);
+    const hiddenTop = topLevel.length - visibleTop.length;
+    if (hiddenTop > 0) {
+        rows.push({
+            type: "",
+            author: "",
+            score: "",
+            text: `[+${hiddenTop} more top-level comments]`,
+        });
+    }
+    return rows;
+}
+export function mapLobstersDomainRows(stories) {
+    return stories.map((item, index) => ({
+        rank: index + 1,
+        id: stringField(item.short_id),
+        title: stringField(item.title),
+        score: numberOrNull(item.score),
+        author: stringField(item.submitter_user),
+        comments: numberOrNull(item.comment_count),
+        created_at: stringField(item.created_at).slice(0, 10),
+        tags: Array.isArray(item.tags) ? item.tags.map(String).join(", ") : "",
+        submission_url: stringField(item.url),
+        comments_url: stringField(item.comments_url),
+    }));
+}
+async function fetchLobstersJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": "unicli-lobsters/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} not found.`);
+    if (!response.ok)
+        throw new Error(`Lobsters returned HTTP ${response.status} for ${label}.`);
+    return (await response.json());
+}
+cli({
+    site: "lobsters",
+    name: "read",
+    description: "Read a Lobste.rs story and its comment tree",
+    domain: "lobste.rs",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Lobste.rs short_id",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 25,
+            description: "Max top-level comments",
+        },
+        { name: "depth", type: "int", default: 2, description: "Max reply depth" },
+        {
+            name: "replies",
+            type: "int",
+            default: 5,
+            description: "Max replies per comment",
+        },
+        {
+            name: "max-length",
+            type: "int",
+            default: 2000,
+            description: "Max characters per comment body",
+        },
+    ],
+    columns: ["type", "author", "score", "text"],
+    func: async (_page, kwargs) => {
+        const id = requireLobstersShortId(kwargs.id);
+        const story = await fetchLobstersJson(`${LOBSTERS_BASE}/s/${id}.json`, `lobsters/${id}`);
+        return buildLobstersReadRows(story, {
+            limit: requireLobstersLimit(kwargs.limit, 25, null, "read limit"),
+            maxDepth: requireLobstersLimit(kwargs.depth, 2, null, "read depth"),
+            maxReplies: requireLobstersLimit(kwargs.replies, 5, null, "read replies"),
+            maxLength: requireLobstersMinInt(kwargs["max-length"] ?? kwargs.maxLength, 2000, 100, "read max-length"),
+        });
+    },
+});
+cli({
+    site: "lobsters",
+    name: "domain",
+    description: "Lobste.rs stories submitted from a specific domain",
+    domain: "lobste.rs",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: "domain",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Source domain",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of stories",
+        },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "title",
+        "score",
+        "author",
+        "comments",
+        "created_at",
+        "tags",
+        "submission_url",
+        "comments_url",
+    ],
+    func: async (_page, kwargs) => {
+        const domain = requireLobstersDomain(kwargs.domain);
+        const limit = requireLobstersLimit(kwargs.limit, 20, 25, "domain limit");
+        const stories = await fetchLobstersJson(`${LOBSTERS_BASE}/domains/${encodeURIComponent(domain)}.json`, `lobsters domain ${domain}`);
+        if (!Array.isArray(stories) || stories.length === 0) {
+            throw new Error(`No Lobste.rs stories found for domain "${domain}".`);
+        }
+        return mapLobstersDomainRows(stories
+            .filter((story) => typeof story === "object" && story !== null)
+            .slice(0, limit));
+    },
+});
+//# sourceMappingURL=read-domain.js.map

package/dist/adapters/lobsters/read-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-domain.js","sourceRoot":"","sources":["../../../src/adapters/lobsters/read-domain.ts"],"names":[],"mappings":"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"}

package/dist/adapters/mangadex/web.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @owner   src/adapters/mangadex/web.ts
+ * @does    Register MangaDex public manga and author search commands.
+ * @needs   MangaDex public API and relationship include semantics.
+ * @feeds   Manga/doujin-adjacent title and creator discovery.
+ * @breaks  MangaDex API schema or public rate limits can block lookup.
+ */
+export declare function mapMangaDexManga(rows: unknown[]): Record<string, unknown>[];
+export declare function mapMangaDexAuthors(rows: unknown[]): Record<string, unknown>[];
+//# sourceMappingURL=web.d.ts.map

package/dist/adapters/mangadex/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/mangadex/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8FH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAiB3E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAe7E"}

package/dist/adapters/mangadex/web.js

@@ -0,0 +1,188 @@
+/**
+ * @owner   src/adapters/mangadex/web.ts
+ * @does    Register MangaDex public manga and author search commands.
+ * @needs   MangaDex public API and relationship include semantics.
+ * @feeds   Manga/doujin-adjacent title and creator discovery.
+ * @breaks  MangaDex API schema or public rate limits can block lookup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const API = "https://api.mangadex.org";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function required(value, label) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error(`mangadex ${label} cannot be empty.`);
+    return text;
+}
+function requireLimit(value) {
+    if (value === undefined || value === null || value === "")
+        return 10;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 50) {
+        throw new Error("mangadex limit must be an integer in [1, 50].");
+    }
+    return n;
+}
+function optionalYear(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1900 || n > 2100) {
+        throw new Error("mangadex year must be an integer in [1900, 2100].");
+    }
+    return n;
+}
+const SORT_PARAMS = {
+    relevance: undefined,
+    latest: ["order[latestUploadedChapter]", "desc"],
+    followed: ["order[followedCount]", "desc"],
+    year: ["order[year]", "desc"],
+};
+function applySort(url, value) {
+    const key = String(value ?? "relevance").trim();
+    const spec = SORT_PARAMS[key];
+    if (!(key in SORT_PARAMS)) {
+        throw new Error(`mangadex sort must be one of: ${Object.keys(SORT_PARAMS).join(", ")}.`);
+    }
+    if (spec)
+        url.searchParams.set(spec[0], spec[1]);
+}
+const CONTENT_RATINGS = new Set([
+    "safe",
+    "suggestive",
+    "erotica",
+    "pornographic",
+    "all",
+]);
+function applyContentRating(url, value) {
+    if (value === undefined || value === null || value === "")
+        return;
+    const rating = String(value).trim();
+    if (!CONTENT_RATINGS.has(rating)) {
+        throw new Error(`mangadex content_rating must be one of: ${Array.from(CONTENT_RATINGS).join(", ")}.`);
+    }
+    if (rating !== "all")
+        url.searchParams.append("contentRating[]", rating);
+}
+async function getJson(url) {
+    const response = await fetch(url, {
+        headers: { Accept: "application/json", "User-Agent": USER_AGENT },
+    });
+    if (!response.ok)
+        throw new Error(`mangadex request failed with HTTP ${response.status}.`);
+    const data = (await response.json());
+    if (data.result && data.result !== "ok")
+        throw new Error(`mangadex API returned ${data.result}.`);
+    return data.data ?? [];
+}
+function localized(values) {
+    const obj = values && typeof values === "object"
+        ? values
+        : {};
+    return str(obj.en || obj.ja || obj["ja-ro"] || obj.zh || Object.values(obj)[0]);
+}
+export function mapMangaDexManga(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const attrs = item.attributes ?? {};
+        return {
+            rank: index + 1,
+            id: item.id,
+            title: localized(attrs.title),
+            status: str(attrs.status),
+            year: attrs.year ?? null,
+            content_rating: str(attrs.contentRating),
+            latest_uploaded_chapter: str(attrs.latestUploadedChapter),
+            description: localized(attrs.description).slice(0, 700),
+            url: `https://mangadex.org/title/${item.id}`,
+        };
+    });
+}
+export function mapMangaDexAuthors(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const attrs = item.attributes ?? {};
+        return {
+            rank: index + 1,
+            id: item.id,
+            name: str(attrs.name),
+            twitter: str(attrs.twitter),
+            pixiv: str(attrs.pixiv),
+            website: str(attrs.website),
+            url: `https://mangadex.org/author/${item.id}`,
+        };
+    });
+}
+async function searchManga(kwargs) {
+    const query = required(kwargs.query, "query");
+    const url = new URL(`${API}/manga`);
+    url.searchParams.set("title", query);
+    url.searchParams.set("limit", String(requireLimit(kwargs.limit)));
+    const year = optionalYear(kwargs.year);
+    if (year)
+        url.searchParams.set("year", String(year));
+    applySort(url, kwargs.sort);
+    applyContentRating(url, kwargs["content-rating"]);
+    url.searchParams.append("includes[]", "author");
+    url.searchParams.append("includes[]", "artist");
+    const rows = mapMangaDexManga(await getJson(url));
+    if (rows.length === 0)
+        throw new Error(`No MangaDex manga found for "${query}".`);
+    return rows;
+}
+async function searchAuthors(kwargs) {
+    const query = required(kwargs.query, "query");
+    const url = new URL(`${API}/author`);
+    url.searchParams.set("name", query);
+    url.searchParams.set("limit", String(requireLimit(kwargs.limit)));
+    const rows = mapMangaDexAuthors(await getJson(url));
+    if (rows.length === 0)
+        throw new Error(`No MangaDex authors found for "${query}".`);
+    return rows;
+}
+const SEARCH_ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+];
+const MANGA_ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+    { name: "year", type: "int" },
+    {
+        name: "sort",
+        type: "str",
+        default: "relevance",
+        choices: ["relevance", "latest", "followed", "year"],
+    },
+    {
+        name: "content-rating",
+        type: "str",
+        choices: ["safe", "suggestive", "erotica", "pornographic", "all"],
+    },
+];
+cli({
+    site: "mangadex",
+    name: "manga",
+    description: "Search MangaDex manga by Japanese title, romaji, alias, or keyword",
+    domain: "mangadex.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: MANGA_ARGS,
+    columns: ["rank", "id", "title", "status", "year", "content_rating", "url"],
+    func: async (_page, kwargs) => searchManga(kwargs),
+});
+cli({
+    site: "mangadex",
+    name: "authors",
+    description: "Search MangaDex authors and artists by public name or romaji",
+    domain: "mangadex.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: SEARCH_ARGS,
+    columns: ["rank", "id", "name", "twitter", "pixiv", "website", "url"],
+    func: async (_page, kwargs) => searchAuthors(kwargs),
+});
+//# sourceMappingURL=web.js.map

package/dist/adapters/mangadex/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/adapters/mangadex/web.ts"],"names":[],"mappings":"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"}

package/dist/adapters/maven/artifact.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @owner   src/adapters/maven/artifact.ts
+ * @does    Register agent-facing Maven Central artifact version history command.
+ * @needs   search.maven.org Solr gav core and coordinate validation.
+ * @feeds   surface coverage ledger, JVM dependency inspection, registry command surface.
+ * @breaks  Maven coordinate parsing or Solr envelope drift hides dependency versions.
+ */
+interface MavenDoc {
+    g?: unknown;
+    a?: unknown;
+    v?: unknown;
+    p?: unknown;
+    timestamp?: unknown;
+    tags?: unknown;
+}
+interface MavenBody {
+    response?: {
+        docs?: MavenDoc[];
+    };
+}
+export interface MavenCoordinate {
+    groupId: string;
+    artifactId: string;
+    version: string;
+}
+export declare function requireMavenLimit(value: unknown, fallback: number): number;
+export declare function parseMavenCoordinate(value: unknown): MavenCoordinate;
+export declare function mapMavenArtifactRows(body: MavenBody, coordinate: MavenCoordinate): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=artifact.d.ts.map

package/dist/adapters/maven/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../src/adapters/maven/artifact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,QAAQ;IAChB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS1E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAapE;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,eAAe,GAC1B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwBhC"}