@lumenflow/core 3.2.0 → 3.2.1

package/dist/adapters/terminal-renderer.adapter.js

@@ -0,0 +1,344 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Terminal Dashboard Renderer Adapter
+ *
+ * Hexagonal Architecture - Infrastructure Layer
+ * Implements the DashboardRenderer port for terminal/CLI output.
+ *
+ * Follows Edward Tufte's data visualisation principles:
+ * - High data-ink ratio (minimal chartjunk)
+ * - Small multiples for comparison (agent metrics table)
+ * - 5-second scannable layout
+ * - Headline sentences for context
+ *
+ * Library-First Approach:
+ * - picocolors: Semantic ANSI colours (NOT raw escape codes)
+ * - cli-table3: ASCII table rendering
+ * - cli-progress: Progress bar rendering
+ *
+ * @module terminal-renderer.adapter
+ * @see {@link ../ports/dashboard-renderer.port.ts} - Port interface
+ * @see {@link ../domain/orchestration.types.ts} - Domain types
+ */
+import picocolors from 'picocolors';
+import Table from 'cli-table3';
+// WU-2010: Import display constants to eliminate magic numbers
+import { SECTION_SEPARATOR_WIDTH, PROGRESS_BAR_WIDTH as DISPLAY_PROGRESS_BAR_WIDTH, SEVERITY_LABEL_PAD_WIDTH, PASS_RATE_GREEN_THRESHOLD, PASS_RATE_YELLOW_THRESHOLD, MS_PER_HOUR, MS_PER_MINUTE, MS_PER_SECOND, } from '../constants/display-constants.js';
+// Constants for rendering (no magic strings)
+const SECTION_SEPARATOR = '\n' + '─'.repeat(SECTION_SEPARATOR_WIDTH) + '\n';
+const HEADER_PREFIX = '▸';
+const BULLET = '•';
+const CHECK_MARK = '✓';
+const CROSS_MARK = '✗';
+const PENDING_MARK = '○';
+const PROGRESS_BAR_WIDTH = DISPLAY_PROGRESS_BAR_WIDTH;
+// Severity colour mapping
+const SEVERITY_COLOURS = {
+    high: picocolors.red,
+    medium: picocolors.yellow,
+    low: picocolors.cyan,
+};
+// Agent result colour mapping
+const RESULT_COLOURS = {
+    pass: picocolors.green,
+    fail: picocolors.red,
+    pending: picocolors.yellow,
+    skipped: picocolors.gray,
+};
+// Event severity colour mapping
+const EVENT_SEVERITY_COLOURS = {
+    info: picocolors.cyan,
+    warning: picocolors.yellow,
+    error: picocolors.red,
+};
+/**
+ * Terminal Dashboard Renderer
+ *
+ * Renders orchestration dashboard data to terminal using ANSI colours and ASCII tables.
+ *
+ * @example
+ * const renderer = new TerminalDashboardRenderer();
+ * const data = await metricsCollector.collect();
+ * renderer.render(data);
+ */
+export class TerminalDashboardRenderer {
+    /**
+     * Render the complete dashboard with all 5 sections.
+     *
+     * Sections:
+     * 1. Global Status - High-level metrics
+     * 2. Agent Small Multiples - Per-agent comparison table
+     * 3. WU Progress - DoD progress bars with headlines
+     * 4. Timeline - Recent events
+     * 5. Alerts - Items requiring attention
+     *
+     * @param data - Complete dashboard data
+     */
+    render(data) {
+        this.clear();
+        console.log(picocolors.bold(picocolors.cyan('\n🎯 Agent Orchestration Dashboard\n')));
+        // Section 1: Global Status
+        this.renderGlobalStatus(data.globalStatus);
+        // Section 2: Agent Small Multiples
+        this.renderAgentMetrics(data.agentMetrics);
+        // Section 3: WU Progress
+        this.renderWUProgress(data.wuProgress);
+        // Section 4: Timeline
+        this.renderTimeline(data.timeline);
+        // Section 5: Alerts
+        this.renderAlerts(data.alerts);
+        console.log('\n');
+    }
+    /**
+     * Render prioritised suggestions.
+     *
+     * @param suggestions - Ordered suggestions (highest priority first)
+     */
+    renderSuggestions(suggestions) {
+        console.log(SECTION_SEPARATOR);
+        console.log(picocolors.bold(`${HEADER_PREFIX} Suggestions\n`));
+        if (suggestions.length === 0) {
+            console.log(picocolors.gray('No suggestions at this time.\n'));
+            return;
+        }
+        for (const suggestion of suggestions) {
+            const priorityColour = SEVERITY_COLOURS[suggestion.priority];
+            const priorityLabel = suggestion.priority.toUpperCase().padEnd(SEVERITY_LABEL_PAD_WIDTH);
+            console.log(`${BULLET} ${priorityColour(priorityLabel)} ${picocolors.bold(suggestion.action)}`);
+            console.log(`  ${picocolors.gray('Reason:')} ${suggestion.reason}`);
+            console.log(`  ${picocolors.gray('Command:')} ${picocolors.cyan(suggestion.command)}\n`);
+        }
+    }
+    /**
+     * Render execution plan and prompt for user approval.
+     *
+     * @param plan - Proposed execution plan
+     * @returns User's choice (approve/reject/edit)
+     */
+    async renderPlan(plan) {
+        console.log(SECTION_SEPARATOR);
+        console.log(picocolors.bold(`${HEADER_PREFIX} Execution Plan\n`));
+        console.log(`${picocolors.gray('WU:')} ${picocolors.cyan(plan.wuId)}`);
+        console.log(`${picocolors.gray('Estimated Tokens:')} ${picocolors.yellow(plan.estimatedTokens.toString())}\n`);
+        console.log(picocolors.bold('Steps:'));
+        for (const step of plan.steps) {
+            const label = 'agent' in step
+                ? `Run agent: ${step.agent}`
+                : 'action' in step
+                    ? `Run: ${step.action}`
+                    : 'Unknown step';
+            const statusIcon = step.status === 'pending' ? PENDING_MARK : CHECK_MARK;
+            console.log(`  ${statusIcon} ${label}`);
+        }
+        console.log('');
+        // Prompt user (mocked in tests via promptUser)
+        return this.promptUser();
+    }
+    /**
+     * Clear terminal output.
+     *
+     * Uses ANSI escape sequence to clear screen.
+     */
+    clear() {
+        // ANSI escape sequence: clear screen and move cursor to top-left
+        console.log('\x1Bc');
+    }
+    /**
+     * Render global status section.
+     *
+     * @private
+     */
+    renderGlobalStatus(status) {
+        const pendingMandatory = status.pendingMandatory ?? [];
+        const worktreesWithUncommittedChanges = status.worktreesWithUncommittedChanges ?? [];
+        console.log(SECTION_SEPARATOR);
+        console.log(picocolors.bold(`${HEADER_PREFIX} Global Status\n`));
+        console.log(`${picocolors.gray('Active WUs:')} ${picocolors.cyan(status.activeWUs.toString())}`);
+        console.log(`${picocolors.gray('Completed (24h):')} ${picocolors.green(status.completed24h.toString())}`);
+        console.log(`${picocolors.gray('Blocked:')} ${status.blocked > 0 ? picocolors.yellow(status.blocked.toString()) : picocolors.gray(status.blocked.toString())}`);
+        console.log(`${picocolors.gray('Gates Failing:')} ${status.gatesFailing > 0 ? picocolors.red(status.gatesFailing.toString()) : picocolors.gray(status.gatesFailing.toString())}`);
+        if (status.longestRunning) {
+            const durationHours = Math.floor(status.longestRunning.durationMs / MS_PER_HOUR);
+            const durationMinutes = Math.floor((status.longestRunning.durationMs % MS_PER_HOUR) / MS_PER_MINUTE);
+            console.log(`${picocolors.gray('Longest Running:')} ${picocolors.cyan(status.longestRunning.wuId)} ${picocolors.gray(`(${durationHours}h ${durationMinutes}m)`)}`);
+        }
+        if (pendingMandatory.length > 0) {
+            console.log(`\n${picocolors.yellow(BULLET)} ${picocolors.bold('Pending Mandatory Agents:')}`);
+            for (const pending of pendingMandatory) {
+                console.log(`  ${picocolors.gray('-')} ${picocolors.cyan(pending.wuId)}: ${pending.agent}`);
+            }
+        }
+        // WU-1438: Display active agent session
+        if (status.activeSession) {
+            const session = status.activeSession;
+            const startTime = new Date(session.started);
+            const durationMs = Date.now() - startTime.getTime();
+            const durationMinutes = Math.floor(durationMs / MS_PER_MINUTE);
+            const durationSeconds = Math.floor((durationMs % MS_PER_MINUTE) / MS_PER_SECOND);
+            console.log(`\n${picocolors.green(BULLET)} ${picocolors.bold('Active Agent Session:')}`);
+            console.log(`  ${picocolors.gray('Session ID:')} ${picocolors.cyan(session.sessionId.slice(0, 8))}...`);
+            console.log(`  ${picocolors.gray('WU:')} ${picocolors.cyan(session.wuId)}`);
+            console.log(`  ${picocolors.gray('Context Tier:')} ${session.contextTier}`);
+            console.log(`  ${picocolors.gray('Duration:')} ${durationMinutes}m ${durationSeconds}s`);
+            console.log(`  ${picocolors.gray('Incidents Logged:')} ${session.incidentsLogged}`);
+        }
+        else {
+            console.log(`\n${picocolors.gray(BULLET)} ${picocolors.gray('No active agent session')}`);
+        }
+        // WU-1748: Display worktrees with uncommitted changes
+        if (worktreesWithUncommittedChanges.length > 0) {
+            console.log(`\n${picocolors.yellow(BULLET)} ${picocolors.bold('Worktrees with Uncommitted Changes:')}`);
+            for (const wt of worktreesWithUncommittedChanges) {
+                const lastActivity = wt.lastActivityTimestamp
+                    ? new Date(wt.lastActivityTimestamp).toLocaleString('en-GB')
+                    : 'Unknown';
+                console.log(`  ${picocolors.gray('-')} ${picocolors.cyan(wt.wuId)}: ${picocolors.yellow(wt.uncommittedFileCount.toString())} uncommitted files`);
+                console.log(`    ${picocolors.gray('Last activity:')} ${lastActivity}`);
+                console.log(`    ${picocolors.gray('Path:')} ${wt.worktreePath}`);
+            }
+        }
+        console.log('');
+    }
+    /**
+     * Render agent metrics as small multiples table.
+     *
+     * @private
+     */
+    renderAgentMetrics(metrics) {
+        console.log(SECTION_SEPARATOR);
+        console.log(picocolors.bold(`${HEADER_PREFIX} Agent Metrics\n`));
+        if (Object.keys(metrics).length === 0) {
+            console.log(picocolors.gray('No agent metrics available.\n'));
+            return;
+        }
+        const table = new Table({
+            head: ['Agent', 'Invoked', 'Pass Rate', 'Avg Duration', 'Last Run'],
+            style: {
+                head: ['cyan'],
+                border: ['gray'],
+            },
+        });
+        for (const [agentName, metric] of Object.entries(metrics)) {
+            const passRateColour = metric.passRate >= PASS_RATE_GREEN_THRESHOLD
+                ? picocolors.green
+                : metric.passRate >= PASS_RATE_YELLOW_THRESHOLD
+                    ? picocolors.yellow
+                    : picocolors.red;
+            const avgDurationMs = metric.avgDurationMs;
+            const avgDurationMinutes = Math.floor(avgDurationMs / MS_PER_MINUTE);
+            const avgDurationSeconds = Math.floor((avgDurationMs % MS_PER_MINUTE) / MS_PER_SECOND);
+            const lastRunResult = metric.lastRun
+                ? RESULT_COLOURS[metric.lastRun.result](metric.lastRun.result)
+                : picocolors.gray('N/A');
+            table.push([
+                agentName,
+                metric.invoked.toString(),
+                passRateColour(`${metric.passRate}%`),
+                `${avgDurationMinutes}m ${avgDurationSeconds}s`,
+                lastRunResult,
+            ]);
+        }
+        console.log(table.toString());
+        console.log('');
+    }
+    /**
+     * Render WU progress with DoD bars and headlines.
+     *
+     * @private
+     */
+    renderWUProgress(progress) {
+        console.log(SECTION_SEPARATOR);
+        console.log(picocolors.bold(`${HEADER_PREFIX} WU Progress\n`));
+        if (progress.length === 0) {
+            console.log(picocolors.gray('No active WUs.\n'));
+            return;
+        }
+        for (const wu of progress) {
+            // WU header
+            console.log(`${picocolors.bold(picocolors.cyan(wu.wuId))} ${picocolors.gray('-')} ${wu.title}`);
+            console.log(`${picocolors.gray('Lane:')} ${wu.lane}`);
+            // DoD progress bar
+            const percentage = (wu.dodProgress / wu.dodTotal) * 100;
+            const filledWidth = Math.floor((percentage / 100) * PROGRESS_BAR_WIDTH);
+            const emptyWidth = PROGRESS_BAR_WIDTH - filledWidth;
+            const progressBar = picocolors.green('█'.repeat(filledWidth)) + picocolors.gray('░'.repeat(emptyWidth));
+            console.log(`${picocolors.gray('DoD:')} [${progressBar}] ${picocolors.cyan(`${wu.dodProgress}/${wu.dodTotal}`)}`);
+            // Agent status
+            const agentStatuses = Object.entries(wu.agents)
+                .map(([agent, status]) => {
+                const statusIcon = status === 'pass'
+                    ? picocolors.green(CHECK_MARK)
+                    : status === 'fail'
+                        ? picocolors.red(CROSS_MARK)
+                        : status === 'skipped'
+                            ? picocolors.gray('-')
+                            : picocolors.yellow(PENDING_MARK);
+                return `${statusIcon} ${agent}`;
+            })
+                .join('  ');
+            console.log(`${picocolors.gray('Agents:')} ${agentStatuses}`);
+            // Headline sentence (Tufte principle)
+            console.log(`${picocolors.italic(picocolors.gray(`"${wu.headline}"`))}\n`);
+        }
+    }
+    /**
+     * Render timeline of recent events.
+     *
+     * @private
+     */
+    renderTimeline(timeline) {
+        console.log(SECTION_SEPARATOR);
+        console.log(picocolors.bold(`${HEADER_PREFIX} Timeline\n`));
+        if (timeline.length === 0) {
+            console.log(picocolors.gray('No recent events.\n'));
+            return;
+        }
+        for (const event of timeline) {
+            const timestamp = new Date(event.timestamp).toLocaleTimeString('en-GB', {
+                hour: '2-digit',
+                minute: '2-digit',
+            });
+            const severityColour = EVENT_SEVERITY_COLOURS[event.severity];
+            console.log(`${picocolors.gray(timestamp)} ${severityColour(BULLET)} ${picocolors.cyan(event.wuId)} ${picocolors.gray('-')} ${event.detail}`);
+        }
+        console.log('');
+    }
+    /**
+     * Render alerts requiring attention.
+     *
+     * @private
+     */
+    renderAlerts(alerts) {
+        console.log(SECTION_SEPARATOR);
+        console.log(picocolors.bold(`${HEADER_PREFIX} Alerts\n`));
+        if (alerts.length === 0) {
+            console.log(picocolors.green(`${CHECK_MARK} No alerts - all clear.\n`));
+            return;
+        }
+        for (const alert of alerts) {
+            const severityColour = SEVERITY_COLOURS[alert.severity];
+            const severityLabel = alert.severity.toUpperCase().padEnd(SEVERITY_LABEL_PAD_WIDTH);
+            console.log(`${severityColour(BULLET)} ${severityColour(severityLabel)} ${picocolors.bold(alert.message)}`);
+            console.log(`  ${picocolors.gray('WU:')} ${picocolors.cyan(alert.wuId)}`);
+            console.log(`  ${picocolors.gray('Action:')} ${alert.action}\n`);
+        }
+    }
+    /**
+     * Prompt user for execution plan approval.
+     *
+     * This is a simplified implementation for testing.
+     * Production version would use @inquirer/prompts for interactive input.
+     *
+     * @private
+     */
+    async promptUser() {
+        // Mock implementation for testing
+        // Production: use @inquirer/prompts select + input
+        return {
+            choice: 'approve',
+            modifications: undefined,
+        };
+    }
+}
+//# sourceMappingURL=terminal-renderer.adapter.js.map

