@zenalexa/unicli 0.220.1 → 0.221.1

package/dist/adapters/cnipa/legal-status.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @owner       src::adapters::cnipa::legal-status
+ * @does        Browser-driven CNIPA legal-status lookup — scrapes the prosecution timeline + grant status from the 公众查询 detail page; emits structured envelopes for captcha / not-found / MCP-bus gaps.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.legal-status)
+ * @breaks      emits PATENT_INVALID_NUMBER, PATENT_BROWSER_CAPTCHA, PATENT_API_DEPRECATED (with MCP_BUS_MISSING context); never synthesizes a status
+ * @invariants  output row carries `legal_status` exactly as scraped; no normalization beyond trim
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/cnipa/search.test.ts (shared transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+export declare function runCnipaLegalStatus(kwargs: {
+    publication_number: string;
+}): Promise<unknown[]>;
+//# sourceMappingURL=legal-status.d.ts.map

package/dist/adapters/cnipa/legal-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legal-status.d.ts","sourceRoot":"","sources":["../../../src/adapters/cnipa/legal-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsCH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAgFrB"}

package/dist/adapters/cnipa/legal-status.js

@@ -0,0 +1,119 @@
+/**
+ * @owner       src::adapters::cnipa::legal-status
+ * @does        Browser-driven CNIPA legal-status lookup — scrapes the prosecution timeline + grant status from the 公众查询 detail page; emits structured envelopes for captcha / not-found / MCP-bus gaps.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.legal-status)
+ * @breaks      emits PATENT_INVALID_NUMBER, PATENT_BROWSER_CAPTCHA, PATENT_API_DEPRECATED (with MCP_BUS_MISSING context); never synthesizes a status
+ * @invariants  output row carries `legal_status` exactly as scraped; no normalization beyond trim
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/cnipa/search.test.ts (shared transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { cnipaEnvelope, looksLikeCaptcha, navigateAndExtract, transportErrorToEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/cnipa/legal-status.ts";
+const CNIPA_LEGAL_URL = "https://pss-system.cponline.cnipa.gov.cn/legalStatus";
+const EXTRACTOR = `(() => {
+  const text = (sel) => {
+    const node = document.querySelector(sel);
+    return node ? (node.textContent || '').trim() : '';
+  };
+  return {
+    publication_number: text('[data-field="pubNo"], .publication-number'),
+    legal_status: text('[data-field="legalStatus"], .legal-status'),
+    status_date: text('[data-field="statusDate"], .status-date'),
+    source_url: location.href,
+    html_marker: document.body && document.body.innerText
+      ? document.body.innerText.slice(0, 200)
+      : '',
+  };
+})()`;
+export async function runCnipaLegalStatus(kwargs) {
+    const pubNo = String(kwargs.publication_number ?? "").trim();
+    if (pubNo.length === 0) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_INVALID_NUMBER", ADAPTER_PATH, "validate", "cnipa legal-status requires a non-empty publication_number"),
+            },
+        ];
+    }
+    const url = `${CNIPA_LEGAL_URL}?pubNo=${encodeURIComponent(pubNo)}`;
+    let detail;
+    try {
+        const result = await navigateAndExtract(url, EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: cnipaEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "mcp-browser evaluate returned no data"),
+                },
+            ];
+        }
+        detail = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    const fieldCount = [detail.publication_number, detail.legal_status].filter(Boolean).length;
+    if (looksLikeCaptcha(fieldCount, detail.html_marker)) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_BROWSER_CAPTCHA", ADAPTER_PATH, "evaluate", "CNIPA legal-status page returned no fields; solve the 验证码 and re-run", ["espacenet"]),
+            },
+        ];
+    }
+    if (!detail.legal_status) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", `cnipa returned no legal_status for "${pubNo}"`, ["espacenet"]),
+            },
+        ];
+    }
+    return [
+        {
+            publication_number: detail.publication_number || pubNo,
+            legal_status: detail.legal_status,
+            status_date: detail.status_date,
+            source_adapter: "cnipa",
+            source_url: detail.source_url || url,
+            retrieved_at: new Date().toISOString(),
+        },
+    ];
+}
+cli({
+    site: "cnipa",
+    name: "legal-status",
+    description: "CNIPA legal-status / prosecution timeline lookup (browser)",
+    domain: "pss-system.cponline.cnipa.gov.cn",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "publication_number",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "ST.16 publication number",
+        },
+    ],
+    columns: ["publication_number", "legal_status", "status_date", "source_url"],
+    capabilities: [
+        "mcp-browser.navigate",
+        "mcp-browser.evaluate",
+        "patent.legal-status",
+    ],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runCnipaLegalStatus(kwargs),
+});
+//# sourceMappingURL=legal-status.js.map

package/dist/adapters/cnipa/legal-status.js.map

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

package/dist/adapters/cnipa/search.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @owner       src::adapters::cnipa::search
+ * @does        Browser-driven search of CNIPA 公众查询 system at pss-system.cponline.cnipa.gov.cn — the only programmatic route for CN patents (CNIPA has no open API today). Drives a real Chrome session via the mcp-browser transport, extracts result rows, normalizes through assemblePatentRecord.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (meta-command discovers via patent.search capability tag)
+ * @breaks      emits PATENT_BROWSER_CAPTCHA envelope when zero rows return from a navigation that did not error (CNIPA almost always shows a captcha gate); emits PATENT_API_DEPRECATED with MCP_BUS_MISSING context when no outbound MCP transport is registered
+ * @invariants  result rows always include source_adapter='cnipa'; publication_number canonicalized via assemblePatentRecord; never returns a synthetic row when extraction fails
+ * @side-effects controls the user's Chrome browser via MCP; reads no env vars
+ * @perf        single navigation + one evaluate; ~2-5 s wall-clock when active
+ * @concurrency safe — every call opens a fresh tab via mcpBrowserNavigate
+ * @test        tests/unit/adapters/cnipa/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only — no upstream API; gated on a live mcp-browser transport
+ */
+export declare function runCnipaSearch(kwargs: {
+    query: string;
+    limit?: number;
+    offset?: number;
+}): Promise<unknown[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/adapters/cnipa/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/cnipa/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsEH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAkGrB"}

package/dist/adapters/cnipa/search.js

@@ -0,0 +1,170 @@
+/**
+ * @owner       src::adapters::cnipa::search
+ * @does        Browser-driven search of CNIPA 公众查询 system at pss-system.cponline.cnipa.gov.cn — the only programmatic route for CN patents (CNIPA has no open API today). Drives a real Chrome session via the mcp-browser transport, extracts result rows, normalizes through assemblePatentRecord.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (meta-command discovers via patent.search capability tag)
+ * @breaks      emits PATENT_BROWSER_CAPTCHA envelope when zero rows return from a navigation that did not error (CNIPA almost always shows a captcha gate); emits PATENT_API_DEPRECATED with MCP_BUS_MISSING context when no outbound MCP transport is registered
+ * @invariants  result rows always include source_adapter='cnipa'; publication_number canonicalized via assemblePatentRecord; never returns a synthetic row when extraction fails
+ * @side-effects controls the user's Chrome browser via MCP; reads no env vars
+ * @perf        single navigation + one evaluate; ~2-5 s wall-clock when active
+ * @concurrency safe — every call opens a fresh tab via mcpBrowserNavigate
+ * @test        tests/unit/adapters/cnipa/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only — no upstream API; gated on a live mcp-browser transport
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { assemblePatentRecord } from "../../engine/normalizer/patent-envelope.js";
+import { cnipaEnvelope, looksLikeCaptcha, navigateAndExtract, transportErrorToEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/cnipa/search.ts";
+const CNIPA_SEARCH_URL = "https://pss-system.cponline.cnipa.gov.cn/conventionalSearch";
+/**
+ * DOM extractor executed inside the page via mcp-browser. The selectors are
+ * the documented ones for the CNIPA 公众查询 result table; when CNIPA
+ * changes the markup an agent reads the failure envelope and updates the
+ * selector here (rule 02 self-repair).
+ */
+const EXTRACTOR = `(() => {
+  const rows = Array.from(
+    document.querySelectorAll('table.result-table tbody tr, .result-list .result-item')
+  ).map((el) => {
+    const text = (sel) => {
+      const node = el.querySelector(sel);
+      return node ? (node.textContent || '').trim() : '';
+    };
+    return {
+      publication_number: text('.publication-number, [data-field="pubNo"]'),
+      application_number: text('.application-number, [data-field="appNo"]'),
+      title: text('.title, [data-field="title"]'),
+      applicant: text('.applicant, [data-field="applicant"]'),
+      publication_date: text('.publication-date, [data-field="pubDate"]'),
+      filing_date: text('.filing-date, [data-field="appDate"]'),
+      source_url: (el.querySelector('a[href]') || {}).href || '',
+    };
+  });
+  const html_marker = (document.body && document.body.innerText
+    ? document.body.innerText.slice(0, 200)
+    : '');
+  return { rows, html_marker };
+})()`;
+function buildSearchUrl(query, limit, offset) {
+    const params = new URLSearchParams({
+        q: query,
+        pageSize: String(limit),
+        pageNo: String(Math.floor(offset / Math.max(1, limit)) + 1),
+    });
+    return `${CNIPA_SEARCH_URL}?${params.toString()}`;
+}
+export async function runCnipaSearch(kwargs) {
+    const limit = typeof kwargs.limit === "number" && Number.isFinite(kwargs.limit)
+        ? Math.max(1, Math.min(100, Math.floor(kwargs.limit)))
+        : 25;
+    const offset = typeof kwargs.offset === "number" && Number.isFinite(kwargs.offset)
+        ? Math.max(0, Math.floor(kwargs.offset))
+        : 0;
+    const query = String(kwargs.query ?? "").trim();
+    if (query.length === 0) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_UNSUPPORTED_QUERY", ADAPTER_PATH, "validate", "cnipa search requires a non-empty query string"),
+            },
+        ];
+    }
+    const url = buildSearchUrl(query, limit, offset);
+    let extract;
+    try {
+        const result = await navigateAndExtract(url, EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: cnipaEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "mcp-browser evaluate returned no data; check selector schema in src/adapters/cnipa/search.ts"),
+                },
+            ];
+        }
+        extract = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    if (looksLikeCaptcha(extract.rows.length, extract.html_marker)) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_BROWSER_CAPTCHA", ADAPTER_PATH, "evaluate", "CNIPA returned no rows for a non-empty query; solve the 验证码 in the open browser tab and re-run", ["espacenet", "lens"]),
+            },
+        ];
+    }
+    const out = [];
+    for (const row of extract.rows.slice(0, limit)) {
+        if (!row.publication_number)
+            continue;
+        try {
+            out.push(assemblePatentRecord({
+                publication_number: row.publication_number,
+                application_number: row.application_number || undefined,
+                title: row.title || undefined,
+                assignees: row.applicant
+                    ? [{ name: row.applicant, country: "CN" }]
+                    : undefined,
+                publication_date: row.publication_date || undefined,
+                filing_date: row.filing_date || undefined,
+                source_adapter: "cnipa",
+                source_url: row.source_url || url,
+            }));
+        }
+        catch {
+            // Skip malformed row rather than synthesize — rule 02.
+        }
+    }
+    if (out.length === 0) {
+        out.push({
+            envelope: cnipaEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", "cnipa returned rows but none carried a publication_number; report as schema drift", ["espacenet"]),
+        });
+    }
+    return out;
+}
+cli({
+    site: "cnipa",
+    name: "search",
+    description: "Search CNIPA via the public 公众查询 browser interface (no API)",
+    domain: "pss-system.cponline.cnipa.gov.cn",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Free-text query — matched against title/abstract/claims",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 25,
+            description: "Maximum results to return (1-100)",
+        },
+        {
+            name: "offset",
+            type: "int",
+            default: 0,
+            description: "Result offset for pagination",
+        },
+    ],
+    columns: ["publication_number", "title", "publication_date", "source_url"],
+    capabilities: [
+        "mcp-browser.navigate",
+        "mcp-browser.evaluate",
+        "patent.search",
+    ],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runCnipaSearch(kwargs),
+});
+//# sourceMappingURL=search.js.map

