code-yeongyu/oh-my-openagent / packages/shared-skills/skills/ulw-research
ulw-research
UnverifiedRuns 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.
scripts/claim-prefix.test.ts
View on GitHubimport { describe, expect, test } from "bun:test"
import { readFileSync } from "node:fs"
import { join } from "node:path"
import { markdownAsHtml } from "./fact-commands-verify.mjs"
import { fill } from "./fact-fill.mjs"
import { valueChecks } from "./fidelity-values.mjs"
import { buildContext } from "./gates-static.mjs"
import { parseHtml } from "./html-lite.mjs"
import { parsePlaceholder, renderValueHtml } from "./placeholder.mjs"
type Row = Record<string, unknown> & { fact_id: string }
const FIX = join(import.meta.dir, "tests", "fixtures", "fidelity")
const BASE: { rows: Row[] } = JSON.parse(readFileSync(join(FIX, "ledger-verify.json"), "utf8"))
const row = (id: string) => BASE.rows.find((r) => r.fact_id === id) as Row
const converted = { ...row("F8"), raw: "320,000 mm (320 m)", render: "320,000 mm (320 m)", derived_from: ["F1"] }
const assumed = {
...row("F8"),
fact_id: "F9",
kind: "assumed",
label: "plan",
raw: "15%",
render: null,
value: "15",
unit: "%",
derived_from: [],
operands: [],
operation: null,
}
const ledger = { ...BASE, rows: [...BASE.rows.filter((r) => r.fact_id !== "F8"), converted, assumed] }
const check = (html: string) =>
valueChecks(buildContext(parseHtml(`<h2>Findings</h2>${html}`), { baseDir: FIX }), ledger, null, join(FIX, "sources"))
describe("claim prefixes come from the CLAIM_KINDS registry and combine with the pointer grammar", () => {
test("#given a prefix before a value mode or a quote selector #when parsed #then the pointer keeps its mode and gains the claim kind", () => {
expect(parsePlaceholder("{{D:F12:label}}")).toEqual({
id: "F12",
kind: "F",
label: "label",
mode: "full",
claimKind: "derived",
})
expect(parsePlaceholder("{{D:F12:label:value}}")).toEqual({
id: "F12",
kind: "F",
label: "label",
mode: "value",
claimKind: "derived",
})
expect(parsePlaceholder("{{V:Q7:label:lead=3}}")).toMatchObject({
id: "Q7",
mode: "lead",
lead: 3,
claimKind: "verified",
})
expect(parsePlaceholder("{{A:F9:plan}}")).toMatchObject({ id: "F9", claimKind: "assumed" })
})
for (const token of [
"{{D:F12}}",
"{{D:F12:}}",
"{{D:F12:a:b}}",
"{{V:F7}}",
"{{A:}}",
"{{X:F8:span_mm}}",
"{{V:V:F7:test_pass}}",
"{{D:F0:label}}",
]) {
test(`#given the malformed ${token} #when filled #then unresolved_placeholder`, () => {
const result = fill(token, ledger)
expect(result.out).toBeNull()
expect((result.errors as { code: string }[]).map((e) => e.code)).toEqual(["unresolved_placeholder"])
})
}
for (const [token, code] of [
["{{A:F8:span_mm}}", "claim_kind_mismatch"],
["{{V:F8:span_mm}}", "unsupported_verification"],
]) {
test(`#given ${token} on a row its kind refuses #when filled #then the kind's documented defect ${code}`, () => {
const result = fill(token, ledger)
expect(result.out).toBeNull()
expect((result.errors as { code: string }[]).map((e) => e.code)).toEqual([code])
})
}
})
describe("renderValueHtml takes { mode, claimKind }", () => {
test("#given a value-mode fact with a D claim #when rendered #then both the mode marker and the claim attribute are emitted", () => {
const html = renderValueHtml(converted, "320,000", { mode: "value", claimKind: "derived" })
expect(html).toContain('data-fact-mode="value"')
expect(html).toContain('data-claim-kind="derived"')
expect(renderValueHtml(converted, "320,000 mm")).not.toMatch(/data-fact-mode|data-claim-kind/)
})
test("#given {{D:F8:span_mm:value}} #when filled to HTML #then the element carries both attributes and the fill map records the mode", () => {
const result = fill("<p>{{D:F8:span_mm:value}} mm</p>", ledger)
expect(result.errors).toEqual([])
expect(result.out).toContain('data-fact-mode="value"')
expect(result.out).toContain('data-claim-kind="derived"')
expect(result.fillMap[0]).toMatchObject({ mode: "value", claimKind: "derived" })
})
})
describe("prefixed fills verify clean in HTML and Markdown", () => {
for (const [token, kind] of [
["{{V:F7:test_pass}}", "verified"],
["{{A:F9:plan}}", "assumed"],
["{{D:F8:span_mm}}", "derived"],
]) {
for (const format of ["html", "md"] as const) {
test(`#given ${token} filled as ${format} #when verified #then it carries ${kind} and raises nothing`, () => {
const result = fill(format === "html" ? `<p>${token} [S4].</p>` : `${token} [S4].`, ledger, { format })
expect(result.errors).toEqual([])
if (result.out === null) throw new Error("fill failed")
const html =
format === "html"
? result.out
: markdownAsHtml(result.out, result.fillMap as Parameters<typeof markdownAsHtml>[1], ledger).html
expect(html).toContain(`data-claim-kind="${kind}"`)
expect(check(html)).toEqual([])
})
}
}
})
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |