Skip to content

code-yeongyu/oh-my-openagent / packages/shared-skills/skills/ulw-research

ulw-research

Unverified

Runs maximum-saturation research with a cooperating team, claim-graph gating, and a cited, QA'd deliverable. Use when the user explicitly asks for research or a deep investigation, including any 'ulw' research wording.

FileKindSize
AGENTS.mdmarkdown9.2 KB
ATTRIBUTION.mdmarkdown2.4 KB
SKILL.mdskill md42.2 KB
references/deliverable-phase.mdmarkdown49.1 KB
references/fact-ledger-grammar.mdmarkdown6.8 KB
references/fact-ledger.mdmarkdown24.4 KB
references/fidelity-claim-kinds.mdmarkdown5.2 KB
references/markdown-blocks.mdmarkdown721 B
references/report-gates.mdmarkdown32.0 KB
references/report-visualization.mdmarkdown15.4 KB
references/research-collection.mdmarkdown26.8 KB
references/research-delivery.mdmarkdown14.3 KB
references/unit-rules.mdmarkdown16.3 KB
scripts/claim-kinds.mjsscript11.2 KB
scripts/claim-kinds.test.tsscript13.5 KB
scripts/claim-prefix.test.tsscript4.9 KB
scripts/claims-index.mjsscript5.3 KB
scripts/claims-index.test.tsscript5.7 KB
scripts/cli-support.mjsscript4.1 KB
scripts/cli-support.test.tsscript4.3 KB
scripts/contracts-validation.test.tsscript3.3 KB
scripts/contracts.mjsscript26.1 KB
scripts/contracts.test.tsscript7.9 KB
scripts/conversion-altered.test.tsscript11.0 KB
scripts/conversion-originals.test.tsscript22.7 KB
scripts/conversion-probe-classes.test.tsscript45.2 KB
scripts/conversion-probe.mjsscript13.5 KB
scripts/conversion-probe.test.tsscript11.6 KB
scripts/copy-returns-fidelity-policy.test.tsscript10.4 KB
scripts/copy-returns-polish.test.tsscript12.1 KB
scripts/copy-returns.test.tsscript10.6 KB
scripts/css-hiding.mjsscript9.1 KB
scripts/css-lite.mjsscript7.6 KB
scripts/css-lite.test.tsscript6.4 KB
scripts/delivery-barrier-meaning.test.tsscript12.3 KB
scripts/delivery-barrier.test.tsscript11.4 KB
scripts/design-spec.mjsscript7.2 KB
scripts/design-spec.test.tsscript6.7 KB
scripts/entities.mjsscript2.5 KB
scripts/entry-guard.mjsscript794 B
scripts/fact-commands-fill.mjsscript6.6 KB
scripts/fact-commands-meaning.mjsscript12.6 KB
scripts/fact-commands-polish.mjsscript10.3 KB
scripts/fact-commands-verify.mjsscript12.6 KB
scripts/fact-commands.mjsscript13.8 KB
scripts/fact-derive-2.test.tsscript7.2 KB
scripts/fact-derive.mjsscript4.9 KB
scripts/fact-derive.test.tsscript10.8 KB
scripts/fact-expr.mjsscript4.5 KB
scripts/fact-fill.mjsscript11.7 KB
scripts/fact-fill.test.tsscript10.7 KB
scripts/fact-ledger-grammar.test.tsscript11.8 KB
scripts/fact-ledger-kinds.mjsscript16.5 KB
scripts/fact-ledger-kinds.test.tsscript9.3 KB
scripts/fact-ledger-legacy.test.tsscript8.9 KB
scripts/fact-ledger-schema.mjsscript11.9 KB
scripts/fact-ledger-schema.test.tsscript1.5 KB
scripts/fact-ledger.mjsscript5.5 KB
scripts/fact-ledger.test.tsscript9.7 KB
scripts/fact-locate.mjsscript12.1 KB
scripts/fact-locate.test.tsscript7.2 KB
scripts/fact-pairs.mjsscript8.3 KB
scripts/fact-pairs.test.tsscript6.6 KB
scripts/fact-recompute.mjsscript4.8 KB
scripts/fact-unit-dimensions-2.test.tsscript8.4 KB
scripts/fact-unit-dimensions.test.tsscript11.9 KB
scripts/fact-unit-rules.test.tsscript8.9 KB
scripts/fidelity-binding.mjsscript6.7 KB
scripts/fidelity-binding.test.tsscript4.0 KB
scripts/fidelity-brief.mjsscript6.4 KB
scripts/fidelity-brief.test.tsscript7.8 KB
scripts/fidelity-claims.mjsscript5.1 KB
scripts/fidelity-csv.mjsscript1.1 KB
scripts/fidelity-lexicon.mjsscript8.1 KB
scripts/fidelity-lexicon.test.tsscript6.0 KB
scripts/fidelity-originals.mjsscript9.9 KB
scripts/fidelity-policy.mjsscript10.1 KB
scripts/fidelity-records.mjsscript13.4 KB
scripts/fidelity-snapshot-readability.mjsscript2.2 KB
scripts/fidelity-sources.mjsscript4.3 KB
scripts/fidelity-state.mjsscript2.1 KB
scripts/fidelity-state.test.tsscript1.7 KB
scripts/fidelity-trace.mjsscript6.1 KB
scripts/fidelity-trace.test.tsscript3.3 KB
scripts/fidelity-value-unit.mjsscript13.3 KB
scripts/fidelity-values.mjsscript16.1 KB
scripts/fidelity-values.test.tsscript15.8 KB
scripts/format-extract-css.mjsscript5.1 KB
scripts/format-extract.mjsscript10.3 KB
scripts/format-extract.test.tsscript11.2 KB
scripts/gates-context.test.tsscript2.6 KB
scripts/gates-fidelity.mjsscript6.3 KB
scripts/gates-fidelity.test.tsscript3.3 KB
scripts/gates-figures.mjsscript9.9 KB
scripts/gates-layout.mjsscript6.6 KB
scripts/gates-layout.test.tsscript12.4 KB
scripts/gates-static-headings.test.tsscript961 B
scripts/gates-static.mjsscript8.1 KB
scripts/gates-static.test.tsscript14.9 KB
scripts/gates-structure.mjsscript4.7 KB
scripts/gates-text.mjsscript7.2 KB
scripts/glossary-vocabulary.test.tsscript1.7 KB
scripts/html-foreign-object.mjsscript2.8 KB
scripts/html-lite.mjsscript9.7 KB
scripts/html-lite.test.tsscript7.9 KB
scripts/html-markup.mjsscript7.0 KB
scripts/html-text-map.mjsscript4.8 KB
scripts/html-text-map.test.tsscript15.2 KB
scripts/layout-probe.mjsscript4.6 KB
scripts/layout-probe.test.tsscript4.2 KB
scripts/lexicon.mjsscript2.6 KB
scripts/lexicon.test.tsscript3.2 KB
scripts/markdown-closers.mjsscript4.9 KB
scripts/md-lite-boundaries.test.tsscript2.2 KB
scripts/md-lite.mjsscript7.8 KB
scripts/md-lite.test.tsscript10.3 KB
scripts/meaning-check.mjsscript9.7 KB
scripts/meaning-check.test.tsscript12.0 KB
scripts/number-grammar.mjsscript2.1 KB
scripts/number-grammar.test.tsscript1.8 KB
scripts/numerals.mjsscript12.0 KB
scripts/numerals.test.tsscript6.1 KB
scripts/outcome-start.mjsscript3.8 KB
scripts/outcome-start.test.tsscript5.0 KB
scripts/outcome.mjsscript10.5 KB
scripts/outcome.test.tsscript12.8 KB
scripts/page-source-locator.test.tsscript11.7 KB
scripts/particles-ko.mjsscript4.8 KB
scripts/particles-ko.test.tsscript4.3 KB
scripts/placeholder.mjsscript9.3 KB
scripts/placeholder.test.tsscript3.8 KB
scripts/polish-apply.mjsscript6.8 KB
scripts/polish-apply.test.tsscript19.7 KB
scripts/polish-diff.mjsscript1.7 KB
scripts/polish-diff.test.tsscript10.1 KB
scripts/polish-markup.test.tsscript14.0 KB
scripts/polish-partial.test.tsscript2.5 KB
scripts/polish-project.mjsscript5.8 KB
scripts/polish-rules.mjsscript9.8 KB
scripts/rational.mjsscript5.2 KB
scripts/rational.test.tsscript1.9 KB
scripts/raw-decode.mjsscript4.5 KB
scripts/raw-locator.mjsscript2.4 KB
scripts/raw-snapshot.test.tsscript7.3 KB
scripts/references-fences.test.tsscript1.2 KB
scripts/repair-tracker.mjsscript7.5 KB
scripts/repair-tracker.test.tsscript10.8 KB
scripts/report-tools-2.test.tsscript16.1 KB
scripts/report-tools-3.test.tsscript9.3 KB
scripts/report-tools-4.test.tsscript10.1 KB
scripts/report-tools-5.test.tsscript14.6 KB
scripts/report-tools-commands.mjsscript12.9 KB
scripts/report-tools.mjsscript2.6 KB
scripts/report-tools.test.tsscript12.1 KB
scripts/sentence-split.mjsscript3.0 KB
scripts/sentence-split.test.tsscript4.5 KB
scripts/snapshot-readability.test.tsscript7.0 KB
scripts/source-commands.mjsscript12.4 KB
scripts/source-integrity.test.tsscript18.1 KB
scripts/source-refresh.mjsscript5.2 KB
scripts/source-snapshot.mjsscript9.9 KB
scripts/source-snapshot.test.tsscript6.3 KB
scripts/source-view.mjsscript5.0 KB
scripts/sources-citation.mjsscript12.1 KB
scripts/sources-citation.test.tsscript14.8 KB
scripts/tests/contracts-support.tsscript3.5 KB
scripts/tests/delivery-barrier-session.tsscript3.3 KB
scripts/tests/derive-clock.tsscript341 B
scripts/tests/fact-derive-support.tsscript1.9 KB
scripts/tests/fact-unit-dimensions-support.tsscript1.5 KB
scripts/tests/fact-unit-rules-support.tsscript16.8 KB
scripts/tests/fidelity-values-support.tsscript1.6 KB
scripts/tests/fixtures/assets/figure-1.svgother141 B
scripts/tests/fixtures/bad-report.htmlother2.1 KB
scripts/tests/fixtures/boxes.jsonconfig3.2 KB
scripts/tests/fixtures/conversion-probe.htmlother485 B
scripts/tests/fixtures/design-spec.mdmarkdown458 B
scripts/tests/fixtures/fidelity-brief-locked.mdmarkdown571 B
scripts/tests/fixtures/fidelity-brief-pending.mdmarkdown574 B
scripts/tests/fixtures/fidelity/assets/share.csvother40 B
scripts/tests/fixtures/fidelity/claim-graph.mdmarkdown449 B
scripts/tests/fixtures/fidelity/gen-legacy-dev.mjsscript5.0 KB
scripts/tests/fixtures/fidelity/ledger-basic.jsonconfig5.1 KB
scripts/tests/fixtures/fidelity/ledger-legacy-dev.jsonconfig18.3 KB
scripts/tests/fixtures/fidelity/ledger-verify.jsonconfig9.1 KB
scripts/tests/fixtures/fidelity/polish-edits.jsonconfig303 B
scripts/tests/fixtures/fidelity/report-bad.htmlother821 B
scripts/tests/fixtures/fidelity/report-good.htmlother2.4 KB
scripts/tests/fixtures/fidelity/sources/S4.htmlother680 B
scripts/tests/fixtures/fidelity/sources/S4/acronyms.jsonconfig36 B
scripts/tests/fixtures/fidelity/sources/S4/meta.jsonconfig256 B
scripts/tests/fixtures/fidelity/sources/S4/sentences.jsonlother623 B
scripts/tests/fixtures/fidelity/sources/S4/text.txtmarkdown300 B
scripts/tests/fixtures/fidelity/sources/S5/acronyms.jsonconfig3 B
scripts/tests/fixtures/fidelity/sources/S5/meta.jsonconfig235 B
scripts/tests/fixtures/fidelity/sources/S5/sentences.jsonlother53 B
scripts/tests/fixtures/fidelity/sources/S5/text.txtmarkdown10 B
scripts/tests/fixtures/fidelity/sources/S9.txtmarkdown128 B
scripts/tests/fixtures/good-report.htmlother2.7 KB
scripts/tests/fixtures/reference-report.htmlother2.5 KB