package/dist/adapters/cnipa/search.js.map

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

package/dist/adapters/crossref/works.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @owner       src::adapters::crossref::works
+ * @does        Registers Crossref REST work search and DOI lookup commands for publisher metadata.
+ * @needs       api.crossref.org REST API, optional CROSSREF_MAILTO, src/registry.ts
+ * @feeds       src/commands/scholar.ts via scholar.search and scholar.get
+ * @breaks      Crossref response-shape drift or rate limiting surfaces as explicit adapter errors.
+ * @invariants  DOI lookup accepts only DOI-shaped references; output maps to ScholarlyWorkRecord.
+ * @side-effects HTTPS egress to api.crossref.org only
+ * @perf        O(limit) JSON mapping
+ * @concurrency safe
+ * @test        tests/unit/adapters/scholar-sources.test.ts
+ * @stability   experimental
+ * @since       2026-05-19
+ */
+import type { ScholarlyWorkRecord } from "../../types/scholarly.js";
+interface CrossrefPerson {
+    given?: unknown;
+    family?: unknown;
+    name?: unknown;
+}
+interface CrossrefItem {
+    DOI?: unknown;
+    title?: unknown[];
+    subtitle?: unknown[];
+    author?: CrossrefPerson[];
+    "container-title"?: unknown[];
+    issued?: {
+        "date-parts"?: unknown[][];
+    };
+    published?: {
+        "date-parts"?: unknown[][];
+    };
+    "is-referenced-by-count"?: unknown;
+    reference?: unknown[];
+    URL?: unknown;
+    type?: unknown;
+    abstract?: unknown;
+}
+export declare function requireCrossrefDoi(value: unknown): string;
+export declare function mapCrossrefItem(item: CrossrefItem, source: string): ScholarlyWorkRecord;
+export {};
+//# sourceMappingURL=works.d.ts.map

