@debriefer/sources 1.0.1

package/dist/news/site-search-source.js

@@ -0,0 +1,182 @@
+/**
+ * Configurable site-search source for news and reference sites.
+ *
+ * Uses DuckDuckGo `site:` search to find articles on a specific domain,
+ * picks the best URL based on path preferences, fetches the page,
+ * extracts article content, and returns a sanitized finding.
+ *
+ * This is the reusable base that 19+ news/reference source factories
+ * instantiate with different SiteSearchConfig values (AP, BBC, Reuters, etc.).
+ */
+import { BaseResearchSource, } from "@debriefer/core";
+import { searchDuckDuckGo } from "../shared/duckduckgo-search.js";
+import { fetchPage } from "../shared/fetch-page.js";
+import { extractArticleContent } from "../shared/readability-extract.js";
+import { sanitizeSourceText } from "../shared/sanitize-text.js";
+// ============================================================================
+// pickBestUrl
+// ============================================================================
+/**
+ * Pick the best URL from search results based on path preferences.
+ *
+ * Scoring:
+ * - +10 for each preferredPaths match found in the URL pathname
+ * - -10 for each avoidPaths match found in the URL pathname
+ * - Returns highest-scored URL, falling back to first result
+ * - Returns null for empty array
+ *
+ * @param results - Array of search results from DDG
+ * @param options - Optional path preference configuration
+ * @returns The best URL string, or null if no results
+ */
+export function pickBestUrl(results, options) {
+    if (results.length === 0) {
+        return null;
+    }
+    const preferredPaths = options?.preferredPaths ?? [];
+    const avoidPaths = options?.avoidPaths ?? [];
+    // If no preferences, return first result
+    if (preferredPaths.length === 0 && avoidPaths.length === 0) {
+        return results[0].url;
+    }
+    let bestUrl = results[0].url;
+    let bestScore = -Infinity;
+    for (const result of results) {
+        let score = 0;
+        let pathname;
+        try {
+            pathname = new URL(result.url).pathname;
+        }
+        catch {
+            // If URL is unparseable, treat pathname as empty
+            pathname = "";
+        }
+        for (const preferred of preferredPaths) {
+            if (pathname.includes(preferred)) {
+                score += 10;
+            }
+        }
+        for (const avoid of avoidPaths) {
+            if (pathname.includes(avoid)) {
+                score -= 10;
+            }
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestUrl = result.url;
+        }
+    }
+    return bestUrl;
+}
+// ============================================================================
+// SiteSearchSource
+// ============================================================================
+/**
+ * A configurable research source that searches a specific news/reference
+ * site via DuckDuckGo `site:` queries.
+ *
+ * All metadata (name, type, reliabilityTier, domain, isFree, estimatedCostPerQuery)
+ * is derived from the provided SiteSearchConfig.
+ */
+export class SiteSearchSource extends BaseResearchSource {
+    name;
+    type;
+    reliabilityTier;
+    domain;
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    config;
+    constructor(config, options) {
+        super({ rateLimitMs: config.rateLimitMs ?? 1500, ...options });
+        this.config = config;
+        this.name = config.name;
+        this.type = config.type;
+        this.reliabilityTier = config.reliabilityTier;
+        this.domain = config.domain;
+    }
+    /**
+     * Build search query for this subject.
+     *
+     * Format: `"subject name" queryTerms` (queryTerms omitted if empty).
+     */
+    buildQuery(subject) {
+        const base = `"${subject.name}"`;
+        if (this.config.queryTerms) {
+            return `${base} (${this.config.queryTerms})`;
+        }
+        return base;
+    }
+    /**
+     * Fetch a finding from this news/reference site.
+     *
+     * Pipeline:
+     * 1. Search DDG with `site:domain` filter
+     * 2. Pick best URL based on path preferences
+     * 3. Fetch the page
+     * 4. Extract article content via Readability
+     * 5. Check minimum content length
+     * 6. Sanitize text
+     * 7. Return RawFinding with metadata
+     */
+    async fetchResult(subject, signal) {
+        const query = this.buildQuery(subject);
+        // Build domain filter: primary domain, plus additional domains via OR
+        const allDomains = [this.config.domain, ...(this.config.additionalDomains ?? [])];
+        // Search each domain and collect all results
+        const allResults = [];
+        for (const domain of allDomains) {
+            const results = await searchDuckDuckGo({ query, domainFilter: domain, signal });
+            allResults.push(...results);
+        }
+        if (allResults.length === 0) {
+            return null;
+        }
+        // Pick best URL
+        const bestUrl = pickBestUrl(allResults, {
+            preferredPaths: this.config.preferredPaths,
+            avoidPaths: this.config.avoidPaths,
+        });
+        if (!bestUrl) {
+            return null;
+        }
+        // Fetch the page
+        const page = await fetchPage({ url: bestUrl, signal });
+        if (page.fetchMethod === "none" || !page.content) {
+            return null;
+        }
+        // Extract article content
+        const actualUrl = page.url || bestUrl;
+        const extracted = extractArticleContent(page.content, actualUrl);
+        if (!extracted) {
+            return null;
+        }
+        // Check minimum content length
+        const minContentLength = this.config.minContentLength ?? 200;
+        if (extracted.text.length < minContentLength) {
+            return null;
+        }
+        // Sanitize and return
+        const text = sanitizeSourceText(extracted.text);
+        return {
+            text,
+            confidence: -1,
+            costUsd: 0,
+            url: actualUrl,
+            publication: this.config.name,
+            metadata: {
+                title: extracted.title,
+                author: extracted.author,
+                siteName: extracted.siteName,
+                domain: (() => {
+                    try {
+                        return new URL(actualUrl).hostname;
+                    }
+                    catch {
+                        return this.config.domain;
+                    }
+                })(),
+            },
+        };
+    }
+}
+//# sourceMappingURL=site-search-source.js.map

