@lumenflow/core 3.1.2 → 3.2.0

package/dist/orchestration-rules.d.ts

@@ -1,60 +0,0 @@
-import { type MandatoryAgentName } from './domain/orchestration.constants.js';
-type SuggestionPriority = 'high' | 'medium' | 'low';
-interface WUProgressRecord {
-    wuId: string;
-    dodProgress: number;
-    dodTotal: number;
-    agents: Record<string, string>;
-}
-interface OrchestrationSuggestion {
-    id: string;
-    priority: SuggestionPriority;
-    action: string;
-    reason: string;
-    command: string;
-}
-/**
- * Detect mandatory agents that should be invoked based on code paths.
- *
- * Uses minimatch glob patterns from MANDATORY_TRIGGERS to determine
- * which agents are required for the given file paths.
- *
- * @param {readonly string[]} codePaths - Array of file paths being touched by the WU
- * @returns {MandatoryAgentName[]} Array of unique mandatory agent names that should be invoked
- */
-export declare function detectMandatoryAgents(codePaths: readonly string[]): MandatoryAgentName[];
-/**
- * Generate suggestions for next actions based on WU progress and agent history.
- *
- * @param {readonly object[]} wuProgress - Array of WU progress records
- * @param {object} _agentHistory - Record of agent metrics (reserved for future use)
- * @returns {object[]} Array of prioritised suggestions
- */
-export declare function generateSuggestions(wuProgress: readonly WUProgressRecord[], _agentHistory?: Record<string, unknown>): OrchestrationSuggestion[];
-/**
- * WU-1542: Build a formatted error message for mandatory agent enforcement failures.
- *
- * @param {string} wuId - Work Unit ID
- * @param {readonly string[]} missingAgents - Array of mandatory agent names that were not invoked
- * @param {readonly string[]} codePaths - Array of file paths that triggered the agents
- * @returns {string} Formatted error message string
- */
-export declare function buildMandatoryAgentsErrorMessage(wuId: string, missingAgents: readonly string[], codePaths: readonly string[]): string;
-/**
- * WU-1542: Check mandatory agent compliance with optional blocking mode.
- *
- * @param {readonly string[]} codePaths - Array of file paths being touched by the WU
- * @param {string} wuId - Work Unit ID for error message context
- * @param {{ blocking: boolean }} options - Options including blocking mode flag
- * @returns {{ compliant: boolean, blocking: boolean, missing: string[], errorMessage?: string }}
- */
-export declare function checkMandatoryAgentsComplianceBlocking(codePaths: readonly string[], wuId: string, options: {
-    blocking: boolean;
-}): {
-    compliant: boolean;
-    blocking: boolean;
-    missing: string[];
-    errorMessage?: string;
-};
-export {};
-//# sourceMappingURL=orchestration-rules.d.ts.map

package/dist/orchestration-rules.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestration-rules.d.ts","sourceRoot":"","sources":["../src/orchestration-rules.ts"],"names":[],"mappings":"AAeA,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAQlG,KAAK,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,UAAU,uBAAuB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAqBxF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,gBAAgB,EAAE,EACvC,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1C,uBAAuB,EAAE,CAsB3B;AAgFD;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,CA0CR;AAED;;;;;;;GAOG;AACH,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BrF"}

package/dist/orchestration-rules.js

@@ -1,212 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Orchestration Rules
- *
- * Pure functions for agent detection and suggestion generation.
- * Uses minimatch for glob pattern matching (NOT regex).
- *
- * @module orchestration-rules
- * @see {@link ./domain/orchestration.constants.ts} - MANDATORY_TRIGGERS patterns
- * @see {@link https://lumenflow.dev/reference/agent-selection-guide/} - Agent selection rules
- */
-import { minimatch } from 'minimatch';
-import { MANDATORY_TRIGGERS } from './domain/orchestration.constants.js';
-/**
- * Threshold for considering a WU "near completion".
- * WUs with DoD progress >= this value trigger code-reviewer suggestion.
- */
-const NEAR_COMPLETION_THRESHOLD = 8;
-/**
- * Detect mandatory agents that should be invoked based on code paths.
- *
- * Uses minimatch glob patterns from MANDATORY_TRIGGERS to determine
- * which agents are required for the given file paths.
- *
- * @param {readonly string[]} codePaths - Array of file paths being touched by the WU
- * @returns {MandatoryAgentName[]} Array of unique mandatory agent names that should be invoked
- */
-export function detectMandatoryAgents(codePaths) {
-    if (codePaths.length === 0) {
-        return [];
-    }
-    const triggeredAgents = new Set();
-    for (const [agentName, patterns] of Object.entries(MANDATORY_TRIGGERS)) {
-        const isTriggered = codePaths.some((filePath) => patterns.some((pattern) => minimatch(filePath, pattern)));
-        if (isTriggered) {
-            triggeredAgents.add(agentName);
-        }
-    }
-    return Array.from(triggeredAgents);
-}
-/**
- * Generate suggestions for next actions based on WU progress and agent history.
- *
- * @param {readonly object[]} wuProgress - Array of WU progress records
- * @param {object} _agentHistory - Record of agent metrics (reserved for future use)
- * @returns {object[]} Array of prioritised suggestions
- */
-export function generateSuggestions(wuProgress, _agentHistory = {}) {
-    if (wuProgress.length === 0) {
-        return [];
-    }
-    const suggestions = [];
-    let suggestionCounter = 0;
-    for (const wu of wuProgress) {
-        const wuSuggestions = generateWUSuggestions(wu, () => ++suggestionCounter);
-        suggestions.push(...wuSuggestions);
-    }
-    // Sort by priority: high > medium > low
-    return suggestions.sort((a, b) => {
-        const priorityOrder = {
-            high: 0,
-            medium: 1,
-            low: 2,
-        };
-        return priorityOrder[a.priority] - priorityOrder[b.priority];
-    });
-}
-/**
- * Generate suggestions for a single WU.
- *
- * @param {object} wu - WU progress record
- * @param {function} nextId - Function to generate unique suggestion IDs
- * @returns {object[]} Array of suggestions for this WU
- */
-function generateWUSuggestions(wu, nextId) {
-    const suggestions = [];
-    // Check for pending mandatory agents (HIGH priority)
-    // Note: For LumenFlow framework development, MANDATORY_TRIGGERS is empty.
-    // Projects using LumenFlow can configure their own mandatory agents.
-    const mandatoryAgentNames = Object.keys(MANDATORY_TRIGGERS);
-    for (const agentName of mandatoryAgentNames) {
-        if (wu.agents[agentName] === 'pending') {
-            suggestions.push({
-                id: `sug-${nextId().toString().padStart(3, '0')}`,
-                priority: 'high',
-                action: `Run ${agentName}`,
-                reason: `Mandatory agent pending for ${wu.wuId}`,
-                command: `pnpm orchestrate:run ${agentName} --wu ${wu.wuId}`,
-            });
-        }
-    }
-    // Check for code-reviewer near completion (MEDIUM priority)
-    const isNearCompletion = wu.dodProgress >= NEAR_COMPLETION_THRESHOLD;
-    const codeReviewerStatus = wu.agents['code-reviewer'];
-    const needsCodeReviewer = isNearCompletion && codeReviewerStatus !== 'pass' && codeReviewerStatus !== 'fail';
-    if (needsCodeReviewer) {
-        suggestions.push({
-            id: `sug-${nextId().toString().padStart(3, '0')}`,
-            priority: 'medium',
-            action: `Run code-reviewer`,
-            reason: `${wu.wuId} is near completion (${wu.dodProgress}/${wu.dodTotal})`,
-            command: `pnpm orchestrate:run code-reviewer --wu ${wu.wuId}`,
-        });
-    }
-    // Check for test-engineer when tests pending (LOW priority)
-    const testEngineerStatus = wu.agents['test-engineer'];
-    const needsTestEngineer = testEngineerStatus === 'pending';
-    if (needsTestEngineer) {
-        suggestions.push({
-            id: `sug-${nextId().toString().padStart(3, '0')}`,
-            priority: 'low',
-            action: `Run test-engineer`,
-            reason: `Tests pending for ${wu.wuId}`,
-            command: `pnpm orchestrate:run test-engineer --wu ${wu.wuId}`,
-        });
-    }
-    return suggestions;
-}
-/**
- * WU-1542: Agent trigger descriptions for error messages.
- * Maps agent names to human-readable descriptions of their trigger patterns.
- *
- * Note: For LumenFlow framework development, this is empty since we don't have
- * application-specific mandatory agents. Projects using LumenFlow should
- * configure their own trigger descriptions based on their domain requirements.
- */
-const AGENT_TRIGGER_DESCRIPTIONS = {
-// No mandatory agent triggers for LumenFlow framework development.
-// Example for application-specific triggers:
-// 'security-auditor': 'supabase/migrations/**, auth/**, rls/**',
-// 'llm-reviewer': 'prompts/**, llm/**',
-};
-/**
- * WU-1542: Build a formatted error message for mandatory agent enforcement failures.
- *
- * @param {string} wuId - Work Unit ID
- * @param {readonly string[]} missingAgents - Array of mandatory agent names that were not invoked
- * @param {readonly string[]} codePaths - Array of file paths that triggered the agents
- * @returns {string} Formatted error message string
- */
-export function buildMandatoryAgentsErrorMessage(wuId, missingAgents, codePaths) {
-    const lines = [
-        '',
-        '='.repeat(70),
-        ' MANDATORY AGENT ENFORCEMENT FAILED (--require-agents)',
-        '='.repeat(70),
-        '',
-        `WU ${wuId} cannot be completed because the following mandatory agents`,
-        'were not confirmed as invoked before wu:done:',
-        '',
-    ];
-    for (const agent of missingAgents) {
-        const description = AGENT_TRIGGER_DESCRIPTIONS[agent] || 'unknown patterns';
-        lines.push(`  - ${agent}`);
-        lines.push(`    Triggered by: ${description}`);
-    }
-    lines.push('');
-    lines.push('Code paths that triggered mandatory agents:');
-    for (const path of codePaths.slice(0, 5)) {
-        lines.push(`  - ${path}`);
-    }
-    if (codePaths.length > 5) {
-        lines.push(`  ... and ${codePaths.length - 5} more`);
-    }
-    lines.push('');
-    lines.push('Required action:');
-    lines.push('  1. Invoke the required agents BEFORE calling wu:done');
-    lines.push("  2. Check your project's mandatory agent configuration");
-    lines.push('  3. Consult agent documentation for compliance requirements');
-    lines.push('');
-    lines.push('To bypass (only if appropriate for your project):');
-    lines.push('  Remove --require-agents flag from wu:done command');
-    lines.push('');
-    lines.push('See: https://lumenflow.dev/reference/agent-selection-guide/ for agent invocation guidance');
-    lines.push('='.repeat(70));
-    return lines.join('\n');
-}
-/**
- * WU-1542: Check mandatory agent compliance with optional blocking mode.
- *
- * @param {readonly string[]} codePaths - Array of file paths being touched by the WU
- * @param {string} wuId - Work Unit ID for error message context
- * @param {{ blocking: boolean }} options - Options including blocking mode flag
- * @returns {{ compliant: boolean, blocking: boolean, missing: string[], errorMessage?: string }}
- */
-export function checkMandatoryAgentsComplianceBlocking(codePaths, wuId, options) {
-    const missingAgents = detectMandatoryAgents(codePaths);
-    if (missingAgents.length === 0) {
-        return {
-            compliant: true,
-            blocking: false,
-            missing: [],
-        };
-    }
-    // Non-blocking mode: return compliance info without error message
-    if (!options.blocking) {
-        return {
-            compliant: false,
-            blocking: false,
-            missing: missingAgents,
-        };
-    }
-    // Blocking mode: generate error message
-    return {
-        compliant: false,
-        blocking: true,
-        missing: missingAgents,
-        errorMessage: buildMandatoryAgentsErrorMessage(wuId, missingAgents, codePaths),
-    };
-}
-//# sourceMappingURL=orchestration-rules.js.map

package/dist/orchestration-rules.js.map

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

package/dist/orphan-detector.d.ts

@@ -1,148 +0,0 @@
-/**
- * Orphan Worktree Detector (WU-1476)
- *
- * Detects orphan directories in worktrees/ that are not tracked by git worktree.
- * Orphan directories can occur when wu:done fails mid-workflow due to:
- * - Backlog sync issues
- * - Formatting errors
- * - Typecheck failures
- * - Recovery mode interruptions
- *
- * Multi-layer defense strategy:
- * - Layer 1: Explicit cleanup in git-adapter.worktreeRemove()
- * - Layer 2: Orphan detection in wu:prune (this module)
- * - Layer 3: Pre-flight check in wu:claim
- * - Layer 4: Manual utility wu:cleanup-orphans
- *
- * @see {@link packages/@lumenflow/cli/src/wu-prune.ts} - Primary consumer
- * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Pre-flight orphan check
- * @see {@link packages/@lumenflow/cli/src/lib/git-adapter.ts} - worktreeRemove with cleanup
- */
-import { existsSync } from 'node:fs';
-/**
- * Result of orphan detection
- * @typedef {object} OrphanDetectionResult
- * @property {string[]} orphans - List of orphan directory paths (absolute)
- * @property {string[]} tracked - List of tracked worktree paths (absolute)
- * @property {string[]} errors - List of error messages encountered during detection
- */
-/**
- * Parsed worktree entry from git worktree list --porcelain
- */
-interface WorktreeEntry {
-    /** Absolute path to worktree */
-    path: string;
-    /** HEAD commit SHA */
-    head?: string;
-    /** Branch name (without refs/heads/ prefix) */
-    branch?: string;
-}
-/**
- * Parse git worktree list --porcelain output into structured entries
- *
- * @param {string} porcelainOutput - Output from git worktree list --porcelain
- * @returns {WorktreeEntry[]} Parsed worktree entries
- */
-export declare function parseWorktreeList(porcelainOutput: string): WorktreeEntry[];
-/**
- * Get set of tracked worktree paths from git
- *
- * @param {string} [projectRoot] - Project root directory (defaults to cwd)
- * @returns {Promise<Set<string>>} Set of absolute paths tracked by git worktree
- */
-export declare function getTrackedWorktreePaths(projectRoot: UnsafeAny): Promise<Set<string>>;
-/**
- * Identify tracked worktrees that are missing on disk
- *
- * @param {string[]} trackedPaths - Absolute paths from git worktree list
- * @param {(path: string) => boolean} [existsFn] - Optional fs.existsSync override
- * @returns {string[]} Missing worktree paths
- */
-export declare function getMissingWorktreesFromTracked(trackedPaths: UnsafeAny, existsFn?: typeof existsSync): any[];
-/**
- * Detect tracked worktrees that are missing on disk
- *
- * @param {string} [projectRoot] - Project root directory (defaults to cwd)
- * @returns {Promise<string[]>} Missing tracked worktree paths
- */
-export declare function detectMissingTrackedWorktrees(projectRoot: UnsafeAny): Promise<any[]>;
-/**
- * Get list of directories in worktrees/ folder
- *
- * @param {string} projectRoot - Absolute path to project root
- * @returns {string[]} List of absolute paths to directories in worktrees/
- */
-export declare function getWorktreeDirectories(projectRoot: UnsafeAny): string[];
-/**
- * Detect orphan worktree directories
- *
- * Compares directories in worktrees/ against git worktree list to find
- * directories that exist on disk but are not tracked by git.
- *
- * @param {string} [projectRoot] - Project root directory (defaults to cwd)
- * @returns {Promise<OrphanDetectionResult>} Detection result with orphans and tracked paths
- */
-export declare function detectOrphanWorktrees(projectRoot: UnsafeAny): Promise<{
-    orphans: string[];
-    tracked: string[];
-    errors: string[];
-}>;
-/**
- * Check if a specific worktree path is an orphan
- *
- * Used by wu:claim for pre-flight checks before creating a worktree.
- *
- * @param {string} worktreePath - Absolute path to check
- * @param {string} [projectRoot] - Project root directory (defaults to cwd)
- * @returns {Promise<boolean>} True if the path exists but is not tracked by git
- */
-export declare function isOrphanWorktree(worktreePath: UnsafeAny, projectRoot: UnsafeAny): Promise<boolean>;
-/**
- * Options for removing orphan directories
- */
-export interface RemoveOrphanDirectoryOptions {
-    /** If true, don't actually remove */
-    dryRun?: boolean;
-}
-/**
- * Remove an orphan directory
- *
- * Safely removes an orphan worktree directory from disk.
- * Only removes directories that are confirmed orphans.
- *
- * @param {string} orphanPath - Absolute path to orphan directory
- * @param {RemoveOrphanDirectoryOptions} [options] - Options
- * @returns {Promise<{removed: boolean, path: string, error?: string}>} Result
- */
-export declare function removeOrphanDirectory(orphanPath: UnsafeAny, options?: RemoveOrphanDirectoryOptions): Promise<{
-    removed: boolean;
-    path: any;
-    error: string;
-    dryRun?: undefined;
-} | {
-    removed: boolean;
-    path: any;
-    dryRun: boolean;
-    error?: undefined;
-} | {
-    removed: boolean;
-    path: any;
-    error?: undefined;
-    dryRun?: undefined;
-}>;
-/**
- * Clean up all orphan directories
- *
- * Detects and removes all orphan worktree directories.
- *
- * @param {string} [projectRoot] - Project root directory (defaults to cwd)
- * @param {RemoveOrphanDirectoryOptions} [options] - Options
- * @returns {Promise<{detected: number, removed: number, errors: string[]}>} Summary
- */
-export declare function cleanupOrphanDirectories(projectRoot: UnsafeAny, options?: RemoveOrphanDirectoryOptions): Promise<{
-    detected: number;
-    removed: number;
-    errors: string[];
-}>;
-export {};
-//# sourceMappingURL=orphan-detector.d.ts.map

package/dist/orphan-detector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orphan-detector.d.ts","sourceRoot":"","sources":["../src/orphan-detector.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAyB,UAAU,EAAU,MAAM,SAAS,CAAC;AAKpE;;;;;;GAMG;AAEH;;GAEG;AACH,UAAU,aAAa;IACrB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,EAAE,CAmC1E;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,SAAS,wBAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,oBAAa,SAK5F;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,WAAW,EAAE,SAAS,kBAIzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,YAe5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,SAAS;;;;GAyBjE;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,oBASrF;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,SAAS,EACrB,OAAO,GAAE,4BAAiC;;;;;;;;;;;;;;;GA0C3C;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,SAAS,EACtB,OAAO,GAAE,4BAAiC;;;;GAqB3C"}