package/dist/adapters/crossref/works.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../../src/adapters/crossref/works.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpE,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;IACxC,SAAS,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;IAC3C,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA6DD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMzD;AAsBD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GACb,mBAAmB,CAoBrB"}

package/dist/adapters/crossref/works.js

@@ -0,0 +1,157 @@
+/**
+ * @owner       src::adapters::crossref::works
+ * @does        Registers Crossref REST work search and DOI lookup commands for publisher metadata.
+ * @needs       api.crossref.org REST API, optional CROSSREF_MAILTO, src/registry.ts
+ * @feeds       src/commands/scholar.ts via scholar.search and scholar.get
+ * @breaks      Crossref response-shape drift or rate limiting surfaces as explicit adapter errors.
+ * @invariants  DOI lookup accepts only DOI-shaped references; output maps to ScholarlyWorkRecord.
+ * @side-effects HTTPS egress to api.crossref.org only
+ * @perf        O(limit) JSON mapping
+ * @concurrency safe
+ * @test        tests/unit/adapters/scholar-sources.test.ts
+ * @stability   experimental
+ * @since       2026-05-19
+ */
+import { cli, Strategy } from "../../registry.js";
+const API = "https://api.crossref.org";
+function str(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function arrFirst(value) {
+    return Array.isArray(value) ? str(value[0]) : str(value);
+}
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+function dateParts(item) {
+    return (item.issued?.["date-parts"]?.[0] ??
+        item.published?.["date-parts"]?.[0] ??
+        []);
+}
+function year(item) {
+    const first = dateParts(item)[0];
+    return typeof first === "number" && Number.isFinite(first)
+        ? first
+        : undefined;
+}
+function date(item) {
+    const parts = dateParts(item).filter((part) => typeof part === "number");
+    if (parts.length === 0)
+        return undefined;
+    return [
+        String(parts[0]).padStart(4, "0"),
+        String(parts[1] ?? 1).padStart(2, "0"),
+        String(parts[2] ?? 1).padStart(2, "0"),
+    ].join("-");
+}
+function authors(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = value
+        .map((person) => str(person.name) ||
+        [person.given, person.family].map(str).filter(Boolean).join(" "))
+        .filter(Boolean);
+    return out.length > 0 ? out : undefined;
+}
+function bareDoi(value) {
+    return str(value)
+        .replace(/^doi:/i, "")
+        .replace(/^https?:\/\/(?:dx\.)?doi\.org\//i, "");
+}
+export function requireCrossrefDoi(value) {
+    const doi = bareDoi(value);
+    if (!/^10\.\S+\/\S+/.test(doi)) {
+        throw new Error(`crossref DOI "${String(value ?? "")}" is not recognised.`);
+    }
+    return doi;
+}
+function maybeMailto(params) {
+    const mailto = process.env.CROSSREF_MAILTO?.trim();
+    if (mailto)
+        params.set("mailto", mailto);
+}
+async function fetchCrossref(path, label) {
+    const response = await fetch(`${API}${path}`, {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": "unicli-crossref/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        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.json();
+}
+export function mapCrossrefItem(item, source) {
+    const doi = requireCrossrefDoi(item.DOI);
+    return {
+        id: doi,
+        title: arrFirst(item.title),
+        authors: authors(item.author),
+        year: year(item),
+        date: date(item),
+        venue: arrFirst(item["container-title"]) || undefined,
+        type: str(item.type) || undefined,
+        abstract: str(item.abstract).replace(/<[^>]+>/g, " ") || undefined,
+        doi,
+        cited_by_count: num(item["is-referenced-by-count"]),
+        references_count: Array.isArray(item.reference)
+            ? item.reference.length
+            : undefined,
+        source_adapter: source,
+        source_url: str(item.URL) || `https://doi.org/${doi}`,
+        retrieved_at: new Date().toISOString(),
+    };
+}
+cli({
+    site: "crossref",
+    name: "search",
+    description: "Search Crossref Works by title, author, DOI, or bibliographic text",
+    domain: "api.crossref.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+    ],
+    columns: ["id", "title", "authors", "year", "venue", "doi", "source_url"],
+    capabilities: ["http.fetch", "scholar.search"],
+    func: async (_page, kwargs) => {
+        const query = String(kwargs.query ?? "").trim();
+        if (!query)
+            throw new Error("crossref search query cannot be empty.");
+        const limit = Math.min(Math.max(Number(kwargs.limit ?? 20), 1), 100);
+        const params = new URLSearchParams({ query, rows: String(limit) });
+        maybeMailto(params);
+        const body = (await fetchCrossref(`/works?${params.toString()}`, "crossref search"));
+        const rows = (body.message?.items ?? []).map((item) => mapCrossrefItem(item, "crossref"));
+        if (rows.length === 0)
+            throw new Error(`No Crossref works matched "${query}".`);
+        return rows;
+    },
+});
+cli({
+    site: "crossref",
+    name: "work",
+    description: "Fetch one Crossref Work by DOI",
+    domain: "api.crossref.org",
+    strategy: Strategy.PUBLIC,
+    args: [{ name: "doi", type: "str", required: true, positional: true }],
+    columns: ["id", "title", "authors", "year", "venue", "doi", "source_url"],
+    capabilities: ["http.fetch", "scholar.get"],
+    func: async (_page, kwargs) => {
+        const doi = requireCrossrefDoi(kwargs.doi ?? kwargs.id ?? kwargs.ref);
+        const params = new URLSearchParams();
+        maybeMailto(params);
+        const suffix = params.size > 0 ? `?${params.toString()}` : "";
+        const body = (await fetchCrossref(`/works/${encodeURIComponent(doi)}${suffix}`, `crossref work ${doi}`));
+        if (!body.message)
+            throw new Error(`Crossref returned no work for ${doi}.`);
+        return [mapCrossrefItem(body.message, "crossref")];
+    },
+});
+//# sourceMappingURL=works.js.map

package/dist/adapters/crossref/works.js.map

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

package/dist/adapters/cvf/papers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @owner       src::adapters::cvf::papers
+ * @does        Registers CVF OpenAccess conference paper search for CVPR/ICCV/ECCV-style proceedings pages.
+ * @needs       openaccess.thecvf.com static proceedings HTML, src/registry.ts
+ * @feeds       src/commands/scholar.ts via scholar.search, scholar.pdf, and scholar.venue
+ * @breaks      CVF markup drift surfaces as empty/parse errors rather than non-CVF fallbacks.
+ * @invariants  Venue/year map to explicit CVF event pages; PDF URLs are absolutized against openaccess.thecvf.com.
+ * @side-effects HTTPS egress to openaccess.thecvf.com only
+ * @perf        O(N) over one proceedings HTML page
+ * @concurrency safe
+ * @test        tests/unit/adapters/scholar-sources.test.ts
+ * @stability   experimental
+ * @since       2026-05-19
+ */
+import type { ScholarlyWorkRecord } from "../../types/scholarly.js";
+export declare function parseCvfRows(html: string, event?: string): ScholarlyWorkRecord[];
+//# sourceMappingURL=papers.d.ts.map

package/dist/adapters/cvf/papers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"papers.d.ts","sourceRoot":"","sources":["../../../src/adapters/cvf/papers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAgCpE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,SAAa,GACjB,mBAAmB,EAAE,CAmCvB"}