scripts/polish-markup.test.ts

View on GitHub
import { describe, expect, test } from "bun:test"

import { markupParts, skeletonChange } from "./html-markup.mjs"
import { applyEdits, POLISH_MARKUP_REASON, POLISH_REFERENCE_REASON, textOf } from "./polish-apply.mjs"
import { diffPolish } from "./polish-diff.mjs"

const LEDGER = { rows: [{ fact_id: "F1", quote: "Revenue may reach 320 m." }] }
const FACT = '<data data-fact="F1">320 m</data>'
const BASE = `<p id="a" class="plain" style="color:red">Revenue may reach ${FACT} this year.</p>`

// The public polish boundary must freeze bytes, not inferred HTML/CSS semantics.
const MARKUP_CASES = [
  ["hidden added", BASE, BASE.replace("<p ", "<p hidden ")],
  [
    "id changed under existing CSS",
    `<style>#gone{display:none}</style>${BASE}`,
    `<style>#gone{display:none}</style>${BASE.replace('id="a"', 'id="gone"')}`,
  ],
  ["class changed", BASE, BASE.replace('class="plain"', 'class="gone"')],
  ["style changed", BASE, BASE.replace("color:red", "display:none")],
  ["stylesheet inserted", BASE, `<style>.plain{display:none}</style>${BASE}`],
  ["self-closing slash added", BASE, BASE.replace('color:red">', 'color:red"/>')],
  ["wrapper added", BASE, BASE.replace(FACT, `<span>${FACT}</span>`)],
  ["wrapper removed", BASE.replace(FACT, `<span>${FACT}</span>`), BASE],
  ["comment added", BASE, `${BASE}<!-- note -->`],
  ["comment changed", `${BASE}<!-- note -->`, `${BASE}<!-- notes -->`],
  ["attribute reorder", BASE, BASE.replace('id="a" class="plain"', 'class="plain" id="a"')],
  ["attribute quote changed", BASE, BASE.replace('id="a"', "id='a'")],
  ["attribute name case changed", BASE, BASE.replace('id="a"', 'ID="a"')],
  ["duplicate attribute changed", BASE.replace("<p ", '<p id="first" '), BASE.replace("<p ", '<p id="other" ')],
  ["href changed", '<a href="/a">Reference</a>', '<a href="/b">Reference</a>'],
  ["closing tag changed", BASE, BASE.replace("</p>", "</div>")],
  ["tag renamed", "<p>Results may improve.</p>", "<div>Results may improve.</div>"],
  ["tag whitespace changed", BASE, BASE.replace("<p ", "<p  ")],
  ["declaration changed", `<!doctype html>${BASE}`, `<!DOCTYPE html>${BASE}`],
  ["script content changed", `${BASE}<script>let x = "note"</script>`, `${BASE}<script>let x = "notes"</script>`],
  ["style content changed", `${BASE}<style>.a{color:red}</style>`, `${BASE}<style>.a{color:tan}</style>`],
  ["template text changed", `${BASE}<template>note</template>`, `${BASE}<template>notes</template>`],
  [
    "nested template text changed",
    `${BASE}<template><template>x</template>note</template>`,
    `${BASE}<template><template>x</template>notes</template>`,
  ],
  ["unclosed script content changed", `${BASE}<script>note`, `${BASE}<script>notes`],
  ["unclosed template content changed", `${BASE}<template>note`, `${BASE}<template>notes`],
] as const

