@lumenflow/core 2.2.2 → 2.3.1

package/dist/risk-detector.js

@@ -15,8 +15,8 @@
  * healthcare domain (PHI, RLS, auth). No standard library exists for this
  * domain-specific classification.
  *
- * @see {@link tools/gates.mjs} - Consumer of risk detection
- * @see {@link tools/lib/file-classifiers.mjs} - File classification utilities
+ * @see {@link packages/@lumenflow/cli/src/gates.ts} - Consumer of risk detection
+ * @see {@link packages/@lumenflow/cli/src/lib/file-classifiers.ts} - File classification utilities
  */
 import path from 'node:path';
 import { isDocumentationPath } from './file-classifiers.js';

package/dist/rollback-utils.d.ts

@@ -5,7 +5,7 @@
  * WU-1255: Per-file error tracking for robust rollback operations.
  * Ensures all files are attempted even if some fail, with clear error reporting.
  *
- * @see {@link tools/wu-done.mjs} - Consumer (rollbackTransaction function)
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Consumer (rollbackTransaction function)
  */
 /**
  * Error entry for failed file restoration

package/dist/rollback-utils.js

@@ -5,7 +5,7 @@
  * WU-1255: Per-file error tracking for robust rollback operations.
  * Ensures all files are attempted even if some fail, with clear error reporting.
  *
- * @see {@link tools/wu-done.mjs} - Consumer (rollbackTransaction function)
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Consumer (rollbackTransaction function)
  */
 /* eslint-disable security/detect-non-literal-fs-filename */
 import { writeFileSync, unlinkSync } from 'node:fs';

package/dist/section-headings.d.ts

