@de-otio/bibcheck 0.1.0

package/dist/markdown/prose.js

@@ -0,0 +1,81 @@
+/**
+ * Shared helper: extract prose lines from markdown content.
+ *
+ * Parses the content via remark/unified to an mdast AST and walks the tree,
+ * skipping nodes whose content should not be treated as prose (code blocks,
+ * inline code, raw HTML, YAML/TOML front-matter). Returns one ProseLine per
+ * source line that contains prose, sorted and deduplicated by line number.
+ *
+ * YAML/TOML front-matter is stripped before AST parsing because remark-parse
+ * alone does not emit yaml/toml AST nodes — the remark-frontmatter plugin is
+ * required for that. Instead, we detect the standard --- / +++ delimiters
+ * manually and record which lines to exclude from the result.
+ */
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+const SKIP_TYPES = new Set(['code', 'inlineCode', 'html', 'yaml', 'toml']);
+/** Returns the set of 1-based line numbers occupied by YAML/TOML front-matter. */
+function frontMatterLines(sourceLines) {
+    const excluded = new Set();
+    if (sourceLines.length === 0)
+        return excluded;
+    const first = sourceLines[0] ?? '';
+    const delimiter = first === '---' ? '---' : first === '+++' ? '+++' : null;
+    if (delimiter === null)
+        return excluded;
+    // Mark line 1 (the opening delimiter)
+    excluded.add(1);
+    for (let i = 1; i < sourceLines.length; i++) {
+        // Lines inside and including the closing delimiter are excluded (1-based)
+        excluded.add(i + 1);
+        if (sourceLines[i] === delimiter) {
+            break;
+        }
+    }
+    return excluded;
+}
+function collectLines(node, sourceLines, seen, excluded, result) {
+    if (SKIP_TYPES.has(node.type)) {
+        return;
+    }
+    const pos = node.position;
+    if (pos !== undefined && pos !== null) {
+        const start = pos.start.line;
+        const end = pos.end.line;
+        const isParent = 'children' in node && Array.isArray(node.children);
+        if (!isParent) {
+            for (let ln = start; ln <= end; ln++) {
+                if (!seen.has(ln) && !excluded.has(ln)) {
+                    seen.add(ln);
+                    const text = sourceLines[ln - 1] ?? '';
+                    result.push({ line: ln, text });
+                }
+            }
+        }
+        else {
+            for (const child of node.children) {
+                collectLines(child, sourceLines, seen, excluded, result);
+            }
+        }
+    }
+}
+export function extractProseLines(content) {
+    const sourceLines = content.split('\n');
+    const excluded = frontMatterLines(sourceLines);
+    // Strip front-matter before parsing so that remark doesn't misinterpret it.
+    // We replace excluded lines with blank lines to preserve line numbers.
+    let parseContent = content;
+    if (excluded.size > 0) {
+        const stripped = sourceLines.map((line, idx) => excluded.has(idx + 1) ? '' : line);
+        parseContent = stripped.join('\n');
+    }
+    const tree = unified().use(remarkParse).parse(parseContent);
+    const seen = new Set();
+    const result = [];
+    for (const child of tree.children) {
+        collectLines(child, sourceLines, seen, excluded, result);
+    }
+    result.sort((a, b) => a.line - b.line);
+    return result;
+}
+//# sourceMappingURL=prose.js.map

package/dist/markdown/prose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.js","sourceRoot":"","sources":["../../src/markdown/prose.ts"],"names":[],"mappings":"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"}

package/dist/output/json.d.ts

@@ -0,0 +1,21 @@
+/**
+ * JSON renderer for bibcheck output.
+ *
+ * Round-trip property: the JSON produced by renderJson is guaranteed to
+ * validate against OutputSchema. Callers can safely parse the output back
+ * through OutputSchema.parse(JSON.parse(text)) and obtain an identical
+ * validated object.
+ */
+import type { Output } from '../schema/output.js';
+/**
+ * Render a validated Output as a JSON string.
+ *
+ * @param output - A validated Output object.
+ * @param opts.pretty - When true (default), produce 2-space-indented JSON.
+ *   When false, produce minified JSON.
+ * @returns The JSON string, always terminated with a trailing newline.
+ */
+export declare function renderJson(output: Output, opts?: {
+    pretty?: boolean;
+}): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAK9E"}

package/dist/output/json.js

@@ -0,0 +1,24 @@
+/**
+ * JSON renderer for bibcheck output.
+ *
+ * Round-trip property: the JSON produced by renderJson is guaranteed to
+ * validate against OutputSchema. Callers can safely parse the output back
+ * through OutputSchema.parse(JSON.parse(text)) and obtain an identical
+ * validated object.
+ */
+import { OutputSchema } from '../schema/output.js';
+/**
+ * Render a validated Output as a JSON string.
+ *
+ * @param output - A validated Output object.
+ * @param opts.pretty - When true (default), produce 2-space-indented JSON.
+ *   When false, produce minified JSON.
+ * @returns The JSON string, always terminated with a trailing newline.
+ */
+export function renderJson(output, opts) {
+    // Validate first so the caller gets a clear error if they pass an invalid object.
+    const validated = OutputSchema.parse(output);
+    const pretty = opts?.pretty !== false; // default true
+    return JSON.stringify(validated, null, pretty ? 2 : 0) + '\n';
+}
+//# sourceMappingURL=json.js.map

