@nitpicker/crawler 0.18.0 → 0.19.0

package/lib/archive/meta/technologies/technology-signal-definitions.js

@@ -0,0 +1,193 @@
+/**
+ * Fixed fingerprint list for the frontend frameworks this module detects via
+ * structural signals (URL path fragments, HTML markers, scoped-attribute
+ * conventions). Deliberately a TypeScript array, not an external config
+ * file (per the accepted design: precision/coverage is refined by editing
+ * this file, not by runtime configuration).
+ *
+ * Every framework here is ALSO detectable via {@link WAPPALYZER_PROVIDER_TO_TECHNOLOGY}
+ * when beholder's Wappalyzer pass independently reports it — the two signal
+ * sources compound in `combineTechnologyConfidence` rather than one
+ * replacing the other. Wappalyzer detects many more technologies than the
+ * frameworks listed here (analytics, CMSes, ...); those pass through with
+ * the provider name verbatim as the technology name, uncurated.
+ * @module
+ */
+export const TECHNOLOGY_SIGNAL_DEFINITIONS = [
+    // Next.js
+    {
+        technology: 'Next.js',
+        signalType: 'html-marker',
+        pattern: /<script[^>]*\sid="__NEXT_DATA__"/i,
+        weight: 70,
+        category: 'JavaScript frameworks',
+    },
+    {
+        technology: 'Next.js',
+        signalType: 'html-marker',
+        pattern: /<div[^>]*\sid="__next"/i,
+        weight: 60,
+        category: 'JavaScript frameworks',
+    },
+    {
+        technology: 'Next.js',
+        signalType: 'url-pattern',
+        pattern: /\/_next\//,
+        weight: 50,
+        category: 'JavaScript frameworks',
+    },
+    // Astro
+    {
+        technology: 'Astro',
+        signalType: 'html-marker',
+        pattern: /<astro-island\b/i,
+        weight: 65,
+        category: 'Static site generator',
+    },
+    {
+        technology: 'Astro',
+        signalType: 'url-pattern',
+        pattern: /\/_astro\//,
+        weight: 50,
+        category: 'Static site generator',
+    },
+    {
+        technology: 'Astro',
+        signalType: 'scoped-attr',
+        pattern: /\sdata-astro-cid-[a-z0-9]+/i,
+        weight: 40,
+        category: 'Static site generator',
+    },
+    // Vue
+    {
+        technology: 'Vue',
+        signalType: 'scoped-attr',
+        pattern: /\sdata-v-[a-z0-9]{6,10}\b/i,
+        weight: 40,
+        category: 'JavaScript frameworks',
+    },
+    {
+        technology: 'Vue',
+        signalType: 'weak-marker',
+        pattern: /\sid="app"/i,
+        weight: 15,
+        category: 'JavaScript frameworks',
+    },
+    {
+        technology: 'Vue',
+        signalType: 'js-license-comment',
+        pattern: /\/\*!\s*\*\s*Vue\.js v\d/i,
+        weight: 55,
+        category: 'JavaScript frameworks',
+    },
+    // Nuxt
+    {
+        technology: 'Nuxt',
+        signalType: 'html-marker',
+        pattern: /<div[^>]*\sid="__nuxt"/i,
+        weight: 60,
+        category: 'JavaScript frameworks',
+    },
+    {
+        technology: 'Nuxt',
+        signalType: 'url-pattern',
+        pattern: /\/_nuxt\//,
+        weight: 50,
+        category: 'JavaScript frameworks',
+    },
+    // Svelte / SvelteKit
+    {
+        technology: 'Svelte',
+        signalType: 'scoped-attr',
+        pattern: /class="[^"]*\bsvelte-[a-z0-9]{6,8}\b/i,
+        weight: 40,
+        category: 'JavaScript frameworks',
+    },
+    {
+        technology: 'SvelteKit',
+        signalType: 'url-pattern',
+        pattern: /\/_app\/immutable\//,
+        weight: 50,
+        category: 'JavaScript frameworks',
+    },
+    // Remix
+    {
+        technology: 'Remix',
+        signalType: 'html-marker',
+        pattern: /window\.__remixContext\s*=/i,
+        weight: 65,
+        category: 'JavaScript frameworks',
+    },
+    // Gatsby
+    {
+        technology: 'Gatsby',
+        signalType: 'html-marker',
+        pattern: /<div[^>]*\sid="___gatsby"/i,
+        weight: 65,
+        category: 'Static site generator',
+    },
+    {
+        technology: 'Gatsby',
+        signalType: 'url-pattern',
+        pattern: /\/page-data\//,
+        weight: 50,
+        category: 'Static site generator',
+    },
+    // Angular
+    {
+        technology: 'Angular',
+        signalType: 'html-marker',
+        pattern: /\sng-version="[\d.]+"/i,
+        weight: 65,
+        category: 'JavaScript frameworks',
+    },
+    {
+        technology: 'Angular',
+        signalType: 'scoped-attr',
+        pattern: /\s_ngcontent-[a-z0-9-]+/i,
+        weight: 40,
+        category: 'JavaScript frameworks',
+    },
+];
+/**
+ * `<meta name="generator">` prefix matchers, checked case-insensitively
+ * against `page_meta.generator` (already extracted — no new HTML scan
+ * needed). Distinct from {@link TECHNOLOGY_SIGNAL_DEFINITIONS} because the
+ * match strategy is prefix-on-a-known-field, not regex-over-HTML.
+ */
+export const GENERATOR_TECHNOLOGY_MATCHERS = [
+    { technology: 'Astro', prefix: 'astro', weight: 85, category: 'Static site generator' },
+    { technology: 'Nuxt', prefix: 'nuxt', weight: 85, category: 'JavaScript frameworks' },
+    {
+        technology: 'Gatsby',
+        prefix: 'gatsby',
+        weight: 85,
+        category: 'Static site generator',
+    },
+];
+/**
+ * Wappalyzer provider name → normalized technology name, for the curated
+ * frameworks that also have {@link TECHNOLOGY_SIGNAL_DEFINITIONS}. Providers
+ * NOT in this map still become `page_technologies` rows — the technology
+ * name is just the provider name verbatim (see `normalize-wappalyzer-entries.ts`)
+ * — this map exists only to fold curated frameworks' Wappalyzer detections
+ * onto the same technology name their structural signals use, so the two
+ * sources compound instead of appearing as two separate rows.
+ */
+export const WAPPALYZER_PROVIDER_TO_TECHNOLOGY = {
+    'Next.js': 'Next.js',
+    Astro: 'Astro',
+    'Vue.js': 'Vue',
+    'Nuxt.js': 'Nuxt',
+    Nuxt: 'Nuxt',
+    Svelte: 'Svelte',
+    SvelteKit: 'SvelteKit',
+    Remix: 'Remix',
+    Gatsby: 'Gatsby',
+    Angular: 'Angular',
+    AngularJS: 'Angular',
+};
+/** Confidence a lone `wappalyzer` signal contributes, before compounding with any structural signal. */
+export const WAPPALYZER_SIGNAL_WEIGHT = 60;
+/** Confidence threshold (`combineTechnologyConfidence`'s output) at or above which a `page_technologies` row is written at all. Below this, a single weak/ambiguous signal is treated as noise, not a detection. */
+export const TECHNOLOGY_CONFIDENCE_THRESHOLD = 30;