@@ -9,7 +9,7 @@
  */
 /**
  * Default section headings (fallbacks when frontmatter is missing)
- * Re-exports from wu-constants.mjs for backwards compatibility
+ * Re-exports from wu-constants.ts for backwards compatibility
  */
 export declare const DEFAULT_SECTION_HEADINGS: {
     backlog: {

package/dist/section-headings.js

@@ -11,7 +11,7 @@ import { getSectionHeadings } from './backlog-parser.js';
 import { BACKLOG_SECTIONS, STATUS_SECTIONS } from './wu-constants.js';
 /**
  * Default section headings (fallbacks when frontmatter is missing)
- * Re-exports from wu-constants.mjs for backwards compatibility
+ * Re-exports from wu-constants.ts for backwards compatibility
  */
 export const DEFAULT_SECTION_HEADINGS = {
     backlog: {

package/dist/spawn-escalation.d.ts

@@ -14,9 +14,9 @@
  * PatientPath's custom spawn-registry.jsonl and memory bus patterns.
  * No external library exists for this domain-specific agent lifecycle management.
  *
- * @see {@link tools/lib/__tests__/spawn-escalation.test.mjs} - Tests
- * @see {@link tools/lib/spawn-recovery.mjs} - Recovery logic
- * @see {@link tools/lib/mem-signal-core.mjs} - Signal creation
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-escalation.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-recovery.ts} - Recovery logic
+ * @see {@link packages/@lumenflow/cli/src/lib/mem-signal-core.ts} - Signal creation
  */
 /**
  * Signal type for spawn failures
@@ -83,7 +83,7 @@ export declare function escalateStuckSpawn(spawnId: any, options?: EscalateStuck
         recovery_action: any;
         recovery_attempts: any;
         last_checkpoint: any;
-        suggested_action: "retry" | "block" | "human_escalate";
+        suggested_action: "block" | "retry" | "human_escalate";
         message: string;
     };
     spawnStatus: "escalated";

package/dist/spawn-escalation.js

@@ -14,9 +14,9 @@
  * PatientPath's custom spawn-registry.jsonl and memory bus patterns.
  * No external library exists for this domain-specific agent lifecycle management.
  *
- * @see {@link tools/lib/__tests__/spawn-escalation.test.mjs} - Tests
- * @see {@link tools/lib/spawn-recovery.mjs} - Recovery logic
- * @see {@link tools/lib/mem-signal-core.mjs} - Signal creation
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-escalation.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-recovery.ts} - Recovery logic
+ * @see {@link packages/@lumenflow/cli/src/lib/mem-signal-core.ts} - Signal creation
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';

package/dist/spawn-monitor.d.ts

@@ -15,10 +15,10 @@
  * PatientPath's spawn-registry.jsonl and lane-lock files. No external
  * library exists for this custom format.
  *
- * @see {@link tools/__tests__/orchestrate-monitor.test.mjs} - Tests
- * @see {@link tools/lib/__tests__/spawn-monitor.test.mjs} - Signal handler tests
- * @see {@link tools/orchestrate-monitor.mjs} - CLI entry point
- * @see {@link tools/lib/spawn-registry-store.mjs} - Registry storage
+ * @see {@link packages/@lumenflow/cli/src/__tests__/orchestrate-monitor.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-monitor.test.ts} - Signal handler tests
+ * @see {@link packages/@lumenflow/cli/src/orchestrate-monitor.ts} - CLI entry point
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Registry storage
  */
 /**
  * Default threshold for stuck spawn detection (in minutes)

package/dist/spawn-monitor.js

@@ -15,10 +15,10 @@
  * PatientPath's spawn-registry.jsonl and lane-lock files. No external
  * library exists for this custom format.
  *
- * @see {@link tools/__tests__/orchestrate-monitor.test.mjs} - Tests
- * @see {@link tools/lib/__tests__/spawn-monitor.test.mjs} - Signal handler tests
- * @see {@link tools/orchestrate-monitor.mjs} - CLI entry point
- * @see {@link tools/lib/spawn-registry-store.mjs} - Registry storage
+ * @see {@link packages/@lumenflow/cli/src/__tests__/orchestrate-monitor.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-monitor.test.ts} - Signal handler tests
+ * @see {@link packages/@lumenflow/cli/src/orchestrate-monitor.ts} - CLI entry point
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Registry storage
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';

package/dist/spawn-recovery.d.ts

@@ -15,9 +15,9 @@
  * PatientPath's custom spawn-registry.jsonl, lane-lock, and memory-store.
  * No external library exists for this domain-specific agent lifecycle management.
  *
- * @see {@link tools/lib/__tests__/spawn-recovery.test.mjs} - Tests
- * @see {@link tools/lib/spawn-monitor.mjs} - Monitoring logic
- * @see {@link tools/lib/spawn-registry-store.mjs} - Spawn state
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-recovery.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-monitor.ts} - Monitoring logic
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Spawn state
  */
 /**
  * Recovery action constants

package/dist/spawn-recovery.js

@@ -15,9 +15,9 @@
  * PatientPath's custom spawn-registry.jsonl, lane-lock, and memory-store.
  * No external library exists for this domain-specific agent lifecycle management.
  *
- * @see {@link tools/lib/__tests__/spawn-recovery.test.mjs} - Tests
- * @see {@link tools/lib/spawn-monitor.mjs} - Monitoring logic
- * @see {@link tools/lib/spawn-registry-store.mjs} - Spawn state
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-recovery.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-monitor.ts} - Monitoring logic
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Spawn state
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';

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

@@ -4,8 +4,8 @@
  * Zod schemas for spawn event validation.
  * Defines schema for tracking sub-agent spawns by orchestrators.
  *
- * @see {@link tools/lib/__tests__/spawn-registry-store.test.mjs} - Tests
- * @see {@link tools/lib/spawn-registry-store.mjs} - Store implementation
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-registry-store.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Store implementation
  */
 import { z } from 'zod';
 /**

package/dist/spawn-registry-schema.js

@@ -4,8 +4,8 @@
  * Zod schemas for spawn event validation.
  * Defines schema for tracking sub-agent spawns by orchestrators.
  *
- * @see {@link tools/lib/__tests__/spawn-registry-store.test.mjs} - Tests
- * @see {@link tools/lib/spawn-registry-store.mjs} - Store implementation
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/spawn-registry-store.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Store implementation
  */
 import { z } from 'zod';
 import crypto from 'node:crypto';

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

@@ -9,8 +9,8 @@
  * - Atomic append operations
  * - O(1) queries by parent WU, target WU, and status
  *
- * @see {@link tools/lib/__tests__/spawn-registry-store.test.mjs} - Tests
- * @see {@link tools/lib/spawn-registry-schema.mjs} - Schema definitions
+ * @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 } from './spawn-registry-schema.js';
 /**

package/dist/spawn-registry-store.js

@@ -9,8 +9,8 @@
  * - Atomic append operations
  * - O(1) queries by parent WU, target WU, and status
  *
- * @see {@link tools/lib/__tests__/spawn-registry-store.test.mjs} - Tests
- * @see {@link tools/lib/spawn-registry-schema.mjs} - Schema definitions
+ * @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';

package/dist/spawn-strategy.d.ts

@@ -17,7 +17,11 @@ export interface SpawnStrategy {
 declare abstract class BaseSpawnStrategy implements SpawnStrategy {
     protected getCorePreamble(wuId: string): string;
     abstract getPreamble(wuId: string): string;
-    abstract getSkillLoadingInstruction(): 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)
@@ -28,26 +32,28 @@ export declare class ClaudeCodeStrategy extends BaseSpawnStrategy {
 }
 /**
  * Strategy for Gemini CLI (Multimodal/Ecosystem)
+ * Uses default getSkillLoadingInstruction from base class
  */
 export declare class GeminiCliStrategy extends BaseSpawnStrategy {
     getPreamble(wuId: string): string;
-    getSkillLoadingInstruction(): string;
 }
 /**
  * Generic Strategy (Unknown/Other clients)
+ * Uses default getSkillLoadingInstruction from base class
  */
 export declare class GenericStrategy extends BaseSpawnStrategy {
     getPreamble(wuId: string): string;
-    getSkillLoadingInstruction(): string;
 }
 /**
- * Factory for creating strategies
+ * Create a strategy for the given client
+ * @param clientName - Client name (e.g. 'claude-code', 'gemini-cli')
  */
-export declare class SpawnStrategyFactory {
-    /**
-     * Create a strategy for the given client
-     * @param clientName - Client name (e.g. 'claude-code', 'gemini-cli')
-     */
-    static create(clientName: string): SpawnStrategy;
-}
+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 {};

package/dist/spawn-strategy.js

@@ -10,7 +10,18 @@ class BaseSpawnStrategy {
 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)`;
+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.`;
     }
 }
 /**
@@ -27,7 +38,7 @@ export class ClaudeCodeStrategy extends BaseSpawnStrategy {
             // 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 += `\n6. Read .claude/CLAUDE.md (Claude-specific workflow overlay)`;
+            preamble += `\n7. Read .claude/CLAUDE.md (Claude-specific workflow overlay)`;
         }
         return preamble;
     }
@@ -41,66 +52,58 @@ export class ClaudeCodeStrategy extends BaseSpawnStrategy {
 }
 /**
  * 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 += `\n6. Read GEMINI.md (Gemini-specific workflow overlay)`;
+            preamble += `\n7. Read GEMINI.md (Gemini-specific workflow overlay)`;
         }
         return preamble;
     }
-    getSkillLoadingInstruction() {
-        return `## Skills Selection
-    
-1. Check \`.lumenflow/agents\` for available skills.
-2. Select relevant skills for this task.`;
-    }
 }
 /**
  * Generic Strategy (Unknown/Other clients)
+ * Uses default getSkillLoadingInstruction from base class
  */
 export class GenericStrategy extends BaseSpawnStrategy {
     getPreamble(wuId) {
         return this.getCorePreamble(wuId);
     }
-    getSkillLoadingInstruction() {
-        return `## Skills Selection
-    
-1. Check \`.lumenflow/agents\` for available skills.
-2. Select relevant skills for this task.`;
-    }
 }
 /**
- * Factory for creating strategies
+ * Create a strategy for the given client
+ * @param clientName - Client name (e.g. 'claude-code', 'gemini-cli')
  */
-export class SpawnStrategyFactory {
-    /**
-     * Create a strategy for the given client
-     * @param clientName - Client name (e.g. 'claude-code', 'gemini-cli')
-     */
-    static create(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();
-        }
+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,
+};

package/dist/spawn-tree.d.ts

@@ -8,9 +8,9 @@
  * Integrates with spawn-registry-store and spawn-registry-schema.
  * No external tree library needed - logic is tightly coupled to spawn data model.
  *
- * @see {@link tools/__tests__/spawn-list.test.mjs} - Tests
- * @see {@link tools/spawn-list.mjs} - CLI command
- * @see {@link tools/lib/spawn-registry-store.mjs} - Data source
+ * @see {@link packages/@lumenflow/cli/src/__tests__/spawn-list.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/spawn-list.ts} - CLI command
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Data source
  */
 /**
  * Status indicators for terminal output.

package/dist/spawn-tree.js

@@ -8,9 +8,9 @@
  * Integrates with spawn-registry-store and spawn-registry-schema.
  * No external tree library needed - logic is tightly coupled to spawn data model.
  *
- * @see {@link tools/__tests__/spawn-list.test.mjs} - Tests
- * @see {@link tools/spawn-list.mjs} - CLI command
- * @see {@link tools/lib/spawn-registry-store.mjs} - Data source
+ * @see {@link packages/@lumenflow/cli/src/__tests__/spawn-list.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/spawn-list.ts} - CLI command
+ * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Data source
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';

package/dist/state-cleanup-core.d.ts

@@ -0,0 +1,205 @@
+/**
+ * State Cleanup Core (WU-1208)
+ *
+ * Unified orchestration of all state cleanup operations:
+ * - Signal cleanup (TTL-based, from @lumenflow/memory)
+ * - Memory cleanup (lifecycle-based, from @lumenflow/memory)
+ * - Event archival (age-based, from @lumenflow/core)
+ *
+ * Cleanup order: signals -> memory -> events (dependency order)
+ *
+ * Design principles:
+ * - Non-fatal errors: failures in one cleanup type don't block others
+ * - Consistent summary: aggregated counts for all cleanup types
+ * - Configurable: supports --dry-run and type-specific flags
+ *
+ * @see {@link packages/@lumenflow/cli/src/state-cleanup.ts} - CLI wrapper
+ * @see {@link packages/@lumenflow/core/src/__tests__/state-cleanup-core.test.ts} - Tests
+ */
+/**
+ * Cleanup types supported by state:cleanup
+ */
+export type CleanupType = 'signals' | 'memory' | 'events';
+/**
+ * Signal cleanup result (from @lumenflow/memory/signal-cleanup-core)
+ */
+export interface SignalCleanupResult {
+    success: boolean;
+    removedIds: string[];
+    retainedIds: string[];
+    bytesFreed: number;
+    compactionRatio: number;
+    dryRun?: boolean;
+    breakdown: {
+        ttlExpired: number;
+        unreadTtlExpired: number;
+        countLimitExceeded: number;
+        activeWuProtected: number;
+    };
+}
+/**
+ * Memory cleanup result (from @lumenflow/memory/mem-cleanup-core)
+ */
+export interface MemoryCleanupResult {
+    success: boolean;
+    removedIds: string[];
+    retainedIds: string[];
+    bytesFreed: number;
+    compactionRatio: number;
+    dryRun?: boolean;
+    breakdown: {
+        ephemeral: number;
+        session: number;
+        wu: number;
+        sensitive: number;
+        ttlExpired: number;
+        activeSessionProtected: number;
+    };
+}
+/**
+ * Event archival result (from @lumenflow/core/wu-events-cleanup)
+ */
+export interface EventArchivalResult {
+    success: boolean;
+    archivedWuIds: string[];
+    retainedWuIds: string[];
+    archivedEventCount: number;
+    retainedEventCount: number;
+    bytesArchived: number;
+    dryRun?: boolean;
+    breakdown: {
+        archivedOlderThanThreshold: number;
+        retainedActiveWu: number;
+        retainedWithinThreshold: number;
+    };
+}
+/**
+ * Signal cleanup function type
+ */
+export type CleanupSignalsFn = (baseDir: string, options: {
+    dryRun?: boolean;
+}) => Promise<SignalCleanupResult>;
+/**
+ * Memory cleanup function type
+ */
+export type CleanupMemoryFn = (baseDir: string, options: {
+    dryRun?: boolean;
+}) => Promise<MemoryCleanupResult>;
+/**
+ * Event archival function type
+ */
+export type ArchiveEventsFn = (baseDir: string, options: {
+    dryRun?: boolean;
+}) => Promise<EventArchivalResult>;
+/**
+ * Error that occurred during a specific cleanup type
+ */
+export interface CleanupError {
+    type: CleanupType;
+    message: string;
+    error?: Error;
+}
+/**
+ * Summary of signal cleanup
+ */
+export interface SignalCleanupSummary {
+    removedCount: number;
+    retainedCount: number;
+    bytesFreed: number;
+    breakdown: SignalCleanupResult['breakdown'];
+}
+/**
+ * Summary of memory cleanup
+ */
+export interface MemoryCleanupSummary {
+    removedCount: number;
+    retainedCount: number;
+    bytesFreed: number;
+    breakdown: MemoryCleanupResult['breakdown'];
+}
+/**
+ * Summary of event archival
+ */
+export interface EventArchivalSummary {
+    archivedWuCount: number;
+    retainedWuCount: number;
+    archivedEventCount: number;
+    retainedEventCount: number;
+    bytesArchived: number;
+    breakdown: EventArchivalResult['breakdown'];
+}
+/**
+ * Overall summary of state cleanup
+ */
+export interface StateCleanupSummary {
+    totalBytesFreed: number;
+    typesExecuted: CleanupType[];
+    typesSkipped: CleanupType[];
+}
+/**
+ * Options for unified state cleanup
+ */
+export interface StateCleanupOptions {
+    /** If true, preview without modifications */
+    dryRun?: boolean;
+    /** Only execute signal cleanup */
+    signalsOnly?: boolean;
+    /** Only execute memory cleanup */
+    memoryOnly?: boolean;
+    /** Only execute event archival */
+    eventsOnly?: boolean;
+    /** Signal cleanup function (injectable for testing) */
+    cleanupSignals?: CleanupSignalsFn;
+    /** Memory cleanup function (injectable for testing) */
+    cleanupMemory?: CleanupMemoryFn;
+    /** Event archival function (injectable for testing) */
+    archiveEvents?: ArchiveEventsFn;
+}
+/**
+ * Result of unified state cleanup
+ */
+export interface StateCleanupResult {
+    /** Whether all executed cleanups succeeded */
+    success: boolean;
+    /** True if in dry-run mode */
+    dryRun?: boolean;
+    /** Signal cleanup summary (undefined if skipped) */
+    signals?: SignalCleanupSummary;
+    /** Memory cleanup summary (undefined if skipped) */
+    memory?: MemoryCleanupSummary;
+    /** Event archival summary (undefined if skipped) */
+    events?: EventArchivalSummary;
+    /** Errors from failed cleanups (non-fatal) */
+    errors: CleanupError[];
+    /** Aggregated summary */
+    summary: StateCleanupSummary;
+}
+/**
+ * Orchestrate all state cleanup operations in dependency order.
+ *
+ * Executes cleanups in order: signals -> memory -> events
+ *
+ * Non-fatal: failures in one cleanup type don't block others.
+ * All errors are collected and reported in the result.
+ *
+ * @param baseDir - Project base directory
+ * @param options - State cleanup options
+ * @returns Unified cleanup result with summaries and errors
+ *
+ * @example
+ * // Full cleanup with dry-run
+ * const result = await cleanupState(baseDir, { dryRun: true });
+ *
+ * @example
+ * // Signals only
+ * const result = await cleanupState(baseDir, { signalsOnly: true });
+ *
+ * @example
+ * // With injected cleanup functions (for testing or custom implementations)
+ * const result = await cleanupState(baseDir, {
+ *   cleanupSignals: myCustomSignalCleanup,
+ *   cleanupMemory: myCustomMemoryCleanup,
+ *   archiveEvents: myCustomEventArchival,
+ * });
+ */
+export declare function cleanupState(baseDir: string, options?: StateCleanupOptions): Promise<StateCleanupResult>;