@lumenflow/core 3.1.2 → 3.1.3

package/dist/spawn-registry-store.d.ts

@@ -1,161 +0,0 @@
-/**
- * Spawn Registry Store (WU-1944)
- *
- * Event-sourced state store for tracking sub-agent spawns.
- * Stores events in .lumenflow/state/spawn-registry.jsonl (append-only, git-friendly).
- *
- * Features:
- * - Event sourcing with replay for current state
- * - Atomic append operations
- * - O(1) queries by parent WU, target WU, and status
- *
- * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-registry-store.test.ts} - Tests
- * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-schema.ts} - Schema definitions
- */
-import { type SpawnEvent, type SpawnIntentValue } from './spawn-registry-schema.js';
-/**
- * Spawn registry file name constant
- */
-export declare const SPAWN_REGISTRY_FILE_NAME = "spawn-registry.jsonl";
-/**
- * Spawn Registry Store class
- *
- * Manages spawn registry state via event sourcing pattern.
- * Events are appended to JSONL file, state is rebuilt by replaying events.
- */
-export declare class SpawnRegistryStore {
-    private readonly baseDir;
-    private readonly registryFilePath;
-    private readonly spawns;
-    private readonly byParent;
-    private readonly byTarget;
-    /**
-     * @param {string} baseDir - Directory containing .lumenflow/state/
-     */
-    constructor(baseDir: string);
-    /**
-     * Loads and replays events from JSONL file into current state.
-     *
-     * Handles:
-     * - Missing file: returns empty state
-     * - Empty file: returns empty state
-     * - Empty lines: skipped gracefully
-     * - Malformed JSON: throws error with line info
-     * - Invalid events: throws validation error
-     *
-     * @returns {Promise<void>}
-     * @throws {Error} If file contains malformed JSON or invalid events
-     *
-     * @example
-     * const store = new SpawnRegistryStore('/path/to/project');
-     * await store.load();
-     * const pending = store.getPending();
-     */
-    load(): Promise<void>;
-    /**
-     * Applies an event to the in-memory state.
-     * If event for same spawn ID exists, updates it (latest wins).
-     *
-     * @private
-     */
-    private _applyEvent;
-    /**
-     * Appends an event to the registry file.
-     *
-     * Uses append mode to avoid full file rewrite.
-     * Creates file and parent directories if they don't exist.
-     * Validates event before appending.
-     *
-     * @private
-     * @throws {Error} If event fails validation
-     */
-    private _appendEvent;
-    /**
-     * Records a new spawn event with pending status.
-     *
-     * @param {string} parentWuId - Parent WU ID (orchestrator)
-     * @param {string} targetWuId - Target WU ID (spawned work)
-     * @param {string} lane - Lane for the spawned work
-     * @param {SpawnIntentValue} [intent] - Optional intent source (e.g., delegation)
-     * @returns {Promise<string>} The generated spawn ID
-     * @throws {Error} If validation fails
-     *
-     * @example
-     * const spawnId = await store.record('WU-1000', 'WU-1001', 'Operations: Tooling');
-     */
-    record(parentWuId: string, targetWuId: string, lane: string, intent?: SpawnIntentValue): Promise<string>;
-    /**
-     * Updates the status of a spawn.
-     *
-     * @param {string} spawnId - Spawn ID to update
-     * @param {string} status - New status
-     * @returns {Promise<void>}
-     * @throws {Error} If spawn ID not found
-     *
-     * @example
-     * await store.updateStatus('spawn-a1b2', 'completed');
-     */
-    updateStatus(spawnId: string, status: string): Promise<void>;
-    /**
-     * Records claim-time pickup evidence for a spawn entry.
-     *
-     * WU-1605: This distinguishes intent-only delegation records from
-     * delegated work that was actually picked up via wu:claim.
-     *
-     * @param {string} spawnId - Spawn ID to update
-     * @param {string} pickedUpBy - Agent identity that claimed the target WU
-     * @param {string} [pickedUpAt] - Optional ISO timestamp (defaults to now)
-     * @returns {Promise<void>}
-     * @throws {Error} If spawn ID not found
-     */
-    recordPickup(spawnId: string, pickedUpBy: string, pickedUpAt?: string): Promise<void>;
-    /**
-     * Gets all spawns for a parent WU.
-     *
-     * @param {string} parentWuId - Parent WU ID
-     * @returns {SpawnEvent[]} Array of spawn events
-     *
-     * @example
-     * const spawns = store.getByParent('WU-1000');
-     */
-    getByParent(parentWuId: string): SpawnEvent[];
-    /**
-     * Gets spawn for a target WU.
-     *
-     * @param {string} targetWuId - Target WU ID
-     * @returns {SpawnEvent | null} Spawn event or null
-     *
-     * @example
-     * const spawn = store.getByTarget('WU-1001');
-     */
-    getByTarget(targetWuId: string): SpawnEvent | null;
-    /**
-     * Gets all pending spawns.
-     *
-     * @returns {SpawnEvent[]} Array of pending spawn events
-     *
-     * @example
-     * const pending = store.getPending();
-     */
-    getPending(): SpawnEvent[];
-    /**
-     * Gets all spawns as an array.
-     *
-     * @returns {SpawnEvent[]} Array of all spawn events
-     *
-     * @example
-     * const allSpawns = store.getAllSpawns();
-     */
-    getAllSpawns(): SpawnEvent[];
-    /**
-     * Gets spawn by ID.
-     *
-     * @param {string} spawnId - Spawn ID
-     * @returns {SpawnEvent | null} Spawn event or null
-     *
-     * @example
-     * const spawn = store.getById('spawn-a1b2');
-     */
-    getById(spawnId: string): SpawnEvent | null;
-}
-//# sourceMappingURL=spawn-registry-store.d.ts.map