package/lib/archive/meta/technologies/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Domain types for technology-signal extraction (crawl time) and confidence
+ * roll-up. Kept in this dedicated `technologies/types.ts` rather than the
+ * parent `meta/types.ts` because these types are internal to the extraction
+ * pipeline (`match-structural-technology-signals.ts` →
+ * `combine-technology-confidence.ts` → `extract-technologies-for-archive.ts`)
+ * and never cross the `archive/meta/types.ts` boundary that the persisted
+ * `technology_signals` / `page_technologies` row shapes (`TechnologySignalRow`
+ * / `PageTechnologyRow`) live in — see the repo-wide `型は types.ts に集約`
+ * rule, applied per-module rather than globally so this module's internal
+ * vocabulary does not leak into the db-ops layer's public row types.
+ */
+/**
+ * How a technology signal was detected. `wappalyzer` is beholder's
+ * `simple-wappalyzer`-based detection (imprecise on its own for frameworks,
+ * but authoritative for the long tail of non-framework technologies —
+ * analytics, CMSes, etc. — this module does not otherwise attempt to
+ * detect). The rest are structural signals this module detects itself.
+ */
+export type TechnologySignalType = 'wappalyzer' | 'meta-generator' | 'html-marker' | 'url-pattern' | 'scoped-attr' | 'weak-marker' | 'js-license-comment';
+/**
+ * One un-combined signal for one technology on one page. The unit that
+ * `combineTechnologyConfidence` groups (by `technology`) and reduces via
+ * noisy-OR into a single {@link PageTechnologyPartial} per technology.
+ */
+export interface TechnologySignalPartial {
+    /** Normalized technology name (e.g. `'Next.js'`, `'Google Analytics'`). */
+    technology: string;
+    signalType: TechnologySignalType;
+    /** Matched fragment or raw value, truncated to ~200 chars by the caller. `null` when the signal type carries no useful excerpt. */
+    evidence: string | null;
+    /** This signal's confidence in isolation, 0-100. */
+    weight: number;
+    /** Wappalyzer/generator-reported category, when this signal type can supply one. */
+    category?: string | null;
+    /** Wappalyzer/generator-reported version, when this signal type can supply one. */
+    version?: string | null;
+}
+/**
+ * One technology's combined roll-up for one page, before the `pageId` is
+ * known (added by the caller at insert time — same "id injected at write
+ * time" pattern as {@link import('../types.js').TagRowForInsert}).
+ */
+export interface PageTechnologyPartial {
+    technology: string;
+    category: string | null;
+    version: string | null;
+    /** `combineTechnologyConfidence`'s noisy-OR result, 0-100. */
+    confidence: number;
+    /** Count of distinct `signalType`s that contributed to `confidence`. */
+    signalCount: number;
+}
+/**
+ * A single fingerprint definition: one technology matched by one signal
+ * type via one regular expression, at one isolated weight. Multiple
+ * definitions may share a `technology` (different signal types/patterns)
+ * — {@link combineTechnologyConfidence} is what lets those compound.
+ */
+export interface TechnologySignalDefinition {
+    technology: string;
+    signalType: 'html-marker' | 'url-pattern' | 'scoped-attr' | 'weak-marker' | 'js-license-comment';
+    /** Tested against the page's raw HTML string (or, for `js-license-comment`, a JS resource's leading bytes). */
+    pattern: RegExp;
+    /** This definition's confidence in isolation, 0-100, when `pattern` matches. */
+    weight: number;
+    /** Category to attach to the technology when only this signal fired. */
+    category?: string;
+}