describe("polish text-node-only markup contract", () => {
  test.each(MARKUP_CASES)(
    "#given %s #then apply refuses markup changed and diff blocks",
    (_label: string, before: string, after: string) => {
      const result = applyEdits(before, [{ before, after }], LEDGER)
      expect(result.applied).toEqual([])
      expect(result.out).toBe(before)
      expect(result.rejected[0]?.reason).toContain("markup changed")
      const defects = diffPolish(before, after, LEDGER)
      expect(defects.find((item: { code: string }) => item.code === "polish_diff_fail")?.severity).toBe("blocker")
    },
  )

  test.each([
    [
      "existing self-closing hidden span",
      `<p>Revenue ${FACT} may rise. <span hidden/> Fine.</p>`,
      `<p>Revenue ${FACT} rise. <span hidden/> may Fine.</p>`,
    ],
    [
      "existing closed dialog",
      `<p>Revenue ${FACT} may rise.</p><dialog>Note.</dialog>`,
      `<p>Revenue ${FACT} rise.</p><dialog>may Note.</dialog>`,
    ],
    [
      "existing duplicate hidden style",
      '<p>Results may improve.</p><div style="display:none" style="color:red">Note.</div>',
      '<p>Results improve.</p><div style="display:none" style="color:red">may Note.</div>',
    ],
    [
      "aria-hidden fact text",
      `<p>Revenue <span aria-hidden="true">${FACT}</span> may rise.</p>`,
      `<p>Revenue <span aria-hidden="true">${FACT.replace("320", "321")}</span> may rise.</p>`,
    ],
    [
      "plain text inside aria-hidden fact",
      '<q data-fact="F1" aria-hidden="true">Revenue may rise.</q>',
      '<q data-fact="F1" aria-hidden="true">Revenue may soar.</q>',
    ],
    [
      "number moved between text nodes",
      "<p>Revenue 320 m.</p><span hidden>Note.</span>",
      "<p>Revenue.</p><span hidden>320 m Note.</span>",
    ],
  ])("#given %s #then protected text cannot migrate or change", (_label: string, before: string, after: string) => {
    expect(applyEdits(before, [{ before, after }], LEDGER).applied).toEqual([])
    expect(diffPolish(before, after, LEDGER).length).toBeGreaterThan(0)
  })

  test.each([
    ["plain prose", "<p>Results may improve steadily.</p>", "steadily", "slowly"],
    ["prose beside a fact", BASE, "this year", "next year"],
    ["quoted greater-than attribute", '<p title="a>b">Results may improve steadily.</p>', "steadily", "slowly"],
    ["literal less-than text", "<p>Growth < limits may persist steadily.</p>", "steadily", "slowly"],
    ["untouched entity beside the edit", "<p>R&amp;D may grow steadily.</p>", "steadily", "slowly"],
    [
      "unchanged frozen content",
      "<style>.a{display:none}</style><template>note</template><p>Results may improve steadily.</p>",
      "steadily",
      "slowly",
    ],
  ])(
    "#given %s #then a text-only edit with protected tokens intact passes",
    (_label: string, html: string, from: string, to: string) => {
      const after = html.replace(from, to)
      expect(applyEdits(html, [{ before: from, after: to }], LEDGER).out).toBe(after)
      expect(diffPolish(html, after, LEDGER)).toEqual([])
    },
  )
})

