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/fact-pairs.mjs

View on GitHub
// fact-pairs.mjs - (source, report sentence) pairs for the meaning verifier.
//
// extractPairs walks the prose sentences of a filled HTML report and emits, in document order:
// a quote pair per distinct ledger quote cited by a findings sentence (facts sharing one quote
// share one pair), a claim pair per sentence bound only by data-claim (the statement comes from
// the claim index), and a translation pair per data-translates span. force_strong routes a pair
// to the strong reader when the lexicon raised name_outside_quote or scope_widened_warn, when the
// hedge-position heuristic fired, or when the source hedges and the sentence's last six tokens do
// not. No model, no IO: the readers run as separate lanes. Plain Node ESM; no Hangul here.

import { isExemptKind, proseSentences } from "./fidelity-binding.mjs"
import { isKoreanTerm, lexicalPattern, lexiconChecks } from "./fidelity-lexicon.mjs"
import { sentenceKey } from "./fidelity-state.mjs"
import { buildContext } from "./gates-static.mjs"
import { parseHtml, proseText } from "./html-lite.mjs"
import { HEDGES } from "./lexicon.mjs"
import { normalizeText } from "./text-normalize.mjs"

/** Every pair kind the producers below emit; consumers count and schema pairs by this list. */
export const PAIR_KINDS = Object.freeze(["quote", "claim", "translation"])
const TAIL = 6

const lang = (text) => (isKoreanTerm(text) ? "ko" : "en")
/** Sentence text with its fact spans cut out, so a Korean value does not make an English sentence Korean. */
const outsideFacts = (sentence) =>
  sentence.facts.reduceRight(
    (text, fact) => text.slice(0, fact.start - sentence.start) + text.slice(fact.end - sentence.start),
    sentence.text,
  )

/** Latin hedges match whole words ("exact"); Korean hedges match as substrings, one syllable as a token prefix ("stem"). */
const HEDGE_RES = HEDGES.map((term) => lexicalPattern(term, isKoreanTerm(term) ? "stem" : "exact"))

/** Hedge terms that are also month names; capitalized and followed by a date number, they are months. */
const MONTH_WORDS = new Set(["may"])

/** A capitalized Latin match after the first word is a name or a month ("in May"), not a hedge. */
const isHedgeAt = (text, match) => {
  if (!/^\p{Lu}/u.test(match[0]) || isKoreanTerm(match[0])) return true
  if (match.index !== 0) return false
  // At the start of a text a capital is only sentence case, so the word still hedges - unless it is a
  // month name followed by a date number ("May 2024 sales rose.").
  return !(MONTH_WORDS.has(match[0].toLowerCase()) && /^\s+\p{Nd}/u.test(text.slice(match.index + match[0].length)))
}

export const hasHedge = (text) => {
  const normal = normalizeText(text)
  return HEDGE_RES.some((re) => [...normal.matchAll(re)].some((match) => isHedgeAt(normal, match)))
}

/** The source hedges and none of the sentence's last six tokens carries a hedge. */
function tailDropsHedge(source, sentence) {
  if (!hasHedge(source)) return false
  return !hasHedge(normalizeText(sentence).split(/\s+/u).filter(Boolean).slice(-TAIL).join(" "))
}

function slugOf(scope) {
  const heading = scope.section?.heading
  if (!heading) return ""
  return (heading.attrs.id ?? proseText(heading))
    .toLowerCase()
    .replace(/[^\p{L}\p{N}]+/gu, "-")
    .replace(/^-+|-+$/gu, "")
}

function claimMap(claims) {
  const list = Array.isArray(claims) ? claims : (claims?.claims ?? [])
  return new Map(list.map((claim) => [claim.claim_id, claim]))
}

const idsOf = (attr) =>
  String(attr ?? "")
    .split(/[\s,]+/u)
    .filter(Boolean)

/** Claim ids that bind a sentence: on the block or an ancestor, or on an inner element whose text the sentence holds. */
function claimIdsFor(ctx, block, sentence) {
  const { closest, descendants } = ctx.util
  const up =
    block.owner.attrs["data-claim"] !== undefined
      ? block.owner
      : closest(block.owner, (node) => node.attrs?.["data-claim"] !== undefined)
  const ids = up ? idsOf(up.attrs["data-claim"]) : []
  const text = normalizeText(sentence.text)
  for (const node of descendants(block.owner)) {
    if (node.attrs?.["data-claim"] === undefined) continue
    const inner = normalizeText(proseText(node))
    if (inner !== "" && text.includes(inner)) ids.push(...idsOf(node.attrs["data-claim"]))
  }
  return [...new Set(ids)]
}