package/dist/spawn-registry-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn-registry-store.d.ts","sourceRoot":"","sources":["../src/spawn-registry-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C;;OAEG;gBACS,OAAO,EAAE,MAAM;IAc3B;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD3B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAmBnB;;;;;;;;;OASG;YACW,YAAY;IAmB1B;;;;;;;;;;;;OAYG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC;IAoBlB;;;;;;;;;;OAUG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlE;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3F;;;;;;;;OAQG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE;IAO7C;;;;;;;;OAQG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQlD;;;;;;;OAOG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;;;;;;OAOG;IACH,YAAY,IAAI,UAAU,EAAE;IAI5B;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;CAG5C"}

package/dist/spawn-registry-store.js

@@ -1,301 +0,0 @@
-/**
- * Spawn Registry Store (WU-1944)
- *
- * Event-sourced state store for tracking sub-agent spawns.
- * Stores events in .lumenflow/state/spawn-registry.jsonl (append-only, git-friendly).
- *
- * Features:
- * - Event sourcing with replay for current state
- * - Atomic append operations
- * - O(1) queries by parent WU, target WU, and status
- *
- * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-registry-store.test.ts} - Tests
- * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-schema.ts} - Schema definitions
- */
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { validateSpawnEvent, generateSpawnId, SpawnStatus, } from './spawn-registry-schema.js';
-/**
- * Spawn registry file name constant
- */
-export const SPAWN_REGISTRY_FILE_NAME = 'spawn-registry.jsonl';
-/**
- * Spawn Registry Store class
- *
- * Manages spawn registry state via event sourcing pattern.
- * Events are appended to JSONL file, state is rebuilt by replaying events.
- */
-export class SpawnRegistryStore {
-    baseDir;
-    registryFilePath;
-    spawns;
-    byParent;
-    byTarget;
-    /**
-     * @param {string} baseDir - Directory containing .lumenflow/state/
-     */
-    constructor(baseDir) {
-        this.baseDir = baseDir;
-        this.registryFilePath = path.join(baseDir, SPAWN_REGISTRY_FILE_NAME);
-        // In-memory state (rebuilt from events)
-        this.spawns = new Map();
-        // Index: parentWuId -> spawnIds[]
-        this.byParent = new Map();
-        // Index: targetWuId -> spawnId
-        this.byTarget = new Map();
-    }
-    /**
-     * Loads and replays events from JSONL file into current state.
-     *
-     * Handles:
-     * - Missing file: returns empty state
-     * - Empty file: returns empty state
-     * - Empty lines: skipped gracefully
-     * - Malformed JSON: throws error with line info
-     * - Invalid events: throws validation error
-     *
-     * @returns {Promise<void>}
-     * @throws {Error} If file contains malformed JSON or invalid events
-     *
-     * @example
-     * const store = new SpawnRegistryStore('/path/to/project');
-     * await store.load();
-     * const pending = store.getPending();
-     */
-    async load() {
-        // Reset state
-        this.spawns.clear();
-        this.byParent.clear();
-        this.byTarget.clear();
-        // Check if file exists
-        let content;
-        try {
-            content = await fs.readFile(this.registryFilePath, 'utf-8');
-        }
-        catch (error) {
-            if (error.code === 'ENOENT') {
-                // File doesn't exist - return empty state
-                return;
-            }
-            throw error;
-        }
-        // Parse JSONL content
-        const lines = content.split('\n');
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i].trim();
-            // Skip empty lines
-            if (!line) {
-                continue;
-            }
-            // Parse JSON line
-            let parsed;
-            try {
-                parsed = JSON.parse(line);
-            }
-            catch (error) {
-                throw new Error(`Malformed JSON on line ${i + 1}: ${error.message}`);
-            }
-            // Validate against schema
-            const validation = validateSpawnEvent(parsed);
-            if (!validation.success) {
-                const issues = validation.error.issues
-                    .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
-                    .join(', ');
-                throw new Error(`Validation error on line ${i + 1}: ${issues}`);
-            }
-            const event = validation.data;
-            // Apply event to state (latest event for same ID wins)
-            this._applyEvent(event);
-        }
-    }
-    /**
-     * Applies an event to the in-memory state.
-     * If event for same spawn ID exists, updates it (latest wins).
-     *
-     * @private
-     */
-    _applyEvent(event) {
-        const { id, parentWuId, targetWuId } = event;
-        // Update main state map
-        this.spawns.set(id, event);
-        // Update parent index
-        if (!this.byParent.has(parentWuId)) {
-            this.byParent.set(parentWuId, []);
-        }
-        const parentSpawns = this.byParent.get(parentWuId);
-        if (!parentSpawns.includes(id)) {
-            parentSpawns.push(id);
-        }
-        // Update target index
-        this.byTarget.set(targetWuId, id);
-    }
-    /**
-     * Appends an event to the registry file.
-     *
-     * Uses append mode to avoid full file rewrite.
-     * Creates file and parent directories if they don't exist.
-     * Validates event before appending.
-     *
-     * @private
-     * @throws {Error} If event fails validation
-     */
-    async _appendEvent(event) {
-        // Validate event before appending
-        const validation = validateSpawnEvent(event);
-        if (!validation.success) {
-            const issues = validation.error.issues
-                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
-                .join(', ');
-            throw new Error(`Validation error: ${issues}`);
-        }
-        const line = JSON.stringify(event) + '\n';
-        // Ensure parent directory exists before appending
-        await fs.mkdir(this.baseDir, { recursive: true });
-        // Use append flag to avoid rewriting the file
-        await fs.appendFile(this.registryFilePath, line, 'utf-8');
-    }
-    /**
-     * Records a new spawn event with pending status.
-     *
-     * @param {string} parentWuId - Parent WU ID (orchestrator)
-     * @param {string} targetWuId - Target WU ID (spawned work)
-     * @param {string} lane - Lane for the spawned work
-     * @param {SpawnIntentValue} [intent] - Optional intent source (e.g., delegation)
-     * @returns {Promise<string>} The generated spawn ID
-     * @throws {Error} If validation fails
-     *
-     * @example
-     * const spawnId = await store.record('WU-1000', 'WU-1001', 'Operations: Tooling');
-     */
-    async record(parentWuId, targetWuId, lane, intent) {
-        const id = generateSpawnId(parentWuId, targetWuId);
-        const event = {
-            id,
-            parentWuId,
-            targetWuId,
-            lane,
-            ...(intent ? { intent } : {}),
-            spawnedAt: new Date().toISOString(),
-            status: SpawnStatus.PENDING,
-            completedAt: null,
-        };
-        await this._appendEvent(event);
-        this._applyEvent(event);
-        return id;
-    }
-    /**
-     * Updates the status of a spawn.
-     *
-     * @param {string} spawnId - Spawn ID to update
-     * @param {string} status - New status
-     * @returns {Promise<void>}
-     * @throws {Error} If spawn ID not found
-     *
-     * @example
-     * await store.updateStatus('spawn-a1b2', 'completed');
-     */
-    async updateStatus(spawnId, status) {
-        const existing = this.spawns.get(spawnId);
-        if (!existing) {
-            throw new Error(`Spawn ID ${spawnId} not found`);
-        }
-        const event = {
-            ...existing,
-            status: status,
-            completedAt: new Date().toISOString(),
-        };
-        await this._appendEvent(event);
-        this._applyEvent(event);
-    }
-    /**
-     * Records claim-time pickup evidence for a spawn entry.
-     *
-     * WU-1605: This distinguishes intent-only delegation records from
-     * delegated work that was actually picked up via wu:claim.
-     *
-     * @param {string} spawnId - Spawn ID to update
-     * @param {string} pickedUpBy - Agent identity that claimed the target WU
-     * @param {string} [pickedUpAt] - Optional ISO timestamp (defaults to now)
-     * @returns {Promise<void>}
-     * @throws {Error} If spawn ID not found
-     */
-    async recordPickup(spawnId, pickedUpBy, pickedUpAt) {
-        const existing = this.spawns.get(spawnId);
-        if (!existing) {
-            throw new Error(`Spawn ID ${spawnId} not found`);
-        }
-        const event = {
-            ...existing,
-            pickedUpBy,
-            pickedUpAt: pickedUpAt ?? new Date().toISOString(),
-        };
-        await this._appendEvent(event);
-        this._applyEvent(event);
-    }
-    /**
-     * Gets all spawns for a parent WU.
-     *
-     * @param {string} parentWuId - Parent WU ID
-     * @returns {SpawnEvent[]} Array of spawn events
-     *
-     * @example
-     * const spawns = store.getByParent('WU-1000');
-     */
-    getByParent(parentWuId) {
-        const spawnIds = this.byParent.get(parentWuId) ?? [];
-        return spawnIds
-            .map((id) => this.spawns.get(id))
-            .filter((event) => event !== undefined);
-    }
-    /**
-     * Gets spawn for a target WU.
-     *
-     * @param {string} targetWuId - Target WU ID
-     * @returns {SpawnEvent | null} Spawn event or null
-     *
-     * @example
-     * const spawn = store.getByTarget('WU-1001');
-     */
-    getByTarget(targetWuId) {
-        const spawnId = this.byTarget.get(targetWuId);
-        if (!spawnId) {
-            return null;
-        }
-        return this.spawns.get(spawnId) ?? null;
-    }
-    /**
-     * Gets all pending spawns.
-     *
-     * @returns {SpawnEvent[]} Array of pending spawn events
-     *
-     * @example
-     * const pending = store.getPending();
-     */
-    getPending() {
-        return Array.from(this.spawns.values()).filter((spawn) => spawn.status === SpawnStatus.PENDING);
-    }
-    /**
-     * Gets all spawns as an array.
-     *
-     * @returns {SpawnEvent[]} Array of all spawn events
-     *
-     * @example
-     * const allSpawns = store.getAllSpawns();
-     */
-    getAllSpawns() {
-        return Array.from(this.spawns.values());
-    }
-    /**
-     * Gets spawn by ID.
-     *
-     * @param {string} spawnId - Spawn ID
-     * @returns {SpawnEvent | null} Spawn event or null
-     *
-     * @example
-     * const spawn = store.getById('spawn-a1b2');
-     */
-    getById(spawnId) {
-        return this.spawns.get(spawnId) ?? null;
-    }
-}
-//# sourceMappingURL=spawn-registry-store.js.map

