@lumenflow/core 3.2.0 → 3.2.1

package/dist/incremental-test.js

@@ -0,0 +1,64 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file incremental-test.ts
+ * @description Helpers for Vitest --changed execution
+ *
+ * WU-1920: Add incremental test execution to gates
+ * WU-2504: Use Vitest --changed instead of custom file diff logic
+ */
+import { GIT_REFS } from './wu-constants.js';
+/**
+ * Glob patterns to exclude slow integration/golden tests from changed runs.
+ * @type {string[]}
+ */
+export const VITEST_CHANGED_EXCLUDES = Object.freeze(['**/*.integration.*', '**/golden-*.test.*']);
+/**
+ * File extensions considered executable code for test runs.
+ * @type {string[]}
+ */
+export const CODE_FILE_EXTENSIONS = Object.freeze([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.js',
+    '.cjs',
+    '.mts',
+    '.cts',
+]);
+/**
+ * Check if a path points to a code file that should trigger full tests.
+ *
+ * @param {string} filePath - Path to check
+ * @returns {boolean} True if the path has a code extension
+ */
+export function isCodeFilePath(filePath) {
+    if (!filePath || typeof filePath !== 'string') {
+        return false;
+    }
+    const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+    return CODE_FILE_EXTENSIONS.some((ext) => normalized.endsWith(ext));
+}
+/**
+ * Build Vitest CLI args for --changed runs.
+ *
+ * @param {BuildVitestChangedArgsOptions} [options]
+ * @returns {string[]} Vitest args for changed test runs
+ */
+export function buildVitestChangedArgs(options = {}) {
+    const { baseBranch = GIT_REFS.ORIGIN_MAIN } = options;
+    const args = [
+        '--changed',
+        baseBranch,
+        '--run',
+        '--passWithNoTests',
+        '--maxWorkers=1',
+        '--teardownTimeout=30000',
+    ];
+    for (const pattern of VITEST_CHANGED_EXCLUDES) {
+        args.push(`--exclude='${pattern}'`);
+    }
+    return args;
+}
+//# sourceMappingURL=incremental-test.js.map

