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-commands-verify.mjs

View on GitHub
// fact-commands-verify.mjs - `fact verify` and the Markdown projection it checks.
//
// fact verify runs the deterministic fidelity gate over one filled HTML or Markdown edition and
// writes a fidelity record (default $SESSION_DIR/fidelity-defects.json, through
// writeFidelityRecord) carrying the artifact's sha256. It
// exits 1 on any blocker or major defect (the orchestrator then records `outcome gate fidelity
// fail`); minors alone exit 0 and are listed. A Markdown edition is read through md-lite into an
// escaped HTML projection (same line numbers) and checked with its fill map, which is the only
// record of where its values sit; LaTeX is verified through its Markdown source.
//
// The locked brief is re-judged here, not only at fill: every edition (HTML or Markdown) needs its
// fill map (fillMapOf: --fill-map, else whichever of `<report>.fill-map.json` and the
// `<report>.polished.fill-map.json` polish-apply writes records the edition's bytes), and that map
// must carry the current brief's brief_sha256; no map, or another hash, is brief_changed. policyErrors
// re-runs over every data-fact the edition carries, so an edition that violates the current
// derived-numbers or source-floor rule fails here too.
//
// The delivery barrier that reads these records (and every other fidelity record) is
// fidelity-records.mjs.

import { existsSync, readFileSync } from "node:fs"
import { dirname, join, resolve } from "node:path"

import { CliError, readJsonFile, sha256Of } from "./cli-support.mjs"
import { countDefects } from "./contracts.mjs"
import { recompute } from "./fact-derive.mjs"
import { readLedger } from "./fact-ledger.mjs"
import { validateLedger } from "./fact-ledger-schema.mjs"
import { briefBindingErrors, fillPolicy, lockedBrief, policyErrors } from "./fidelity-policy.mjs"
import { FIDELITY_RECORD, writeFidelityRecord } from "./fidelity-records.mjs"
import { blocksDelivery, checkFidelity } from "./gates-fidelity.mjs"
import { parseMarkdown } from "./md-lite.mjs"
import { escapeHtml, parseRenderedQuote, renderQuote, renderValueHtml } from "./placeholder.mjs"
import { sessionDirOf } from "./source-commands.mjs"

function readText(path) {
  try {
    return readFileSync(path, "utf8")
  } catch (error) {
    throw new CliError(`cannot read ${path}: ${error.code ?? error.message}`)
  }
}

/**
 * md-lite block kind -> its projection: the element tag (null = h<level>) and, for a run of one kind,
 * the container that wraps the run. Code and table rows also take the specialized bodies below.
 */
export const MD_HTML_BLOCK_RULES = Object.freeze({
  heading: Object.freeze({ tag: null }),
  paragraph: Object.freeze({ tag: "p" }),
  list_item: Object.freeze({ tag: "li", group: Object.freeze(["<ul>", "</ul>"]) }),
  blockquote: Object.freeze({ tag: "blockquote" }),
  code: Object.freeze({ tag: "code" }),
  table_row: Object.freeze({ tag: "tr", group: Object.freeze(["<table>", "</table>"]) }),
})

