@lumenflow/cli 3.1.3 → 3.2.1

package/dist/gates-plan-resolvers.js

@@ -0,0 +1,190 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Gates Plan Resolvers
+ *
+ * WU-1647: Extracted pure plan-resolution functions that decide
+ * what mode (full/incremental/skip) each gate should use.
+ *
+ * These functions are side-effect-free and only depend on their inputs.
+ *
+ * @module gates-plan-resolvers
+ */
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { isLintableFile } from '@lumenflow/core/incremental-lint';
+import { getBasename, normalizePath, extractPackagesFromCodePaths } from './gates-utils.js';
+// ── Config file detection ──────────────────────────────────────────────
+const PRETTIER_CONFIG_FILES = new Set([
+    '.prettierrc',
+    '.prettierrc.json',
+    '.prettierrc.yaml',
+    '.prettierrc.yml',
+    '.prettierrc.js',
+    '.prettierrc.cjs',
+    '.prettierrc.ts',
+    'prettier.config.js',
+    'prettier.config.cjs',
+    'prettier.config.ts',
+    'prettier.config.mjs',
+    '.prettierignore',
+]);
+const WORKSPACE_ARTIFACT_ROOT_PREFIXES = ['packages/', 'apps/', 'tools/'];
+const DIST_ARTIFACT_ROOT_SUFFIX = '/dist';
+const DIST_ARTIFACT_PATH_SEGMENT = '/dist/';
+// WU-1356: Extended to support multiple build tools and test runners
+const TEST_CONFIG_BASENAMES = new Set([
+    'turbo.json', // Turborepo
+    'nx.json', // Nx
+    'lerna.json', // Lerna
+    'pnpm-lock.yaml',
+    'package-lock.json',
+    'yarn.lock',
+    'bun.lockb',
+    'package.json',
+]);
+// WU-1356: Extended to support vitest, jest, and mocha config patterns
+const TEST_CONFIG_PATTERNS = [
+    /^vitest\.config\.(ts|mts|js|mjs|cjs)$/i,
+    /^jest\.config\.(ts|js|mjs|cjs|json)$/i,
+    /^\.mocharc\.(js|json|yaml|yml)$/i,
+    // eslint-disable-next-line security/detect-unsafe-regex -- static tsconfig pattern; no backtracking risk
+    /^tsconfig(\..+)?\.json$/i,
+];
+export function isPrettierConfigFile(filePath) {
+    if (!filePath)
+        return false;
+    const basename = getBasename(filePath);
+    return PRETTIER_CONFIG_FILES.has(basename);
+}
+function trimTrailingPathSeparators(filePath) {
+    let trimmed = filePath;
+    while (trimmed.endsWith('/')) {
+        trimmed = trimmed.slice(0, -1);
+    }
+    return trimmed;
+}
+export function isWorkspaceDistArtifactRoot(filePath) {
+    if (!filePath) {
+        return false;
+    }
+    const normalizedPath = trimTrailingPathSeparators(normalizePath(filePath));
+    if (!normalizedPath) {
+        return false;
+    }
+    const hasWorkspacePrefix = WORKSPACE_ARTIFACT_ROOT_PREFIXES.some((prefix) => normalizedPath.startsWith(prefix));
+    const isDistArtifactPath = normalizedPath.endsWith(DIST_ARTIFACT_ROOT_SUFFIX) ||
+        normalizedPath.includes(DIST_ARTIFACT_PATH_SEGMENT);
+    return hasWorkspacePrefix && isDistArtifactPath;
+}
+export function filterFormatCheckChangedFiles(changedFiles) {
+    return changedFiles.filter((filePath) => !isWorkspaceDistArtifactRoot(filePath));
+}
+function filterExistingFormatCheckFiles(changedFiles, cwd) {
+    return changedFiles.filter((filePath) => {
+        const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
+        return existsSync(resolvedPath);
+    });
+}
+export function isTestConfigFile(filePath) {
+    if (!filePath)
+        return false;
+    const basename = getBasename(filePath);
+    if (TEST_CONFIG_BASENAMES.has(basename)) {
+        return true;
+    }
+    return TEST_CONFIG_PATTERNS.some((pattern) => pattern.test(basename));
+}
+// ── Plan resolvers ─────────────────────────────────────────────────────
+/* eslint-disable sonarjs/no-duplicate-string -- Pre-existing: format check reasons are intentionally distinct string literals */
+export function resolveFormatCheckPlan({ changedFiles, fileListError = false, cwd, }) {
+    const filteredChangedFiles = filterFormatCheckChangedFiles(changedFiles);
+    if (fileListError) {
+        return { mode: 'full', files: [], reason: 'file-list-error' };
+    }
+    if (filteredChangedFiles.some(isPrettierConfigFile)) {
+        return { mode: 'full', files: [], reason: 'prettier-config' };
+    }
+    const existingChangedFiles = cwd
+        ? filterExistingFormatCheckFiles(filteredChangedFiles, cwd)
+        : filteredChangedFiles;
+    if (existingChangedFiles.length === 0) {
+        return { mode: 'skip', files: [] };
+    }
+    return { mode: 'incremental', files: existingChangedFiles };
+}
+export function resolveLintPlan({ isMainBranch, changedFiles, }) {
+    if (isMainBranch) {
+        return { mode: 'full', files: [] };
+    }
+    const lintTargets = changedFiles.filter((filePath) => {
+        const normalized = normalizePath(filePath);
+        return ((normalized.startsWith('apps/') || normalized.startsWith('packages/')) &&
+            isLintableFile(normalized));
+    });
+    if (lintTargets.length === 0) {
+        return { mode: 'skip', files: [] };
+    }
+    return { mode: 'incremental', files: lintTargets };
+}
+/* eslint-enable sonarjs/no-duplicate-string */
+export function resolveTestPlan({ isMainBranch, hasUntrackedCode, hasConfigChange, fileListError, }) {
+    if (fileListError) {
+        return { mode: 'full', reason: 'file-list-error' };
+    }
+    if (hasUntrackedCode) {
+        return { mode: 'full', reason: 'untracked-code' };
+    }
+    if (hasConfigChange) {
+        return { mode: 'full', reason: 'test-config' };
+    }
+    if (isMainBranch) {
+        return { mode: 'full' };
+    }
+    return { mode: 'incremental' };
+}
+/**
+ * WU-1299: Resolve test plan for docs-only mode
+ */
+export function resolveDocsOnlyTestPlan({ codePaths }) {
+    const packages = extractPackagesFromCodePaths(codePaths);
+    if (packages.length === 0) {
+        return {
+            mode: 'skip',
+            packages: [],
+            reason: 'no-code-packages',
+        };
+    }
+    return {
+        mode: 'filtered',
+        packages,
+    };
+}
+/**
+ * WU-1299: Format message for docs-only test skipping/filtering
+ */
+export function formatDocsOnlySkipMessage(plan) {
+    if (plan.mode === 'skip') {
+        return '\uD83D\uDCDD docs-only mode: skipping all tests (no code packages in code_paths)';
+    }
+    const packageList = plan.packages.join(', ');
+    return `\uD83D\uDCDD docs-only mode: running tests only for packages in code_paths: ${packageList}`;
+}
+/**
+ * Resolve spec-linter execution strategy.
+ * If current WU is known, run scoped validation only.
+ * If unknown, fall back to global validation.
+ */
+export function resolveSpecLinterPlan(wuId) {
+    if (wuId) {
+        return {
+            scopedWuId: wuId,
+            runGlobal: false,
+        };
+    }
+    return {
+        scopedWuId: null,
+        runGlobal: true,
+    };
+}
+//# sourceMappingURL=gates-plan-resolvers.js.map

package/dist/gates-plan-resolvers.js.map

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