@nitpicker/archive 0.25.0 → 0.25.1

package/README.md

@@ -1,12 +1,12 @@
 # @nitpicker/archive
 
-`.nitpicker` アーカイブ（tar + SQLite）の読み書きを担う内部パッケージです。スキーマ定義・マイグレーション・`Archive` / `ArchiveAccessor`・tar 展開キャッシュ・concat / split・body hash・URL alias・技術スタック検出のロールアップ・テンプレート分類・保存済み HTML スナップショットのセレクタ照合と文字列・正規表現検索（`html-snapshot/`。ネイティブの `@nitpicker/core` を呼ぶ薄いラッパーと、その型）・スコープ判定・エラー分類を含みます。
+`.nitpicker`アーカイブ（tar + SQLite）の読み書きを担う内部パッケージです。スキーマ定義・マイグレーション・`Archive`/`ArchiveAccessor`・tar 展開キャッシュ・concat/split・body hash・URL alias・技術スタック検出のロールアップ・テンプレート分類・保存済み HTML スナップショットのセレクタ照合と文字列・正規表現検索（`html-snapshot/`。ネイティブの`@nitpicker/core`を呼ぶ薄いラッパーと、その型）・スコープ判定・エラー分類を含みます。
 
-ヘッドレスブラウザ（puppeteer / `@d-zero/beholder`）や `@d-zero/dealer` には依存しないため、読み取り専用の経路（[@nitpicker/query](../query/README.md)、viewer、mcp-server、report-\*）はクローラーを引き込まずにアーカイブを扱えます。クロール時の書き込みは [@nitpicker/crawler](../crawler/README.md) がこのパッケージ経由で行います。
+ヘッドレスブラウザ（puppeteer/`@d-zero/beholder`）や`@d-zero/dealer`には依存しないため、読み取り専用の経路（[@nitpicker/query](../query/README.md)、viewer、mcp-server、report-\*）はクローラーを引き込まずにアーカイブを扱えます。クロール時の書き込みは[@nitpicker/crawler](../crawler/README.md)がこのパッケージ経由で行います。
 
 ## 使い方
 
-公開 API は機能単位のサブパスで export しています（パッケージルート `.` の export はありません）。
+公開 API は機能単位のサブパスで export しています（パッケージルート`.`の export はありません）。
 
 ```ts
 import Archive from '@nitpicker/archive/archive';
@@ -19,17 +19,17 @@ const config = await accessor.getConfig();
 console.log(classifyErrorKind('net::ERR_NAME_NOT_RESOLVED')); // 'dns'
 ```
 
-利用可能なサブパスは `package.json` の `exports` を参照してください。
+利用可能なサブパスは`package.json`の`exports`を参照してください。
 
 ## テンプレート分類（page-cluster）
 
-テンプレート分類（`src/template-classification/`）は、ページを DOM 構造の類似性でクラスタリングします。計算はすべて [@nitpicker/core](../core/README.md) のネイティブアドオン（Rust の `nitpicker_template_cluster`）が実行し、`src/template-classification/page-cluster/` にはそれを駆動するドライバ（`resolve-page-cluster-keys.ts` の `resolvePageClusterKeys`）だけがあります。ドライバはページのシグナル（URL パス・スタイルシート・ホスト）を渡してから、各ページの HTML を必要な読み込みでだけ取り出して渡し、ページごとのキーとクラスタごとの reason を受け取ります。ドライバはこのディレクトリの外（`@nitpicker/core` を除く）に依存せず、パッケージの `exports` にも載せていません。呼び出しは `classify-page-templates.ts` / `create-page-cluster-factory.ts` に閉じています（ほかはテスト専用の `golden/`）。分類器の `clusterKey` は nitpicker 側で `templateKey` と呼び替えます。
+テンプレート分類（`src/template-classification/`）は、ページを DOM 構造の類似性でクラスタリングします。計算はすべて[@nitpicker/core](../core/README.md)のネイティブアドオン（Rust の`nitpicker_template_cluster`）が実行し、`src/template-classification/page-cluster/`にはそれを駆動するドライバ（`resolve-page-cluster-keys.ts`の`resolvePageClusterKeys`）だけがあります。ドライバはページのシグナル（URL パス・スタイルシート・ホスト）を渡してから、各ページの HTML を必要な読み込みでだけ取り出して渡し、ページごとのキーとクラスタごとの reason を受け取ります。ドライバはこのディレクトリの外（`@nitpicker/core`を除く）に依存せず、パッケージの`exports`にも載せていません。呼び出しは`classify-page-templates.ts`/`create-page-cluster-factory.ts`に閉じています（ほかはテスト専用の`golden/`）。分類器の`clusterKey`は nitpicker 側で`templateKey`と呼び替えます。
 
-出力は既存アーカイブに保存済みの `templateKey` と reason にバイト単位で一致し、`src/template-classification/golden/` の golden がそれを固定しています。
+出力は既存アーカイブに保存済みの`templateKey`と reason にバイト単位で一致し、`src/template-classification/golden/`の golden がそれを固定しています。
 
 ### アルゴリズム概観
 
-`clusterKey` がどう決まるかを知っておくと、分類結果の解釈（なぜこの 2 ページが同じ `templateKey` なのか）がしやすくなります。実装詳細の WHY は `nitpicker_template_cluster` の各モジュールの doc comment が正です。
+`clusterKey`がどう決まるかを知っておくと、分類結果の解釈（なぜこの 2 ページが同じ`templateKey`なのか）がしやすくなります。実装詳細の WHY は`nitpicker_template_cluster`の各モジュールの doc comment が正です。
 
 #### 全体パイプライン
 
@@ -52,8 +52,8 @@ flowchart TD
 
 - **Pass 0（ブロッキング）** — HTML を読まず、URL パスと first-party stylesheet 集合だけで粗く分割します。高価な構造比較を同一ブロック内に閉じ込め、コーパス全体の比較コストを O(n²) から劇的に減らします。stylesheet を持たない orphan ページは同一セクションの CSS ブロックへ再割当されます
 - **chrome discovery** — 全ページのランドマーク署名の度数分布に auto-cut を当て、閾値以上を「グローバル chrome」（サイト共通のヘッダー等）として比較から除外し、閾値未満かつ 2 ページ以上に出現するものを「ローカル chrome」（セクション固有のナビ等）としてトークン再注入します
