@ozzylabs/feedradar 0.1.4 → 0.1.6

package/dist/core/progress.js

@@ -0,0 +1,212 @@
+/**
+ * ProgressReporter — UX abstraction for long-running CLI operations.
+ *
+ * Implements [ADR-0015 Progress Reporting UX](../../docs/adr/0015-progress-reporting-ux.md):
+ *
+ * - 3-layer model (phase markers / heartbeat spinner / side metrics)
+ * - TTY auto-detection with env / flag overrides (`RADAR_NO_PROGRESS=1`,
+ *   `--quiet`, `--verbose`)
+ * - CI / non-TTY safe degradation: spinner becomes plain text and `\r`
+ *   same-line updates are disabled
+ * - Zero new runtime dependencies — the spinner frame set
+ *   (`⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏`) is rotated by an internal `setInterval` and rendered via
+ *   `process.stderr.write` + ANSI escape `\x1b[K\r`
+ *
+ * This is the **base** (#196) — only the interface, the factory, and the
+ * default reporter implementation. CLI integration (`research` / `review` /
+ * `update`) ships in #197, feed adapter integration in #198. Adapter call
+ * sites in `src/agents/*.ts` consume the optional `onProgress` callback
+ * defined alongside this module (see `src/agents/types.ts`).
+ */
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const ANSI_CLEAR_LINE = "\x1b[K";
+/**
+ * No-op reporter. Used by:
+ *
+ * - tests that do not care about progress output
+ * - `--quiet` / `RADAR_NO_PROGRESS=1` paths (see `createProgressReporter`)
+ * - adapter call sites where the caller did not opt into progress
+ *
+ * All six methods return immediately so wiring a `noopProgressReporter()` to
+ * an existing adapter is byte-equivalent to passing `undefined`.
+ */
+export function noopProgressReporter() {
+    return {
+        phase() { },
+        start() { },
+        update() { },
+        succeed() { },
+        fail() { },
+        raw() { },
+    };
+}
+/**
+ * Construct a `ProgressReporter` honouring the ADR-0015 D2 priority table:
+ *
+ *   env (`RADAR_NO_PROGRESS=1`) > flag (`level`) > TTY auto-detect
+ *
+ * - `level: "quiet"` → no-op (callers want zero output)
+ * - `RADAR_NO_PROGRESS=1` → no-op (CI escape hatch)
+ * - non-TTY + `level: "normal"` → plain text (phase markers + completion
+ *   lines, NO spinner animation, NO `\r` overwrite)
+ * - TTY + `level: "normal"` → phase markers + spinner + same-line update
+ * - `level: "verbose"` → phase markers + spinner (if TTY) + `raw()` pass-
+ *   through enabled (regardless of TTY)
+ *
+ * The reporter is self-contained: callers should not depend on internal
+ * state (e.g. the active spinner timer). The contract is the 6-method
+ * interface above.
+ */
+export function createProgressReporter(opts) {
+    // Env escape hatch (D2 table row 1). Honoured even at `level: "verbose"`
+    // — CI environments must be able to opt out unconditionally.
+    if (process.env.RADAR_NO_PROGRESS === "1") {
+        return noopProgressReporter();
+    }
+    if (opts.level === "quiet") {
+        return noopProgressReporter();
+    }
+    const tty = opts.tty ?? Boolean(process.stderr.isTTY);
+    const stream = opts.stream ?? process.stderr;
+    const heartbeatMs = opts.heartbeatMs ?? 1000;
+    const now = opts.now ?? Date.now;
+    const verbose = opts.level === "verbose";
+    // Active spinner state. `null` means no spinner is running.
+    let active = null;
+    function renderSpinnerRow() {
+        if (!active)
+            return "";
+        const elapsedSec = Math.max(0, Math.floor((now() - active.startedAt) / 1000));
+        const mm = String(Math.floor(elapsedSec / 60)).padStart(2, "0");
+        const ss = String(elapsedSec % 60).padStart(2, "0");
+        const frame = SPINNER_FRAMES[active.frame % SPINNER_FRAMES.length];
+        const metricEntries = Object.entries(active.metrics);
+        const metricsSuffix = metricEntries.length > 0 ? `  ${metricEntries.map(([k, v]) => `${k}: ${v}`).join("  ")}` : "";
+        return `${frame} ${active.label} [${mm}:${ss}]${metricsSuffix}`;
+    }
+    function repaint() {
+        if (!active)
+            return;
+        if (tty) {
+            stream.write(`\r${ANSI_CLEAR_LINE}${renderSpinnerRow()}`);
+        }
+    }
+    function clearSpinnerLine() {
+        if (tty && active) {
+            stream.write(`\r${ANSI_CLEAR_LINE}`);
+        }
+    }
+    function stopSpinner() {
+        if (active?.timer) {
+            clearInterval(active.timer);
+        }
+        active = null;
+    }
+    return {
+        phase(name, info) {
+            // Phase markers always claim their own line; clear any active spinner
+            // overwrite first so we don't leave a half-painted row in scrollback.
+            clearSpinnerLine();
+            const suffix = info ? ` (${info})` : "";
+            stream.write(`${name}${suffix}\n`);
+            // Re-paint the spinner row on the new line so it continues to update.
+            repaint();
+        },
+        start(label) {
+            // If a previous spinner was still active, drop it silently — the new
+            // start supersedes it (caller bug, but we don't want to crash).
+            clearSpinnerLine();
+            stopSpinner();
+            active = {
+                label,
+                startedAt: now(),
+                frame: 0,
+                metrics: {},
+                timer: null,
+            };
+            if (tty) {
+                // Paint frame 0 immediately so the user sees something before the
+                // first heartbeat tick fires.
+                repaint();
+                if (heartbeatMs > 0) {
+                    const timer = setInterval(() => {
+                        if (!active)
+                            return;
+                        active.frame += 1;
+                        repaint();
+                    }, heartbeatMs);
+                    // Don't keep the event loop alive just for the spinner — if the
+                    // host process is otherwise idle (e.g. awaiting a child), we still
+                    // want it to exit when the work is done.
+                    if (typeof timer.unref === "function") {
+                        timer.unref();
+                    }
+                    active.timer = timer;
+                }
+            }
+            else {
+                // Non-TTY plain-text degrade: one line per state transition, no `\r`.
+                stream.write(`${label}\n`);
+            }
+        },
+        update(metrics) {
+            if (!active)
+                return;
+            // Merge so successive `update` calls only need to pass the changed
+            // metric (e.g. page index ticks per fetch).
+            active.metrics = { ...active.metrics, ...metrics };
+            if (tty) {
+                repaint();
+            }
+            // On non-TTY we intentionally drop tick updates to avoid spamming the
+            // log with one line per page. The next phase / succeed / fail line
+            // re-states the final metric set.
+        },
+        succeed(label, duration) {
+            const elapsedMs = duration ?? (active ? now() - active.startedAt : 0);
+            const formatted = formatDuration(elapsedMs);
+            clearSpinnerLine();
+            stopSpinner();
+            stream.write(`${label} (${formatted})\n`);
+        },
+        fail(label, reason) {
+            clearSpinnerLine();
+            stopSpinner();
+            stream.write(`${label} — ${reason}\n`);
+        },
+        raw(text) {
+            if (!verbose)
+                return;
+            // Clear the spinner row before flushing pass-through so the agent's
+            // stdout / stderr line doesn't end up appended to the spinner frame.
+            // On non-TTY, the spinner doesn't share a line so clearing is a no-op.
+            clearSpinnerLine();
+            stream.write(text);
+            // If the chunk does not end in a newline, the spinner repaint would
+            // overwrite the tail of the chunk. Insert a soft newline before
+            // re-rendering so the chunk is preserved verbatim in scrollback.
+            if (active && tty && !text.endsWith("\n")) {
+                stream.write("\n");
+            }
+            repaint();
+        },
+    };
+}
+/**
+ * Format an elapsed-time in milliseconds as either `Nms`, `N.Ns`, or
+ * `Nm Ns`. Used by `succeed()` so the completion line carries the actual
+ * sub-task duration without the caller having to compute it.
+ */
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    if (ms < 60_000) {
+        const seconds = (ms / 1000).toFixed(1);
+        return `${seconds}s`;
+    }
+    const minutes = Math.floor(ms / 60_000);
+    const seconds = Math.floor((ms % 60_000) / 1000);
+    return `${minutes}m ${seconds}s`;
+}
+//# sourceMappingURL=progress.js.map

