@zenalexa/unicli 0.225.2 → 0.225.3

package/AGENTS.md

@@ -36,7 +36,7 @@ it starts only the Uni-CLI automation profile.
 
 <!-- BEGIN COUNTS -->
 
-> <!-- STATS:site_count -->317<!-- /STATS --> sites, <!-- STATS:command_count -->1772<!-- /STATS --> commands, <!-- STATS:pipeline_step_count -->103<!-- /STATS --> pipeline steps, BM25 bilingual search. `npm install -g @zenalexa/unicli`
+> <!-- STATS:site_count -->320<!-- /STATS --> sites, <!-- STATS:command_count -->1798<!-- /STATS --> commands, <!-- STATS:pipeline_step_count -->103<!-- /STATS --> pipeline steps, BM25 bilingual search. `npm install -g @zenalexa/unicli`
 
 <!-- END COUNTS -->
 
@@ -128,7 +128,7 @@ allowlist entry without a one-line `// REASON:` justification in
 
 ## Version
 
-0.225.2 — Apollo · Gordon
+0.225.3 — Apollo · Schmitt
 
 ## MCP one-liner (Claude Desktop / Cursor / Continue)
 

package/README.md

@@ -41,7 +41,7 @@
 </p>
 
 <p align="center">
-  <sub>Native CLI · MCP · ACP · JSON/Markdown envelopes · browser CDP · visual fallback · macOS desktop AX · <!-- STATS:site_count -->317<!-- /STATS --> surfaces · <!-- STATS:test_count -->9181<!-- /STATS --> tests</sub>
+  <sub>Native CLI · MCP · ACP · JSON/Markdown envelopes · browser CDP · visual fallback · macOS desktop AX · <!-- STATS:site_count -->320<!-- /STATS --> surfaces · <!-- STATS:test_count -->9255<!-- /STATS --> tests</sub>
 </p>
 
 <p align="center">
@@ -340,7 +340,7 @@ The wall below is generated from active manifest sites with real logo support. B
   <a data-site="replicate" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="replicate: 2 commands"><img alt="replicate" src="https://img.shields.io/static/v1?label=replicate&message=2+cmds&color=7c3aed&style=flat-square&logo=replicate&logoColor=white"></a>
 </p>
 <p><strong>scholarly</strong><br>
-  <a data-site="arxiv" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="arxiv: 5 commands"><img alt="arxiv" src="https://img.shields.io/static/v1?label=arxiv&message=5+cmds&color=0f766e&style=flat-square&logo=arxiv&logoColor=white"></a>
+  <a data-site="arxiv" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="arxiv: 6 commands"><img alt="arxiv" src="https://img.shields.io/static/v1?label=arxiv&message=6+cmds&color=0f766e&style=flat-square&logo=arxiv&logoColor=white"></a>
   <a data-site="google-scholar" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="google-scholar: 3 commands"><img alt="google-scholar" src="https://img.shields.io/static/v1?label=google-scholar&message=3+cmds&color=0f766e&style=flat-square&logo=google&logoColor=white"></a>
   <a data-site="huggingface-papers" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="huggingface-papers: 2 commands"><img alt="huggingface-papers" src="https://img.shields.io/static/v1?label=huggingface-papers&message=2+cmds&color=0f766e&style=flat-square&logo=huggingface&logoColor=white"></a>
   <a data-site="zotero" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="zotero: 8 commands"><img alt="zotero" src="https://img.shields.io/static/v1?label=zotero&message=8+cmds&color=0f766e&style=flat-square&logo=zotero&logoColor=white"></a>
@@ -552,5 +552,5 @@ npm run verify
 [Apache-2.0](./LICENSE)
 
 <p align="center">
-  <sub>v0.225.2 — Apollo · Gordon</sub>
+  <sub>v0.225.3 — Apollo · Schmitt</sub>
 </p>

package/README.zh-CN.md

@@ -40,7 +40,7 @@
 </p>
 
 <p align="center">
-  <sub>Native CLI · MCP · ACP · JSON/Markdown envelope · browser CDP · visual fallback · macOS desktop AX · <!-- STATS:site_count -->317<!-- /STATS --> 个 surface · <!-- STATS:test_count -->9181<!-- /STATS --> 个测试</sub>
+  <sub>Native CLI · MCP · ACP · JSON/Markdown envelope · browser CDP · visual fallback · macOS desktop AX · <!-- STATS:site_count -->320<!-- /STATS --> 个 surface · <!-- STATS:test_count -->9255<!-- /STATS --> 个测试</sub>
 </p>
 
 <p align="center">
