@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/rubygems/gem.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @owner   src/adapters/rubygems/gem.ts
+ * @does    Register agent-facing RubyGems single-gem metadata command.
+ * @needs   rubygems.org public gem JSON API.
+ * @feeds   surface coverage ledger, Ruby dependency inspection, registry command surface.
+ * @breaks  RubyGems envelope drift or weak gem-name validation hides gem metadata.
+ */
+interface RubyGemBody {
+    name?: unknown;
+    version?: unknown;
+    version_created_at?: unknown;
+    downloads?: unknown;
+    version_downloads?: unknown;
+    licenses?: unknown;
+    authors?: unknown;
+    homepage_uri?: unknown;
+    source_code_uri?: unknown;
+    bug_tracker_uri?: unknown;
+    metadata?: Record<string, unknown>;
+    info?: unknown;
+    project_uri?: unknown;
+}
+export declare function requireGemName(value: unknown): string;
+export declare function mapRubyGemRow(body: RubyGemBody, requested: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=gem.d.ts.map

package/dist/adapters/rubygems/gem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gem.d.ts","sourceRoot":"","sources":["../../../src/adapters/rubygems/gem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAUD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMrD;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB"}

package/dist/adapters/rubygems/gem.js

@@ -0,0 +1,96 @@
+/**
+ * @owner   src/adapters/rubygems/gem.ts
+ * @does    Register agent-facing RubyGems single-gem metadata command.
+ * @needs   rubygems.org public gem JSON API.
+ * @feeds   surface coverage ledger, Ruby dependency inspection, registry command surface.
+ * @breaks  RubyGems envelope drift or weak gem-name validation hides gem metadata.
+ */
+import { cli, Strategy } from "../../registry.js";
+const GEMS_BASE = "https://rubygems.org/api/v1";
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+export function requireGemName(value) {
+    const name = String(value ?? "").trim();
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name)) {
+        throw new Error("gem name must be a non-empty RubyGems token.");
+    }
+    return name;
+}
+export function mapRubyGemRow(body, requested) {
+    const name = stringField(body.name) || requested;
+    if (!name)
+        throw new Error(`RubyGems returned no metadata for ${requested}.`);
+    const licenses = Array.isArray(body.licenses)
+        ? body.licenses.map(stringField).filter(Boolean).join(", ")
+        : "";
+    const metadata = body.metadata ?? {};
+    return {
+        gem: name,
+        version: stringField(body.version),
+        releasedAt: stringField(body.version_created_at).slice(0, 10),
+        downloads: numberField(body.downloads),
+        versionDownloads: numberField(body.version_downloads),
+        license: licenses,
+        authors: stringField(body.authors),
+        homepage: stringField(body.homepage_uri),
+        source: stringField(body.source_code_uri) ||
+            stringField(metadata.source_code_uri),
+        bugs: stringField(body.bug_tracker_uri) ||
+            stringField(metadata.bug_tracker_uri),
+        info: stringField(body.info),
+        url: stringField(body.project_uri) || `https://rubygems.org/gems/${name}`,
+    };
+}
+async function fetchGemJson(name) {
+    const response = await fetch(`${GEMS_BASE}/gems/${encodeURIComponent(name)}.json`, {
+        headers: {
+            "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`rubygems gem ${name} returned no result.`);
+    if (!response.ok)
+        throw new Error(`rubygems gem ${name} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "rubygems",
+    name: "gem",
+    description: "Fetch RubyGems gem metadata",
+    domain: "rubygems.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "name",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Gem name",
+        },
+    ],
+    columns: [
+        "gem",
+        "version",
+        "releasedAt",
+        "downloads",
+        "versionDownloads",
+        "license",
+        "authors",
+        "homepage",
+        "source",
+        "bugs",
+        "info",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const name = requireGemName(kwargs.name);
+        const body = (await fetchGemJson(name));
+        return [mapRubyGemRow(body, name)];
+    },
+});
+//# sourceMappingURL=gem.js.map

package/dist/adapters/rubygems/gem.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * @owner   src/adapters/safebooru/web.ts
+ * @does    Register Safebooru tag lookup for exact and prefix-style ACG tag discovery.
+ * @needs   Safebooru DAPI tag XML endpoint.
+ * @feeds   Booru tag discovery before image search/detail/download workflows.
+ * @breaks  Safebooru DAPI XML attribute changes can block tag lookup.
+ */
+export declare function parseSafebooruTags(xml: string): Record<string, unknown>[];
+export declare function mergeSafebooruTags(groups: Record<string, unknown>[][]): Record<string, unknown>[];
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/safebooru/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsCH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmBzE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAY3B"}

package/dist/adapters/safebooru/web.js

@@ -0,0 +1,120 @@
+/**
+ * @owner   src/adapters/safebooru/web.ts
+ * @does    Register Safebooru tag lookup for exact and prefix-style ACG tag discovery.
+ * @needs   Safebooru DAPI tag XML endpoint.
+ * @feeds   Booru tag discovery before image search/detail/download workflows.
+ * @breaks  Safebooru DAPI XML attribute changes can block tag lookup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function required(value, label) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error(`safebooru ${label} cannot be empty.`);
+    return text;
+}
+function requireLimit(value) {
+    if (value === undefined || value === null || value === "")
+        return 20;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 100) {
+        throw new Error("safebooru limit must be an integer in [1, 100].");
+    }
+    return n;
+}
+function decodeXml(value) {
+    return value
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&");
+}
+function attr(source, name) {
+    const match = source.match(new RegExp(`\\b${name}="([^"]*)"`));
+    return match ? decodeXml(match[1]) : "";
+}
+export function parseSafebooruTags(xml) {
+    const rows = [];
+    const tagRegex = /<tag\b[^>]*\/>/g;
+    let match;
+    while ((match = tagRegex.exec(xml)) !== null) {
+        const raw = match[0];
+        const name = attr(raw, "name");
+        if (!name)
+            continue;
+        rows.push({
+            rank: rows.length + 1,
+            id: attr(raw, "id"),
+            name,
+            count: attr(raw, "count"),
+            type: attr(raw, "type"),
+            ambiguous: attr(raw, "ambiguous"),
+            url: `https://safebooru.org/index.php?page=post&s=list&tags=${encodeURIComponent(name)}`,
+        });
+    }
+    return rows;
+}
+export function mergeSafebooruTags(groups) {
+    const rows = [];
+    const seen = new Set();
+    for (const group of groups) {
+        for (const row of group) {
+            const name = str(row.name);
+            if (!name || seen.has(name))
+                continue;
+            seen.add(name);
+            rows.push({ ...row, rank: rows.length + 1 });
+        }
+    }
+    return rows;
+}
+async function fetchTagRows(url) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/xml,text/xml",
+            "User-Agent": USER_AGENT,
+        },
+    });
+    if (!response.ok)
+        throw new Error(`safebooru request failed with HTTP ${response.status}.`);
+    return parseSafebooruTags(await response.text());
+}
+function tagUrl(kind, query, limit) {
+    const url = new URL("https://safebooru.org/index.php");
+    url.searchParams.set("page", "dapi");
+    url.searchParams.set("s", "tag");
+    url.searchParams.set("q", "index");
+    url.searchParams.set(kind, query);
+    url.searchParams.set("limit", String(limit));
+    return url;
+}
+async function searchTags(kwargs) {
+    const query = required(kwargs.query, "query");
+    const limit = requireLimit(kwargs.limit);
+    const rows = mergeSafebooruTags([
+        await fetchTagRows(tagUrl("name", query, 1)),
+        await fetchTagRows(tagUrl("name_pattern", query, limit)),
+    ]).slice(0, limit);
+    if (rows.length === 0)
+        throw new Error(`No Safebooru tags found for "${query}".`);
+    return rows;
+}
+cli({
+    site: "safebooru",
+    name: "tags",
+    description: "Search Safebooru tags by exact tag name or ASCII tag prefix such as blue_archive",
+    domain: "safebooru.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+    ],
+    columns: ["rank", "id", "name", "count", "type", "ambiguous", "url"],
+    func: async (_page, kwargs) => searchTags(kwargs),
+});
+//# sourceMappingURL=web.js.map

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

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