-- **Stage A（ブロック内クラスタリング）** — ブロックごとに直線的に処理します。本文ルート（`contentRoot` → `<main>` → 内蔵リスト）の深さキャップ（候補深度 2〜10 を全走査して knee を探す自動選択）→ tokenize → **ページ固有クラスの除去**（ブロック内で 1 ページにしか現れないクラスは `<article class="outline">` のようなページ識別ラベルであってテンプレート構造ではないので、`allowedClasses` で除いて再 tokenize します。10 ページ以上のブロックのみ）→ complete-linkage 階層クラスタリング → max-gap auto-cut でカット高を決定 → 最後に包含関係にあるクラスタを吸収する包含割当（割当チェーンを辿り、循環はメンバー最大のクラスタをルートに選んで解決）
-- **Pass 1b（サンプルに落としたブロックのみ）** — Stage A の類似度表がメモリ上限（`--template-memory-budget <MiB>` または `NITPICKER_TEMPLATE_MEMORY_BUDGET`、既定 512 MiB、0 なら全ブロック）を超えるブロックだけ、リザーバサンプリング（最大 100 ページ、ブロックキーをシードにした決定的乱数）で代表させ、サンプル外のページは Stage A 完了後に max-Jaccard で最寄りクラスタへ一括割当する（tokenize にはサンプルで学習した許可クラス集合を適用し、サンプル側と同じ規則で比較します）。そのブロックのメモリ使用量はブロックのページ数ではなくサンプルサイズに比例します。もう 1 つの上限は、全ページで計算するブロックのページ（HTML の解析結果を計算が終わるまで全ブロック分抱える。1 ページ約 60KB）の合計で、`@nitpicker/core` の `TEMPLATE_EXACT_PAGE_LIMIT`（20,000 ページ、固定）です。超えるときは、標本より大きい（100 ページを超える）ブロックを、ページ数が多い順（同数ならブロックの出現順）に、収まるまでサンプルに落とします。100 ページ以下のブロックはサンプルにしても保持ページが減らないので落とさず、それだけで上限を超えるときは超えたまま保持します。ブロックの判定はページ数だけで決まり（重複する集合のまとめ込みはしません）、判定したブロックは `block-sampled` の進捗イベントと分類結果の `sampledBlocks` に、理由（`table-over-budget`、`pages-over-limit`）つきで残ります。サンプルに落としたブロックを含むマージ済みグループは Stage B でも 100 メンバーに抑えます
+- **Stage A（ブロック内クラスタリング）** — ブロックごとに直線的に処理します。本文ルート（`contentRoot` → `<main>` → 内蔵リスト）の深さキャップ（候補深度 2〜10 を全走査して knee を探す自動選択）→ tokenize → **ページ固有クラスの除去**（ブロック内で 1 ページにしか現れないクラスは`<article class="outline">`のようなページ識別ラベルであってテンプレート構造ではないので、`allowedClasses`で除いて再 tokenize します。10 ページ以上のブロックのみ）→ complete-linkage 階層クラスタリング → max-gap auto-cut でカット高を決定 → 最後に包含関係にあるクラスタを吸収する包含割当（割当チェーンを辿り、循環はメンバー最大のクラスタをルートに選んで解決）
+- **Pass 1b（サンプルに落としたブロックのみ）** — Stage A の類似度表がメモリ上限（`--template-memory-budget <MiB>`または`NITPICKER_TEMPLATE_MEMORY_BUDGET`、既定 512 MiB、0 なら全ブロック）を超えるブロックだけ、リザーバサンプリング（最大 100 ページ、ブロックキーをシードにした決定的乱数）で代表させ、サンプル外のページは Stage A 完了後に max-Jaccard で最寄りクラスタへ一括割当する（tokenize にはサンプルで学習した許可クラス集合を適用し、サンプル側と同じ規則で比較します）。そのブロックのメモリ使用量はブロックのページ数ではなくサンプルサイズに比例します。もう 1 つの上限は、全ページで計算するブロックのページ（HTML の解析結果を計算が終わるまで全ブロック分抱える。1 ページ約 60KB）の合計で、`@nitpicker/core`の`TEMPLATE_EXACT_PAGE_LIMIT`（20,000 ページ、固定）です。超えるときは、標本より大きい（100 ページを超える）ブロックを、ページ数が多い順（同数ならブロックの出現順）に、収まるまでサンプルに落とします。100 ページ以下のブロックはサンプルにしても保持ページが減らないので落とさず、それだけで上限を超えるときは超えたまま保持します。ブロックの判定はページ数だけで決まり（重複する集合のまとめ込みはしません）、判定したブロックは`block-sampled`の進捗イベントと分類結果の`sampledBlocks`に、理由（`table-over-budget`、`pages-over-limit`）つきで残ります。サンプルに落としたブロックを含むマージ済みグループは Stage B でも 100 メンバーに抑えます
 - **Stage B（ブロック越えマージ）** — ブロック分割はあくまで比較コスト削減のためなので、最後に同一テンプレートがブロックを跨いで分かれていないか再統合します。これが唯一の反復処理です（次節）。収束後、確定した最終クラスタごとに reason（`TemplateClusterReason`）を 1 つずつ組み立てます — 追加の全コーパススキャンではなく、Stage A/B が既に計算済みの中間データ（quorum core、landmark インスタンス、ブロッキング根拠）を再利用するだけなので、クラスタ数にしか比例しません
 
 #### Stage B: ブロック越え統合の不動点ループ
@@ -74,27 +74,27 @@ flowchart TD
 
 マージが起きるとユニットのメンバー構成が変わり、文書頻度も quorum core も変わります。そのため毎ラウンド、統合後のプールから全指標を**再計算**してマージを再試行します。fine stage・L2 stage の両方でマージが 1 件も出なくなった時点で不動点に到達したとみなして収束します（安全弁として最大 10 ラウンド。実データでは 7 ラウンド以内に収束）。L2 stage は fine stage が空振りしたラウンドでしか実行されない最後の粗い経路で、誤マージ防止のために shell（ランドマーク由来トークン）の相互裏付けを要求します。
 