package/lib/archive/meta/technologies/types.js

@@ -0,0 +1,13 @@
+/**
+ * Domain types for technology-signal extraction (crawl time) and confidence
+ * roll-up. Kept in this dedicated `technologies/types.ts` rather than the
+ * parent `meta/types.ts` because these types are internal to the extraction
+ * pipeline (`match-structural-technology-signals.ts` →
+ * `combine-technology-confidence.ts` → `extract-technologies-for-archive.ts`)
+ * and never cross the `archive/meta/types.ts` boundary that the persisted
+ * `technology_signals` / `page_technologies` row shapes (`TechnologySignalRow`
+ * / `PageTechnologyRow`) live in — see the repo-wide `型は types.ts に集約`
+ * rule, applied per-module rather than globally so this module's internal
+ * vocabulary does not leak into the db-ops layer's public row types.
+ */
+export {};

package/lib/archive/meta/types.d.ts

@@ -122,6 +122,7 @@ export interface PageDenormalizedColumns {
  *   main_content_video_count: 0,
  *   main_content_audio_count: 0,
  *   main_content_canvas_count: 0,
+ *   main_content_custom_element_count: 0,
  *   scroll_height_desktop: 3200,
  *   scroll_height_mobile: 5400,
  * };
@@ -157,6 +158,16 @@ export interface MainContentsDenormalizedColumns {
     main_content_audio_count: number | null;
     /** Number of canvases within the main region, or `null`. */
     main_content_canvas_count: number | null;
+    /**
+     * Number of Web Components (custom elements) within the main region, or
+     * `null`. Unlike its siblings above, `null` is not solely "page not
+     * rendered" — it also covers "rendered, but nitpicker's own
+     * `captureCustomElements` best-effort capture failed" (a distinct state
+     * from "captured, zero found" = `0`), since this column is not sourced
+     * from beholder's `MainContentsData` at all. See
+     * `compute-main-contents-denormalized.ts`.
+     */
+    main_content_custom_element_count: number | null;
     /** `document.body.scrollHeight` at the desktop-compact preset, or `null`. */
     scroll_height_desktop: number | null;
     /** `document.body.scrollHeight` at the mobile-small preset, or `null`. */
@@ -356,6 +367,27 @@ export interface MainContentCanvasRow {
     /** IDL bitmap height. */
     height: number;
 }
+/**
+ * One row in the `page_main_content_custom_elements` table. Unlike its
+ * seven `MainContentXxxRow` siblings, the source data is not beholder's
+ * `MainContentsData` but nitpicker's own `capture-custom-elements.ts`.
+ * @example
+ * const row: MainContentCustomElementRow = { id: 1, pageId: 42, order: 0, nodeName: 'MY-WIDGET', elementId: 'widget-1', classList: '["foo"]' };
+ */
+export interface MainContentCustomElementRow {
+    /** Auto-increment primary key. */
+    id: number;
+    /** FK to `content_items.id`. */
+    pageId: number;
+    /** 0-based DOM traversal order within the main content region. */
+    order: number;
+    /** The element's `nodeName` (e.g. `'MY-WIDGET'`). */
+    nodeName: string;
+    /** The element's `id` attribute, or `null`. */
+    elementId: string | null;
+    /** JSON-encoded array of the element's CSS classes, or `null`. */
+    classList: string | null;
+}
 /**
  * One row in the `page_jsonld` table.
  *
@@ -474,6 +506,71 @@ export interface TagRow {
  * };
  */
 export type TagRowForInsert = Omit<TagRow, 'id'>;
+/**
+ * One row in the `technology_signals` table — one un-combined signal for
+ * one technology on one page. See
+ * `archive/meta/technologies/types.ts#TechnologySignalPartial` for the
+ * pre-insert shape (no `pageId`/`id`) this is built from.
+ * @example
+ * const row: TechnologySignalRow = {
+ *   id: 1,
+ *   pageId: 42,
+ *   technology: 'Next.js',
+ *   signalType: 'html-marker',
+ *   evidence: '<script id="__NEXT_DATA__"',
+ *   weight: 70,
+ * };
+ */
+export interface TechnologySignalRow {
+    /** Auto-increment primary key. */
+    id: number;
+    /** FK to `content_items.id`. */
+    pageId: number;
+    /** Normalized technology name (e.g. `'Next.js'`, `'Google Analytics'`). */
+    technology: string;
+    /** How this signal was detected. */
+    signalType: 'wappalyzer' | 'meta-generator' | 'html-marker' | 'url-pattern' | 'scoped-attr' | 'weak-marker' | 'js-license-comment';
+    /** Matched fragment or raw value, truncated to ~200 chars, or `null`. */
+    evidence: string | null;
+    /** This signal's confidence in isolation, 0-100. */
+    weight: number;
+}
+/** Insert shape for {@link TechnologySignalRow}. */
+export type TechnologySignalRowForInsert = Omit<TechnologySignalRow, 'id'>;
+/**
+ * One row in the `page_technologies` table — the confidence-combined
+ * roll-up of every {@link TechnologySignalRow} for one technology on one
+ * page. Read-optimised counterpart of `technology_signals`, analogous to
+ * `page_meta.tag_count` being the roll-up of `page_tags` — except here the
+ * roll-up is a full row, not just a count, because `confidence` is a
+ * per-technology computed value (`combineTechnologyConfidence`), not a
+ * simple count.
+ * @example
+ * const row: PageTechnologyRow = {
+ *   id: 1,
+ *   pageId: 42,
+ *   technology: 'Next.js',
+ *   category: 'JavaScript frameworks',
+ *   version: null,
+ *   confidence: 80,
+ *   signalCount: 2,
+ * };
+ */
+export interface PageTechnologyRow {
+    /** Auto-increment primary key. */
+    id: number;
+    /** FK to `content_items.id`. */
+    pageId: number;
+    technology: string;
+    category: string | null;
+    version: string | null;
+    /** `combineTechnologyConfidence`'s noisy-OR result, 0-100. */
+    confidence: number;
+    /** Count of distinct `signalType`s that contributed to `confidence`. */
+    signalCount: number;
+}
+/** Insert shape for {@link PageTechnologyRow}. */
+export type PageTechnologyRowForInsert = Omit<PageTechnologyRow, 'id'>;
 /**
  * Summary of one page's JSON-LD entries returned by `get-page-detail`.
  *
@@ -495,36 +592,6 @@ export interface JsonLdSummary {
     /** Number of entries that failed to parse (i.e. have a non-null `parseError`). */
     parseErrorCount: number;
 }
