@mfittko/repo-wiki 0.2.1

package/dist/src/wiki-patch.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Structured wiki patch parsing and lint-gated acceptance.
+ *
+ * LLM output is treated as untrusted and must be parsed, validated, and
+ * accepted only after lint gates pass. Free-form markdown cannot bypass
+ * patch validation; invalid patches produce actionable errors and do not
+ * overwrite existing wiki pages.
+ *
+ * Typical usage:
+ *
+ *   // Parse and validate (throws WikiPatchError on error-level failures):
+ *   const patch = parseWikiPatch(llmOutput, 'Module-Auth');
+ *
+ *   // Inspect issues without throwing:
+ *   const issues = validateWikiPatch(llmOutput, 'Module-Auth');
+ *
+ *   // Full synthesis pipeline with retry:
+ *   const patch = await synthesizeWikiPage(provider, request, { maxRetries: 2 });
+ */
+import type { LLMProvider, LLMRequest } from './llm-provider.js';
+/** A single lint issue found during patch validation. */
+export interface WikiPatchIssue {
+    /** Severity of the issue. Error-level issues block acceptance; warnings are informational. */
+    level: 'error' | 'warning';
+    /** Machine-readable issue code. */
+    code: string;
+    /** Human-readable description of the problem. */
+    message: string;
+}
+/** Required and optional frontmatter fields recognized in wiki patches. */
+export interface WikiPatchFrontmatter {
+    /** Git commit SHA that was current when this page was compiled. */
+    source_commit: string;
+    /** Page archetype identifier (e.g. "module", "home", "architecture"). */
+    kind: string;
+    /** Repository source paths cited by this page. */
+    source_paths: string[];
+    /** ISO-8601 timestamp of compilation. */
+    compiled_at: string;
+    /** Page ownership state emitted by the compiler. */
+    page_state?: string;
+    /** Remote URL or shorthand of the source repository. */
+    source_repo?: string;
+    /** Additional frontmatter fields passed through from the LLM. */
+    [key: string]: unknown;
+}
+/**
+ * Structured representation of a validated LLM-generated wiki page.
+ *
+ * A `WikiPatch` is produced only when all error-level lint gates pass. It
+ * carries the parsed frontmatter, the markdown body, and the full normalized
+ * content so that callers can apply human-notes preservation and write the
+ * final page without re-parsing.
+ */
+export interface WikiPatch {
+    /** Wiki page slug/filename without `.md` (e.g. `"Module-Auth"`). */
+    pageName: string;
+    /** Full, normalized markdown content (frontmatter + body). */
+    content: string;
+    /** Parsed frontmatter fields extracted from the content. */
+    frontmatter: WikiPatchFrontmatter;
+    /** Markdown body — everything after the closing `---` of the frontmatter. */
+    body: string;
+}
+/**
+ * Thrown by `parseWikiPatch` when one or more error-level lint gates fail.
+ *
+ * The `issues` array contains all problems found (both errors and warnings),
+ * giving callers enough information to log actionable diagnostics or feed
+ * failure details back to the LLM on retry.
+ *
+ * Example:
+ *   try {
+ *     const patch = parseWikiPatch(llmOutput, 'Module-Auth');
+ *   } catch (err) {
+ *     if (err instanceof WikiPatchError) {
+ *       for (const issue of err.issues) console.error(issue.message);
+ *     }
+ *   }
+ */
+export declare class WikiPatchError extends Error {
+    /** Wiki page slug this error pertains to. */
+    readonly pageName: string;
+    /** Full list of validation issues (errors and warnings). */
+    readonly issues: WikiPatchIssue[];
+    constructor(message: string, pageName: string, issues: WikiPatchIssue[]);
+}
+/** Options for the synthesis pipeline (`synthesizeWikiPage`). */
+export interface SynthesizeOptions {
+    /**
+     * Maximum number of additional synthesis attempts when the first response
+     * fails validation. Defaults to 0 (no retries).
+     */
+    maxRetries?: number;
+}
+/**
+ * Validate raw LLM-generated content as a structured wiki patch.
+ *
+ * Returns the full list of issues found (errors and warnings). This is the
+ * non-throwing variant; call `parseWikiPatch` to get a validated `WikiPatch`
+ * or a thrown `WikiPatchError`.
+ *
+ * Lint gates applied (error-level):
+ *   1. `empty-content`       – LLM returned empty or whitespace-only content.
+ *   2. `missing-frontmatter` – Content does not begin with a `---` YAML block.
+ *   3. `missing-source-commit` – Frontmatter lacks a `source_commit` field.
+ *   4. `missing-kind`        – Frontmatter lacks a `kind` field.
+ *   5. `missing-compiled-at` – Frontmatter lacks a `compiled_at` field.
+ *   6. `empty-body`          – No markdown content after the frontmatter block.
+ *   7. `secret-like-content` – Content matches a known credential pattern.
+ *   8. `invalid-source-paths` – `source_paths` contains non-string or blank entries.
+ *
+ * Lint gates applied (warning-level):
+ *   9. `missing-source-paths` – Frontmatter lacks a `source_paths` array.
+ */
+export declare function validateWikiPatch(rawContent: string, pageName: string): WikiPatchIssue[];
+/**
+ * Parse and validate LLM-generated content as a structured wiki patch.
+ *
+ * Throws `WikiPatchError` if any error-level lint gate fails. Callers should
+ * catch this error to log actionable diagnostics, optionally feed failure
+ * details back into the next LLM request, or skip the page.
+ *
+ * Warnings are attached to the thrown error's `issues` array (when it throws)
+ * or are silently surfaced (when the patch is valid). If callers need to
+ * inspect warnings on a successful parse, use `validateWikiPatch` instead.
+ *
+ * @param rawContent - Raw LLM output string to validate.
+ * @param pageName   - Wiki page slug (e.g. `"Module-Auth"`) used in messages.
+ * @returns A validated `WikiPatch` ready for human-notes injection and writing.
+ * @throws {WikiPatchError} When one or more error-level issues are found.
+ */
+export declare function parseWikiPatch(rawContent: string, pageName: string): WikiPatch;
+/**
+ * Call an LLM provider and return the response as a validated `WikiPatch`.
+ *
+ * Validation runs after every provider response. If a response fails
+ * validation and `maxRetries > 0`, the provider is called again. The last
+ * thrown `WikiPatchError` is re-thrown when all attempts are exhausted.
+ *
+ * This makes it impossible for free-form LLM output to bypass patch
+ * validation and overwrite wiki pages.
+ *
+ * @param provider - LLM provider (mock or hosted).
+ * @param request  - Pre-built `LLMRequest` (use `buildRequest` to assemble).
+ * @param options  - Optional `{ maxRetries }` (default 0).
+ * @returns A validated `WikiPatch`.
+ * @throws {WikiPatchError} When all synthesis attempts produce invalid patches.
+ * @throws {LLMProviderError} On unrecoverable provider failures.
+ * @throws {RangeError} When `maxRetries` is not a non-negative finite number.
+ */
+export declare function synthesizeWikiPage(provider: LLMProvider, request: LLMRequest, options?: SynthesizeOptions): Promise<WikiPatch>;

package/dist/src/wiki-patch.js

@@ -0,0 +1,489 @@
+/**
+ * Structured wiki patch parsing and lint-gated acceptance.
+ *
+ * LLM output is treated as untrusted and must be parsed, validated, and
+ * accepted only after lint gates pass. Free-form markdown cannot bypass
+ * patch validation; invalid patches produce actionable errors and do not
+ * overwrite existing wiki pages.
+ *
+ * Typical usage:
+ *
+ *   // Parse and validate (throws WikiPatchError on error-level failures):
+ *   const patch = parseWikiPatch(llmOutput, 'Module-Auth');
+ *
+ *   // Inspect issues without throwing:
+ *   const issues = validateWikiPatch(llmOutput, 'Module-Auth');
+ *
+ *   // Full synthesis pipeline with retry:
+ *   const patch = await synthesizeWikiPage(provider, request, { maxRetries: 2 });
+ */
+import { containsSecretLikeContent } from './secret-patterns.js';
+// ── Structured error ───────────────────────────────────────────────────────
+/**
+ * Thrown by `parseWikiPatch` when one or more error-level lint gates fail.
+ *
+ * The `issues` array contains all problems found (both errors and warnings),
+ * giving callers enough information to log actionable diagnostics or feed
+ * failure details back to the LLM on retry.
+ *
+ * Example:
+ *   try {
+ *     const patch = parseWikiPatch(llmOutput, 'Module-Auth');
+ *   } catch (err) {
+ *     if (err instanceof WikiPatchError) {
+ *       for (const issue of err.issues) console.error(issue.message);
+ *     }
+ *   }
+ */
+export class WikiPatchError extends Error {
+    /** Wiki page slug this error pertains to. */
+    pageName;
+    /** Full list of validation issues (errors and warnings). */
+    issues;
+    constructor(message, pageName, issues) {
+        super(message);
+        this.name = 'WikiPatchError';
+        this.pageName = pageName;
+        this.issues = issues;
+    }
+}
+// ── Frontmatter parsing ────────────────────────────────────────────────────
+/**
+ * Split a markdown document into its frontmatter block and body.
+ *
+ * Returns `{ frontmatterRaw: null, body: content }` when the document does
+ * not begin with a valid `---`-delimited YAML block.
+ */
+function stripSurroundingMarkdownFence(content) {
+    const normalized = content.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n');
+    const trimmed = normalized.trim();
+    const fence = /^```[A-Za-z0-9_-]*[ \t]*\n([\s\S]*?)\n?```[ \t]*$/.exec(trimmed);
+    if (!fence) {
+        return normalized;
+    }
+    const inner = fence[1].replace(/^\uFEFF/, '').replace(/\r\n/g, '\n');
+    return inner.startsWith('---\n') ? inner : normalized;
+}
+function normalizeLLMOutput(content) {
+    return stripSurroundingMarkdownFence(content).replace(/^\uFEFF/, '').replace(/\r\n/g, '\n');
+}
+function splitFrontmatterAndBody(content) {
+    const normalized = normalizeLLMOutput(content);
+    const opening = normalized.match(/^---[ \t]*\n/);
+    if (!opening) {
+        return { frontmatterRaw: null, body: normalized };
+    }
+    const closingPattern = /^---[ \t]*$/gm;
+    closingPattern.lastIndex = opening[0].length;
+    const closing = closingPattern.exec(normalized);
+    if (!closing) {
+        return { frontmatterRaw: null, body: normalized };
+    }
+    const frontmatterRaw = normalized.slice(opening[0].length, closing.index);
+    // Strip the single newline that separates frontmatter from the body.
+    const body = normalized.slice(closing.index + closing[0].length).replace(/^\n/, '');
+    return { frontmatterRaw, body };
+}
+/**
+ * Parse a raw YAML frontmatter string into a key→value record.
+ *
+ * Handles the frontmatter subset repo-wiki emits and asks LLMs to return:
+ * top-level `key: value` pairs, JSON-quoted or bare scalar values, JSON-style
+ * inline arrays, and indented block sequences. It intentionally does not try
+ * to be a general YAML parser.
+ */
+function parseFrontmatterFields(raw) {
+    const fields = {};
+    const lines = raw.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1) {
+            i++;
+            continue;
+        }
+        const key = line.slice(0, colonIdx).trim();
+        if (!key || key.startsWith('#')) {
+            i++;
+            continue;
+        }
+        const rawValue = line.slice(colonIdx + 1).trim();
+        if (rawValue === '[]') {
+            // Inline empty array
+            fields[key] = [];
+            i++;
+            continue;
+        }
+        if (rawValue === '') {
+            // Possible block sequence: collect lines that start with "  -"
+            const items = [];
+            i++;
+            while (i < lines.length && /^\s+-/.test(lines[i])) {
+                const item = lines[i].replace(/^\s*-\s*/, '').trim();
+                items.push(parseScalar(item));
+                i++;
+            }
+            fields[key] = items;
+            continue;
+        }
+        // Inline array: `key: ["a", "b"]`
+        if (rawValue.startsWith('[') && rawValue.endsWith(']')) {
+            try {
+                const parsed = JSON.parse(rawValue);
+                if (Array.isArray(parsed)) {
+                    fields[key] = parsed;
+                    i++;
+                    continue;
+                }
+            }
+            catch {
+                // Fall through to scalar parsing
+            }
+        }
+        fields[key] = parseScalar(rawValue);
+        i++;
+    }
+    return fields;
+}
+/**
+ * Parse a scalar YAML or JSON value into its native type.
+ *
+ * Handles JSON-quoted strings, booleans, null, numbers, and bare YAML strings.
+ */
+function parseScalar(value) {
+    if (!value)
+        return '';
+    // Try JSON.parse for quoted strings, numbers, booleans, null
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed === 'string' || typeof parsed === 'number' || typeof parsed === 'boolean' || parsed === null)
+            return parsed;
+    }
+    catch {
+        // Fall through
+    }
+    return value;
+}
+// ── Validation ─────────────────────────────────────────────────────────────
+/**
+ * Validate raw LLM-generated content as a structured wiki patch.
+ *
+ * Returns the full list of issues found (errors and warnings). This is the
+ * non-throwing variant; call `parseWikiPatch` to get a validated `WikiPatch`
+ * or a thrown `WikiPatchError`.
+ *
+ * Lint gates applied (error-level):
+ *   1. `empty-content`       – LLM returned empty or whitespace-only content.
+ *   2. `missing-frontmatter` – Content does not begin with a `---` YAML block.
+ *   3. `missing-source-commit` – Frontmatter lacks a `source_commit` field.
+ *   4. `missing-kind`        – Frontmatter lacks a `kind` field.
+ *   5. `missing-compiled-at` – Frontmatter lacks a `compiled_at` field.
+ *   6. `empty-body`          – No markdown content after the frontmatter block.
+ *   7. `secret-like-content` – Content matches a known credential pattern.
+ *   8. `invalid-source-paths` – `source_paths` contains non-string or blank entries.
+ *
+ * Lint gates applied (warning-level):
+ *   9. `missing-source-paths` – Frontmatter lacks a `source_paths` array.
+ */
+export function validateWikiPatch(rawContent, pageName) {
+    const issues = [];
+    // 1. Non-empty content
+    if (!rawContent || !rawContent.trim()) {
+        issues.push({
+            level: 'error',
+            code: 'empty-content',
+            message: `${pageName}: LLM returned empty content.`,
+        });
+        return issues; // Further checks are meaningless without content
+    }
+    // 2. Valid frontmatter block
+    const normalizedContent = normalizeLLMOutput(rawContent);
+    const { frontmatterRaw, body } = splitFrontmatterAndBody(normalizedContent);
+    if (frontmatterRaw === null) {
+        issues.push({
+            level: 'error',
+            code: 'missing-frontmatter',
+            message: `${pageName}: content does not start with a valid YAML frontmatter block (---).`,
+        });
+    }
+    else {
+        const fields = parseFrontmatterFields(frontmatterRaw);
+        // 3. Required field: source_commit
+        const sourceCommit = fields['source_commit'];
+        if (!sourceCommit || typeof sourceCommit !== 'string' || !sourceCommit.trim()) {
+            issues.push({
+                level: 'error',
+                code: 'missing-source-commit',
+                message: `${pageName}: frontmatter is missing required field "source_commit".`,
+            });
+        }
+        // 4. Required field: kind
+        const kind = fields['kind'];
+        if (!kind || typeof kind !== 'string' || !kind.trim()) {
+            issues.push({
+                level: 'error',
+                code: 'missing-kind',
+                message: `${pageName}: frontmatter is missing required field "kind".`,
+            });
+        }
+        // 5. Required field: compiled_at
+        const compiledAt = fields['compiled_at'];
+        if (!compiledAt || typeof compiledAt !== 'string' || !compiledAt.trim()) {
+            issues.push({
+                level: 'error',
+                code: 'missing-compiled-at',
+                message: `${pageName}: frontmatter is missing required field "compiled_at".`,
+            });
+        }
+        // 6. Body must not be empty
+        if (!body || !body.trim()) {
+            issues.push({
+                level: 'error',
+                code: 'empty-body',
+                message: `${pageName}: patch contains a frontmatter block but no markdown body.`,
+            });
+        }
+        // 8/9. source_paths must be an array when present; a missing array is a warning.
+        const sourcePaths = fields['source_paths'];
+        if (sourcePaths === undefined) {
+            issues.push({
+                level: 'warning',
+                code: 'missing-source-paths',
+                message: `${pageName}: frontmatter is missing a "source_paths" array.`,
+            });
+        }
+        else if (!Array.isArray(sourcePaths)) {
+            issues.push({
+                level: 'error',
+                code: 'invalid-source-paths',
+                message: `${pageName}: frontmatter field "source_paths" must be an array when present.`,
+            });
+        }
+        else if (!sourcePaths.every(isNonEmptyString)) {
+            issues.push({
+                level: 'error',
+                code: 'invalid-source-paths',
+                message: `${pageName}: frontmatter field "source_paths" must contain only non-empty strings.`,
+            });
+        }
+    }
+    // 7. Secret-like content check (run over the full content)
+    if (containsSecretLikeContent(normalizedContent)) {
+        issues.push({
+            level: 'error',
+            code: 'secret-like-content',
+            message: `${pageName}: content contains secret-like content that cannot be accepted.`,
+        });
+    }
+    return issues;
+}
+/**
+ * Parse and validate LLM-generated content as a structured wiki patch.
+ *
+ * Throws `WikiPatchError` if any error-level lint gate fails. Callers should
+ * catch this error to log actionable diagnostics, optionally feed failure
+ * details back into the next LLM request, or skip the page.
+ *
+ * Warnings are attached to the thrown error's `issues` array (when it throws)
+ * or are silently surfaced (when the patch is valid). If callers need to
+ * inspect warnings on a successful parse, use `validateWikiPatch` instead.
+ *
+ * @param rawContent - Raw LLM output string to validate.
+ * @param pageName   - Wiki page slug (e.g. `"Module-Auth"`) used in messages.
+ * @returns A validated `WikiPatch` ready for human-notes injection and writing.
+ * @throws {WikiPatchError} When one or more error-level issues are found.
+ */
+export function parseWikiPatch(rawContent, pageName) {
+    const issues = validateWikiPatch(rawContent, pageName);
+    const errorCount = issues.filter((i) => i.level === 'error').length;
+    if (errorCount > 0) {
+        throw new WikiPatchError(`Wiki patch for "${pageName}" failed validation with ${errorCount} error(s).`, pageName, issues);
+    }
+    const normalized = normalizeLLMOutput(rawContent);
+    const { frontmatterRaw, body } = splitFrontmatterAndBody(normalized);
+    // frontmatterRaw is guaranteed non-null here (missing-frontmatter would have been an error)
+    const fields = parseFrontmatterFields(frontmatterRaw);
+    const frontmatter = {
+        source_commit: String(fields['source_commit'] ?? ''),
+        kind: String(fields['kind'] ?? ''),
+        source_paths: Array.isArray(fields['source_paths'])
+            ? fields['source_paths'].filter(isNonEmptyString)
+            : [],
+        compiled_at: String(fields['compiled_at'] ?? ''),
+        ...Object.fromEntries(Object.entries(fields).filter(([k]) => !['source_commit', 'kind', 'source_paths', 'compiled_at'].includes(k))),
+    };
+    return { pageName, content: normalized, frontmatter, body };
+}
+// ── Synthesis pipeline ─────────────────────────────────────────────────────
+/**
+ * Call an LLM provider and return the response as a validated `WikiPatch`.
+ *
+ * Validation runs after every provider response. If a response fails
+ * validation and `maxRetries > 0`, the provider is called again. The last
+ * thrown `WikiPatchError` is re-thrown when all attempts are exhausted.
+ *
+ * This makes it impossible for free-form LLM output to bypass patch
+ * validation and overwrite wiki pages.
+ *
+ * @param provider - LLM provider (mock or hosted).
+ * @param request  - Pre-built `LLMRequest` (use `buildRequest` to assemble).
+ * @param options  - Optional `{ maxRetries }` (default 0).
+ * @returns A validated `WikiPatch`.
+ * @throws {WikiPatchError} When all synthesis attempts produce invalid patches.
+ * @throws {LLMProviderError} On unrecoverable provider failures.
+ * @throws {RangeError} When `maxRetries` is not a non-negative finite number.
+ */
+export async function synthesizeWikiPage(provider, request, options = {}) {
+    const maxRetries = normalizeMaxRetries(options.maxRetries);
+    let lastError;
+    let nextRequest = request;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const response = await provider.complete(nextRequest);
+        try {
+            validateWikiPatchForRequest(response.content, request);
+            return parseWikiPatch(response.content, request.pageName);
+        }
+        catch (err) {
+            if (!(err instanceof WikiPatchError))
+                throw err;
+            lastError = err;
+            if (attempt < maxRetries) {
+                nextRequest = withValidationFeedback(request, err);
+            }
+        }
+    }
+    // All attempts exhausted — re-throw the last validation error
+    throw lastError;
+}
+function validateWikiPatchForRequest(rawContent, request) {
+    const issues = validateWikiPatch(rawContent, request.pageName);
+    if (request.archetype === 'architecture') {
+        issues.push(...validateArchitecturePatch(rawContent, request));
+    }
+    const errorCount = issues.filter((i) => i.level === 'error').length;
+    if (errorCount > 0) {
+        throw new WikiPatchError(`Wiki patch for "${request.pageName}" failed validation with ${errorCount} error(s).`, request.pageName, issues);
+    }
+}
+const ARCHITECTURE_REQUIRED_HEADINGS = [
+    '## Executive Architecture Summary',
+    '## System and Repository Context',
+    '## Major Modules and Responsibilities',
+    '## Runtime, Data, and Control-Flow Relationships',
+    '## Build, Test, Deployment, and Operational Surfaces',
+    '## Cross-Cutting Concerns',
+    '## Caveats and Open Questions',
+];
+function validateArchitecturePatch(rawContent, request) {
+    const issues = [];
+    const normalizedContent = normalizeLLMOutput(rawContent);
+    const { frontmatterRaw, body } = splitFrontmatterAndBody(normalizedContent);
+    if (frontmatterRaw === null) {
+        return issues;
+    }
+    const fields = parseFrontmatterFields(frontmatterRaw);
+    if (fields['kind'] !== 'architecture') {
+        issues.push({
+            level: 'error',
+            code: 'invalid-architecture-kind',
+            message: `${request.pageName}: Architecture page frontmatter must set kind: "architecture".`,
+        });
+    }
+    for (const field of ['confidence', 'claim_status']) {
+        const value = fields[field];
+        if (!value || typeof value !== 'string' || !value.trim()) {
+            issues.push({
+                level: 'error',
+                code: `missing-${field.replace('_', '-')}`,
+                message: `${request.pageName}: Architecture page frontmatter is missing required field "${field}".`,
+            });
+        }
+    }
+    const sourcePaths = fields['source_paths'];
+    if (sourcePaths === undefined) {
+        issues.push({
+            level: 'error',
+            code: 'missing-source-paths',
+            message: `${request.pageName}: Architecture page frontmatter is missing required field "source_paths".`,
+        });
+    }
+    else if (Array.isArray(sourcePaths)) {
+        if (sourcePaths.length === 0) {
+            issues.push({
+                level: 'error',
+                code: 'empty-source-paths',
+                message: `${request.pageName}: Architecture page source_paths must not be empty.`,
+            });
+        }
+        const allowedSourcePaths = new Set((request.sourcePaths || []).filter(isNonEmptyString));
+        const outOfContextPaths = sourcePaths.filter((entry) => isNonEmptyString(entry) && !allowedSourcePaths.has(entry));
+        if (outOfContextPaths.length > 0) {
+            issues.push({
+                level: 'error',
+                code: 'out-of-context-source-paths',
+                message: `${request.pageName}: Architecture page source_paths must be drawn from the prompt source cards: ${outOfContextPaths.join(', ')}.`,
+            });
+        }
+    }
+    for (const heading of ARCHITECTURE_REQUIRED_HEADINGS) {
+        if (!body.includes(heading)) {
+            issues.push({
+                level: 'error',
+                code: 'missing-architecture-heading',
+                message: `${request.pageName}: Architecture page is missing required heading "${heading}".`,
+            });
+        }
+    }
+    const humanNotesBlock = /<!-- HUMAN_NOTES_START -->([\s\S]*?)<!-- HUMAN_NOTES_END -->/.exec(body);
+    if (!humanNotesBlock) {
+        issues.push({
+            level: 'error',
+            code: 'missing-human-notes-block',
+            message: `${request.pageName}: Architecture page must include a HUMAN_NOTES block.`,
+        });
+    }
+    else if (humanNotesBlock[1].trim().length > 0) {
+        issues.push({
+            level: 'error',
+            code: 'non-empty-human-notes-block',
+            message: `${request.pageName}: Architecture page HUMAN_NOTES block must remain empty in synthesized output.`,
+        });
+    }
+    return issues;
+}
+function withValidationFeedback(request, error) {
+    return {
+        ...request,
+        userPrompt: `${request.userPrompt}\n\n${formatValidationFeedback(error)}`,
+    };
+}
+function formatValidationFeedback(error) {
+    const issueLines = error.issues
+        .map((issue) => `- ${issue.level} ${issue.code}: ${issue.message}`)
+        .join('\n');
+    return [
+        'Previous response was rejected by repo-wiki structured patch validation.',
+        'Validation issues:',
+        issueLines || '- error unknown: Validation failed.',
+        '',
+        'Retry output contract:',
+        '- Output only raw markdown for the page.',
+        '- The first line must be exactly `---`.',
+        '- Do not include any preamble, commentary, or fenced code block wrapper.',
+        '- Include required YAML frontmatter: source_repo, source_commit, compiled_at, kind, page_state, and source_paths.',
+        '- source_paths must be a non-empty array of repository source paths grounded in the prompt context.',
+    ].join('\n');
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function normalizeMaxRetries(maxRetries) {
+    if (maxRetries === undefined)
+        return 0;
+    if (!Number.isFinite(maxRetries) || maxRetries < 0) {
+        throw new RangeError('maxRetries must be a non-negative finite number.');
+    }
+    return Math.floor(maxRetries);
+}
+//# sourceMappingURL=wiki-patch.js.map

package/dist/src/wiki-patch.js.map

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