openbriefing 0.1.0 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 This package is the reference parser and checker for the [Open Briefing Standard (OBS)](https://openbriefingstandard.org). OBS is how a publisher says how their content should be summarized and presented when software consumes it.
 
-**Version 0.1.** It contains the parser and `openbriefing check`. Later versions add `generate`, `preview`, `backfill`, `review` and a Ghost integration.
+**Version 0.2.** It contains the parser and `openbriefing check`, and reads spec version 1.1, which adds `obs:highlight`: passages the publisher marks, word for word from the content, for quoting on their own with credit. `check` lists each highlight with its word count and label, and warns when one is not found in the page's text. Later versions add `generate`, `preview`, `backfill`, `review` and a Ghost integration.
 
 ## Check a page or a feed
 
@@ -22,6 +22,7 @@ import { parseObs } from "openbriefing";
 
 const dom = new JSDOM(html, { url });
 const { brief, errors, warnings } = parseObs(dom.window.document, url);
+// brief.summaries, brief.keep, brief.highlights (each { text, words, label?, inContent? }), …
 ```
 
 | Export | What it does |
@@ -30,7 +31,7 @@ const { brief, errors, warnings } = parseObs(dom.window.document, url);
 | `parseFeedObs(itemElement, itemUrl?)` | Reads one RSS `<item>` or Atom `<entry>` |
 | `validateObs(object)` | Checks an object already in the `ObsBrief` shape |
 | `mergeObs(page, feed)` | Applies the feed-against-page rule: the later `obs:modified` stands, and the page wins a tie |
-| `tierFor(words)`, `SIZES`, `normalizeUrl` | Helpers that use the spec's numbers |
+| `tierFor(words)`, `SIZES`, `normalizeUrl`, `looseText` | Helpers that use the spec's numbers and its loose text comparison |
 
 The parser has no runtime dependencies. It takes any DOM `Document` (jsdom, linkedom, or a browser's `DOMParser`), makes no network requests, and never throws.
 

package/dist/cli.js

@@ -61,6 +61,14 @@ function describe(label, r) {
             row(`summary`, `${s.tier.padEnd(6)} ${String(s.words).padStart(5)} words  (target ${lo}–${hi})  ${s.from}`);
         }
         b.keep.forEach((k, i) => row(i === 0 ? "keep (core)" : `keep ${i + 1}`, cut(k)));
+        b.highlights.forEach((h, i) => {
+            const notes = [`${h.words}/${SIZES.highlight} words`];
+            if (h.label !== undefined)
+                notes.push(cut(h.label, 30));
+            if (h.inContent === false)
+                notes.push("not in the text");
+            row(`highlight ${i + 1}`, `${cut(h.text)}  (${notes.join(", ")})`);
+        });
         row("derive", `${b.derive.mode}; translate ${b.derive.translate ? "yes" : "no"}; combine ${b.derive.combine ? "yes" : "no"}`);
         if (b.attribution !== undefined)
             row("attribution", cut(b.attribution));

package/dist/obs.d.ts

@@ -18,6 +18,15 @@ export interface ObsSummary {
     /** "tiered" for obs:summary:{tier}; "inferred" for a bare obs:summary (§4). */
     from: "tiered" | "inferred";
 }
+export interface ObsHighlight {
+    /** The passage, as written. */
+    text: string;
+    words: number;
+    /** obs:highlight:label, 6 words or fewer, when given. */
+    label?: string;
+    /** False when the page's text does not contain the highlight (§7). Absent for feed items and empty pages. */
+    inContent?: boolean;
+}
 export interface ObsBrief {
     version: number;
     /** obs:modified, as given (ISO 8601). */
@@ -32,6 +41,8 @@ export interface ObsBrief {
     summaries: ObsSummary[];
     /** Priority order, at most 3. keep[0] is the core message (§6). */
     keep: string[];
+    /** Priority order, at most 5 (§7). Empty when none. */
+    highlights: ObsHighlight[];
     derive: {
         mode: DeriveMode;
         translate: boolean;
@@ -56,6 +67,9 @@ export declare const SIZES: {
     readonly keep: 40;
     readonly attribution: 12;
     readonly keepMax: 3;
+    readonly highlight: 60;
+    readonly highlightLabel: 6;
+    readonly highlightMax: 5;
     readonly tiers: Record<ObsTier, {
         target: [number, number];
     }>;
@@ -68,8 +82,13 @@ export declare const SIZES: {
 export declare function tierFor(words: number): ObsTier;
 /** Words are runs of characters between white space (§4). */
 export declare function countWords(text: string): number;
-/** URL comparison of §11: scheme and host case, trailing slash, tracking parameters. */
+/** URL comparison of §12: scheme and host case, trailing slash, tracking parameters. */
 export declare function normalizeUrl(input: string, base?: string): string | undefined;
+/**
+ * The loose comparison of §7: compatibility forms, straight quotes for curly,
+ * one kind of dash, one kind of space, one case. Words themselves must match.
+ */
+export declare function looseText(s: string): string;
 /**
  * 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.

package/dist/obs.js

@@ -15,6 +15,9 @@ export const SIZES = {
     keep: 40,
     attribution: 12,
     keepMax: 3,
+    highlight: 60,
+    highlightLabel: 6,
+    highlightMax: 5,
     tiers: {
         short: { target: [40, 80] },
         medium: { target: [200, 350] },
@@ -36,6 +39,7 @@ export function countWords(text) {
     const t = text.trim();
     return t === "" ? 0 : t.split(/\s+/u).length;
 }
+const newBag = () => ({ props: new Map(), highlights: [] });
 const KNOWN = new Set([
     "obs:modified",
     "obs:summary",
@@ -45,6 +49,8 @@ const KNOWN = new Set([
     "obs:title",
     "obs:headline",
     "obs:keep",
+    "obs:highlight",
+    "obs:highlight:label",
     "obs:derive",
     "obs:derive:translate",
     "obs:derive:combine",
@@ -55,14 +61,33 @@ const KNOWN = new Set([
     "obs:version",
 ]);
 function put(bag, key, value) {
-    const list = bag.get(key);
+    const list = bag.props.get(key);
     if (list)
         list.push(value);
     else
-        bag.set(key, [value]);
+        bag.props.set(key, [value]);
 }
+/** Files one property, routing highlights and their labels to the ordered list (§3.1). */
+function collect(bag, key, value, warnings) {
+    if (key === "obs:highlight") {
+        bag.highlights.push({ text: value });
+    }
+    else if (key === "obs:highlight:label") {
+        const last = bag.highlights[bag.highlights.length - 1];
+        if (last === undefined)
+            warnings.push("obs:highlight:label before any obs:highlight; it is ignored (§3.1)");
+        else if (last.label === undefined)
+            last.label = value;
+        else
+            warnings.push(`obs:highlight #${bag.highlights.length} has two labels; the first is used (§3.1)`);
+    }
+    else {
+        put(bag, key, value);
+    }
+}
+const isEmpty = (bag) => bag.props.size === 0 && bag.highlights.length === 0;
 function first(bag, key, warnings) {
-    const list = bag.get(key);
+    const list = bag.props.get(key);
     if (!list || list.length === 0)
         return undefined;
     if (list.length > 1 && key !== "obs:keep") {
@@ -77,14 +102,14 @@ 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)`);
+        warnings.push(`${key}: HTML removed; values are plain text (§9)`);
     }
     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)`);