package/dist/incremental-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-test.js","sourceRoot":"","sources":["../src/incremental-test.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmB;IAChD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAyC,EAAE;IAChF,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,IAAI,GAAG;QACX,WAAW;QACX,UAAU;QACV,OAAO;QACP,mBAAmB;QACnB,gBAAgB;QAChB,yBAAyB;KAC1B,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,uBAAuB,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,cAAc,OAAO,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @lumenflow/core - Battle-tested LumenFlow workflow framework
+ * @module @lumenflow/core
+ */
+export declare const VERSION = "0.0.0";
+export * from './arg-parser.js';
+export * from './date-utils.js';
+export * from './error-handler.js';
+export * from './retry-strategy.js';
+export * from './sandbox-allowlist.js';
+export * from './sandbox-profile.js';
+export * from './sandbox-backend-linux.js';
+export * from './sandbox-backend-macos.js';
+export * from './sandbox-backend-windows.js';
+export * from './cycle-detector.js';
+export { DEFAULT_DOMAIN, inferDefaultDomain, normalizeToEmail, isValidEmail, } from './user-normalizer.js';
+export * from './git-adapter.js';
+export * from './state-machine.js';
+export { WU_EVENT_TYPES, WU_STATUSES, WU_PATTERNS, CreateEventSchema, ClaimEventSchema, BlockEventSchema, UnblockEventSchema, CompleteEventSchema, CheckpointEventSchema, WUEventSchema, validateWUEvent, DelegationEventSchema as WUDelegationEventSchema, type CreateEvent, type ClaimEvent, type BlockEvent, type UnblockEvent, type CompleteEvent, type CheckpointEvent, type WUEvent, type DelegationEvent as WUDelegationEvent, } from './wu-state-schema.js';
+export { WU_EVENTS_FILE_NAME, WUStateStore, acquireLock, releaseLock, repairStateFile, isLockStale as isWULockStale, type WUStateEntry, type LockData as WULockData, type CheckpointOptions, type RepairResult, } from './wu-state-store.js';
+export { createWUStateStore } from './wu-state-store.js';
+export * from './lane-checker.js';
+export * from './lane-inference.js';
+export { getStaleThresholdMs, getLocksDir, getLockFilePath, isLockStale, isZombieLock, readLockMetadata, acquireLaneLock, releaseLaneLock, checkLaneLock, forceRemoveStaleLock, getAllLaneLocks, auditedUnlock, } from './lane-lock.js';
+export * from './lane-validator.js';
+export * from './wu-yaml.js';
+export { getAssignedEmail } from './wu-claim-helpers.js';
+export * from './wu-done-worktree.js';
+export * from './wu-done-worktree-services.js';
+export * from './wu-done-validators.js';
+export * from './wu-done-concurrent-merge.js';
+export * from './wu-helpers.js';
+export * from './wu-schema.js';
+export * from './wu-validator.js';
+export * from './wu-rules-engine.js';
+export * from './delegation-registry-store.js';
+export * from './delegation-registry-schema.js';
+export * from './delegation-tree.js';
+export * from './delegation-recovery.js';
+export * from './delegation-monitor.js';
+export * from './delegation-escalation.js';
+export { SPAWN_SENTINEL, SPAWN_PROMPT_VERSION, SpawnPromptSchema, computeChecksum, createSpawnPrompt, validateSpawnPrompt, parseSpawnPrompt, serializeSpawnPrompt, checkSentinel, type SpawnPrompt, type SpawnPromptValidationResult, type ParseResult as SpawnPromptParseResult, } from './spawn-prompt-schema.js';
+export * from './backlog-generator.js';
+export * from './backlog-parser.js';
+export * from './backlog-editor.js';
+export * from './backlog-sync-validator.js';
+export * from './validators/claim-validation.js';
+export * from './worktree-scanner.js';
+export * from './worktree-ownership.js';
+export * from './micro-worktree.js';
+export * from './atomic-merge.js';
+export { detectOrphanWorktrees, detectMissingTrackedWorktrees } from './orphan-detector.js';
+export * from './dependency-guard.js';
+export * from './stamp-utils.js';
+export * from './lumenflow-config.js';
+export * from './lumenflow-config-schema.js';
+export * from './wu-events-cleanup.js';
+export * from './state-cleanup-core.js';
+export * from './state-doctor-core.js';
+export * from './gates-config.js';
+export * from './branch-check.js';
+export * from './agent-patterns-registry.js';
+export * from './lumenflow-home.js';
+export * from './force-bypass-audit.js';
+export { LUMENFLOW_PATHS } from './wu-constants.js';
+export { WU_STATUS, DIRECTORIES } from './wu-constants.js';
+export type { NodeFsError } from './wu-constants.js';
+export { STREAM_ERRORS, EXIT_CODES } from './wu-constants.js';
+export * from './stream-error-handler.js';
+export * from './color-support.js';
+export * from './context/index.js';
+export * from './validation/index.js';
+export * from './recovery/index.js';
+export * from './context-validation-integration.js';
+export { CONTEXT_VALIDATION } from './wu-constants.js';
+export type { ValidationErrorCode, PredicateSeverity, ValidationMode } from './wu-constants.js';
+export { LUMENFLOW_CLIENT_IDS, CLAUDE_HOOKS, getHookCommand } from './wu-constants.js';
+export type { LumenflowClientId } from './wu-constants.js';
+export { LocationType } from './domain/context.schemas.js';
+export { RecoveryIssueCode, RecoveryActionType } from './domain/recovery.schemas.js';
+export type { IToolExecutor, IToolRunner } from './ports/core-tools.ports.js';
+export type { ILocationResolver, IGitStateReader, IWuStateReader } from './ports/context.ports.js';
+export type { ICommandRegistry } from './ports/validation.ports.js';
+export type { IRecoveryAnalyzer } from './ports/recovery.ports.js';
+export type { IWuGitAdapter, IWuStatusCheckResult, IBranchValidationResult, IWuYamlReader, IWuYamlWriter, IWuStateStore, IWuCheckpointManager, IWuPaths, } from './ports/wu-helpers.ports.js';
+export type { IWuEventLog, IWuLockManager, IWuStateQuery } from './ports/wu-state.ports.js';
+export type { IGitConfig, IDirectoriesConfig, IStateConfig, IPathsConfig, IGitOperationConfig, } from './ports/config.ports.js';
+export type { IGitAdapter, MergeOptions, MergeResult, PushOptions, DeleteBranchOptions, WorktreeRemoveOptions, } from './ports/git-validator.ports.js';
+export { LOCATION_TYPE_VALUES, LocationTypeSchema, LocationContextSchema, GitStateSchema, WuStateResultSchema, SessionStateSchema, WuContextSchema, } from './domain/context.schemas.js';
+export { VALIDATION_ERROR_CODE_VALUES, ValidationErrorCodeSchema, PREDICATE_SEVERITY_VALUES, PredicateSeveritySchema, ValidationErrorSchema, ValidationWarningSchema, ValidationResultSchema, CommandPredicateConfigSchema, CommandDefinitionConfigSchema, type CommandPredicateConfig, type CommandDefinitionConfig, } from './domain/validation.schemas.js';
+export { RECOVERY_ISSUE_CODE_VALUES, RecoveryIssueCodeSchema, RECOVERY_ACTION_TYPE_VALUES, RecoveryActionTypeSchema, RecoveryIssueSchema, RecoveryActionSchema, RecoveryAnalysisSchema, } from './domain/recovery.schemas.js';
+export { SimpleGitLocationAdapter, SimpleGitStateAdapter, FileSystemWuStateAdapter, CommandRegistryAdapter, RecoveryAnalyzerAdapter, } from './adapters/index.js';
+export { ComputeContextUseCase, type ComputeContextOptions, ValidateCommandUseCase, AnalyzeRecoveryUseCase, } from './usecases/index.js';
+export * from './lane-suggest-prompt.js';
+export * from './git-context-extractor.js';
+export * from './pack-authoring-template-engine.js';
+export { createContextAdapters, createValidationAdapters, createRecoveryAdapters, createComputeContextUseCase, createValidateCommandUseCase, createAnalyzeRecoveryUseCase, computeWuContext, validateCommand, analyzeRecoveryIssues, type ContextAdapters, type ValidationAdapters, type RecoveryAdapters, type CreateComputeContextOptions, type CreateValidateCommandOptions, type CreateAnalyzeRecoveryOptions, } from './context-di.js';
+export * from './wu-id-generator.js';
+export * from './test-baseline.js';
+export { loadManifest, loadTemplate, loadTemplatesWithOverrides, assembleTemplates, replaceTokens, evaluateCondition, type TemplateFrontmatter, type LoadedTemplate, type ManifestEntry, type TemplateManifest, type TemplateContext, } from './template-loader.js';
+export { tryAssembleSpawnTemplates, buildTemplateContext } from './wu-spawn.js';
+export * from './patrol-loop.js';
+export { resolvePolicy, getDefaultPolicy, MethodologyConfigSchema, MethodologyOverridesSchema, TestingMethodologySchema, ArchitectureMethodologySchema, CoverageModeSchema, WorkClassificationConfigSchema, WorkClassificationUiSchema, TESTING_METHODOLOGY, ARCHITECTURE_METHODOLOGY, COVERAGE_MODE, type ResolvedPolicy, type ResolvePolicyOptions, type MethodologyConfig, type MethodologyOverrides, type TestingMethodology, type ArchitectureMethodology, type CoverageMode, type WorkClassificationSchemaConfig, type WorkClassificationUi, } from './resolve-policy.js';
+export { listWUs, type WUListEntry, type ListWUsOptions } from './wu-list.js';
+export * from './schemas/index.js';
+export { classifyWork, WORK_DOMAINS, SIGNAL_WEIGHTS, DEFAULT_UI_CODE_PATH_PATTERNS, DEFAULT_UI_LANE_HINTS, type WorkDomain, type WorkSignal, type WorkClassification, type WorkClassificationConfig, } from './work-classifier.js';
+export { detectCloudMode, CLOUD_ACTIVATION_SOURCE, type CloudDetectInput, type CloudDetectResult, type CloudDetectConfig, type CloudEnvSignalConfig, type CloudActivationSource, } from './cloud-detect.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js.map

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