package/dist/spawn-registry-store.js.map

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

package/dist/spawn-strategy.d.ts

@@ -1,60 +0,0 @@
-/**
- * Strategy interface for client-specific spawn behavior
- */
-export interface SpawnStrategy {
-    /**
-     * Get the context loading preamble for the specific client
-     */
-    getPreamble(wuId: string): string;
-    /**
-     * Get instructions for loading agent skills/tools
-     */
-    getSkillLoadingInstruction(): string;
-}
-/**
- * Base class with shared preamble logic
- */
-declare abstract class BaseSpawnStrategy implements SpawnStrategy {
-    protected getCorePreamble(wuId: string): string;
-    abstract getPreamble(wuId: string): string;
-    /**
-     * Default skill loading instruction - shared by GenericStrategy and GeminiCliStrategy
-     * ClaudeCodeStrategy overrides this with Claude-specific paths
-     */
-    getSkillLoadingInstruction(): string;
-}
-/**
- * Strategy for Claude Code (Local/Terminal)
- */
-export declare class ClaudeCodeStrategy extends BaseSpawnStrategy {
-    getPreamble(wuId: string): string;
-    getSkillLoadingInstruction(): string;
-}
-/**
- * Strategy for Gemini CLI (Multimodal/Ecosystem)
- * Uses default getSkillLoadingInstruction from base class
- */
-export declare class GeminiCliStrategy extends BaseSpawnStrategy {
-    getPreamble(wuId: string): string;
-}
-/**
- * Generic Strategy (Unknown/Other clients)
- * Uses default getSkillLoadingInstruction from base class
- */
-export declare class GenericStrategy extends BaseSpawnStrategy {
-    getPreamble(wuId: string): string;
-}
-/**
- * Create a strategy for the given client
- * @param clientName - Client name (e.g. 'claude-code', 'codex-cli', 'gemini-cli')
- */
-export declare function createSpawnStrategy(clientName: string): SpawnStrategy;
-/**
- * Factory for creating strategies (legacy wrapper)
- * @deprecated Use createSpawnStrategy function directly
- */
-export declare const SpawnStrategyFactory: {
-    create: typeof createSpawnStrategy;
-};
-export {};
-//# sourceMappingURL=spawn-strategy.d.ts.map

