@lumenflow/core 4.24.0 → 5.0.1

package/dist/wu-yaml.d.ts

@@ -1,114 +1,3 @@
 /// <reference path="./types.d.ts" />
-/**
- * WU-1352: Standardized YAML stringify options.
- *
- * Ensures consistent output across all WU tools:
- * - lineWidth: 100 (wrap long lines)
- * - singleQuote: true (prefer 'single' over "double")
- * - defaultKeyType: PLAIN (unquoted keys when safe)
- *
- * @type {import('yaml').ToStringOptions}
- */
-export declare const YAML_STRINGIFY_OPTIONS: Readonly<{
-    lineWidth: 100;
-    singleQuote: true;
-    defaultKeyType: "PLAIN";
-}>;
-/**
- * Read and parse WU YAML file.
- *
- * Validates:
- * - File exists
- * - YAML is valid
- * - WU ID matches expected ID
- *
- * @param {string} wuPath - Path to WU YAML file
- * @param {string} expectedId - Expected WU ID (e.g., 'WU-123')
- * @returns {object} Parsed YAML document
- * @throws {Error} If file not found, YAML invalid, or ID mismatch
- */
-export declare function readWU(wuPath: string, expectedId: string): Record<string, unknown>;
-/**
- * Read and parse WU YAML file asynchronously.
- *
- * Validates:
- * - File exists
- * - YAML is valid
- * - WU ID matches expected ID
- *
- * @param {string} wuPath - Path to WU YAML file
- * @param {string} expectedId - Expected WU ID (e.g., 'WU-123')
- * @returns {Promise<object>} Parsed YAML document
- * @throws {Error} If file not found, YAML invalid, or ID mismatch
- */
-export declare function readWUAsync(wuPath: string, expectedId: string): Promise<Record<string, unknown>>;
-/**
- * Parse YAML string to object.
- * WU-1352: Centralized YAML parsing for consistency.
- *
- * @param {string} text - YAML string to parse
- * @returns {object} Parsed object
- * @throws {Error} If YAML is invalid
- */
-export declare function parseYAML(text: string): Record<string, unknown>;
-/**
- * Stringify object to YAML with standardized options.
- * WU-1352: Centralized YAML serialization for consistency.
- *
- * @param {object} doc - Object to stringify
- * @param {object} [options] - Additional stringify options (merged with YAML_STRINGIFY_OPTIONS)
- * @returns {string} YAML string
- */
-export declare function stringifyYAML(doc: unknown, options?: Record<string, unknown>): string;
-/**
- * Read and parse YAML file without ID validation.
- * WU-1352: For cases where you don't know/need to validate the WU ID.
- *
- * @param {string} yamlPath - Path to YAML file
- * @returns {object} Parsed YAML document
- * @throws {Error} If file not found or YAML invalid
- */
-export declare function readWURaw(yamlPath: string): Record<string, unknown>;
-/**
- * Read and parse YAML file without ID validation asynchronously.
- * WU-1352: For cases where you don't know/need to validate the WU ID.
- *
- * @param {string} yamlPath - Path to YAML file
- * @returns {Promise<object>} Parsed YAML document
- * @throws {Error} If file not found or YAML invalid
- */
-export declare function readWURawAsync(yamlPath: string): Promise<Record<string, unknown>>;
-/**
- * Write WU YAML file with consistent formatting.
- * WU-1352: Uses YAML_STRINGIFY_OPTIONS for consistent output.
- * WU-2115: Validates doc against BaseWUSchema before writing to prevent
- * malformed WU YAML from being silently persisted.
- *
- * @param {string} wuPath - Path to WU YAML file
- * @param {object} doc - YAML document to write
- * @throws {ZodError} If doc fails BaseWUSchema validation
- */
-export declare function writeWU(wuPath: string, doc: unknown): void;
-/**
- * Append note to WU document's notes field.
- *
- * Always outputs a string (Zod schema requires string type).
- * Handles various input formats:
- * - undefined/null/empty: Set note directly as string
- * - string: Append with newline separator
- * - array: Convert to newline-separated string, then append
- * - other: Replace with note
- *
- * @param {object} doc - WU document
- * @param {string} note - Note to append
- */
-export declare function appendNote(doc: Record<string, unknown>, note: string): void;
-/**
- * Append an agent session entry to a WU's agent_sessions[] array
- *
- * @param {string} wuId - WU ID (e.g., "WU-1234")
- * @param {object} sessionData - Session summary from endSession()
- * @throws {Error} if WU file not found
- */
-export declare function appendAgentSession(wuId: string, sessionData: Record<string, unknown>): void;
+export * from '@lumenflow/packs-software-delivery/state/wu-yaml';
 //# sourceMappingURL=wu-yaml.d.ts.map

package/dist/wu-yaml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wu-yaml.d.ts","sourceRoot":"","sources":["../src/wu-yaml.ts"],"names":[],"mappings":"AAgEA;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAC;AA8CH;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWlF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAelC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAEzF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASnE;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAavF;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAK1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAqB3E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAqB3F"}
+{"version":3,"file":"wu-yaml.d.ts","sourceRoot":"","sources":["../src/wu-yaml.ts"],"names":[],"mappings":"AAMA,cAAc,kDAAkD,CAAC"}

package/dist/wu-yaml.js

@@ -1,307 +1,7 @@
 // Copyright (c) 2026 Hellmai Ltd
 // SPDX-License-Identifier: AGPL-3.0-only
-import { existsSync, readFileSync, writeFileSync, promises as fs } from 'node:fs';
-import { parse, stringify } from 'yaml';
-import { createError, ErrorCodes, getErrorMessage } from './error-handler.js';
-import { STRING_LITERALS } from './wu-constants.js';
-import { createWuPaths } from './wu-paths.js';
-import { BaseWUSchema } from './wu-schema.js';
-/**
- * Unified WU YAML I/O module.
- *
- * Replaces 4 duplicate read/write functions scattered across wu-claim, wu-done,
- * wu-block, and wu-unblock. Single source of truth for WU YAML operations.
- *
- * WU-1352: Standardized on yaml v2.8.1 (eemeli) with consistent stringify options.
- *
- * Functions:
- * - readWU(path, id): Read and validate WU YAML
- * - readWURaw(path): Read YAML without ID validation
- * - parseYAML(text): Parse YAML string to object
- * - writeWU(path, doc): Write WU YAML with consistent formatting
- * - stringifyYAML(doc): Stringify object to YAML with consistent formatting
- * - appendNote(doc, note): Append note to doc.notes field
- *
- * @example
- * import { readWU, writeWU, appendNote } from './lib/wu-yaml.js';
- * import { createWuPaths } from './wu-paths.js';
- *
- * const wuPaths = createWuPaths();
- *
- * // Read WU
- * const doc = readWU(wuPaths.WU('WU-123'), 'WU-123');
- *
- * // Modify doc
- * doc.status = 'in_progress';
- * appendNote(doc, 'Started work on this WU');
- *
- * // Write back
- * writeWU(wuPaths.WU('WU-123'), doc);
- */
-/**
- * WU-1352: YAML scalar type constants (from yaml library).
- * These match the string values expected by the yaml package.
- * @see https://github.com/eemeli/yaml/blob/main/docs/03_options.md
- */
-const YAML_SCALAR_TYPES = Object.freeze({
-    /** Unquoted string (when safe) */
-    PLAIN: 'PLAIN',
-    /** Single-quoted string */
-    QUOTE_SINGLE: 'QUOTE_SINGLE',
-    /** Double-quoted string */
-    QUOTE_DOUBLE: 'QUOTE_DOUBLE',
-    /** Block literal (|) */
-    BLOCK_LITERAL: 'BLOCK_LITERAL',
-    /** Block folded (>) */
-    BLOCK_FOLDED: 'BLOCK_FOLDED',
-});
-/** Standard line width for WU YAML files */
-const YAML_LINE_WIDTH = 100;
-/**
- * WU-1352: Standardized YAML stringify options.
- *
- * Ensures consistent output across all WU tools:
- * - lineWidth: 100 (wrap long lines)
- * - singleQuote: true (prefer 'single' over "double")
- * - defaultKeyType: PLAIN (unquoted keys when safe)
- *
- * @type {import('yaml').ToStringOptions}
- */
-export const YAML_STRINGIFY_OPTIONS = Object.freeze({
-    lineWidth: YAML_LINE_WIDTH,
-    singleQuote: true,
-    defaultKeyType: YAML_SCALAR_TYPES.PLAIN,
-});
-/**
- * WU-2125: Parse YAML content string into a validated object.
- *
- * Shared parse boundary for all read functions. Wraps YAML parse errors
- * with structured error codes and path context.
- *
- * @param {string} text - Raw YAML content
- * @param {string} sourcePath - File path (for error messages)
- * @returns {Record<string, unknown>} Parsed document
- * @throws {Error} YAML_PARSE_ERROR if YAML is invalid
- */
-function parseWUYaml(text, sourcePath) {
-    try {
-        return parse(text);
-    }
-    catch (e) {
-        const msg = getErrorMessage(e);
-        throw createError(ErrorCodes.YAML_PARSE_ERROR, `Failed to parse YAML ${sourcePath}: ${msg}`, {
-            path: sourcePath,
-            originalError: msg,
-        });
-    }
-}
-/**
- * WU-2125: Validate that a parsed WU document's id field matches the expected ID.
- *
- * @param {unknown} doc - Parsed YAML document (may be null for empty files)
- * @param {string} expectedId - Expected WU ID (e.g., 'WU-123')
- * @param {string} wuPath - File path (for error messages)
- * @returns {Record<string, unknown>} Validated document
- * @throws {Error} WU_NOT_FOUND if doc is null or ID does not match
- */
-function validateWUId(doc, expectedId, wuPath) {
-    const parsed = doc;
-    if (!parsed || parsed.id !== expectedId) {
-        throw createError(ErrorCodes.WU_NOT_FOUND, `WU YAML id mismatch. Expected ${expectedId}, found ${parsed && parsed.id}`, { path: wuPath, expectedId, foundId: parsed && parsed.id });
-    }
-    return parsed;
-}
-/**
- * Read and parse WU YAML file.
- *
- * Validates:
- * - File exists
- * - YAML is valid
- * - WU ID matches expected ID
- *
- * @param {string} wuPath - Path to WU YAML file
- * @param {string} expectedId - Expected WU ID (e.g., 'WU-123')
- * @returns {object} Parsed YAML document
- * @throws {Error} If file not found, YAML invalid, or ID mismatch
- */
-export function readWU(wuPath, expectedId) {
-    if (!existsSync(wuPath)) {
-        throw createError(ErrorCodes.FILE_NOT_FOUND, `WU file not found: ${wuPath}`, {
-            path: wuPath,
-            expectedId,
-        });
-    }
-    const text = readFileSync(wuPath, { encoding: 'utf-8' });
-    const doc = parseWUYaml(text, wuPath);
-    return validateWUId(doc, expectedId, wuPath);
-}
-/**
- * Read and parse WU YAML file asynchronously.
- *
- * Validates:
- * - File exists
- * - YAML is valid
- * - WU ID matches expected ID
- *
- * @param {string} wuPath - Path to WU YAML file
- * @param {string} expectedId - Expected WU ID (e.g., 'WU-123')
- * @returns {Promise<object>} Parsed YAML document
- * @throws {Error} If file not found, YAML invalid, or ID mismatch
- */
-export async function readWUAsync(wuPath, expectedId) {
-    try {
-        const text = await fs.readFile(wuPath, { encoding: 'utf-8' });
-        const doc = parseWUYaml(text, wuPath);
-        return validateWUId(doc, expectedId, wuPath);
-    }
-    catch (err) {
-        const errObj = err;
-        if (errObj.code === 'ENOENT') {
-            throw createError(ErrorCodes.FILE_NOT_FOUND, `WU file not found: ${wuPath}`, {
-                path: wuPath,
-                expectedId,
-            });
-        }
-        throw err;
-    }
-}
-/**
- * Parse YAML string to object.
- * WU-1352: Centralized YAML parsing for consistency.
- *
- * @param {string} text - YAML string to parse
- * @returns {object} Parsed object
- * @throws {Error} If YAML is invalid
- */
-export function parseYAML(text) {
-    return parse(text);
-}
-/**
- * Stringify object to YAML with standardized options.
- * WU-1352: Centralized YAML serialization for consistency.
- *
- * @param {object} doc - Object to stringify
- * @param {object} [options] - Additional stringify options (merged with YAML_STRINGIFY_OPTIONS)
- * @returns {string} YAML string
- */
-export function stringifyYAML(doc, options = {}) {
-    return stringify(doc, { ...YAML_STRINGIFY_OPTIONS, ...options });
-}
-/**
- * Read and parse YAML file without ID validation.
- * WU-1352: For cases where you don't know/need to validate the WU ID.
- *
- * @param {string} yamlPath - Path to YAML file
- * @returns {object} Parsed YAML document
- * @throws {Error} If file not found or YAML invalid
- */
-export function readWURaw(yamlPath) {
-    if (!existsSync(yamlPath)) {
-        throw createError(ErrorCodes.FILE_NOT_FOUND, `YAML file not found: ${yamlPath}`, {
-            path: yamlPath,
-        });
-    }
-    const text = readFileSync(yamlPath, { encoding: 'utf-8' });
-    return parseWUYaml(text, yamlPath);
-}
-/**
- * Read and parse YAML file without ID validation asynchronously.
- * WU-1352: For cases where you don't know/need to validate the WU ID.
- *
- * @param {string} yamlPath - Path to YAML file
- * @returns {Promise<object>} Parsed YAML document
- * @throws {Error} If file not found or YAML invalid
- */
-export async function readWURawAsync(yamlPath) {
-    try {
-        const text = await fs.readFile(yamlPath, { encoding: 'utf-8' });
-        return parseWUYaml(text, yamlPath);
-    }
-    catch (err) {
-        const errObj = err;
-        if (errObj.code === 'ENOENT') {
-            throw createError(ErrorCodes.FILE_NOT_FOUND, `YAML file not found: ${yamlPath}`, {
-                path: yamlPath,
-            });
-        }
-        throw err;
-    }
-}
-/**
- * Write WU YAML file with consistent formatting.
- * WU-1352: Uses YAML_STRINGIFY_OPTIONS for consistent output.
- * WU-2115: Validates doc against BaseWUSchema before writing to prevent
- * malformed WU YAML from being silently persisted.
- *
- * @param {string} wuPath - Path to WU YAML file
- * @param {object} doc - YAML document to write
- * @throws {ZodError} If doc fails BaseWUSchema validation
- */
-export function writeWU(wuPath, doc) {
-    // WU-2115: Validate against schema before writing — throws ZodError on invalid data
-    BaseWUSchema.parse(doc);
-    const out = stringify(doc, YAML_STRINGIFY_OPTIONS);
-    writeFileSync(wuPath, out, { encoding: 'utf-8' });
-}
-/**
- * Append note to WU document's notes field.
- *
- * Always outputs a string (Zod schema requires string type).
- * Handles various input formats:
- * - undefined/null/empty: Set note directly as string
- * - string: Append with newline separator
- * - array: Convert to newline-separated string, then append
- * - other: Replace with note
- *
- * @param {object} doc - WU document
- * @param {string} note - Note to append
- */
-export function appendNote(doc, note) {
-    // Do nothing if note is falsy
-    if (!note)
-        return;
-    const existing = doc.notes;
-    if (existing === undefined || existing === null || existing === '') {
-        // No existing notes: set directly as string
-        doc.notes = note;
-    }
-    else if (Array.isArray(existing)) {
-        // Array notes: convert to string first (schema requires string), then append
-        const joined = existing.filter(Boolean).join(STRING_LITERALS.NEWLINE).trimEnd();
-        doc.notes = joined ? `${joined}${STRING_LITERALS.NEWLINE}${note}` : note;
-    }
-    else if (typeof existing === 'string') {
-        // String notes: append with newline
-        const trimmed = existing.trimEnd();
-        doc.notes = trimmed ? `${trimmed}${STRING_LITERALS.NEWLINE}${note}` : note;
-    }
-    else {
-        // Invalid type: replace with note
-        doc.notes = note;
-    }
-}
-/**
- * Append an agent session entry to a WU's agent_sessions[] array
- *
- * @param {string} wuId - WU ID (e.g., "WU-1234")
- * @param {object} sessionData - Session summary from endSession()
- * @throws {Error} if WU file not found
- */
-export function appendAgentSession(wuId, sessionData) {
-    const paths = createWuPaths();
-    const wuPath = paths.WU(wuId);
-    if (!existsSync(wuPath)) {
-        throw createError(ErrorCodes.FILE_NOT_FOUND, `WU file not found: ${wuPath}`);
-    }
-    // Parse WU YAML
-    const doc = readWU(wuPath, wuId);
-    // Initialize agent_sessions array if needed
-    if (!Array.isArray(doc.agent_sessions)) {
-        doc.agent_sessions = [];
-    }
-    // Append session
-    doc.agent_sessions.push(sessionData);
-    // Write back
-    writeWU(wuPath, doc);
-}
+// WU-2689 (INIT-058 L4): Shim — real module lives in @lumenflow/packs-software-delivery.
+// Re-export preserves the `@lumenflow/core/wu-yaml` subpath for existing consumers
+// until Layer 7 removes the shim.
+export * from '@lumenflow/packs-software-delivery/state/wu-yaml';
 //# sourceMappingURL=wu-yaml.js.map