package/dist/adapters/terminal-renderer.adapter.js.map

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

package/dist/adapters/validation-adapters.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Validation Adapters
+ *
+ * WU-1094: INIT-002 Phase 2 - Implement adapters and dependency injection
+ *
+ * Concrete adapter implementations for validation-related port interfaces.
+ * These adapters wrap the existing implementation functions to conform
+ * to the port interfaces, enabling dependency injection.
+ *
+ * Adapters:
+ * - CommandRegistryAdapter - Implements ICommandRegistry
+ *
+ * @module adapters/validation-adapters
+ */
+import type { ICommandRegistry, CommandDefinition, WuContext } from '../ports/validation.ports.js';
+/**
+ * CommandRegistryAdapter
+ *
+ * Implements ICommandRegistry by delegating to the command registry functions.
+ * Provides access to command definitions and context-based validation.
+ *
+ * @example
+ * // Use default adapter
+ * const adapter = new CommandRegistryAdapter();
+ * const def = adapter.getCommandDefinition('wu:done');
+ *
+ * @example
+ * // Use as port interface
+ * const registry: ICommandRegistry = new CommandRegistryAdapter();
+ */
+export declare class CommandRegistryAdapter implements ICommandRegistry {
+    /**
+     * Get command definition by name.
+     *
+     * @param command - Command name (e.g., 'wu:create', 'wu:done')
+     * @returns CommandDefinition or null if not found
+     */
+    getCommandDefinition(command: string): CommandDefinition | null;
+    /**
+     * Get all commands valid for the current context.
+     *
+     * @param context - Current WU context
+     * @returns Array of valid CommandDefinitions
+     */
+    getValidCommandsForContext(context: WuContext): CommandDefinition[];
+    /**
+     * Get all registered command definitions.
+     *
+     * @returns Array of all CommandDefinitions
+     */
+    getAllCommands(): CommandDefinition[];
+}
+//# sourceMappingURL=validation-adapters.d.ts.map

