openbriefing 0.0.1 → 0.1.1

package/dist/obs.js

@@ -0,0 +1,449 @@
+/**
+ * The Open Briefing Standard, version 1: reference parser.
+ *
+ * Self-contained: no runtime imports. It reads a DOM `Document` or `Element`
+ * (jsdom on a server, DOMParser in a browser) and never touches the network.
+ * Every function here returns a result rather than throwing.
+ *
+ * Section numbers in comments refer to spec/v1.md.
+ */
+export const OBS_NS = "https://openbriefingstandard.org/ns#";
+/** Sizes from §4, exported so tools show the same numbers. */
+export const SIZES = {
+    title: 12,
+    headline: 40,
+    keep: 40,
+    attribution: 12,
+    keepMax: 3,
+    tiers: {
+        short: { target: [40, 80] },
+        medium: { target: [200, 350] },
+        long: { target: [500, 800] },
+    },
+    bands: { shortMax: 120, mediumMax: 500 },
+};
+const TIERS = ["short", "medium", "long"];
+/** The tier for a word count, by the bands in §4. */
+export function tierFor(words) {
+    if (words <= SIZES.bands.shortMax)
+        return "short";
+    if (words <= SIZES.bands.mediumMax)
+        return "medium";
+    return "long";
+}
+/** Words are runs of characters between white space (§4). */
+export function countWords(text) {
+    const t = text.trim();
+    return t === "" ? 0 : t.split(/\s+/u).length;
+}
+const KNOWN = new Set([
+    "obs:modified",
+    "obs:summary",
+    "obs:summary:short",
+    "obs:summary:medium",
+    "obs:summary:long",
+    "obs:title",
+    "obs:headline",
+    "obs:keep",
+    "obs:derive",
+    "obs:derive:translate",
+    "obs:derive:combine",
+    "obs:attribution",
+    "obs:preference",
+    "obs:lang",
+    "obs:url",
+    "obs:version",
+]);
+function put(bag, key, value) {
+    const list = bag.get(key);
+    if (list)
+        list.push(value);
+    else
+        bag.set(key, [value]);
+}
+function first(bag, key, warnings) {
+    const list = bag.get(key);
+    if (!list || list.length === 0)
+        return undefined;
+    if (list.length > 1 && key !== "obs:keep") {
+        warnings.push(`${key} appears ${list.length} times; the first is used (§3.1)`);
+    }
+    return list[0];
+}
+const TAG_RE = /<[^>]*>/gu;
+const URL_RE = /\b(?:https?:\/\/|www\.)\S+/iu;
+/** Plain-text rules of §8: strip markup, warn about URLs, trim. */
+function cleanText(key, raw, warnings) {
+    let text = raw;
+    if (TAG_RE.test(text)) {
+        text = text.replace(TAG_RE, "");
+        warnings.push(`${key}: HTML removed; values are plain text (§8)`);
+    }
+    TAG_RE.lastIndex = 0;
+    text = text.replace(/\r\n?/gu, "\n").trim();
+    if (text === "")
+        return undefined;
+    if (URL_RE.test(text))
+        warnings.push(`${key}: contains a URL; summaries should not (§8)`);
+    return text;
+}
+function enumValue(key, raw, allowed, fallback, warnings) {
+    if (raw === undefined)
+        return fallback;
+    const v = raw.trim().toLowerCase();
+    if (allowed.includes(v))
+        return v;
+    warnings.push(`${key}: "${raw}" is not one of ${allowed.join(", ")}; the default "${fallback}" applies`);
+    return fallback;
+}
+/** ISO 8601 date-time, with a time and an offset or Z. */
+const ISO_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})$/u;
+function validModified(v) {
+    return ISO_RE.test(v) && !Number.isNaN(Date.parse(v));
+}
+const TRACKING = /^(?:utm_.*|fbclid|gclid)$/iu;
+/** URL comparison of §11: scheme and host case, trailing slash, tracking parameters. */
+export function normalizeUrl(input, base) {
+    let u;
+    try {
+        u = base ? new URL(input, base) : new URL(input);
+    }
+    catch {
+        return undefined;
+    }
+    if (u.protocol !== "http:" && u.protocol !== "https:")
+        return undefined;
+    u.hash = "";
+    for (const k of [...u.searchParams.keys()])
+        if (TRACKING.test(k))
+            u.searchParams.delete(k);
+    let path = u.pathname;
+    if (path.length > 1 && path.endsWith("/"))
+        path = path.replace(/\/+$/u, "");
+    const query = u.searchParams.toString();
+    return `${u.protocol}//${u.host.toLowerCase()}${path}${query ? `?${query}` : ""}`;
+}
+function sizeWarning(key, words, max, warnings) {
+    if (words > max)
+        warnings.push(`${key}: ${words} words, over its size of ${max} (§4)`);
+}
+function build(bag, ctx, extraWarnings = []) {
+    const errors = [];
+    const warnings = [...extraWarnings];
+    for (const key of bag.keys()) {
+        if (KNOWN.has(key))
+            continue;
+        if (key.startsWith("obs:audio:") || key === "obs:audio")
+            continue; // reserved, §14
+        warnings.push(`${key} is not an OBS v1 property and is ignored (§3.1)`);
+    }
+    // Text values, cleaned once.
+    const text = (key) => {
+        const raw = first(bag, key, warnings);
+        return raw === undefined ? undefined : cleanText(key, raw, warnings);
+    };
+    // obs:version
+    let version = 1;
+    const rawVersion = first(bag, "obs:version", warnings);
+    if (rawVersion !== undefined) {
+        const n = Number.parseInt(rawVersion.trim(), 10);
+        if (!Number.isInteger(n) || n < 1 || String(n) !== rawVersion.trim()) {
+            warnings.push(`obs:version: "${rawVersion}" is not a whole number; 1 is assumed`);
+        }
+        else {
+            version = n;
+            if (n > 1)
+                warnings.push(`obs:version ${n} is newer than this reader (v1); unknown tags are ignored`);
+        }
+    }
+    // obs:modified (required)
+    const modified = first(bag, "obs:modified", warnings)?.trim();
+    if (modified === undefined || modified === "") {
+        errors.push("obs:modified is missing; it is required (§3)");
+    }
+    else if (!validModified(modified)) {
+        errors.push(`obs:modified: "${modified}" is not an ISO 8601 date and time (§3)`);
+    }
+    // Summaries (§4)
+    const tiered = new Map();
+    for (const tier of TIERS) {
+        const t = text(`obs:summary:${tier}`);
+        if (t === undefined)
+            continue;
+        const words = countWords(t);
+        tiered.set(tier, { tier, text: t, words, from: "tiered" });
+        sizeWarning(`obs:summary:${tier}`, words, SIZES.tiers[tier].target[1], warnings);
+    }
+    const bare = text("obs:summary");
+    if (bare !== undefined) {
+        const words = countWords(bare);
+        const tier = tierFor(words);
+        if (tiered.has(tier)) {
+            warnings.push(`obs:summary (${words} words) falls in the ${tier} tier, which obs:summary:${tier} already fills; it is set aside (§4)`);
+        }
+        else {
+            tiered.set(tier, { tier, text: bare, words, from: "inferred" });
+            sizeWarning("obs:summary", words, SIZES.tiers[tier].target[1], warnings);
+        }
+    }
+    const summaries = TIERS.flatMap((t) => (tiered.has(t) ? [tiered.get(t)] : []));
+    if (summaries.length === 0)
+        errors.push("No summary: obs:summary or a tiered summary is required (§3)");
+    if (errors.length > 0)
+        return { errors, warnings };
+    // Optional forms
+    const title = text("obs:title");
+    if (title !== undefined)
+        sizeWarning("obs:title", countWords(title), SIZES.title, warnings);
+    const headline = text("obs:headline");
+    if (headline !== undefined)
+        sizeWarning("obs:headline", countWords(headline), SIZES.headline, warnings);
+    // Keep lines (§6)
+    const keepAll = (bag.get("obs:keep") ?? [])
+        .map((raw) => cleanText("obs:keep", raw, warnings))
+        .filter((v) => v !== undefined);
+    if (keepAll.length > SIZES.keepMax) {
+        warnings.push(`obs:keep appears ${keepAll.length} times; only the first ${SIZES.keepMax} are used (§3)`);
+    }
+    const keep = keepAll.slice(0, SIZES.keepMax);
+    keep.forEach((k, i) => sizeWarning(`obs:keep #${i + 1}`, countWords(k), SIZES.keep, warnings));
+    // Derivation (§5)
+    const mode = enumValue("obs:derive", first(bag, "obs:derive", warnings), ["verbatim", "anchor", "open"], "anchor", warnings);
+    const translate = enumValue("obs:derive:translate", first(bag, "obs:derive:translate", warnings), ["yes", "no"], "yes", warnings) === "yes";
+    const combine = enumValue("obs:derive:combine", first(bag, "obs:derive:combine", warnings), ["yes", "no"], "yes", warnings) === "yes";
+    const attribution = text("obs:attribution");
+    if (attribution !== undefined)
+        sizeWarning("obs:attribution", countWords(attribution), SIZES.attribution, warnings);
+    const preference = enumValue("obs:preference", first(bag, "obs:preference", warnings), ["summary", "full"], "summary", warnings);
+    const lang = first(bag, "obs:lang", warnings)?.trim() || ctx.lang || undefined;
+    // Identity (§11)
+    let url;
+    let describesThisPage = true;
+    const rawUrl = first(bag, "obs:url", warnings)?.trim();
+    if (rawUrl) {
+        url = normalizeUrl(rawUrl, ctx.canonical);
+        if (url === undefined) {
+            warnings.push(`obs:url: "${rawUrl}" is not an http or https URL; it is ignored`);
+        }
+        else if (ctx.canonical !== undefined) {
+            describesThisPage = url === normalizeUrl(ctx.canonical);
+        }
+    }
+    const brief = {
+        version,
+        modified: modified,
+        describesThisPage,
+        summaries,
+        keep,
+        derive: { mode, translate, combine },
+        preference,
+    };
+    if (url !== undefined)
+        brief.url = url;
+    if (title !== undefined)
+        brief.title = title;
+    if (headline !== undefined)
+        brief.headline = headline;
+    if (attribution !== undefined)
+        brief.attribution = attribution;
+    if (lang !== undefined)
+        brief.lang = lang;
+    return { brief, errors, warnings };
+}
+function guard(fn) {
+    try {
+        return fn();
+    }
+    catch (err) {
+        return { errors: [`Could not read the tags: ${err instanceof Error ? err.message : String(err)}`], warnings: [] };
+    }
+}
+// ---------------------------------------------------------------------------
+// Pages (§3.1)
+/**
+ * Reads a page's obs: meta tags. `pageUrl` is where the page was fetched
+ * from; the page's <link rel="canonical"> takes precedence for §11.
+ */
+export function parseObs(doc, pageUrl) {
+    return guard(() => {
+        const bag = new Map();
+        const warnings = [];
+        let inBody = false;
+        for (const meta of Array.from(doc.getElementsByTagName("meta"))) {
+            const key = (meta.getAttribute("property") ?? meta.getAttribute("name") ?? "").trim().toLowerCase();
+            if (!key.startsWith("obs:"))
+                continue;
+            const content = meta.getAttribute("content");
+            if (content === null)
+                continue;
+            if (content.trim() === "")
+                continue;
+            if (!inBody && doc.body && doc.body.contains(meta))
+                inBody = true;
+            put(bag, key, content);
+        }
+        if (bag.size === 0)
+            return { errors: ["No obs: tags on the page"], warnings };
+        if (inBody)
+            warnings.push("Some obs: tags are in <body>; they belong in <head> (§3.1)");
+        const canonicalHref = doc.querySelector('link[rel~="canonical"]')?.getAttribute("href") ?? undefined;
+        const canonical = (canonicalHref && normalizeUrl(canonicalHref, pageUrl)) || normalizeUrl(pageUrl) || undefined;
+        const lang = doc.documentElement?.getAttribute("lang")?.trim() || undefined;
+        const ctx = {};
+        if (canonical !== undefined)
+            ctx.canonical = canonical;
+        if (lang !== undefined)
+            ctx.lang = lang;
+        return build(bag, ctx, warnings);
+    });
+}
+// ---------------------------------------------------------------------------
+// Feeds (§13)
+function obsChildren(item) {
+    return Array.from(item.children).filter((el) => {
+        if (el.namespaceURI === OBS_NS)
+            return true;
+        // Lenient: a feed that forgot to declare the namespace but used the prefix.
+        return el.namespaceURI === null && el.tagName.toLowerCase().startsWith("obs:");
+    });
+}
+function localName(el) {
+    const name = el.namespaceURI === OBS_NS ? el.localName : el.tagName.slice(4);
+    return name.toLowerCase();
+}
+function itemLink(item) {
+    for (const el of Array.from(item.children)) {
+        if (el.namespaceURI === OBS_NS)
+            continue;
+        if (el.localName !== "link")
+            continue;
+        const href = el.getAttribute("href");
+        if (href !== null) {
+            const rel = el.getAttribute("rel");
+            if (rel === null || rel === "alternate")
+                return href.trim();
+        }
+        else if (el.textContent?.trim()) {
+            return el.textContent.trim();
+        }
+    }
+    return undefined;
+}
+/**
+ * Reads the OBS elements of one RSS <item> or Atom <entry>. `itemUrl`
+ * overrides the item's own link when given.
+ */
+export function parseFeedObs(item, itemUrl) {
+    return guard(() => {
+        const bag = new Map();
+        const warnings = [];
+        for (const el of obsChildren(item)) {
+            const name = localName(el);
+            const value = el.textContent ?? "";
+            if (name === "summary") {
+                const length = el.getAttribute("length")?.trim().toLowerCase();
+                if (length === undefined || length === "")
+                    put(bag, "obs:summary", value);
+                else if (TIERS.includes(length))
+                    put(bag, `obs:summary:${length}`, value);
+                else
+                    warnings.push(`<obs:summary length="${length}"> is not short, medium or long; it is ignored`);
+            }
+            else if (name === "derive") {
+                if (value.trim() !== "")
+                    put(bag, "obs:derive", value);
+                const tr = el.getAttribute("translate");
+                if (tr !== null)
+                    put(bag, "obs:derive:translate", tr);
+                const co = el.getAttribute("combine");
+                if (co !== null)
+                    put(bag, "obs:derive:combine", co);
+            }
+            else {
+                put(bag, `obs:${name}`, value);
+            }
+        }
+        if (bag.size === 0)
+            return { errors: ["No OBS elements on the item"], warnings };
+        const link = itemUrl ?? itemLink(item);
+        const canonical = link ? normalizeUrl(link) : undefined;
+        const ctx = {};
+        if (canonical !== undefined)
+            ctx.canonical = canonical;
+        return build(bag, ctx, warnings);
+    });
+}
+// ---------------------------------------------------------------------------
+// Objects already in the ObsBrief shape (an ingest payload, a JSON file)
+/** Checks an object in the ObsBrief shape and rebuilds it under the same rules. */
+export function validateObs(input) {
+    return guard(() => {
+        if (input === null || typeof input !== "object" || Array.isArray(input)) {
+            return { errors: ["Expected an object in the ObsBrief shape"], warnings: [] };
+        }
+        const o = input;
+        const bag = new Map();
+        const warnings = [];
+        const str = (v) => (typeof v === "string" ? v : undefined);
+        const set = (key, v) => {
+            const s = str(v);
+            if (s !== undefined)
+                put(bag, key, s);
+            else if (v !== undefined && v !== null)
+                warnings.push(`${key} is not a string; it is ignored`);
+        };
+        set("obs:modified", o.modified);
+        if (typeof o.version === "number")
+            put(bag, "obs:version", String(o.version));
+        set("obs:url", o.url);
+        set("obs:title", o.title);
+        set("obs:headline", o.headline);
+        set("obs:attribution", o.attribution);
+        set("obs:preference", o.preference);
+        set("obs:lang", o.lang);
+        if (Array.isArray(o.summaries)) {
+            for (const s of o.summaries) {
+                if (s && typeof s === "object") {
+                    const rec = s;
+                    const tier = str(rec.tier);
+                    const t = str(rec.text);
+                    if (t === undefined)
+                        continue;
+                    // A summary whose tier was inferred is re-inferred from its words.
+                    if (rec.from === "inferred" || tier === undefined)
+                        put(bag, "obs:summary", t);
+                    else if (TIERS.includes(tier))
+                        put(bag, `obs:summary:${tier}`, t);
+                    else
+                        warnings.push(`A summary has tier "${tier}"; it is ignored`);
+                }
+            }
+        }
+        if (Array.isArray(o.keep))
+            for (const k of o.keep)
+                set("obs:keep", k);
+        if (o.derive && typeof o.derive === "object") {
+            const d = o.derive;
+            set("obs:derive", d.mode);
+            if (typeof d.translate === "boolean")
+                put(bag, "obs:derive:translate", d.translate ? "yes" : "no");
+            if (typeof d.combine === "boolean")
+                put(bag, "obs:derive:combine", d.combine ? "yes" : "no");
+        }
+        const result = build(bag, {}, warnings);
+        if (result.brief && typeof o.describesThisPage === "boolean") {
+            result.brief.describesThisPage = o.describesThisPage;
+        }
+        return result;
+    });
+}
+// ---------------------------------------------------------------------------
+// Feed against page (§13)
+/** The later obs:modified stands; on a tie, the page stands. */
+export function mergeObs(page, feed) {
+    if (!page)
+        return feed;
+    if (!feed)
+        return page;
+    return Date.parse(feed.modified) > Date.parse(page.modified) ? feed : page;
+}

package/fixtures/bad-modified.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: bad-modified</title>
+  <link rel="canonical" href="https://example.test/bad-modified/">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone.">
+  <meta property="obs:modified" content="last Tuesday">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>

package/fixtures/band-120.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: band-120</title>
+  <link rel="canonical" href="https://example.test/band-120/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning.">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>

package/fixtures/band-121.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: band-121</title>
+  <link rel="canonical" href="https://example.test/band-121/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most.">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>

package/fixtures/band-500.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: band-500</title>
+  <link rel="canonical" href="https://example.test/band-500/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>

package/fixtures/band-501.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: band-501</title>
+  <link rel="canonical" href="https://example.test/band-501/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The.">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>

package/fixtures/body-tags.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: body-tags</title>
+  <link rel="canonical" href="https://example.test/body-tags/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone.">
+</body>
+</html>

package/fixtures/derive-bad.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: derive-bad</title>
+  <link rel="canonical" href="https://example.test/derive-bad/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone.">
+  <meta property="obs:derive" content="loose">
+  <meta property="obs:derive:translate" content="maybe">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>

package/fixtures/derive-verbatim.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: derive-verbatim</title>
+  <link rel="canonical" href="https://example.test/derive-verbatim/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone.">
+  <meta property="obs:derive" content="VERBATIM">
+  <meta property="obs:derive:combine" content="no">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>

package/fixtures/duplicate-headline.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: duplicate-headline</title>
+  <link rel="canonical" href="https://example.test/duplicate-headline/">
+  <meta property="obs:modified" content="2026-11-08T14:00:00Z">
+  <meta property="obs:summary" content="The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month. The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone.">
+  <meta property="obs:headline" content="The garden club planned its spring planting, and volunteers will water the beds every second morning.">
+  <meta property="obs:headline" content="A second headline that is ignored.">
+</head>
+<body>
+  <article><h1>Garden Club Notes</h1><p>The garden club met on Tuesday to plan the spring planting. Volunteers agreed to water the beds every second morning. Most of the seeds came from last year's harvest. The committee chose tomatoes, beans and three kinds of squash. A new fence will keep the rabbits away from the lettuce. Members who cannot dig offered to label the rows instead. The treasurer reported enough money for compost and tools. Children from the school will help on the first Saturday. Anyone may take vegetables home once the harvest begins. The next meeting is set for the first week of the month.</p></article>
+</body>
+</html>