package/dist/adapters/stackoverflow/questions.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @owner   src/adapters/stackoverflow/questions.ts
+ * @does    Register agent-facing Stack Overflow read, related, tag, and user commands.
+ * @needs   Public Stack Exchange API, strict numeric ids, bounded pagination, HTML-to-text conversion.
+ * @feeds   surface coverage ledger, Stack Overflow research workflows, question/answer readers.
+ * @breaks  Stack Exchange envelope drift, partial comment pagination, or weak entity decoding corrupts reads.
+ */
+interface StackOwner {
+    display_name?: unknown;
+    user_id?: unknown;
+}
+interface StackQuestion {
+    question_id?: unknown;
+    accepted_answer_id?: unknown;
+    title?: unknown;
+    body?: unknown;
+    score?: unknown;
+    answer_count?: unknown;
+    view_count?: unknown;
+    is_answered?: unknown;
+    tags?: unknown;
+    owner?: StackOwner;
+    creation_date?: unknown;
+    last_activity_date?: unknown;
+    link?: unknown;
+}
+interface StackAnswer {
+    answer_id?: unknown;
+    is_accepted?: unknown;
+    body?: unknown;
+    score?: unknown;
+    owner?: StackOwner;
+}
+interface StackComment {
+    post_id?: unknown;
+    body?: unknown;
+    score?: unknown;
+    owner?: StackOwner;
+}
+interface StackUser {
+    user_id?: unknown;
+    display_name?: unknown;
+    reputation?: unknown;
+    badge_counts?: {
+        gold?: unknown;
+        silver?: unknown;
+        bronze?: unknown;
+    };
+    location?: unknown;
+    creation_date?: unknown;
+    last_access_date?: unknown;
+    link?: unknown;
+}
+interface StackEnvelope<T> {
+    items?: T[];
+    has_more?: unknown;
+    error_id?: unknown;
+    error_name?: unknown;
+    error_message?: unknown;
+}
+type FetchStackJson = <T>(path: string, params: Record<string, unknown>, label: string) => Promise<StackEnvelope<T>>;
+export declare function requireStackQuestionId(value: unknown, label?: string): string;
+export declare function requireStackString(value: unknown, label: string): string;
+export declare function requireStackLimit(value: unknown, fallback: number, max: number, label: string): number;
+export declare function requireStackMinInt(value: unknown, fallback: number, min: number, label: string): number;
+export declare function stackEpochToDate(value: unknown): string;
+export declare function decodeStackHtmlEntities(value: unknown): string;
+export declare function stackHtmlToText(value: unknown): string;
+export declare function mapStackQuestionRows(questions: StackQuestion[]): Array<Record<string, unknown>>;
+export declare function mapStackUserRows(users: StackUser[]): Array<Record<string, unknown>>;
+export declare function sortStackAnswers(question: StackQuestion, answers: StackAnswer[]): StackAnswer[];
+export declare function buildStackReadRows(question: StackQuestion | undefined, questionComments: StackComment[], answers: StackAnswer[], fetchJson: FetchStackJson, options: {
+    answersLimit: number;
+    commentsLimit: number;
+    maxLength: number;
+    label: string;
+}): Promise<Array<Record<string, unknown>>>;
+export {};
+//# sourceMappingURL=questions.d.ts.map

package/dist/adapters/stackoverflow/questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../../src/adapters/stackoverflow/questions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,UAAU,UAAU;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,WAAW;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,SAAS;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,aAAa,CAAC,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,cAAc,GAAG,CAAC,CAAC,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAc/B,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAO,GAAG,MAAM,CAM3E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAUR;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAiBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKvD;AA2BD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAa9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAetD;AAgED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EAAE,GACzB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBhC;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAAE,GACjB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkBhC;AAUD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,WAAW,EAAE,GACrB,WAAW,EAAE,CAQf;AAmED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,gBAAgB,EAAE,YAAY,EAAE,EAChC,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE;IACP,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAuEzC"}