@lumenflow/core 3.1.1 → 3.1.3

package/dist/context-di.js

@@ -1,165 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-// Import adapters
-import { SimpleGitLocationAdapter, SimpleGitStateAdapter, FileSystemWuStateAdapter, } from './adapters/context-adapters.js';
-import { CommandRegistryAdapter } from './adapters/validation-adapters.js';
-import { RecoveryAnalyzerAdapter } from './adapters/recovery-adapters.js';
-// Import use cases
-import { ComputeContextUseCase, } from './usecases/compute-context.usecase.js';
-import { ValidateCommandUseCase } from './usecases/validate-command.usecase.js';
-import { AnalyzeRecoveryUseCase } from './usecases/analyze-recovery.usecase.js';
-/**
- * Create all context adapters with default implementations.
- *
- * @example
- * const adapters = createContextAdapters();
- * const location = await adapters.locationResolver.resolveLocation();
- */
-export function createContextAdapters() {
-    return {
-        locationResolver: new SimpleGitLocationAdapter(),
-        gitStateReader: new SimpleGitStateAdapter(),
-        wuStateReader: new FileSystemWuStateAdapter(),
-    };
-}
-/**
- * Create all validation adapters with default implementations.
- *
- * @example
- * const adapters = createValidationAdapters();
- * const def = adapters.commandRegistry.getCommandDefinition('wu:done');
- */
-export function createValidationAdapters() {
-    return {
-        commandRegistry: new CommandRegistryAdapter(),
-    };
-}
-/**
- * Create all recovery adapters with default implementations.
- *
- * @example
- * const adapters = createRecoveryAdapters();
- * const analysis = await adapters.recoveryAnalyzer.analyzeRecovery(context);
- */
-export function createRecoveryAdapters() {
-    return {
-        recoveryAnalyzer: new RecoveryAnalyzerAdapter(),
-    };
-}
-/**
- * Create a ComputeContextUseCase with default or custom adapters.
- *
- * @example
- * // Use default adapters
- * const useCase = createComputeContextUseCase();
- * const context = await useCase.execute({ wuId: 'WU-1094' });
- *
- * @example
- * // Use custom adapters for testing
- * const useCase = createComputeContextUseCase({
- *   locationResolver: mockLocationResolver,
- * });
- */
-export function createComputeContextUseCase(options = {}) {
-    const defaults = createContextAdapters();
-    return new ComputeContextUseCase(options.locationResolver ?? defaults.locationResolver, options.gitStateReader ?? defaults.gitStateReader, options.wuStateReader ?? defaults.wuStateReader);
-}
-/**
- * Create a ValidateCommandUseCase with default or custom registry.
- *
- * @example
- * // Use default registry
- * const useCase = createValidateCommandUseCase();
- * const result = await useCase.execute('wu:done', context);
- *
- * @example
- * // Use custom registry for testing
- * const useCase = createValidateCommandUseCase({
- *   commandRegistry: mockRegistry,
- * });
- */
-export function createValidateCommandUseCase(options = {}) {
-    const defaults = createValidationAdapters();
-    return new ValidateCommandUseCase(options.commandRegistry ?? defaults.commandRegistry);
-}
-/**
- * Create an AnalyzeRecoveryUseCase with default or custom analyzer.
- *
- * @example
- * // Use default analyzer
- * const useCase = createAnalyzeRecoveryUseCase();
- * const analysis = await useCase.execute(context);
- *
- * @example
- * // Use custom analyzer for testing
- * const useCase = createAnalyzeRecoveryUseCase({
- *   recoveryAnalyzer: mockAnalyzer,
- * });
- */
-export function createAnalyzeRecoveryUseCase(options = {}) {
-    const defaults = createRecoveryAdapters();
-    return new AnalyzeRecoveryUseCase(options.recoveryAnalyzer ?? defaults.recoveryAnalyzer);
-}
-// ============================================================================
-// Backwards Compatible Function Exports
-// ============================================================================
-/**
- * Compute WU context for the given options.
- *
- * This is a convenience function that creates a use case with default adapters
- * and executes it. Use createComputeContextUseCase() for more control.
- *
- * @param options - Options including optional wuId and cwd
- * @returns Promise<WuContext> - Computed WU context
- *
- * @example
- * const context = await computeWuContext({ wuId: 'WU-1094' });
- * console.log(context.location.type); // 'main' or 'worktree'
- */
-export async function computeWuContext(options = {}) {
-    const useCase = createComputeContextUseCase();
-    return useCase.execute(options);
-}
-/**
- * Validate a command against the given context.
- *
- * This is a convenience function that creates a use case with default registry
- * and executes it. Use createValidateCommandUseCase() for more control.
- *
- * @param command - Command name (e.g., 'wu:done')
- * @param context - Current WU context
- * @returns Promise<ValidationResult> - Validation result
- *
- * @example
- * const context = await computeWuContext({ wuId: 'WU-1094' });
- * const result = await validateCommand('wu:done', context);
- * if (!result.valid) {
- *   console.error(result.errors[0].message);
- * }
- */
-export async function validateCommand(command, context) {
-    const useCase = createValidateCommandUseCase();
-    return useCase.execute(command, context);
-}
-/**
- * Analyze recovery issues for the given context.
- *
- * This is a convenience function that creates a use case with default analyzer
- * and executes it. Use createAnalyzeRecoveryUseCase() for more control.
- *
- * @param context - Current WU context
- * @returns Promise<RecoveryAnalysis> - Recovery analysis
- *
- * @example
- * const context = await computeWuContext({ wuId: 'WU-1094' });
- * const analysis = await analyzeRecoveryIssues(context);
- * if (analysis.hasIssues) {
- *   console.log('Issues:', analysis.issues);
- *   console.log('Suggested actions:', analysis.actions);
- * }
- */
-export async function analyzeRecoveryIssues(context) {
-    const useCase = createAnalyzeRecoveryUseCase();
-    return useCase.execute(context);
-}
-//# sourceMappingURL=context-di.js.map