package/dist/invariants/check-automated-tests.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Invariant metadata
+ */
+export declare const INVARIANT_ID = "INV-AUTOMATED-TESTS-FOR-CODE";
+export declare const INVARIANT_TYPE = "wu-automated-tests";
+/**
+ * Run the INV-AUTOMATED-TESTS-FOR-CODE invariant check.
+ *
+ * Scans WU YAML files and validates that UnsafeAny with code files in code_paths
+ * have automated tests (unit, e2e, or integration).
+ *
+ * WU-2425: When wuId is provided, only validates that specific WU instead of
+ * all active WUs. This prevents unrelated WUs from blocking wu:done completion.
+ *
+ * @param {CheckAutomatedTestsInvariantOptions} [options={}] - Options
+ * @returns {{ valid: boolean, violations: Array<object> }} Check result
+ */
+export interface CheckAutomatedTestsInvariantOptions {
+    /** Base directory for path resolution */
+    baseDir?: string;
+    /** Specific WU ID to validate (WU-2425: scoped validation) */
+    wuId?: string;
+}
+export declare function checkAutomatedTestsInvariant(options?: CheckAutomatedTestsInvariantOptions): {
+    valid: boolean;
+    violations: {
+        id: string;
+        type: string;
+        wuId: any;
+        description: string;
+        message: string | null;
+        codeFiles: any[] | undefined;
+    }[];
+};
+/**
+ * Format a violation for display.
+ *
+ * @param {object} violation - Violation object
+ * @returns {string} Formatted error message
+ */
+export declare function formatAutomatedTestsViolation(violation: UnsafeAny): string;
+//# sourceMappingURL=check-automated-tests.d.ts.map