-fine stage・L2 stage いずれの経路で提案されたマージも、適用前に**凝集度ガード**を通ります: 統合後の quorum core が統合前の core に対して一定比率を下回るなら、そのマージは破棄されます。個々の経路が「統合前のペア類似度」だけを見て提案する一方、複数ラウンドにわたる連鎖的な統合は「統合後に実際どれだけまとまっているか」を悪化させ得る（無関係なテンプレート同士が少しずつ吸収し合う catch-all 化）ため、経路をまたいだ単一のチェックポイントとして機能します。あわせて、L2 stage 自体もラウンド開始前に判別力を検査し、参加ユニット全体が同一の署名形状に潰れている（`main` 直下の浅い階層しか手がかりが残っていない等）場合は、そのラウンドの L2 比較を丸ごとスキップします。詳細は `merge_cross_block_clusters.rs` / `filter_merges_by_cohesion.rs` / `l2_signature.rs` の doc comment を参照してください。
+fine stage・L2 stage いずれの経路で提案されたマージも、適用前に**凝集度ガード**を通ります: 統合後の quorum core が統合前の core に対して一定比率を下回るなら、そのマージは破棄されます。個々の経路が「統合前のペア類似度」だけを見て提案する一方、複数ラウンドにわたる連鎖的な統合は「統合後に実際どれだけまとまっているか」を悪化させ得る（無関係なテンプレート同士が少しずつ吸収し合う catch-all 化）ため、経路をまたいだ単一のチェックポイントとして機能します。あわせて、L2 stage 自体もラウンド開始前に判別力を検査し、参加ユニット全体が同一の署名形状に潰れている（`main`直下の浅い階層しか手がかりが残っていない等）場合は、そのラウンドの L2 比較を丸ごとスキップします。詳細は`merge_cross_block_clusters.rs`/`filter_merges_by_cohesion.rs`/`l2_signature.rs`の doc comment を参照してください。
 
-凝集度ガードの前に、Stage A が同一ブロック内で別クラスタと判定した（双方 3 ページ以上の）ユニット同士を、構造トークンに実質的な差がある限り統合しない**分離尊重ガード**も通ります。生の core では閾値に届かないが、クラス名を除くと骨格が一致する組（BEM 名だけが違う同一骨格）は対象外です。詳細は `filter_merges_by_stage_a_separation.rs` の doc comment を参照してください。
+凝集度ガードの前に、Stage A が同一ブロック内で別クラスタと判定した（双方 3 ページ以上の）ユニット同士を、構造トークンに実質的な差がある限り統合しない**分離尊重ガード**も通ります。生の core では閾値に届かないが、クラス名を除くと骨格が一致する組（BEM 名だけが違う同一骨格）は対象外です。詳細は`filter_merges_by_stage_a_separation.rs`の doc comment を参照してください。
 
 #### Self-tuning
 
-閾値の多くは **max-gap auto-cut**（度数分布の隣接ギャップ最大の中点を境界とする）でデータから自己発見されます。① Stage A のカット高、② Stage B の shell 判定、③ chrome discovery のグローバル/ローカル判定、の 3 箇所で同一プリミティブを再利用しているので、サイトごとにハイパーパラメータをチューニングする必要はありません。詳細は `auto_cut_threshold.rs` の doc comment を参照してください。例外的に Stage B fine stage の complete-linkage だけは固定閾値 0.8 を使います（理由は `merge_cross_block_clusters.rs` を参照）。
+閾値の多くは **max-gap auto-cut**（度数分布の隣接ギャップ最大の中点を境界とする）でデータから自己発見されます。① Stage A のカット高、② Stage B の shell 判定、③ chrome discovery のグローバル/ローカル判定、の 3 箇所で同一プリミティブを再利用しているので、サイトごとにハイパーパラメータをチューニングする必要はありません。詳細は`auto_cut_threshold.rs`の doc comment を参照してください。例外的に Stage B fine stage の complete-linkage だけは固定閾値 0.8 を使います（理由は`merge_cross_block_clusters.rs`を参照）。
 
 ### golden（出力を固定するテスト）
 
-`src/template-classification/golden/` は、分類器の出力（ページごとの `templateKey` と、`page_template_clusters` に保存される reason JSON の文字列）を `__golden__/` に固定し、全件一致を確かめます。入力は、決定的に生成する合成サイトと `page-cluster/__fixtures__/` の HTML で、ドライバに直接渡します。合成サイトは、小さい 1 規模と、約 2 万ページ強の 1 規模です。後者はメモリ上限を 3 通りに変えて記録します。既定のメモリ上限では最大のブロックだけが保持ページ数の上限でサンプルに落ち、メモリ上限 0 では全ブロックが落ち、メモリ上限を絞った場合は一部のブロックだけが落ちます。メモリ上限 0 の記録は、全ブロックをサンプルから計算した結果で、この方式の出力を固定します。分類器を書き換えても出力が同じであることのゲートです。アーカイブ側のアダプタ（`createPageClusterFactory` など）を含む本番経路全体は、実アーカイブで `scripts/template-classification-golden.mjs` を使って確かめます。
+`src/template-classification/golden/`は、分類器の出力（ページごとの`templateKey`と、`page_template_clusters`に保存される reason JSON の文字列）を`__golden__/`に固定し、全件一致を確かめます。入力は、決定的に生成する合成サイトと`page-cluster/__fixtures__/`の HTML で、ドライバに直接渡します。合成サイトは、小さい 1 規模と、約 2 万ページ強の 1 規模です。後者はメモリ上限を 3 通りに変えて記録します。既定のメモリ上限では最大のブロックだけが保持ページ数の上限でサンプルに落ち、メモリ上限 0 では全ブロックが落ち、メモリ上限を絞った場合は一部のブロックだけが落ちます。メモリ上限 0 の記録は、全ブロックをサンプルから計算した結果で、この方式の出力を固定します。分類器を書き換えても出力が同じであることのゲートです。アーカイブ側のアダプタ（`createPageClusterFactory`など）を含む本番経路全体は、実アーカイブで`scripts/template-classification-golden.mjs`を使って確かめます。
 
-出力を意図して変えるときだけ、次のコマンドで `__golden__/` を更新し、理由を PR に書きます（パスを付けないと他の spec の snapshot まで更新されます）。
+出力を意図して変えるときだけ、次のコマンドで`__golden__/`を更新し、理由を PR に書きます（パスを付けないと他の spec の snapshot まで更新されます）。
 
 ```sh
 yarn vitest run packages/@nitpicker/archive/src/template-classification/golden --exclude '.claude/**' -u
 ```
 