package/dist/spawn-strategy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn-strategy.d.ts","sourceRoot":"","sources":["../src/spawn-strategy.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAElC;;OAEG;IACH,0BAA0B,IAAI,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,uBAAe,iBAAkB,YAAW,aAAa;IACvD,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW/C,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAE1C;;;OAGG;IACH,0BAA0B,IAAI,MAAM;CAMrC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiBjC,0BAA0B,IAAI,MAAM;CAOrC;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CASlC;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGlC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CA0BrE;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;CAEhC,CAAC"}

package/dist/spawn-strategy.js

@@ -1,112 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-import { existsSync } from 'node:fs';
-/**
- * Base class with shared preamble logic
- */
-class BaseSpawnStrategy {
-    getCorePreamble(wuId) {
-        return `Load the following context in this order:
-
-1. Read LUMENFLOW.md (workflow fundamentals and critical rules)
-2. Read .lumenflow/constraints.md (non-negotiable constraints)
-3. Read README.md (project structure and tech stack)
-4. Read docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md sections 1-7 (TDD, gates, Definition of Done)
-5. Read docs/04-operations/tasks/wu/${wuId}.yaml (the specific WU you're working on)
-6. Read docs/04-operations/_frameworks/lumenflow/agent/onboarding/quick-ref-commands.md (CLI tooling reference - USE THESE COMMANDS)`;
-    }
-    /**
-     * Default skill loading instruction - shared by GenericStrategy and GeminiCliStrategy
-     * ClaudeCodeStrategy overrides this with Claude-specific paths
-     */
-    getSkillLoadingInstruction() {
-        return `## Skills Selection
-
-1. Check \`.lumenflow/agents\` for available skills.
-2. Select relevant skills for this task.`;
-    }
-}
-/**
- * Strategy for Claude Code (Local/Terminal)
- */
-export class ClaudeCodeStrategy extends BaseSpawnStrategy {
-    getPreamble(wuId) {
-        let preamble = this.getCorePreamble(wuId);
-        // Vendor overlay
-        if (existsSync('.claude/CLAUDE.md')) {
-            // Insert after LUMENFLOW.md if possible, or just append/prepend
-            // For simplicity and clarity, we'll prepend the vendor specific instructions
-            // relying on the user to follow the specific order if stated.
-            // Actually, checking original behavior: CLAUDE.md was #1.
-            // But new plan says LUMENFLOW.md is core.
-            // We will append it as an overlay step.
-            preamble += `\n7. Read .claude/CLAUDE.md (Claude-specific workflow overlay)`;
-        }
-        return preamble;
-    }
-    getSkillLoadingInstruction() {
-        return `## Skills Selection
-    
-1. Check \`.lumenflow/agents\` for available skills.
-2. Check \`.claude/agents\` for Claude-specific overrides or additions.
-3. Select relevant skills for this task.`;
-    }
-}
-/**
- * Strategy for Gemini CLI (Multimodal/Ecosystem)
- * Uses default getSkillLoadingInstruction from base class
- */
-export class GeminiCliStrategy extends BaseSpawnStrategy {
-    getPreamble(wuId) {
-        let preamble = this.getCorePreamble(wuId);
-        if (existsSync('GEMINI.md')) {
-            preamble += `\n7. Read GEMINI.md (Gemini-specific workflow overlay)`;
-        }
-        return preamble;
-    }
-}
-/**
- * Generic Strategy (Unknown/Other clients)
- * Uses default getSkillLoadingInstruction from base class
- */
-export class GenericStrategy extends BaseSpawnStrategy {
-    getPreamble(wuId) {
-        return this.getCorePreamble(wuId);
-    }
-}
-/**
- * Create a strategy for the given client
- * @param clientName - Client name (e.g. 'claude-code', 'codex-cli', 'gemini-cli')
- */
-export function createSpawnStrategy(clientName) {
-    switch (clientName.toLowerCase()) {
-        case 'claude': // Legacy alias
-        case 'claude-code':
-            return new ClaudeCodeStrategy();
-        case 'gemini': // Alias
-        case 'gemini-cli':
-            return new GeminiCliStrategy();
-        case 'codex': // Deprecated alias
-        case 'codex-cli':
-            // Codex might need its own strategy later (sandbox), but for now generic or claude-like?
-            // Plan says: "codex: preamble: false, strategy: cloud-sandbox" -> implies Generic or dedicated.
-            // For now, let's map to Generic but maybe we should add CodexStrategy if it has diff behavior.
-            // Re-reading plan: "CodexStrategy: Emphasizes cloud sandbox constraints"
-            // But for this "Minimal" pass, let's stick to Generic with a comment,
-            // OR essentially treat it as Generic since we don't have constraints logic here yet (it's in wu-spawn).
-            // Actually, let's return GenericStrategy but we might handle constraints elsewhere.
-            return new GenericStrategy();
-        default:
-            // Warn? The factory just creates. The caller should warn if it fell back.
-            // But here we just return Generic.
-            return new GenericStrategy();
-    }
-}
-/**
- * Factory for creating strategies (legacy wrapper)
- * @deprecated Use createSpawnStrategy function directly
- */
-export const SpawnStrategyFactory = {
-    create: createSpawnStrategy,
-};
-//# sourceMappingURL=spawn-strategy.js.map