// Review #11152 round 4: an edit may never carry <, > or &, so it cannot create, alter, close or
// escape any tag, comment, bogus comment, CDATA section, entity or script, whatever the tokenizer models.
const DATA = '<p>Revenue reached <data class="fact" data-fact="F1">320 m</data> in spring.</p>'
const SCRIPT = "<p>Results may improve steadily.</p><script><!--<script></script>foo();</script>"
describe("polish edits never carry markup characters", () => {
  test.each([
    ["bogus comment before a fact span", DATA, "Revenue reached ", "Revenue reached </ "],
    [
      "bogus comment hiding a sentence",
      "<p>Fine. The board met in spring.</p>",
      "The board met in spring.",
      "</ The board met in spring.>",
    ],
    ["empty end tag", "<p>Results may improve steadily.</p>", "steadily", "steadily </>"],
    ["introduced entity", "<p>Results may improve steadily.</p>", "steadily", "steadily &lt;b&gt;"],
    ["introduced greater-than", "<p>Results may improve steadily.</p>", "steadily", "steadily >"],
    ["removed entity", "<p>R&amp;D may grow steadily.</p>", "R&amp;D", "RD"],
  ])("#given %s #then apply rejects it and diff blocks", (_label: string, html: string, from: string, to: string) => {
    const result = applyEdits(html, [{ before: from, after: to }], LEDGER)
    expect(result.applied).toEqual([])
    expect(result.out).toBe(html)
    expect(result.rejected[0]?.reason).toContain(
      "edit contains markup characters (<, >, &): route this section through the full fidelity gates",
    )
    if (from === "R&amp;D" || to.includes("&lt;") || to === "steadily >") return
    expect(
      diffPolish(html, html.replace(from, to), LEDGER).find(
        (item: { code: string }) => item.code === "polish_diff_fail",
      )?.severity,
    ).toBe("blocker")
  })

  test.each([
    ["words around R&amp;D", "<p>Our R&amp;D budget grew in 2025.</p>", "budget grew", "budget rose", true],
    [
      "an edit spanning R&amp;D",
      "<p>Our R&amp;D budget grew in 2025.</p>",
      "Our R&amp;D budget grew",
      "The R&amp;D budget rose",
      false,
    ],
    [
      "words around p &lt; 0.05",
      "<p>The effect held at p &lt; 0.05 in the trial.</p>",
      "in the trial",
      "across the trial",
      true,
    ],
    [
      "an edit spanning p &lt; 0.05",
      "<p>The effect held at p &lt; 0.05 in the trial.</p>",
      "held at p &lt; 0.05",
      "stayed at p &lt; 0.05",
      false,
    ],
  ])(
    "#given legitimate prose with %s #then only an edit leaving the entity bytes untouched applies",
    (_label: string, html: string, from: string, to: string, passes: boolean) => {
      const result = applyEdits(html, [{ before: from, after: to }], LEDGER)
      if (passes) {
        expect(result.out).toBe(html.replace(from, to))
        expect(diffPolish(html, result.out, LEDGER)).toEqual([])
        return
      }
      expect(result.out).toBe(html)
      expect(result.rejected[0]?.reason).toContain(POLISH_MARKUP_REASON)
    },
  )

  test("#given double-escaped script code #then the ambiguity refusal blocks a text-only edit of it", () => {
    const result = applyEdits(SCRIPT, [{ before: "foo();", after: "bar();" }], LEDGER)
    expect(result.applied).toEqual([])
    expect(result.rejected[0]?.reason).toContain("ambiguous markup: <!-- inside script")
    expect(diffPolish(SCRIPT, SCRIPT.replace("foo", "bar"), LEDGER)[0]?.message).toContain("ambiguous markup")
  })

  test.each([
    ["end tag open before a non-letter", "<p>a </ b> c</p>"],
    ["empty end tag", "<p>a </> c</p>"],
    ["comment opener inside script", "<script><!-- x --></script><p>c</p>"],
    ["comment opener inside style", "<style><!-- .a{} --></style><p>c</p>"],
    ["CDATA section", "<p>a <![CDATA[ b ]]> c</p>"],
    ["processing instruction", "<p>a <?x b?> c</p>"],
    ["less-than inside an attribute value", '<p title="a<b">c</p>'],
    ["comment closed by --!>", "<p>a <!-- b --!> c</p>"],
  ])("#given a document with %s #then diff refuses it as ambiguous markup", (_label: string, html: string) => {
    const defect = diffPolish(html, html, LEDGER).find((item: { code: string }) => item.code === "polish_diff_fail")
    expect(defect?.message).toContain("ambiguous markup")
  })

  test("#given an end tag open before a non-letter #then the tokenizer skips a bogus comment to the next >", () => {
    expect(markupParts("a </ b> c </> d").markup).toEqual(["</ b>", "</>"])
  })

  test("#given a double-escaped script #then the script runs to the close outside the escape", () => {
    expect(markupParts(`${SCRIPT}<p>x</p>`).markup).toEqual([
      "<p>",
      "</p>",
      "<script><!--<script></script>foo();</script>",
      "<p>",
      "</p>",
    ])
    expect(markupParts("<script><!-- a --></script><b>x</b>").markup).toEqual([
      "<script><!-- a --></script>",
      "<b>",
      "</b>",
    ])
  })
})