package/dist/news/site-search-source.js.map

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

package/dist/news/sources.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Factory functions for 21 site-search sources (news, reference, obituary).
+ *
+ * Each factory creates a SiteSearchSource configured for a specific
+ * news or reference site, with appropriate reliability tier, path
+ * preferences, and query terms.
+ */
+import { type BaseSourceOptions } from "@debriefer/core";
+import { SiteSearchSource } from "./site-search-source.js";
+/** AP News — general-interest wire service. */
+export declare function apNews(options?: BaseSourceOptions): SiteSearchSource;
+/** BBC News — British public-service broadcaster. */
+export declare function bbcNews(options?: BaseSourceOptions): SiteSearchSource;
+/** Reuters — international news agency. */
+export declare function reuters(options?: BaseSourceOptions): SiteSearchSource;
+/** NPR — U.S. public radio network. */
+export declare function npr(options?: BaseSourceOptions): SiteSearchSource;
+/** The Independent — British broadsheet newspaper. */
+export declare function independent(options?: BaseSourceOptions): SiteSearchSource;
+/** The Telegraph — British broadsheet newspaper. */
+export declare function telegraph(options?: BaseSourceOptions): SiteSearchSource;
+/** The Washington Post — U.S. national newspaper. */
+export declare function washingtonPost(options?: BaseSourceOptions): SiteSearchSource;
+/** Los Angeles Times — U.S. West Coast newspaper. */
+export declare function laTimes(options?: BaseSourceOptions): SiteSearchSource;
+/** Time — U.S. news magazine. */
+export declare function time(options?: BaseSourceOptions): SiteSearchSource;
+/** The New Yorker — U.S. magazine of reportage and commentary. */
+export declare function newYorker(options?: BaseSourceOptions): SiteSearchSource;
+/** PBS — U.S. public television network. */
+export declare function pbs(options?: BaseSourceOptions): SiteSearchSource;
+/** Britannica — general-purpose reference encyclopaedia. */
+export declare function britannica(options?: BaseSourceOptions): SiteSearchSource;
+/** Rolling Stone — music, film, and culture magazine. */
+export declare function rollingStone(options?: BaseSourceOptions): SiteSearchSource;
+/** Smithsonian Magazine — history, science, and culture magazine. */
+export declare function smithsonian(options?: BaseSourceOptions): SiteSearchSource;
+/** National Geographic — science, exploration, and nature magazine. */
+export declare function nationalGeographic(options?: BaseSourceOptions): SiteSearchSource;
+/** History.com — history-focused editorial site (A&E Networks). */
+export declare function historyCom(options?: BaseSourceOptions): SiteSearchSource;
+/** TCM (Turner Classic Movies) — classic film database and editorial. */
+export declare function tcm(options?: BaseSourceOptions): SiteSearchSource;
+/** AllMusic — music reference database. */
+export declare function allMusic(options?: BaseSourceOptions): SiteSearchSource;
+/** People — celebrity and human-interest magazine. */
+export declare function people(options?: BaseSourceOptions): SiteSearchSource;
+/** Biography.com — biographical reference site (A&E Networks). */
+export declare function biographyCom(options?: BaseSourceOptions): SiteSearchSource;
+/** Legacy.com — obituary and memorial aggregator. */
+export declare function legacy(options?: BaseSourceOptions): SiteSearchSource;
+//# sourceMappingURL=sources.d.ts.map

