@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/goproxy/module.js

@@ -0,0 +1,221 @@
+/**
+ * @owner   src/adapters/goproxy/module.ts
+ * @does    Register agent-facing Go module proxy metadata and version commands.
+ * @needs   Public proxy.golang.org GOPROXY protocol, TypeScript adapter loader, Go module path validation.
+ * @feeds   surface coverage ledger, Go package registry command surface, agent-readable module rows.
+ * @breaks  GOPROXY protocol drift, weak module path validation, or silent empty rows hide module lookup failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const GOPROXY_BASE = "https://proxy.golang.org";
+const MODULE_PATH_RE = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,199}$/;
+const VERSION_TAG_RE = /^v[0-9]+(\.[0-9]+)*([-+][A-Za-z0-9._-]+)?$/;
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function trimDate(value) {
+    const text = stringField(value).trim();
+    if (!text)
+        return null;
+    const noFraction = text.replace(/\.\d+/, "");
+    return noFraction.endsWith("Z")
+        ? noFraction
+        : text.length >= 10
+            ? text.slice(0, 10)
+            : null;
+}
+export function requireGoModulePath(value) {
+    const modulePath = String(value ?? "").trim();
+    if (!modulePath)
+        throw new Error("goproxy module path is required.");
+    if (!MODULE_PATH_RE.test(modulePath) || !modulePath.includes("/")) {
+        throw new Error(`goproxy module path "${String(value)}" is not recognised.`);
+    }
+    return modulePath;
+}
+export function requireGoProxyLimit(value, fallback = 30) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 200) {
+        throw new Error(`goproxy limit must be an integer in [1, 200]. Got: ${String(value)}`);
+    }
+    return n;
+}
+function encodeModulePath(modulePath) {
+    return modulePath.split("/").map(encodeURIComponent).join("/");
+}
+function parseSemver(tag) {
+    const stripped = tag.replace(/^v/, "");
+    const noBuild = stripped.split("+")[0] ?? stripped;
+    const dash = noBuild.indexOf("-");
+    const head = dash >= 0 ? noBuild.slice(0, dash) : noBuild;
+    const pre = dash >= 0 ? noBuild.slice(dash + 1) : "";
+    return {
+        numbers: head.split(".").map((part) => {
+            const n = Number.parseInt(part, 10);
+            return Number.isFinite(n) ? n : 0;
+        }),
+        pre,
+    };
+}
+function comparePrerelease(left, right) {
+    const leftParts = left.split(".");
+    const rightParts = right.split(".");
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let i = 0; i < length; i += 1) {
+        const a = leftParts[i];
+        const b = rightParts[i];
+        if (a == null)
+            return -1;
+        if (b == null)
+            return 1;
+        const aNum = /^\d+$/.test(a);
+        const bNum = /^\d+$/.test(b);
+        if (aNum && bNum) {
+            const diff = Number(a) - Number(b);
+            if (diff !== 0)
+                return diff;
+            continue;
+        }
+        if (aNum !== bNum)
+            return aNum ? -1 : 1;
+        if (a !== b)
+            return a < b ? -1 : 1;
+    }
+    return 0;
+}
+function compareSemver(left, right) {
+    const a = parseSemver(left);
+    const b = parseSemver(right);
+    const length = Math.max(a.numbers.length, b.numbers.length);
+    for (let i = 0; i < length; i += 1) {
+        const diff = (a.numbers[i] ?? 0) - (b.numbers[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    if (a.pre === "" && b.pre !== "")
+        return 1;
+    if (a.pre !== "" && b.pre === "")
+        return -1;
+    return comparePrerelease(a.pre, b.pre);
+}
+export function sortGoVersionsDescending(versions) {
+    return versions
+        .filter((version) => VERSION_TAG_RE.test(version))
+        .sort((a, b) => compareSemver(b, a));
+}
+export function mapGoProxyModuleRow(modulePath, detail) {
+    if (!detail.Version) {
+        throw new Error(`proxy.golang.org returned no @latest entry for "${modulePath}".`);
+    }
+    const origin = detail.Origin ?? {};
+    const encoded = encodeModulePath(modulePath);
+    return {
+        module: modulePath,
+        version: stringField(detail.Version),
+        publishedAt: trimDate(detail.Time),
+        vcs: stringField(origin.VCS).trim(),
+        repository: stringField(origin.URL).trim(),
+        commit: stringField(origin.Hash).trim(),
+        ref: stringField(origin.Ref).trim(),
+        pkgGoDevUrl: `https://pkg.go.dev/${modulePath}`,
+        url: `${GOPROXY_BASE}/${encoded}/@latest`,
+    };
+}
+export function mapGoProxyVersionRows(modulePath, versions, limit) {
+    const encoded = encodeModulePath(modulePath);
+    const sorted = sortGoVersionsDescending(versions).slice(0, limit);
+    if (sorted.length === 0) {
+        throw new Error(`"${modulePath}" has no semver-shaped tags on proxy.golang.org.`);
+    }
+    return sorted.map((version, index) => ({
+        rank: index + 1,
+        module: modulePath,
+        version,
+        publishedAt: null,
+        url: `${GOPROXY_BASE}/${encoded}/@v/${encodeURIComponent(version)}.info`,
+    }));
+}
+async function fetchGoProxy(url, label) {
+    const response = await fetch(url, {
+        headers: { "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)" },
+    });
+    if (response.status === 404 || response.status === 410)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response;
+}
+cli({
+    site: "goproxy",
+    name: "module",
+    description: "Latest version and VCS origin metadata for a Go module",
+    domain: "proxy.golang.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "module",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Go module path",
+        },
+    ],
+    columns: [
+        "module",
+        "version",
+        "publishedAt",
+        "vcs",
+        "repository",
+        "commit",
+        "ref",
+        "pkgGoDevUrl",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const modulePath = requireGoModulePath(kwargs.module);
+        const response = await fetchGoProxy(`${GOPROXY_BASE}/${encodeModulePath(modulePath)}/@latest`, `goproxy module ${modulePath}`);
+        return [
+            mapGoProxyModuleRow(modulePath, (await response.json())),
+        ];
+    },
+});
+cli({
+    site: "goproxy",
+    name: "versions",
+    description: "Published version tags for a Go module",
+    domain: "proxy.golang.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "module",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Go module path",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 30,
+            description: "Max rows",
+        },
+    ],
+    columns: ["rank", "module", "version", "publishedAt", "url"],
+    func: async (_page, kwargs) => {
+        const modulePath = requireGoModulePath(kwargs.module);
+        const limit = requireGoProxyLimit(kwargs.limit);
+        const response = await fetchGoProxy(`${GOPROXY_BASE}/${encodeModulePath(modulePath)}/@v/list`, `goproxy versions ${modulePath}`);
+        const versions = (await response.text())
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+        if (versions.length === 0) {
+            throw new Error(`proxy.golang.org returned no published versions for "${modulePath}".`);
+        }
+        return mapGoProxyVersionRows(modulePath, versions, limit);
+    },
+});
+//# sourceMappingURL=module.js.map

package/dist/adapters/goproxy/module.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * @owner   src/adapters/grok/web.ts
+ * @does    Register agent-facing Grok web commands implemented with site-specific safety checks.
+ * @needs   Logged-in grok.com browser session, Grok chat DOM, optional local image output directory.
+ * @feeds   surface coverage ledger and Grok read/history/detail/send/new/status/image workflows.
+ * @breaks  Grok DOM drift or weak UUID validation can miss or target the wrong conversation.
+ */
+interface GrokBubble {
+    id?: unknown;
+    role?: unknown;
+    text?: unknown;
+    html?: unknown;
+}
+interface GrokImage {
+    src: string;
+    w: number;
+    h: number;
+}
+export declare function normalizeGrokBoolean(value: unknown, fallback?: boolean): boolean;
+export declare function parseGrokSessionId(value: unknown): string;
+export declare function grokHtmlToMarkdown(value: unknown): string;
+export declare function mapGrokBubbles(bubbles: GrokBubble[], wantMarkdown: boolean): Record<string, unknown>[];
+export declare function mapGrokSessions(sessions: {
+    id?: unknown;
+    title?: unknown;
+}[]): Record<string, unknown>[];
+export declare function pickLatestGrokImages(bubbleImageSets: GrokImage[][], baselineCount: number): GrokImage[];
+export {};
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/grok/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,UAAU,UAAU;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,UAAQ,GACf,OAAO,CAIT;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgCzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAezD;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,EACrB,YAAY,EAAE,OAAO,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAW3B;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAW3B;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,SAAS,EAAE,EAAE,EAC9B,aAAa,EAAE,MAAM,GACpB,SAAS,EAAE,CAMb"}