package/dist/core/progress.js.map

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

package/dist/core/recipes.d.ts

@@ -0,0 +1,138 @@
+import { type RecipeFile } from "../schemas/recipe.js";
+/**
+ * Recipe loader and CLI-args merger for `radar source recipes` /
+ * `radar source add --recipe <name>` (ADR-0012 §D3, strategy A — リポ同梱).
+ *
+ * Design notes:
+ *
+ * - Recipes live in `recipes/*.yaml` at the package root and are bundled
+ *   into npm publish via the package.json `files` allowlist plus a copy
+ *   step in `scripts/copy-skills.mjs` (`recipes/` → `dist/recipes/`). The
+ *   resolver tries the compiled location first, then falls back to the
+ *   source tree (used by the test suite and `pnpm test` runs that have
+ *   not built `dist/` yet).
+ *
+ * - The directory is allowed to be empty (#178 adds the actual bundled
+ *   recipes). When the directory is missing entirely the loader behaves
+ *   the same as "no recipes" — the bundle is optional at the schema
+ *   level. The CLI surfaces a friendly "no recipes" message instead of
+ *   an error in that case.
+ *
+ * - Each recipe is independently parse-and-validate so one malformed
+ *   YAML does not prevent the rest from being listed. `listRecipes`
+ *   returns per-recipe `error` strings; `loadRecipe(name)` throws so
+ *   `--recipe <name>` can hard-fail at `source add` time.
+ *
+ * - The recipe's identifier ( `--recipe <name>` match key) is the YAML
+ *   filename stem. There is no inner "name" field that doubles as the
+ *   match key — recipe authors rename the file to rename the recipe.
+ *   `RecipeFile.name` is the *display name* (mirrors `Source.name`).
+ */
+/** A recipe loaded from disk, paired with its filename-derived identifier. */
+export interface LoadedRecipe {
+    /** Filename stem (e.g. `aws-whats-new` for `aws-whats-new.yaml`). */
+    name: string;
+    /** Absolute path of the recipe YAML, useful for error messages. */
+    path: string;
+    recipe: RecipeFile;
+}
+/** Entry returned by `listRecipes`, including malformed recipes (with `error`). */
+export interface RecipeListEntry {
+    name: string;
+    path: string;
+    /** Parsed recipe, or `null` when this entry failed to load (see `error`). */
+    recipe: RecipeFile | null;
+    /** Human-readable error string when the entry could not be loaded. */
+    error?: string;
+}
+/** Options for the loader/lister to override the recipes directory (used by tests). */
+export interface RecipeLoaderOptions {
+    recipesRoot?: string;
+}
+/**
+ * Resolve the directory holding the bundled recipes.
+ *
+ * Compiled layout (npm install): `dist/core/recipes.js` → `../recipes`.
+ * Source layout (tests / `pnpm test`): `src/core/recipes.ts` → `../../recipes`.
+ *
+ * We probe the compiled location first because that is the path users
+ * hit at runtime. Both paths can be present during local development
+ * (after `pnpm run build`); preferring compiled keeps the source tree
+ * from being the active asset directory by accident.
+ */
+export declare function resolveRecipesRoot(): Promise<string>;
+/**
+ * List all bundled recipes by reading every `*.yaml` file in the recipes
+ * directory.
+ *
+ * Behaviour:
+ *
+ * - Missing recipes directory → returns `[]` (treated as "no recipes",
+ *   not an error). This matches the bootstrap state where #178 has not
+ *   yet shipped the actual recipe files.
+ * - Each `.yaml` is independently parsed and Zod-validated. Failures are
+ *   captured in the per-entry `error` field so partial corruption never
+ *   prevents the rest from rendering.
+ * - Entries are sorted by `name` for deterministic output (tests rely on
+ *   this; users get a stable display order).
+ */
+export declare function listRecipes(opts?: RecipeLoaderOptions): Promise<RecipeListEntry[]>;
+/**
+ * Load a single recipe by its filename stem (e.g. `aws-whats-new`).
+ *
+ * Throws on:
+ *
+ * - missing recipes directory (the bundle is absent)
+ * - unknown recipe name (the file does not exist)
+ * - malformed YAML or Zod-schema violation
+ *
+ * The error messages are user-facing — `source add --recipe` surfaces
+ * them via the CLI `error()` sink without further wrapping.
+ */
+export declare function loadRecipe(name: string, opts?: RecipeLoaderOptions): Promise<LoadedRecipe>;
+/**
+ * CLI overrides applied on top of a recipe when generating a Source.
+ *
+ * The whitelist is intentionally narrow:
+ *
+ * - `id` (required) — recipes never carry an `id`; the caller picks one
+ *   per workspace
+ * - `name` (display name) — useful when a single recipe is applied
+ *   multiple times to differentiate, or to localize
+ * - `tags` — workspace-level taxonomy that varies per install
+ * - `filters.keywords` / `filters.excludeKeywords` — the only fields a
+ *   user is reliably expected to override; "what counts as a hit" is
+ *   per-workspace
+ *
+ * Other fields (`pagination`, `jsonSelectors`, `selectors`, `js`,
+ * `http`, `url`, `kind`, `trustLevel`) are NOT overridable from the
+ * CLI. Recipe authors own these "structural" fields. Users edit the
+ * generated `sources/<id>.yaml` if they need to deviate further.
+ */
+export interface RecipeOverrides {
+    /** Required — the source id chosen by the caller. */
+    id: string;
+    /** Optional override for `Source.name` (display name). */
+    name?: string;
+    /** Optional override for `Source.tags` (replaces, does not merge). */
+    tags?: string[];
+    /** Optional override for `filters.keywords` (replaces, does not merge). */
+    keywords?: string[];
+    /** Optional override for `filters.excludeKeywords` (replaces, does not merge). */
+    excludeKeywords?: string[];
+}
+/**
+ * Merge a recipe with CLI overrides to produce a plain object suitable
+ * for `SourceSchema.safeParse`.
+ *
+ * Override semantics: each field is *replaced* (not merged) when the
+ * override is present. This mirrors `source add` flag semantics
+ * (`--keywords a,b` replaces, never appends) and keeps the mental model
+ * uniform across `add` and `add --recipe`.
+ *
+ * `description` from the recipe is dropped — it is recipe metadata,
+ * not Source metadata. Strip it explicitly so the generated YAML does
+ * not carry a stray field that fails downstream schema validation.
+ */
+export declare function mergeRecipeWithOverrides(recipe: RecipeFile, overrides: RecipeOverrides): Record<string, unknown>;
+//# sourceMappingURL=recipes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/core/recipes.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,sBAAsB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uFAAuF;AACvF,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAS1D;AAWD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA8D5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAyDvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,eAAe,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkDzB"}