package/dist/wu-yaml.js.map

@@ -1 +1 @@
-{"version":3,"file":"wu-yaml.js","sourceRoot":"","sources":["../src/wu-yaml.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wu-yaml.js","sourceRoot":"","sources":["../src/wu-yaml.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,yFAAyF;AACzF,mFAAmF;AACnF,kCAAkC;AAClC,cAAc,kDAAkD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "4.24.0",
+  "version": "5.0.1",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -110,13 +110,10 @@
     "./context/index": "./dist/context/index.js",
     "./context/location-resolver": "./dist/context/location-resolver.js",
     "./core/worktree-guard": "./dist/core/worktree-guard.js",
-    "./coverage-gate": "./dist/coverage-gate.js",
     "./dependency-graph": "./dist/dependency-graph.js",
     "./dependency-validator": "./dist/dependency-validator.js",
     "./docs-path-validator": "./dist/docs-path-validator.js",
     "./domain/orchestration.constants": "./dist/domain/orchestration.constants.js",
-    "./gates-agent-mode": "./dist/gates-agent-mode.js",
-    "./gates-config": "./dist/gates-config.js",
     "./generate-traceability": "./dist/generate-traceability.js",
     "./hardcoded-strings": "./dist/hardcoded-strings.js",
     "./git-context-extractor": "./dist/git-context-extractor.js",
@@ -137,7 +134,6 @@
     "./prompt-linter": "./dist/prompt-linter.js",
     "./rebase-artifact-cleanup": "./dist/rebase-artifact-cleanup.js",
     "./recovery/recovery-analyzer": "./dist/recovery/recovery-analyzer.js",
-    "./resolve-policy": "./dist/resolve-policy.js",
     "./rollback-utils": "./dist/rollback-utils.js",
     "./schemas/memory-arg-validators": "./dist/schemas/memory-arg-validators.js",
     "./spawn-strategy": "./dist/spawn-strategy.js",
@@ -154,6 +150,7 @@
     "./validators/claim-validation": "./dist/validators/claim-validation.js",
     "./validators/supabase-docs-linter": "./dist/validators/supabase-docs-linter.js",
     "./validators/wu-tasks": "./dist/validators/wu-tasks.js",
+    "./integration-target": "./dist/integration-target.js",
     "./worktree-symlink": "./dist/worktree-symlink.js",
     "./wu-checkpoint": "./dist/wu-checkpoint.js",
     "./wu-claim-resume": "./dist/wu-claim-resume.js",
@@ -193,7 +190,9 @@
     "./wu-validation-constants": "./dist/wu-validation-constants.js",
     "./wu-validator": "./dist/wu-validator.js",
     "./wu-yaml-fixer": "./dist/wu-yaml-fixer.js",
-    "./normalize-config-keys": "./dist/normalize-config-keys.js"
+    "./normalize-config-keys": "./dist/normalize-config-keys.js",
+    "./env-accessors": "./dist/env-accessors.js",
+    "./delivery-review-contract": "./dist/delivery-review-contract.js"
   },
   "main": "./dist/index.js",
   "bin": {
@@ -226,7 +225,11 @@
     "tiktoken": "^1.0.21",
     "xstate": "^5.28.0",
     "yaml": "^2.8.2",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "@lumenflow/packs-agent-runtime": "^5.0.1",
+    "@lumenflow/kernel": "5.0.1",
+    "@lumenflow/host": "^5.0.0-alpha.0",
+    "@lumenflow/packs-software-delivery": "^5.0.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",
@@ -236,7 +239,7 @@
     "vitest": "^4.0.18"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "4.24.0"
+    "@lumenflow/memory": "5.0.1"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {
@@ -255,7 +258,7 @@
     "pack:dist": "pnpm pack",
     "clean": "rm -rf dist *.tgz",
     "test": "vitest run",
-    "lint": "eslint src --quiet --rule no-console:off --rule @typescript-eslint/no-unused-vars:off --rule sonarjs/concise-regex:off",
+    "lint": "NODE_OPTIONS=--max-old-space-size=8192 eslint src --quiet --rule no-console:off --rule @typescript-eslint/no-unused-vars:off --rule sonarjs/concise-regex:off",
     "typecheck": "tsc --noEmit"
   }
 }

package/dist/coverage-gate.d.ts

@@ -1,128 +0,0 @@
-#!/usr/bin/env node
-/// <reference path="./types.d.ts" />
-/**
- * Coverage Gate for Quality Gates
- *
- * WU-1433: Adds coverage checking to gates with configurable mode (warn/block).
- * Enforces ≥90% coverage on hex core files (application layer).
- *
- * Mode flag allows gradual rollout:
- * - warn: Log failures but don't block (default)
- * - block: Fail the gate if thresholds not met
- *
- * @see {@link packages/@lumenflow/cli/src/gates.ts} - Integration point
- * @see {@link vitest.config.ts} - Coverage thresholds
- */
-/**
- * Coverage gate modes
- * @constant
- */
-export declare const COVERAGE_GATE_MODES: Readonly<{
-    /** Log warnings but don't fail the gate */
-    WARN: "warn";
-    /** Fail the gate if thresholds not met */
-    BLOCK: "block";
-}>;
-/**
- * Glob patterns for hex core files that require ≥90% coverage.
- * These are the critical application layer files.
- *
- * WU-1068: Changed from @exampleapp to @lumenflow for framework reusability.
- * Project-specific patterns should be configured in workspace.yaml.
- *
- * @constant {string[]}
- */
-export declare const HEX_CORE_PATTERNS: readonly string[];
-/**
- * Default coverage threshold for hex core files (percentage)
- * WU-1262: Kept for backwards compatibility.
- * WU-2044: Now delegates to DEFAULT_MIN_COVERAGE from gate-constants.ts (DRY).
- * The actual threshold is determined by resolveCoverageConfig() based on methodology.
- * @constant {number}
- */
-export declare const COVERAGE_THRESHOLD = 90;
-/**
- * Default path to coverage summary JSON
- * @constant {string}
- */
-export declare const DEFAULT_COVERAGE_PATH = "coverage/coverage-summary.json";
-/**
- * Check if a file path is in the hex core layer.
- *
- * WU-2448: Coverage reporters may emit absolute paths (e.g., <repo-root>/packages/...)
- * or file:// URLs; use substring matching so hex-core checks still apply.
- *
- * @param {string|null|undefined} filePath - File path to check
- * @returns {boolean} True if file is in hex core layer
- */
-export declare function isHexCoreFile(filePath: UnsafeAny): boolean;
-/**
- * Parse coverage JSON file.
- *
- * @param {string} coveragePath - Path to coverage-summary.json
- * @returns {object|null} Parsed coverage data or null if invalid
- */
-export declare function parseCoverageJson(coveragePath: UnsafeAny): {
-    total: any;
-    files: Record<string, unknown>;
-} | null;
-/**
- * Check if coverage meets thresholds for hex core files.
- *
- * @param {object|null} coverageData - Parsed coverage data
- * @param {number} [threshold] - Coverage threshold to use (defaults to COVERAGE_THRESHOLD)
- * @returns {{ pass: boolean, failures: Array<{ file: string, actual: number, threshold: number, metric: string }> }}
- */
-export declare function checkCoverageThresholds(coverageData: UnsafeAny, threshold?: number): {
-    pass: boolean;
-    failures: {
-        file: string;
-        actual: number;
-        threshold: number;
-        metric: string;
-    }[];
-};
-/**
- * Format coverage data for display.
- *
- * @param {object|null} coverageData - Parsed coverage data
- * @returns {string} Formatted output string
- */
-export declare function formatCoverageDelta(coverageData: UnsafeAny): string;
-/**
- * Logger interface for coverage gate output
- */
-interface CoverageGateLogger {
-    log: (...args: unknown[]) => void;
-}
-/**
- * Options for running coverage gate
- */
-export interface CoverageGateOptions {
-    /** Gate mode ('warn' or 'block') */
-    mode?: string;
-    /** Path to coverage JSON */
-    coveragePath?: string;
-    /** Logger for output */
-    logger?: CoverageGateLogger;
-    /**
-     * WU-1262: Coverage threshold override (0-100).
-     * When provided, overrides the default COVERAGE_THRESHOLD constant.
-     * This is typically populated from resolveCoverageConfig().
-     */
-    threshold?: number;
-}
-/**
- * Run coverage gate.
- *
- * @param {CoverageGateOptions} options - Gate options
- * @returns {Promise<{ ok: boolean, mode: string, duration: number, message: string }>}
- */
-export declare function runCoverageGate(options?: CoverageGateOptions): Promise<{
-    ok: boolean;
-    mode: string;
-    duration: number;
-    message: string;
-}>;
-export {};
-//# sourceMappingURL=coverage-gate.d.ts.map

package/dist/coverage-gate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"coverage-gate.d.ts","sourceRoot":"","sources":["../src/coverage-gate.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;GAYG;AAOH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,2CAA2C;;IAE3C,0CAA0C;;EAE1C,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,mBAG5B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,KAAuB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mCAAmC,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,WAQhD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,SAAS;;;SAuBxD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;;;;EA+BlF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,SAAS,UA6B1D;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,mBAAwB;;;;;GAiDtE"}