package/dist/adapters/validation-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-adapters.d.ts","sourceRoot":"","sources":["../../src/adapters/validation-adapters.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AASnG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAI/D;;;;;OAKG;IACH,0BAA0B,CAAC,OAAO,EAAE,SAAS,GAAG,iBAAiB,EAAE;IAInE;;;;OAIG;IACH,cAAc,IAAI,iBAAiB,EAAE;CAGtC"}

package/dist/adapters/validation-adapters.js

@@ -0,0 +1,48 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// Import existing implementations
+import { COMMAND_REGISTRY, getCommandDefinition, getValidCommandsForContext, } from '../validation/command-registry.js';
+/**
+ * CommandRegistryAdapter
+ *
+ * Implements ICommandRegistry by delegating to the command registry functions.
+ * Provides access to command definitions and context-based validation.
+ *
+ * @example
+ * // Use default adapter
+ * const adapter = new CommandRegistryAdapter();
+ * const def = adapter.getCommandDefinition('wu:done');
+ *
+ * @example
+ * // Use as port interface
+ * const registry: ICommandRegistry = new CommandRegistryAdapter();
+ */
+export class CommandRegistryAdapter {
+    /**
+     * Get command definition by name.
+     *
+     * @param command - Command name (e.g., 'wu:create', 'wu:done')
+     * @returns CommandDefinition or null if not found
+     */
+    getCommandDefinition(command) {
+        return getCommandDefinition(command);
+    }
+    /**
+     * Get all commands valid for the current context.
+     *
+     * @param context - Current WU context
+     * @returns Array of valid CommandDefinitions
+     */
+    getValidCommandsForContext(context) {
+        return getValidCommandsForContext(context);
+    }
+    /**
+     * Get all registered command definitions.
+     *
+     * @returns Array of all CommandDefinitions
+     */
+    getAllCommands() {
+        return Array.from(COMMAND_REGISTRY.values());
+    }
+}
+//# sourceMappingURL=validation-adapters.js.map