package/dist/core/recipes.js

@@ -0,0 +1,242 @@
+import { access, readdir, readFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse as parseYaml } from "yaml";
+import { RecipeFileSchema } from "../schemas/recipe.js";
+/**
+ * Resolve the directory holding the bundled recipes.
+ *
+ * Compiled layout (npm install): `dist/core/recipes.js` → `../recipes`.
+ * Source layout (tests / `pnpm test`): `src/core/recipes.ts` → `../../recipes`.
+ *
+ * We probe the compiled location first because that is the path users
+ * hit at runtime. Both paths can be present during local development
+ * (after `pnpm run build`); preferring compiled keeps the source tree
+ * from being the active asset directory by accident.
+ */
+export async function resolveRecipesRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const compiled = resolve(here, "../recipes");
+    if (await pathExists(compiled)) {
+        return compiled;
+    }
+    // Source layout fallback. We walk two levels up from src/core/ to find
+    // the package root, then descend into `recipes/`.
+    return resolve(here, "../../recipes");
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List all bundled recipes by reading every `*.yaml` file in the recipes
+ * directory.
+ *
+ * Behaviour:
+ *
+ * - Missing recipes directory → returns `[]` (treated as "no recipes",
+ *   not an error). This matches the bootstrap state where #178 has not
+ *   yet shipped the actual recipe files.
+ * - Each `.yaml` is independently parsed and Zod-validated. Failures are
+ *   captured in the per-entry `error` field so partial corruption never
+ *   prevents the rest from rendering.
+ * - Entries are sorted by `name` for deterministic output (tests rely on
+ *   this; users get a stable display order).
+ */
+export async function listRecipes(opts = {}) {
+    const root = opts.recipesRoot ?? (await resolveRecipesRoot());
+    if (!(await pathExists(root))) {
+        return [];
+    }
+    let entries;
+    try {
+        entries = await readdir(root);
+    }
+    catch {
+        return [];
+    }
+    // `.gitkeep` (or any other dotfile) must not be picked up as a recipe;
+    // the `*.yaml` glob is enforced by suffix rather than a separate
+    // exclude list.
+    const yamlFiles = entries.filter((f) => f.endsWith(".yaml")).sort();
+    const results = [];
+    for (const filename of yamlFiles) {
+        const path = join(root, filename);
+        const name = filename.slice(0, -".yaml".length);
+        let raw;
+        try {
+            raw = await readFile(path, "utf8");
+        }
+        catch (e) {
+            results.push({
+                name,
+                path,
+                recipe: null,
+                error: `failed to read: ${e instanceof Error ? e.message : String(e)}`,
+            });
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = parseYaml(raw);
+        }
+        catch (e) {
+            results.push({
+                name,
+                path,
+                recipe: null,
+                error: `invalid YAML: ${e instanceof Error ? e.message : String(e)}`,
+            });
+            continue;
+        }
+        const result = RecipeFileSchema.safeParse(parsed);
+        if (!result.success) {
+            const issues = result.error.issues
+                .map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`)
+                .join("; ");
+            results.push({
+                name,
+                path,
+                recipe: null,
+                error: `schema validation failed: ${issues}`,
+            });
+            continue;
+        }
+        results.push({ name, path, recipe: result.data });
+    }
+    return results;
+}
+/**
+ * Load a single recipe by its filename stem (e.g. `aws-whats-new`).
+ *
+ * Throws on:
+ *
+ * - missing recipes directory (the bundle is absent)
+ * - unknown recipe name (the file does not exist)
+ * - malformed YAML or Zod-schema violation
+ *
+ * The error messages are user-facing — `source add --recipe` surfaces
+ * them via the CLI `error()` sink without further wrapping.
+ */
+export async function loadRecipe(name, opts = {}) {
+    // Reject path-separator / traversal characters defensively. `--recipe`
+    // is positional CLI input and could be copied from arbitrary sources;
+    // the same posture as `isSafeSourceId` keeps the lookup confined to
+    // the recipes directory.
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name) || name.includes("..")) {
+        throw new Error(`invalid recipe name '${name}' (must match [A-Za-z0-9][A-Za-z0-9._-]*)`);
+    }
+    const root = opts.recipesRoot ?? (await resolveRecipesRoot());
+    if (!(await pathExists(root))) {
+        throw new Error(`no bundled recipes available (recipes/ not found at ${root}); recipe '${name}' cannot be resolved`);
+    }
+    const path = join(root, `${name}.yaml`);
+    if (!(await pathExists(path))) {
+        // Surface available names so the user can self-correct without having
+        // to run a second command. List failures are swallowed here (best
+        // effort) so the primary error message is the one the user sees.
+        let available = [];
+        try {
+            const all = await listRecipes({ recipesRoot: root });
+            available = all.map((r) => r.name);
+        }
+        catch {
+            // ignore — we already have the primary error to report
+        }
+        const hint = available.length === 0 ? "" : ` (available: ${available.join(", ")})`;
+        throw new Error(`recipe '${name}' not found${hint}`);
+    }
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (e) {
+        throw new Error(`failed to read recipe '${name}': ${e instanceof Error ? e.message : String(e)}`);
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (e) {
+        throw new Error(`invalid YAML in recipe '${name}': ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const result = RecipeFileSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`)
+            .join("; ");
+        throw new Error(`recipe '${name}' failed schema validation: ${issues}`);
+    }
+    return { name, path, recipe: result.data };
+}
+/**
+ * Merge a recipe with CLI overrides to produce a plain object suitable
+ * for `SourceSchema.safeParse`.
+ *
+ * Override semantics: each field is *replaced* (not merged) when the
+ * override is present. This mirrors `source add` flag semantics
+ * (`--keywords a,b` replaces, never appends) and keeps the mental model
+ * uniform across `add` and `add --recipe`.
+ *
+ * `description` from the recipe is dropped — it is recipe metadata,
+ * not Source metadata. Strip it explicitly so the generated YAML does
+ * not carry a stray field that fails downstream schema validation.
+ */
+export function mergeRecipeWithOverrides(recipe, overrides) {
+    // Build the candidate as a fresh object so the recipe object on disk
+    // is not mutated and we get control over field ordering in the output
+    // YAML (id first → kind → url → ...).
+    const candidate = {
+        id: overrides.id,
+        kind: recipe.kind,
+        url: recipe.url,
+    };
+    // Display name: caller override wins, then recipe.name, then nothing.
+    if (overrides.name !== undefined) {
+        candidate.name = overrides.name;
+    }
+    else if (recipe.name !== undefined) {
+        candidate.name = recipe.name;
+    }
+    // Tags: override replaces; otherwise inherit recipe tags (which defaults
+    // to []). Emit only when non-empty so the YAML stays minimal for the
+    // common case "no tags in either place".
+    const tags = overrides.tags ?? recipe.tags;
+    if (tags.length > 0) {
+        candidate.tags = tags;
+    }
+    // Filters: override the include/exclude keyword arrays; preserve the
+    // recipe's other filter knobs (matchMode / matchFields / caseSensitive)
+    // because those reflect adapter-specific tuning that the recipe author
+    // already picked.
+    const mergedFilters = {
+        ...recipe.filters,
+        keywords: overrides.keywords ?? recipe.filters.keywords,
+        excludeKeywords: overrides.excludeKeywords ?? recipe.filters.excludeKeywords,
+    };
+    candidate.filters = mergedFilters;
+    // Structural fields that the recipe owns. Drop undefined entries to
+    // keep the generated YAML free of explicit nulls.
+    if (recipe.selectors !== undefined)
+        candidate.selectors = recipe.selectors;
+    if (recipe.js !== undefined)
+        candidate.js = recipe.js;
+    if (recipe.http !== undefined)
+        candidate.http = recipe.http;
+    if (recipe.pagination !== undefined)
+        candidate.pagination = recipe.pagination;
+    if (recipe.jsonSelectors !== undefined)
+        candidate.jsonSelectors = recipe.jsonSelectors;
+    // Facet sweep (ADR-0017). Recipe-only structural field — caller cannot
+    // override via flags in Phase 1 (see `printAddHelp` for the rationale).
+    if (recipe.facets !== undefined)
+        candidate.facets = recipe.facets;
+    candidate.trustLevel = recipe.trustLevel;
+    return candidate;
+}
+//# sourceMappingURL=recipes.js.map

package/dist/core/recipes.js.map

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