/** Escaped text with inline links and code spans kept as elements, so a URL is never read as prose. */
export const projectMarkdownInline = (text) =>
  escapeHtml(text)
    .replace(/\[([^\]]+)\]\(([^)\s]+)\)/gu, '<a href="$2">$1</a>')
    .replace(/`([^`]+)`/gu, "<code>$1</code>")

/** The element the HTML fill writes for one fill-map entry, or null when its bytes were edited since. */
function entryHtml(text, entry, rows) {
  const body = text.slice(entry.start, entry.end)
  if (body !== entry.rendered) return null
  const row = rows.get(entry.fact_id)
  if (entry.translates)
    return `<span data-translates="${escapeHtml(entry.translates)}">${projectMarkdownInline(body.replace(/^<!--[\s\S]*?-->\s*/u, ""))}</span>`
  if (!row) return `<data data-fact="${escapeHtml(entry.fact_id)}">${escapeHtml(body)}</data>`
  const quoted = row.kind === "quote" ? parseRenderedQuote(body) : null
  if (quoted) return renderQuote(row, entry.selector ?? "full", quoted.text, "html", entry.claimKind)
  return row.kind === "quote"
    ? null
    : renderValueHtml(row, body, { mode: entry.mode, claimKind: entry.claimKind ?? null })
}

/** [from, to) of the filled text as HTML, each intact fill-map entry rebuilt as its fill element. */
function spanHtml(text, from, to, entries, rows, stale) {
  let html = ""
  let cursor = from
  for (const entry of entries) {
    if (entry.start < cursor || entry.end > to || entry.start < from || entry.replaced !== undefined) continue
    const element = entryHtml(text, entry, rows)
    if (element === null) continue
    stale.delete(entry)
    html += projectMarkdownInline(text.slice(cursor, entry.start)) + element
    cursor = entry.end
  }
  return html + projectMarkdownInline(text.slice(cursor, to))
}

/**
 * An escaped HTML projection of a filled Markdown edition: one element per md-lite block, each on
 * the source line it starts on, lists and table rows grouped. Never a rendering for readers.
 * @param {string} text the filled Markdown
 * @param {{ fact_id: string, start: number, end: number, rendered: string, replaced?: string, translates?: string }[]} entries its fill map
 * @param {{ rows: object[] }} ledger
 * @returns {{ html: string, stale: object[] }} stale: entries whose bytes changed after fill (checked by text)
 */
export function markdownAsHtml(text, entries, ledger) {
  const sorted = [...(entries ?? [])].sort((a, b) => a.start - b.start)
  const rows = new Map((ledger?.rows ?? []).map((row) => [row.fact_id, row]))
  const stale = new Set(sorted.filter((entry) => entry.replaced === undefined))
  const lineAt = (offset) => text.slice(0, offset).split("\n").length
  const parsed = parseMarkdown(text)
  if (parsed.problems.length > 0) {
    throw new CliError(
      `the Markdown edition is malformed: ${parsed.problems.map((problem) => `${problem.code} at line ${problem.line}`).join(", ")}; fix it before verifying`,
    )
  }
  let html = "<!doctype html><html><head><title>md</title></head><body>"
  let line = 1
  let open = null
  for (const block of parsed.blocks) {
    const rule = MD_HTML_BLOCK_RULES[block.kind]
    if (rule === undefined) throw new CliError(`md-lite block kind ${block.kind} has no projection rule`)
    if (open && open !== block.kind) html += MD_HTML_BLOCK_RULES[open].group[1]
    const target = lineAt(block.start)
    if (target > line) html += "\n".repeat(target - line)
    line = Math.max(line, target) + (text.slice(block.start, block.end).match(/\n/gu)?.length ?? 0)
    if (rule.group && open !== block.kind) html += rule.group[0]
    open = rule.group ? block.kind : null
    const inner = (from, to) => spanHtml(text, from, to, sorted, rows, stale)
    if (block.kind === "table_row")
      html += `<${rule.tag}>${block.cells.map((cell) => `<td>${inner(cell.start, cell.end)}</td>`).join("")}</${rule.tag}>`
    else if (block.kind === "code") html += `<pre><${rule.tag}>${escapeHtml(block.text)}</${rule.tag}></pre>`
    else {
      const tag = rule.tag ?? `h${block.level}`
      const replaced =
        block.kind === "blockquote"
          ? sorted.find((entry) => entry.replaced !== undefined && entry.start <= block.start && entry.end >= block.end)
          : undefined
      const attrs = replaced
        ? ` data-fact="${escapeHtml(replaced.fact_id)}" data-replaced="${escapeHtml(replaced.replaced)}"`
        : ""
      html += `<${tag}${attrs}>${inner(block.start, block.end)}</${tag}>`
    }
  }
  return { html: `${html}${open ? MD_HTML_BLOCK_RULES[open].group[1] : ""}</body></html>\n`, stale: [...stale] }
}

/** The session dir from --session-dir or SESSION_DIR, or null; a bare flag names no session. */
export const sessionOf = (flags) => {
  const dir = flags["session-dir"] ?? process.env.SESSION_DIR
  return dir && dir !== true ? resolve(dir) : null
}

/** The ledger from --ledger (validated) or from the session dir; every fact command loads it here. */
export function ledgerFrom(flags, session = sessionOf(flags)) {
  if (flags.ledger === undefined) {
    if (session === null) throw new CliError("--ledger is required without --session-dir (or SESSION_DIR)")
    return readLedger(session)
  }
  const ledger = readJsonFile(flags.ledger)
  const errors = validateLedger(ledger)
  if (errors.length > 0) throw new CliError(`${flags.ledger} is not a valid fact ledger: ${errors[0]}`)
  return ledger
}

const MARKDOWN_EXTENSION = /\.(md|markdown)$/iu
/** The edition format: the explicit flag, else md for a .md or .markdown path (any case), else html. */
export const editionFormatOf = (path, flag) => flag ?? (MARKDOWN_EXTENSION.test(path) ? "md" : "html")

/**
 * An edition's fill map path: --fill-map, else whichever of fact fill's `<report>.fill-map.json` and
 * polish-apply's `<report>.polished.fill-map.json` records these bytes as its artifact_sha256, else the
 * first of them that exists; null when neither exists.
 */
export function fillMapOf(report, text, flag) {
  if (flag !== undefined) return flag
  const found = [`${report}.fill-map.json`, `${report}.polished.fill-map.json`].filter((path) => existsSync(path))
  return found.find((path) => readJsonFile(path).artifact_sha256 === sha256Of(text)) ?? found[0] ?? null
}

/** The report's format (from --format or its extension) and, for Markdown, its fill map entries. */
export function readEdition(report, flags) {
  const format = editionFormatOf(report, flags.format)
  if (format !== "html" && format !== "md")
    throw new CliError(
      `--format ${format}: verify html or md (a LaTeX edition is verified through its Markdown source)`,
    )
  const text = readText(report)
  if (format === "html")
    return { format, text, entries: flags["fill-map"] === undefined ? null : readJsonFile(flags["fill-map"]).entries }
  const map = flags["fill-map"] ?? `${report}.fill-map.json`
  if (!existsSync(map)) throw new CliError(`a Markdown edition needs its fill map: ${map} is missing (pass --fill-map)`)
  return { format, text, entries: readJsonFile(map).entries }
}

/** @param {{ positionals: string[], flags: Record<string, any> }} args parsed by runFact */
export function runFactVerify(args) {
  const [report] = args.positionals
  const { flags } = args
  if (!report)
    throw new CliError(
      "usage: fact verify <report> [--format html|md] [--sources D] [--claims claims.json] [--fill-map F] [--brief brief.md] [--out fidelity-defects.json]",
    )
  const sessionDir = sessionDirOf(flags)
  const { parsed, refusal } = lockedBrief("fact verify", flags)
  if (refusal) return refusal
  const policy = fillPolicy(parsed)
  const edition = readEdition(report, flags)
  const claimsPath = flags.claims ?? join(sessionDir, "claims.json")
  const briefPath = flags.brief ?? join(sessionDir, "brief.md")
  const ledger = readLedger(sessionDir)
  const projected = edition.format === "md" ? markdownAsHtml(edition.text, edition.entries, ledger) : null
  // The entries whose element is in the checked HTML: an HTML edition's own map, or the projection's intact entries.
  const ownMap = flags["fill-map"] ?? `${report}.fill-map.json`
  const fillEntries = projected
    ? edition.entries.filter((entry) => !projected.stale.includes(entry))
    : existsSync(ownMap)
      ? readJsonFile(ownMap).entries
      : null
  const result = checkFidelity(projected?.html ?? edition.text, {
    ledger,
    sourcesDir: resolve(flags.sources ?? join(sessionDir, "sources")),
    claims: flags.claims !== undefined || existsSync(claimsPath) ? readJsonFile(claimsPath) : null,
    fillMap: projected?.stale ?? edition.entries,
    fillEntries,
    brief: existsSync(briefPath) ? readText(briefPath) : "",
    baseDir: dirname(resolve(report)),
    recompute,
  })
  const checked = projected?.html ?? edition.text
  const pointers = [...checked.matchAll(/\bdata-fact="([^"]+)"/gu)].map((match) => ({
    token: match[0],
    start: match.index,
    parsed: { id: match[1] },
  }))
  const mapPath = fillMapOf(report, edition.text, flags["fill-map"])
  const bound = briefBindingErrors(
    mapPath === null ? null : readJsonFile(mapPath),
    mapPath ?? `${report}.fill-map.json`,
    parsed,
  )
  const defects = [...bound, ...policyErrors(checked, pointers, ledger, sessionDir, policy).errors, ...result.defects]
  const counts = countDefects(defects)
  const status = defects.some(blocksDelivery) ? "fail" : "pass"
  const exitCode = status === "fail" ? 1 : 0
  const out = resolve(flags.out ?? join(sessionDir, FIDELITY_RECORD))
  const record = writeFidelityRecord(out, "fidelity", {
    command: "fact verify",
    status,
    exitCode,
    format: edition.format,
    report: resolve(report),
    artifact_sha256: sha256Of(edition.text),
    defects,
    counts,
    gatesRun: result.gatesRun,
  })
  return {
    json: { ...record, out },
    summary: `fact verify: ${status.toUpperCase()} - ${counts.blocker} blocker, ${counts.major} major, ${counts.minor} minor`,
    exitCode,
  }
}
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