package/dist/context-di.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-di.js","sourceRoot":"","sources":["../src/context-di.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAyBzC,kBAAkB;AAClB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,mBAAmB;AACnB,OAAO,EACL,qBAAqB,GAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAehF;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,gBAAgB,EAAE,IAAI,wBAAwB,EAAE;QAChD,cAAc,EAAE,IAAI,qBAAqB,EAAE;QAC3C,aAAa,EAAE,IAAI,wBAAwB,EAAE;KAC9C,CAAC;AACJ,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,eAAe,EAAE,IAAI,sBAAsB,EAAE;KAC9C,CAAC;AACJ,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,gBAAgB,EAAE,IAAI,uBAAuB,EAAE;KAChD,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAuC,EAAE;IAEzC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IAEzC,OAAO,IAAI,qBAAqB,CAC9B,OAAO,CAAC,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB,EACrD,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc,EACjD,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAChD,CAAC;AACJ,CAAC;AASD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAE5C,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC;AACzF,CAAC;AASD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAE1C,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AAC3F,CAAC;AAED,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAiC,EAAE;IACxE,MAAM,OAAO,GAAG,2BAA2B,EAAE,CAAC;IAC9C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,OAAkB;IAElB,MAAM,OAAO,GAAG,4BAA4B,EAAE,CAAC;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAkB;IAC5D,MAAM,OAAO,GAAG,4BAA4B,EAAE,CAAC;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/context-validation-integration.d.ts