-/**
- * Summary of one page's Wappalyzer tags returned by `get-page-detail`.
- * @see summarize-tags.ts
- * @example
- * const summary: TagsSummary = {
- *   count: 2,
- *   providerIds: { 'Google Analytics': ['G-XXXX'], YouTube: [] },
- * };
- */
-export interface TagsSummary {
-    /** Total tag rows for the page. */
-    count: number;
-    /** Provider → list of external IDs (unique, sorted). Providers with no IDs map to `[]`. */
-    providerIds: Readonly<Record<string, readonly string[]>>;
-}
-/**
- * One row of {@link import('@d-zero/beholder').Meta.tags.detected} after
- * archive-side flattening.
- *
- * Used by `get-tag-inventory` to return per-provider page counts across the
- * whole site.
- * @example
- * const entry: TagInventoryEntry = { provider: 'Google Tag Manager', pageCount: 120 };
- */
-export interface TagInventoryEntry {
-    /** Wappalyzer provider name. */
-    provider: string;
-    /** Number of distinct pages where the provider was detected. */
-    pageCount: number;
-}
 /**
  * Error thrown by `assert-compatible-version` when the archive's
  * `info.version` is older than the format version this build accepts.

package/lib/archive/migrate-content-items-alias-of-id.d.ts

@@ -43,5 +43,10 @@ import type { Knex } from 'knex';
  * runs (after `initSchema`, itself after `assertCompatibleVersion` rejects
  * pre-0.13 archives) the table is always present.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export declare function migrateContentItemsAliasOfId(instance: Knex): Promise<void>;
+export declare function migrateContentItemsAliasOfId(instance: Knex, onLog?: (message: string) => void): Promise<void>;

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

@@ -42,8 +42,13 @@
  * runs (after `initSchema`, itself after `assertCompatibleVersion` rejects
  * pre-0.13 archives) the table is always present.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export async function migrateContentItemsAliasOfId(instance) {
+export async function migrateContentItemsAliasOfId(instance, onLog) {
     const hasContentItems = await instance.schema.hasTable('content_items');
     if (!hasContentItems) {
         return;
@@ -51,8 +56,14 @@ export async function migrateContentItemsAliasOfId(instance) {
     const hasColumn = await instance.schema.hasColumn('content_items', 'alias_of_id');
     if (!hasColumn) {
         await instance.raw('ALTER TABLE content_items ADD COLUMN alias_of_id INTEGER REFERENCES content_items(id) DEFERRABLE INITIALLY DEFERRED');
-        // eslint-disable-next-line no-console
-        console.error('[migrate] content_items.alias_of_id column added');
+        const message = '[migrate] content_items.alias_of_id column added';
+        if (onLog) {
+            onLog(message);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.error(message);
+        }
     }
     await instance.raw('CREATE INDEX IF NOT EXISTS idx_content_items_alias_of_id ON content_items(alias_of_id)');
 }

package/lib/archive/migrate-content-items-dedupe-cap-event-id.d.ts

@@ -33,9 +33,14 @@ import type { Knex } from 'knex';
  * (after `initSchema`, itself after `assertCompatibleVersion` rejects
  * pre-0.13 archives) the table is always present.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  * @example
  * ```ts
  * await migrateContentItemsDedupeCapEventId(knex);
  * ```
  */
