@lumenflow/core 3.2.0 → 3.2.2

package/dist/schemas/agents-config.js

@@ -0,0 +1,153 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Agents Configuration Schemas
+ *
+ * Agent client configuration including blocks, skills, enforcement,
+ * methodology defaults, and capabilities mapping.
+ *
+ * @module schemas/agents-config
+ */
+import { z } from 'zod';
+import { LUMENFLOW_CLIENT_IDS } from '../wu-context-constants.js';
+/**
+ * Methodology defaults (agent-facing project defaults)
+ */
+export const DEFAULT_METHODOLOGY_PRINCIPLES = [
+    'TDD',
+    'Hexagonal Architecture',
+    'SOLID',
+    'DRY',
+    'YAGNI',
+    'KISS',
+    'Library-First',
+];
+export const MethodologyDefaultsSchema = z.object({
+    /** Enable or disable project defaults output */
+    enabled: z.boolean().default(true),
+    /** Whether defaults are required or recommended */
+    enforcement: z.enum(['required', 'recommended']).default('required'),
+    /** Default methodology principles to apply */
+    principles: z.array(z.string()).default(DEFAULT_METHODOLOGY_PRINCIPLES),
+    /** Optional notes appended to Project Defaults */
+    notes: z.string().optional(),
+});
+/**
+ * Client-specific blocks (agent-facing spawn blocks)
+ */
+export const ClientBlockSchema = z.object({
+    /** Block title */
+    title: z.string(),
+    /** Block content (markdown allowed) */
+    content: z.string(),
+});
+/**
+ * Client-specific skills guidance
+ */
+export const ClientSkillsSchema = z.object({
+    /** Optional skills selection guidance text */
+    instructions: z.string().optional(),
+    /** Recommended skills to load for this client */
+    recommended: z.array(z.string()).default([]),
+    /**
+     * WU-1142: Lane-specific skills to recommend
+     * Maps lane names to arrays of skill names
+     * @example
+     * byLane:
+     *   'Framework: Core': ['tdd-workflow', 'lumenflow-gates']
+     *   'Content: Documentation': ['worktree-discipline']
+     */
+    byLane: z.record(z.string(), z.array(z.string())).optional(),
+});
+/**
+ * WU-1367: Client enforcement configuration
+ *
+ * Configures workflow compliance enforcement via Claude Code hooks.
+ * When enabled, hooks block non-compliant operations instead of relying
+ * on agents to remember workflow rules.
+ *
+ * @example
+ * ```yaml
+ * agents:
+ *   clients:
+ *     claude-code:
+ *       enforcement:
+ *         hooks: true
+ *         block_outside_worktree: true
+ *         require_wu_for_edits: true
+ *         warn_on_stop_without_wu_done: true
+ * ```
+ */
+export const ClientEnforcementSchema = z.object({
+    /**
+     * Enable enforcement hooks.
+     * When true, hooks are generated in .claude/hooks/
+     * @default false
+     */
+    hooks: z.boolean().default(false),
+    /**
+     * Block Write/Edit operations when cwd is not a worktree.
+     * Prevents accidental edits to main checkout.
+     * @default false
+     */
+    block_outside_worktree: z.boolean().default(false),
+    /**
+     * Require a claimed WU for Write/Edit operations.
+     * Ensures all edits are associated with tracked work.
+     * @default false
+     */
+    require_wu_for_edits: z.boolean().default(false),
+    /**
+     * Warn when session ends without wu:done being called.
+     * Reminds agents to complete their work properly.
+     * @default false
+     */
+    warn_on_stop_without_wu_done: z.boolean().default(false),
+});
+/**
+ * Client configuration (per-client settings)
+ */
+export const ClientConfigSchema = z.object({
+    /** Preamble file path (e.g. 'CLAUDE.md') or false to disable */
+    preamble: z.union([z.string(), z.boolean()]).optional(),
+    /** Skills directory path */
+    skillsDir: z.string().optional(),
+    /** Agents directory path */
+    agentsDir: z.string().optional(),
+    /** Client-specific blocks injected into wu:spawn output */
+    blocks: z.array(ClientBlockSchema).default([]),
+    /** Client-specific skills guidance for wu:spawn */
+    skills: ClientSkillsSchema.optional(),
+    /**
+     * WU-1367: Enforcement configuration for Claude Code hooks.
+     * When enabled, generates hooks that enforce workflow compliance.
+     */
+    enforcement: ClientEnforcementSchema.optional(),
+    /**
+     * WU-1900: Capability-to-skill mapping for classifier-driven skill suggestions.
+     * Maps abstract capability tags from the work classifier to client-specific skill names.
+     *
+     * @example
+     * ```yaml
+     * agents:
+     *   clients:
+     *     claude-code:
+     *       capabilities_map:
+     *         ui-design-awareness: frontend-design
+     *         component-reuse-check: library-first
+     * ```
+     */
+    capabilities_map: z.record(z.string(), z.string()).optional(),
+});
+/**
+ * Agents configuration
+ */
+export const AgentsConfigSchema = z.object({
+    /** Default client to use if not specified (configure per project; bootstrap default: 'claude-code') */
+    defaultClient: z.string().default(LUMENFLOW_CLIENT_IDS.CLAUDE_CODE),
+    /** Client-specific configurations */
+    clients: z.record(z.string(), ClientConfigSchema).default({}),
+    /** Project methodology defaults (agent-facing) */
+    methodology: MethodologyDefaultsSchema.default(() => MethodologyDefaultsSchema.parse({})),
+});
+//# sourceMappingURL=agents-config.js.map

package/dist/schemas/agents-config.js.map

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

package/dist/schemas/arg-validators.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file arg-validators.ts
+ * @description CLI argument validators using shared schemas (WU-1431)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments.
+ * They handle:
+ * - CLI-only alias mapping (codePath -> code_paths, manualTest -> test_paths_manual)
+ * - Conditional validation (skip_gates requires reason)
+ * - Normalized output for consistent downstream processing
+ */
+import { type WuCreateInput, type WuClaimInput, type WuStatusInput, type WuDoneInput, type GatesInput } from './command-schemas.js';
+/**
+ * Validation result with normalized data
+ */
+export interface ValidationResult<T> {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    normalized: T;
+}
+/**
+ * Validate wu:create arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuCreateInput
+ */
+export declare function validateWuCreateArgs(args: Record<string, unknown>): ValidationResult<WuCreateInput>;
+/**
+ * Validate wu:claim arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuClaimInput
+ */
+export declare function validateWuClaimArgs(args: Record<string, unknown>): ValidationResult<WuClaimInput>;
+/**
+ * Validate wu:status arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuStatusInput
+ */
+export declare function validateWuStatusArgs(args: Record<string, unknown>): ValidationResult<WuStatusInput>;
+/**
+ * Validate wu:done arguments
+ *
+ * Includes additional validation: skip_gates requires reason
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuDoneInput
+ */
+export declare function validateWuDoneArgs(args: Record<string, unknown>): ValidationResult<WuDoneInput>;
+/**
+ * Validate gates arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized GatesInput
+ */
+export declare function validateGatesArgs(args: Record<string, unknown>): ValidationResult<GatesInput>;
+//# sourceMappingURL=arg-validators.d.ts.map

package/dist/schemas/arg-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-validators.d.ts","sourceRoot":"","sources":["../../src/schemas/arg-validators.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAO9B;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC,CAAC;CACf;AA+ED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,CAAC,aAAa,CAAC,CAmBjC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAkBjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,CAAC,aAAa,CAAC,CAkBjC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAwB/F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAkB7F"}

package/dist/schemas/arg-validators.js

@@ -0,0 +1,193 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file arg-validators.ts
+ * @description CLI argument validators using shared schemas (WU-1431)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments.
+ * They handle:
+ * - CLI-only alias mapping (codePath -> code_paths, manualTest -> test_paths_manual)
+ * - Conditional validation (skip_gates requires reason)
+ * - Normalized output for consistent downstream processing
+ */
+import { wuCreateSchema, wuClaimSchema, wuStatusSchema, wuDoneSchema, gatesSchema, } from './command-schemas.js';
+import { getCliOnlyAliases } from './schema-utils.js';
+// =============================================================================
+// CLI Alias Mapping
+// =============================================================================
+/**
+ * Map CLI-only aliases to their canonical field names
+ *
+ * @param args - Raw CLI arguments (may include aliases)
+ * @returns Arguments with aliases mapped to canonical names
+ */
+function mapCliAliases(args) {
+    const aliases = getCliOnlyAliases();
+    const result = { ...args };
+    for (const [aliasName, aliasDef] of Object.entries(aliases)) {
+        if (aliasName in result) {
+            const canonicalName = aliasDef.canonical;
+            // Merge alias value into canonical field (arrays are concatenated)
+            const aliasValue = result[aliasName];
+            const canonicalValue = result[canonicalName];
+            if (Array.isArray(aliasValue)) {
+                if (Array.isArray(canonicalValue)) {
+                    result[canonicalName] = [...canonicalValue, ...aliasValue];
+                }
+                else {
+                    result[canonicalName] = aliasValue;
+                }
+            }
+            else {
+                result[canonicalName] = aliasValue;
+            }
+            // Remove the alias field
+            delete result[aliasName];
+        }
+    }
+    return result;
+}
+/**
+ * Format Zod errors into human-readable strings
+ */
+function formatZodErrors(error) {
+    return error.issues.map((issue) => {
+        // Convert path to string (filter out symbols)
+        const path = issue.path.filter((p) => typeof p !== 'symbol').join('.');
+        // Handle required field errors (Zod 4 uses invalid_type with "received undefined")
+        if (issue.code === 'invalid_type' && issue.message.includes('received undefined')) {
+            return `${path} is required`;
+        }
+        if (issue.message === 'Required') {
+            return `${path} is required`;
+        }
+        return `${path}: ${issue.message}`;
+    });
+}
+// =============================================================================
+// Validators
+// =============================================================================
+/**
+ * Validate wu:create arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuCreateInput
+ */
+export function validateWuCreateArgs(args) {
+    const mapped = mapCliAliases(args);
+    const result = wuCreateSchema.safeParse(mapped);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: mapped,
+    };
+}
+/**
+ * Validate wu:claim arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuClaimInput
+ */
+export function validateWuClaimArgs(args) {
+    const result = wuClaimSchema.safeParse(args);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: args,
+    };
+}
+/**
+ * Validate wu:status arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuStatusInput
+ */
+export function validateWuStatusArgs(args) {
+    const result = wuStatusSchema.safeParse(args);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: args,
+    };
+}
+/**
+ * Validate wu:done arguments
+ *
+ * Includes additional validation: skip_gates requires reason
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuDoneInput
+ */
+export function validateWuDoneArgs(args) {
+    const result = wuDoneSchema.safeParse(args);
+    if (!result.success) {
+        return {
+            valid: false,
+            errors: formatZodErrors(result.error),
+            warnings: [],
+            normalized: args,
+        };
+    }
+    // Additional validation: skip_gates requires reason
+    const errors = [];
+    if (result.data.skip_gates && !result.data.reason) {
+        errors.push('skip_gates requires reason to be provided');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: [],
+        normalized: result.data,
+    };
+}
+/**
+ * Validate gates arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized GatesInput
+ */
+export function validateGatesArgs(args) {
+    const result = gatesSchema.safeParse(args);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: args,
+    };
+}
+//# sourceMappingURL=arg-validators.js.map

package/dist/schemas/arg-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-validators.js","sourceRoot":"","sources":["../../src/schemas/arg-validators.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,GAMZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAgBtD,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAA6B;IAClD,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;YACzC,mEAAmE;YACnE,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YAE7C,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;oBAClC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,cAAc,EAAE,GAAG,UAAU,CAAC,CAAC;gBAC7D,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;gBACrC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;YACrC,CAAC;YAED,yBAAyB;YACzB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAkBD;;GAEG;AACH,SAAS,eAAe,CAAC,KAAmB;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,8CAA8C;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7F,mFAAmF;QACnF,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAClF,OAAO,GAAG,IAAI,cAAc,CAAC;QAC/B,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,GAAG,IAAI,cAAc,CAAC;QAC/B,CAAC;QACD,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA6B;IAE7B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAuB;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAoB;KACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA6B;IAE7B,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAqB;KAClC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;YACrC,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,IAAmB;SAChC,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC,IAAI;KACxB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA6B;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAkB;KAC/B,CAAC;AACJ,CAAC"}

package/dist/schemas/cloud-config.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Cloud Auto-Detection Configuration Schemas
+ *
+ * Cloud mode auto-detection via environment signals for branch-PR workflows.
+ *
+ * @module schemas/cloud-config
+ */
+import { z } from 'zod';
+/**
+ * WU-1495: Cloud environment signal configuration
+ *
+ * Defines an environment variable to check during cloud auto-detection.
+ * When `equals` is omitted, presence of the variable (non-empty) triggers detection.
+ * When `equals` is provided, the variable value must match exactly.
+ *
+ * All signals are user-configured; no vendor-specific signals are hardcoded.
+ *
+ * @example
+ * ```yaml
+ * cloud:
+ *   env_signals:
+ *     - name: CI                    # presence check
+ *     - name: GITHUB_ACTIONS
+ *       equals: 'true'              # exact match
+ *     - name: CODEX
+ * ```
+ */
+export declare const CloudEnvSignalSchema: z.ZodObject<{
+    name: z.ZodString;
+    equals: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** WU-1495: TypeScript type for cloud env signal */
+export type CloudEnvSignal = z.infer<typeof CloudEnvSignalSchema>;
+/**
+ * WU-1495: Cloud auto-detection configuration schema
+ *
+ * Controls opt-in cloud mode auto-detection via environment signals.
+ * Explicit activation (--cloud flag or LUMENFLOW_CLOUD=1) always takes
+ * precedence over auto-detection, regardless of these settings.
+ *
+ * Detection precedence:
+ * 1. --cloud CLI flag (always wins)
+ * 2. LUMENFLOW_CLOUD=1 env var (always wins)
+ * 3. env_signals (only when auto_detect=true)
+ *
+ * @example
+ * ```yaml
+ * cloud:
+ *   auto_detect: true
+ *   env_signals:
+ *     - name: CI
+ *     - name: CODEX
+ *     - name: GITHUB_ACTIONS
+ *       equals: 'true'
+ * ```
+ */
+export declare const CloudConfigSchema: z.ZodObject<{
+    auto_detect: z.ZodDefault<z.ZodBoolean>;
+    env_signals: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        equals: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** WU-1495: TypeScript type for cloud config */
+export type CloudConfig = z.infer<typeof CloudConfigSchema>;
+//# sourceMappingURL=cloud-config.d.ts.map

package/dist/schemas/cloud-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-config.d.ts","sourceRoot":"","sources":["../../src/schemas/cloud-config.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB;;;iBAY/B,CAAC;AAEH,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAgB5B,CAAC;AAEH,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/cloud-config.js

@@ -0,0 +1,81 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Cloud Auto-Detection Configuration Schemas
+ *
+ * Cloud mode auto-detection via environment signals for branch-PR workflows.
+ *
+ * @module schemas/cloud-config
+ */
+import { z } from 'zod';
+/**
+ * WU-1495: Cloud environment signal configuration
+ *
+ * Defines an environment variable to check during cloud auto-detection.
+ * When `equals` is omitted, presence of the variable (non-empty) triggers detection.
+ * When `equals` is provided, the variable value must match exactly.
+ *
+ * All signals are user-configured; no vendor-specific signals are hardcoded.
+ *
+ * @example
+ * ```yaml
+ * cloud:
+ *   env_signals:
+ *     - name: CI                    # presence check
+ *     - name: GITHUB_ACTIONS
+ *       equals: 'true'              # exact match
+ *     - name: CODEX
+ * ```
+ */
+export const CloudEnvSignalSchema = z.object({
+    /**
+     * Environment variable name to check.
+     * Must be non-empty.
+     */
+    name: z.string().min(1),
+    /**
+     * Optional exact value to match against.
+     * When omitted, presence of a non-empty value is sufficient.
+     */
+    equals: z.string().optional(),
+});
+/**
+ * WU-1495: Cloud auto-detection configuration schema
+ *
+ * Controls opt-in cloud mode auto-detection via environment signals.
+ * Explicit activation (--cloud flag or LUMENFLOW_CLOUD=1) always takes
+ * precedence over auto-detection, regardless of these settings.
+ *
+ * Detection precedence:
+ * 1. --cloud CLI flag (always wins)
+ * 2. LUMENFLOW_CLOUD=1 env var (always wins)
+ * 3. env_signals (only when auto_detect=true)
+ *
+ * @example
+ * ```yaml
+ * cloud:
+ *   auto_detect: true
+ *   env_signals:
+ *     - name: CI
+ *     - name: CODEX
+ *     - name: GITHUB_ACTIONS
+ *       equals: 'true'
+ * ```
+ */
+export const CloudConfigSchema = z.object({
+    /**
+     * Enable env-signal auto-detection for cloud mode.
+     * When false (default), only explicit activation (--cloud / LUMENFLOW_CLOUD=1) works.
+     * When true, env_signals are also checked.
+     * @default false
+     */
+    auto_detect: z.boolean().default(false),
+    /**
+     * Environment signals to check when auto_detect is true.
+     * Each signal defines an environment variable name and optional value constraint.
+     * Signals are checked in order; first match activates cloud mode.
+     * @default []
+     */
+    env_signals: z.array(CloudEnvSignalSchema).default([]),
+});
+//# sourceMappingURL=cloud-config.js.map

package/dist/schemas/cloud-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-config.js","sourceRoot":"","sources":["../../src/schemas/cloud-config.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAKH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC;;;;;OAKG;IACH,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEvC;;;;;OAKG;IACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC"}