// Review #11152 round 5: the primary rule is a whole-document skeleton comparison. Every markup
// token and every character reference in text must be byte-identical; an edit's located region may
// not touch a character reference either, so an edit can neither change nor create one.
const AMPD = "<p>We fund R&amp;D labs here.</p>"
const TOM = "<p>Tom & Jerry ran.</p>"
describe("polish keeps character references intact", () => {
  test.each(["style", "p"])(
    "#given a quoted greater-than in a %s end tag #when its quote changes #then diff blocks",
    (tag: string) => {
      const before = `<${tag}>p{}</${tag} a='>'> trailing prose`
      const after = before.replace(">'", ">x")
      expect(diffPolish(before, after, LEDGER).map((item: { code: string }) => item.code)).toContain("polish_diff_fail")
    },
  )

  test.each(["&amp.", `&${"a".repeat(24)}.`])(
    "#given %s immediately before an edit #when extended #then the reference reason is actionable",
    (reference: string) => {
      const html = `<p>${reference} next</p>`
      const result = applyEdits(html, [{ before: " next", after: "later" }], LEDGER)
      expect(result.rejected[0]?.reason).toContain(POLISH_REFERENCE_REASON)
      expect(result.out).toBe(html)
      expect(
        diffPolish(html, html.replace(" next", "later"), LEDGER).map((item: { code: string }) => item.code),
      ).toContain("polish_diff_fail")
    },
  )

  test.each([
    ["an edit starting inside an entity", AMPD, "amp;D labs", "lt;D labs"],
    ["an edit starting right after a bare ampersand", TOM, " Jerry ran", "lt; ran"],
  ])(
    "#given %s #then apply refuses it and diff blocks the hand edit",
    (_label: string, html: string, from: string, to: string) => {
      const result = applyEdits(html, [{ before: from, after: to }], LEDGER)
      expect(result.applied).toEqual([])
      expect(result.out).toBe(html)
      expect(result.rejected[0]?.reason).toContain("character reference")
      const defects = diffPolish(html, html.replace(from, to), LEDGER)
      expect(defects.find((item: { code: string }) => item.code === "polish_diff_fail")?.severity).toBe("blocker")
    },
  )

  test("#given a hand edit from R&amp;D to R&lt;D #then diff blocks it", () => {
    const defect = diffPolish(AMPD, AMPD.replace("&amp;", "&lt;"), LEDGER).find(
      (item: { code: string }) => item.code === "polish_diff_fail",
    )
    expect(defect?.message).toContain("skeleton changed")
  })

  test.each([
    ["an entity changed", AMPD, AMPD.replace("&amp;", "&lt;")],
    ["an entity created", TOM, "<p>Tom &lt; ran.</p>"],
    ["an entity removed", AMPD, AMPD.replace("R&amp;D", "RD")],
    ["a tag changed", AMPD, AMPD.replace("<p>", "<div>")],
  ])(
    "#given %s #then the skeleton check alone names the first differing token",
    (_label: string, before: string, after: string) => {
      expect(skeletonChange(before, after)).toContain("skeleton changed at token")
    },
  )

  test.each([
    ["words beside an entity", AMPD, AMPD.replace("labs here", "labs nearby")],
    ["words beside a bare ampersand", TOM, TOM.replace("ran", "walked")],
    ["an unchanged document", AMPD, AMPD],
  ])("#given %s #then the skeleton is unchanged", (_label: string, before: string, after: string) => {
    expect(skeletonChange(before, after)).toBeNull()
  })

  test("#given a quoted greater-than in an attribute #then the text projection follows the scanner", () => {
    expect(textOf('<p title="a>b">Results may improve.</p>').trim()).toBe("Results may improve.")
  })
})
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall