@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-rules-resolvers.js

@@ -0,0 +1,229 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import fg from 'fast-glob';
+import { createGitForPath } from './git-adapter.js';
+import { CLI_PACKAGE_JSON_PATH, hasGlobPattern, normalizePathForCoverage, } from './wu-rules-core.js';
+const DEFAULT_HEAD_REF = 'HEAD';
+const BASE_REF_CANDIDATES = ['origin/main', 'main'];
+const BASE_REF_UNAVAILABLE_REASON = `Unable to resolve git base ref (tried ${BASE_REF_CANDIDATES.join(', ')}).`;
+const GLOB_IGNORE_PATTERNS = ['**/node_modules/**'];
+const GLOB_INCLUDE_DOT_ENTRIES = true;
+const GLOB_ONLY_FILES = false;
+const GLOB_FOLLOW_SYMLINKS = false;
+const GLOB_SUPPRESS_ERRORS = true;
+const GLOB_REQUIRE_UNIQUE_MATCHES = true;
+const PATH_NOT_FOUND_PATTERNS = [
+    /does not exist in/i,
+    /exists on disk, but not in/i,
+    /path .* not in/i,
+    /unknown revision or path/i,
+    /fatal: path /i,
+];
+function getGlobOptions(cwd) {
+    return {
+        cwd,
+        dot: GLOB_INCLUDE_DOT_ENTRIES,
+        onlyFiles: GLOB_ONLY_FILES,
+        followSymbolicLinks: GLOB_FOLLOW_SYMLINKS,
+        suppressErrors: GLOB_SUPPRESS_ERRORS,
+        ignore: GLOB_IGNORE_PATTERNS,
+        unique: GLOB_REQUIRE_UNIQUE_MATCHES,
+    };
+}
+function toErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function splitLines(output) {
+    return output
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean);
+}
+function matchesAnyNotFoundPattern(message) {
+    return PATH_NOT_FOUND_PATTERNS.some((pattern) => pattern.test(message));
+}
+async function readJsonFileAtRef(options) {
+    const git = createGitForPath(options.cwd);
+    try {
+        const output = await git.raw(['show', `${options.ref}:${options.filePath}`]);
+        const parsed = JSON.parse(output);
+        return { ok: true, value: parsed };
+    }
+    catch (error) {
+        const message = toErrorMessage(error);
+        if (matchesAnyNotFoundPattern(message)) {
+            return { ok: false, missing: true };
+        }
+        return { ok: false, missing: false, reason: message };
+    }
+}
+function isMissingRefResult(result) {
+    return !result.ok && 'missing' in result && result.missing === true;
+}
+function isErrorRefResult(result) {
+    return !result.ok && 'missing' in result && result.missing === false;
+}
+export function pathReferenceExistsSync(reference, cwd) {
+    const normalizedReference = reference.trim();
+    if (!normalizedReference) {
+        return false;
+    }
+    if (hasGlobPattern(normalizedReference)) {
+        try {
+            const matches = fg.sync(normalizedReference, getGlobOptions(cwd));
+            return matches.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    const fullPath = path.join(cwd, normalizedReference);
+    return existsSync(fullPath);
+}
+export async function pathReferenceExists(reference, cwd) {
+    const normalizedReference = reference.trim();
+    if (!normalizedReference) {
+        return false;
+    }
+    if (hasGlobPattern(normalizedReference)) {
+        try {
+            const matches = await fg(normalizedReference, getGlobOptions(cwd));
+            return matches.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    const fullPath = path.join(cwd, normalizedReference);
+    return existsSync(fullPath);
+}
+export async function resolveBaseRef(options) {
+    if (options.baseRef && options.baseRef.trim()) {
+        return options.baseRef.trim();
+    }
+    const git = createGitForPath(options.cwd);
+    for (const candidateRef of BASE_REF_CANDIDATES) {
+        try {
+            if (await git.branchExists(candidateRef)) {
+                return candidateRef;
+            }
+        }
+        catch {
+            // Continue trying other candidates.
+        }
+    }
+    return null;
+}
+export async function resolveChangedFiles(options) {
+    const cwd = options.cwd;
+    const headRef = options.headRef || DEFAULT_HEAD_REF;
+    const baseRef = await resolveBaseRef({ cwd, baseRef: options.baseRef });
+    if (!baseRef) {
+        return {
+            ok: false,
+            reason: BASE_REF_UNAVAILABLE_REASON,
+        };
+    }
+    const git = createGitForPath(cwd);
+    try {
+        const output = await git.raw(['diff', '--name-only', `${baseRef}...${headRef}`]);
+        const files = splitLines(output).map((filePath) => normalizePathForCoverage(filePath));
+        return {
+            ok: true,
+            files,
+            baseRef,
+            headRef,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            reason: toErrorMessage(error),
+        };
+    }
+}
+export async function resolveCliBinDiff(options) {
+    const cwd = options.cwd;
+    const headRef = options.headRef || DEFAULT_HEAD_REF;
+    const baseRef = await resolveBaseRef({ cwd, baseRef: options.baseRef });
+    if (!baseRef) {
+        return {
+            state: 'unavailable',
+            reason: BASE_REF_UNAVAILABLE_REASON,
+            headRef,
+        };
+    }
+    const baseDoc = await readJsonFileAtRef({ cwd, ref: baseRef, filePath: CLI_PACKAGE_JSON_PATH });
+    const headDoc = await readJsonFileAtRef({ cwd, ref: headRef, filePath: CLI_PACKAGE_JSON_PATH });
+    if (isErrorRefResult(headDoc)) {
+        return {
+            state: 'unavailable',
+            reason: headDoc.reason,
+            baseRef,
+            headRef,
+        };
+    }
+    if (isErrorRefResult(baseDoc)) {
+        return {
+            state: 'unavailable',
+            reason: baseDoc.reason,
+            baseRef,
+            headRef,
+        };
+    }
+    // R-006: Base path missing and head exists means the CLI package file is newly introduced.
+    if (isMissingRefResult(baseDoc) && headDoc.ok) {
+        return {
+            state: 'changed',
+            reason: `${CLI_PACKAGE_JSON_PATH} does not exist at ${baseRef} but exists at ${headRef}.`,
+            baseRef,
+            headRef,
+        };
+    }
+    // File removed is also a change.
+    if (baseDoc.ok && isMissingRefResult(headDoc)) {
+        return {
+            state: 'changed',
+            reason: `${CLI_PACKAGE_JSON_PATH} exists at ${baseRef} but not at ${headRef}.`,
+            baseRef,
+            headRef,
+        };
+    }
+    if (isMissingRefResult(baseDoc) && isMissingRefResult(headDoc)) {
+        return {
+            state: 'unavailable',
+            reason: `${CLI_PACKAGE_JSON_PATH} is missing at both ${baseRef} and ${headRef}.`,
+            baseRef,
+            headRef,
+        };
+    }
+    if (!baseDoc.ok || !headDoc.ok) {
+        return {
+            state: 'unavailable',
+            reason: 'Unable to resolve package.json state at base/head refs.',
+            baseRef,
+            headRef,
+        };
+    }
+    const baseBin = baseDoc.value.bin;
+    const headBin = headDoc.value.bin;
+    return {
+        state: isDeepStrictEqual(baseBin, headBin) ? 'unchanged' : 'changed',
+        baseRef,
+        headRef,
+    };
+}
+export function createDefaultWURuleResolvers() {
+    return {
+        pathReferenceExists,
+        resolveChangedFiles,
+        resolveCliBinDiff,
+    };
+}
+//# sourceMappingURL=wu-rules-resolvers.js.map

package/dist/wu-rules-resolvers.js.map

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

package/dist/wu-schema-normalization.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file wu-schema-normalization.ts
+ * @description Schema normalization for legacy WU YAML formats (WU-2004)
+ *
+ * Handles migration of legacy fields to current schema:
+ * - summary → description
+ * - string risks → array
+ * - test_paths → tests
+ * - ISO/Date created → YYYY-MM-DD
+ * - Removes deprecated fields: owner, context
+ */
+/**
+ * Normalize a WU schema object, converting legacy formats to current schema.
+ * @param {Object} wu - Raw WU object (from YAML parse)
+ * @returns {Object} Normalized WU object
+ */
+export declare function normalizeWUSchema(wu: UnsafeAny): any;
+//# sourceMappingURL=wu-schema-normalization.d.ts.map

package/dist/wu-schema-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-schema-normalization.d.ts","sourceRoot":"","sources":["../src/wu-schema-normalization.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,SAAS,OAwE9C"}

package/dist/wu-schema-normalization.js

@@ -0,0 +1,87 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file wu-schema-normalization.ts
+ * @description Schema normalization for legacy WU YAML formats (WU-2004)
+ *
+ * Handles migration of legacy fields to current schema:
+ * - summary → description
+ * - string risks → array
+ * - test_paths → tests
+ * - ISO/Date created → YYYY-MM-DD
+ * - Removes deprecated fields: owner, context
+ */
+/**
+ * Normalize a WU schema object, converting legacy formats to current schema.
+ * @param {Object} wu - Raw WU object (from YAML parse)
+ * @returns {Object} Normalized WU object
+ */
+export function normalizeWUSchema(wu) {
+    const result = { ...wu };
+    // 1. summary → description migration
+    if (result.summary && !result.description) {
+        result.description = result.summary;
+    }
+    delete result.summary;
+    // 2. context → append to description
+    if (result.context) {
+        if (result.description) {
+            result.description = `${result.description}\n\n${result.context}`;
+        }
+        else {
+            result.description = result.context;
+        }
+        delete result.context;
+    }
+    // 3. risks string → array conversion
+    if (typeof result.risks === 'string') {
+        result.risks = result.risks
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean);
+    }
+    // 4. test_paths → tests migration
+    if (result.test_paths && !result.tests) {
+        result.tests = {};
+        for (const [key, value] of Object.entries(result.test_paths)) {
+            if (Array.isArray(value)) {
+                result.tests[key] = value.map((item) => {
+                    // js-yaml parses "Key: Value" as { Key: 'Value' } object
+                    if (typeof item === 'object' && item !== null) {
+                        // Convert { 'Manual test': 'Navigate to /settings' } → 'Manual test: Navigate to /settings'
+                        const entries = Object.entries(item);
+                        if (entries.length === 1) {
+                            const entry = entries[0];
+                            if (entry) {
+                                const [k, v] = entry;
+                                return `${k}: ${v}`;
+                            }
+                        }
+                    }
+                    return item;
+                });
+            }
+            else {
+                result.tests[key] = value;
+            }
+        }
+    }
+    delete result.test_paths;
+    // 5. created date normalization
+    if (result.created) {
+        if (result.created instanceof Date) {
+            result.created = result.created.toISOString().slice(0, 10);
+        }
+        else if (typeof result.created === 'string') {
+            // ISO timestamp → YYYY-MM-DD
+            const isoMatch = result.created.match(/^(\d{4}-\d{2}-\d{2})/);
+            if (isoMatch) {
+                result.created = isoMatch[1];
+            }
+        }
+    }
+    // 6. Remove deprecated fields
+    delete result.owner;
+    return result;
+}
+//# sourceMappingURL=wu-schema-normalization.js.map

package/dist/wu-schema-normalization.js.map

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