-差分を読むときは `inputDigest` を先に見ます。`inputDigest` が変わっていれば入力（生成器か fixture）が変わっています。`inputDigest` が同じなのにほかのフィールドが変わっていれば、分類器の出力が変わっています。
+差分を読むときは`inputDigest`を先に見ます。`inputDigest`が変わっていれば入力（生成器か fixture）が変わっています。`inputDigest`が同じなのにほかのフィールドが変わっていれば、分類器の出力が変わっています。
 
-`page-cluster/__fixtures__/` の HTML は、`@nitpicker/core` の Rust テスト（htmlparser2 との突き合わせ）も読みます。fixture を足したり変えたりしたら、core の `scripts/record-htmlparser2-events.mjs` で記録済みイベントを取り直します（手順はスクリプト冒頭）。取り直すまで core のテストが落ちます。
+`page-cluster/__fixtures__/`の HTML は、`@nitpicker/core`の Rust テスト（htmlparser2 との突き合わせ）も読みます。fixture を足したり変えたりしたら、core の`scripts/record-htmlparser2-events.mjs`で記録済みイベントを取り直します（手順はスクリプト冒頭）。取り直すまで core のテストが落ちます。
 
 ## 関連リンク
 

package/lib/archive.js

@@ -74,7 +74,6 @@ export default class Archive extends ArchiveAccessor {
     get renamedDir() {
         return path.resolve(path.dirname(this.#filePath), path.basename(this.#filePath, path.extname(this.#filePath)));
     }
-    // eslint-disable-next-line no-restricted-syntax
     constructor(filePath, tmpDir, db, releaseLock) {
         super(tmpDir, db);
         this.#filePath = filePath;

package/lib/create-entity-tables.d.ts

@@ -106,8 +106,8 @@ import type { Knex } from 'knex';
  * for the pair); duplicate observations are counted via `count` without
  * retaining their bodies. The UNIQUE constraint's auto-index on
  * `(page_id, href_page_id)` also serves any `WHERE page_id = ?` seek via
- * SQLite's leading-prefix rule, so no separate `CREATE INDEX ... ON
- * anchor_edges(page_id)` is needed; only the reverse-direction
+ * SQLite's leading-prefix rule, so no separate
+ * `CREATE INDEX ... ON anchor_edges(page_id)` is needed; only the reverse-direction
  * `idx_anchor_edges_href` on `href_page_id` alone is added.
  *
  * **`image_items.dom_path_text_id NOT NULL`.** Every image row must
@@ -127,8 +127,8 @@ import type { Knex } from 'knex';
  * and the viewer would arbitrarily pick one to render.
  *
  * **`resource_items` url / blob mutual-exclusion CHECK.** Same rationale
- * as the image CHECK above, but stricter: `(url_id IS NULL) !=
- * (url_blob_id IS NULL)` requires EXACTLY one slot to be non-null (not
+ * as the image CHECK above, but stricter:
+ * `(url_id IS NULL) != (url_blob_id IS NULL)` requires EXACTLY one slot to be non-null (not
  * "at most one") because a resource — unlike an `<img>` that can
  * legitimately have neither `src` nor `currentSrc` — is always
  * identified by some URL. `resolveUrlOrBlob` (writer) /
@@ -178,8 +178,8 @@ import type { Knex } from 'knex';
  *
  * ### Idempotency
  *
- * All statements use `CREATE TABLE IF NOT EXISTS` / `CREATE INDEX IF NOT
- * EXISTS` so the primitive is safe to call multiple times against the
+ * All statements use `CREATE TABLE IF NOT EXISTS` /
+ * `CREATE INDEX IF NOT EXISTS` so the primitive is safe to call multiple times against the
  * same DB. Both call sites (`initSchema` and
  * `migrateEntityTables`) still guard on their own sentinels,
  * but the function itself no longer depends on the sentinel being

package/lib/create-entity-tables.js

@@ -105,8 +105,8 @@
  * for the pair); duplicate observations are counted via `count` without
  * retaining their bodies. The UNIQUE constraint's auto-index on
  * `(page_id, href_page_id)` also serves any `WHERE page_id = ?` seek via
- * SQLite's leading-prefix rule, so no separate `CREATE INDEX ... ON
- * anchor_edges(page_id)` is needed; only the reverse-direction
+ * SQLite's leading-prefix rule, so no separate
+ * `CREATE INDEX ... ON anchor_edges(page_id)` is needed; only the reverse-direction
  * `idx_anchor_edges_href` on `href_page_id` alone is added.
  *
  * **`image_items.dom_path_text_id NOT NULL`.** Every image row must
@@ -126,8 +126,8 @@
  * and the viewer would arbitrarily pick one to render.
  *
  * **`resource_items` url / blob mutual-exclusion CHECK.** Same rationale
- * as the image CHECK above, but stricter: `(url_id IS NULL) !=
- * (url_blob_id IS NULL)` requires EXACTLY one slot to be non-null (not
+ * as the image CHECK above, but stricter:
+ * `(url_id IS NULL) != (url_blob_id IS NULL)` requires EXACTLY one slot to be non-null (not
  * "at most one") because a resource — unlike an `<img>` that can
  * legitimately have neither `src` nor `currentSrc` — is always
  * identified by some URL. `resolveUrlOrBlob` (writer) /
@@ -177,8 +177,8 @@
  *
  * ### Idempotency
  *
- * All statements use `CREATE TABLE IF NOT EXISTS` / `CREATE INDEX IF NOT
- * EXISTS` so the primitive is safe to call multiple times against the
+ * All statements use `CREATE TABLE IF NOT EXISTS` /
+ * `CREATE INDEX IF NOT EXISTS` so the primitive is safe to call multiple times against the
  * same DB. Both call sites (`initSchema` and
  * `migrateEntityTables`) still guard on their own sentinels,
  * but the function itself no longer depends on the sentinel being

package/lib/database.js

@@ -100,7 +100,6 @@ export class Database extends EventEmitter {
     #instance;
     /** Connection-scoped write-side id caches for entity/ref upserts. */
     #writeRefCaches = createWriteRefCaches();
-    // eslint-disable-next-line no-restricted-syntax
     constructor(options) {
         super();
         // **Known caveat (libsql 0.5.x)**: passing `readonly: true` via

package/lib/db-ops/_shared/load-response-headers-by-set-ids.js

@@ -31,12 +31,12 @@ export async function loadResponseHeadersBySetIds(knex, headerSetIds) {
     const merged = new Map();
     for (let index = 0; index < headerSetIds.length; index += LOOKUP_CHUNK_SIZE) {
         const chunk = headerSetIds.slice(index, index + LOOKUP_CHUNK_SIZE);
-        const headerRows = (await knex('header_set_entries as hse')
+        const headerRows = await knex('header_set_entries as hse')
             .join('header_name_refs as hnr', 'hnr.id', 'hse.name_id')
             .join('header_value_refs as hvr', 'hvr.id', 'hse.value_id')
             .whereIn('hse.header_set_id', chunk)
             .orderBy(['hse.header_set_id', 'hnr.name', 'hse.occurrence'])
-            .select('hse.header_set_id as headerSetId', 'hnr.name as name', 'hvr.value as value'));
+            .select('hse.header_set_id as headerSetId', 'hnr.name as name', 'hvr.value as value');
         for (const row of headerRows) {
             const bySet = merged.get(row.headerSetId) ?? new Map();
             const values = bySet.get(row.name) ?? [];

package/lib/db-ops/dedupe-cap/list-dedupe-cap-shape-keys.js

@@ -22,6 +22,6 @@ export async function listDedupeCapShapeKeys(knex) {
     if (!hasTable) {
         return [];
     }
-    const rows = (await knex('dedupe_cap_events').distinct('shape_key'));
+    const rows = await knex('dedupe_cap_events').distinct('shape_key');
     return rows.map((row) => row.shape_key);
 }

package/lib/db-ops/outages/close-stale-open-network-outages.js

@@ -29,9 +29,9 @@ export async function closeStaleOpenNetworkOutages(knex) {
     if (!hasTable) {
         return;
     }
-    const openRows = (await knex('network_outages')
+    const openRows = await knex('network_outages')
         .whereNull('ended_at')
-        .select('id', 'started_at'));
+        .select('id', 'started_at');
     if (openRows.length === 0) {
         return;
     }

package/lib/db-ops/outages/compute-outage-clamp-timestamp.js

@@ -23,8 +23,8 @@
  *   (a brand-new archive with no activity yet).
  */
 export async function computeOutageClampTimestamp(knex) {
-    const [crawlErrorsRow] = (await knex('crawl_errors').max('createdAt as maxCreatedAt'));
-    const [contentItemsRow] = (await knex('content_items').max('last_crawled_at as maxLastCrawledAt'));
+    const [crawlErrorsRow] = await knex('crawl_errors').max('createdAt as maxCreatedAt');
+    const [contentItemsRow] = await knex('content_items').max('last_crawled_at as maxLastCrawledAt');
     const latestError = crawlErrorsRow?.maxCreatedAt ?? 0;
     const latestCrawl = contentItemsRow?.maxLastCrawledAt ?? 0;
     return Math.max(latestError, latestCrawl);

package/lib/db-ops/outages/list-network-outages.js

@@ -29,7 +29,7 @@ export async function listNetworkOutages(knex) {
     if (!hasTable) {
         return [];
     }
-    const rows = (await knex('network_outages').select('started_at', 'ended_at'));
+    const rows = await knex('network_outages').select('started_at', 'ended_at');
     if (rows.length === 0) {
         return [];
     }

package/lib/db-ops/templates/replace-page-templates.js

@@ -147,7 +147,7 @@ function labelPair(label) {
  * @returns The previous membership; empty on a first run.
  */
 async function loadPreviousMembership(trx) {
-    const previousRows = (await trx('page_templates').select('page_id as pageId', 'template_key as templateKey'));
+    const previousRows = await trx('page_templates').select('page_id as pageId', 'template_key as templateKey');
     const membership = new Map();
     for (const row of previousRows) {
         const pageIds = membership.get(row.templateKey);
@@ -166,7 +166,7 @@ async function loadPreviousMembership(trx) {
  * @returns Template key → label; empty on a first run.
  */
 async function loadPreviousLabels(trx) {
-    const labelRows = (await trx('page_template_labels').select('template_key as templateKey', 'section', 'ordinal'));
+    const labelRows = await trx('page_template_labels').select('template_key as templateKey', 'section', 'ordinal');
     return new Map(labelRows.map((row) => [
         row.templateKey,
         { section: row.section, ordinal: row.ordinal },

package/lib/filesystem/output-text.js

@@ -16,13 +16,13 @@ export async function outputText(filePath, data) {
     mkdir(filePath);
     await fs.writeFile(filePath, data, { encoding: 'utf8' }).catch(async (error) => {
         if (error instanceof Error && 'code' in error && error.code === 'ENAMETOOLONG') {
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(`File path too long: ${filePath}`);
             const dir = path.dirname(filePath);
             const altFileName = `__file_path_too_long_${(filePathTooLongCount++).toString().padStart(4, '0')}`;
             const ext = path.extname(filePath);
             const altFilePath = path.resolve(dir, `${altFileName}${ext}`);
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(`Try to save to: ${altFilePath}`);
             const altMetaFilePath = path.resolve(dir, `${altFileName}.meta.txt`);
             await outputText(altFilePath, data);

package/lib/filesystem/parse-pax-path.js

@@ -31,9 +31,7 @@ export function parsePaxPath(data) {
         if (recordEnd > data.length) {
             return null;
         }
-        // Decimal (not `0x3D`) to sidestep the Prettier/eslint hex-case
-        // conflict — see `parse-tar-size-field.ts` for the full explanation.
-        const equalsIndex = data.indexOf(61 /* '=' */, spaceIndex);
+        const equalsIndex = data.indexOf(0x3d /* '=' */, spaceIndex);
         if (equalsIndex !== -1 && equalsIndex < recordEnd) {
             const key = data.subarray(spaceIndex + 1, equalsIndex).toString('utf8');
             if (key === 'path') {

package/lib/filesystem/parse-tar-size-field.js

@@ -21,10 +21,7 @@ export function parseTarSizeField(field) {
         // tars never approach sizes needing this (single-digit-terabyte
         // range before it would even matter), but a correct read here still
         // costs nothing.
-        // `0b0111_1111` (not `0x7F`) to sidestep the Prettier/eslint hex-case
-        // conflict (Prettier always lowercases hex digits; this repo's
-        // `unicorn/number-literal-case` requires uppercase) — a binary literal
-        // has no letter digits to disagree about.
+        // Mask off the high bit that marks the base-256 form.
         let value = BigInt(first & 0b0111_1111);
         for (let i = 1; i < field.length; i++) {
             value = (value << 8n) | BigInt(field[i] ?? 0);

package/lib/filesystem/readline.js

@@ -16,7 +16,7 @@ export async function readline(filePath, callback) {
     const promiseBuffer = [];
     await new Promise((resolve) => {
         rLine.on('line', (line) => {
-            promiseBuffer.push(callback(line));
+            promiseBuffer.push(Promise.resolve(callback(line)));
         });
         rLine.on('close', () => {
             resolve();

package/lib/meta/derive-meta-extras.js

@@ -17,7 +17,7 @@
  * @returns Plain object suitable for `JSON.stringify`.
  */
 export function deriveMetaExtras(meta) {
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- we destructure to omit these from the spread
+    // oxlint-disable-next-line typescript/no-unused-vars -- we destructure to omit these from the spread
     const { jsonLd, speculationRules, tags, _raw, ...rest } = meta;
     return rest;
 }

package/lib/meta/types.d.ts

@@ -442,7 +442,7 @@ export interface JsonLdRow {
     /** Original script text content (uncompressed; SQLite overflow pages handle large rows). */
     raw: string;
     /** Parsed JSON object (`null` when `parseError` is set). */
-    parsed: unknown | null;
+    parsed: unknown;
     /** Parse error message preserved from beholder; `null` when the entry parsed cleanly. */
     parseError: string | null;
 }

package/lib/migrate-content-items-alias-of-id.js

@@ -61,7 +61,7 @@ export async function migrateContentItemsAliasOfId(instance, onLog) {
             onLog(message);
         }
         else {
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(message);
         }
     }

package/lib/migrate-content-items-dedupe-cap-event-id.js

@@ -55,7 +55,7 @@ export async function migrateContentItemsDedupeCapEventId(instance, onLog) {
             onLog(message);
         }
         else {
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(message);
         }
     }

package/lib/migrate-content-items-is-metadata-only.js

@@ -53,7 +53,7 @@ export async function migrateContentItemsIsMetadataOnly(instance, onLog) {
             onLog(message);
         }
         else {
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(message);
         }
     }

package/lib/migrate-entity-tables.js

@@ -61,6 +61,6 @@ export async function migrateEntityTables(instance) {
         return;
     }
     await createEntityTables(instance);
-    // eslint-disable-next-line no-console
+    // oxlint-disable-next-line no-console
     console.error('[migrate] 0.13 entity/edge tables created');
 }

package/lib/migrate-info-created-cwd.js

@@ -30,7 +30,7 @@ export async function migrateInfoCreatedCwd(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-info-main-content-selector.js

@@ -29,7 +29,7 @@ export async function migrateInfoMainContentSelector(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-info-request-header-names.js

@@ -29,7 +29,7 @@ export async function migrateInfoRequestHeaderNames(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-info-roots.js

@@ -46,7 +46,7 @@ export async function migrateInfoRoots(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-inventory-runs-to-list-reconcile-runs.js

@@ -45,7 +45,7 @@ export async function migrateInventoryRunsToListReconcileRuns(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-list-reconcile-runs-exclude-skipped.js

@@ -38,7 +38,7 @@ export async function migrateListReconcileRunsExcludeSkipped(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-list-reconcile-runs-invalid-skipped.js

@@ -29,7 +29,7 @@ export async function migrateListReconcileRunsInvalidSkipped(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-main-contents-columns.js

@@ -55,7 +55,7 @@ export async function migrateMainContentsColumns(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-page-meta-body-hash.js

@@ -55,7 +55,7 @@ export async function migratePageMetaBodyHash(instance, onLog) {
             onLog(message);
         }
         else {
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(message);
         }
     }

package/lib/migrate-page-meta-console-error-count.js

@@ -38,7 +38,7 @@ export async function migratePageMetaConsoleErrorCount(instance, onLog) {
             onLog(message);
         }
         else {
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(message);
         }
     }

package/lib/migrate-page-meta-custom-element-count.js

@@ -44,7 +44,7 @@ export async function migratePageMetaCustomElementCount(instance, onLog) {
             onLog(message);
         }
         else {
-            // eslint-disable-next-line no-console
+            // oxlint-disable-next-line no-console
             console.error(message);
         }
     }

package/lib/migrate-page-meta-image-scan.js

@@ -46,7 +46,7 @@ export async function migratePageMetaImageScan(instance, onLog) {
         onLog(message);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(message);
     }
 }

package/lib/migrate-page-tags-to-page-technologies.js

@@ -48,7 +48,7 @@ export async function migratePageTagsToPageTechnologies(instance, onLog) {
         onLog(startMessage);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(startMessage);
     }
     await instance.transaction(async (trx) => {
@@ -73,7 +73,7 @@ export async function migratePageTagsToPageTechnologies(instance, onLog) {
         onLog(endMessage);
     }
     else {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.error(endMessage);
     }
 }

package/lib/migrate-ref-tables.js

@@ -33,6 +33,6 @@ export async function migrateRefTables(instance) {
         return;
     }
     await createRefTables(instance);
-    // eslint-disable-next-line no-console
+    // oxlint-disable-next-line no-console
     console.error('[migrate] 0.13 ref/header tables created');
 }

package/lib/populate-entity-tables/populate-page-meta.js

@@ -236,7 +236,7 @@ function resolveOptionalUrlId(value, urlIds, pageId, column) {
         return null;
     }
     if (isLargeDataUri(value)) {
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line no-console
         console.warn(`populatePageMeta: dropping large data URI in page id=${pageId} column=${column} (page_meta has no *_blob_id companion for URL columns)`);
         return null;
     }

package/lib/populate-ref-tables/populate-blob-refs.js

@@ -102,7 +102,7 @@ export async function populateBlobRefs(trx, onProgress) {
                     }
                     const decoded = decodeDataUri(value);
                     if (decoded === null) {
-                        // eslint-disable-next-line no-console
+                        // oxlint-disable-next-line no-console
                         console.warn(`populateBlobRefs: skipping malformed data URI (length=${value.length}) — raw string still exists in ${source.table} row`);
                         continue;
                     }

package/lib/template-classification/collect-page-ids-with-html.js

@@ -21,10 +21,10 @@
  * ```
  */
 export async function collectPageIdsWithHtml(archive) {
-    const rows = (await archive
+    const rows = await archive
         .getKnex()('page_html_ref as ref')
         .join('page_html_blobs as blob', 'blob.hash', 'ref.hash')
         .where('blob.size_raw', '>', 0)
-        .select('ref.page_id as pageId'));
+        .select('ref.page_id as pageId');
     return new Set(rows.map((row) => row.pageId));
 }

package/lib/template-classification/collect-page-stylesheet-urls.js

@@ -44,10 +44,10 @@ const SQLITE_IN_CHUNK = 500;
  */
 export async function collectPageStylesheetUrls(archive) {
     const knex = archive.getKnex();
-    const cssResources = (await knex('resource_items as ri')
+    const cssResources = await knex('resource_items as ri')
         .join('content_type_refs as ctr', 'ctr.id', 'ri.content_type_id')
         .where('ctr.category', 'css')
-        .select('ri.id as id', 'ri.url_id as urlId'));
+        .select('ri.id as id', 'ri.url_id as urlId');
     // A CSS resource identified by a `data:` URI (routed to `blob_refs`
     // instead of `url_refs`, `resource_items.url_blob_id`) has no stylesheet
     // URL to report — skip it rather than passing a `null` into `whereIn`.
@@ -57,7 +57,9 @@ export async function collectPageStylesheetUrls(archive) {
     }
     const cssUrlById = new Map();
     await eachSplitted(cssResourcesWithUrl.map((r) => r.urlId), SQLITE_IN_CHUNK, async (chunk) => {
-        const rows = (await knex('url_refs').whereIn('id', chunk).select('id', 'url'));
+        const rows = await knex('url_refs')
+            .whereIn('id', chunk)
+            .select('id', 'url');
         for (const row of rows) {
             cssUrlById.set(row.id, row.url);
         }
@@ -71,9 +73,9 @@ export async function collectPageStylesheetUrls(archive) {
     }
     const resourceIdsByPageId = new Map();
     await eachSplitted(cssResourcesWithUrl.map((r) => r.id), SQLITE_IN_CHUNK, async (chunk) => {
-        const rows = (await knex('resource_ref_edges')
+        const rows = await knex('resource_ref_edges')
             .whereIn('resource_id', chunk)
-            .select('resource_id as resourceId', 'page_id as pageId'));
+            .select('resource_id as resourceId', 'page_id as pageId');
         // Avoid `push(...rows)`: on large real archives this chunk array can
         // be large enough to overflow V8's argument-spread limit even though
         // the underlying data itself fits in memory.
@@ -92,10 +94,10 @@ export async function collectPageStylesheetUrls(archive) {
     }
     const pageUrlById = new Map();
     await eachSplitted([...resourceIdsByPageId.keys()], SQLITE_IN_CHUNK, async (chunk) => {
-        const rows = (await knex('content_items as ci')
+        const rows = await knex('content_items as ci')
             .join('url_refs as ur', 'ur.id', 'ci.url_id')
             .whereIn('ci.id', chunk)
-            .select('ci.id as id', 'ur.url as url'));
+            .select('ci.id as id', 'ur.url as url');
         for (const row of rows) {
             pageUrlById.set(row.id, row.url);
         }

package/lib/template-classification/load-page-cluster-candidates.js

@@ -51,13 +51,13 @@ export async function loadPageClusterCandidates(archive, options) {
     let lastId = 0;
     let done = 0;
     while (true) {
-        const rows = (await internalHtml()
+        const rows = await internalHtml()
             .join('url_refs as ur', 'ur.id', 'ci.url_id')
             .leftJoin('page_meta as pm', 'pm.page_id', 'ci.id')
             .andWhere('ci.id', '>', lastId)
             .orderBy('ci.id')
             .limit(batchSize)
-            .select('ci.id as id', 'ur.url as url', 'pm.main_content_node_name as main_content_node_name', 'pm.main_content_id as main_content_id', 'pm.main_content_role as main_content_role', 'pm.main_content_class_list as main_content_class_list'));
+            .select('ci.id as id', 'ur.url as url', 'pm.main_content_node_name as main_content_node_name', 'pm.main_content_id as main_content_id', 'pm.main_content_role as main_content_role', 'pm.main_content_class_list as main_content_class_list');
         if (rows.length === 0) {
             break;
         }

package/lib/test-utils/compare-strings.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Orders two strings by UTF-16 code unit, which is what `Array#sort()` does
+ * without a comparator. Written out so specs can pass a comparator
+ * explicitly (`toSorted(compareStrings)`) and still get the locale-independent
+ * order that makes expectations reproducible.
+ * @param a - Left string.
+ * @param b - Right string.
+ * @returns Negative when `a` sorts first, positive when `b` does, 0 when equal.
+ * @example
+ * ['b', 'B', 'a'].toSorted(compareStrings); // ['B', 'a', 'b']
+ */
+export declare function compareStrings(a: string, b: string): number;

package/lib/test-utils/compare-strings.js

@@ -0,0 +1,14 @@
+/**
+ * Orders two strings by UTF-16 code unit, which is what `Array#sort()` does
+ * without a comparator. Written out so specs can pass a comparator
+ * explicitly (`toSorted(compareStrings)`) and still get the locale-independent
+ * order that makes expectations reproducible.
+ * @param a - Left string.
+ * @param b - Right string.
+ * @returns Negative when `a` sorts first, positive when `b` does, 0 when equal.
+ * @example
+ * ['b', 'B', 'a'].toSorted(compareStrings); // ['B', 'a', 'b']
+ */
+export function compareStrings(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}

package/lib/transfer/copy-page-template-labels.js

@@ -34,7 +34,7 @@ const SRC = TRANSFER_SOURCE_ALIAS;
  * ```
  */
 export async function copyPageTemplateLabels(trx) {
-    const [sourceTable] = (await trx.raw(`SELECT name FROM ${SRC}.sqlite_master WHERE type = 'table' AND name = 'page_template_labels'`));
+    const [sourceTable] = await trx.raw(`SELECT name FROM ${SRC}.sqlite_master WHERE type = 'table' AND name = 'page_template_labels'`);
     if (sourceTable) {
         await trx.raw(`
 			INSERT INTO main.page_template_labels (template_key, section, ordinal)

package/lib/transfer/list-transfer-columns.d.ts

@@ -4,14 +4,14 @@ import type { Knex } from 'knex';
  * function, in declaration order, minus any names in `exclude`.
  *
  * A transfer copy must NEVER build its column list from a hand-written
- * literal or from `SELECT *` — migrated archives add columns via `ALTER
- * TABLE ADD COLUMN`, which always appends at the end, so a fresh archive's
+ * literal or from `SELECT *` — migrated archives add columns via
+ * `ALTER TABLE ADD COLUMN`, which always appends at the end, so a fresh archive's
  * `content_items` (say) can have `alias_of_id` earlier in declaration order
- * than a migrated archive's copy of the same table. A positional `INSERT
- * ... SELECT * FROM other_table` across two archives with different column
+ * than a migrated archive's copy of the same table. A positional
+ * `INSERT ... SELECT * FROM other_table` across two archives with different column
  * orders would silently shift values into the wrong columns. Reading each
- * side's own column list and building an explicit, named `SELECT
- * <col1>, <col2>, ...` (this function's contract) sidesteps the problem
+ * side's own column list and building an explicit, named
+ * `SELECT <col1>, <col2>, ...` (this function's contract) sidesteps the problem
  * entirely — column order never matters when every column is named.
  *
  * The pragma table-valued function must be schema-qualified as

package/lib/transfer/list-transfer-columns.js

@@ -3,14 +3,14 @@
  * function, in declaration order, minus any names in `exclude`.
  *
  * A transfer copy must NEVER build its column list from a hand-written
- * literal or from `SELECT *` — migrated archives add columns via `ALTER
- * TABLE ADD COLUMN`, which always appends at the end, so a fresh archive's
+ * literal or from `SELECT *` — migrated archives add columns via
+ * `ALTER TABLE ADD COLUMN`, which always appends at the end, so a fresh archive's
  * `content_items` (say) can have `alias_of_id` earlier in declaration order
- * than a migrated archive's copy of the same table. A positional `INSERT
- * ... SELECT * FROM other_table` across two archives with different column
+ * than a migrated archive's copy of the same table. A positional
+ * `INSERT ... SELECT * FROM other_table` across two archives with different column
  * orders would silently shift values into the wrong columns. Reading each
- * side's own column list and building an explicit, named `SELECT
- * <col1>, <col2>, ...` (this function's contract) sidesteps the problem
+ * side's own column list and building an explicit, named
+ * `SELECT <col1>, <col2>, ...` (this function's contract) sidesteps the problem
  * entirely — column order never matters when every column is named.
  *
  * The pragma table-valued function must be schema-qualified as

package/lib/transfer/reclassify-resource-externality.d.ts

@@ -9,8 +9,8 @@ import type { Knex } from 'knex';
  * target" — a write-time fact this transfer never re-derives, per
  * ARCHITECTURE.md's invariant), `resource_items.is_external` is a pure
  * scope check computed the same way at crawl time
- * (`@nitpicker/crawler`'s `Crawler#handleResources`: `findScopeEntry(url, this.#scope)
- * === null`). Concat's merged scope is a union of every source's roots,
+ * (`@nitpicker/crawler`'s `Crawler#handleResources`:
+ * `findScopeEntry(url, this.#scope) === null`). Concat's merged scope is a union of every source's roots,
  * so a resource one source recorded as external can legitimately become
  * internal-by-scope in the output even though nothing about the resource
  * itself changed — recomputing this is the resource-table equivalent of

package/lib/transfer/reclassify-resource-externality.js

@@ -9,8 +9,8 @@ import { findScopeEntry } from '../scope/find-scope-entry.js';
  * target" — a write-time fact this transfer never re-derives, per
  * ARCHITECTURE.md's invariant), `resource_items.is_external` is a pure
  * scope check computed the same way at crawl time
- * (`@nitpicker/crawler`'s `Crawler#handleResources`: `findScopeEntry(url, this.#scope)
- * === null`). Concat's merged scope is a union of every source's roots,
+ * (`@nitpicker/crawler`'s `Crawler#handleResources`:
+ * `findScopeEntry(url, this.#scope) === null`). Concat's merged scope is a union of every source's roots,
  * so a resource one source recorded as external can legitimately become
  * internal-by-scope in the output even though nothing about the resource
  * itself changed — recomputing this is the resource-table equivalent of

package/lib/utils/array/each-splitted.js

@@ -10,5 +10,5 @@ import { splitArray } from '@d-zero/shared/split-array';
  */
 export async function eachSplitted(a, count, callback) {
     const splitted = splitArray(a, count);
-    await Promise.all(splitted.map((items) => callback(items)));
+    await Promise.all(splitted.map((items) => Promise.resolve(callback(items))));
 }

package/lib/utils/types/types.d.ts

@@ -166,7 +166,7 @@ export interface MainContentsMainTag {
     role: string | null;
     /**
      * A simple diagnostic CSS selector built from tag + id + classes
-     * (not `@medv/finder`). // cspell:disable-line
+     * (not `@medv/finder`).
      */
     selector: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nitpicker/archive",
-	"version": "0.25.0",
+	"version": "0.25.1",
 	"description": "Read/write layer for .nitpicker archives (SQLite schema, migration, cache, concat/split, template classification)",
 	"author": "D-ZERO",
 	"license": "Apache-2.0",
@@ -342,9 +342,9 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"@d-zero/fs": "0.2.7",
-		"@d-zero/shared": "0.23.0",
-		"@nitpicker/core": "0.25.0",
+		"@d-zero/fs": "0.2.8",
+		"@d-zero/shared": "0.23.2",
+		"@nitpicker/core": "0.25.1",
 		"debug": "4.4.3",
 		"fs-extra": "11.4.1",
 		"knex": "3.3.0",
@@ -357,5 +357,5 @@
 		"@types/tar": "7.0.87",
 		"@types/unzipper": "0.10.11"
 	},
-	"gitHead": "fb258acf112366504c6dbb44b69a25bbc528fa30"
+	"gitHead": "fa839178ea8f40e92fc742e0480c6cfbbb8fb01f"
 }