specforge-mcp 0.1.0

package/dist/engine/config-health/build-tool-checker.js

@@ -0,0 +1,158 @@
+// engine/config-health/build-tool-checker.ts — SPEC-050 S3
+// Config health checks for build tools (Vite-specific).
+// C7: vite.config.ts not in tsconfig include → error
+// C8: rolldown bundler + this.emitFile in config → warning
+// C9: Vite 7+ with explicit es5/es6 target → info
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { detectBuildTool } from '../build-tool-detector.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function readFileSafe(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+function parseVersionMajor(version) {
+    if (!version) {
+        return null;
+    }
+    const cleaned = version.replace(/^[^0-9]*/, '');
+    const match = /^(\d+)/.exec(cleaned);
+    return match !== null ? parseInt(match[1] ?? '0', 10) : null;
+}
+// ---------------------------------------------------------------------------
+// C7: vite.config.ts not covered by tsconfig include patterns
+// ---------------------------------------------------------------------------
+/**
+ * Check that vite.config.ts is covered by tsconfig.json include patterns.
+ * If tsconfig has no include array, TypeScript covers all files by default → no finding.
+ */
+async function checkViteConfigInTsconfig(projectPath) {
+    const tsconfigContent = await readFileSafe(join(projectPath, 'tsconfig.json'));
+    if (!tsconfigContent) {
+        return [];
+    }
+    let tsconfig;
+    try {
+        tsconfig = JSON.parse(tsconfigContent);
+    }
+    catch {
+        return [];
+    }
+    // No include array → TypeScript covers everything by default
+    if (!tsconfig.include) {
+        return [];
+    }
+    // Check if vite.config.ts is covered by any include pattern
+    const patterns = tsconfig.include;
+    const covered = patterns.some((p) => p === 'vite.config.ts' ||
+        p === '*.config.ts' ||
+        p === '*.ts' ||
+        p.endsWith('/**') ||
+        p === '**' ||
+        p === '**/*.ts');
+    if (covered) {
+        return [];
+    }
+    return [
+        {
+            severity: 'error',
+            checker: 'build-tool',
+            file: 'tsconfig.json',
+            message: 'vite.config.ts not covered by tsconfig — TypeScript will not check build config',
+            fix: "Add 'vite.config.ts' or '*.config.ts' to tsconfig.json 'include' array",
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// C8: Rolldown-incompatible plugin (this.emitFile) in vite.config
+// ---------------------------------------------------------------------------
+/**
+ * Scan vite.config content for this.emitFile usage (Rollup hook not supported in Rolldown).
+ * Only triggered when bundler is rolldown.
+ */
+async function checkRolldownPluginCompat(projectPath, configFile) {
+    const configContent = await readFileSafe(join(projectPath, configFile));
+    if (!configContent) {
+        return [];
+    }
+    if (!configContent.includes('this.emitFile')) {
+        return [];
+    }
+    return [
+        {
+            severity: 'warning',
+            checker: 'build-tool',
+            file: configFile,
+            message: 'Rollup plugin hook this.emitFile detected — may not be Rolldown-compatible (Rolldown does not implement all Rollup hooks)',
+            fix: 'Check the Rolldown plugin compatibility matrix at https://rolldown.rs/contrib-guide/. Pin to Vite 7 if a critical plugin is incompatible.',
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// C9: Vite 7+ with explicit legacy target
+// ---------------------------------------------------------------------------
+const LEGACY_TARGETS = new Set(['es5', 'es6', 'es2015']);
+/**
+ * Detect if Vite 7+ config has an explicit legacy build.target that overrides
+ * the new baseline-widely-available default.
+ */
+async function checkVite7LegacyTarget(projectPath, configFile) {
+    const configContent = await readFileSafe(join(projectPath, configFile));
+    if (!configContent) {
+        return [];
+    }
+    const targetMatch = /build\s*[:{][^}]*target\s*[:=]\s*['"`]([^'"`]+)['"`]/.exec(configContent);
+    if (!targetMatch) {
+        return [];
+    }
+    const target = (targetMatch[1] ?? '').toLowerCase();
+    if (!LEGACY_TARGETS.has(target)) {
+        return [];
+    }
+    return [
+        {
+            severity: 'info',
+            checker: 'build-tool',
+            file: configFile,
+            message: `Explicit build target '${target}' overrides Vite 7 baseline-widely-available default`,
+            fix: 'Consider removing the explicit target and using @vitejs/plugin-legacy only if you need IE11 support',
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+/**
+ * Run build-tool health checks by auto-detecting the build tool from the project.
+ * Only runs Vite-specific checks when Vite is detected.
+ * Per SPEC-050 S3: no build tool detected → no checks.
+ */
+export async function checkBuildToolHealth(projectPath) {
+    const buildTool = await detectBuildTool(projectPath);
+    if (buildTool.buildTool !== 'vite') {
+        return [];
+    }
+    const configFile = buildTool.configFile ?? 'vite.config.ts';
+    const major = parseVersionMajor(buildTool.version);
+    const promises = [
+        // C7: vite.config.ts coverage
+        checkViteConfigInTsconfig(projectPath),
+    ];
+    // C8: Rolldown plugin compat check
+    if (buildTool.bundler === 'rolldown') {
+        promises.push(checkRolldownPluginCompat(projectPath, configFile));
+    }
+    // C9: Vite 7+ legacy target check
+    if (major !== null && major >= 7) {
+        promises.push(checkVite7LegacyTarget(projectPath, configFile));
+    }
+    const results = await Promise.all(promises);
+    return results.flat();
+}
+//# sourceMappingURL=build-tool-checker.js.map

package/dist/engine/config-health/build-tool-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-tool-checker.js","sourceRoot":"","sources":["../../../src/engine/config-health/build-tool-checker.ts"],"names":[],"mappings":"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"}

package/dist/engine/config-health/ci-checker.d.ts

@@ -0,0 +1,5 @@
+import type { ConfigHealthFinding } from '../../types/index.js';
+export { checkVersionConsistency } from './ci-version-checker.js';
+export declare function checkCiCommands(projectPath: string): Promise<ConfigHealthFinding[]>;
+export declare function checkBuildArtifacts(projectPath: string): Promise<ConfigHealthFinding[]>;
+//# sourceMappingURL=ci-checker.d.ts.map

package/dist/engine/config-health/ci-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/config-health/ci-checker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AA0BlE,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoFzF;AAMD,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA8D7F"}

package/dist/engine/config-health/ci-checker.js

@@ -0,0 +1,170 @@
+// engine/config-health/ci-checker.ts — SPEC-042
+// CI/Build configuration health checks (language-agnostic).
+import { join } from 'node:path';
+import { glob } from 'glob';
+import { collectProjectCommands, fileExists, readFileSafe } from './ci-commands-collector.js';
+export { checkVersionConsistency } from './ci-version-checker.js';
+// ---------------------------------------------------------------------------
+// Check: CI commands referencing non-existent scripts
+// ---------------------------------------------------------------------------
+function extractCiRunCommands(content) {
+    const commands = [];
+    const runPattern = /^\s*-?\s*run\s*:\s*(.+)$/gm;
+    let match;
+    while ((match = runPattern.exec(content)) !== null) {
+        const cmd = match[1]?.trim() ?? '';
+        if (cmd) {
+            commands.push(cmd);
+        }
+    }
+    const scriptPattern = /^\s*-\s+([\w./]+\s+[\w./]+.*|[\w./]+\.sh.*)$/gm;
+    while ((match = scriptPattern.exec(content)) !== null) {
+        const cmd = match[1]?.trim() ?? '';
+        if (cmd && !cmd.startsWith('uses:') && !cmd.startsWith('name:')) {
+            commands.push(cmd);
+        }
+    }
+    return commands;
+}
+export async function checkCiCommands(projectPath) {
+    const findings = [];
+    const ciFiles = [];
+    try {
+        const ghWorkflows = await glob('.github/workflows/*.{yml,yaml}', {
+            cwd: projectPath,
+            nodir: true,
+        });
+        ciFiles.push(...ghWorkflows);
+    }
+    catch {
+        /* v8 ignore next 1 */
+        // ignore
+    }
+    const gitlabCi = await readFileSafe(join(projectPath, '.gitlab-ci.yml'));
+    if (gitlabCi) {
+        ciFiles.push('.gitlab-ci.yml');
+    }
+    const bitbucketPipelines = await readFileSafe(join(projectPath, 'bitbucket-pipelines.yml'));
+    if (bitbucketPipelines) {
+        ciFiles.push('bitbucket-pipelines.yml');
+    }
+    if (ciFiles.length === 0) {
+        return findings;
+    }
+    const projectCmds = await collectProjectCommands(projectPath);
+    for (const ciFile of ciFiles) {
+        const content = await readFileSafe(join(projectPath, ciFile));
+        if (!content) {
+            continue;
+        }
+        for (const cmd of extractCiRunCommands(content)) {
+            const npmRunMatch = /(?:npm run|pnpm run|yarn run)\s+([\w:-]+)/.exec(cmd);
+            if (npmRunMatch?.[1]) {
+                const scriptName = npmRunMatch[1];
+                if (!projectCmds.packageScripts.has(scriptName)) {
+                    findings.push({
+                        severity: 'error',
+                        checker: 'ci-commands',
+                        file: ciFile,
+                        message: `CI step runs 'npm run ${scriptName}' but '${scriptName}' is not in package.json scripts`,
+                        fix: `Add '${scriptName}' to package.json scripts or fix the CI command`,
+                    });
+                }
+                continue;
+            }
+            const makeMatch = /^make\s+([\w-]+)/.exec(cmd);
+            if (makeMatch?.[1]) {
+                const target = makeMatch[1];
+                if (!projectCmds.makefileTargets.has(target)) {
+                    findings.push({
+                        severity: 'warning',
+                        checker: 'ci-commands',
+                        file: ciFile,
+                        message: `CI step runs 'make ${target}' but target '${target}' not found in Makefile`,
+                        fix: `Add '${target}' target to Makefile or fix the CI command`,
+                    });
+                }
+                continue;
+            }
+            const shellMatch = /(?:bash|sh)\s+(scripts\/[\w./]+\.sh)/.exec(cmd);
+            if (shellMatch?.[1]) {
+                const scriptPath = shellMatch[1];
+                const exists = await fileExists(join(projectPath, scriptPath));
+                if (!exists) {
+                    findings.push({
+                        severity: 'error',
+                        checker: 'ci-commands',
+                        file: ciFile,
+                        message: `CI step runs '${scriptPath}' but the file does not exist`,
+                        fix: `Create '${scriptPath}' or fix the CI command`,
+                    });
+                }
+            }
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Check: build artifacts depending on config files not copied to dist
+// ---------------------------------------------------------------------------
+export async function checkBuildArtifacts(projectPath) {
+    const findings = [];
+    const hasDist = await fileExists(join(projectPath, 'dist', 'index.js'));
+    const hasBuildSrc = await fileExists(join(projectPath, 'src', 'index.ts'));
+    if (!hasBuildSrc) {
+        return findings;
+    }
+    let configJsonFiles;
+    try {
+        configJsonFiles = await glob('src/config/**/*.json', { cwd: projectPath, nodir: true });
+    }
+    catch {
+        /* v8 ignore next 1 */
+        return findings;
+    }
+    if (configJsonFiles.length === 0) {
+        return findings;
+    }
+    const pkgContent = await readFileSafe(join(projectPath, 'package.json'));
+    let buildScript = '';
+    if (pkgContent) {
+        try {
+            const pkg = JSON.parse(pkgContent);
+            buildScript = pkg.scripts?.build ?? '';
+        }
+        catch {
+            // ignore
+        }
+    }
+    const hasCopyStep = buildScript.includes('cp ') ||
+        buildScript.includes('copyfiles') ||
+        buildScript.includes('cpy ') ||
+        buildScript.includes('ncp ') ||
+        buildScript.includes('config');
+    if (hasDist && !hasCopyStep) {
+        for (const configFile of configJsonFiles) {
+            const distPath = configFile.replace(/^src\//, 'dist/');
+            const existsInDist = await fileExists(join(projectPath, distPath));
+            if (!existsInDist) {
+                findings.push({
+                    severity: 'error',
+                    checker: 'build-artifacts',
+                    file: configFile,
+                    message: `Config file '${configFile}' is not present in '${distPath}' — will cause runtime crash when deployed`,
+                    fix: `Add a copy step to the build script: e.g., 'cp -r src/config dist/config' or use 'copyfiles' package`,
+                });
+            }
+        }
+    }
+    else if (!hasDist && !hasCopyStep) {
+        findings.push({
+            severity: 'warning',
+            checker: 'build-artifacts',
+            file: 'package.json',
+            message: `${configJsonFiles.length} JSON config file(s) in src/config/ detected but build script has no copy step`,
+            fix: `Add 'cp -r src/config dist/config' or similar to your build script to ensure configs are available at runtime`,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=ci-checker.js.map

package/dist/engine/config-health/ci-checker.js.map

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

package/dist/engine/config-health/ci-commands-collector.d.ts

@@ -0,0 +1,10 @@
+export declare function readFileSafe(filePath: string): Promise<string>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function collectProjectCommands(projectPath: string): Promise<{
+    packageScripts: Set<string>;
+    makefileTargets: Set<string>;
+    shellScripts: Set<string>;
+    cargoAliases: Set<string>;
+    pythonScripts: Set<string>;
+}>;
+//# sourceMappingURL=ci-commands-collector.d.ts.map

package/dist/engine/config-health/ci-commands-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-commands-collector.d.ts","sourceRoot":"","sources":["../../../src/engine/config-health/ci-commands-collector.ts"],"names":[],"mappings":"AAOA,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnE;AAgHD,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACzE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B,CAAC,CAUD"}

package/dist/engine/config-health/ci-commands-collector.js

@@ -0,0 +1,135 @@
+// engine/config-health/ci-commands-collector.ts — SPEC-042
+// Helpers to collect available commands/scripts in a project.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+export async function readFileSafe(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+export async function fileExists(filePath) {
+    const c = await readFileSafe(filePath);
+    return c !== '';
+}
+async function collectPackageScripts(projectPath) {
+    const scripts = new Set();
+    const pkgContent = await readFileSafe(join(projectPath, 'package.json'));
+    if (!pkgContent) {
+        return scripts;
+    }
+    try {
+        const pkg = JSON.parse(pkgContent);
+        for (const name of Object.keys(pkg.scripts ?? {})) {
+            scripts.add(name);
+        }
+    }
+    catch {
+        // ignore parse errors
+    }
+    return scripts;
+}
+async function collectMakefileTargets(projectPath) {
+    const targets = new Set();
+    const makeContent = await readFileSafe(join(projectPath, 'Makefile'));
+    if (!makeContent) {
+        return targets;
+    }
+    const targetPattern = /^([\w-]+)\s*:/gm;
+    let match;
+    while ((match = targetPattern.exec(makeContent)) !== null) {
+        /* v8 ignore start */
+        if (match[1]) {
+            targets.add(match[1]);
+        }
+        /* v8 ignore stop */
+    }
+    return targets;
+}
+async function collectShellScripts(projectPath) {
+    const scripts = new Set();
+    try {
+        const found = await glob('scripts/**/*.sh', { cwd: projectPath, nodir: true });
+        for (const s of found) {
+            scripts.add(s);
+            /* v8 ignore start */
+            const base = s.split('/').pop() ?? '';
+            if (base) {
+                scripts.add(base);
+            }
+            /* v8 ignore stop */
+        }
+    }
+    catch {
+        // ignore
+    }
+    return scripts;
+}
+async function collectCargoAliases(projectPath) {
+    const aliases = new Set();
+    const content = await readFileSafe(join(projectPath, '.cargo', 'config.toml'));
+    if (!content) {
+        return aliases;
+    }
+    const aliasPattern = /^([\w-]+)\s*=/gm;
+    let inAliasSection = false;
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed === '[alias]') {
+            inAliasSection = true;
+            continue;
+        }
+        if (inAliasSection && trimmed.startsWith('[')) {
+            break;
+        }
+        if (inAliasSection) {
+            let m;
+            aliasPattern.lastIndex = 0;
+            if ((m = aliasPattern.exec(trimmed)) !== null && m[1]) {
+                aliases.add(m[1]);
+            }
+        }
+    }
+    return aliases;
+}
+async function collectPythonScripts(projectPath) {
+    const scripts = new Set();
+    const content = await readFileSafe(join(projectPath, 'pyproject.toml'));
+    if (!content) {
+        return scripts;
+    }
+    const scriptPattern = /^\s*([\w-]+)\s*=\s*"/gm;
+    let inScripts = false;
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed === '[project.scripts]') {
+            inScripts = true;
+            continue;
+        }
+        if (inScripts && trimmed.startsWith('[')) {
+            break;
+        }
+        if (inScripts) {
+            let m;
+            scriptPattern.lastIndex = 0;
+            if ((m = scriptPattern.exec(trimmed)) !== null && m[1]) {
+                scripts.add(m[1]);
+            }
+        }
+    }
+    return scripts;
+}
+export async function collectProjectCommands(projectPath) {
+    const [packageScripts, makefileTargets, shellScripts, cargoAliases, pythonScripts] = await Promise.all([
+        collectPackageScripts(projectPath),
+        collectMakefileTargets(projectPath),
+        collectShellScripts(projectPath),
+        collectCargoAliases(projectPath),
+        collectPythonScripts(projectPath),
+    ]);
+    return { packageScripts, makefileTargets, shellScripts, cargoAliases, pythonScripts };
+}
+//# sourceMappingURL=ci-commands-collector.js.map

package/dist/engine/config-health/ci-commands-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-commands-collector.js","sourceRoot":"","sources":["../../../src/engine/config-health/ci-commands-collector.ts"],"names":[],"mappings":"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"}

package/dist/engine/config-health/ci-version-checker.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigHealthFinding } from '../../types/index.js';
+export declare function checkVersionConsistency(projectPath: string): Promise<ConfigHealthFinding[]>;
+//# sourceMappingURL=ci-version-checker.d.ts.map

package/dist/engine/config-health/ci-version-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-version-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/config-health/ci-version-checker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAwHhE,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA0BjG"}

package/dist/engine/config-health/ci-version-checker.js

@@ -0,0 +1,131 @@
+// engine/config-health/ci-version-checker.ts — SPEC-042
+// Version consistency checks between CI files and local tool-version declarations.
+import { join } from 'node:path';
+import { glob } from 'glob';
+import { readFileSafe } from './ci-commands-collector.js';
+async function collectVersionDeclarations(projectPath) {
+    const declarations = [];
+    const nvmrc = await readFileSafe(join(projectPath, '.nvmrc'));
+    if (nvmrc.trim()) {
+        declarations.push({
+            runtime: 'node',
+            version: nvmrc.trim().replace('v', ''),
+            source: '.nvmrc',
+        });
+    }
+    const toolVersions = await readFileSafe(join(projectPath, '.tool-versions'));
+    if (toolVersions) {
+        for (const line of toolVersions.split('\n')) {
+            const m = /^(nodejs|python|go|rust|ruby)\s+([\d.]+)/.exec(line.trim());
+            if (m?.[1] && m[2]) {
+                const runtime = m[1] === 'nodejs' ? 'node' : m[1];
+                declarations.push({ runtime, version: m[2], source: '.tool-versions' });
+            }
+        }
+    }
+    const goMod = await readFileSafe(join(projectPath, 'go.mod'));
+    if (goMod) {
+        const m = /^go\s+([\d.]+)/m.exec(goMod);
+        if (m?.[1]) {
+            declarations.push({ runtime: 'go', version: m[1], source: 'go.mod' });
+        }
+    }
+    const pyproject = await readFileSafe(join(projectPath, 'pyproject.toml'));
+    if (pyproject) {
+        const m = /requires-python\s*=\s*"([^"]+)"/.exec(pyproject);
+        if (m?.[1]) {
+            const version = m[1]
+                .replace(/[>=<~!]/g, '')
+                .trim()
+                .split('.')
+                .slice(0, 2)
+                .join('.');
+            declarations.push({ runtime: 'python', version, source: 'pyproject.toml' });
+        }
+    }
+    return declarations;
+}
+function checkVersionInCiFile(content, ciFile, localVersions) {
+    const findings = [];
+    const nodeVersionPattern = /node-version\s*:\s*['"]?([\d.]+)['"]?/g;
+    let match;
+    while ((match = nodeVersionPattern.exec(content)) !== null) {
+        /* v8 ignore start */
+        const ciVersion = (match[1] ?? '').split('.')[0] ?? '';
+        /* v8 ignore stop */
+        const localNode = localVersions.find((v) => v.runtime === 'node');
+        const localMajor = localNode?.version.split('.')[0] ?? '';
+        if (localNode && ciVersion && localMajor && ciVersion !== localMajor) {
+            findings.push({
+                severity: 'warning',
+                checker: 'ci-commands',
+                file: ciFile,
+                message: `CI uses Node.js ${ciVersion} but ${localNode.source} specifies ${localNode.version}`,
+                fix: `Align Node.js version in ${ciFile} with ${localNode.source} (use ${localNode.version})`,
+            });
+        }
+    }
+    const pythonVersionPattern = /python-version\s*:\s*['"]?([\d.]+)['"]?/g;
+    while ((match = pythonVersionPattern.exec(content)) !== null) {
+        const ciVersion = match[1];
+        const localPython = localVersions.find((v) => v.runtime === 'python');
+        if (localPython && ciVersion) {
+            const ciMM = ciVersion.split('.').slice(0, 2).join('.');
+            const localMM = localPython.version.split('.').slice(0, 2).join('.');
+            if (ciMM !== localMM) {
+                findings.push({
+                    severity: 'warning',
+                    checker: 'ci-commands',
+                    file: ciFile,
+                    message: `CI uses Python ${ciVersion} but ${localPython.source} specifies ${localPython.version}`,
+                    fix: `Align Python version in ${ciFile} with ${localPython.source} (use ${localPython.version})`,
+                });
+            }
+        }
+    }
+    const goVersionPattern = /go-version\s*:\s*['"]?([\d.]+)['"]?/g;
+    while ((match = goVersionPattern.exec(content)) !== null) {
+        const ciVersion = match[1];
+        const localGo = localVersions.find((v) => v.runtime === 'go');
+        if (localGo && ciVersion) {
+            const ciMM = ciVersion.split('.').slice(0, 2).join('.');
+            const localMM = localGo.version.split('.').slice(0, 2).join('.');
+            if (ciMM !== localMM) {
+                findings.push({
+                    severity: 'warning',
+                    checker: 'ci-commands',
+                    file: ciFile,
+                    message: `CI uses Go ${ciVersion} but ${localGo.source} specifies ${localGo.version}`,
+                    fix: `Align Go version in ${ciFile} with ${localGo.source} (use ${localGo.version})`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+export async function checkVersionConsistency(projectPath) {
+    const findings = [];
+    const localVersions = await collectVersionDeclarations(projectPath);
+    if (localVersions.length === 0) {
+        return findings;
+    }
+    let ciFiles;
+    try {
+        ciFiles = await glob('.github/workflows/*.{yml,yaml}', { cwd: projectPath, nodir: true });
+    }
+    catch {
+        return findings;
+    }
+    if (ciFiles.length === 0) {
+        return findings;
+    }
+    for (const ciFile of ciFiles) {
+        const content = await readFileSafe(join(projectPath, ciFile));
+        if (!content) {
+            continue;
+        }
+        findings.push(...checkVersionInCiFile(content, ciFile, localVersions));
+    }
+    return findings;
+}
+//# sourceMappingURL=ci-version-checker.js.map