@@ -299,7 +299,7 @@ ACP 作为编辑器和桥接兼容层保留。真正跑任务时，优先 native
   <a data-site="replicate" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="replicate: 2 commands"><img alt="replicate" src="https://img.shields.io/static/v1?label=replicate&message=2+cmds&color=7c3aed&style=flat-square&logo=replicate&logoColor=white"></a>
 </p>
 <p><strong>学术</strong><br>
-  <a data-site="arxiv" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="arxiv: 5 commands"><img alt="arxiv" src="https://img.shields.io/static/v1?label=arxiv&message=5+cmds&color=0f766e&style=flat-square&logo=arxiv&logoColor=white"></a>
+  <a data-site="arxiv" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="arxiv: 6 commands"><img alt="arxiv" src="https://img.shields.io/static/v1?label=arxiv&message=6+cmds&color=0f766e&style=flat-square&logo=arxiv&logoColor=white"></a>
   <a data-site="google-scholar" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="google-scholar: 3 commands"><img alt="google-scholar" src="https://img.shields.io/static/v1?label=google-scholar&message=3+cmds&color=0f766e&style=flat-square&logo=google&logoColor=white"></a>
   <a data-site="huggingface-papers" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="huggingface-papers: 2 commands"><img alt="huggingface-papers" src="https://img.shields.io/static/v1?label=huggingface-papers&message=2+cmds&color=0f766e&style=flat-square&logo=huggingface&logoColor=white"></a>
   <a data-site="zotero" href="https://olo-dot-io.github.io/Uni-CLI/reference/sites" title="zotero: 8 commands"><img alt="zotero" src="https://img.shields.io/static/v1?label=zotero&message=8+cmds&color=0f766e&style=flat-square&logo=zotero&logoColor=white"></a>
@@ -496,5 +496,5 @@ npm run verify
 [Apache-2.0](./LICENSE)
 
 <p align="center">
-  <sub>v0.225.2 — Apollo · Gordon</sub>
+  <sub>v0.225.3 — Apollo · Schmitt</sub>
 </p>

package/dist/adapters/acl-anthology/papers.d.ts

@@ -1,16 +1,23 @@
 /**
  * @owner       src::adapters::acl-anthology::papers
- * @does        Registers ACL Anthology paper search and event proceedings listing from official Anthology pages.
- * @needs       aclanthology.org static search/event HTML, src/registry.ts
- * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, and scholar.venue
- * @breaks      ACL Anthology markup drift surfaces as empty parse output; no browser workaround is used.
- * @invariants  Paper URLs/PDF URLs are absolutized against aclanthology.org; event keys are explicit.
- * @side-effects HTTPS egress to aclanthology.org only
- * @perf        O(N) over one HTML response
+ * @does        Registers ACL Anthology paper search, metadata lookup, PDF download, and PDF text-read commands from official Anthology pages.
+ * @needs       aclanthology.org static search/paper HTML, scholar-artifacts PDF reader, src/registry.ts
+ * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, scholar.fulltext, and scholar.venue
+ * @breaks      ACL Anthology markup drift, denied PDF downloads, missing pdftotext, or empty PDF text surfaces as source read failure.
+ * @invariants  Paper URLs/PDF URLs are absolutized against aclanthology.org; read output labels `text_source=pdf`.
+ * @side-effects HTTPS egress to aclanthology.org; read writes PDFs under the requested output directory and executes pdftotext.
+ * @perf        O(N) over one HTML response for search; O(PDF bytes + extracted pages) for read.
  * @concurrency safe
- * @test        covered by scholar command discovery and parser style tests for sibling proceedings sources
+ * @test        src/adapters/acl-anthology/papers.test.ts, tests/unit/adapters/scholar-sources.test.ts
  * @stability   experimental
  * @since       2026-05-19
  */
-export {};
+import type { ScholarlyWorkRecord } from "../../types/scholarly.js";
+export declare function cleanAclHtml(value: string): string;
+export declare function normalizeAclAnthologyId(value: unknown): string;
+export declare function aclAnthologyPdfUrl(id: string): string;
+export declare function parseAclBibEntries(bib: string): ScholarlyWorkRecord[];
+export declare function searchAclBibRows(rows: readonly ScholarlyWorkRecord[], query: string, limit: number): ScholarlyWorkRecord[];
+export declare function requireAclReadPageArgs(kwargs: Record<string, unknown>): Record<string, unknown>;
+export declare function aclArtifactFilename(record: ScholarlyWorkRecord): string;
 //# sourceMappingURL=papers.d.ts.map

