@lumenflow/core 3.2.0 → 3.2.2

package/dist/validators/backlog-sync.d.ts

@@ -0,0 +1,11 @@
+export interface BacklogSyncResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    wuCount: number;
+    backlogCount: number;
+}
+export declare function validateBacklogSync(options?: {
+    cwd?: string;
+}): Promise<BacklogSyncResult>;
+//# sourceMappingURL=backlog-sync.d.ts.map

package/dist/validators/backlog-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-sync.d.ts","sourceRoot":"","sources":["../../src/validators/backlog-sync.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AA2BD,wBAAsB,mBAAmB,CACvC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAwC5B"}

package/dist/validators/backlog-sync.js

@@ -0,0 +1,65 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file backlog-sync.ts
+ * @description Validates backlog.md is in sync with WU YAML files (WU-1111)
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { FILE_SYSTEM } from '../wu-constants.js';
+import { createWuPaths } from '../wu-paths.js';
+function extractWUIDsFromBacklog(content) {
+    const wuIds = [];
+    const pattern = /WU-\d+/gi;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const wuId = match[0].toUpperCase();
+        if (!wuIds.includes(wuId)) {
+            wuIds.push(wuId);
+        }
+    }
+    return wuIds;
+}
+function getWUIDsFromFiles(wuDir) {
+    if (!existsSync(wuDir)) {
+        return [];
+    }
+    return readdirSync(wuDir)
+        .filter((f) => f.endsWith('.yaml'))
+        .map((f) => f.replace('.yaml', '').toUpperCase());
+}
+export async function validateBacklogSync(options = {}) {
+    const { cwd = process.cwd() } = options;
+    const errors = [];
+    const warnings = [];
+    const paths = createWuPaths({ projectRoot: cwd });
+    const backlogPath = path.join(cwd, paths.BACKLOG());
+    const wuDir = path.join(cwd, paths.WU_DIR());
+    if (!existsSync(backlogPath)) {
+        errors.push(`Backlog file not found: ${backlogPath}`);
+        return { valid: false, errors, warnings, wuCount: 0, backlogCount: 0 };
+    }
+    const wuIdsFromFiles = getWUIDsFromFiles(wuDir);
+    const backlogContent = readFileSync(backlogPath, {
+        encoding: FILE_SYSTEM.UTF8,
+    });
+    const wuIdsFromBacklog = extractWUIDsFromBacklog(backlogContent);
+    for (const wuId of wuIdsFromFiles) {
+        if (!wuIdsFromBacklog.includes(wuId)) {
+            errors.push(`${wuId} not found in backlog.md (exists as ${wuId}.yaml)`);
+        }
+    }
+    for (const wuId of wuIdsFromBacklog) {
+        if (!wuIdsFromFiles.includes(wuId)) {
+            warnings.push(`${wuId} referenced in backlog.md but ${wuId}.yaml not found`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        wuCount: wuIdsFromFiles.length,
+        backlogCount: wuIdsFromBacklog.length,
+    };
+}
+//# sourceMappingURL=backlog-sync.js.map

package/dist/validators/backlog-sync.js.map

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

package/dist/validators/claim-validation.d.ts

@@ -0,0 +1,46 @@
+declare const CLAIM_ALLOWLIST_ALL = "all";
+export declare const CLAIM_VALIDATION_IDS: {
+    readonly LEGACY_CONFIG_HARD_CUT: "legacy-config-hard-cut";
+    readonly RUNCLI_MAIN_REQUIRED: "runcli-main-required";
+    readonly CORE_NO_PROCESS_EXIT: "core-no-process-exit";
+};
+export type ClaimValidationId = (typeof CLAIM_VALIDATION_IDS)[keyof typeof CLAIM_VALIDATION_IDS];
+export interface ClaimValidationAllowlistEntry {
+    claimId: ClaimValidationId | typeof CLAIM_ALLOWLIST_ALL;
+    pathPattern: string;
+    reason?: string;
+    source?: string;
+}
+export interface ClaimValidationEvidence {
+    filePath: string;
+    line: number;
+    lineText: string;
+}
+export interface ClaimValidationSpecReference {
+    id: string;
+    filePath: string;
+    line: number;
+    section: 'acceptance' | 'success_metrics';
+}
+export interface ClaimValidationMismatch {
+    claimId: ClaimValidationId;
+    claimText: string;
+    specReference: ClaimValidationSpecReference;
+    evidence: ClaimValidationEvidence[];
+    remediationHint: string;
+}
+export interface ClaimValidationResult {
+    ok: boolean;
+    scannedClaims: number;
+    checkedClaims: number;
+    mismatches: ClaimValidationMismatch[];
+    warnings: string[];
+}
+export interface ClaimValidationOptions {
+    cwd?: string;
+    wuId?: string;
+    allowlist?: ClaimValidationAllowlistEntry[];
+}
+export declare function validateClaimValidation(options?: ClaimValidationOptions): Promise<ClaimValidationResult>;
+export {};
+//# sourceMappingURL=claim-validation.d.ts.map

package/dist/validators/claim-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-validation.d.ts","sourceRoot":"","sources":["../../src/validators/claim-validation.ts"],"names":[],"mappings":"AAkBA,QAAA,MAAM,mBAAmB,QAAQ,CAAC;AA8ClC,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEjG,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,iBAAiB,GAAG,OAAO,mBAAmB,CAAC;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,GAAG,iBAAiB,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AA8GD,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA0FhC"}

package/dist/validators/claim-validation.js

@@ -0,0 +1,491 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file claim-validation.ts
+ * @description Validates absolute claims in WU/initiative specs against live code.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { globSync } from 'glob';
+import micromatch from 'micromatch';
+import { WORKSPACE_CONFIG_FILE_NAME } from '../config-contract.js';
+import { parseYAML } from '../wu-yaml.js';
+import { createWuPaths } from '../wu-paths.js';
+import { DIRECTORIES, FILE_SYSTEM } from '../wu-constants.js';
+const CLAIM_NOTE_ALLOW_PREFIX = 'claim-validation:allow';
+const CLAIM_ALLOWLIST_ALL = 'all';
+const LINE_SPLIT_PATTERN = /\r?\n/;
+const CLAIM_LINE_PREFIX_WORDS = 8;
+const LEGACY_CONFIG_FILE_LITERAL = '.lumenflow.config.yaml';
+const LEGACY_CONFIG_CLAIM_PATTERN = /\.lumenflow\.config\.yaml/i;
+const RUNCLI_MAIN_CLAIM_PATTERN = /runcli\s*\(\s*main\s*\)/i;
+const PROCESS_EXIT_CLAIM_PATTERN = /process\.exit/i;
+const CORE_TEXT_PATTERN = /\bcore\b/i;
+const ABSOLUTE_NEGATION_PATTERN = /\b(no|zero|without|remove|removed|eliminate|eliminated|delete|deleted|gone)\b/i;
+const ABSOLUTE_UNIVERSAL_PATTERN = /\b(all|every)\b/i;
+const PROCESS_EXIT_USAGE_PATTERN = /\bprocess\.exit\s*\(/;
+const IMPORT_META_MAIN_PATTERN = /\bimport\.meta\.main\b/;
+const MAIN_CATCH_PATTERN = /main\(\)\.catch\s*\(/;
+const RUNCLI_MAIN_CALL = 'runCLI(main';
+const EXPORTED_MAIN_PATTERN = /export\s+async\s+function\s+main\s*\(|export\s+function\s+main\s*\(/;
+const YAML_EXTENSION = '.yaml';
+const SOURCE_GLOBS = {
+    LEGACY_CONFIG: [
+        `${DIRECTORIES.PACKAGES}**/src/**/*.{ts,tsx,js,mjs,cjs}`,
+        'actions/**/src/**/*.{ts,tsx,js,mjs,cjs}',
+        `${DIRECTORIES.TOOLS}**/*.{ts,js,mjs,cjs}`,
+    ],
+    CLI_ENTRYPOINTS: [`${DIRECTORIES.PACKAGES}**/cli/src/**/*.ts`],
+    CORE_RUNTIME: [`${DIRECTORIES.PACKAGES}**/core/src/**/*.{ts,js,mjs,cjs}`],
+};
+const SOURCE_GLOB_IGNORES = [
+    '**/__tests__/**',
+    '**/*.test.*',
+    '**/*.spec.*',
+    '**/dist/**',
+    '**/node_modules/**',
+];
+const CLAIM_VALIDATOR_SOURCE_GLOB = `${DIRECTORIES.PACKAGES}**/core/src/validators/claim-validation.ts`;
+const LEGACY_CONFIG_SCAN_IGNORES = [...SOURCE_GLOB_IGNORES, CLAIM_VALIDATOR_SOURCE_GLOB];
+const CORE_RUNTIME_IGNORES = [
+    ...SOURCE_GLOB_IGNORES,
+    `${DIRECTORIES.PACKAGES}**/core/src/cli/**`,
+];
+export const CLAIM_VALIDATION_IDS = {
+    LEGACY_CONFIG_HARD_CUT: 'legacy-config-hard-cut',
+    RUNCLI_MAIN_REQUIRED: 'runcli-main-required',
+    CORE_NO_PROCESS_EXIT: 'core-no-process-exit',
+};
+const CHECK_DEFINITIONS = [
+    {
+        id: CLAIM_VALIDATION_IDS.LEGACY_CONFIG_HARD_CUT,
+        isMatch: (claimText) => {
+            return (LEGACY_CONFIG_CLAIM_PATTERN.test(claimText) && ABSOLUTE_NEGATION_PATTERN.test(claimText));
+        },
+        runScan: (projectRoot) => {
+            return scanLinesForPattern({
+                projectRoot,
+                globs: SOURCE_GLOBS.LEGACY_CONFIG,
+                ignores: LEGACY_CONFIG_SCAN_IGNORES,
+                includeLine: (line) => {
+                    return line.includes(LEGACY_CONFIG_FILE_LITERAL) && !isCommentOnlyLine(line);
+                },
+            });
+        },
+        remediationHint: `Remove runtime usage of ${LEGACY_CONFIG_FILE_LITERAL} and keep ${WORKSPACE_CONFIG_FILE_NAME} as the only config contract.`,
+    },
+    {
+        id: CLAIM_VALIDATION_IDS.RUNCLI_MAIN_REQUIRED,
+        isMatch: (claimText) => {
+            return (RUNCLI_MAIN_CLAIM_PATTERN.test(claimText) && ABSOLUTE_UNIVERSAL_PATTERN.test(claimText));
+        },
+        runScan: (projectRoot) => {
+            const files = listSourceFiles(projectRoot, SOURCE_GLOBS.CLI_ENTRYPOINTS, SOURCE_GLOB_IGNORES);
+            const evidence = [];
+            for (const filePath of files) {
+                const content = readUtf8(filePath);
+                if (!content) {
+                    continue;
+                }
+                const hasExportedMain = EXPORTED_MAIN_PATTERN.test(content);
+                if (!hasExportedMain) {
+                    continue;
+                }
+                const hasImportMetaMain = IMPORT_META_MAIN_PATTERN.test(content);
+                const hasMainCatch = MAIN_CATCH_PATTERN.test(content);
+                const hasRunCLI = content.includes(RUNCLI_MAIN_CALL);
+                if ((hasImportMetaMain || hasMainCatch) && !hasRunCLI) {
+                    const lines = content.split(LINE_SPLIT_PATTERN);
+                    const lineNumber = findLineNumber(lines, (line) => line.includes('import.meta.main')) ??
+                        findLineNumber(lines, (line) => line.includes('main().catch(')) ??
+                        1;
+                    const lineText = lines[lineNumber - 1]?.trim() ?? '';
+                    evidence.push({
+                        filePath: toRelativePath(projectRoot, filePath),
+                        line: lineNumber,
+                        lineText,
+                    });
+                }
+            }
+            return evidence;
+        },
+        remediationHint: 'Wrap entrypoint execution with runCLI(main) and import runCLI from cli-entry-point.',
+    },
+    {
+        id: CLAIM_VALIDATION_IDS.CORE_NO_PROCESS_EXIT,
+        isMatch: (claimText) => {
+            return (PROCESS_EXIT_CLAIM_PATTERN.test(claimText) &&
+                CORE_TEXT_PATTERN.test(claimText) &&
+                ABSOLUTE_NEGATION_PATTERN.test(claimText));
+        },
+        runScan: (projectRoot) => {
+            return scanLinesForPattern({
+                projectRoot,
+                globs: SOURCE_GLOBS.CORE_RUNTIME,
+                ignores: CORE_RUNTIME_IGNORES,
+                includeLine: (line) => {
+                    return PROCESS_EXIT_USAGE_PATTERN.test(line) && !isCommentOnlyLine(line);
+                },
+            });
+        },
+        remediationHint: 'Replace process.exit() with typed errors in core modules and exit only at CLI boundaries.',
+    },
+];
+export async function validateClaimValidation(options = {}) {
+    const projectRoot = options.cwd ?? process.cwd();
+    const warnings = [];
+    const wuId = options.wuId?.trim();
+    if (!wuId) {
+        warnings.push('No WU ID provided; claim validation skipped.');
+        return {
+            ok: true,
+            scannedClaims: 0,
+            checkedClaims: 0,
+            mismatches: [],
+            warnings,
+        };
+    }
+    const wuSpec = loadWUSpec(projectRoot, wuId, warnings);
+    if (!wuSpec) {
+        return {
+            ok: true,
+            scannedClaims: 0,
+            checkedClaims: 0,
+            mismatches: [],
+            warnings,
+        };
+    }
+    const initiativeSpec = wuSpec.initiativeRef
+        ? loadInitiativeSpec(projectRoot, wuSpec.initiativeRef, warnings)
+        : null;
+    const claims = [...wuSpec.claims, ...(initiativeSpec?.claims ?? [])];
+    const allowlist = [
+        ...(options.allowlist ?? []),
+        ...wuSpec.allowlist,
+        ...(initiativeSpec?.allowlist ?? []),
+    ];
+    const checkClaims = claims.flatMap((claim) => {
+        return CHECK_DEFINITIONS.filter((check) => check.isMatch(claim.claimText)).map((check) => ({
+            claim,
+            check,
+        }));
+    });
+    if (checkClaims.length === 0) {
+        return {
+            ok: true,
+            scannedClaims: claims.length,
+            checkedClaims: 0,
+            mismatches: [],
+            warnings,
+        };
+    }
+    const evidenceByCheck = new Map();
+    for (const check of CHECK_DEFINITIONS) {
+        const shouldRun = checkClaims.some((entry) => entry.check.id === check.id);
+        if (!shouldRun) {
+            continue;
+        }
+        const rawEvidence = check.runScan(projectRoot);
+        const filteredEvidence = applyAllowlist(rawEvidence, allowlist, check.id);
+        evidenceByCheck.set(check.id, filteredEvidence);
+    }
+    const mismatches = [];
+    for (const { claim, check } of checkClaims) {
+        const evidence = evidenceByCheck.get(check.id) ?? [];
+        if (evidence.length === 0) {
+            continue;
+        }
+        mismatches.push({
+            claimId: check.id,
+            claimText: claim.claimText,
+            specReference: claim.specReference,
+            evidence,
+            remediationHint: check.remediationHint,
+        });
+    }
+    return {
+        ok: mismatches.length === 0,
+        scannedClaims: claims.length,
+        checkedClaims: checkClaims.length,
+        mismatches,
+        warnings,
+    };
+}
+function loadWUSpec(projectRoot, wuId, warnings) {
+    const wuPaths = createWuPaths({ projectRoot });
+    const wuPath = path.join(projectRoot, wuPaths.WU(wuId));
+    if (!existsSync(wuPath)) {
+        warnings.push(`WU spec not found for ${wuId}: ${wuPath}`);
+        return null;
+    }
+    const rawText = readUtf8(wuPath);
+    if (!rawText) {
+        warnings.push(`WU spec could not be read for ${wuId}: ${wuPath}`);
+        return null;
+    }
+    const doc = parseYAML(rawText);
+    if (!doc) {
+        warnings.push(`WU spec could not be parsed for ${wuId}: ${wuPath}`);
+        return null;
+    }
+    const claims = extractClaims({
+        specId: wuId,
+        filePath: wuPath,
+        section: 'acceptance',
+        values: asStringArray(doc.acceptance),
+        rawText,
+    });
+    const initiativeRef = asString(doc.initiative);
+    const allowlist = parseAllowlistNotes({
+        specId: wuId,
+        notes: asStringArray(doc.notes),
+    });
+    return {
+        claims,
+        initiativeRef: initiativeRef ?? null,
+        allowlist,
+    };
+}
+function loadInitiativeSpec(projectRoot, initiativeRef, warnings) {
+    const wuPaths = createWuPaths({ projectRoot });
+    const initiativesDir = path.join(projectRoot, wuPaths.INITIATIVES_DIR());
+    if (!existsSync(initiativesDir)) {
+        warnings.push(`Initiatives directory not found: ${initiativesDir}`);
+        return null;
+    }
+    const initiativePath = resolveInitiativePath(initiativesDir, initiativeRef);
+    if (!initiativePath) {
+        warnings.push(`Initiative spec not found for reference: ${initiativeRef}`);
+        return null;
+    }
+    const rawText = readUtf8(initiativePath);
+    if (!rawText) {
+        warnings.push(`Initiative spec could not be read: ${initiativePath}`);
+        return null;
+    }
+    const doc = parseYAML(rawText);
+    if (!doc) {
+        warnings.push(`Initiative spec could not be parsed: ${initiativePath}`);
+        return null;
+    }
+    const initiativeId = asString(doc.id) ?? initiativeRef;
+    const claims = extractClaims({
+        specId: initiativeId,
+        filePath: initiativePath,
+        section: 'success_metrics',
+        values: asStringArray(doc.success_metrics),
+        rawText,
+    });
+    const allowlist = parseAllowlistNotes({
+        specId: initiativeId,
+        notes: asStringArray(doc.notes),
+    });
+    return {
+        claims,
+        initiativeRef: null,
+        allowlist,
+    };
+}
+function resolveInitiativePath(initiativesDir, initiativeRef) {
+    const directPath = path.join(initiativesDir, `${initiativeRef}${YAML_EXTENSION}`);
+    if (existsSync(directPath)) {
+        return directPath;
+    }
+    const files = readdirSync(initiativesDir).filter((file) => file.endsWith(YAML_EXTENSION));
+    const refLower = initiativeRef.toLowerCase();
+    for (const file of files) {
+        const candidatePath = path.join(initiativesDir, file);
+        const rawText = readUtf8(candidatePath);
+        if (!rawText) {
+            continue;
+        }
+        const doc = parseYAML(rawText);
+        if (!doc) {
+            continue;
+        }
+        const candidateId = asString(doc.id)?.toLowerCase();
+        const candidateSlug = asString(doc.slug)?.toLowerCase();
+        if (candidateId === refLower || candidateSlug === refLower) {
+            return candidatePath;
+        }
+    }
+    return null;
+}
+function extractClaims(input) {
+    return input.values.map((claimText) => ({
+        claimText,
+        specReference: {
+            id: input.specId,
+            filePath: input.filePath,
+            line: findClaimLineNumber(input.rawText, claimText),
+            section: input.section,
+        },
+    }));
+}
+function parseAllowlistNotes(input) {
+    const entries = [];
+    for (const note of input.notes) {
+        const trimmed = note.trim();
+        if (!trimmed.toLowerCase().startsWith(CLAIM_NOTE_ALLOW_PREFIX)) {
+            continue;
+        }
+        const entry = parseAllowlistDirective(trimmed, input.specId);
+        if (entry) {
+            entries.push(entry);
+        }
+    }
+    return entries;
+}
+function parseAllowlistDirective(note, specId) {
+    const parts = note.split(/\s+/).filter(Boolean);
+    if (parts.length < 3) {
+        return null;
+    }
+    const claimToken = parts[1]?.trim().toLowerCase() ?? '';
+    const pathPattern = parts
+        .slice(2)
+        .join(' ')
+        .trim()
+        .replace(/^['"]|['"]$/g, '');
+    if (!pathPattern) {
+        return null;
+    }
+    const claimId = normalizeClaimId(claimToken);
+    if (!claimId) {
+        return null;
+    }
+    return {
+        claimId,
+        pathPattern,
+        source: specId,
+        reason: note,
+    };
+}
+function normalizeClaimId(value) {
+    if (value === CLAIM_ALLOWLIST_ALL) {
+        return CLAIM_ALLOWLIST_ALL;
+    }
+    const validIds = new Set(Object.values(CLAIM_VALIDATION_IDS));
+    if (validIds.has(value)) {
+        return value;
+    }
+    return null;
+}
+function applyAllowlist(evidence, allowlist, claimId) {
+    if (allowlist.length === 0) {
+        return evidence;
+    }
+    return evidence.filter((item) => {
+        for (const allowEntry of allowlist) {
+            const claimMatches = allowEntry.claimId === CLAIM_ALLOWLIST_ALL || allowEntry.claimId === claimId;
+            if (!claimMatches) {
+                continue;
+            }
+            if (micromatch.isMatch(item.filePath, allowEntry.pathPattern)) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+function scanLinesForPattern(input) {
+    const files = listSourceFiles(input.projectRoot, input.globs, input.ignores);
+    const evidence = [];
+    for (const filePath of files) {
+        const content = readUtf8(filePath);
+        if (!content) {
+            continue;
+        }
+        const lines = content.split(LINE_SPLIT_PATTERN);
+        lines.forEach((line, index) => {
+            if (!input.includeLine(line)) {
+                return;
+            }
+            evidence.push({
+                filePath: toRelativePath(input.projectRoot, filePath),
+                line: index + 1,
+                lineText: line.trim(),
+            });
+        });
+    }
+    return evidence;
+}
+function listSourceFiles(projectRoot, globs, ignores) {
+    const allMatches = new Set();
+    for (const pattern of globs) {
+        const matches = globSync(pattern, {
+            cwd: projectRoot,
+            absolute: true,
+            nodir: true,
+            ignore: [...ignores],
+        });
+        matches.forEach((match) => allMatches.add(path.resolve(match)));
+    }
+    return Array.from(allMatches).sort((left, right) => left.localeCompare(right));
+}
+function isCommentOnlyLine(line) {
+    const trimmed = line.trim();
+    return (trimmed.startsWith('//') ||
+        trimmed.startsWith('/*') ||
+        trimmed.startsWith('*') ||
+        trimmed.startsWith('*/'));
+}
+function findClaimLineNumber(rawText, claimText) {
+    const lines = rawText.split(LINE_SPLIT_PATTERN);
+    const normalizedClaim = normalizeText(claimText);
+    const claimPrefix = normalizedClaim
+        .split(' ')
+        .filter(Boolean)
+        .slice(0, CLAIM_LINE_PREFIX_WORDS)
+        .join(' ');
+    if (claimPrefix.length === 0) {
+        return 1;
+    }
+    const exactLine = findLineNumber(lines, (line) => normalizeText(line).includes(claimPrefix));
+    return exactLine ?? 1;
+}
+function findLineNumber(lines, matches) {
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index];
+        if (!line) {
+            continue;
+        }
+        if (matches(line)) {
+            return index + 1;
+        }
+    }
+    return null;
+}
+function normalizeText(value) {
+    return value.toLowerCase().replace(/['"`]/g, '').replace(/\s+/g, ' ').trim();
+}
+function asString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const result = [];
+    for (const item of value) {
+        if (typeof item === 'string') {
+            const trimmed = item.trim();
+            if (trimmed) {
+                result.push(trimmed);
+            }
+        }
+    }
+    return result;
+}
+function readUtf8(filePath) {
+    try {
+        return readFileSync(filePath, { encoding: FILE_SYSTEM.UTF8 });
+    }
+    catch {
+        return null;
+    }
+}
+function toRelativePath(projectRoot, absolutePath) {
+    return path.relative(projectRoot, absolutePath).split(path.sep).join('/');
+}
+//# sourceMappingURL=claim-validation.js.map

package/dist/validators/claim-validation.js.map

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

package/dist/validators/supabase-docs-linter.d.ts

@@ -0,0 +1,15 @@
+export interface SupabaseDocsLinterResult {
+    ok: boolean;
+    skipped: boolean;
+    message?: string;
+    errors?: string[];
+}
+export interface SupabaseDocsLinterOptions {
+    cwd?: string;
+    logger?: {
+        log: (message: string) => void;
+        warn?: (message: string) => void;
+    };
+}
+export declare function runSupabaseDocsLinter(options?: SupabaseDocsLinterOptions): Promise<SupabaseDocsLinterResult>;
+//# sourceMappingURL=supabase-docs-linter.d.ts.map

package/dist/validators/supabase-docs-linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-docs-linter.d.ts","sourceRoot":"","sources":["../../src/validators/supabase-docs-linter.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CAC/E;AAED,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAuCnC"}