package/dist/adapters/validation-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-adapters.js","sourceRoot":"","sources":["../../src/adapters/validation-adapters.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAmBzC,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,sBAAsB;IACjC;;;;;OAKG;IACH,oBAAoB,CAAC,OAAe;QAClC,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,0BAA0B,CAAC,OAAkB;QAC3C,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/agent-patterns-registry.d.ts

@@ -0,0 +1,141 @@
+/** Default agent branch patterns (narrow: just agent/*) */
+export declare const DEFAULT_AGENT_PATTERNS: string[];
+/** Remote registry URL */
+export declare const REGISTRY_URL = "https://lumenflow.dev/registry/agent-patterns.json";
+/** Cache TTL: 7 days in milliseconds (WU-2044: uses canonical MS_PER_DAY) */
+export declare const CACHE_TTL_MS: number;
+/**
+ * Options for getAgentPatterns
+ */
+export interface GetAgentPatternsOptions {
+    /** Override cache directory (default: ~/.lumenflow/cache) */
+    cacheDir?: string;
+    /** Fetch timeout in milliseconds (default: 5000) */
+    timeoutMs?: number;
+}
+/**
+ * Source of agent patterns for observability
+ */
+export type AgentPatternSource = 'registry' | 'merged' | 'override' | 'config' | 'defaults';
+/**
+ * Result of resolveAgentPatterns with observability fields
+ */
+export interface AgentPatternResult {
+    /** Resolved patterns to use for agent branch matching */
+    patterns: string[];
+    /** Source of the patterns for observability */
+    source: AgentPatternSource;
+    /** Whether the registry was successfully fetched */
+    registryFetched: boolean;
+}
+/**
+ * Type for injectable registry fetcher function
+ */
+export type RegistryFetcher = (options: GetAgentPatternsOptions) => Promise<string[]>;
+/**
+ * Options for resolveAgentPatterns (WU-1089)
+ */
+export interface ResolveAgentPatternsOptions {
+    /** Injectable registry fetcher for testing (uses getAgentPatterns by default) */
+    registryFetcher?: RegistryFetcher;
+    /** Patterns from config.git.agentBranchPatterns (merged with registry by default) */
+    configPatterns?: string[];
+    /** Patterns from config.git.agentBranchPatternsOverride (replaces everything if set) */
+    overridePatterns?: string[];
+    /** config.git.disableAgentPatternRegistry - skips network fetch (airgapped mode) */
+    disableAgentPatternRegistry?: boolean;
+    /** Override cache directory (passed to fetcher) */
+    cacheDir?: string;
+    /** Fetch timeout in milliseconds (passed to fetcher) */
+    timeoutMs?: number;
+}
+/**
+ * Get the default cache directory
+ *
+ * @returns Path to cache directory (~/.lumenflow/cache or LUMENFLOW_HOME/cache)
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get agent branch patterns from registry with caching
+ *
+ * Fetches patterns from remote registry, caches locally for 7 days,
+ * and falls back to defaults on failure.
+ *
+ * @param options - Options
+ * @returns Array of agent branch patterns (glob format)
+ *
+ * @example
+ * ```typescript
+ * const patterns = await getAgentPatterns();
+ * // ['claude/*', 'codex/*', 'copilot/*', 'cursor/*', 'agent/*']
+ * ```
+ */
+export declare function getAgentPatterns(options?: GetAgentPatternsOptions): Promise<string[]>;
+/**
+ * Resolve agent branch patterns based on config with merge/override/airgapped support
+ *
+ * Behavior matrix (WU-1089):
+ *
+ * | disableRegistry | override patterns | config patterns | Result                 | Source        |
+ * |-----------------|-------------------|-----------------|------------------------|---------------|
+ * | false           | undefined         | undefined/[]    | registry               | 'registry'    |
+ * | false           | undefined         | ['custom/*']    | config + registry      | 'merged'      |
+ * | false           | ['only/*']        | UnsafeAny             | override only          | 'override'    |
+ * | true            | undefined         | undefined/[]    | defaults               | 'defaults'    |
+ * | true            | undefined         | ['custom/*']    | config only            | 'config'      |
+ * | true            | ['only/*']        | UnsafeAny             | override only          | 'override'    |
+ *
+ * When registry fetch fails:
+ * - Falls back to config patterns if provided, source = 'config'
+ * - Falls back to defaults if no config, source = 'defaults'
+ *
+ * @param options - Resolution options
+ * @returns Result with patterns, source, and registryFetched flag
+ *
+ * @example Default (fetch from registry)
+ * ```typescript
+ * const result = await resolveAgentPatterns({});
+ * // result.patterns = ['claude/*', 'codex/*', ...] (from registry)
+ * // result.source = 'registry'
+ * // result.registryFetched = true
+ * ```
+ *
+ * @example Merge mode (config + registry)
+ * ```typescript
+ * const result = await resolveAgentPatterns({
+ *   configPatterns: ['my-agent/*'],
+ * });
+ * // result.patterns = ['my-agent/*', 'claude/*', 'codex/*', ...]
+ * // result.source = 'merged'
+ * // result.registryFetched = true
+ * ```
+ *
+ * @example Override mode (explicit replacement)
+ * ```typescript
+ * const result = await resolveAgentPatterns({
+ *   overridePatterns: ['only-this/*'],
+ * });
+ * // result.patterns = ['only-this/*']
+ * // result.source = 'override'
+ * // result.registryFetched = false
+ * ```
+ *
+ * @example Airgapped mode (no network)
+ * ```typescript
+ * const result = await resolveAgentPatterns({
+ *   disableAgentPatternRegistry: true,
+ *   configPatterns: ['my-agent/*'],
+ * });
+ * // result.patterns = ['my-agent/*']
+ * // result.source = 'config'
+ * // result.registryFetched = false
+ * ```
+ */
+export declare function resolveAgentPatterns(options?: ResolveAgentPatternsOptions): Promise<AgentPatternResult>;
+/**
+ * Clear the in-memory cache
+ *
+ * Used primarily for testing.
+ */
+export declare function clearCache(): void;
+//# sourceMappingURL=agent-patterns-registry.d.ts.map

package/dist/agent-patterns-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-patterns-registry.d.ts","sourceRoot":"","sources":["../src/agent-patterns-registry.ts"],"names":[],"mappings":"AAqBA,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,UAAc,CAAC;AAElD,0BAA0B;AAC1B,eAAO,MAAM,YAAY,uDAAuD,CAAC;AAEjF,6EAA6E;AAC7E,eAAO,MAAM,YAAY,QAAiB,CAAC;AA+B3C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,oDAAoD;IACpD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,oFAAoF;IACpF,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAmGD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6C/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,kBAAkB,CAAC,CA2E7B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}