@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/defillama/protocols.js

@@ -0,0 +1,218 @@
+/**
+ * @owner   src/adapters/defillama/protocols.ts
+ * @does    Register agent-facing DefiLlama protocol list and detail commands.
+ * @needs   DefiLlama public API, bounded result limits, validated protocol slugs.
+ * @feeds   surface coverage ledger, DeFi protocol TVL rows, protocol metadata detail.
+ * @breaks  DefiLlama API drift, weak slug validation, or silent empty rows hide DeFi data failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://api.llama.fi";
+const SLUG_RE = /^[a-z0-9][a-z0-9._-]{0,99}$/;
+export function requireDefillamaLimit(value) {
+    const raw = value === undefined || value === null || value === "" ? 30 : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 500) {
+        throw new Error("defillama limit must be an integer in [1, 500].");
+    }
+    return limit;
+}
+export function requireDefillamaSlug(value) {
+    const slug = String(value ?? "").trim();
+    if (!slug)
+        throw new Error("defillama slug cannot be empty.");
+    if (!SLUG_RE.test(slug)) {
+        throw new Error(`defillama slug "${String(value)}" is not valid.`);
+    }
+    return slug;
+}
+export function unixToDate(value) {
+    if (value == null)
+        return null;
+    const n = Number(value);
+    if (!Number.isFinite(n) || n <= 0)
+        return null;
+    const date = new Date(n > 1e12 ? n : n * 1000);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString().slice(0, 10);
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function numberField(value) {
+    const n = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim()
+            ? Number(value)
+            : NaN;
+    return Number.isFinite(n) ? n : null;
+}
+function joinStrings(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string" && item.trim()).join(", ")
+        : "";
+}
+function objectField(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+export function mapDefillamaProtocolRows(rows, limit) {
+    return rows
+        .filter((row) => (row.slug || row.name) && numberField(row.tvl) != null)
+        .sort((a, b) => (numberField(b.tvl) ?? 0) - (numberField(a.tvl) ?? 0))
+        .slice(0, limit)
+        .map((row, index) => {
+        const slug = stringField(row.slug);
+        return {
+            rank: index + 1,
+            slug,
+            name: stringField(row.name),
+            category: stringField(row.category),
+            tvl: numberField(row.tvl),
+            mcap: numberField(row.mcap),
+            change_1d: numberField(row.change_1d),
+            change_7d: numberField(row.change_7d),
+            chains: joinStrings(row.chains),
+            listedAt: unixToDate(row.listedAt),
+            url: slug ? `https://defillama.com/protocol/${slug}` : "",
+        };
+    });
+}
+export function mapDefillamaDetailRow(slug, detail, protocols) {
+    const tvlSeries = Array.isArray(detail.tvl)
+        ? detail.tvl
+        : [];
+    const lastPoint = tvlSeries[tvlSeries.length - 1] ?? {};
+    const isParent = detail.isParentProtocol === true;
+    const chains = new Set(Array.isArray(detail.chains) ? detail.chains : []);
+    let category = "";
+    if (isParent) {
+        for (const protocol of protocols) {
+            if (protocol.parentProtocol === detail.id &&
+                Array.isArray(protocol.chains)) {
+                for (const chain of protocol.chains) {
+                    if (typeof chain === "string")
+                        chains.add(chain);
+                }
+            }
+        }
+    }
+    else {
+        const match = protocols.find((protocol) => protocol.slug === slug);
+        category = stringField(match?.category);
+        if (Array.isArray(match?.chains)) {
+            for (const chain of match.chains) {
+                if (typeof chain === "string")
+                    chains.add(chain);
+            }
+        }
+    }
+    return {
+        slug,
+        name: stringField(detail.name),
+        category,
+        isParent,
+        tvl: numberField(lastPoint.totalLiquidityUSD),
+        tvlAt: unixToDate(lastPoint.date),
+        mcap: numberField(detail.mcap),
+        chains: [...chains].join(", "),
+        twitter: stringField(detail.twitter),
+        github: joinStrings(detail.github),
+        audits: stringField(detail.audits),
+        listedAt: unixToDate(detail.listedAt),
+        description: stringField(detail.description),
+        website: stringField(detail.url),
+        url: `https://defillama.com/protocol/${slug}`,
+    };
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-defillama (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 400)
+        throw new Error(`${label} returned HTTP 400.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "defillama",
+    name: "protocols",
+    description: "Top DeFi protocols by current TVL",
+    domain: "defillama.com",
+    strategy: Strategy.PUBLIC,
+    args: [{ name: "limit", type: "int", default: 30, description: "Max rows" }],
+    columns: [
+        "rank",
+        "slug",
+        "name",
+        "category",
+        "tvl",
+        "mcap",
+        "change_1d",
+        "change_7d",
+        "chains",
+        "listedAt",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const limit = requireDefillamaLimit(kwargs.limit);
+        const body = await fetchJson(`${API_BASE}/protocols`, "defillama protocols");
+        const rows = mapDefillamaProtocolRows(Array.isArray(body) ? body : [], limit);
+        if (rows.length === 0)
+            throw new Error("defillama protocols returned no rows.");
+        return rows;
+    },
+});
+cli({
+    site: "defillama",
+    name: "protocol",
+    description: "Fetch DefiLlama protocol detail by slug",
+    domain: "defillama.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "slug",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Protocol slug",
+        },
+    ],
+    columns: [
+        "slug",
+        "name",
+        "category",
+        "isParent",
+        "tvl",
+        "tvlAt",
+        "mcap",
+        "chains",
+        "twitter",
+        "github",
+        "audits",
+        "listedAt",
+        "description",
+        "website",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const slug = requireDefillamaSlug(kwargs.slug);
+        const detail = objectField(await fetchJson(`${API_BASE}/protocol/${encodeURIComponent(slug)}`, "defillama protocol"));
+        if (!detail.name)
+            throw new Error(`defillama protocol returned no row for "${slug}".`);
+        const protocols = await fetchJson(`${API_BASE}/protocols`, "defillama protocol list");
+        return [
+            mapDefillamaDetailRow(slug, detail, Array.isArray(protocols)
+                ? protocols
+                : []),
+        ];
+    },
+});
+//# sourceMappingURL=protocols.js.map

package/dist/adapters/defillama/protocols.js.map

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

package/dist/adapters/devto/read.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @owner   src/adapters/devto/read.ts
+ * @does    Register agent-facing DEV.to article reader.
+ * @needs   Public dev.to articles API, numeric article ids, explicit body truncation.
+ * @feeds   surface coverage ledger, developer article reading workflow.
+ * @breaks  DEV.to API shape drift or missing body_markdown would silently hide article content.
+ */
+interface DevtoArticle {
+    id?: unknown;
+    title?: unknown;
+    body_markdown?: unknown;
+    user?: {
+        username?: unknown;
+    };
+    public_reactions_count?: unknown;
+    reading_time_minutes?: unknown;
+    tag_list?: unknown;
+    tags?: unknown;
+    published_at?: unknown;
+    url?: unknown;
+}
+export declare function requireDevtoArticleId(value: unknown): string;
+export declare function requireDevtoMaxLength(value: unknown, fallback?: number): number;
+export declare function mapDevtoArticleRow(article: DevtoArticle, requestedId: string, maxLength: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=read.d.ts.map

package/dist/adapters/devto/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/adapters/devto/read.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,YAAY;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAUD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM5D;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAS,GAChB,MAAM,CAOR;AAOD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB"}

package/dist/adapters/devto/read.js

@@ -0,0 +1,110 @@
+/**
+ * @owner   src/adapters/devto/read.ts
+ * @does    Register agent-facing DEV.to article reader.
+ * @needs   Public dev.to articles API, numeric article ids, explicit body truncation.
+ * @feeds   surface coverage ledger, developer article reading workflow.
+ * @breaks  DEV.to API shape drift or missing body_markdown would silently hide article content.
+ */
+import { cli, Strategy } from "../../registry.js";
+const DEVTO_ARTICLE_BASE = "https://dev.to/api/articles";
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+export function requireDevtoArticleId(value) {
+    const id = String(value ?? "").trim();
+    if (!/^\d+$/.test(id)) {
+        throw new Error(`Invalid DEV.to article id: ${String(value)}.`);
+    }
+    return id;
+}
+export function requireDevtoMaxLength(value, fallback = 20_000) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 100) {
+        throw new Error("devto read max-length must be an integer >= 100.");
+    }
+    return n;
+}
+function normalizeTags(article) {
+    const tags = article.tag_list ?? article.tags ?? "";
+    return Array.isArray(tags) ? tags.map(String).join(", ") : String(tags);
+}
+export function mapDevtoArticleRow(article, requestedId, maxLength) {
+    if (!article || !article.id) {
+        throw new Error(`DEV.to article ${requestedId} returned no article.`);
+    }
+    const body = stringField(article.body_markdown);
+    if (!body.trim()) {
+        throw new Error(`DEV.to article ${requestedId} did not include body_markdown.`);
+    }
+    return {
+        id: article.id,
+        title: stringField(article.title),
+        author: stringField(article.user?.username) || "[deleted]",
+        reactions: numberField(article.public_reactions_count),
+        reading_time: numberField(article.reading_time_minutes),
+        tags: normalizeTags(article),
+        published_at: stringField(article.published_at),
+        body: body.length > maxLength
+            ? `${body.slice(0, maxLength)}\n\n... [truncated]`
+            : body,
+        url: stringField(article.url),
+    };
+}
+async function fetchDevtoArticle(id) {
+    const response = await fetch(`${DEVTO_ARTICLE_BASE}/${id}`, {
+        headers: {
+            "User-Agent": "unicli-devto/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`DEV.to article ${id} not found.`);
+    if (!response.ok) {
+        throw new Error(`DEV.to API returned HTTP ${response.status} for article ${id}.`);
+    }
+    return (await response.json());
+}
+cli({
+    site: "devto",
+    name: "read",
+    description: "Read a DEV.to article body by id",
+    domain: "dev.to",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "DEV.to numeric article id",
+        },
+        {
+            name: "max-length",
+            type: "int",
+            default: 20_000,
+            description: "Max body characters",
+        },
+    ],
+    columns: [
+        "id",
+        "title",
+        "author",
+        "reactions",
+        "reading_time",
+        "tags",
+        "published_at",
+        "body",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const id = requireDevtoArticleId(kwargs.id);
+        const maxLength = requireDevtoMaxLength(kwargs["max-length"] ?? kwargs.maxLength);
+        return [mapDevtoArticleRow(await fetchDevtoArticle(id), id, maxLength)];
+    },
+});
+//# sourceMappingURL=read.js.map

package/dist/adapters/devto/read.js.map

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

package/dist/adapters/dianping/shop.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @owner   src/adapters/dianping/shop.ts
+ * @does    Register agent-facing Dianping shop detail extraction implemented with site-specific safety checks.
+ * @needs   Dianping shop page DOM and a browser profile that can pass Dianping anti-bot checks.
+ * @feeds   surface coverage ledger and restaurant search-to-detail workflows.
+ * @breaks  Dianping shop-head DOM drift, login redirects, captcha gates, or deleted shops can hide detail fields.
+ */
+declare const SHOP_FIELDS: readonly ["shop_id", "name", "rating", "reviews", "price", "rank", "taste", "environment", "service", "ingredients", "hours", "address", "subway", "features", "url"];
+type DianpingShopField = (typeof SHOP_FIELDS)[number];
+interface DianpingShopBreakdown {
+    口味?: unknown;
+    环境?: unknown;
+    服务?: unknown;
+    食材?: unknown;
+}
+interface DianpingShopData {
+    name?: unknown;
+    rating?: unknown;
+    reviewsRaw?: unknown;
+    priceRaw?: unknown;
+    rank?: unknown;
+    breakdown?: DianpingShopBreakdown;
+    hours?: unknown;
+    address?: unknown;
+    subway?: unknown;
+    features?: unknown;
+    url?: unknown;
+}
+export declare function normalizeDianpingShopId(value: unknown): string;
+export declare function parseDianpingReviewCount(value: unknown): number | null;
+export declare function parseDianpingPrice(value: unknown): number | null;
+export declare function mapDianpingShopFields(shopId: string, data: DianpingShopData, fallbackUrl: string): Array<{
+    field: DianpingShopField;
+    value: unknown;
+}>;
+export declare function classifyDianpingShopFailure(sample: unknown, url: string, shopId: string): never;
+export {};
+//# sourceMappingURL=shop.d.ts.map

package/dist/adapters/dianping/shop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shop.d.ts","sourceRoot":"","sources":["../../../src/adapters/dianping/shop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,QAAA,MAAM,WAAW,uKAgBP,CAAC;AAEX,KAAK,iBAAiB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,UAAU,qBAAqB;IAC7B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAOD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW9D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAYtE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKhE;AAmBD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,GAClB,KAAK,CAAC;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBrD;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,KAAK,CA+BP"}

package/dist/adapters/dianping/shop.js

@@ -0,0 +1,194 @@
+/**
+ * @owner   src/adapters/dianping/shop.ts
+ * @does    Register agent-facing Dianping shop detail extraction implemented with site-specific safety checks.
+ * @needs   Dianping shop page DOM and a browser profile that can pass Dianping anti-bot checks.
+ * @feeds   surface coverage ledger and restaurant search-to-detail workflows.
+ * @breaks  Dianping shop-head DOM drift, login redirects, captcha gates, or deleted shops can hide detail fields.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { str } from "../_shared/browser-tools.js";
+const DIANPING_ORIGIN = "https://www.dianping.com";
+const SHOP_ID_RE = /^[A-Za-z0-9_-]+$/;
+const SHOP_FIELDS = [
+    "shop_id",
+    "name",
+    "rating",
+    "reviews",
+    "price",
+    "rank",
+    "taste",
+    "environment",
+    "service",
+    "ingredients",
+    "hours",
+    "address",
+    "subway",
+    "features",
+    "url",
+];
+export function normalizeDianpingShopId(value) {
+    const raw = str(value).trim();
+    if (!raw)
+        throw new Error("Dianping shop_id must be a non-empty string.");
+    const match = raw.match(/\/shop\/([^/?#]+)/);
+    const shopId = match?.[1] ?? raw;
+    if (!SHOP_ID_RE.test(shopId)) {
+        throw new Error(`Dianping shop_id must be an alphanumeric shop ID or /shop/<id> URL.`);
+    }
+    return shopId;
+}
+export function parseDianpingReviewCount(value) {
+    const text = str(value).trim();
+    if (!text)
+        return null;
+    const wan = text.match(/^([\d.]+)\s*万/);
+    if (wan) {
+        const count = Number(wan[1]);
+        return Number.isFinite(count) ? Math.round(count * 10000) : null;
+    }
+    const plain = text.match(/(\d+(?:\.\d+)?)/);
+    if (!plain)
+        return null;
+    const count = Number(plain[1]);
+    return Number.isFinite(count) ? Math.round(count) : null;
+}
+export function parseDianpingPrice(value) {
+    const match = str(value).match(/[¥￥]\s*(\d+(?:\.\d+)?)/);
+    if (!match)
+        return null;
+    const price = Number(match[1]);
+    return Number.isFinite(price) ? price : null;
+}
+function numberOrNull(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    const text = str(value).trim();
+    if (!text)
+        return null;
+    const valueNumber = Number(text);
+    return Number.isFinite(valueNumber) ? valueNumber : null;
+}
+function featuresText(value) {
+    if (Array.isArray(value))
+        return value
+            .map((item) => str(item).trim())
+            .filter(Boolean)
+            .join(", ");
+    return str(value).trim();
+}
+export function mapDianpingShopFields(shopId, data, fallbackUrl) {
+    const rating = numberOrNull(data.rating);
+    const breakdown = data.breakdown ?? {};
+    const values = {
+        shop_id: shopId,
+        name: str(data.name).trim(),
+        rating,
+        reviews: parseDianpingReviewCount(data.reviewsRaw),
+        price: parseDianpingPrice(data.priceRaw),
+        rank: str(data.rank).trim(),
+        taste: numberOrNull(breakdown["口味"]),
+        environment: numberOrNull(breakdown["环境"]),
+        service: numberOrNull(breakdown["服务"]),
+        ingredients: numberOrNull(breakdown["食材"]),
+        hours: str(data.hours).trim(),
+        address: str(data.address).trim(),
+        subway: str(data.subway).trim(),
+        features: featuresText(data.features),
+        url: str(data.url).trim() || fallbackUrl,
+    };
+    return SHOP_FIELDS.map((field) => ({ field, value: values[field] }));
+}
+export function classifyDianpingShopFailure(sample, url, shopId) {
+    const signal = `${url} ${str(sample)}`;
+    if (/verify\.meituan\.com|verifyimg|身份核实|请依次点击|美团安全验证|Yoda/i.test(signal)) {
+        throw new Error(`Dianping shop ${shopId} is blocked by captcha; solve the Dianping captcha in this browser profile and retry.`);
+    }
+    if (/login\.dianping\.com|account\.dianping\.com|请先登录|未登录|请登录/.test(signal)) {
+        throw new Error(`Dianping shop ${shopId} requires login; sign in to dianping.com in this browser profile and retry.`);
+    }
+    if (/商户不存在|店铺不存在|店铺已关闭|页面不存在|404|已下线|没有找到相关商户/i.test(signal)) {
+        throw new Error(`Dianping shop ${shopId} was not found or is unavailable.`);
+    }
+    const preview = str(sample).slice(0, 160);
+    throw new Error(`Dianping shop ${shopId} did not render expected shop data${preview ? `; sample: ${preview}` : ""}.`);
+}
+function buildDianpingShopEvaluate() {
+    return `(() => {
+    const clean = (value) => value == null ? '' : String(value).replace(/\\s+/g, ' ').trim();
+    const head = document.querySelector('.shop-head');
+    if (!head) {
+      const sample = clean(document.body?.innerText || document.body?.textContent || '').slice(0, 800);
+      return { ok: false, sample, url: location.href };
+    }
+    const headText = clean(head.textContent);
+    const titleEl = document.querySelector('.shop-name, .shop-head h2, .shop-head h1');
+    let name = clean(titleEl?.textContent);
+    if (!name) {
+      const match = String(document.title || '').match(/【([^】]+)】/);
+      if (match) name = clean(match[1]);
+    }
+    const rating = clean(document.querySelector('.star-score')?.textContent);
+    const reviewEl = document.querySelector('.reviews, .review-num, .reviewCount, .reviewCountSentence');
+    let reviewsRaw = clean(reviewEl?.textContent);
+    if (!reviewsRaw) {
+      const titleText = clean(document.querySelector('.review-title')?.textContent);
+      const titleMatch = titleText.match(/评价\\(([\\d.,万]+)\\)/);
+      if (titleMatch) reviewsRaw = titleMatch[1];
+    }
+    const priceMatch = headText.match(/[¥￥]\\s*\\d+(?:\\.\\d+)?/);
+    const breakdown = {};
+    for (const key of ['口味', '环境', '服务', '食材']) {
+      const match = headText.match(new RegExp(key + '[:：]\\\\s*([0-9.]+)'));
+      if (match) breakdown[key] = Number(match[1]);
+    }
+    const features = Array.from(document.querySelectorAll('.shop-feature')).map((node) => clean(node.textContent)).filter(Boolean);
+    const subwayMatch = headText.match(/距(?:地铁)?[^\\s]+?步行\\d+m/);
+    const hoursMatch = headText.match(/营业中[^\\s]*\\d{1,2}:\\d{2}-(?:次日)?\\d{1,2}:\\d{2}|今日休息|暂停营业/);
+    const rankMatch = headText.match(/[^\\s]+?(?:口味|人气|环境|服务)榜\\s*[·•]\\s*第\\d+名/);
+    return {
+      ok: true,
+      name,
+      rating,
+      reviewsRaw,
+      priceRaw: priceMatch?.[0] || '',
+      rank: rankMatch?.[0] || '',
+      breakdown,
+      hours: hoursMatch?.[0] || '',
+      address: clean(document.querySelector('.desc-info')?.textContent),
+      subway: subwayMatch?.[0] || '',
+      features,
+      url: location.href,
+    };
+  })()`;
+}
+cli({
+    site: "dianping",
+    name: "shop",
+    description: "Read Dianping shop details by shop ID or shop URL",
+    domain: "www.dianping.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: "shop_id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Dianping shop ID or https://www.dianping.com/shop/<id> URL",
+        },
+    ],
+    columns: ["field", "value"],
+    func: async (page, kwargs) => {
+        const shopId = normalizeDianpingShopId(kwargs.shop_id);
+        const url = `${DIANPING_ORIGIN}/shop/${shopId}`;
+        const p = page;
+        await p.goto(url, { waitUntil: "load", settleMs: 3000 });
+        await p.wait(3);
+        const result = (await p.evaluate(buildDianpingShopEvaluate()));
+        if (!result?.ok) {
+            classifyDianpingShopFailure(result?.sample, str(result?.url) || url, shopId);
+        }
+        return mapDianpingShopFields(shopId, result, url);
+    },
+});
+//# sourceMappingURL=shop.js.map

package/dist/adapters/dianping/shop.js.map

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

package/dist/adapters/dockerhub/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @owner   src/adapters/dockerhub/registry.ts
+ * @does    Register agent-facing Docker Hub search and image metadata commands.
+ * @needs   Public Docker Hub API, TypeScript adapter loader, bounded argument parsing.
+ * @feeds   surface coverage ledger, container registry command surface, agent-readable image rows.
+ * @breaks  Docker Hub API envelope drift, weak image parsing, or silent empty results hide registry lookup failures.
+ */
+interface DockerHubSearchItem {
+    repo_owner?: unknown;
+    repo_name?: unknown;
+    is_official?: unknown;
+    star_count?: unknown;
+    pull_count?: unknown;
+    short_description?: unknown;
+}
+interface DockerHubImageBody {
+    namespace?: unknown;
+    name?: unknown;
+    star_count?: unknown;
+    pull_count?: unknown;
+    description?: unknown;
+    last_updated?: unknown;
+    last_modified?: unknown;
+    date_registered?: unknown;
+    status_description?: unknown;
+}
+export declare function requireDockerHubString(value: unknown, name: string): string;
+export declare function requireDockerHubLimit(value: unknown, fallback: number): number;
+export declare function parseDockerHubImage(value: unknown): {
+    owner: string;
+    name: string;
+};
+export declare function mapDockerHubSearchRows(items: DockerHubSearchItem[], limit: number): Array<Record<string, unknown>>;
+export declare function mapDockerHubImageRow(body: DockerHubImageBody, fallbackOwner: string, fallbackName: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=registry.d.ts.map