package/dist/output/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,IAA2B;IACpE,kFAAkF;IAClF,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,eAAe;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAChE,CAAC"}

package/dist/output/markdown.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Markdown renderer for bibcheck output.
+ *
+ * Produces a sectioned human-readable report with tables for entry-level
+ * findings and lists for linkage failures, phrase flags, and worklist items.
+ * All sections are always present; empty sections show "No findings." rather
+ * than being omitted, so the document structure is stable across runs.
+ */
+import type { Output } from '../schema/output.js';
+/**
+ * Render a validated Output as a Markdown string.
+ *
+ * The document always contains all sections, even when empty, so its structure
+ * is stable and predictable for downstream consumers. Sections with no findings
+ * show "No findings." rather than being omitted.
+ *
+ * Lists are sorted deterministically (alpha by citekey or file:line) so two
+ * renders of the same input produce byte-identical output.
+ */
+export declare function renderMarkdown(output: Output): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/output/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/output/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiD,MAAM,qBAAqB,CAAC;AAyLjG;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/dist/output/markdown.js

@@ -0,0 +1,194 @@
+/**
+ * Markdown renderer for bibcheck output.
+ *
+ * Produces a sectioned human-readable report with tables for entry-level
+ * findings and lists for linkage failures, phrase flags, and worklist items.
+ * All sections are always present; empty sections show "No findings." rather
+ * than being omitted, so the document structure is stable across runs.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Escape pipe characters so they don't break Markdown table cells. */
+function escCell(s) {
+    return s.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+/** Format a file:line pair as a Markdown link for IDE/GitHub clickability. */
+function fileLink(file, line) {
+    return `[${file}:${line}](${file}#L${line})`;
+}
+// ---------------------------------------------------------------------------
+// Section builders
+// ---------------------------------------------------------------------------
+function renderSummaryTable(output) {
+    const { summary, tool } = output;
+    const lines = [
+        '## Summary',
+        '',
+        `**Schema version:** ${output.schemaVersion}`,
+        `**Tool:** ${tool.name}@${tool.version}`,
+        '',
+        '| Metric | Count |',
+        '|--------|-------|',
+        `| Total entries | ${summary.totalEntries} |`,
+        `| Verified | ${summary.verified} |`,
+        `| Metadata mismatches | ${summary.metadataMismatches} |`,
+        `| Not found in databases | ${summary.notFoundInDatabases} |`,
+        `| Malformed identifiers | ${summary.malformedIdentifiers} |`,
+        `| Unverifiable | ${summary.unverifiable} |`,
+        `| Canonical issues | ${summary.canonicalIssues} |`,
+        `| Linkage failures | ${summary.linkageFailures} |`,
+        `| Orphaned entries (informational) | ${summary.orphanedEntries ?? 0} |`,
+        `| Phrase flags | ${summary.phraseFlags} |`,
+        `| Worklist items | ${summary.worklistItems} |`,
+        '',
+    ];
+    return lines.join('\n');
+}
+function renderEntriesTable(entries) {
+    const lines = ['## Bibliography entries', ''];
+    if (entries.length === 0) {
+        lines.push('No findings.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    // Sort alphabetically by citekey.
+    const sorted = [...entries].sort((a, b) => a.citekey.localeCompare(b.citekey));
+    lines.push('| Citekey | Existence status | Evidence | Canonical status | Canonical URL |');
+    lines.push('|---------|-----------------|----------|-----------------|---------------|');
+    for (const entry of sorted) {
+        const existStatus = entry.existence?.status ?? 'not run';
+        const evidence = entry.existence?.evidence ?? '—';
+        const canonStatus = entry.canonical?.status ?? 'not run';
+        const canonUrl = entry.canonical?.url != null ? `[link](${entry.canonical.url})` : '—';
+        lines.push(`| ${escCell(entry.citekey)} | ${escCell(existStatus)} | ${escCell(evidence)} | ${escCell(canonStatus)} | ${canonUrl} |`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderLinkageSection(linkage) {
+    const lines = ['## Linkage', ''];
+    const unresolved = [...linkage]
+        .filter((l) => l.status === 'unresolved')
+        .sort((a, b) => a.citekey.localeCompare(b.citekey));
+    if (unresolved.length === 0) {
+        lines.push('No findings.');
+    }
+    else {
+        for (const entry of unresolved) {
+            lines.push(`- **@${entry.citekey}** — referenced in:`);
+            const sortedRefs = [...entry.references].sort((a, b) => {
+                const fc = a.file.localeCompare(b.file);
+                return fc !== 0 ? fc : a.line - b.line;
+            });
+            for (const ref of sortedRefs) {
+                lines.push(`  - ${fileLink(ref.file, ref.line)}`);
+            }
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Orphaned bibliography entries (reverse linkage, H2): bibliography citekeys
+ * never referenced in any doc. Informational — a smell, not a failure — so the
+ * section is always present but plainly labelled non-gating.
+ */
+function renderOrphansSection(linkage) {
+    const lines = ['## Orphaned entries (informational)', ''];
+    const orphans = [...linkage]
+        .filter((l) => l.status === 'orphan')
+        .sort((a, b) => a.citekey.localeCompare(b.citekey));
+    if (orphans.length === 0) {
+        lines.push('No findings.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    lines.push('These bibliography entries are never cited in any document. This is ' +
+        'informational only and does not affect the exit code.');
+    lines.push('');
+    for (const entry of orphans) {
+        lines.push(`- **@${entry.citekey}**`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderPhraseFlagsSection(phraseFlags) {
+    const lines = ['## Phrase flags', ''];
+    const flagged = [...phraseFlags]
+        .filter((f) => f.status === 'flagged')
+        .sort((a, b) => {
+        const fc = a.file.localeCompare(b.file);
+        if (fc !== 0)
+            return fc;
+        if (a.line !== b.line)
+            return a.line - b.line;
+        return a.patternKey.localeCompare(b.patternKey);
+    });
+    if (flagged.length === 0) {
+        lines.push('No findings.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    for (const flag of flagged) {
+        const loc = fileLink(flag.file, flag.line);
+        lines.push(`- \`${flag.patternKey}\` in ${loc}: "${escCell(flag.matchedText)}"`);
+        if (flag.referenceUrl != null) {
+            lines.push(`  - Reference: <${flag.referenceUrl}>`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderWorklistSection(worklist) {
+    const lines = ['## Worklist', ''];
+    if (worklist.length === 0) {
+        lines.push('No findings.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    const sorted = [...worklist].sort((a, b) => {
+        const fc = a.file.localeCompare(b.file);
+        if (fc !== 0)
+            return fc;
+        if (a.line !== b.line)
+            return a.line - b.line;
+        return a.type.localeCompare(b.type);
+    });
+    for (const item of sorted) {
+        const loc = fileLink(item.file, item.line);
+        const verif = item.verificationUrl != null ? `<${item.verificationUrl}>` : 'manual';
+        lines.push(`- [${item.type}] ${loc} — ${escCell(item.recommendedAction)}`);
+        lines.push(`  - Citation: \`${item.citation}\``);
+        lines.push(`  - Verification: ${verif}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Render a validated Output as a Markdown string.
+ *
+ * The document always contains all sections, even when empty, so its structure
+ * is stable and predictable for downstream consumers. Sections with no findings
+ * show "No findings." rather than being omitted.
+ *
+ * Lists are sorted deterministically (alpha by citekey or file:line) so two
+ * renders of the same input produce byte-identical output.
+ */
+export function renderMarkdown(output) {
+    const sections = [
+        '# bibcheck report',
+        '',
+        renderSummaryTable(output),
+        renderEntriesTable(output.entries),
+        renderLinkageSection(output.linkage),
+        renderOrphansSection(output.linkage),
+        renderPhraseFlagsSection(output.phraseFlags),
+        renderWorklistSection(output.worklist),
+    ];
+    return sections.join('\n');
+}
+//# sourceMappingURL=markdown.js.map

package/dist/output/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/output/markdown.ts"],"names":[],"mappings":"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"}

package/dist/output/sarif.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SARIF v2.1.0 renderer for bibcheck output.
+ *
+ * Uses node-sarif-builder for the structural boilerplate (tool/driver, rules,
+ * results) and then post-processes the resulting object to add:
+ *   - originalUriBaseIds so that relative artifact URIs resolve correctly
+ *   - partialFingerprints (sha256-based, stable across runs) for deduplication
+ *
+ * The library does not expose a first-class API for those two fields, so they
+ * are injected directly onto the mutable run/result objects that the builders
+ * expose as public properties (`.run` and `.result`). This is the documented
+ * escape hatch in node-sarif-builder.
+ *
+ * Worklist items are NOT emitted as SARIF results. They are informational and
+ * would cause spurious CI failures if surfaced as findings.
+ */
+import type { Output } from '../schema/output.js';
+/**
+ * Render a validated Output as a SARIF v2.1.0 JSON string.
+ *
+ * The SARIF document contains one run with:
+ * - tool.driver with all applicable rules defined
+ * - originalUriBaseIds.PROJECTROOT so relative file URIs resolve correctly
+ * - one result per finding (existence mismatches, canonical errors, linkage
+ *   unresolved, phrase flags), with partialFingerprints for deduplication
+ *
+ * Worklist items are not emitted as SARIF results (they are informational).
+ * Acknowledged phrase flags are not emitted (only status: 'flagged' entries).
+ */
+export declare function renderSarif(output: Output): string;
+//# sourceMappingURL=sarif.d.ts.map

package/dist/output/sarif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/output/sarif.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAwSlD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiDlD"}