@lumenflow/core 3.2.0 → 3.2.2

package/dist/usecases/index.js

@@ -0,0 +1,21 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Use Cases Index
+ *
+ * WU-1094: INIT-002 Phase 2 - Implement adapters and dependency injection
+ *
+ * Re-exports all use case classes.
+ *
+ * @module usecases
+ */
+// Context use cases
+export { ComputeContextUseCase } from './compute-context.usecase.js';
+// Validation use cases
+export { ValidateCommandUseCase } from './validate-command.usecase.js';
+// Recovery use cases
+export { AnalyzeRecoveryUseCase } from './analyze-recovery.usecase.js';
+// Existing use cases (pre-WU-1094)
+export { GetDashboardDataUseCase, } from './get-dashboard-data.usecase.js';
+export { GetSuggestionsUseCase } from './get-suggestions.usecase.js';
+//# sourceMappingURL=index.js.map

package/dist/usecases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usecases/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAA8B,MAAM,8BAA8B,CAAC;AAEjG,uBAAuB;AACvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,qBAAqB;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,mCAAmC;AACnC,OAAO,EACL,uBAAuB,GAExB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAA8B,MAAM,8BAA8B,CAAC"}

package/dist/usecases/validate-command.usecase.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ValidateCommandUseCase
+ *
+ * WU-1094: INIT-002 Phase 2 - Implement adapters and dependency injection
+ *
+ * Use case for validating commands against WU context.
+ * Uses constructor injection for command registry dependency.
+ *
+ * Hexagonal Architecture - Application Layer
+ * - Depends on port interface (ICommandRegistry)
+ * - Does NOT import from infrastructure layer
+ *
+ * @module usecases/validate-command.usecase
+ */
+import type { ICommandRegistry, CommandDefinition, WuContext } from '../ports/validation.ports.js';
+import type { ValidationResult } from '../validation/types.js';
+/**
+ * ValidateCommandUseCase
+ *
+ * Validates a command against the current WU context, returning
+ * validation errors and warnings with fix suggestions.
+ *
+ * @example
+ * // Using default registry via DI factory
+ * const useCase = createValidateCommandUseCase();
+ * const result = await useCase.execute('wu:done', context);
+ *
+ * @example
+ * // Using custom registry for testing
+ * const useCase = new ValidateCommandUseCase(mockRegistry);
+ * const result = await useCase.execute('wu:claim', context);
+ */
+export declare class ValidateCommandUseCase {
+    private readonly commandRegistry;
+    constructor(commandRegistry: ICommandRegistry);
+    /**
+     * Execute the use case to validate a command.
+     *
+     * @param command - Command name (e.g., 'wu:done')
+     * @param context - Current WU context
+     * @returns Promise<ValidationResult> - Validation result with errors/warnings
+     */
+    execute(command: string, context: WuContext): Promise<ValidationResult>;
+    /**
+     * Get valid commands for the current context.
+     *
+     * @param context - Current WU context
+     * @returns Promise<CommandDefinition[]> - Array of valid commands
+     */
+    getValidCommands(context: WuContext): Promise<CommandDefinition[]>;
+    /**
+     * Generate fix command for location errors.
+     */
+    private getLocationFixCommand;
+}
+//# sourceMappingURL=validate-command.usecase.d.ts.map

package/dist/usecases/validate-command.usecase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.usecase.d.ts","sourceRoot":"","sources":["../../src/usecases/validate-command.usecase.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAsC,MAAM,wBAAwB,CAAC;AAKnG;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,gBAAgB;IAE9D;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkG7E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxE;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAkB9B"}

package/dist/usecases/validate-command.usecase.js

@@ -0,0 +1,143 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { CONTEXT_VALIDATION } from '../wu-constants.js';
+const { ERROR_CODES, SEVERITY } = CONTEXT_VALIDATION;
+/**
+ * ValidateCommandUseCase
+ *
+ * Validates a command against the current WU context, returning
+ * validation errors and warnings with fix suggestions.
+ *
+ * @example
+ * // Using default registry via DI factory
+ * const useCase = createValidateCommandUseCase();
+ * const result = await useCase.execute('wu:done', context);
+ *
+ * @example
+ * // Using custom registry for testing
+ * const useCase = new ValidateCommandUseCase(mockRegistry);
+ * const result = await useCase.execute('wu:claim', context);
+ */
+export class ValidateCommandUseCase {
+    commandRegistry;
+    constructor(commandRegistry) {
+        this.commandRegistry = commandRegistry;
+    }
+    /**
+     * Execute the use case to validate a command.
+     *
+     * @param command - Command name (e.g., 'wu:done')
+     * @param context - Current WU context
+     * @returns Promise<ValidationResult> - Validation result with errors/warnings
+     */
+    async execute(command, context) {
+        const errors = [];
+        const warnings = [];
+        // Step 1: Look up command definition
+        const commandDef = this.commandRegistry.getCommandDefinition(command);
+        if (!commandDef) {
+            errors.push({
+                // Use WU_NOT_FOUND as a general "not found" error code
+                // The message clarifies it's an unknown command
+                code: ERROR_CODES.WU_NOT_FOUND,
+                message: `Unknown command: ${command}`,
+                fixCommand: null,
+            });
+            return {
+                valid: false,
+                errors,
+                warnings,
+                context,
+            };
+        }
+        // Step 2: Check location requirement
+        if (commandDef.requiredLocation !== null) {
+            if (context.location.type !== commandDef.requiredLocation) {
+                const fixCommand = this.getLocationFixCommand(commandDef.requiredLocation, context, command);
+                errors.push({
+                    code: ERROR_CODES.WRONG_LOCATION,
+                    message: `${command} must be run from ${commandDef.requiredLocation} checkout`,
+                    fixCommand,
+                    context: {
+                        required: commandDef.requiredLocation,
+                        actual: context.location.type,
+                    },
+                });
+            }
+        }
+        // Step 3: Check WU status requirement
+        if (commandDef.requiredWuStatus !== null) {
+            const actualStatus = context.wu?.status ?? null;
+            if (actualStatus !== commandDef.requiredWuStatus) {
+                errors.push({
+                    code: ERROR_CODES.WRONG_WU_STATUS,
+                    message: `${command} requires WU status '${commandDef.requiredWuStatus}' but got '${actualStatus ?? 'no WU'}'`,
+                    fixCommand: null,
+                    context: {
+                        required: commandDef.requiredWuStatus,
+                        actual: actualStatus,
+                    },
+                });
+            }
+        }
+        // Step 4: Check predicates
+        if (commandDef.predicates && commandDef.predicates.length > 0) {
+            for (const predicate of commandDef.predicates) {
+                const passed = predicate.check(context);
+                if (!passed) {
+                    const message = predicate.getFixMessage
+                        ? predicate.getFixMessage(context)
+                        : predicate.description;
+                    if (predicate.severity === SEVERITY.ERROR) {
+                        errors.push({
+                            // Use GATES_NOT_PASSED for predicate failures (e.g., dirty worktree)
+                            code: ERROR_CODES.GATES_NOT_PASSED,
+                            message,
+                            fixCommand: null,
+                            context: { predicateId: predicate.id },
+                        });
+                    }
+                    else {
+                        warnings.push({
+                            id: predicate.id,
+                            message,
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            context,
+        };
+    }
+    /**
+     * Get valid commands for the current context.
+     *
+     * @param context - Current WU context
+     * @returns Promise<CommandDefinition[]> - Array of valid commands
+     */
+    async getValidCommands(context) {
+        return this.commandRegistry.getValidCommandsForContext(context);
+    }
+    /**
+     * Generate fix command for location errors.
+     */
+    getLocationFixCommand(requiredLocation, context, command) {
+        if (requiredLocation === 'main') {
+            // Need to cd to main checkout
+            const wuIdParam = context.wu?.id ? ` --id ${context.wu.id}` : '';
+            return `cd ${context.location.mainCheckout} && pnpm ${command}${wuIdParam}`;
+        }
+        else if (requiredLocation === 'worktree') {
+            // Need to cd to worktree
+            if (context.location.worktreeName) {
+                return `cd ${context.location.mainCheckout}/worktrees/${context.location.worktreeName}`;
+            }
+        }
+        return '';
+    }
+}
+//# sourceMappingURL=validate-command.usecase.js.map

package/dist/usecases/validate-command.usecase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.usecase.js","sourceRoot":"","sources":["../../src/usecases/validate-command.usecase.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAmBzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,eAAiC;QAAjC,oBAAe,GAAf,eAAe,CAAkB;IAAG,CAAC;IAElE;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAkB;QAC/C,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,qCAAqC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEtE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC;gBACV,uDAAuD;gBACvD,gDAAgD;gBAChD,IAAI,EAAE,WAAW,CAAC,YAAY;gBAC9B,OAAO,EAAE,oBAAoB,OAAO,EAAE;gBACtC,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM;gBACN,QAAQ;gBACR,OAAO;aACR,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,IAAI,UAAU,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC,gBAAgB,EAAE,CAAC;gBAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAC3C,UAAU,CAAC,gBAAgB,EAC3B,OAAO,EACP,OAAO,CACR,CAAC;gBAEF,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,WAAW,CAAC,cAAc;oBAChC,OAAO,EAAE,GAAG,OAAO,qBAAqB,UAAU,CAAC,gBAAgB,WAAW;oBAC9E,UAAU;oBACV,OAAO,EAAE;wBACP,QAAQ,EAAE,UAAU,CAAC,gBAAgB;wBACrC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;qBAC9B;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,IAAI,UAAU,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,IAAI,CAAC;YAEhD,IAAI,YAAY,KAAK,UAAU,CAAC,gBAAgB,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,WAAW,CAAC,eAAe;oBACjC,OAAO,EAAE,GAAG,OAAO,wBAAwB,UAAU,CAAC,gBAAgB,cAAc,YAAY,IAAI,OAAO,GAAG;oBAC9G,UAAU,EAAE,IAAI;oBAChB,OAAO,EAAE;wBACP,QAAQ,EAAE,UAAU,CAAC,gBAAgB;wBACrC,MAAM,EAAE,YAAY;qBACrB;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;gBAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAExC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa;wBACrC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC;wBAClC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;oBAE1B,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;wBAC1C,MAAM,CAAC,IAAI,CAAC;4BACV,qEAAqE;4BACrE,IAAI,EAAE,WAAW,CAAC,gBAAgB;4BAClC,OAAO;4BACP,UAAU,EAAE,IAAI;4BAChB,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE;yBACvC,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,QAAQ,CAAC,IAAI,CAAC;4BACZ,EAAE,EAAE,SAAS,CAAC,EAAE;4BAChB,OAAO;yBACR,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;YACR,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAkB;QACvC,OAAO,IAAI,CAAC,eAAe,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACK,qBAAqB,CAC3B,gBAAwB,EACxB,OAAkB,EAClB,OAAe;QAEf,IAAI,gBAAgB,KAAK,MAAM,EAAE,CAAC;YAChC,8BAA8B;YAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,YAAY,OAAO,GAAG,SAAS,EAAE,CAAC;QAC9E,CAAC;aAAM,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC3C,yBAAyB;YACzB,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAClC,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,cAAc,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1F,CAAC;QACH,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/user-normalizer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Default domain fallback when git config and lumenflow config unavailable
+ * WU-1068: Changed from hardcoded 'exampleapp.co.uk' to generic default
+ */
+export declare const DEFAULT_DOMAIN: string;
+/**
+ * Check if a value is a valid email address (simple check)
+ *
+ * @param {string|null|undefined} value - Value to check
+ * @returns {boolean} True if value is a valid email
+ */
+export declare function isValidEmail(value: UnsafeAny): boolean;
+/**
+ * Infer the default email domain from available sources
+ *
+ * Priority:
+ * 1. Git config user.email domain
+ * 2. workspace.yaml software_delivery.owner_email domain
+ * 3. DEFAULT_DOMAIN constant
+ *
+ * @param {string} [cwd] - Working directory for config lookup
+ * @returns {Promise<string>} Inferred domain (never null/undefined)
+ */
+export declare function inferDefaultDomain(cwd?: string): Promise<any>;
+/**
+ * Normalize a username or email to full email format
+ *
+ * If value is already a valid email, returns it unchanged (with normalization).
+ * If value is a plain username, appends the default domain.
+ *
+ * @param {string|null|undefined} value - Username or email
+ * @param {string} [domain] - Optional domain override
+ * @returns {Promise<string>} Normalized email address, or empty string for null/undefined
+ */
+export declare function normalizeToEmail(value: UnsafeAny, domain: UnsafeAny): Promise<string>;
+//# sourceMappingURL=user-normalizer.d.ts.map

package/dist/user-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-normalizer.d.ts","sourceRoot":"","sources":["../src/user-normalizer.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAwB,CAAC;AASpD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,WAQ5C;AAwFD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,SAAgB,gBAe3D;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,mBAmBzE"}

package/dist/user-normalizer.js

@@ -0,0 +1,177 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU-1333: User normalizer utilities
+ *
+ * Provides email normalization and domain inference for WU ownership.
+ * Converts plain usernames (e.g., "tom") to email format (e.g., "tom@hellm.ai")
+ * using domain from git config or workspace.yaml software_delivery.
+ *
+ * WU-1068: Removed hardcoded exampleapp.co.uk domain. Domain is now inferred
+ * from git config user.email or workspace.yaml software_delivery.owner_email.
+ */
+import { readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { WORKSPACE_CONFIG_FILE_NAME, WORKSPACE_V2_KEYS } from './config-contract.js';
+import { getGitForCwd } from './git-adapter.js';
+import { DEFAULTS } from './wu-constants.js';
+/**
+ * Default domain fallback when git config and lumenflow config unavailable
+ * WU-1068: Changed from hardcoded 'exampleapp.co.uk' to generic default
+ */
+export const DEFAULT_DOMAIN = DEFAULTS.EMAIL_DOMAIN;
+/**
+ * Minimum length for a valid email local part
+ */
+const MIN_LOCAL_PART_LENGTH = 1;
+const SOFTWARE_DELIVERY_KEY = WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY;
+const OWNER_EMAIL_KEYS = ['owner_email', 'ownerEmail'];
+/**
+ * Check if a value is a valid email address (simple check)
+ *
+ * @param {string|null|undefined} value - Value to check
+ * @returns {boolean} True if value is a valid email
+ */
+export function isValidEmail(value) {
+    if (!value || typeof value !== 'string') {
+        return false;
+    }
+    const str = value.trim();
+    // Simple email validation: must have @ with content before and after
+    const atIndex = str.indexOf('@');
+    return atIndex > 0 && atIndex < str.length - 1;
+}
+/**
+ * Extract domain from an email address
+ *
+ * @param {string} email - Email address
+ * @returns {string|null} Domain part or null if invalid
+ */
+function extractDomain(email) {
+    if (!isValidEmail(email)) {
+        return null;
+    }
+    const atIndex = email.indexOf('@');
+    return email.slice(atIndex + 1);
+}
+/**
+ * Try to get domain from git config user.email
+ *
+ * @returns {Promise<string|null>} Domain from git config or null
+ */
+async function getDomainFromGitConfig() {
+    try {
+        const git = getGitForCwd();
+        const email = await git.getConfigValue('user.email');
+        return extractDomain(email?.trim() || '');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Cast unknown data to a record when possible.
+ */
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+/**
+ * Try to get owner email from software_delivery config.
+ */
+function readOwnerEmail(softwareDelivery) {
+    for (const key of OWNER_EMAIL_KEYS) {
+        const value = softwareDelivery[key];
+        if (typeof value === 'string' && value.trim() !== '') {
+            return value.trim();
+        }
+    }
+    return null;
+}
+/**
+ * Try to get domain from workspace.yaml software_delivery owner email.
+ *
+ * @param {string} [cwd] - Working directory to search from
+ * @returns {Promise<string|null>} Domain from config or null
+ */
+async function getDomainFromWorkspaceConfig(cwd = process.cwd()) {
+    const configPath = join(cwd, WORKSPACE_CONFIG_FILE_NAME);
+    try {
+        await access(configPath);
+    }
+    catch {
+        return null;
+    }
+    try {
+        const content = await readFile(configPath, { encoding: 'utf-8' });
+        const workspaceDoc = asRecord(parseYaml(content));
+        if (!workspaceDoc) {
+            return null;
+        }
+        const softwareDelivery = asRecord(workspaceDoc[SOFTWARE_DELIVERY_KEY]);
+        if (!softwareDelivery) {
+            return null;
+        }
+        const ownerEmail = readOwnerEmail(softwareDelivery);
+        return ownerEmail ? extractDomain(ownerEmail) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Infer the default email domain from available sources
+ *
+ * Priority:
+ * 1. Git config user.email domain
+ * 2. workspace.yaml software_delivery.owner_email domain
+ * 3. DEFAULT_DOMAIN constant
+ *
+ * @param {string} [cwd] - Working directory for config lookup
+ * @returns {Promise<string>} Inferred domain (never null/undefined)
+ */
+export async function inferDefaultDomain(cwd = process.cwd()) {
+    // Try git config first
+    const gitDomain = await getDomainFromGitConfig();
+    if (gitDomain) {
+        return gitDomain;
+    }
+    // Try lumenflow config
+    const configDomain = await getDomainFromWorkspaceConfig(cwd);
+    if (configDomain) {
+        return configDomain;
+    }
+    // Fallback to default
+    return DEFAULT_DOMAIN;
+}
+/**
+ * Normalize a username or email to full email format
+ *
+ * If value is already a valid email, returns it unchanged (with normalization).
+ * If value is a plain username, appends the default domain.
+ *
+ * @param {string|null|undefined} value - Username or email
+ * @param {string} [domain] - Optional domain override
+ * @returns {Promise<string>} Normalized email address, or empty string for null/undefined
+ */
+export async function normalizeToEmail(value, domain) {
+    // Handle null/undefined/empty
+    if (!value) {
+        return '';
+    }
+    const str = String(value).trim().toLowerCase();
+    if (str.length < MIN_LOCAL_PART_LENGTH) {
+        return '';
+    }
+    // Already a valid email - return as-is (normalized)
+    if (isValidEmail(str)) {
+        return str;
+    }
+    // Plain username - append domain
+    const effectiveDomain = domain || (await inferDefaultDomain());
+    return `${str}@${effectiveDomain}`;
+}
+//# sourceMappingURL=user-normalizer.js.map

package/dist/user-normalizer.js.map

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

package/dist/validation/command-registry.d.ts

@@ -0,0 +1,26 @@
+import type { CommandDefinition, CommandPredicate, WuContext } from './types.js';
+/**
+ * Command registry mapping command names to definitions.
+ */
+export declare const COMMAND_REGISTRY: Map<string, CommandDefinition>;
+/**
+ * Get command definition by name.
+ *
+ * @param command - Command name (e.g., 'wu:create')
+ * @returns CommandDefinition or null if not found
+ */
+export declare function getCommandDefinition(command: string): CommandDefinition | null;
+/**
+ * Get all commands valid for the current context.
+ *
+ * A command is valid if:
+ * - Location requirement is satisfied (or null = UnsafeAny)
+ * - WU status requirement is satisfied (or null = no WU required)
+ * - All error-severity predicates pass
+ *
+ * @param context - Current WU context
+ * @returns Array of valid CommandDefinitions
+ */
+export declare function getValidCommandsForContext(context: WuContext): CommandDefinition[];
+export type { CommandDefinition, CommandPredicate, WuContext };
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/validation/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/validation/command-registry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmMjF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAS1D,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAE9E;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,GAAG,iBAAiB,EAAE,CAgBlF;AAGD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC"}