@softure-ai/blog 0.0.0-stage → 0.1.6

package/dist/proxy/index.js.map

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

package/dist/quality/blocks.d.ts

@@ -0,0 +1,21 @@
+export type BlockKind = "heading" | "paragraph" | "listItem" | "table" | "quote" | "footnote" | "directive";
+export interface Block {
+    readonly kind: BlockKind;
+    /** The text without the block marker (`#`, `-`, `>`, `[^id]:`); lines of a paragraph joined by spaces. */
+    text: string;
+    /** The line of the file, from 1. */
+    readonly line: number;
+    /** Heading level, 1–6. */
+    readonly level?: number;
+    /** Footnote id of a definition. */
+    readonly footnoteId?: string;
+}
+/** The body of an article file and the file line it starts on, or `null` without a frontmatter. */
+export declare function splitArticleBody(text: string): {
+    readonly body: string;
+    readonly bodyStartLine: number;
+} | null;
+export declare function splitBlocks(body: string, bodyStartLine?: number): Block[];
+/** The blocks a reader reads as text: no footnote definitions, no directives. */
+export declare function getProseBlocks(blocks: readonly Block[]): Block[];
+//# sourceMappingURL=blocks.d.ts.map

package/dist/quality/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/quality/blocks.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAE5G,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,0GAA0G;IAC1G,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM/G;AAaD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,SAAI,GAAG,KAAK,EAAE,CAmFpE;AAID,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAEhE"}

package/dist/quality/blocks.js