function exempt(ctx, node) {
  return (
    isExemptKind(node.attrs["data-kind"]) ||
    Boolean(ctx.util.closest(node, (cur) => isExemptKind(cur.attrs?.["data-kind"])))
  )
}

/** Lexicon routing for every fact span of one quote group in one sentence. */
function lexiconRouted(group, sentence) {
  const probes = group.facts.map((fact, index) => ({
    pair_id: String(index),
    quote: group.quote,
    sentence: sentence.text,
    span: [fact.start - sentence.start, fact.end - sentence.start],
    qualifier: group.row.kind === "quote" ? null : (group.rows.get(fact.id)?.qualifier ?? null),
  }))
  return lexiconChecks(probes).forceStrong.length > 0
}

function quotePairs(sentence, rows, slug, reportLang) {
  const groups = new Map()
  for (const fact of sentence.facts) {
    const row = rows.get(fact.id)
    if (!row?.quote) continue
    const group = groups.get(row.quote) ?? { quote: row.quote, row, rows, facts: [], ids: [] }
    group.facts.push(fact)
    if (!group.ids.includes(fact.id)) group.ids.push(fact.id)
    groups.set(row.quote, group)
  }
  const allIds = [...new Set(sentence.facts.map((fact) => fact.id))]
  return [...groups.values()].map((group) => ({
    kind: "quote",
    sentence_key: sentenceKey(slug, allIds),
    fact_ids: [...group.ids].sort(),
    quote: group.quote,
    sentence: sentence.text,
    source_lang: lang(group.quote),
    report_lang: reportLang ?? lang(outsideFacts(sentence)),
    force_strong: lexiconRouted(group, sentence) || tailDropsHedge(group.quote, sentence.text),
  }))
}

function claimPairs(ctx, block, sentence, byClaim, slug, reportLang) {
  if (sentence.facts.length > 0 || exempt(ctx, block.owner)) return []
  return claimIdsFor(ctx, block, sentence)
    .map((id) => byClaim.get(id))
    .filter(Boolean)
    .map((claim) => ({
      kind: "claim",
      sentence_key: sentenceKey(slug, [claim.claim_id]),
      claim_id: claim.claim_id,
      statement: claim.statement,
      sentence: sentence.text,
      source_lang: lang(claim.statement),
      report_lang: reportLang ?? lang(sentence.text),
      force_strong:
        lexiconChecks([{ pair_id: "c", quote: claim.statement, sentence: sentence.text }]).forceStrong.length > 0 ||
        tailDropsHedge(claim.statement, sentence.text),
    }))
}

function translationPair(node, rows, slug, reportLang) {
  const id = node.attrs["data-translates"]
  const row = rows.get(id)
  const text = proseText(node)
  if (!row?.quote || text === "") return null
  return {
    kind: "translation",
    sentence_key: sentenceKey(slug, [id]),
    fact_ids: [id],
    quote: row.quote,
    sentence: text,
    source_lang: lang(row.quote),
    report_lang: reportLang ?? lang(text),
    force_strong: tailDropsHedge(row.quote, text),
  }
}

/**
 * @param {string} html the filled report
 * @param {{ rows: object[] }} ledger
 * @param {{ claims: object[] } | object[] | null} claims indexClaims(...) output or its claims array
 * @returns {object[]} pairs with pair_id P1, P2, ... in document order
 */
export function extractPairs(html, ledger, claims) {
  const ctx = buildContext(parseHtml(html), {})
  const rows = new Map((ledger?.rows ?? []).map((row) => [row.fact_id, row]))
  const byClaim = claimMap(claims)
  const htmlLang = ctx.all.find((node) => node.tag === "html")?.attrs.lang
  const reportLang = htmlLang ? htmlLang.toLowerCase().split("-")[0] : null
  const out = []
  const seenSpans = new Set()
  for (const block of proseSentences(ctx)) {
    const findings = Boolean(block.scope.section) && block.kind === null
    if (!findings) continue
    const slug = slugOf(block.scope)
    for (const sentence of block.sentences) {
      out.push(
        ...quotePairs(sentence, rows, slug, reportLang),
        ...claimPairs(ctx, block, sentence, byClaim, slug, reportLang),
      )
    }
    for (const node of ctx.util.descendants(block.owner)) {
      if (node.attrs?.["data-translates"] === undefined || seenSpans.has(node)) continue
      seenSpans.add(node)
      const pair = translationPair(node, rows, slug, reportLang)
      if (pair) out.push(pair)
    }
  }
  return out.map((pair, index) => ({ pair_id: `P${index + 1}`, ...pair }))
}
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