package/dist/invariants/check-automated-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-automated-tests.d.ts","sourceRoot":"","sources":["../../src/invariants/check-automated-tests.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,eAAO,MAAM,YAAY,iCAAiC,CAAC;AAC3D,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAkFnD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mCAAmC;IAClD,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,mCAAwC;;;;;;;;;;EAuE7F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,SAAS,UAiBjE"}

package/dist/invariants/check-automated-tests.js

@@ -0,0 +1,171 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * INV-AUTOMATED-TESTS-FOR-CODE Invariant Check (WU-2333)
+ *
+ * Validates that WUs with code files in code_paths have automated tests.
+ * Config files are excluded from this requirement.
+ *
+ * This invariant ensures that manual-only tests cannot satisfy validation
+ * for code changes, enforcing TDD discipline.
+ *
+ * Library-first check: This is custom validation logic for ExampleApp WU workflow.
+ * No external library exists for WU YAML validation - this integrates with
+ * the existing manual-test-validator.ts which already implements the core logic.
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/manual-test-validator.ts} - Core validation logic
+ * @see {@link tools/invariants.yml} - Invariant registry
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { parseYAML } from '../wu-yaml.js';
+import { validateAutomatedTestRequirement, isCodeFile } from '../manual-test-validator.js';
+import { DIRECTORIES, WU_STATUS } from '../wu-constants.js';
+/**
+ * Invariant metadata
+ */
+export const INVARIANT_ID = 'INV-AUTOMATED-TESTS-FOR-CODE';
+export const INVARIANT_TYPE = 'wu-automated-tests';
+/**
+ * WU statuses that should be validated.
+ * Only validate active work - in_progress and blocked WUs.
+ * Done, ready, and waiting WUs are either already validated or not yet being worked.
+ */
+const ACTIVE_STATUSES = Object.freeze([WU_STATUS.IN_PROGRESS, WU_STATUS.BLOCKED]);
+/**
+ * Default path to WU YAML files relative to base directory.
+ * WU-1430: Use centralized constant instead of hardcoded path.
+ */
+const WU_YAML_PATH = DIRECTORIES.WU_DIR;
+/**
+ * Check a single WU YAML file for automated test requirement.
+ *
+ * @param {string} filePath - Path to WU YAML file
+ * @param {CheckWUFileOptions} [options={}] - Options
+ * @returns {{ valid: boolean, wuId: string|null, error: string|null }} Check result
+ */
+function checkWUFile(filePath, options = {}) {
+    const { skipStatusCheck = false } = options;
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const doc = parseYAML(content);
+        if (!doc) {
+            return { valid: true, wuId: null, error: null };
+        }
+        const wuId = doc.id || path.basename(filePath, '.yaml');
+        const status = doc.status || '';
+        // WU-2425: Skip status check when validating a specific WU (e.g., during wu:done)
+        // This is needed because wu:done may set status to 'done' before validation runs
+        if (!skipStatusCheck && !ACTIVE_STATUSES.includes(status)) {
+            return { valid: true, wuId, error: null };
+        }
+        // Use the existing validation logic from manual-test-validator.ts
+        const result = validateAutomatedTestRequirement(doc);
+        if (!result.valid) {
+            return {
+                valid: false,
+                wuId,
+                error: result.errors.join('\n'),
+                codeFiles: getCodeFilesFromPaths(doc.code_paths || []),
+            };
+        }
+        return { valid: true, wuId, error: null };
+    }
+    catch {
+        // Skip files that can't be parsed
+        return { valid: true, wuId: null, error: null };
+    }
+}
+/**
+ * Get code files from code_paths (filtering out config files).
+ *
+ * @param {string[]} codePaths - Array of code paths
+ * @returns {string[]} Code files that require automated tests
+ */
+function getCodeFilesFromPaths(codePaths) {
+    if (!codePaths || !Array.isArray(codePaths)) {
+        return [];
+    }
+    return codePaths.filter((p) => isCodeFile(p));
+}
+export function checkAutomatedTestsInvariant(options = {}) {
+    const { baseDir = process.cwd(), wuId } = options;
+    const wuDir = path.join(baseDir, WU_YAML_PATH);
+    const violations = [];
+    // Check if WU directory exists
+    if (!existsSync(wuDir)) {
+        return { valid: true, violations: [] };
+    }
+    // WU-2425: If wuId is provided, only check that specific WU file
+    if (wuId) {
+        const filePath = path.join(wuDir, `${wuId}.yaml`);
+        // If the WU file doesn't exist, pass gracefully (nothing to validate)
+        if (!existsSync(filePath)) {
+            return { valid: true, violations: [] };
+        }
+        // When validating a specific WU, skip status check (validate regardless of status)
+        // This is needed because wu:done may set status to 'done' before validation runs
+        const result = checkWUFile(filePath, { skipStatusCheck: true });
+        if (!result.valid) {
+            violations.push({
+                id: INVARIANT_ID,
+                type: INVARIANT_TYPE,
+                wuId: result.wuId,
+                description: `WU ${result.wuId} has code files but no automated tests`,
+                message: result.error,
+                codeFiles: result.codeFiles,
+            });
+        }
+        return {
+            valid: violations.length === 0,
+            violations,
+        };
+    }
+    // Default behavior: check all WU files (existing behavior for gates)
+    let files;
+    try {
+        files = readdirSync(wuDir).filter((f) => f.startsWith('WU-') && (f.endsWith('.yaml') || f.endsWith('.yml')));
+    }
+    catch {
+        return { valid: true, violations: [] };
+    }
+    // Check each WU file
+    for (const file of files) {
+        const filePath = path.join(wuDir, file);
+        const result = checkWUFile(filePath);
+        if (!result.valid) {
+            violations.push({
+                id: INVARIANT_ID,
+                type: INVARIANT_TYPE,
+                wuId: result.wuId,
+                description: `WU ${result.wuId} has code files but no automated tests`,
+                message: result.error,
+                codeFiles: result.codeFiles,
+            });
+        }
+    }
+    return {
+        valid: violations.length === 0,
+        violations,
+    };
+}
+/**
+ * Format a violation for display.
+ *
+ * @param {object} violation - Violation object
+ * @returns {string} Formatted error message
+ */
+export function formatAutomatedTestsViolation(violation) {
+    const lines = [
+        `INVARIANT VIOLATION: ${violation.id}`,
+        `WU: ${violation.wuId}`,
+        `Description: ${violation.description}`,
+    ];
+    if (violation.codeFiles && violation.codeFiles.length > 0) {
+        lines.push(`Code files requiring tests: ${violation.codeFiles.join(', ')}`);
+    }
+    lines.push('');
+    lines.push('Action: Add automated tests (unit, e2e, or integration) to the tests field in the WU YAML.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=check-automated-tests.js.map

package/dist/invariants/check-automated-tests.js.map

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

package/dist/invariants-runner.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Invariant type constants
+ */
+export declare const INVARIANT_TYPES: {
+    REQUIRED_FILE: string;
+    FORBIDDEN_FILE: string;
+    MUTUAL_EXCLUSIVITY: string;
+    FORBIDDEN_PATTERN: string;
+    REQUIRED_PATTERN: string;
+    FORBIDDEN_IMPORT: string;
+    WU_AUTOMATED_TESTS: string;
+};
+interface InvariantDefinition {
+    id: string;
+    type: string;
+    description: string;
+    message?: string;
+    path?: string;
+    paths?: string[];
+    pattern?: string;
+    scope?: string[];
+    from?: string;
+    cannot_import?: string[];
+    valid?: boolean;
+    existingPaths?: string[];
+    matchingFiles?: string[];
+    patternNotFound?: boolean;
+    violatingFiles?: string[];
+    violatingImports?: Record<string, number>;
+    wuViolations?: Array<{
+        wuId: string;
+        codeFiles?: string[];
+    }>;
+    [key: string]: unknown;
+}
+interface InvariantValidationResult {
+    valid: boolean;
+    violations: InvariantDefinition[];
+}
+/**
+ * Context passed to invariant checkers during validation.
+ * Contains optional fields that specific checkers may require.
+ */
+export interface InvariantCheckerContext {
+    /** Specific WU ID for scoped validation (WU-2425) */
+    wuId?: string;
+}
+/**
+ * Strategy interface for invariant type validation (WU-2017).
+ *
+ * Each invariant type implements this interface with a `validate()` method.
+ * New invariant types can be added by implementing this interface and calling
+ * `registerInvariantChecker()` -- no modification to existing code required (OCP).
+ *
+ * @example
+ * class MyCustomChecker implements InvariantChecker {
+ *   validate(invariant, baseDir, context) {
+ *     // Return violation object if invalid, null if valid
+ *     return null;
+ *   }
+ * }
+ * registerInvariantChecker('my-custom-type', new MyCustomChecker());
+ */
+export interface InvariantChecker {
+    /**
+     * Validate an invariant against the current repo state.
+     *
+     * @param invariant - The invariant definition from invariants.yml
+     * @param baseDir - Base directory for path resolution
+     * @param context - Additional context (e.g., wuId for scoped validation)
+     * @returns Violation object if invalid, null if valid
+     */
+    validate(invariant: InvariantDefinition, baseDir: string, context?: InvariantCheckerContext): InvariantDefinition | null;
+}
+/**
+ * Register a new invariant checker for a given type (WU-2017).
+ *
+ * Adding a new invariant type requires only:
+ * 1. A class implementing InvariantChecker
+ * 2. A call to registerInvariantChecker()
+ * 3. (Optional) An entry in INVARIANT_TYPES for the type constant
+ *
+ * @param type - The invariant type string (e.g., 'required-file')
+ * @param checker - The checker implementation
+ */
+export declare function registerInvariantChecker(type: string, checker: InvariantChecker): void;
+/**
+ * Get the registered checker for an invariant type (WU-2017).
+ *
+ * @param type - The invariant type string
+ * @returns The checker or undefined if not registered
+ */
+export declare function getInvariantChecker(type: string): InvariantChecker | undefined;
+/**
+ * Custom error class for invariant violations
+ */
+export declare class InvariantError extends Error {
+    /** The invariant ID */
+    invariantId: string;
+    /**
+     * @param {string} invariantId - The invariant ID (e.g., 'INV-001')
+     * @param {string} message - Error message
+     */
+    constructor(invariantId: string, message: string);
+}
+/**
+ * Load invariants from a YAML file
+ *
+ * @param {string} filePath - Path to invariants.yml
+ * @returns {Array<object>} Array of invariant definitions
+ * @throws {Error} If file doesn't exist or has invalid YAML
+ */
+export declare function loadInvariants(filePath: string): InvariantDefinition[];
+/**
+ * Validate all invariants against the current repo state (WU-2017).
+ *
+ * Uses the checker registry to dispatch validation to the appropriate
+ * InvariantChecker implementation for each invariant type. Unknown types
+ * produce a warning but do not fail validation.
+ *
+ * WU-2425: When wuId is provided, WU-scoped invariants only validate that specific WU.
+ *
+ * @param {Array<object>} invariants - Array of invariant definitions
+ * @param {ValidateInvariantsOptions} [options={}] - Options
+ * @returns {{valid: boolean, violations: Array<object>}} Validation result
+ */
+export interface ValidateInvariantsOptions {
+    /** Base directory for path resolution */
+    baseDir?: string;
+    /** Specific WU ID for scoped validation (WU-2425) */
+    wuId?: string;
+}
+export declare function validateInvariants(invariants: InvariantDefinition[], options?: ValidateInvariantsOptions): InvariantValidationResult;
+/**
+ * Format an invariant violation for display
+ *
+ * @param {object} violation - Violation object from validateInvariants
+ * @returns {string} Formatted error message
+ */
+export declare function formatInvariantError(violation: InvariantDefinition): string;
+/**
+ * Run invariants validation and format results for gates output
+ *
+ * WU-2425: When wuId is provided, WU-scoped invariants (like automated tests)
+ * only validate that specific WU, preventing unrelated WUs from blocking wu:done.
+ *
+ * @param {RunInvariantsOptions} [options={}] - Options
+ * @returns {{success: boolean, violations: Array<object>, formatted: string}} Result
+ */
+export interface RunInvariantsOptions {
+    /** Path to invariants config */
+    configPath?: string;
+    /** Base directory */
+    baseDir?: string;
+    /** Suppress console output */
+    silent?: boolean;
+    /** Specific WU ID for scoped validation (WU-2425) */
+    wuId?: string;
+}
+export declare function runInvariants(options?: RunInvariantsOptions): {
+    success: boolean;
+    violations: InvariantDefinition[];
+    formatted: string;
+};
+export {};
+//# sourceMappingURL=invariants-runner.d.ts.map

package/dist/invariants-runner.d.ts.map

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