+        warnings.push(`${key}: contains a URL; summaries should not (§9)`);
     return text;
 }
 function enumValue(key, raw, allowed, fallback, warnings) {
@@ -102,7 +127,7 @@ 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. */
+/** URL comparison of §12: scheme and host case, trailing slash, tracking parameters. */
 export function normalizeUrl(input, base) {
     let u;
     try {
@@ -130,11 +155,13 @@ function sizeWarning(key, words, max, warnings) {
 function build(bag, ctx, extraWarnings = []) {
     const errors = [];
     const warnings = [...extraWarnings];
-    for (const key of bag.keys()) {
+    for (const key of bag.props.keys()) {
         if (KNOWN.has(key))
             continue;
         if (key.startsWith("obs:audio:") || key === "obs:audio")
-            continue; // reserved, §14
+            continue; // reserved, §15
+        if (key === "obs:highlight:start" || key === "obs:highlight:end")
+            continue; // reserved, §15
         warnings.push(`${key} is not an OBS v1 property and is ignored (§3.1)`);
     }
     // Text values, cleaned once.
@@ -199,7 +226,7 @@ function build(bag, ctx, extraWarnings = []) {
     if (headline !== undefined)
         sizeWarning("obs:headline", countWords(headline), SIZES.headline, warnings);
     // Keep lines (§6)
-    const keepAll = (bag.get("obs:keep") ?? [])
+    const keepAll = (bag.props.get("obs:keep") ?? [])
         .map((raw) => cleanText("obs:keep", raw, warnings))
         .filter((v) => v !== undefined);
     if (keepAll.length > SIZES.keepMax) {
@@ -207,6 +234,31 @@ function build(bag, ctx, extraWarnings = []) {
     }
     const keep = keepAll.slice(0, SIZES.keepMax);
     keep.forEach((k, i) => sizeWarning(`obs:keep #${i + 1}`, countWords(k), SIZES.keep, warnings));
+    // Highlights (§7)
+    const highlightsAll = [];
+    for (const raw of bag.highlights) {
+        const t = cleanText("obs:highlight", raw.text, warnings);
+        if (t === undefined)
+            continue;
+        const h = { text: t, words: countWords(t) };
+        if (raw.label !== undefined) {
+            const label = cleanText("obs:highlight:label", raw.label, warnings);
+            if (label !== undefined)
+                h.label = label;
+        }
+        if (typeof raw.inContent === "boolean")
+            h.inContent = raw.inContent;
+        highlightsAll.push(h);
+    }
+    if (highlightsAll.length > SIZES.highlightMax) {
+        warnings.push(`obs:highlight appears ${highlightsAll.length} times; only the first ${SIZES.highlightMax} are used (§3)`);
+    }
+    const highlights = highlightsAll.slice(0, SIZES.highlightMax);
+    highlights.forEach((h, i) => {
+        sizeWarning(`obs:highlight #${i + 1}`, h.words, SIZES.highlight, warnings);
+        if (h.label !== undefined)
+            sizeWarning(`obs:highlight:label #${i + 1}`, countWords(h.label), SIZES.highlightLabel, 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";
@@ -216,7 +268,7 @@ function build(bag, ctx, extraWarnings = []) {
         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)
+    // Identity (§12)
     let url;
     let describesThisPage = true;
     const rawUrl = first(bag, "obs:url", warnings)?.trim();
@@ -235,6 +287,7 @@ function build(bag, ctx, extraWarnings = []) {
         describesThisPage,
         summaries,
         keep,
+        highlights,
         derive: { mode, translate, combine },
         preference,
     };
@@ -250,6 +303,34 @@ function build(bag, ctx, extraWarnings = []) {
         brief.lang = lang;
     return { brief, errors, warnings };
 }
+/**
+ * The loose comparison of §7: compatibility forms, straight quotes for curly,
+ * one kind of dash, one kind of space, one case. Words themselves must match.
+ */
+export function looseText(s) {
+    return s
+        .normalize("NFKC")
+        .replace(/[\u2018\u2019\u201a\u201b\u2032]/gu, "'")
+        .replace(/[\u201c\u201d\u201e\u201f\u2033]/gu, '"')
+        .replace(/[\u2010-\u2015\u2212]/gu, "-")
+        .replace(/\s*-\s*/gu, "-")
+        .replace(/\s+/gu, " ")
+        .trim()
+        .toLowerCase();
+}
+/** Sets inContent on each highlight from the page's text; skipped when the body is empty (§7). */
+function checkContent(brief, bodyText, warnings) {
+    const body = bodyText === undefined ? "" : looseText(bodyText);
+    if (body === "")
+        return;
+    for (const h of brief.highlights) {
+        h.inContent = body.includes(looseText(h.text));
+        if (!h.inContent) {
+            const head = h.text.split(/\s+/u).slice(0, 6).join(" ");
+            warnings.push(`obs:highlight "${head}…" is not in the page's text (§7)`);
+        }
+    }
+}
 function guard(fn) {
     try {
         return fn();
@@ -266,7 +347,7 @@ function guard(fn) {
  */
 export function parseObs(doc, pageUrl) {
     return guard(() => {
-        const bag = new Map();
+        const bag = newBag();
         const warnings = [];
         let inBody = false;
         for (const meta of Array.from(doc.getElementsByTagName("meta"))) {
@@ -280,9 +361,9 @@ export function parseObs(doc, pageUrl) {
                 continue;
             if (!inBody && doc.body && doc.body.contains(meta))
                 inBody = true;
-            put(bag, key, content);
+            collect(bag, key, content, warnings);
         }
-        if (bag.size === 0)
+        if (isEmpty(bag))
             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)");
@@ -294,11 +375,14 @@ export function parseObs(doc, pageUrl) {
             ctx.canonical = canonical;
         if (lang !== undefined)
             ctx.lang = lang;
-        return build(bag, ctx, warnings);
+        const result = build(bag, ctx, warnings);
+        if (result.brief)
+            checkContent(result.brief, doc.body?.textContent ?? undefined, result.warnings);
+        return result;
     });
 }
 // ---------------------------------------------------------------------------
-// Feeds (§13)
+// Feeds (§14)
 function obsChildren(item) {
     return Array.from(item.children).filter((el) => {
         if (el.namespaceURI === OBS_NS)
@@ -335,12 +419,18 @@ function itemLink(item) {
  */
 export function parseFeedObs(item, itemUrl) {
     return guard(() => {
-        const bag = new Map();
+        const bag = newBag();
         const warnings = [];
         for (const el of obsChildren(item)) {
             const name = localName(el);
             const value = el.textContent ?? "";
-            if (name === "summary") {
+            if (name === "highlight") {
+                collect(bag, "obs:highlight", value, warnings);
+                const label = el.getAttribute("label");
+                if (label !== null)
+                    collect(bag, "obs:highlight:label", label, warnings);
+            }
+            else if (name === "summary") {
                 const length = el.getAttribute("length")?.trim().toLowerCase();
                 if (length === undefined || length === "")
                     put(bag, "obs:summary", value);
@@ -363,7 +453,7 @@ export function parseFeedObs(item, itemUrl) {
                 put(bag, `obs:${name}`, value);
             }
         }
-        if (bag.size === 0)
+        if (isEmpty(bag))
             return { errors: ["No OBS elements on the item"], warnings };
         const link = itemUrl ?? itemLink(item);
         const canonical = link ? normalizeUrl(link) : undefined;
@@ -382,7 +472,7 @@ export function validateObs(input) {
             return { errors: ["Expected an object in the ObsBrief shape"], warnings: [] };
         }
         const o = input;
-        const bag = new Map();
+        const bag = newBag();
         const warnings = [];
         const str = (v) => (typeof v === "string" ? v : undefined);
         const set = (key, v) => {
@@ -422,6 +512,26 @@ export function validateObs(input) {
         if (Array.isArray(o.keep))
             for (const k of o.keep)
                 set("obs:keep", k);
+        if (Array.isArray(o.highlights)) {
+            for (const h of o.highlights) {
+                if (!h || typeof h !== "object")
+                    continue;
+                const rec = h;
+                const t = str(rec.text);
+                if (t === undefined) {
+                    warnings.push("A highlight has no text; it is ignored");
+                    continue;
+                }
+                const raw = { text: t };
+                const label = str(rec.label);
+                if (label !== undefined)
+                    raw.label = label;
+                // The producer saw the page; its verdict is carried through.
+                if (typeof rec.inContent === "boolean")
+                    raw.inContent = rec.inContent;
+                bag.highlights.push(raw);
+            }
+        }
         if (o.derive && typeof o.derive === "object") {
             const d = o.derive;
             set("obs:derive", d.mode);
@@ -438,7 +548,7 @@ export function validateObs(input) {
     });
 }
 // ---------------------------------------------------------------------------
-// Feed against page (§13)
+// Feed against page (§14)
 /** The later obs:modified stands; on a tie, the page stands. */
 export function mergeObs(page, feed) {
     if (!page)

package/fixtures/expected.json

@@ -19,6 +19,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -46,6 +47,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -71,6 +73,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -98,6 +101,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -123,6 +127,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -150,6 +155,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -178,6 +184,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "verbatim",
         "translate": true,
@@ -203,6 +210,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -234,6 +242,7 @@
         "keep": [
           "Anyone may take vegetables home once the harvest begins."
         ],
+        "highlights": [],
         "derive": {
           "mode": "anchor",
           "translate": true,
@@ -270,6 +279,17 @@
         "keep": [
           "Anyone may take vegetables home once the harvest begins."
         ],
+        "highlights": [
+          {
+            "text": "Anyone may take vegetables home once the harvest begins.",
+            "words": 9,
+            "label": "On the harvest"
+          },
+          {
+            "text": "Children from the school will help on the first Saturday.",
+            "words": 10
+          }
+        ],
         "derive": {
           "mode": "anchor",
           "translate": false,
@@ -296,6 +316,7 @@
           }
         ],
         "keep": [],
+        "highlights": [],
         "derive": {
           "mode": "anchor",
           "translate": true,
@@ -323,6 +344,216 @@
         }
       ],
       "keep": [],
+      "highlights": [],
+      "derive": {
+        "mode": "anchor",
+        "translate": true,
+        "combine": true
+      },
+      "preference": "summary",
+      "lang": "en"
+    },
+    "errors": [],
+    "warnings": []
+  },
+  "highlight-label-orphan.html": {
+    "brief": {
+      "version": 1,
+      "modified": "2026-11-08T14:00:00Z",
+      "describesThisPage": true,
+      "summaries": [
+        {
+          "tier": "medium",
+          "text": "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.",
+          "words": 280,
+          "from": "inferred"
+        }
+      ],
+      "keep": [],
+      "highlights": [
+        {
+          "text": "Anyone may take vegetables home once the harvest begins.",
+          "words": 9,
+          "inContent": true
+        }
+      ],
+      "derive": {
+        "mode": "anchor",
+        "translate": true,
+        "combine": true
+      },
+      "preference": "summary",
+      "lang": "en"
+    },
+    "errors": [],
+    "warnings": [
+      "obs:highlight:label before any obs:highlight; it is ignored (§3.1)"
+    ]
+  },
+  "highlight-limits.html": {
+    "brief": {
+      "version": 1,
+      "modified": "2026-11-08T14:00:00Z",
+      "describesThisPage": true,
+      "summaries": [
+        {
+          "tier": "medium",
+          "text": "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.",
+          "words": 280,
+          "from": "inferred"
+        }
+      ],
+      "keep": [],
+      "highlights": [
+        {
+          "text": "The garden club met on Tuesday to plan the spring planting.",
+          "words": 11,
+          "inContent": true
+        },
+        {
+          "text": "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.",
+          "words": 69,
+          "inContent": true
+        },
+        {
+          "text": "Most of the seeds came from last year's harvest.",
+          "words": 9,
+          "inContent": true
+        },
+        {
+          "text": "The committee chose tomatoes, beans and three kinds of squash.",
+          "words": 10,
+          "inContent": true
+        },
+        {
+          "text": "Members who cannot dig offered to label the rows instead.",
+          "words": 10,
+          "inContent": true
+        }
+      ],
+      "derive": {
+        "mode": "anchor",
+        "translate": true,
+        "combine": true
+      },
+      "preference": "summary",
+      "lang": "en"
+    },
+    "errors": [],
+    "warnings": [
+      "obs:highlight appears 7 times; only the first 5 are used (§3)",
+      "obs:highlight #2: 69 words, over its size of 60 (§4)"
+    ]
+  },
+  "highlight-not-in-text.html": {
+    "brief": {
+      "version": 1,
+      "modified": "2026-11-08T14:00:00Z",
+      "describesThisPage": true,
+      "summaries": [
+        {
+          "tier": "medium",
+          "text": "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.",
+          "words": 280,
+          "from": "inferred"
+        }
+      ],
+      "keep": [],
+      "highlights": [
+        {
+          "text": "Most of the seeds came from last year’s harvest.",
+          "words": 9,
+          "inContent": true
+        },
+        {
+          "text": "The fence — a new one — keeps the rabbits out.",
+          "words": 11,
+          "inContent": true
+        },
+        {
+          "text": "The club bought a tractor for the heavy digging.",
+          "words": 9,
+          "inContent": false
+        }
+      ],
+      "derive": {
+        "mode": "anchor",
+        "translate": true,
+        "combine": true
+      },
+      "preference": "summary",
+      "lang": "en"
+    },
+    "errors": [],
+    "warnings": [
+      "obs:highlight \"The club bought a tractor for…\" is not in the page's text (§7)"
+    ]
+  },
+  "highlight-reserved.html": {
+    "brief": {
+      "version": 1,
+      "modified": "2026-11-08T14:00:00Z",
+      "describesThisPage": true,
+      "summaries": [
+        {
+          "tier": "medium",
+          "text": "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.",
+          "words": 280,
+          "from": "inferred"
+        }
+      ],
+      "keep": [],
+      "highlights": [
+        {
+          "text": "Anyone may take vegetables home once the harvest begins.",
+          "words": 9,
+          "inContent": true
+        }
+      ],
+      "derive": {
+        "mode": "anchor",
+        "translate": true,
+        "combine": true
+      },
+      "preference": "summary",
+      "lang": "en"
+    },
+    "errors": [],
+    "warnings": []
+  },
+  "highlights.html": {
+    "brief": {
+      "version": 1,
+      "modified": "2026-11-08T14:00:00Z",
+      "describesThisPage": true,
+      "summaries": [
+        {
+          "tier": "medium",
+          "text": "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.",
+          "words": 280,
+          "from": "inferred"
+        }
+      ],
+      "keep": [],
+      "highlights": [
+        {
+          "text": "Anyone may take vegetables home once the harvest begins.",
+          "words": 9,
+          "label": "On the harvest",
+          "inContent": true
+        },
+        {
+          "text": "Volunteers agreed to water the beds every second morning.",
+          "words": 9,
+          "inContent": true
+        },
+        {
+          "text": "A new fence will keep the rabbits away from the lettuce.",
+          "words": 11,
+          "label": "On rabbits",
+          "inContent": true
+        }
+      ],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -348,6 +579,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -377,6 +609,7 @@
         "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.",
         "Children from the school help on the first Saturday."
       ],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -405,6 +638,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -430,6 +664,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -440,8 +675,8 @@
     },
     "errors": [],
     "warnings": [
-      "obs:summary: HTML removed; values are plain text (§8)",
-      "obs:summary: contains a URL; summaries should not (§8)"
+      "obs:summary: HTML removed; values are plain text (§9)",
+      "obs:summary: contains a URL; summaries should not (§9)"
     ]
   },
   "missing-modified.html": {
@@ -470,6 +705,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -495,6 +731,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -528,6 +765,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -559,6 +797,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -584,6 +823,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -609,6 +849,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -642,6 +883,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -667,6 +909,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -694,6 +937,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -720,6 +964,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,
@@ -762,6 +1007,19 @@
         "Volunteers water the beds every second morning.",
         "Children from the school help on the first Saturday."
       ],
+      "highlights": [
+        {
+          "text": "Anyone may take vegetables home once the harvest begins.",
+          "words": 9,
+          "label": "On the harvest",
+          "inContent": true
+        },
+        {
+          "text": "Children from the school will help on the first Saturday.",
+          "words": 10,
+          "inContent": true
+        }
+      ],
       "derive": {
         "mode": "anchor",
         "translate": false,
@@ -790,6 +1048,7 @@
         }
       ],
       "keep": [],
+      "highlights": [],
       "derive": {
         "mode": "anchor",
         "translate": true,

package/fixtures/feed-rss.xml

@@ -12,6 +12,8 @@
       <obs:summary>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.</obs:summary>
       <obs:summary length="short">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.</obs:summary>
       <obs:keep>Anyone may take vegetables home once the harvest begins.</obs:keep>
+      <obs:highlight label="On the harvest">Anyone may take vegetables home once the harvest begins.</obs:highlight>
+      <obs:highlight>Children from the school will help on the first Saturday.</obs:highlight>
       <obs:derive translate="no">anchor</obs:derive>
       <obs:attribution>From the Garden Club newsletter</obs:attribution>
     </item>

package/fixtures/highlight-label-orphan.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: highlight-label-orphan</title>
+  <link rel="canonical" href="https://example.test/highlight-label-orphan/">
+  <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:highlight:label" content="A label with nothing before it">
+  <meta property="obs:highlight" content="Anyone may take vegetables home once the harvest begins.">
+</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/highlight-limits.html

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: highlight-limits</title>
+  <link rel="canonical" href="https://example.test/highlight-limits/">
+  <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:highlight" content="The garden club met on Tuesday to plan the spring planting.">
+  <meta property="obs:highlight" 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.">
+  <meta property="obs:highlight" content="Most of the seeds came from last year's harvest.">
+  <meta property="obs:highlight" content="The committee chose tomatoes, beans and three kinds of squash.">
+  <meta property="obs:highlight" content="Members who cannot dig offered to label the rows instead.">
+  <meta property="obs:highlight" content="A sixth highlight that is dropped.">
+  <meta property="obs:highlight" content="A seventh highlight that is dropped.">
+</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/highlight-not-in-text.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: highlight-not-in-text</title>
+  <link rel="canonical" href="https://example.test/highlight-not-in-text/">
+  <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:highlight" content="Most of the seeds came from last year’s harvest.">
+  <meta property="obs:highlight" content="The fence — a new one — keeps the rabbits out.">
+  <meta property="obs:highlight" content="The club bought a tractor for the heavy digging.">
+</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>
+  <p>The fence - a new one - keeps the rabbits out.</p>
+</body>
+</html>

package/fixtures/highlight-reserved.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: highlight-reserved</title>
+  <link rel="canonical" href="https://example.test/highlight-reserved/">
+  <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:highlight" content="Anyone may take vegetables home once the harvest begins.">
+  <meta property="obs:highlight:start" content="00:01:12">
+  <meta property="obs:highlight:end" content="00:01:30">
+</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/highlights.html

@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="en">
+<head prefix="obs: https://openbriefingstandard.org/ns#">
+  <meta charset="utf-8">
+  <title>Garden Club Notes: highlights</title>
+  <link rel="canonical" href="https://example.test/highlights/">
+  <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:highlight" content="Anyone may take vegetables home once the harvest begins.">
+  <meta property="obs:highlight:label" content="On the harvest">
+  <meta property="obs:highlight" content="Volunteers agreed to water the beds every second morning.">
+  <meta property="obs:highlight" content="A new fence will keep the rabbits away from the lettuce.">
+  <meta property="obs:highlight:label" content="On rabbits">
+</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/valid-full.html

@@ -13,6 +13,9 @@
   <meta property="obs:keep" content="Anyone may take vegetables home once the harvest begins.">
   <meta property="obs:keep" content="Volunteers water the beds every second morning.">
   <meta property="obs:keep" content="Children from the school help on the first Saturday.">
+  <meta property="obs:highlight" content="Anyone may take vegetables home once the harvest begins.">
+  <meta property="obs:highlight:label" content="On the harvest">
+  <meta property="obs:highlight" content="Children from the school will help on the first Saturday.">
   <meta property="obs:attribution" content="From the Garden Club newsletter">
   <meta property="obs:derive" content="anchor">
   <meta property="obs:derive:translate" content="no">

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "openbriefing",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Open Briefing Standard (OBS): the reference parser and checker for publishers' own summaries.",
-  "keywords": ["open-briefing-standard", "obs", "summary", "metadata", "opengraph", "publishing"],
+  "keywords": [
+    "open-briefing-standard",
+    "obs",
+    "summary",
+    "metadata",
+    "opengraph",
+    "publishing"
+  ],
   "homepage": "https://openbriefingstandard.org",
   "repository": {
     "type": "git",
@@ -15,12 +22,23 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./fixtures/*": "./fixtures/*"
   },
-  "bin": { "openbriefing": "./dist/cli.js" },
-  "files": ["dist", "fixtures", "README.md"],
-  "engines": { "node": ">=20" },
+  "bin": {
+    "openbriefing": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "fixtures",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",