@@ -0,0 +1,113 @@
+// The body of an article cut into blocks with file lines (FIRE_TRACKER `src/lib/blog/quality/parse.ts`,
+// `splitBlocks`). Line-level rules need no Markdown tree: headings, paragraphs, list items, tables,
+// quotes, footnote definitions and `::` directives are enough. Fenced code and HTML comments are
+// skipped: the gate judges prose, not examples.
+/** The body of an article file and the file line it starts on, or `null` without a frontmatter. */
+export function splitArticleBody(text) {
+    const lines = text.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n").split("\n");
+    if (lines[0] !== "---")
+        return null;
+    const end = lines.indexOf("---", 1);
+    if (end === -1)
+        return null;
+    return { body: lines.slice(end + 1).join("\n"), bodyStartLine: end + 2 };
+}
+const HEADING = /^(#{1,6})\s+(.*)$/;
+const LIST_ITEM = /^\s*(?:[-*+]|\d+[.)])\s+(.*)$/;
+const FOOTNOTE_DEF = /^\[\^([^\]]+)\]:\s*(.*)$/;
+const FENCE = /^\s*(```|~~~)/;
+const CONTINUATION = /^\s{2,}\S/;
+export function splitBlocks(body, bodyStartLine = 1) {
+    const blocks = [];
+    let paragraph = null;
+    let table = null;
+    let inFence = false;
+    let inComment = false;
+    const flush = () => {
+        if (paragraph !== null)
+            blocks.push({ kind: "paragraph", text: paragraph.lines.join(" "), line: paragraph.line });
+        if (table !== null)
+            blocks.push({ kind: "table", text: table.lines.join("\n"), line: table.line });
+        paragraph = null;
+        table = null;
+    };
+    for (const [index, raw] of body.split("\n").entries()) {
+        const lineNo = bodyStartLine + index;
+        const line = raw.trimEnd();
+        const trimmed = line.trim();
+        if (FENCE.test(line)) {
+            flush();
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        if (inComment) {
+            if (line.includes("-->"))
+                inComment = false;
+            continue;
+        }
+        if (trimmed.startsWith("<!--")) {
+            flush();
+            inComment = !line.includes("-->");
+            continue;
+        }
+        if (trimmed === "") {
+            flush();
+            continue;
+        }
+        const heading = HEADING.exec(line);
+        if (heading !== null) {
+            flush();
+            blocks.push({ kind: "heading", text: (heading[2] ?? "").trim(), line: lineNo, level: (heading[1] ?? "#").length });
+            continue;
+        }
+        const footnote = FOOTNOTE_DEF.exec(line);
+        if (footnote !== null) {
+            flush();
+            blocks.push({ kind: "footnote", text: (footnote[2] ?? "").trim(), line: lineNo, footnoteId: footnote[1] ?? "" });
+            continue;
+        }
+        if (trimmed.startsWith("::")) {
+            flush();
+            blocks.push({ kind: "directive", text: trimmed, line: lineNo });
+            continue;
+        }
+        if (trimmed.startsWith("|")) {
+            if (paragraph !== null)
+                flush();
+            table ??= { lines: [], line: lineNo };
+            table.lines.push(trimmed);
+            continue;
+        }
+        const listItem = LIST_ITEM.exec(line);
+        if (listItem !== null) {
+            flush();
+            blocks.push({ kind: "listItem", text: (listItem[1] ?? "").trim(), line: lineNo });
+            continue;
+        }
+        if (trimmed.startsWith(">")) {
+            flush();
+            blocks.push({ kind: "quote", text: trimmed.replace(/^>\s?/, ""), line: lineNo });
+            continue;
+        }
+        // An indented line continues the list item or footnote above it.
+        const previous = blocks.at(-1);
+        if (paragraph === null && table === null && CONTINUATION.test(raw) && (previous?.kind === "listItem" || previous?.kind === "footnote")) {
+            previous.text = `${previous.text} ${trimmed}`;
+            continue;
+        }
+        if (table !== null)
+            flush();
+        paragraph ??= { lines: [], line: lineNo };
+        paragraph.lines.push(trimmed);
+    }
+    flush();
+    return blocks;
+}
+const PROSE_KINDS = new Set(["paragraph", "listItem", "table", "quote", "heading"]);
+/** The blocks a reader reads as text: no footnote definitions, no directives. */
+export function getProseBlocks(blocks) {
+    return blocks.filter((block) => PROSE_KINDS.has(block.kind));
+}
+//# sourceMappingURL=blocks.js.map

package/dist/quality/blocks.js.map

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

package/dist/quality/catalog.d.ts

@@ -0,0 +1,10 @@
+import type { QualityRuleInfo } from "./plugin.js";
+import { type QualitySettings } from "./settings.js";
+export declare const QUALITY_RULE_GROUPS: readonly ["file", "structure", "links", "images", "ymyl", "style", "voice", "plugin"];
+export type QualityRuleGroup = (typeof QUALITY_RULE_GROUPS)[number];
+export interface QualityCatalogRule extends QualityRuleInfo {
+    readonly group: QualityRuleGroup;
+}
+/** Every rule the gate can report with these settings, with the effective severity; rules switched off are left out. */
+export declare function listQualityRules(settings: QualitySettings): QualityCatalogRule[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/quality/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/quality/catalog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE3E,eAAO,MAAM,mBAAmB,uFAAwF,CAAC;AACzH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AAwDD,wHAAwH;AACxH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,kBAAkB,EAAE,CAgBhF"}

package/dist/quality/catalog.js

@@ -0,0 +1,71 @@
+import { getEffectiveSeverity } from "./settings.js";
+export const QUALITY_RULE_GROUPS = ["file", "structure", "links", "images", "ymyl", "style", "voice", "plugin"];
+const rule = (group, id, severity, description) => ({ group, id, severity, description });
+/** Rules that do not depend on the ruleset, the voice or plugins. */
+const CORE_RULES = [
+    rule("file", "file", "error", "the file parses: frontmatter keys and values, slug equal to the file name"),
+    rule("structure", "title-length", "warning", "the title fits in search results (limits.titleChars)"),
+    rule("structure", "description-length", "warning", "the description is between limits.descriptionChars.min and max characters"),
+    rule("structure", "as-of-future", "error", "current_as_of is not in the future"),
+    rule("structure", "stale", "warning", "current_as_of is not older than limits.staleAfterDays"),
+    rule("structure", "summary-missing", "error", "an article has a summary"),
+    rule("structure", "lead", "error", "the text opens with a paragraph that answers"),
+    rule("structure", "lead-length", "warning", "the first paragraph fits in limits.leadWords"),
+    rule("structure", "lead-number", "error", "an article has a concrete number in its first two paragraphs"),
+    rule("structure", "heading-h1", "error", "no # heading in the body"),
+    rule("structure", "heading-order", "error", "headings do not skip a level"),
+    rule("structure", "sections", "error", "an article has at least two ## sections"),
+    rule("structure", "section-question", "error", "at least one ## heading of an article is a question"),
+    rule("structure", "section-answer", "error", "a question heading is followed by a paragraph"),
+    rule("structure", "section-answer-length", "warning", "the answer under a question fits in limits.answerWords"),
+    rule("structure", "length", "error", "the word count is within limits.words (a warning above the maximum)"),
+    rule("structure", "footnote-undefined", "error", "every footnote reference has a definition"),
+    rule("structure", "footnote-unused", "warning", "every footnote definition is referenced"),
+    rule("links", "internal-links", "error", "at least limits.internalLinks internal links (a warning for a term)"),
+    rule("links", "internal-link-target", "error", "every internal link leads to a page, article or glossary term"),
+    rule("links", "external-link-https", "warning", "external links use https"),
+    rule("links", "external-link-dead", "error", "external links answer 2xx (only with --external)"),
+    rule("links", "term-form-conflict", "error", "a glossary form belongs to one published term (only in check; publish refuses it always)"),
+    rule("images", "image-source", "error", "an image comes from the site or a host of blog({ images: { hosts } })"),
+    rule("images", "image-alt", "error", "an image has alt text"),
+    rule("images", "image-dimensions", "error", "the app knows an image's width and height (blog({ images: { dimensions } }))"),
+    rule("style", "dashes", "error", "at most one dash per limits.wordsPerDash words"),
+    rule("style", "dashes-paragraph", "warning", "at most one dash per paragraph"),
+    rule("style", "bold-density", "warning", "at most one bold phrase per limits.wordsPerBold words"),
+    rule("style", "bold-labels", "warning", "fewer than three list items start with a bold label"),
+    rule("style", "triads", "warning", "at most three lists of three"),
+    rule("style", "long-sentences", "warning", "sentences fit in limits.sentenceWords"),
+    rule("style", "monotone-rhythm", "warning", "sentence lengths vary"),
+    rule("style", "repeated-openings", "warning", "no three sentences in a row start with the same word"),
+];
+const YMYL_RULES = [
+    rule("ymyl", "sources-missing", "error", "an article lists its sources"),
+    rule("ymyl", "source-https", "error", "every source address uses https"),
+    rule("ymyl", "number-source", "error", "every significant number (amount, percentage, 1000 or more) carries a footnote"),
+    rule("ymyl", "footnote-source", "error", "every footnote has a source address or the app's own calculation mark"),
+    rule("ymyl", "footnote-not-in-sources", "error", "every address in a footnote is a listed source"),
+    rule("ymyl", "profit-promise", "error", "no promise of profit and no order to buy"),
+];
+const PLUGIN_RULES = [
+    rule("plugin", "plugin-failed", "error", "a rule plugin ran without throwing"),
+    rule("plugin", "plugin-rule-undeclared", "error", "a rule plugin reports only the rules it declares"),
+];
+/** Every rule the gate can report with these settings, with the effective severity; rules switched off are left out. */
+export function listQualityRules(settings) {
+    const { ruleset, options } = settings;
+    const rules = [
+        ...CORE_RULES,
+        ...(ruleset.flagsTitleCaseHeadings ? [rule("style", "title-case-heading", "warning", "headings use sentence case")] : []),
+        ...ruleset.patterns.map((pattern) => rule("style", pattern.id, pattern.severity, pattern.message)),
+        ...settings.voicePatterns.map((pattern) => rule("voice", pattern.id, pattern.severity, pattern.message)),
+        ...(options.ymyl === null ? [] : YMYL_RULES),
+        ...(options.blocks.length === 0 ? [] : [rule("structure", "block-requires", "error", "a block plugin's fenced block has the frontmatter keys it requires")]),
+        ...(options.plugins.length === 0 ? [] : PLUGIN_RULES),
+        ...options.plugins.flatMap((plugin) => plugin.rules.map((info) => rule("plugin", info.id, info.severity, info.description))),
+    ];
+    return rules.flatMap((entry) => {
+        const severity = getEffectiveSeverity(settings, entry.id, entry.severity);
+        return severity === null ? [] : [{ ...entry, severity }];
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/dist/quality/catalog.js.map

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

package/dist/quality/check-article.d.ts

@@ -0,0 +1,34 @@
+import type { BlogArticleInput } from "../contract.js";
+import { type ParseArticleFileOptions } from "../content/article-file.js";
+import { type QualityFinding } from "./finding.js";
+import { type InternalLinkResolver } from "./rules/links.js";
+import { type QualitySettings } from "./settings.js";
+export interface QualityCheckResult {
+    readonly findings: readonly QualityFinding[];
+    /** External addresses for the network check (`--external`). */
+    readonly externalLinks: readonly {
+        readonly url: string;
+        readonly line: number;
+    }[];
+}
+export interface CheckArticleInput {
+    /** The parsed file. */
+    readonly article: BlogArticleInput;
+    /** The whole file text, for the body's line numbers. */
+    readonly text: string;
+    readonly settings: QualitySettings;
+    /** `YYYY-MM-DD` in the app's time zone. */
+    readonly today: string;
+    /** Default: every internal link exists (the publish gate; `check` resolves them). */
+    readonly resolveInternalLink?: InternalLinkResolver;
+}
+export declare function checkArticle(input: CheckArticleInput): QualityCheckResult;
+export interface CheckArticleTextInput extends Omit<CheckArticleInput, "article"> {
+    /** A path or a bare name; it must read `<slug>.md`. */
+    readonly fileName: string;
+    /** The app's `fields` and reserved slugs, as the publish run applies them. */
+    readonly parse?: ParseArticleFileOptions;
+}
+/** Parses the file first; parse errors are `file` findings and stop the check. */
+export declare function checkArticleText(input: CheckArticleTextInput): QualityCheckResult;
+//# sourceMappingURL=check-article.d.ts.map

package/dist/quality/check-article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-article.d.ts","sourceRoot":"","sources":["../../src/quality/check-article.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE5F,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAKjE,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIvF,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpF;AAED,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;CACrD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA2BzE;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC;IAC/E,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC;CAC1C;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CAMjF"}

package/dist/quality/check-article.js

@@ -0,0 +1,74 @@
+import { findArticleImages } from "../render/images.js";
+import { findArticleBlocks } from "../render/render-article.js";
+import { parseArticleFile } from "../content/article-file.js";
+import { splitArticleBody, splitBlocks } from "./blocks.js";
+import { sortFindings } from "./finding.js";
+import { checkBlockRequires } from "./rules/blocks.js";
+import { checkImages } from "./rules/images.js";
+import { checkLinks, collectLinks } from "./rules/links.js";
+import { checkFootnotes, checkLead, checkLength, checkMetadata, checkSections } from "./rules/structure.js";
+import { checkMetadataStyle, checkRhythm, checkStyle } from "./rules/style.js";
+import { checkNumberSources, checkSources } from "./rules/ymyl.js";
+import { getEffectiveSeverity } from "./settings.js";
+export function checkArticle(input) {
+    const { article, settings, today } = input;
+    const split = splitArticleBody(input.text);
+    const blocks = split === null ? splitBlocks(article.bodyMarkdown) : splitBlocks(split.body, split.bodyStartLine);
+    const body = split?.body ?? article.bodyMarkdown;
+    const bodyStartLine = split?.bodyStartLine ?? 1;
+    const pluginBlocks = findPluginBlocks(body, bodyStartLine, settings);
+    const images = findArticleImages(body).map((image) => ({ ...image, line: image.line + bodyStartLine - 1 }));
+    const ruleInput = { article, blocks, settings, today };
+    const links = collectLinks(ruleInput);
+    const builtIn = [
+        ...checkMetadata(ruleInput),
+        ...checkMetadataStyle(ruleInput),
+        ...checkLead(ruleInput),
+        ...checkSections(ruleInput),
+        ...checkLength(ruleInput),
+        ...checkFootnotes(ruleInput),
+        ...(settings.options.ymyl === null ? [] : [...checkSources(ruleInput), ...checkNumberSources(ruleInput)]),
+        ...checkLinks(ruleInput, links, input.resolveInternalLink ?? (() => true)),
+        ...checkStyle(ruleInput),
+        ...checkRhythm(ruleInput),
+        ...checkBlockRequires(article, pluginBlocks),
+        ...checkImages(images, settings.images),
+    ];
+    const fromPlugins = settings.options.plugins.flatMap((plugin) => runPlugin(plugin, { article, blocks, pluginBlocks, today, ruleset: settings.ruleset }));
+    return { findings: applySeverity(settings, [...builtIn, ...fromPlugins]), externalLinks: links.external };
+}
+/** Parses the file first; parse errors are `file` findings and stop the check. */
+export function checkArticleText(input) {
+    const parsed = parseArticleFile(input.text, input.fileName, input.parse);
+    if (!parsed.ok) {
+        return { findings: applySeverity(input.settings, parsed.errors.map((message) => ({ rule: "file", severity: "error", message }))), externalLinks: [] };
+    }
+    return checkArticle({ ...input, article: parsed.article });
+}
+/** The app's plugin blocks with file lines; none without `quality.blocks`. */
+function findPluginBlocks(body, bodyStartLine, settings) {
+    if (settings.options.blocks.length === 0)
+        return [];
+    return findArticleBlocks(body, settings.options.blocks).map((block) => ({ ...block, line: block.line + bodyStartLine - 1 }));
+}
+function runPlugin(plugin, context) {
+    let findings;
+    try {
+        findings = plugin.check(context);
+    }
+    catch (error) {
+        // A plugin bug must not crash a publish with a stack trace; it refuses the file instead.
+        return [{ rule: "plugin-failed", severity: "error", message: `plugin ${plugin.name} failed: ${error instanceof Error ? error.message : String(error)}` }];
+    }
+    const declared = new Set(plugin.rules.map((info) => info.id));
+    return findings.map((finding) => declared.has(finding.rule)
+        ? finding
+        : { rule: "plugin-rule-undeclared", severity: "error", message: `plugin ${plugin.name} reported rule ${finding.rule}, which it does not declare`, ...(finding.line === undefined ? {} : { line: finding.line }) });
+}
+function applySeverity(settings, findings) {
+    return sortFindings(findings.flatMap((finding) => {
+        const severity = getEffectiveSeverity(settings, finding.rule, finding.severity);
+        return severity === null ? [] : [{ ...finding, severity }];
+    }));
+}
+//# sourceMappingURL=check-article.js.map

package/dist/quality/check-article.js.map

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

package/dist/quality/check-files.d.ts

@@ -0,0 +1,23 @@
+import type { ArticleFile } from "../db/publish-run.js";
+import { type ParseArticleFileOptions } from "../content/article-file.js";
+import { type GlossaryTerm } from "../render/glossary.js";
+import { type FetchLike } from "./external-links.js";
+import { type QualityFinding } from "./finding.js";
+import type { InternalLinkResolver } from "./rules/links.js";
+import { type QualitySettings } from "./settings.js";
+export interface CheckArticleFilesOptions {
+    readonly settings: QualitySettings;
+    readonly today: string;
+    readonly resolveInternalLink: InternalLinkResolver;
+    readonly parse?: ParseArticleFileOptions;
+    /** When given, external links are requested over the network. */
+    readonly fetch?: FetchLike;
+    /** The site's published terms (`readGlossaryTerms`); a checked term that shares a form with another is reported. */
+    readonly glossary?: readonly GlossaryTerm[];
+}
+export interface FileCheckResult {
+    readonly file: string;
+    readonly findings: readonly QualityFinding[];
+}
+export declare function checkArticleFiles(files: readonly ArticleFile[], options: CheckArticleFilesOptions): Promise<FileCheckResult[]>;
+//# sourceMappingURL=check-files.d.ts.map

package/dist/quality/check-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-files.d.ts","sourceRoot":"","sources":["../../src/quality/check-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAyB,KAAK,YAAY,EAAyB,MAAM,uBAAuB,CAAC;AAExG,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC;IACzC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,oHAAoH;IACpH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAiBpI"}

package/dist/quality/check-files.js

@@ -0,0 +1,44 @@
+import { parseArticleFile } from "../content/article-file.js";
+import { findTermFormConflicts } from "../render/glossary.js";
+import { checkArticleText } from "./check-article.js";
+import { checkExternalLinks } from "./external-links.js";
+import { sortFindings } from "./finding.js";
+import { getEffectiveSeverity } from "./settings.js";
+export async function checkArticleFiles(files, options) {
+    const results = [];
+    const conflicts = findTermFormConflicts(options.glossary ?? []);
+    for (const file of files) {
+        const result = checkArticleText({
+            text: file.text,
+            fileName: file.name,
+            settings: options.settings,
+            today: options.today,
+            resolveInternalLink: options.resolveInternalLink,
+            ...(options.parse === undefined ? {} : { parse: options.parse }),
+        });
+        const external = options.fetch === undefined ? [] : await checkExternalLinks(result.externalLinks, options.fetch);
+        const forms = checkTermForms(file, conflicts, options);
+        results.push({ file: file.name, findings: sortFindings([...result.findings, ...external, ...forms]) });
+    }
+    return results;
+}
+/** `term-form-conflict` for a published term file whose forms another term claims too. */
+function checkTermForms(file, conflicts, options) {
+    if (conflicts.length === 0)
+        return [];
+    const parsed = parseArticleFile(file.text, file.name, options.parse);
+    if (!parsed.ok || parsed.article.kind !== "term" || parsed.article.status !== "published")
+        return [];
+    const { slug } = parsed.article;
+    const severity = getEffectiveSeverity(options.settings, "term-form-conflict", "error");
+    if (severity === null)
+        return [];
+    return conflicts
+        .filter((conflict) => conflict.slugs.includes(slug))
+        .map((conflict) => ({
+        rule: "term-form-conflict",
+        severity,
+        message: `form "${conflict.form}" is also a form of term ${conflict.slugs.filter((other) => other !== slug).join(", ")}; a form belongs to one term, so remove it from all but one`,
+    }));
+}
+//# sourceMappingURL=check-files.js.map

package/dist/quality/check-files.js.map

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

package/dist/quality/external-links.d.ts

@@ -0,0 +1,19 @@
+import type { QualityFinding } from "./finding.js";
+export type FetchLike = (url: string, init: {
+    readonly method: string;
+    readonly redirect: "follow";
+    readonly signal: AbortSignal;
+    readonly headers: Record<string, string>;
+}) => Promise<{
+    readonly status: number;
+}>;
+export declare function checkExternalUrl(url: string, fetchImpl: FetchLike): Promise<{
+    ok: boolean;
+    detail: string;
+}>;
+/** Each address once, at its first line. */
+export declare function checkExternalLinks(links: readonly {
+    readonly url: string;
+    readonly line: number;
+}[], fetchImpl: FetchLike): Promise<QualityFinding[]>;
+//# sourceMappingURL=external-links.d.ts.map

package/dist/quality/external-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-links.d.ts","sourceRoot":"","sources":["../../src/quality/external-links.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KACnI,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAQ1C,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAUlH;AAED,4CAA4C;AAC5C,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAO3J"}

package/dist/quality/external-links.js

@@ -0,0 +1,30 @@
+/** Some public-sector servers refuse requests that do not introduce themselves. */
+const USER_AGENT = "softure-blog-link-check/1.0";
+/** Servers without HEAD support answer with these; then the check asks with GET. */
+const RETRY_WITH_GET = new Set([400, 403, 404, 405, 501]);
+const TIMEOUT_MS = 15_000;
+export async function checkExternalUrl(url, fetchImpl) {
+    const request = (method) => fetchImpl(url, { method, redirect: "follow", signal: AbortSignal.timeout(TIMEOUT_MS), headers: { "user-agent": USER_AGENT } });
+    try {
+        let response = await request("HEAD");
+        if (RETRY_WITH_GET.has(response.status))
+            response = await request("GET");
+        return { ok: response.status >= 200 && response.status < 300, detail: `HTTP ${String(response.status)}` };
+    }
+    catch (error) {
+        // A network failure is the finding itself: its message tells the editor what happened.
+        return { ok: false, detail: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** Each address once, at its first line. */
+export async function checkExternalLinks(links, fetchImpl) {
+    const unique = new Map();
+    for (const link of links)
+        if (!unique.has(link.url))
+            unique.set(link.url, link.line);
+    const results = await Promise.all([...unique].map(async ([url, line]) => ({ url, line, ...(await checkExternalUrl(url, fetchImpl)) })));
+    return results
+        .filter((result) => !result.ok)
+        .map((result) => ({ rule: "external-link-dead", severity: "error", message: `an external link does not answer 2xx (${result.detail}): ${result.url}`, line: result.line }));
+}
+//# sourceMappingURL=external-links.js.map

package/dist/quality/external-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-links.js","sourceRoot":"","sources":["../../src/quality/external-links.ts"],"names":[],"mappings":"AAUA,mFAAmF;AACnF,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,oFAAoF;AACpF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,SAAoB;IACtE,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IACnK,IAAI,CAAC;QACH,IAAI,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QACzE,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,QAAQ,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IAC5G,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uFAAuF;QACvF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAiE,EAAE,SAAoB;IAC9H,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxI,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,yCAAyC,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAChL,CAAC"}

package/dist/quality/finding.d.ts

@@ -0,0 +1,17 @@
+export declare const QUALITY_SEVERITIES: readonly ["error", "warning"];
+export type QualitySeverity = (typeof QUALITY_SEVERITIES)[number];
+export interface QualityFinding {
+    /** The stable id of the rule, used for severity overrides and by the writing skill. */
+    readonly rule: string;
+    readonly severity: QualitySeverity;
+    /** What is wrong and what to do instead, in English. */
+    readonly message: string;
+    /** The line of the file, from 1, when the rule points at one. */
+    readonly line?: number;
+}
+export declare function hasQualityErrors(findings: readonly QualityFinding[]): boolean;
+/** Errors first, then by line; findings without a line go first within their severity. */
+export declare function sortFindings(findings: readonly QualityFinding[]): QualityFinding[];
+/** `[rule] line N: message`, the form the publish command prints. */
+export declare function formatFinding(finding: QualityFinding): string;
+//# sourceMappingURL=finding.d.ts.map

package/dist/quality/finding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.d.ts","sourceRoot":"","sources":["../../src/quality/finding.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,+BAAgC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAE7E;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,CAElF;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE7D"}

package/dist/quality/finding.js

@@ -0,0 +1,15 @@
+// A finding of the quality gate (FIRE_TRACKER `src/lib/blog/quality/finding.ts`). An error refuses a
+// publish and fails `softure-blog check`; a warning only informs.
+export const QUALITY_SEVERITIES = ["error", "warning"];
+export function hasQualityErrors(findings) {
+    return findings.some((finding) => finding.severity === "error");
+}
+/** Errors first, then by line; findings without a line go first within their severity. */
+export function sortFindings(findings) {
+    return [...findings].sort((a, b) => (a.severity === b.severity ? (a.line ?? 0) - (b.line ?? 0) : a.severity === "error" ? -1 : 1));
+}
+/** `[rule] line N: message`, the form the publish command prints. */
+export function formatFinding(finding) {
+    return `[${finding.rule}]${finding.line === undefined ? "" : ` line ${String(finding.line)}`}: ${finding.message}`;
+}
+//# sourceMappingURL=finding.js.map

package/dist/quality/finding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.js","sourceRoot":"","sources":["../../src/quality/finding.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,kEAAkE;AAElE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,SAAS,CAAU,CAAC;AAahE,MAAM,UAAU,gBAAgB,CAAC,QAAmC;IAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AAClE,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,QAAmC;IAC9D,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrI,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;AACrH,CAAC"}

package/dist/quality/gate.d.ts

@@ -0,0 +1,5 @@
+import type { Clock } from "@softure-ai/core";
+import type { PublishGate } from "../db/publish-run.js";
+import { type QualitySettings } from "./settings.js";
+export declare function createQualityGate(settings: QualitySettings, clock: Clock): PublishGate;
+//# sourceMappingURL=gate.d.ts.map

package/dist/quality/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/quality/gate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAKtF"}

package/dist/quality/gate.js

@@ -0,0 +1,10 @@
+import { checkArticle } from "./check-article.js";
+import { formatFinding } from "./finding.js";
+import { getLocalDate } from "./settings.js";
+export function createQualityGate(settings, clock) {
+    return (file, article) => {
+        const { findings } = checkArticle({ article, text: file.text, settings, today: getLocalDate(clock.now(), settings.timeZone) });
+        return findings.filter((finding) => finding.severity === "error").map(formatFinding);
+    };
+}
+//# sourceMappingURL=gate.js.map

package/dist/quality/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/quality/gate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAwB,MAAM,eAAe,CAAC;AAEnE,MAAM,UAAU,iBAAiB,CAAC,QAAyB,EAAE,KAAY;IACvE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/H,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvF,CAAC,CAAC;AACJ,CAAC"}