@zenalexa/unicli 0.219.0 → 0.220.0

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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAkBhD,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAiB,EACjB,SAAiB;IAEjB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IACjD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,GAAG,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC3C,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,OAAO;QACL,GAAG,EAAE,IAAI;QACT,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7D,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;QACtC,gBAAgB,EAAE,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACrD,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;QACxC,MAAM,EACJ,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC;YACjC,WAAW,CAAC,QAAQ,CAAC,eAAe,CAAC;QACvC,IAAI,EACF,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC;YACjC,WAAW,CAAC,QAAQ,CAAC,eAAe,CAAC;QACvC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,6BAA6B,IAAI,EAAE;KAC1E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,SAAS,SAAS,kBAAkB,CAAC,IAAI,CAAC,OAAO,EACpD;QACE,OAAO,EAAE;YACP,YAAY,EAAE,gDAAgD;YAC9D,MAAM,EAAE,kBAAkB;SAC3B;KACF,CACF,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QACzB,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,sBAAsB,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,CAAC,EAAE;QACd,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,kBAAkB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,6BAA6B;IAC1C,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,UAAU;SACxB;KACF;IACD,OAAO,EAAE;QACP,KAAK;QACL,SAAS;QACT,YAAY;QACZ,WAAW;QACX,kBAAkB;QAClB,SAAS;QACT,SAAS;QACT,UAAU;QACV,QAAQ;QACR,MAAM;QACN,MAAM;QACN,KAAK;KACN;IACD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAgB,CAAC;QACvD,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;CACF,CAAC,CAAC"}

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":"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"}