@@ -1,69 +0,0 @@
-import type { WuContext, ValidationResult } from './validation/types.js';
-declare const COMMANDS: {
-    readonly WU_CREATE: "wu:create";
-    readonly WU_CLAIM: "wu:claim";
-    readonly WU_PREP: "wu:prep";
-    readonly WU_DONE: "wu:done";
-    readonly WU_BLOCK: "wu:block";
-    readonly WU_UNBLOCK: "wu:unblock";
-    readonly WU_STATUS: "wu:status";
-    readonly WU_RECOVER: "wu:recover";
-    readonly GATES: "gates";
-};
-/**
- * Validation mode from config
- */
-export type ValidationMode = 'off' | 'warn' | 'error';
-/**
- * Result of running context validation
- */
-export interface ContextValidationResult {
-    /** Whether the command can proceed */
-    canProceed: boolean;
-    /** The computed context */
-    context: WuContext;
-    /** Validation result (null if validation was off) */
-    validation: ValidationResult | null;
-    /** Validation mode that was applied */
-    mode: ValidationMode;
-    /** Formatted output for display (if UnsafeAny) */
-    output: string | null;
-}
-/**
- * Get validation mode from config
- */
-export declare function getValidationMode(): ValidationMode;
-/**
- * Check if next steps should be shown
- */
-export declare function shouldShowNextSteps(): boolean;
-/**
- * Format next steps for display
- */
-export declare function formatNextSteps(context: WuContext, commandName: string): string;
-/**
- * Run context validation for a command
- *
- * @param commandName - The wu:* command name (e.g., 'wu:claim')
- * @param wuId - Optional WU ID for context
- * @returns ContextValidationResult
- */
-export declare function runContextValidation(commandName: string, wuId?: string): Promise<ContextValidationResult>;
-/**
- * Apply context validation to a command
- *
- * This is the main integration function. It:
- * 1. Runs validation according to config
- * 2. Logs warnings/errors as appropriate
- * 3. Returns whether the command should proceed
- * 4. Exits with error if mode is 'error' and validation fails
- *
- * @param commandName - The wu:* command name
- * @param wuId - Optional WU ID for context
- * @param logPrefix - Log prefix for output
- * @returns The computed context if validation passes
- * @throws {ProcessExitError} if mode is 'error' and validation fails (WU-1538)
- */
-export declare function applyContextValidation(commandName: string, wuId?: string, logPrefix?: string): Promise<WuContext>;
-export { COMMANDS };
-//# sourceMappingURL=context-validation-integration.d.ts.map

package/dist/context-validation-integration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-validation-integration.d.ts","sourceRoot":"","sources":["../src/context-validation-integration.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,QAAA,MAAQ,QAAQ;;;;;;;;;;CAAuB,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,qDAAqD;IACrD,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,uCAAuC;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAYlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AA2BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAc/E;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,CAAC,CAsClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,GAAE,MAAoB,GAC9B,OAAO,CAAC,SAAS,CAAC,CAgBpB;AAGD,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/context-validation-integration.js

