amenbo 0.1.5 → 0.3.0

package/README.en.md

@@ -37,7 +37,12 @@ For a measured comparison against similar tools (official fetch MCP / Jina Reade
 
 ```bash
 npm install -g amenbo
-# postinstall downloads Chromium (for SPA rendering & screenshots)
+```
+
+That's enough for plain Markdown fetching (`fetch` / `links`). If you also want browser-based fetching — SPA escalation or screenshots — run this once (a ~170MB download the first time):
+
+```bash
+npx -y amenbo install-browser
 ```
 
 Or for development:
@@ -165,6 +170,11 @@ Discovery order: sitemap → RSS/Atom → in-page links.
 - **SSRF protection**: rejects non-http/https schemes (`file:`, `ftp:`, etc.). Rejects DNS-resolved destinations that are private / loopback / link-local / reserved addresses. As a DNS rebinding (TOCTOU) countermeasure, actual connections are pinned to the validated IP
 - **Body size cap**: prevents OOM from oversized responses
 
+## Known limitations
+
+- **No HTTP proxy support**: `HTTP_PROXY` / `HTTPS_PROXY` environment variables are not honored. As an SSRF countermeasure, connections are pinned to a validated IP (DNS rebinding protection), which is incompatible with delegating name resolution to an upstream proxy. Networks that require an upstream proxy are currently unsupported
+- **No anti-bot circumvention**: fetch failures due to robots.txt denial or bot countermeasures are by design and reported as-is (see [Low impact on target sites](#low-impact-on-target-sites))
+
 ## Development
 
 ```bash

package/README.md

@@ -37,7 +37,12 @@ amenbo(アメンボ / water strider)は、Claude Code や Codex のようなコ
 
 ```bash
 npm install -g amenbo
-# postinstall で Chromium が入ります(SPA描画・スクリーンショット用)
+```
+
+Markdown 取得(通常の `fetch` / `links`)はこれだけで動きます。JS 描画が必要な SPA への昇格やスクリーンショットなど、ブラウザ(Chromium)経由の取得を使う場合のみ、初回に一度だけ実行してください(約 170MB のダウンロード):
+
+```bash
+npx -y amenbo install-browser
 ```
 
 または開発用途:
@@ -160,6 +165,11 @@ sitemap → RSS/Atom → ページ内リンクの順で探索します。
 - **SSRF 対策**：http/https 以外のスキーム(`file:`, `ftp:` 等)を拒否。DNS 解決した接続先が private / loopback / link-local / 予約アドレスなら拒否。DNS rebinding(TOCTOU)対策として実接続を検証済み IP に固定します
 - **ボディサイズ上限**：巨大レスポンスによる OOM を防止
 
+## 既知の制限
+
+- **HTTP プロキシ非対応**：`HTTP_PROXY` / `HTTPS_PROXY` 等の環境変数は尊重しません。SSRF 対策として接続先を検証済み IP に固定する設計(DNS rebinding 対策)と、プロキシへ名前解決を委ねる方式が両立しないためです。上流プロキシ必須のネットワークでは現状ご利用いただけません
+- **anti-bot 回避は実装しません**：robots.txt 拒否やボット対策による取得失敗は仕様です。失敗はそのまま報告します([収集先への低負荷](#収集先への低負荷)参照)
+
 ## 開発
 
 ```bash

package/dist/cache.d.ts

@@ -17,6 +17,7 @@ export interface CacheWriteInput {
     markdown: string;
     metadata: Record<string, unknown>;
 }
+export declare function resolveCacheDir(): string;
 export declare function hashContent(content: string): string;
 /** スクリーンショットのキャッシュキー(url+撮影パラメータの組)を計算する。 */
 export declare function computeScreenshotCacheKey(url: string, width: number, scale: number, fullPage: boolean): string;
@@ -38,14 +39,31 @@ export declare class PageCache {
     private readonly cacheDir;
     private readonly ttlMs;
     private readonly now;
+    private readonly statements;
+    private closed;
     constructor(options?: {
         dbPath?: string;
         cacheDir?: string;
         ttlMs?: number;
         now?: () => number;
     });
+    /** 全SQL文を一度だけprepareする(DDL適用後・prune前に呼ぶ)。 */
+    private prepareStatements;
     /**
-     * M3: TTL超過エントリを削除する(ディスク無制限増加の防止)。起動時に自動実行される。
+     * 前回pruneからTTL未満なら掃除を間引く。
+     *
+     * 起動のたびにpruneExpired(複数テーブルのDELETE+screenshots走査)を実行すると、CLIの
+     * 1コマンド=1プロセスでのバルク収集ループで毎回のプロセス起動に掃除コストが乗る。
+     * prune直後のTTL窓ではほとんど新規失効が無いため、前回pruneからの経過がTTL未満なら
+     * skipする(掃除間隔がTTL単位まで粗くなるだけで、ディスク無制限増加の防止という
+     * M3の目的は維持される。失効エントリの残留は最大でも約2×TTLに収まる)。
+     * meta未記録(新規DB/初回起動)では必ず実行するため、起動時掃除のテストは従来通り成立する。
+     */
+    private maybePruneExpired;
+    /** meta テーブルの単一整数値を返す(未記録ならnull)。 */
+    private getMetaValue;
+    /**
+     * M3: TTL超過エントリを削除する(ディスク無制限増加の防止)。maybePruneExpired経由で呼ばれる。
      * screenshotsはSQLite行に加え、対応するPNGファイル(タイル)もあわせて削除する。
      */
     private pruneExpired;
@@ -57,7 +75,16 @@ export declare class PageCache {
     }): boolean;
     /** 保存済みスクリーンショットエントリを取得する(TTL判定は isFresh を使う)。 */
     getScreenshot(cacheKey: string): ScreenshotCacheEntry | undefined;
-    /** スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。 */
+    /**
+     * スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。
+     *
+     * レビュー指摘対応(Medium): 同一cacheKeyへの再撮影でタイル数が減った場合(旧5枚→新3枚)、
+     * 新しいtile_pathsで上書きされるDB行からは旧tile-3.png/tile-4.pngを参照できなくなり、
+     * pruneExpiredもそれらを認識できず孤立ファイルとしてディスクに残り続けていた。
+     * tileDirはcacheKey単位のディレクトリ(他のcacheKeyのタイルと混在しない)のため、
+     * 書き込み前にディレクトリごと削除してから作り直すことで、枚数が変化しても
+     * 旧タイルを確実に一掃する(初回撮影時はディレクトリが存在しないためforce:trueで無視する)。
+     */
     setScreenshot(input: ScreenshotWriteInput): ScreenshotCacheEntry;
     /** 新規取得結果を保存(既存があれば上書き)する。 */
     set(input: CacheWriteInput): CacheEntry;
@@ -86,5 +113,24 @@ export declare class PageCache {
      * store JSDoc参照)。せめて時刻が巻き戻らないよう、SQL側でMAXを取って単調増加を保証する。
      */
     setHostLastRequestAt(host: string, at: number): void;
+    /**
+     * レビュー指摘対応: オリジン(例 "https://example.com")のrobots.txtキャッシュを返す
+     * (未記録ならnull)。PolitenessManagerのrobotsStoreオプションとして注入し、プロセス間で
+     * robots.txt取得結果を共有するために使う。TTL判定(robotsTtlMs)は呼び出し元(PolitenessManager)
+     * がfetchedAtを見て行う(page cacheのttlMsとは別の時間軸のため、ここでは判定しない)。
+     * 空bodyのrobots.txt(=制限なし)も正しい取得結果として保存されるため、
+     * 「未記録(null)」と「空bodyの記録あり」は区別される。
+     */
+    getRobotsCache(origin: string): {
+        body: string;
+        fetchedAt: number;
+    } | null;
+    /** オリジンのrobots.txt取得結果(本文+取得時刻)を記録する。既存があれば上書きする。 */
+    setRobotsCache(origin: string, body: string, fetchedAt: number): void;
+    /**
+     * 冪等なclose。better-sqlite3のclose()は閉鎖済みでも安全だったが、node:sqliteは
+     * "database is not open" を投げるため、CLIのfinallyとprocess 'exit'ハンドラの両方から
+     * 呼ばれる二重close経路(core.ts参照)を自前のフラグで吸収する。
+     */
     close(): void;
 }

package/dist/cache.js

@@ -1,5 +1,5 @@
 /**
- * cache.ts — better-sqlite3によるURL単位のローカルキャッシュ。
+ * cache.ts — node:sqlite(DatabaseSync)によるURL単位のローカルキャッシュ。
  *
  * 保存場所: $AMENBO_CACHE_DIR または ~/.cache/amenbo/cache.sqlite
  * URL毎にETag/Last-Modified/本文ハッシュ/変換済みMarkdown/取得時刻を保存する。
@@ -21,17 +21,32 @@
  * 短時間に連続実行すると同一ドメインへの最小間隔が守られない。host_requests テーブルへ
  * 最終リクエスト時刻を永続化し、PolitenessManagerのstoreオプションとして注入することで
  * MCPサーバー/CLIの複数プロセス間で共有する(再起動直後の連続アクセスも守れる副次効果あり)。
- * journal_mode=WAL は複数プロセスからの同時アクセスを想定して設定している。
+ * 同じ理由でrobots.txtの取得結果もrobots_cache テーブルへ永続化し、PolitenessManagerの
+ * robotsStoreオプションとして注入する(CLIでの複数ページ一括収集時にコマンド毎の
+ * robots.txt再取得を防ぐ)。journal_mode=WAL は複数プロセスからの同時アクセスを想定して設定している。
+ *
+ * 性能: SQL文は全てコンストラクタで一度だけprepareし(this.statements)、以降は再利用する。
+ * node:sqliteのprepare()は呼び出しの度にSQLを再コンパイルするため、MCPサーバー常駐時の
+ * 反復実行やCLIバルク収集ループでの再コンパイルコストを避ける。
+ *
+ * node:sqliteの制約: better-sqlite3はNumber.MAX_SAFE_INTEGERを超えるINTEGER列を読むと
+ * 例外を投げたが、node:sqliteは黙ってbigintを返す(上流の挙動差)。本ファイルの整数列
+ * (fetched_at/last_request_at)は全てDate.now()由来でMAX_SAFE_INTEGERを超えないため、
+ * number型へのキャストのみで安全に扱える。
  */
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
 const DEFAULT_TTL_MS = 15 * 60 * 1000; // 15分
 /** Phase 4テンプレート学習: 定型ブロック判定に使う「直近ページ数」の既定値。 */
 const DEFAULT_TEMPLATE_RECENT_PAGES = 3;
-function resolveCacheDir() {
+/** meta テーブルに前回prune時刻を記録するキー。 */
+const META_LAST_PRUNED_AT = "last_pruned_at";
+// レビュー指摘対応: cli.ts(fetch画像の保存先)がキャッシュディレクトリ解決ロジックを
+// 再利用できるようexportする(AMENBO_CACHE_DIR未指定時の既定値~/.cache/amenboとのずれを防ぐ)。
+export function resolveCacheDir() {
     const dir = process.env.AMENBO_CACHE_DIR ?? join(homedir(), ".cache", "amenbo");
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
@@ -50,15 +65,17 @@ export class PageCache {
     cacheDir;
     ttlMs;
     now;
+    statements;
+    closed = false;
     constructor(options = {}) {
         this.cacheDir = options.cacheDir ?? resolveCacheDir();
         if (!existsSync(this.cacheDir)) {
             mkdirSync(this.cacheDir, { recursive: true });
         }
-        this.db = new Database(options.dbPath ?? join(this.cacheDir, "cache.sqlite"));
+        this.db = new DatabaseSync(options.dbPath ?? join(this.cacheDir, "cache.sqlite"));
         this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
         this.now = options.now ?? Date.now;
-        this.db.pragma("journal_mode = WAL");
+        this.db.exec("PRAGMA journal_mode = WAL");
         this.db.exec(`
       CREATE TABLE IF NOT EXISTS pages (
         url TEXT PRIMARY KEY,
@@ -95,22 +112,112 @@ export class PageCache {
         last_request_at INTEGER NOT NULL
       )
     `);
+        // レビュー指摘対応: robots.txtの取得結果をhost_requestsと同じ考え方でプロセス間共有する。
+        // CLIバルク収集(1コマンド=1プロセス)で、コマンド毎にrobots.txtを再取得してしまう
+        // 低負荷原則違反への対応(PolitenessManagerのrobotsStoreオプションとして注入する)。
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS robots_cache (
+        origin TEXT PRIMARY KEY,
+        body TEXT NOT NULL,
+        fetched_at INTEGER NOT NULL
+      )
+    `);
+        // 前回prune時刻等の単一値メタデータ。maybePruneExpired の間引き判定に使う。
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value INTEGER NOT NULL
+      )
+    `);
+        this.statements = this.prepareStatements();
         // M3: TTL超過削除・サイズ上限が無くディスクが無制限に増加する問題への対応。
-        // 起動(コンストラクタ)のたびにTTL超過エントリを掃除する。
+        // 起動のたびに掃除するとCLIバルク収集(1コマンド=1プロセス)で毎回DELETEが走るため、
+        // 前回pruneからTTL未満なら間引く(maybePruneExpired参照)。
+        this.maybePruneExpired();
+    }
+    /** 全SQL文を一度だけprepareする(DDL適用後・prune前に呼ぶ)。 */
+    prepareStatements() {
+        return {
+            deletePagesExpired: this.db.prepare("DELETE FROM pages WHERE fetched_at < ?"),
+            deleteDomainPagesExpired: this.db.prepare("DELETE FROM domain_pages WHERE fetched_at < ?"),
+            deleteHostRequestsExpired: this.db.prepare("DELETE FROM host_requests WHERE last_request_at < ?"),
+            selectScreenshotsExpired: this.db.prepare("SELECT * FROM screenshots WHERE fetched_at < ?"),
+            deleteScreenshotsExpired: this.db.prepare("DELETE FROM screenshots WHERE fetched_at < ?"),
+            getPage: this.db.prepare("SELECT * FROM pages WHERE url = ?"),
+            setPage: this.db.prepare(`INSERT INTO pages (url, etag, last_modified, content_hash, markdown, metadata, fetched_at)
+         VALUES (@url, @etag, @lastModified, @contentHash, @markdown, @metadata, @fetchedAt)
+         ON CONFLICT(url) DO UPDATE SET
+           etag = excluded.etag,
+           last_modified = excluded.last_modified,
+           content_hash = excluded.content_hash,
+           markdown = excluded.markdown,
+           metadata = excluded.metadata,
+           fetched_at = excluded.fetched_at`),
+            touchPage: this.db.prepare("UPDATE pages SET fetched_at = ? WHERE url = ?"),
+            getScreenshot: this.db.prepare("SELECT * FROM screenshots WHERE cache_key = ?"),
+            setScreenshot: this.db.prepare(`INSERT INTO screenshots (cache_key, url, tile_paths, metadata, fetched_at)
+         VALUES (@cacheKey, @url, @tilePaths, @metadata, @fetchedAt)
+         ON CONFLICT(cache_key) DO UPDATE SET
+           url = excluded.url,
+           tile_paths = excluded.tile_paths,
+           metadata = excluded.metadata,
+           fetched_at = excluded.fetched_at`),
+            recordDomainPage: this.db.prepare(`INSERT INTO domain_pages (domain, url, fetched_at, block_hashes)
+         VALUES (@domain, @url, @fetchedAt, @blockHashes)
+         ON CONFLICT(domain, url) DO UPDATE SET
+           fetched_at = excluded.fetched_at,
+           block_hashes = excluded.block_hashes`),
+            getDomainPages: this.db.prepare("SELECT * FROM domain_pages WHERE domain = ? ORDER BY fetched_at DESC LIMIT ?"),
+            getHostRequest: this.db.prepare("SELECT * FROM host_requests WHERE host = ?"),
+            setHostRequest: this.db.prepare(`INSERT INTO host_requests (host, last_request_at)
+         VALUES (@host, @lastRequestAt)
+         ON CONFLICT(host) DO UPDATE SET last_request_at = MAX(last_request_at, excluded.last_request_at)`),
+            getRobots: this.db.prepare("SELECT * FROM robots_cache WHERE origin = ?"),
+            setRobots: this.db.prepare(`INSERT INTO robots_cache (origin, body, fetched_at)
+         VALUES (@origin, @body, @fetchedAt)
+         ON CONFLICT(origin) DO UPDATE SET
+           body = excluded.body,
+           fetched_at = excluded.fetched_at`),
+            getMeta: this.db.prepare("SELECT value FROM meta WHERE key = ?"),
+            setMeta: this.db.prepare(`INSERT INTO meta (key, value) VALUES (@key, @value)
+         ON CONFLICT(key) DO UPDATE SET value = excluded.value`),
+        };
+    }
+    /**
+     * 前回pruneからTTL未満なら掃除を間引く。
+     *
+     * 起動のたびにpruneExpired(複数テーブルのDELETE+screenshots走査)を実行すると、CLIの
+     * 1コマンド=1プロセスでのバルク収集ループで毎回のプロセス起動に掃除コストが乗る。
+     * prune直後のTTL窓ではほとんど新規失効が無いため、前回pruneからの経過がTTL未満なら
+     * skipする(掃除間隔がTTL単位まで粗くなるだけで、ディスク無制限増加の防止という
+     * M3の目的は維持される。失効エントリの残留は最大でも約2×TTLに収まる)。
+     * meta未記録(新規DB/初回起動)では必ず実行するため、起動時掃除のテストは従来通り成立する。
+     */
+    maybePruneExpired() {
+        const lastPrunedAt = this.getMetaValue(META_LAST_PRUNED_AT);
+        const at = this.now();
+        if (lastPrunedAt !== null && at - lastPrunedAt < this.ttlMs)
+            return;
         this.pruneExpired();
+        this.statements.setMeta.run({ key: META_LAST_PRUNED_AT, value: at });
+    }
+    /** meta テーブルの単一整数値を返す(未記録ならnull)。 */
+    getMetaValue(key) {
+        const row = this.statements.getMeta.get(key);
+        return row ? Number(row.value) : null;
     }
     /**
-     * M3: TTL超過エントリを削除する(ディスク無制限増加の防止)。起動時に自動実行される。
+     * M3: TTL超過エントリを削除する(ディスク無制限増加の防止)。maybePruneExpired経由で呼ばれる。
      * screenshotsはSQLite行に加え、対応するPNGファイル(タイル)もあわせて削除する。
      */
     pruneExpired() {
         const cutoff = this.now() - this.ttlMs;
-        this.db.prepare("DELETE FROM pages WHERE fetched_at < ?").run(cutoff);
-        this.db.prepare("DELETE FROM domain_pages WHERE fetched_at < ?").run(cutoff);
+        this.statements.deletePagesExpired.run(cutoff);
+        this.statements.deleteDomainPagesExpired.run(cutoff);
         // code-reviewer指摘: host_requestsもM3の対象から漏れていた(訪問ホスト毎に1行増える
         // 無制限増加テーブルという点でdomain_pages等と同じ性質を持つため、他テーブルと一貫させる)。
-        this.db.prepare("DELETE FROM host_requests WHERE last_request_at < ?").run(cutoff);
-        const expiredScreenshots = this.db.prepare("SELECT * FROM screenshots WHERE fetched_at < ?").all(cutoff);
+        this.statements.deleteHostRequestsExpired.run(cutoff);
+        const expiredScreenshots = this.statements.selectScreenshotsExpired.all(cutoff);
         for (const row of expiredScreenshots) {
             const tilePaths = JSON.parse(row.tile_paths);
             for (const filePath of tilePaths) {
@@ -122,11 +229,11 @@ export class PageCache {
                 }
             }
         }
-        this.db.prepare("DELETE FROM screenshots WHERE fetched_at < ?").run(cutoff);
+        this.statements.deleteScreenshotsExpired.run(cutoff);
     }
     /** 保存済みエントリを取得する(TTL判定は行わない。判定は isFresh を使う)。 */
     get(url) {
-        const row = this.db.prepare("SELECT * FROM pages WHERE url = ?").get(url);
+        const row = this.statements.getPage.get(url);
         if (!row)
             return undefined;
         return {
@@ -145,7 +252,7 @@ export class PageCache {
     }
     /** 保存済みスクリーンショットエントリを取得する(TTL判定は isFresh を使う)。 */
     getScreenshot(cacheKey) {
-        const row = this.db.prepare("SELECT * FROM screenshots WHERE cache_key = ?").get(cacheKey);
+        const row = this.statements.getScreenshot.get(cacheKey);
         if (!row)
             return undefined;
         return {
@@ -156,9 +263,19 @@ export class PageCache {
             fetchedAt: row.fetched_at,
         };
     }
-    /** スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。 */
+    /**
+     * スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。
+     *
+     * レビュー指摘対応(Medium): 同一cacheKeyへの再撮影でタイル数が減った場合(旧5枚→新3枚)、
+     * 新しいtile_pathsで上書きされるDB行からは旧tile-3.png/tile-4.pngを参照できなくなり、
+     * pruneExpiredもそれらを認識できず孤立ファイルとしてディスクに残り続けていた。
+     * tileDirはcacheKey単位のディレクトリ(他のcacheKeyのタイルと混在しない)のため、
+     * 書き込み前にディレクトリごと削除してから作り直すことで、枚数が変化しても
+     * 旧タイルを確実に一掃する(初回撮影時はディレクトリが存在しないためforce:trueで無視する)。
+     */
     setScreenshot(input) {
         const tileDir = join(this.cacheDir, "screenshots", input.cacheKey);
+        rmSync(tileDir, { recursive: true, force: true });
         mkdirSync(tileDir, { recursive: true });
         const tilePaths = input.tiles.map((buffer, index) => {
             const filePath = join(tileDir, `tile-${index}.png`);
@@ -166,15 +283,7 @@ export class PageCache {
             return filePath;
         });
         const fetchedAt = this.now();
-        this.db
-            .prepare(`INSERT INTO screenshots (cache_key, url, tile_paths, metadata, fetched_at)
-         VALUES (@cacheKey, @url, @tilePaths, @metadata, @fetchedAt)
-         ON CONFLICT(cache_key) DO UPDATE SET
-           url = excluded.url,
-           tile_paths = excluded.tile_paths,
-           metadata = excluded.metadata,
-           fetched_at = excluded.fetched_at`)
-            .run({
+        this.statements.setScreenshot.run({
             cacheKey: input.cacheKey,
             url: input.url,
             tilePaths: JSON.stringify(tilePaths),
@@ -187,17 +296,7 @@ export class PageCache {
     set(input) {
         const contentHash = hashContent(input.markdown);
         const fetchedAt = this.now();
-        this.db
-            .prepare(`INSERT INTO pages (url, etag, last_modified, content_hash, markdown, metadata, fetched_at)
-         VALUES (@url, @etag, @lastModified, @contentHash, @markdown, @metadata, @fetchedAt)
-         ON CONFLICT(url) DO UPDATE SET
-           etag = excluded.etag,
-           last_modified = excluded.last_modified,
-           content_hash = excluded.content_hash,
-           markdown = excluded.markdown,
-           metadata = excluded.metadata,
-           fetched_at = excluded.fetched_at`)
-            .run({
+        this.statements.setPage.run({
             url: input.url,
             etag: input.etag,
             lastModified: input.lastModified,
@@ -218,17 +317,11 @@ export class PageCache {
     }
     /** 304再検証成功時: 本文は変えず取得時刻のみ更新する(再変換しない)。 */
     touch(url) {
-        this.db.prepare("UPDATE pages SET fetched_at = ? WHERE url = ?").run(this.now(), url);
+        this.statements.touchPage.run(this.now(), url);
     }
     /** Phase 4テンプレート学習: このページの(除去前・全)ブロックハッシュ集合をドメイン別に記録する。 */
     recordDomainPageBlocks(domain, url, blockHashes) {
-        this.db
-            .prepare(`INSERT INTO domain_pages (domain, url, fetched_at, block_hashes)
-         VALUES (@domain, @url, @fetchedAt, @blockHashes)
-         ON CONFLICT(domain, url) DO UPDATE SET
-           fetched_at = excluded.fetched_at,
-           block_hashes = excluded.block_hashes`)
-            .run({ domain, url, fetchedAt: this.now(), blockHashes: JSON.stringify(blockHashes) });
+        this.statements.recordDomainPage.run({ domain, url, fetchedAt: this.now(), blockHashes: JSON.stringify(blockHashes) });
     }
     /**
      * 直近recentPages件のページ全てに共通して出現したブロックハッシュを定型ブロック
@@ -236,9 +329,7 @@ export class PageCache {
      * 無い場合(コールドスタート)は誤除去を避けるため空集合を返す。
      */
     getTemplateBlockHashes(domain, recentPages = DEFAULT_TEMPLATE_RECENT_PAGES) {
-        const rows = this.db
-            .prepare("SELECT * FROM domain_pages WHERE domain = ? ORDER BY fetched_at DESC LIMIT ?")
-            .all(domain, recentPages);
+        const rows = this.statements.getDomainPages.all(domain, recentPages);
         if (rows.length < recentPages)
             return new Set();
         const occurrenceCount = new Map();
@@ -260,7 +351,7 @@ export class PageCache {
      * PolitenessManagerのstoreオプションとして注入し、プロセス間でレート制御状態を共有するために使う。
      */
     getHostLastRequestAt(host) {
-        const row = this.db.prepare("SELECT * FROM host_requests WHERE host = ?").get(host);
+        const row = this.statements.getHostRequest.get(host);
         return row ? row.last_request_at : null;
     }
     /**
@@ -273,13 +364,33 @@ export class PageCache {
      * store JSDoc参照)。せめて時刻が巻き戻らないよう、SQL側でMAXを取って単調増加を保証する。
      */
     setHostLastRequestAt(host, at) {
-        this.db
-            .prepare(`INSERT INTO host_requests (host, last_request_at)
-         VALUES (@host, @lastRequestAt)
-         ON CONFLICT(host) DO UPDATE SET last_request_at = MAX(last_request_at, excluded.last_request_at)`)
-            .run({ host, lastRequestAt: at });
+        this.statements.setHostRequest.run({ host, lastRequestAt: at });
+    }
+    /**
+     * レビュー指摘対応: オリジン(例 "https://example.com")のrobots.txtキャッシュを返す
+     * (未記録ならnull)。PolitenessManagerのrobotsStoreオプションとして注入し、プロセス間で
+     * robots.txt取得結果を共有するために使う。TTL判定(robotsTtlMs)は呼び出し元(PolitenessManager)
+     * がfetchedAtを見て行う(page cacheのttlMsとは別の時間軸のため、ここでは判定しない)。
+     * 空bodyのrobots.txt(=制限なし)も正しい取得結果として保存されるため、
+     * 「未記録(null)」と「空bodyの記録あり」は区別される。
+     */
+    getRobotsCache(origin) {
+        const row = this.statements.getRobots.get(origin);
+        return row ? { body: row.body, fetchedAt: row.fetched_at } : null;
     }
+    /** オリジンのrobots.txt取得結果(本文+取得時刻)を記録する。既存があれば上書きする。 */
+    setRobotsCache(origin, body, fetchedAt) {
+        this.statements.setRobots.run({ origin, body, fetchedAt });
+    }
+    /**
+     * 冪等なclose。better-sqlite3のclose()は閉鎖済みでも安全だったが、node:sqliteは
+     * "database is not open" を投げるため、CLIのfinallyとprocess 'exit'ハンドラの両方から
+     * 呼ばれる二重close経路(core.ts参照)を自前のフラグで吸収する。
+     */
     close() {
+        if (this.closed)
+            return;
+        this.closed = true;
         this.db.close();
     }
 }

package/dist/cache.js.map

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

package/dist/cli.d.ts

@@ -11,7 +11,9 @@ export type ParsedCommand = {
     kind: "version";
 } | {
     kind: "help";
-    topic?: "fetch" | "links" | "screenshot";
+    topic?: "fetch" | "links" | "screenshot" | "install-browser";
+} | {
+    kind: "install-browser";
 } | ParsedFetchCommand | ParsedLinksCommand | ParsedScreenshotCommand;
 export interface ParsedFetchCommand {
     kind: "fetch";