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-unit-dimensions-2.test.ts

View on GitHub
import { expect, test } from "bun:test"
import { recompute } from "./fact-derive.mjs"
import { derive } from "./tests/derive-clock"
import { addRow, emptyLedger, retractRow, validateLedger } from "./fact-ledger.mjs"
import { canonicalUnit } from "./unit-rules.mjs"
import { convertFactor } from "./units.mjs"
import { Row, Book, now, book, row, sum, refused } from "./tests/fact-unit-dimensions-support"

test("dimension 21: expression root and literal precision remain explicit", () => {
  const l = book(["1000", "3"], ["m", "m"])
  expect(row(l, { op: "expr", formula: "F1 - F2", unit: "m" }).value).toBe("997")
  expect(row(l, { op: "expr", formula: "(F1 - F2) * 1", unit: "m" }).value).toBe("1000")
  expect(row(l, { op: "expr", formula: "(F1 - F2) * 1.00", unit: "m" }).value).toBe("1000")
})

test("dimension 22: cloned snapshots are deterministic and replay appends a new identity", () => {
  const original = book()
  const left = structuredClone(original)
  const right = structuredClone(original)
  expect(row(left, sum)).toEqual(row(right, sum))
  expect(row(left, sum).fact_id).toBe("F4")
  expect(original.rows).toHaveLength(2)
})

test("dimension 23: coherent trusted input rewrites are a documented arithmetic limitation", () => {
  const l = book(["0", "3"])
  const km = row(l, { op: "convert", operands: ["F1"], to: "km" })
  const cm = row(l, { op: "convert", operands: ["F1"], to: "cm" })
  const coherent = { ...cm, fact_id: km.fact_id, label: km.label }
  expect(recompute(l, coherent).ok).toBe(true)
  expect(recompute(l, { ...km, unit: "cm" }).ok).toBe(false)
})

test("dimension 24: sum permutation and ordered arithmetic keep their own semantics", () => {
  const l = book(["2", "5"])
  for (const operands of [
    ["F1", "F2"],
    ["F2", "F1"],
  ])
    expect(row(l, { ...sum, operands }).exact).toEqual({ num: "7", den: "1" })
  expect(row(l, { ...sum, op: "diff" }).exact).toEqual({ num: "-3", den: "1" })
  expect(row(l, { ...sum, op: "diff", operands: ["F2", "F1"] }).exact).toEqual({ num: "3", den: "1" })
})

test("dimension 25: numeric domain boundaries do not forbid negative ordinary arithmetic", () => {
  for (const values of [
    ["6", "5"],
    ["-1", "5"],
    ["0", "0"],
  ])
    expect(derive(book(values), { op: "share", part: "F1", whole: "F2", unit: "%" }).error).toBeDefined()
  expect(row(book(["-2", "-5"]), sum).exact).toEqual({ num: "-7", den: "1" })
  expect(derive(book(), { op: "expr", formula: "F1 / (F2 - F2)", unit: null }).error).toBeDefined()
})

test("dimension 26: percent products and pct nodes preserve fraction semantics", () => {
  const l = book(["20", "50"], ["%", "%"])
  expect(row(l, { op: "expr", formula: "pct(F1 * F2)", unit: "%" }).exact).toEqual({ num: "10", den: "1" })
  expect(row(l, { op: "diff", operands: ["F2", "F1"], unit: "%p" }).exact).toEqual({ num: "30", den: "1" })
  expect(derive(l, { op: "expr", formula: "pct(F1)", unit: "%" }).error).toBeDefined()
})

test("dimension 27: conversion maps compose with exact independent rational arithmetic", () => {
  const groups = [
    ["mm", "cm", "m", "km"],
    ["g", "kg", "t"],
    ["ms", "s", "min", "h"],
    ["B", "KB", "MB", "GB", "TB"],
    ["C", "F"],
    ["%", "\u2030"],
    ["KRW", "KRW-e3", "KRW-e4", "KRW-e8", "KRW-e12"],
  ]
  const apply = (
    factor: { num: bigint; den: bigint; offset?: { num: bigint; den: bigint } } | null,
    x: [bigint, bigint],
  ): [bigint, bigint] => {
    if (!factor) throw Error("missing conversion")
    const o = factor.offset ?? { num: 0n, den: 1n }
    return [x[0] * factor.num * o.den + o.num * x[1] * factor.den, x[1] * factor.den * o.den]
  }
  for (const group of groups)
    for (const a of group)
      for (const b of group)
        for (const c of group) {
          for (const value of [-3n, 0n, 7n]) {
            const direct = apply(convertFactor(a, c), [value, 1n])
            const chained = apply(convertFactor(b, c), apply(convertFactor(a, b), [value, 1n]))
            expect(direct[0] * chained[1]).toBe(chained[0] * direct[1])
          }
        }
  expect(derive(book(), { op: "convert", operands: ["F1"], to: "furlong" }).error).toBeDefined()
})