package/dist/adapters/acl-anthology/papers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"papers.d.ts","sourceRoot":"","sources":["../../../src/adapters/acl-anthology/papers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"papers.d.ts","sourceRoot":"","sources":["../../../src/adapters/acl-anthology/papers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAkBpE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAUD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU9D;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAErD;AAwCD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CA8BrE;AA8BD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,mBAAmB,EAAE,EACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,mBAAmB,EAAE,CAWvB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAKvE"}

package/dist/adapters/acl-anthology/papers.js

@@ -1,19 +1,27 @@
 /**
  * @owner       src::adapters::acl-anthology::papers
- * @does        Registers ACL Anthology paper search and event proceedings listing from official Anthology pages.
- * @needs       aclanthology.org static search/event HTML, src/registry.ts
- * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, and scholar.venue
- * @breaks      ACL Anthology markup drift surfaces as empty parse output; no browser workaround is used.
- * @invariants  Paper URLs/PDF URLs are absolutized against aclanthology.org; event keys are explicit.
- * @side-effects HTTPS egress to aclanthology.org only
- * @perf        O(N) over one HTML response
+ * @does        Registers ACL Anthology paper search, metadata lookup, PDF download, and PDF text-read commands from official Anthology pages.
+ * @needs       aclanthology.org static search/paper HTML, scholar-artifacts PDF reader, src/registry.ts
+ * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, scholar.fulltext, and scholar.venue
+ * @breaks      ACL Anthology markup drift, denied PDF downloads, missing pdftotext, or empty PDF text surfaces as source read failure.
+ * @invariants  Paper URLs/PDF URLs are absolutized against aclanthology.org; read output labels `text_source=pdf`.
+ * @side-effects HTTPS egress to aclanthology.org; read writes PDFs under the requested output directory and executes pdftotext.
+ * @perf        O(N) over one HTML response for search; O(PDF bytes + extracted pages) for read.
  * @concurrency safe
- * @test        covered by scholar command discovery and parser style tests for sibling proceedings sources
+ * @test        src/adapters/acl-anthology/papers.test.ts, tests/unit/adapters/scholar-sources.test.ts
  * @stability   experimental
  * @since       2026-05-19
  */
+import { execFile } from "node:child_process";
+import { join, resolve } from "node:path";
+import { promisify } from "node:util";
+import { gunzipSync } from "node:zlib";
 import { cli, Strategy } from "../../registry.js";
+import { httpDownload, sanitizeFilename } from "../../engine/download.js";
 const ORIGIN = "https://aclanthology.org";
+const ANTHOLOGY_BIB_URL = `${ORIGIN}/anthology.bib.gz`;
+const execFileAsync = promisify(execFile);
+let anthologyBibCache;
 function decode(value) {
     return value
         .replace(/&/g, "&")
@@ -24,48 +32,178 @@ function decode(value) {
         .replace(/\s+/g, " ")
         .trim();
 }
-function absolute(path) {
-    return /^https?:\/\//i.test(path)
-        ? path
-        : `${ORIGIN}${path.startsWith("/") ? "" : "/"}${path}`;
+export function cleanAclHtml(value) {
+    return decode(value.replace(/<[^>]+>/g, ""));
 }
-function normalizeId(value) {
-    const raw = String(value ?? "").trim();
+function normalizeSearchText(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function normalizeAclAnthologyId(value) {
+    const raw = String(value ?? "")
+        .trim()
+        .replace(/^https?:\/\/(?:www\.)?aclanthology\.org\//i, "")
+        .replace(/\.pdf$/i, "")
+        .replace(/\/$/i, "");
     if (!/^[A-Za-z0-9.-]+$/.test(raw)) {
-        throw new Error(`ACL Anthology id "${raw}" is not valid.`);
+        throw new Error(`ACL Anthology id "${String(value ?? "")}" is not valid.`);
     }
     return raw.replace(/\.$/, "");
 }
-function parseRows(html, source = "acl-anthology") {
-    const out = [];
-    const re = /<p class="d-sm-flex[^"]*">[\s\S]*?<a[^>]+href="([^"]+)"[^>]*>([\s\S]*?)<\/a>([\s\S]*?)(?=<p class="d-sm-flex|$)/g;
+export function aclAnthologyPdfUrl(id) {
+    return `${ORIGIN}/${id}.pdf`;
+}
+function cleanBibValue(value) {
+    return decode(value
+        .trim()
+        .replace(/,$/, "")
+        .replace(/^["{]|["}]$/g, "")
+        .replace(/\\"/g, '"')
+        .replace(/\\&/g, "&")
+        .replace(/\\url\{([^}]+)\}/g, "$1")
+        .replace(/\\[a-zA-Z]+\{([^}]*)\}/g, "$1")
+        .replace(/[{}]/g, "")
+        .replace(/\s+/g, " "));
+}
+function normalizeBibAuthors(value) {
+    const authors = cleanBibValue(value)
+        .split(/\s+and\s+/)
+        .map((author) => {
+        const parts = author.split(/\s*,\s*/);
+        return parts.length === 2 ? `${parts[1]} ${parts[0]}` : author;
+    })
+        .map((author) => author.trim())
+        .filter(Boolean);
+    return authors.length > 0 ? authors.slice(0, 20) : undefined;
+}
+function parseBibFields(entry) {
+    const fields = {};
+    const re = /^\s*([A-Za-z][A-Za-z0-9_-]*)\s*=\s*([\s\S]*?)(?=,\n\s*[A-Za-z][A-Za-z0-9_-]*\s*=|\n}\s*$)/gm;
     let match;
-    while ((match = re.exec(html)) !== null) {
-        const sourceUrl = absolute(match[1]);
-        const id = sourceUrl.replace(`${ORIGIN}/`, "").replace(/\/$/, "");
-        const block = match[3];
-        const pdf = block.match(/href="([^"]+\.pdf)"/i)?.[1] ?? "";
-        const authorText = block
-            .replace(/<span class="d-block">[\s\S]*?<\/span>/g, " ")
-            .replace(/<[^>]+>/g, " ");
-        const authors = decode(authorText)
-            .split(/,\s*/)
-            .map((author) => author.trim())
-            .filter(Boolean)
-            .slice(0, 20);
-        out.push({
+    while ((match = re.exec(entry)) !== null) {
+        fields[match[1].toLowerCase()] = match[2];
+    }
+    return fields;
+}
+export function parseAclBibEntries(bib) {
+    const rows = [];
+    for (const entry of bib.split(/\n(?=@[A-Za-z]+\{)/)) {
+        const header = entry.match(/^@([A-Za-z]+)\{([^,]+),/);
+        if (!header)
+            continue;
+        const fields = parseBibFields(entry);
+        const title = fields.title ? cleanBibValue(fields.title) : "";
+        const sourceUrl = fields.url ? cleanBibValue(fields.url) : "";
+        const id = sourceUrl
+            ? normalizeAclAnthologyId(sourceUrl)
+            : normalizeAclAnthologyId(header[2]);
+        if (!title || !id)
+            continue;
+        const year = fields.year ? Number(cleanBibValue(fields.year)) : undefined;
+        const doi = fields.doi ? cleanBibValue(fields.doi) : undefined;
+        rows.push({
             id,
-            title: decode(match[2].replace(/<[^>]+>/g, " ")),
-            authors: authors.length > 0 ? authors : undefined,
-            year: Number(id.slice(0, 4)) || undefined,
-            venue: "ACL Anthology",
-            pdf_url: pdf ? absolute(pdf) : `${sourceUrl}.pdf`,
-            source_adapter: source,
-            source_url: sourceUrl,
+            title,
+            authors: fields.author ? normalizeBibAuthors(fields.author) : undefined,
+            year: Number.isInteger(year) ? year : undefined,
+            venue: fields.booktitle
+                ? cleanBibValue(fields.booktitle)
+                : "ACL Anthology",
+            doi,
+            pdf_url: aclAnthologyPdfUrl(id),
+            source_adapter: "acl-anthology",
+            source_url: `${ORIGIN}/${id}/`,
             retrieved_at: new Date().toISOString(),
         });
     }
-    return out;
+    return rows;
+}
+function scoreAclBibRow(row, query) {
+    const normalizedQuery = normalizeSearchText(query);
+    const terms = normalizedQuery.split(" ").filter(Boolean);
+    const title = normalizeSearchText(row.title);
+    const authors = normalizeSearchText((row.authors ?? []).join(" "));
+    const haystack = normalizeSearchText([
+        row.id,
+        row.title,
+        row.venue,
+        row.year,
+        row.doi,
+        (row.authors ?? []).join(" "),
+    ]
+        .filter(Boolean)
+        .join(" "));
+    if (!normalizedQuery || !terms.every((term) => haystack.includes(term))) {
+        return 0;
+    }
+    let score = 10;
+    if (row.id.toLowerCase() === normalizedQuery)
+        score += 100;
+    if (title === normalizedQuery)
+        score += 80;
+    if (title.includes(normalizedQuery))
+        score += 40;
+    if (authors.includes(normalizedQuery))
+        score += 20;
+    return score + Math.min(Number(row.year ?? 0) / 10_000, 1);
+}
+export function searchAclBibRows(rows, query, limit) {
+    return rows
+        .map((row, index) => ({
+        row,
+        index,
+        score: scoreAclBibRow(row, query),
+    }))
+        .filter((candidate) => candidate.score > 0)
+        .sort((a, b) => b.score - a.score || a.index - b.index)
+        .slice(0, limit)
+        .map((candidate) => candidate.row);
+}
+export function requireAclReadPageArgs(kwargs) {
+    return {
+        first_page: kwargs["first-page"] ?? kwargs.firstPage,
+        last_page: kwargs["last-page"] ?? kwargs.lastPage,
+        max_chars: kwargs["max-chars"] ?? kwargs.maxChars,
+    };
+}
+export function aclArtifactFilename(record) {
+    const title = sanitizeFilename(String(record.title ?? ""))
+        .replace(/\s+/g, "_")
+        .slice(0, 96);
+    return `${sanitizeFilename(record.id)}${title ? `-${title}` : ""}.pdf`;
+}
+function requireAclPageRange(firstPage, lastPage) {
+    const first = Number(firstPage ?? 1);
+    const last = Number(lastPage ?? 20);
+    if (!Number.isInteger(first) || first < 1) {
+        throw new Error("acl-anthology first-page must be an integer >= 1.");
+    }
+    if (!Number.isInteger(last) || last < first) {
+        throw new Error("acl-anthology last-page must be an integer >= first-page.");
+    }
+    return { firstPage: first, lastPage: last };
+}
+function requireAclMaxChars(value, fallback = 40_000) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1_000 || n > 1_000_000) {
+        throw new Error(`acl-anthology max-chars must be an integer in [1000, 1000000]. Got: ${String(value)}`);
+    }
+    return n;
+}
+function truncateAclText(text, maxChars) {
+    if (text.length <= maxChars) {
+        return { text, truncated: false, originalChars: text.length };
+    }
+    return {
+        text: `${text.slice(0, maxChars).trimEnd()}\n\n[truncated at ${maxChars} characters]`,
+        truncated: true,
+        originalChars: text.length,
+    };
 }
 async function fetchHtml(url, label) {
     const response = await fetch(url, {
@@ -80,6 +218,78 @@ async function fetchHtml(url, label) {
         throw new Error(`${label} returned HTTP ${response.status}.`);
     return response.text();
 }
+async function fetchAnthologyBib() {
+    anthologyBibCache ??= (async () => {
+        const response = await fetch(ANTHOLOGY_BIB_URL, {
+            headers: {
+                Accept: "application/x-gzip, application/gzip, */*",
+                "User-Agent": "unicli-acl-anthology/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+            },
+        });
+        if (!response.ok)
+            throw new Error(`ACL Anthology BibTeX returned HTTP ${response.status}.`);
+        return gunzipSync(Buffer.from(await response.arrayBuffer())).toString("utf8");
+    })();
+    return anthologyBibCache;
+}
+async function fetchAclPaperRecord(id) {
+    const html = await fetchHtml(`${ORIGIN}/${id}/`, `acl-anthology paper ${id}`);
+    const title = cleanAclHtml(html.match(/<h2[^>]*id=title[^>]*>([\s\S]*?)<\/h2>/)?.[1] ?? "");
+    if (!title)
+        throw new Error(`ACL Anthology paper ${id} did not expose a title.`);
+    return {
+        id,
+        title,
+        year: Number(id.slice(0, 4)) || undefined,
+        venue: "ACL Anthology",
+        pdf_url: aclAnthologyPdfUrl(id),
+        source_adapter: "acl-anthology",
+        source_url: `${ORIGIN}/${id}/`,
+        retrieved_at: new Date().toISOString(),
+    };
+}
+async function readAclPaperPdf(record, kwargs) {
+    if (!record.pdf_url) {
+        throw new Error(`ACL Anthology paper ${record.id} did not expose a PDF.`);
+    }
+    const outputDir = resolve(String(kwargs.output ?? "./acl-anthology-downloads"));
+    const path = join(outputDir, aclArtifactFilename(record));
+    const download = await httpDownload(record.pdf_url, path, {
+        Accept: "application/pdf,*/*",
+        Referer: record.source_url ?? `${ORIGIN}/${record.id}/`,
+        "User-Agent": "unicli-acl-anthology/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+    });
+    if (download.status === "failed" || !download.path) {
+        throw new Error(`ACL Anthology PDF download failed for ${record.id}: ${download.error ?? "no path"}.`);
+    }
+    const pageArgs = requireAclReadPageArgs(kwargs);
+    const { firstPage, lastPage } = requireAclPageRange(pageArgs.first_page, pageArgs.last_page);
+    const maxChars = requireAclMaxChars(pageArgs.max_chars);
+    const { stdout } = await execFileAsync("pdftotext", [
+        "-layout",
+        "-enc",
+        "UTF-8",
+        "-f",
+        String(firstPage),
+        "-l",
+        String(lastPage),
+        download.path,
+        "-",
+    ], { timeout: 60_000, maxBuffer: 10 * 1024 * 1024 });
+    const extracted = stdout.trim();
+    if (!extracted) {
+        throw new Error(`pdftotext returned no text for ACL Anthology ${record.id} pages ${firstPage}-${lastPage}.`);
+    }
+    const truncated = truncateAclText(extracted, maxChars);
+    return {
+        ...record,
+        path: download.path,
+        text: truncated.text,
+        text_chars: truncated.originalChars,
+        text_truncated: truncated.truncated,
+        text_source: "pdf",
+    };
+}
 cli({
     site: "acl-anthology",
     name: "search",
@@ -97,7 +307,7 @@ cli({
         if (!query)
             throw new Error("acl-anthology search query cannot be empty.");
         const limit = Math.min(Math.max(Number(kwargs.limit ?? 20), 1), 100);
-        const rows = parseRows(await fetchHtml(`${ORIGIN}/search/?q=${encodeURIComponent(query)}`, "acl-anthology search")).slice(0, limit);
+        const rows = searchAclBibRows(parseAclBibEntries(await fetchAnthologyBib()), query, limit);
         if (rows.length === 0)
             throw new Error(`No ACL Anthology papers matched "${query}".`);
         return rows;
@@ -113,23 +323,77 @@ cli({
     columns: ["id", "title", "authors", "year", "venue", "pdf_url", "source_url"],
     capabilities: ["http.fetch", "scholar.get", "scholar.pdf"],
     func: async (_page, kwargs) => {
-        const id = normalizeId(kwargs.id ?? kwargs.ref);
-        const html = await fetchHtml(`${ORIGIN}/${id}/`, `acl-anthology paper ${id}`);
-        const title = decode(html.match(/<h2[^>]*id=title[^>]*>([\s\S]*?)<\/h2>/)?.[1] ?? "");
-        if (!title)
-            throw new Error(`ACL Anthology paper ${id} did not expose a title.`);
-        return [
-            {
-                id,
-                title,
-                year: Number(id.slice(0, 4)) || undefined,
-                venue: "ACL Anthology",
-                pdf_url: `${ORIGIN}/${id}.pdf`,
-                source_adapter: "acl-anthology",
-                source_url: `${ORIGIN}/${id}/`,
-                retrieved_at: new Date().toISOString(),
-            },
-        ];
+        const id = normalizeAclAnthologyId(kwargs.id ?? kwargs.ref);
+        return [await fetchAclPaperRecord(id)];
+    },
+});
+cli({
+    site: "acl-anthology",
+    name: "read",
+    description: "Download an ACL Anthology paper PDF by id and extract text",
+    domain: "aclanthology.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "ACL Anthology paper id (e.g. 2020.acl-main.447)",
+            "x-unicli-kind": "id",
+            "x-unicli-accepts": ["url"],
+        },
+        {
+            name: "output",
+            type: "str",
+            default: "./acl-anthology-downloads",
+            description: "Output directory",
+            "x-unicli-kind": "path",
+        },
+        {
+            name: "first-page",
+            type: "int",
+            default: 1,
+            description: "First PDF page to extract",
+        },
+        {
+            name: "last-page",
+            type: "int",
+            default: 20,
+            description: "Last PDF page to extract",
+        },
+        {
+            name: "max-chars",
+            type: "int",
+            default: 40000,
+            description: "Maximum extracted text characters",
+        },
+    ],
+    columns: [
+        "id",
+        "title",
+        "source_adapter",
+        "source_url",
+        "pdf_url",
+        "path",
+        "text_source",
+        "text",
+        "text_chars",
+        "text_truncated",
+    ],
+    capabilities: [
+        "http.fetch",
+        "http.download",
+        "subprocess.exec",
+        "scholar.fulltext",
+        "scholar.pdf",
+    ],
+    executables: ["pdftotext"],
+    minimum_capability: "subprocess.exec",
+    func: async (_page, kwargs) => {
+        const id = normalizeAclAnthologyId(kwargs.id ?? kwargs.ref);
+        const record = await fetchAclPaperRecord(id);
+        return [await readAclPaperPdf(record, kwargs)];
     },
 });
 //# sourceMappingURL=papers.js.map

package/dist/adapters/acl-anthology/papers.js.map

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

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

@@ -1,9 +1,16 @@
 /**
  * @owner   src/adapters/arxiv/papers.ts
- * @does    Register agent-facing arXiv author and recent category commands.
- * @needs   export.arxiv.org Atom API, category validation, conservative XML parsing.
- * @feeds   surface coverage ledger, scholarly search workflow, arXiv category monitoring.
- * @breaks  arXiv Atom shape drift, weak category parsing, or silent empty feeds hide paper discovery failures.
+ * @does    Register agent-facing arXiv author, recent category, and PDF text-read commands.
+ * @needs   export.arxiv.org Atom API, arxiv.org PDF URLs, category/id validation, conservative XML parsing, pdftotext.
+ * @feeds   surface coverage ledger, scholarly search/read workflow, arXiv category monitoring.
+ * @breaks  arXiv Atom/PDF shape drift, weak category/id parsing, denied PDF downloads, missing pdftotext, or silent empty feeds hide paper discovery/read failures.
+ * @invariants  arXiv ids are normalized before URL construction; read returns PDF-derived text only and labels `text_source=pdf`.
+ * @side-effects HTTPS egress to export.arxiv.org and arxiv.org; read writes PDFs under the requested output directory and executes pdftotext.
+ * @perf        O(limit) for Atom discovery; O(PDF bytes + extracted pages) for read.
+ * @concurrency safe - per-command local state only
+ * @test        src/adapters/arxiv/papers.test.ts, tests/unit/commands/scholar.test.ts
+ * @stability   experimental
+ * @since       0.225.2
  */
 interface ArxivEntry {
     id: string;
@@ -20,8 +27,19 @@ interface ArxivEntry {
 }
 export declare function requireArxivLimit(value: unknown, fallback: number, max?: number): number;
 export declare function requireArxivAuthor(value: unknown): string;
+export declare function normalizeArxivId(value: unknown): string;
 export declare function requireArxivCategory(value: unknown): string;
 export declare function decodeArxivEntities(value: string): string;
 export declare function parseArxivEntries(xml: string): ArxivEntry[];
+export declare function arxivArtifactFilename(input: {
+    id: string;
+    title?: unknown;
+}): string;
+export declare function requireArxivPageRange(firstPage: unknown, lastPage: unknown): {
+    firstPage: number;
+    lastPage: number;
+};
+export declare function requireArxivMaxChars(value: unknown, fallback?: number): number;
+export declare function readArxivPaper(kwargs: Record<string, unknown>): Promise<Record<string, unknown>>;
 export {};
 //# sourceMappingURL=papers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"papers.d.ts","sourceRoot":"","sources":["../../../src/adapters/arxiv/papers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,SAAK,GACP,MAAM,CAOR;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIzD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM3D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzD;AAwCD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAgC3D"}
+{"version":3,"file":"papers.d.ts","sourceRoot":"","sources":["../../../src/adapters/arxiv/papers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,SAAK,GACP,MAAM,CAOR;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIzD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYvD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM3D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzD;AAwCD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAgC3D;AAiCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,MAAM,CAQT;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAUzC;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAS,GAChB,MAAM,CASR;AA4BD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0ElC"}