-export declare function migrateContentItemsDedupeCapEventId(instance: Knex): Promise<void>;
+export declare function migrateContentItemsDedupeCapEventId(instance: Knex, onLog?: (message: string) => void): Promise<void>;

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

@@ -32,12 +32,17 @@
  * (after `initSchema`, itself after `assertCompatibleVersion` rejects
  * pre-0.13 archives) the table is always present.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  * @example
  * ```ts
  * await migrateContentItemsDedupeCapEventId(knex);
  * ```
  */
-export async function migrateContentItemsDedupeCapEventId(instance) {
+export async function migrateContentItemsDedupeCapEventId(instance, onLog) {
     const hasContentItems = await instance.schema.hasTable('content_items');
     if (!hasContentItems) {
         return;
@@ -45,7 +50,13 @@ export async function migrateContentItemsDedupeCapEventId(instance) {
     const hasColumn = await instance.schema.hasColumn('content_items', 'dedupe_cap_event_id');
     if (!hasColumn) {
         await instance.raw('ALTER TABLE content_items ADD COLUMN dedupe_cap_event_id INTEGER REFERENCES dedupe_cap_events(id) DEFERRABLE INITIALLY DEFERRED');
-        // eslint-disable-next-line no-console
-        console.error('[migrate] content_items.dedupe_cap_event_id column added');
+        const message = '[migrate] content_items.dedupe_cap_event_id column added';
+        if (onLog) {
+            onLog(message);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.error(message);
+        }
     }
 }

package/lib/archive/migrate-info-main-content-selector.d.ts

@@ -7,5 +7,10 @@ import type { Knex } from 'knex';
  * idempotent, and self-healing for archives whose provisioning crashed
  * partway through.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export declare function migrateInfoMainContentSelector(instance: Knex): Promise<void>;
+export declare function migrateInfoMainContentSelector(instance: Knex, onLog?: (message: string) => void): Promise<void>;

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

@@ -6,8 +6,13 @@
  * idempotent, and self-healing for archives whose provisioning crashed
  * partway through.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export async function migrateInfoMainContentSelector(instance) {
+export async function migrateInfoMainContentSelector(instance, onLog) {
     const hasInfo = await instance.schema.hasTable('info');
     if (!hasInfo) {
         return;
@@ -19,6 +24,12 @@ export async function migrateInfoMainContentSelector(instance) {
     await instance.schema.table('info', (t) => {
         t.string('mainContentSelector');
     });
-    // eslint-disable-next-line no-console
-    console.error('[migrate] info.mainContentSelector column added');
+    const message = '[migrate] info.mainContentSelector column added';
+    if (onLog) {
+        onLog(message);
+    }
+    else {
+        // eslint-disable-next-line no-console
+        console.error(message);
+    }
 }

package/lib/archive/migrate-info-roots.d.ts

@@ -11,5 +11,10 @@ import type { Knex } from 'knex';
  * performed), a single notice is written to stderr so the user knows the
  * file was upgraded.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export declare function migrateInfoRoots(instance: Knex): Promise<void>;
+export declare function migrateInfoRoots(instance: Knex, onLog?: (message: string) => void): Promise<void>;

package/lib/archive/migrate-info-roots.js

@@ -10,8 +10,13 @@
  * performed), a single notice is written to stderr so the user knows the
  * file was upgraded.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export async function migrateInfoRoots(instance) {
+export async function migrateInfoRoots(instance, onLog) {
     const hasInfo = await instance.schema.hasTable('info');
     if (!hasInfo) {
         return;
@@ -36,6 +41,12 @@ export async function migrateInfoRoots(instance) {
         });
         changes.push('scope dropped');
     }
-    // eslint-disable-next-line no-console
-    console.error(`[migrate] info table upgraded (${changes.join(', ')})`);
+    const message = `[migrate] info table upgraded (${changes.join(', ')})`;
+    if (onLog) {
+        onLog(message);
+    }
+    else {
+        // eslint-disable-next-line no-console
+        console.error(message);
+    }
 }

package/lib/archive/migrate-inventory-runs-exclude-skipped.d.ts

@@ -16,5 +16,10 @@ import type { Knex } from 'knex';
  * only by `listInventoryRuns` display surfaces, never consumed by any
  * runtime decision — matching `scope_skipped` / `invalid_skipped`.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export declare function migrateInventoryRunsExcludeSkipped(instance: Knex): Promise<void>;
+export declare function migrateInventoryRunsExcludeSkipped(instance: Knex, onLog?: (message: string) => void): Promise<void>;

package/lib/archive/migrate-inventory-runs-exclude-skipped.js

@@ -15,8 +15,13 @@
  * only by `listInventoryRuns` display surfaces, never consumed by any
  * runtime decision — matching `scope_skipped` / `invalid_skipped`.
  * @param instance - The Knex query builder instance connected to the database.
+ * @param onLog - Called instead of `console.error` when this migration
+ *   actually applies (issue #294: a bare `console.error` here can fire
+ *   while a `@d-zero/dealer` `Lanes`/`TaskList` display is mid-redraw during
+ *   `Archive.open`, corrupting its cursor tracking). Falls back to
+ *   `console.error` when omitted (direct/test callers).
  */
-export async function migrateInventoryRunsExcludeSkipped(instance) {
+export async function migrateInventoryRunsExcludeSkipped(instance, onLog) {
     const hasTable = await instance.schema.hasTable('inventory_runs');
     if (!hasTable) {
         return;
@@ -28,6 +33,12 @@ export async function migrateInventoryRunsExcludeSkipped(instance) {
     await instance.schema.table('inventory_runs', (t) => {
         t.integer('exclude_skipped');
     });
-    // eslint-disable-next-line no-console
-    console.error('[migrate] inventory_runs.exclude_skipped column added');
+    const message = '[migrate] inventory_runs.exclude_skipped column added';
+    if (onLog) {
+        onLog(message);
+    }
+    else {
+        // eslint-disable-next-line no-console
+        console.error(message);
+    }
 }