test("dimension 28: grammar rejects injection and preserves precedence", () => {
  for (const formula of ["F1;globalThis.x=1", "-F1", "F1 ** 2", "pct F1", "(F1", "F1 F2"])
    expect(derive(book(), { op: "expr", formula, unit: "m" }).error).toBeDefined()
  expect(row(book(), { op: "expr", formula: "F1 + F2 * 2", unit: "m" }).exact).toEqual({ num: "7", den: "1" })
})

test("dimension 29: signed rounding ties and canonical display are exact", () => {
  for (const [values, expected] of [
    [["-1.25", "-2.5"], "-3.8"],
    [["1.25", "2.5"], "3.8"],
    [["999.5", "0"], "1000"],
  ] as const) {
    expect(row(book([...values]), sum).value).toBe(expected)
  }
  const l = book(["20", "15"], ["%", "%"])
  const delta = row(l, { op: "diff", operands: ["F1", "F2"], unit: "%p" })
  expect(recompute(l, { ...delta, render: "5 pp" }).ok).toBe(false)
})

test("dimension 30: seeded factor trees have an independent arithmetic and unit oracle", () => {
  let seed = 0x11009
  const next = () => {
    seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0
    return seed
  }
  const atoms = ["m", "s", "person"]
  for (let i = 0; i < 100; i++) {
    const counts = [0, 0, 0]
    const factors = Array.from({ length: 5 }, () => {
      const index = next() % atoms.length
      const exponent = (next() % 7) - 3
      counts[index] += exponent
      return `(${atoms[index]}^${exponent})`
    })
    const side = (positive: boolean) =>
      atoms
        .map((a, index) => ({ a, n: counts[index] }))
        .filter(({ n }) => (positive ? n > 0 : n < 0))
        .sort((a, b) => a.a.localeCompare(b.a))
        .map(({ a, n }) => (Math.abs(n) === 1 ? a : `${a}^${Math.abs(n)}`))
    const top = side(true).join("*") || "1"
    const bottom = side(false)
    const expectedUnit = bottom.length
      ? `${top}/${bottom.length === 1 ? bottom[0] : `(${bottom.join("*")})`}`
      : top === "1"
        ? null
        : top
    expect(canonicalUnit(factors.join("*"))).toBe(expectedUnit)
    const a = BigInt(1 + (next() % 100))
    const b = BigInt(1 + (next() % 100))
    const l = book([String(a), String(b)], [factors.join("*"), "person"])
    const result = row(l, { op: "expr", formula: "F1 * F2 / F2", unit: expectedUnit })
    expect(result.exact).toEqual({ num: String(a), den: "1" })
    expect(result.unit).toBe(expectedUnit)
    expect(recompute(l, result).ok).toBe(true)
    expect(recompute(l, { ...result, exact: { num: String(a + 1n), den: "1" } }).ok).toBe(false)
  }
})

test("dimension 30: independent rational oracle crosses every operation with metadata and tampering", () => {
  let state = 3917
  const next = () => {
    state = (Math.imul(state, 1103515245) + 12345) >>> 0
    return state
  }
  const exact = (n: bigint, d = 1n) => {
    let a = n < 0n ? -n : n
    let b = d
    while (b) [a, b] = [b, a % b]
    return { num: String(n / a), den: String(d / a) }
  }
  for (let i = 0; i < 50; i++) {
    const a = BigInt(1 + (next() % 50))
    const b = a + BigInt(1 + (next() % 50))
    const meta = {
      population: { country: "x", cohort: i },
      accounting_basis: "cash",
      snapshot_window: "2026",
      entity: "acme",
    }
    const specs: Array<[Row, { num: string; den: string }]> = [
      [{ ...sum }, exact(a + b)],
      [{ ...sum, op: "diff" }, exact(a - b)],
      [{ op: "ratio", num: "F1", den: "F2", unit: null }, exact(a, b)],
      [{ op: "share", part: "F1", whole: "F2", unit: "%" }, exact(100n * a, b)],
      [{ op: "growth", from: "F1", to: "F2", unit: "%" }, exact(100n * (b - a), a)],
      [{ op: "convert", operands: ["F1"], to: "cm" }, exact(100n * a)],
      [{ op: "expr", formula: "F1 * 2 / F2", unit: null }, exact(2n * a, b)],
    ]
    for (const [spec, expected] of specs) {
      const l = book(
        [String(a), String(b)],
        ["metre", "m"],
        [
          { ...meta, valid_at: "2025" },
          { ...meta, valid_at: "2026" },
        ],
      )
      const result = row(l, spec)
      expect(result.exact).toEqual(expected)
      expect(recompute(l, result).ok).toBe(true)
      expect(recompute(l, { ...result, unit: "person" }).ok).toBe(false)
      expect(recompute(l, { ...result, exact: { num: String(BigInt(expected.num) + 1n), den: expected.den } }).ok).toBe(
        false,
      )
    }
    const l = book([String(100n * a), String(b)], ["bp/person", "person"])
    const result = row(l, { op: "expr", formula: "F1 * F2", unit: "%p" })
    expect(result.exact).toEqual(exact(a * b))
  }
})
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