package/dist/spawn-strategy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn-strategy.js","sourceRoot":"","sources":["../src/spawn-strategy.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBrC;;GAEG;AACH,MAAe,iBAAiB;IACpB,eAAe,CAAC,IAAY;QACpC,OAAO;;;;;;sCAM2B,IAAI;qIAC2F,CAAC;IACpI,CAAC;IAID;;;OAGG;IACH,0BAA0B;QACxB,OAAO;;;yCAG8B,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,WAAW,CAAC,IAAY;QACtB,IAAI,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE1C,iBAAiB;QACjB,IAAI,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACpC,gEAAgE;YAChE,6EAA6E;YAC7E,8DAA8D;YAC9D,0DAA0D;YAC1D,0CAA0C;YAC1C,wCAAwC;YACxC,QAAQ,IAAI,gEAAgE,CAAC;QAC/E,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0BAA0B;QACxB,OAAO;;;;yCAI8B,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,WAAW,CAAC,IAAY;QACtB,IAAI,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,QAAQ,IAAI,wDAAwD,CAAC;QACvE,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,iBAAiB;IACpD,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,QAAQ,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,KAAK,QAAQ,CAAC,CAAC,eAAe;QAC9B,KAAK,aAAa;YAChB,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAElC,KAAK,QAAQ,CAAC,CAAC,QAAQ;QACvB,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,EAAE,CAAC;QAEjC,KAAK,OAAO,CAAC,CAAC,mBAAmB;QACjC,KAAK,WAAW;YACd,yFAAyF;YACzF,gGAAgG;YAChG,+FAA+F;YAC/F,yEAAyE;YACzE,sEAAsE;YACtE,wGAAwG;YACxG,oFAAoF;YACpF,OAAO,IAAI,eAAe,EAAE,CAAC;QAE/B;YACE,0EAA0E;YAC1E,mCAAmC;YACnC,OAAO,IAAI,eAAe,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,mBAAmB;CAC5B,CAAC"}