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/md-lite.mjs
View on GitHub// md-lite.mjs - a light Markdown block model for md/post deliverables.
//
// parseMarkdown(text) returns { blocks } in document order, each block one of heading,
// paragraph, list_item, table_row, code, blockquote, with start/end offsets into the raw text
// so text.slice(start, end) === block.text (table cells carry their own offsets). Headings carry
// level 1-6. Code blocks are fenced (``` or ~~~); an unterminated fence runs to the end of the
// text and is reported in problems as unterminated_fence, which a caller must refuse rather than
// skip. Callers skip kind 'code' when they look for numbers. sectionKindsMd(blocks) classifies
// sections with the gates-static classifier itself (sectionKind, closingTest). It never renders
// HTML. Plain Node ESM, sibling imports only.
import { closingTest, sectionKind } from "./gates-static.mjs"
export { closingTest, sectionKind }
/** A fence opener: a backtick fence's info string holds no backtick (else it is an inline span). */
const FENCE = /^ {0,3}(?:(`{3,})[^`]*|(~{3,}).*)$/
const HEADING = /^ {0,3}(#{1,6})(?=[ \t]|$)/
const BLOCKQUOTE = /^ {0,3}> ?/
/** A bullet or an ordered marker (digits, then . or ), then a space); group 1 is the number. */
const LIST_ITEM = /^[ \t]*(?:[-*+]|(\d{1,9})[.)])[ \t]+/
const TABLE_SEPARATOR = /^[ \t]*\|?[ \t]*:?-+:?[ \t]*(?:\|[ \t]*:?-+:?[ \t]*)*\|?[ \t]*$/
const CLOSING_HASHES = /[ \t]+#+[ \t]*$|^#+[ \t]*$/
const THEMATIC_BREAK = /^ {0,3}([-*_])(?:[ \t]*\1){2,}[ \t]*$/
/** The Markdown block grammar, one named pattern per syntax. */
export const MD_BLOCK_PATTERNS = Object.freeze({
FENCE,
HEADING,
BLOCKQUOTE,
LIST_ITEM,
TABLE_SEPARATOR,
CLOSING_HASHES,
THEMATIC_BREAK,
})
/** Split into lines with offsets; end excludes the newline and a trailing carriage return. */
function linesOf(text) {
const lines = []
let start = 0
while (start <= text.length) {
const newline = text.indexOf("\n", start)
const next = newline === -1 ? text.length + 1 : newline + 1
let end = newline === -1 ? text.length : newline
if (end > start && text[end - 1] === "\r") end--
lines.push({ start, end, next, raw: text.slice(start, end) })
start = next
}
return lines
}
/** Narrow [start, end) to its non-whitespace core. */
function trimRange(text, start, end) {
let from = start
let to = end
while (from < to && /\s/.test(text[from])) from++
while (to > from && /\s/.test(text[to - 1])) to--
return { start: from, end: to }
}
function block(text, kind, range, extra = {}) {
return { kind, ...extra, text: text.slice(range.start, range.end), start: range.start, end: range.end }
}
function isSeparator(line) {
return line !== undefined && line.raw.includes("-") && TABLE_SEPARATOR.test(line.raw)
}
/** Cells split on unescaped pipes, outer pipes dropped, each cell trimmed with offsets. */
function tableCells(text, range) {
const bounds = []
for (let k = range.start; k < range.end; k++) {
let slashes = 0
while (k - slashes - 1 >= range.start && text[k - slashes - 1] === "\\") slashes++
if (text[k] === "|" && slashes % 2 === 0) bounds.push(k)
}
const edges = [range.start - 1, ...bounds, range.end]
if (bounds[0] === range.start) edges.shift()
if (bounds.at(-1) === range.end - 1 && bounds.length > 0) edges.pop()
const cells = []
for (let k = 0; k + 1 < edges.length; k++) {
const cell = trimRange(text, edges[k] + 1, edges[k + 1])
cells.push({ text: text.slice(cell.start, cell.end), start: cell.start, end: cell.end })
}
return cells
}
function headingBlock(text, line, marker) {
const after = line.start + line.raw.indexOf(marker) + marker.length
const range = trimRange(text, after, line.end)
const closing = text.slice(range.start, range.end).match(CLOSING_HASHES)
if (closing) range.end = trimRange(text, range.start, range.start + (closing.index ?? 0)).end
return block(text, "heading", range, { level: marker.length })
}
/**
* Parse Markdown into a flat block list.
* @param {string} text
* @returns {{ blocks: { kind: string, level?: number, text: string, start: number, end: number,
* cells?: { text: string, start: number, end: number }[] }[],
* problems: { code: "unterminated_fence", line: number, start: number }[] }}
*/
export function parseMarkdown(text) {
const source = String(text ?? "")
const lines = linesOf(source)
const blocks = []
const problems = []
let paragraph = null
let inTable = false
const flush = () => {
if (paragraph) blocks.push(block(source, "paragraph", paragraph))
paragraph = null
}
for (let i = 0; i < lines.length; i++) {
const line = lines[i]
const fence = line.raw.match(FENCE)
if (fence) {
flush()
inTable = false
const open = fence[1] ?? fence[2]
const codeStart = Math.min(line.next, source.length)
let close = lines.length
for (let k = i + 1; k < lines.length; k++) {
const candidate = lines[k].raw.replace(/^ {0,3}/, "").trimEnd()
if (candidate.startsWith(open[0].repeat(open.length)) && /^(`+|~+)$/.test(candidate)) {
close = k
break
}
}
let codeEnd = source.length
if (close === lines.length) problems.push({ code: "unterminated_fence", line: i + 1, start: line.start })
else {
codeEnd = Math.max(codeStart, lines[close].start - 1)
if (codeEnd > codeStart && source[codeEnd - 1] === "\r") codeEnd--
}
blocks.push(block(source, "code", { start: codeStart, end: codeEnd }))
i = close
continue
}
if (line.raw.trim() === "") {
flush()
inTable = false
continue
}
const range = trimRange(source, line.start, line.end)
if (!inTable && line.raw.includes("|") && isSeparator(lines[i + 1])) inTable = true
if (inTable && line.raw.includes("|")) {
flush()
if (!isSeparator(line)) blocks.push(block(source, "table_row", range, { cells: tableCells(source, range) }))
continue
}
inTable = false
const heading = line.raw.match(HEADING)
if (heading) {
flush()
blocks.push(headingBlock(source, line, heading[1]))
continue
}
if (THEMATIC_BREAK.test(line.raw)) {
flush()
continue
}
const marker = line.raw.match(BLOCKQUOTE) ?? line.raw.match(LIST_ITEM)
// Only an ordered marker numbered 1 may interrupt a paragraph (CommonMark); else it is text.
const continues = paragraph !== null && marker?.[1] !== undefined && Number(marker[1]) !== 1
if (marker && !continues) {
flush()
const kind = BLOCKQUOTE.test(line.raw) ? "blockquote" : "list_item"
const content = trimRange(source, line.start + marker[0].length, line.end)
if (content.end > content.start) blocks.push(block(source, kind, content))
continue
}
if (paragraph) paragraph.end = range.end
else paragraph = { start: range.start, end: range.end }
}
flush()
return { blocks, problems }
}
/**
* Section kind of every block, parallel to blocks: an h2 opens a section whose kind comes from
* its heading text (sources, closing, toc, appendix, glossary, or null for findings); an h3 that
* reads as a closing heading marks its blocks closing until the next h2 or h3, as in gates-static.
* @param {{ kind: string, level?: number, text: string }[]} blocks
* @param {{ closingPattern?: RegExp|string }} [options] extra closing heading pattern (the spec's)
* @returns {(string|null)[]}
*/
export function sectionKindsMd(blocks, options = {}) {
const isClosing = closingTest(options.closingPattern)
let section = null
let closingH3 = false
return blocks.map((entry) => {
if (entry.kind === "heading" && entry.level === 2) {
section = sectionKind(entry.text, isClosing)
closingH3 = false
} else if (entry.kind === "heading" && entry.level === 3) {
closingH3 = isClosing(entry.text)
}
return closingH3 ? "closing" : section
})
}
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 |