@@ -1,161 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Context Validation Integration
- *
- * WU-1090: Context-aware state machine for WU lifecycle commands
- *
- * Shared module for integrating context validation into CLI commands.
- * Reads validation_mode from config and applies validation accordingly.
- *
- * @module
- */
-import { computeContext } from './context/context-computer.js';
-import { validateCommand } from './validation/validate-command.js';
-import { getValidCommandsForContext } from './validation/command-registry.js';
-import { getConfig } from './lumenflow-config.js';
-import { EMOJI, CONTEXT_VALIDATION } from './wu-constants.js';
-import { ProcessExitError } from './error-handler.js';
-const { COMMANDS } = CONTEXT_VALIDATION;
-/**
- * Get validation mode from config
- */
-export function getValidationMode() {
-    try {
-        const config = getConfig();
-        const experimental = config?.experimental;
-        if (!experimental?.context_validation) {
-            return 'off';
-        }
-        return experimental.validation_mode || 'warn';
-    }
-    catch {
-        // Config not available, default to warn
-        return 'warn';
-    }
-}
-/**
- * Check if next steps should be shown
- */
-export function shouldShowNextSteps() {
-    try {
-        const config = getConfig();
-        return config?.experimental?.show_next_steps !== false;
-    }
-    catch {
-        return true;
-    }
-}
-/**
- * Format validation errors for display
- */
-function formatErrors(validation) {
-    const lines = [];
-    for (const error of validation.errors) {
-        lines.push(`${EMOJI.FAILURE} ${error.code}: ${error.message}`);
-        if (error.fixCommand) {
-            lines.push(`   Fix: ${error.fixCommand}`);
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Format validation warnings for display
- */
-function formatWarnings(validation) {
-    const lines = [];
-    for (const warning of validation.warnings) {
-        lines.push(`${EMOJI.WARNING} ${warning.id}: ${warning.message}`);
-    }
-    return lines.join('\n');
-}
-/**
- * Format next steps for display
- */
-export function formatNextSteps(context, commandName) {
-    const validCommands = getValidCommandsForContext(context);
-    const commandDef = validCommands.find((c) => c.name === commandName);
-    if (!commandDef?.getNextSteps) {
-        return '';
-    }
-    const steps = commandDef.getNextSteps(context);
-    if (steps.length === 0) {
-        return '';
-    }
-    return '\n## Next Steps\n' + steps.map((s) => `  ${s}`).join('\n');
-}
-/**
- * Run context validation for a command
- *
- * @param commandName - The wu:* command name (e.g., 'wu:claim')
- * @param wuId - Optional WU ID for context
- * @returns ContextValidationResult
- */
-export async function runContextValidation(commandName, wuId) {
-    const mode = getValidationMode();
-    // Compute context
-    const { context } = await computeContext({ wuId });
-    // If validation is off, just return context
-    if (mode === 'off') {
-        return {
-            canProceed: true,
-            context,
-            validation: null,
-            mode,
-            output: null,
-        };
-    }
-    // Run validation
-    const validation = validateCommand(commandName, context);
-    // Format output
-    let output = null;
-    if (!validation.valid) {
-        output = formatErrors(validation);
-    }
-    else if (validation.warnings.length > 0) {
-        output = formatWarnings(validation);
-    }
-    // Determine if command can proceed
-    const canProceed = mode === 'warn' || validation.valid;
-    return {
-        canProceed,
-        context,
-        validation,
-        mode,
-        output,
-    };
-}
-/**
- * Apply context validation to a command
- *
- * This is the main integration function. It:
- * 1. Runs validation according to config
- * 2. Logs warnings/errors as appropriate
- * 3. Returns whether the command should proceed
- * 4. Exits with error if mode is 'error' and validation fails
- *
- * @param commandName - The wu:* command name
- * @param wuId - Optional WU ID for context
- * @param logPrefix - Log prefix for output
- * @returns The computed context if validation passes
- * @throws {ProcessExitError} if mode is 'error' and validation fails (WU-1538)
- */
-export async function applyContextValidation(commandName, wuId, logPrefix = '[context]') {
-    const result = await runContextValidation(commandName, wuId);
-    // Log output if UnsafeAny
-    if (result.output) {
-        if (result.mode === 'error' && !result.canProceed) {
-            console.error(`${logPrefix} Context validation failed:`);
-            console.error(result.output);
-            throw new ProcessExitError(`${logPrefix} Context validation failed`, 1);
-        }
-        else if (result.mode === 'warn') {
-            console.warn(`${logPrefix} Context validation warnings:`);
-            console.warn(result.output);
-        }
-    }
-    return result.context;
-}
-// Re-export commands for convenience
-export { COMMANDS };
-//# sourceMappingURL=context-validation-integration.js.map

package/dist/context-validation-integration.js.map

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

package/dist/core/scope-checker.d.ts

@@ -1,80 +0,0 @@
-import { getWUContext } from './worktree-guard.js';
-/**
- * Load WU YAML data for a given WU ID
- *
- * Wrapper around readWU that constructs the path.
- * Exported for testing injection.
- *
- * @param {string} wuId - WU identifier
- * @returns {Object} Parsed WU YAML
- * @private
- */
-declare function loadWUYaml(wuId: UnsafeAny): any;
-/**
- * Options for getActiveScope
- */
-interface GetActiveScopeOptions {
-    /** WU context getter (for testing) */
-    getWUContext?: typeof getWUContext;
-    /** WU YAML loader (for testing) */
-    loadWUYaml?: typeof loadWUYaml;
-}
-/**
- * Get active WU scope (WU ID + code_paths)
- *
- * Retrieves the current WU context and loads code_paths from WU YAML.
- * Returns null if not in a WU workspace.
- *
- * @param {GetActiveScopeOptions} [options] - Options
- * @returns {Promise<Object|null>} Scope object {wuId, code_paths} or null
- *
- * @example
- * const scope = await getActiveScope();
- * if (scope) {
- *   console.log(`WU ${scope.wuId} code_paths:`, scope.code_paths);
- * }
- */
-export declare function getActiveScope(options?: GetActiveScopeOptions): Promise<{
-    wuId: string;
-    code_paths: any;
-} | null>;
-/**
- * Check if a file path is within WU scope
- *
- * Validates a file path against the WU's code_paths using glob matching.
- * Supports exact paths and glob patterns (*, **, {a,b}, etc.).
- *
- * Empty code_paths = no restrictions (documentation/process WUs).
- *
- * @param {string} filePath - File path to check
- * @param {Object|null} scope - Scope object from getActiveScope()
- * @param {string} scope.wuId - WU identifier
- * @param {string[]} scope.code_paths - Allowed file paths/patterns
- * @returns {boolean} True if path is in scope, false otherwise
- *
- * @example
- * const scope = await getActiveScope();
- * if (isPathInScope('apps/web/src/Header.tsx', scope)) {
- *   console.log('Path is in scope');
- * }
- */
-export declare function isPathInScope(filePath: UnsafeAny, scope: UnsafeAny): boolean;
-/**
- * Assert that a file path is within WU scope
- *
- * Throws descriptive error if path is outside WU code_paths.
- * Use this for write operations that must enforce scope boundaries.
- *
- * @param {string} filePath - File path to check
- * @param {Object|null} scope - Scope object from getActiveScope()
- * @param {string} [operation] - Operation name for error message context
- * @throws {Error} If path is outside scope or no scope available
- *
- * @example
- * const scope = await getActiveScope();
- * assertPathInScope('apps/web/src/Header.tsx', scope, 'file write');
- * // Throws if path not in WU code_paths
- */
-export declare function assertPathInScope(filePath: UnsafeAny, scope: UnsafeAny, operation?: string): void;
-export {};
-//# sourceMappingURL=scope-checker.d.ts.map

package/dist/core/scope-checker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scope-checker.d.ts","sourceRoot":"","sources":["../../src/core/scope-checker.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBnD;;;;;;;;;GASG;AACH,iBAAS,UAAU,CAAC,IAAI,EAAE,SAAS,OAGlC;AAED;;GAEG;AACH,UAAU,qBAAqB;IAC7B,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;IACnC,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;CAChC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B;;;UAiBvE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,WAoBlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,SAAS,EAChB,SAAS,SAAmB,QAsC7B"}

package/dist/core/scope-checker.js

@@ -1,166 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * @file scope-checker.ts
- * @description WU scope validation and code_paths enforcement (WU-1397)
- *
- * Provides runtime validation that file modifications stay within WU code_paths.
- * Prevents scope creep and ensures agents only modify authorized files.
- *
- * Features:
- * - Load code_paths from active WU YAML
- * - Validate file paths against glob patterns
- * - Throw descriptive errors for scope violations
- * - Support both exact paths and glob patterns
- *
- * Used by wu- scripts and future file operation guards.
- *
- * @see {@link packages/@lumenflow/cli/src/lib/core/worktree-guard.ts} - WU context detection
- * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU YAML parsing
- */
-import micromatch from 'micromatch';
-import { getWUContext } from './worktree-guard.js';
-import { readWU } from '../wu-yaml.js';
-import { WU_PATHS } from '../wu-paths.js';
-/**
- * Normalize path separators to forward slashes
- *
- * Handles both Unix and Windows path separators for cross-platform compatibility.
- *
- * @param {string} p - Path to normalize
- * @returns {string} Path with forward slashes
- * @private
- */
-function normalizePath(p) {
-    return p.replace(/\\/g, '/');
-}
-/**
- * Load WU YAML data for a given WU ID
- *
- * Wrapper around readWU that constructs the path.
- * Exported for testing injection.
- *
- * @param {string} wuId - WU identifier
- * @returns {Object} Parsed WU YAML
- * @private
- */
-function loadWUYaml(wuId) {
-    const wuPath = WU_PATHS.WU(wuId);
-    return readWU(wuPath, wuId);
-}
-/**
- * Get active WU scope (WU ID + code_paths)
- *
- * Retrieves the current WU context and loads code_paths from WU YAML.
- * Returns null if not in a WU workspace.
- *
- * @param {GetActiveScopeOptions} [options] - Options
- * @returns {Promise<Object|null>} Scope object {wuId, code_paths} or null
- *
- * @example
- * const scope = await getActiveScope();
- * if (scope) {
- *   console.log(`WU ${scope.wuId} code_paths:`, scope.code_paths);
- * }
- */
-export async function getActiveScope(options = {}) {
-    const getContextFn = options.getWUContext || getWUContext;
-    const loadYamlFn = options.loadWUYaml || loadWUYaml;
-    // Get current WU context from worktree path or git branch
-    const context = await getContextFn();
-    if (!context) {
-        return null;
-    }
-    // Load WU YAML to get code_paths
-    const wuData = loadYamlFn(context.wuId);
-    return {
-        wuId: context.wuId,
-        code_paths: wuData.code_paths || [],
-    };
-}
-/**
- * Check if a file path is within WU scope
- *
- * Validates a file path against the WU's code_paths using glob matching.
- * Supports exact paths and glob patterns (*, **, {a,b}, etc.).
- *
- * Empty code_paths = no restrictions (documentation/process WUs).
- *
- * @param {string} filePath - File path to check
- * @param {Object|null} scope - Scope object from getActiveScope()
- * @param {string} scope.wuId - WU identifier
- * @param {string[]} scope.code_paths - Allowed file paths/patterns
- * @returns {boolean} True if path is in scope, false otherwise
- *
- * @example
- * const scope = await getActiveScope();
- * if (isPathInScope('apps/web/src/Header.tsx', scope)) {
- *   console.log('Path is in scope');
- * }
- */
-export function isPathInScope(filePath, scope) {
-    if (!scope) {
-        return false;
-    }
-    // Empty code_paths = no restrictions (documentation/process WUs)
-    if (!scope.code_paths || scope.code_paths.length === 0) {
-        return true;
-    }
-    // Normalize path separators for cross-platform compatibility
-    const normalizedPath = normalizePath(filePath);
-    // Check exact match first (fast path)
-    if (scope.code_paths.includes(normalizedPath)) {
-        return true;
-    }
-    // Check glob patterns using micromatch
-    return micromatch.isMatch(normalizedPath, scope.code_paths);
-}
-/**
- * Assert that a file path is within WU scope
- *
- * Throws descriptive error if path is outside WU code_paths.
- * Use this for write operations that must enforce scope boundaries.
- *
- * @param {string} filePath - File path to check
- * @param {Object|null} scope - Scope object from getActiveScope()
- * @param {string} [operation] - Operation name for error message context
- * @throws {Error} If path is outside scope or no scope available
- *
- * @example
- * const scope = await getActiveScope();
- * assertPathInScope('apps/web/src/Header.tsx', scope, 'file write');
- * // Throws if path not in WU code_paths
- */
-export function assertPathInScope(filePath, scope, operation = 'this operation') {
-    if (!scope) {
-        throw new Error(`❌ SCOPE VIOLATION: No active WU context.
-
-Operation: ${operation}
-File path: ${filePath}
-
-You must claim a WU before performing operations.
-Run: pnpm wu:claim --id WU-XXX --lane "<lane>"
-`);
-    }
-    if (!isPathInScope(filePath, scope)) {
-        const normalizedPath = normalizePath(filePath);
-        throw new Error(`❌ SCOPE VIOLATION: File path outside WU code_paths.
-
-Operation: ${operation}
-WU ID: ${scope.wuId}
-File path: ${normalizedPath}
-
-Allowed code_paths:
-${scope.code_paths.map((p) => `  - ${p}`).join('\n')}
-
-This file is not authorized for modification in this WU.
-Either:
-  1. Add this path to code_paths in WU YAML (if legitimately needed)
-  2. Create a separate WU for this change
-  3. Choose a different file within scope
-
-See: CLAUDE.md §2 (Worktree Discipline)
-`);
-    }
-}
-//# sourceMappingURL=scope-checker.js.map

package/dist/core/scope-checker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scope-checker.js","sourceRoot":"","sources":["../../src/core/scope-checker.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;;;;GAQG;AACH,SAAS,aAAa,CAAC,CAAY;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,UAAU,CAAC,IAAe;IACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAYD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAiC,EAAE;IACtE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,YAAY,CAAC;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC;IAEpD,0DAA0D;IAC1D,MAAM,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iCAAiC;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAAC,QAAmB,EAAE,KAAgB;IACjE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iEAAiE;IACjE,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IAC7D,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE/C,sCAAsC;IACtC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,OAAO,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAmB,EACnB,KAAgB,EAChB,SAAS,GAAG,gBAAgB;IAE5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb;;aAEO,SAAS;aACT,QAAQ;;;;CAIpB,CACI,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE/C,MAAM,IAAI,KAAK,CACb;;aAEO,SAAS;SACb,KAAK,CAAC,IAAI;aACN,cAAc;;;EAGzB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;CAS9D,CACI,CAAC;IACJ,CAAC;AACH,CAAC"}