@ozzylabs/feedradar 0.1.1 → 0.1.2

package/dist/core/feeds/html.js

@@ -1,184 +1,9 @@
-import { createHash } from "node:crypto";
-import { parse as parseHtml } from "node-html-parser";
-import { ItemSchema } from "../../schemas/index.js";
-import { deriveItemId, deriveStableKey } from "./derive-id.js";
+import { CONTENT_HASH_PREFIX, contentHash, parseHtmlDocument } from "./_html-common.js";
+// Re-export shared primitives so existing imports (and tests) that pulled
+// `parseHtmlDocument` from this module keep working after the
+// `_html-common.ts` split (ADR-0010 §D1, no behavior change).
+export { parseHtmlDocument } from "./_html-common.js";
 const USER_AGENT = "feedradar/0.0.0 (+https://github.com/ozzy-labs/feedradar)";
-/**
- * Prefix that flags an `lastEtag` slot as carrying a content hash rather than
- * an actual HTTP ETag. We reuse the `lastEtag` field so this Phase does not
- * have to migrate `SourceState` (see `docs/design/source-html.md`).
- */
-const CONTENT_HASH_PREFIX = "sha256:";
-/** Attributes the adapter checks before falling back to text content. */
-const DATETIME_ATTRS = ["datetime", "content", "value"];
-/**
- * Convert an `HTMLElement | null` to its trimmed text, or `undefined` when
- * the selector did not match. We always trim because raw scrapes routinely
- * carry surrounding whitespace from formatted markup.
- */
-function textOf(el) {
-    if (!el)
-        return undefined;
-    const text = el.text?.trim();
-    return text ? text : undefined;
-}
-/**
- * Apply a CSS selector relative to `root` and return the first match.
- * `node-html-parser` returns `null` instead of throwing for invalid input,
- * which matches what callers want here (a missing field, not a hard error).
- */
-function queryFirst(root, selector) {
-    return root.querySelector(selector);
-}
-/**
- * Resolve the `link` selector to an `href` (or text fallback).
- *
- * Anchor tags expose the URL via `href` so we prefer the attribute. When the
- * selector points at a non-anchor (e.g. a `<div data-link>` wrapper used by
- * some changelog layouts), we fall back to text content so the adapter can
- * still operate, deferring URL validation to `ItemSchema`.
- */
-function pickLink(el) {
-    if (!el)
-        return undefined;
-    const href = el.getAttribute("href");
-    if (href && href.trim())
-        return href.trim();
-    return textOf(el);
-}
-/**
- * Resolve `publishedAt` to a candidate string for `new Date()`.
- *
- * `<time datetime="2026-05-12">` and `<meta content="..."/>` markup hide the
- * canonical timestamp in attributes; the visible text is often a
- * localized "May 12, 2026" that is harder to parse reliably. We probe the
- * known attributes first, then fall back to element text.
- */
-function pickDatetime(el) {
-    if (!el)
-        return undefined;
-    for (const attr of DATETIME_ATTRS) {
-        const value = el.getAttribute(attr);
-        if (value && value.trim())
-            return value.trim();
-    }
-    return textOf(el);
-}
-/**
- * Try to parse a candidate timestamp into ISO 8601. Returns `undefined` for
- * unparseable inputs so the item can still be emitted (RSS adapter parity).
- */
-function toIsoDate(value) {
-    if (!value)
-        return undefined;
-    const date = new Date(value);
-    if (Number.isNaN(date.getTime()))
-        return undefined;
-    return date.toISOString();
-}
-/** Collect the trimmed text of every match for `selector`. */
-function collectTags(root, selector) {
-    if (!selector)
-        return undefined;
-    const tags = root
-        .querySelectorAll(selector)
-        .map((el) => el.text?.trim())
-        .filter((t) => !!t && t.length > 0);
-    return tags.length > 0 ? tags : undefined;
-}
-/**
- * Resolve a relative `link` against the source URL.
- *
- * Many sites publish `<a href="/changelog/foo">` rather than absolute URLs;
- * without resolution `ItemSchema`'s `z.string().url()` would drop them. We
- * intentionally swallow `URL` constructor errors so a malformed `link`
- * surfaces as a normal validation drop later instead of breaking the whole
- * fetch.
- */
-function resolveUrl(raw, base) {
-    try {
-        return new URL(raw, base).toString();
-    }
-    catch {
-        return raw;
-    }
-}
-/** Normalize one matched element into an Item, or `null` to drop it. */
-function parseItem(itemEl, selectors, source, fetchedAt) {
-    const title = textOf(queryFirst(itemEl, selectors.title));
-    const linkRaw = pickLink(queryFirst(itemEl, selectors.link));
-    if (!title || !linkRaw)
-        return null;
-    const url = resolveUrl(linkRaw, source.url);
-    const summary = selectors.summary ? textOf(queryFirst(itemEl, selectors.summary)) : undefined;
-    const body = selectors.body ? textOf(queryFirst(itemEl, selectors.body)) : undefined;
-    const publishedAt = selectors.publishedAt
-        ? toIsoDate(pickDatetime(queryFirst(itemEl, selectors.publishedAt)))
-        : undefined;
-    const tags = collectTags(itemEl, selectors.tags);
-    const stableKey = deriveStableKey({
-        url,
-        fallbackHashInputs: [title, publishedAt],
-    });
-    const id = deriveItemId(title, stableKey);
-    // Preserve a structured snapshot of the raw scrape rather than the
-    // `HTMLElement` instance itself — the watcher serializes `raw` to YAML and
-    // we want the on-disk payload to be diff-friendly.
-    const raw = { title, link: linkRaw };
-    if (summary !== undefined)
-        raw.summary = summary;
-    if (body !== undefined)
-        raw.body = body;
-    if (publishedAt !== undefined)
-        raw.publishedAt = publishedAt;
-    if (tags !== undefined)
-        raw.tags = tags;
-    return validateItem({
-        id,
-        sourceId: source.id,
-        title,
-        url,
-        summary,
-        publishedAt,
-        fetchedAt,
-        raw,
-    });
-}
-function validateItem(candidate) {
-    const result = ItemSchema.safeParse(candidate);
-    // Items that fail validation (e.g. unresolvable URL) are dropped silently —
-    // see rss.ts for the same fail-soft rationale.
-    return result.success ? result.data : null;
-}
-/**
- * Parse an HTML document into validated `Item[]` using the source's
- * `selectors`. Exported so tests can drive the parser directly without
- * needing a fake HTTP layer.
- */
-export function parseHtmlDocument(html, source, fetchedAt) {
-    if (!source.selectors) {
-        throw new Error(`html adapter: source '${source.id}' has no selectors`);
-    }
-    const selectors = source.selectors;
-    let root;
-    try {
-        root = parseHtml(html);
-    }
-    catch (e) {
-        throw new Error(`html adapter: failed to parse HTML: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    const itemEls = root.querySelectorAll(selectors.item);
-    return itemEls
-        .map((el) => parseItem(el, selectors, source, fetchedAt))
-        .filter((i) => i !== null);
-}
-/**
- * Compute the sha256 of the raw response body, prefixed so callers can tell
- * it apart from a real ETag inside `SourceState.lastEtag`.
- */
-function contentHash(body) {
-    return `${CONTENT_HASH_PREFIX}${createHash("sha256").update(body).digest("hex")}`;
-}
 /**
  * Issue an HTTP GET with conditional headers. The previous `lastEtag` slot
  * may contain either an actual ETag (mirror RSS behavior) or a `sha256:`

package/dist/core/feeds/html.js.map

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

package/dist/core/feeds/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAKrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAMhE;AAED,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU9C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAMhE;AAED,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/feeds/index.js

@@ -1,10 +1,12 @@
 import { githubReleasesAdapter } from "./github-releases.js";
 import { htmlAdapter } from "./html.js";
+import { htmlJsAdapter } from "./html-js.js";
 import { npmRegistryAdapter } from "./npm-registry.js";
 import { rssAdapter } from "./rss.js";
 const adapters = new Map([
     [rssAdapter.kind, rssAdapter],
     [htmlAdapter.kind, htmlAdapter],
+    [htmlJsAdapter.kind, htmlJsAdapter],
     [githubReleasesAdapter.kind, githubReleasesAdapter],
     [npmRegistryAdapter.kind, npmRegistryAdapter],
 ]);

package/dist/core/feeds/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAA8B;IACpD,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;IAC7B,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAC/B,CAAC,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACnD,CAAC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,CAAC;CAC9C,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAA8B;IACpD,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;IAC7B,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAC/B,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC;IACnC,CAAC,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACnD,CAAC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,CAAC;CAC9C,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/playwright-check.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Detection / install helpers for the optional `playwright` peer dependency
+ * used by the `html-js` feed adapter (ADR-0010).
+ *
+ * The `html-js` adapter resolves Playwright at fetch time via
+ * `await import("playwright")`, so the package is intentionally optional in
+ * `package.json#peerDependenciesMeta`. Two CLI surfaces need to inspect that
+ * resolution outside of the adapter itself:
+ *
+ *   1. `radar doctor` — proactively reports whether Playwright + Chromium are
+ *      installed so users can fix the environment before scheduling a watch.
+ *   2. `radar watch run` — lazily probes Playwright on the first `html-js`
+ *      source so a missing install does not abort the whole run; the affected
+ *      source is skipped with an actionable error, other kinds continue.
+ *
+ * Both paths share the same probe / install helpers here to keep the install
+ * hint and `RADAR_AUTO_INSTALL_CHROMIUM` escape hatch in one place. The escape
+ * hatch exists for CI scenarios where a fresh runner has `playwright` itself
+ * (e.g. via `npm i`) but no browser binary on disk yet.
+ *
+ * Policy choices (intentional, not for adapter to second-guess):
+ *
+ *   - We do NOT auto-install the `playwright` npm package. Global npm installs
+ *     fail in non-obvious ways (permissions, version mismatches with the
+ *     workspace's lockfile), so the user must run `npm i -g playwright`
+ *     themselves and get a clear error from `npm` if it fails.
+ *   - We DO auto-install Chromium when `RADAR_AUTO_INSTALL_CHROMIUM=1` is set
+ *     and Playwright is present. `npx playwright install chromium` is the
+ *     official path, idempotent, and well-supported in CI runners.
+ */
+/**
+ * Minimal Playwright surface this module reasons about. We only need
+ * `chromium.executablePath()` (sync function returning a fs path) — the
+ * fetcher in `feeds/html-js.ts` keeps its own structural type for the launch
+ * subset it actually uses.
+ */
+export interface PlaywrightModuleLike {
+    chromium: {
+        executablePath: () => string;
+    };
+}
+/**
+ * Outcome of a Playwright probe. Discriminated union so callers branch
+ * cleanly on the failure mode without parsing error messages.
+ *
+ * - `ok`: module loaded AND `chromium.executablePath()` points at an
+ *   existing file on disk.
+ * - `module-missing`: `import("playwright")` threw (package not installed).
+ * - `chromium-missing`: module loaded but the executable path is absent.
+ *   The path is included so callers can show it to the user.
+ */
+export type PlaywrightProbeResult = {
+    status: "ok";
+    executablePath: string;
+} | {
+    status: "module-missing";
+    message: string;
+} | {
+    status: "chromium-missing";
+    executablePath: string;
+};
+/**
+ * Test seam: lets unit tests inject a fake importer / `pathExists` so we can
+ * exercise every branch (module missing, chromium missing, ok) without
+ * touching the real Playwright install.
+ *
+ * The real CLI never passes these; defaults are dynamic import + `fs.access`.
+ */
+export interface ProbeOptions {
+    /** Replace dynamic `import("playwright")` (tests only). */
+    importPlaywright?: () => Promise<unknown>;
+    /** Replace fs existence check (tests only). */
+    pathExists?: (p: string) => Promise<boolean>;
+}
+/**
+ * Probe whether Playwright + Chromium are usable from this process.
+ *
+ * Order matters: we MUST surface "module missing" before attempting any
+ * property access — `chromium.executablePath()` would throw with a less
+ * actionable message ("Cannot read properties of undefined").
+ */
+export declare function probePlaywright(options?: ProbeOptions): Promise<PlaywrightProbeResult>;
+/**
+ * User-facing install hint emitted when Playwright (the npm package) is
+ * missing. The text matches the wording in `feeds/html-js.ts#loadPlaywright`
+ * so users see consistent guidance across `doctor` and `watch run`.
+ *
+ * `RADAR_AUTO_INSTALL_CHROMIUM` is mentioned only in the Chromium-missing
+ * branch — auto-installing the npm package itself is intentionally out of
+ * scope (see module header).
+ */
+export declare const PLAYWRIGHT_MODULE_MISSING_HINT: string;
+/**
+ * User-facing install hint emitted when the npm package is present but the
+ * Chromium binary on disk is not. Mentions the auto-install escape hatch
+ * since this is the branch it actually applies to.
+ */
+export declare const CHROMIUM_MISSING_HINT: string;
+/**
+ * Test seam for the spawn used by `installChromium`. Production passes
+ * the real `child_process.spawn`; tests inject a fake that returns a
+ * predetermined exit code without actually launching a subprocess.
+ */
+export type InstallSpawnLike = (command: string, args: readonly string[], options: {
+    cwd?: string;
+    stdio?: "inherit" | "pipe" | "ignore";
+}) => {
+    on(event: "close", listener: (code: number | null) => void): void;
+    on(event: "error", listener: (err: Error) => void): void;
+};
+export interface InstallChromiumOptions {
+    /** Working directory for the spawned `npx`. Defaults to the caller's cwd. */
+    cwd?: string;
+    /** Test seam: swap out `child_process.spawn`. */
+    spawnImpl?: InstallSpawnLike;
+    /** Sink for progress messages (defaults to console.log). */
+    log?: (message: string) => void;
+}
+/**
+ * Spawn `npx playwright install chromium` and resolve when it exits.
+ *
+ * Used by the `RADAR_AUTO_INSTALL_CHROMIUM=1` escape hatch. We pipe output
+ * through `stdio: "inherit"` so the user (or CI logs) sees Playwright's
+ * progress in real time — `npx playwright install` already prints
+ * download URLs and percentages that are helpful debugging signal when the
+ * install fails. Resolves to the child's exit code so callers can decide
+ * whether to retry the original operation.
+ *
+ * Note we explicitly use `npx` (not direct binary lookup) because Playwright
+ * does not expose a JS API for browser install; the CLI is the supported
+ * entrypoint per Playwright docs.
+ */
+export declare function installChromium(options?: InstallChromiumOptions): Promise<number>;
+//# sourceMappingURL=playwright-check.d.ts.map

package/dist/core/playwright-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-check.d.ts","sourceRoot":"","sources":["../../src/core/playwright-check.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,MAAM,CAAC;KAC9B,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAWD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgChG;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,QAE0B,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAEmC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;CAAE,KAC7D;IACH,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;CAC1D,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3F"}

package/dist/core/playwright-check.js

@@ -0,0 +1,98 @@
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+async function defaultPathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probe whether Playwright + Chromium are usable from this process.
+ *
+ * Order matters: we MUST surface "module missing" before attempting any
+ * property access — `chromium.executablePath()` would throw with a less
+ * actionable message ("Cannot read properties of undefined").
+ */
+export async function probePlaywright(options = {}) {
+    const importPlaywright = options.importPlaywright ?? (() => import("playwright"));
+    const pathExists = options.pathExists ?? defaultPathExists;
+    let mod;
+    try {
+        mod = (await importPlaywright());
+    }
+    catch (e) {
+        return {
+            status: "module-missing",
+            message: e instanceof Error ? e.message : String(e),
+        };
+    }
+    let execPath;
+    try {
+        execPath = mod.chromium.executablePath();
+    }
+    catch (e) {
+        // `executablePath()` raises when no browsers were ever installed via
+        // `npx playwright install`. Treat as the same user-actionable failure as a
+        // missing file on disk; surface an empty path so callers know the message
+        // came from this branch.
+        return {
+            status: "chromium-missing",
+            executablePath: e instanceof Error ? `(${e.message})` : "(unknown)",
+        };
+    }
+    if (!(await pathExists(execPath))) {
+        return { status: "chromium-missing", executablePath: execPath };
+    }
+    return { status: "ok", executablePath: execPath };
+}
+/**
+ * User-facing install hint emitted when Playwright (the npm package) is
+ * missing. The text matches the wording in `feeds/html-js.ts#loadPlaywright`
+ * so users see consistent guidance across `doctor` and `watch run`.
+ *
+ * `RADAR_AUTO_INSTALL_CHROMIUM` is mentioned only in the Chromium-missing
+ * branch — auto-installing the npm package itself is intentionally out of
+ * scope (see module header).
+ */
+export const PLAYWRIGHT_MODULE_MISSING_HINT = "Playwright is required for kind: html-js. Run: npm i -g playwright && npx playwright install chromium\n" +
+    "Or set RADAR_AUTO_INSTALL_CHROMIUM=1 to auto-install on next run.";
+/**
+ * User-facing install hint emitted when the npm package is present but the
+ * Chromium binary on disk is not. Mentions the auto-install escape hatch
+ * since this is the branch it actually applies to.
+ */
+export const CHROMIUM_MISSING_HINT = "Chromium binary not found. Run: npx playwright install chromium\n" +
+    "Or set RADAR_AUTO_INSTALL_CHROMIUM=1 to auto-install on next run.";
+/**
+ * Spawn `npx playwright install chromium` and resolve when it exits.
+ *
+ * Used by the `RADAR_AUTO_INSTALL_CHROMIUM=1` escape hatch. We pipe output
+ * through `stdio: "inherit"` so the user (or CI logs) sees Playwright's
+ * progress in real time — `npx playwright install` already prints
+ * download URLs and percentages that are helpful debugging signal when the
+ * install fails. Resolves to the child's exit code so callers can decide
+ * whether to retry the original operation.
+ *
+ * Note we explicitly use `npx` (not direct binary lookup) because Playwright
+ * does not expose a JS API for browser install; the CLI is the supported
+ * entrypoint per Playwright docs.
+ */
+export async function installChromium(options = {}) {
+    const spawnImpl = options.spawnImpl ?? spawn;
+    const log = options.log ?? ((m) => console.log(m));
+    log("Installing Chromium via `npx playwright install chromium`...");
+    return new Promise((resolve, reject) => {
+        const child = spawnImpl("npx", ["playwright", "install", "chromium"], {
+            cwd: options.cwd,
+            stdio: "inherit",
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+//# sourceMappingURL=playwright-check.js.map

package/dist/core/playwright-check.js.map

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

package/dist/core/watcher.d.ts

@@ -1,5 +1,6 @@
 import type { Item, Source, SourceState } from "../schemas/index.js";
 import type { FeedAdapter, FetchLike } from "./feeds/index.js";
+import { installChromium, type ProbeOptions } from "./playwright-check.js";
 export interface WorkspacePaths {
     /** Workspace root; defaults to process.cwd() at the CLI layer. */
     cwd: string;
@@ -24,6 +25,22 @@ export interface WatchRunOptions extends WorkspacePaths {
     log?: (message: string) => void;
     warn?: (message: string) => void;
     error?: (message: string) => void;
+    /**
+     * Override `process.env` lookup. Tests use this to toggle
+     * `RADAR_AUTO_INSTALL_CHROMIUM=1` without poking at the real environment.
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Test seam: replace the Playwright probe used by the lazy `html-js`
+     * pre-check. Production callers leave this unset and the real
+     * `import("playwright")` path runs.
+     */
+    playwrightProbeOptions?: ProbeOptions;
+    /**
+     * Test seam: replace the auto-install function. Tests inject a stub that
+     * records invocation without actually spawning `npx playwright install`.
+     */
+    installChromiumImpl?: typeof installChromium;
 }
 export interface WatchRunResult {
     /** Map of sourceId → detected (filter-passing, not previously seen) items. */

package/dist/core/watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/core/watcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA+C/D,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC;IACnD,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,6EAA6E;IAC7E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAWD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkHhF;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAQ9D"}
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/core/watcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAK/D,OAAO,EAEL,eAAe,EAGf,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AA2C/B,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC;IACnD,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,YAAY,CAAC;IACtC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,eAAe,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,6EAA6E;IAC7E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAWD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA+KhF;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAQ9D"}

package/dist/core/watcher.js

@@ -6,6 +6,7 @@ import { getFeedAdapter } from "./feeds/index.js";
 import { filterItems } from "./filter.js";
 import { detectInjection } from "./injection-detector.js";
 import { saveItems } from "./items.js";
+import { CHROMIUM_MISSING_HINT, installChromium, PLAYWRIGHT_MODULE_MISSING_HINT, probePlaywright, } from "./playwright-check.js";
 import { loadSourceState, saveSourceState } from "./state.js";
 async function pathExists(p) {
     try {
@@ -118,6 +119,8 @@ export async function watchRun(options) {
     const warn = options.warn ?? ((m) => console.warn(m));
     const error = options.error ?? ((m) => console.error(m));
     const getAdapter = options.getAdapter ?? getFeedAdapter;
+    const env = options.env ?? process.env;
+    const installImpl = options.installChromiumImpl ?? installChromium;
     const sources = await loadSources(paths.sourcesDir, (m) => warn(`watch run: ${m}`));
     const filtered = options.sourceId ? sources.filter((s) => s.id === options.sourceId) : sources;
     if (filtered.length === 0) {
@@ -130,6 +133,41 @@ export async function watchRun(options) {
         return { detected: {}, states: {}, errors: [] };
     }
     const result = { detected: {}, states: {}, errors: [] };
+    // Lazy Playwright probe cache. We only run the probe when the first
+    // `html-js` source comes up so RSS / GitHub / npm-only workspaces never pay
+    // for the dynamic import. The result is reused across every subsequent
+    // `html-js` source in the same run — both because the install state cannot
+    // realistically change mid-run and because re-probing per source would be
+    // wasteful (and would spawn `npx playwright install` repeatedly when the
+    // auto-install hatch is on but fails for some reason).
+    let playwrightProbe = null;
+    const ensurePlaywrightReady = async () => {
+        if (playwrightProbe !== null)
+            return playwrightProbe;
+        playwrightProbe = await probePlaywright(options.playwrightProbeOptions);
+        // Auto-install escape hatch (CI-friendly, see playwright-check.ts policy).
+        // Triggered only when (a) Playwright itself is present, (b) Chromium is
+        // missing, and (c) the user opted in via env. We re-probe after install
+        // so the cached result reflects post-install reality; if the install
+        // failed the result stays at `chromium-missing` and the source is skipped
+        // with the usual hint.
+        if (playwrightProbe.status === "chromium-missing" && env.RADAR_AUTO_INSTALL_CHROMIUM === "1") {
+            log("watch run: RADAR_AUTO_INSTALL_CHROMIUM=1 detected — attempting to install Chromium...");
+            try {
+                const code = await installImpl({ cwd: paths.cwd, log });
+                if (code === 0) {
+                    playwrightProbe = await probePlaywright(options.playwrightProbeOptions);
+                }
+                else {
+                    warn(`watch run: chromium auto-install exited with code ${code}`);
+                }
+            }
+            catch (e) {
+                warn(`watch run: chromium auto-install failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        return playwrightProbe;
+    };
     for (const source of filtered) {
         const previousState = await loadSourceState(paths.stateDir, source.id);
         let adapter;
@@ -142,6 +180,27 @@ export async function watchRun(options) {
             result.errors.push({ sourceId: source.id, message });
             continue;
         }
+        // Lazy Playwright pre-check for `html-js` sources. Skipping the source
+        // (rather than aborting the whole run) preserves the contract that one
+        // misbehaving source must not block the others — the same shape used for
+        // adapter errors / fetch failures above. The error message embeds the
+        // canonical install hint so the user sees the same wording here as in
+        // `radar doctor`.
+        if (source.kind === "html-js") {
+            const probe = await ensurePlaywrightReady();
+            if (probe.status !== "ok") {
+                const hint = probe.status === "module-missing"
+                    ? PLAYWRIGHT_MODULE_MISSING_HINT
+                    : CHROMIUM_MISSING_HINT;
+                const detail = probe.status === "module-missing"
+                    ? "playwright module not installed"
+                    : `chromium binary missing at '${probe.executablePath}'`;
+                const message = `${detail}\n${hint}`;
+                error(`watch run: '${source.id}' skipped: ${message}`);
+                result.errors.push({ sourceId: source.id, message });
+                continue;
+            }
+        }
         let fetched;
         let nextStatePatch;
         let notModified = false;