package/dist/news/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/news/sources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAM1D,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAapE;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAarE;AAED,2CAA2C;AAC3C,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAarE;AAED,uCAAuC;AACvC,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAajE;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAazE;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAavE;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAa5E;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAarE;AAED,iCAAiC;AACjC,wBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAalE;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAavE;AAED,4CAA4C;AAC5C,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAajE;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAaxE;AAMD,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAa1E;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAazE;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAahF;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAaxE;AAED,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAajE;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAatE;AAMD,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAapE;AAMD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAY1E;AAMD,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAapE"}

package/dist/news/sources.js

@@ -0,0 +1,276 @@
+/**
+ * Factory functions for 21 site-search sources (news, reference, obituary).
+ *
+ * Each factory creates a SiteSearchSource configured for a specific
+ * news or reference site, with appropriate reliability tier, path
+ * preferences, and query terms.
+ */
+import { ReliabilityTier } from "@debriefer/core";
+import { SiteSearchSource } from "./site-search-source.js";
+// ============================================================================
+// TIER_1_NEWS (0.95)
+// ============================================================================
+/** AP News — general-interest wire service. */
+export function apNews(options) {
+    return new SiteSearchSource({
+        name: "AP News",
+        type: "ap-news",
+        domain: "apnews.com",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 1500,
+        preferredPaths: ["/article/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** BBC News — British public-service broadcaster. */
+export function bbcNews(options) {
+    return new SiteSearchSource({
+        name: "BBC News",
+        type: "bbc-news",
+        domain: "bbc.com",
+        additionalDomains: ["bbc.co.uk"],
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 1500,
+        queryTerms: "profile OR biography OR life story",
+    }, options);
+}
+/** Reuters — international news agency. */
+export function reuters(options) {
+    return new SiteSearchSource({
+        name: "Reuters",
+        type: "reuters",
+        domain: "reuters.com",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/world/", "/lifestyle/", "/entertainment/", "/business/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** NPR — U.S. public radio network. */
+export function npr(options) {
+    return new SiteSearchSource({
+        name: "NPR",
+        type: "npr",
+        domain: "npr.org",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 1500,
+        preferredPaths: ["/sections/", "/music/", "/books/", "/movies/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** The Independent — British broadsheet newspaper. */
+export function independent(options) {
+    return new SiteSearchSource({
+        name: "The Independent",
+        type: "independent",
+        domain: "independent.co.uk",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/arts-entertainment/", "/news/", "/life-style/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** The Telegraph — British broadsheet newspaper. */
+export function telegraph(options) {
+    return new SiteSearchSource({
+        name: "The Telegraph",
+        type: "telegraph",
+        domain: "telegraph.co.uk",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/films/", "/culture/", "/obituaries/", "/news/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** The Washington Post — U.S. national newspaper. */
+export function washingtonPost(options) {
+    return new SiteSearchSource({
+        name: "The Washington Post",
+        type: "washington-post",
+        domain: "washingtonpost.com",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/entertainment/", "/obituaries/", "/style/", "/lifestyle/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** Los Angeles Times — U.S. West Coast newspaper. */
+export function laTimes(options) {
+    return new SiteSearchSource({
+        name: "Los Angeles Times",
+        type: "la-times",
+        domain: "latimes.com",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/entertainment/", "/obituaries/", "/california/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** Time — U.S. news magazine. */
+export function time(options) {
+    return new SiteSearchSource({
+        name: "Time",
+        type: "time",
+        domain: "time.com",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 1500,
+        preferredPaths: ["/entertainment/", "/culture/", "/person-of-the-year/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** The New Yorker — U.S. magazine of reportage and commentary. */
+export function newYorker(options) {
+    return new SiteSearchSource({
+        name: "The New Yorker",
+        type: "new-yorker",
+        domain: "newyorker.com",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/magazine/", "/culture/", "/news/", "/books/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** PBS — U.S. public television network. */
+export function pbs(options) {
+    return new SiteSearchSource({
+        name: "PBS",
+        type: "pbs",
+        domain: "pbs.org",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 1500,
+        preferredPaths: ["/wgbh/", "/newshour/", "/frontline/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** Britannica — general-purpose reference encyclopaedia. */
+export function britannica(options) {
+    return new SiteSearchSource({
+        name: "Britannica",
+        type: "britannica",
+        domain: "britannica.com",
+        reliabilityTier: ReliabilityTier.TIER_1_NEWS,
+        rateLimitMs: 1500,
+        preferredPaths: ["/biography/"],
+        queryTerms: "biography",
+    }, options);
+}
+// ============================================================================
+// TRADE_PRESS (0.9)
+// ============================================================================
+/** Rolling Stone — music, film, and culture magazine. */
+export function rollingStone(options) {
+    return new SiteSearchSource({
+        name: "Rolling Stone",
+        type: "rolling-stone",
+        domain: "rollingstone.com",
+        reliabilityTier: ReliabilityTier.TRADE_PRESS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/music/", "/movies/", "/culture/", "/feature/"],
+        queryTerms: "profile OR biography OR interview",
+    }, options);
+}
+/** Smithsonian Magazine — history, science, and culture magazine. */
+export function smithsonian(options) {
+    return new SiteSearchSource({
+        name: "Smithsonian Magazine",
+        type: "smithsonian",
+        domain: "smithsonianmag.com",
+        reliabilityTier: ReliabilityTier.TRADE_PRESS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/history/", "/biography/", "/people-places/"],
+        queryTerms: "biography",
+    }, options);
+}
+/** National Geographic — science, exploration, and nature magazine. */
+export function nationalGeographic(options) {
+    return new SiteSearchSource({
+        name: "National Geographic",
+        type: "national-geographic",
+        domain: "nationalgeographic.com",
+        reliabilityTier: ReliabilityTier.TRADE_PRESS,
+        rateLimitMs: 1500,
+        preferredPaths: ["/adventure/", "/science/", "/history/"],
+        queryTerms: "profile OR biography",
+    }, options);
+}
+/** History.com — history-focused editorial site (A&E Networks). */
+export function historyCom(options) {
+    return new SiteSearchSource({
+        name: "History.com",
+        type: "history-com",
+        domain: "history.com",
+        reliabilityTier: ReliabilityTier.TRADE_PRESS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/topics/", "/biographies/", "/people/"],
+        queryTerms: "biography",
+    }, options);
+}
+/** TCM (Turner Classic Movies) — classic film database and editorial. */
+export function tcm(options) {
+    return new SiteSearchSource({
+        name: "TCM",
+        type: "tcm",
+        domain: "tcm.com",
+        reliabilityTier: ReliabilityTier.TRADE_PRESS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/tcmdb/person/"],
+        queryTerms: "biography",
+    }, options);
+}
+/** AllMusic — music reference database. */
+export function allMusic(options) {
+    return new SiteSearchSource({
+        name: "AllMusic",
+        type: "all-music",
+        domain: "allmusic.com",
+        reliabilityTier: ReliabilityTier.TRADE_PRESS,
+        rateLimitMs: 2000,
+        preferredPaths: ["/artist/", "/artists/"],
+        queryTerms: "biography",
+    }, options);
+}
+// ============================================================================
+// MARGINAL_EDITORIAL (0.65)
+// ============================================================================
+/** People — celebrity and human-interest magazine. */
+export function people(options) {
+    return new SiteSearchSource({
+        name: "People",
+        type: "people",
+        domain: "people.com",
+        reliabilityTier: ReliabilityTier.MARGINAL_EDITORIAL,
+        rateLimitMs: 1500,
+        avoidPaths: ["/gallery/", "/video/", "/news/", "/shopping/", "/food/"],
+        queryTerms: "profile OR personal life",
+    }, options);
+}
+// ============================================================================
+// SECONDARY_COMPILATION (0.85)
+// ============================================================================
+/** Biography.com — biographical reference site (A&E Networks). */
+export function biographyCom(options) {
+    return new SiteSearchSource({
+        name: "Biography.com",
+        type: "biography-com",
+        domain: "biography.com",
+        reliabilityTier: ReliabilityTier.SECONDARY_COMPILATION,
+        rateLimitMs: 1500,
+        avoidPaths: ["/lists/", "/news/", "/video/", "/gallery/"],
+    }, options);
+}
+// ============================================================================
+// MARGINAL_MIXED (0.6)
+// ============================================================================
+/** Legacy.com — obituary and memorial aggregator. */
+export function legacy(options) {
+    return new SiteSearchSource({
+        name: "Legacy.com",
+        type: "legacy",
+        domain: "legacy.com",
+        reliabilityTier: ReliabilityTier.MARGINAL_MIXED,
+        rateLimitMs: 2000,
+        preferredPaths: ["/obituaries/"],
+        queryTerms: "obituary",
+    }, options);
+}
+//# sourceMappingURL=sources.js.map

package/dist/news/sources.js.map

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

package/dist/obituary/find-a-grave.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Find a Grave obituary source.
+ *
+ * Searches findagrave.com for memorial pages by name, extracts biography
+ * content via Readability (with regex fallback), and returns sanitized text.
+ *
+ * Find a Grave is user-generated content — anyone can create or edit memorials.
+ * Reliability tier is UNRELIABLE_UGC (0.35) per Wikipedia RSP guidelines.
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+/** Options for the Find a Grave source. */
+export type FindAGraveOptions = BaseSourceOptions;
+/**
+ * Find a Grave source for obituary / memorial content.
+ *
+ * Pipeline:
+ * 1. Search findagrave.com by first/last name
+ * 2. Parse memorial URLs from search results HTML
+ * 3. Filter for URLs containing the subject's name (normalized)
+ * 4. Fetch the memorial page via fetchPage (with archive fallback)
+ * 5. Extract bio via Readability, falling back to regex
+ * 6. Sanitize text and return if long enough
+ */
+export declare class FindAGraveSource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Find a Grave";
+    readonly type = "find-a-grave";
+    readonly reliabilityTier = ReliabilityTier.UNRELIABLE_UGC;
+    readonly domain = "www.findagrave.com";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    constructor(options?: FindAGraveOptions);
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+}
+/**
+ * Create a Find a Grave source instance.
+ *
+ * @example
+ * ```typescript
+ * const source = findAGrave()
+ * ```
+ */
+export declare function findAGrave(options?: FindAGraveOptions): FindAGraveSource;
+//# sourceMappingURL=find-a-grave.d.ts.map

package/dist/obituary/find-a-grave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-a-grave.d.ts","sourceRoot":"","sources":["../../src/obituary/find-a-grave.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAkBxB,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAA;AAMjD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IACvE,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,eAAe,kCAAiC;IACzD,QAAQ,CAAC,MAAM,wBAAuB;IACtC,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;gBAEtB,OAAO,GAAE,iBAAsB;cAI3B,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAsI9B;AAMD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAExE"}