@tonycasey/lisa 1.2.0 → 2.0.0

package/dist/lib/domain/interfaces/IRecursionService.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Result of memory recursion for plan mode prompts.
+ */
+export interface IRecursionResult {
+    /** Whether any relevant context was found */
+    readonly hasContext: boolean;
+    /** Previous decisions found in memory */
+    readonly decisions: readonly string[];
+    /** Learnings from retrospectives */
+    readonly learnings: readonly string[];
+    /** Related tasks */
+    readonly relatedTasks: readonly string[];
+    /** Formatted summary for output */
+    readonly summary: string;
+}
+/**
+ * Configuration for recursion service.
+ */
+export interface IRecursionConfig {
+    /** Minimum prompt length to trigger recursion */
+    readonly minPromptLength: number;
+    /** Maximum results per category */
+    readonly maxResultsPerType: number;
+    /** Timeout for memory queries (ms) */
+    readonly queryTimeoutMs: number;
+}
+/**
+ * Service for searching memory when planning.
+ *
+ * When a user submits a prompt in plan mode, this service searches
+ * memory for relevant context: previous decisions, learnings, and tasks.
+ */
+export interface IRecursionService {
+    /**
+     * Run memory recursion for a plan mode prompt.
+     * Searches for relevant decisions, learnings, and tasks.
+     *
+     * @param prompt - The user's prompt text
+     * @param groupIds - Hierarchical group IDs to search
+     * @returns Recursion result with found context
+     */
+    run(prompt: string, groupIds: readonly string[]): Promise<IRecursionResult>;
+    /**
+     * Check if recursion should run for a given prompt.
+     *
+     * @param prompt - The user's prompt text
+     * @param permissionMode - The current permission mode
+     * @returns True if recursion should run
+     */
+    shouldRun(prompt: string, permissionMode: string): boolean;
+}
+//# sourceMappingURL=IRecursionService.d.ts.map

package/dist/lib/domain/interfaces/IRecursionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRecursionService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IRecursionService.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oBAAoB;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,sCAAsC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5E;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5D"}

package/dist/lib/domain/interfaces/IRecursionService.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IRecursionService.js.map

package/dist/lib/domain/interfaces/IRecursionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRecursionService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IRecursionService.ts"],"names":[],"mappings":""}

package/dist/lib/domain/interfaces/ISessionCaptureService.d.ts

@@ -0,0 +1,16 @@
+import type { ICapturedWork } from './types';
+/**
+ * Service responsible for capturing session work.
+ * Analyzes session transcript and extracts facts worth remembering.
+ */
+export interface ISessionCaptureService {
+    /**
+     * Capture work from the current session.
+     * May spawn a background worker for async processing.
+     *
+     * @param sessionId - Optional session ID
+     * @returns Captured work including facts and complexity assessment
+     */
+    captureSessionWork(sessionId?: string): Promise<ICapturedWork>;
+}
+//# sourceMappingURL=ISessionCaptureService.d.ts.map

package/dist/lib/domain/interfaces/ISessionCaptureService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISessionCaptureService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ISessionCaptureService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChE"}

package/dist/lib/domain/interfaces/ISessionCaptureService.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ISessionCaptureService.js.map

package/dist/lib/domain/interfaces/ISessionCaptureService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISessionCaptureService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ISessionCaptureService.ts"],"names":[],"mappings":""}

package/dist/lib/domain/interfaces/ITaskService.d.ts

@@ -0,0 +1,52 @@
+import type { ITask, ITaskInput, ITaskUpdate, ITaskCounts } from './types';
+/**
+ * Read operations for tasks.
+ * Separated for Interface Segregation Principle.
+ */
+export interface ITaskReader {
+    /**
+     * Get all tasks for a group.
+     * @param groupIds - Hierarchical group IDs to query
+     * @param aliases - Project aliases for tagging
+     * @param branch - Current git branch (for tagging)
+     */
+    getTasks(groupIds: readonly string[], aliases: readonly string[], branch: string | null): Promise<readonly ITask[]>;
+    /**
+     * Get tasks with simple interface (no aliases/branch).
+     * Uses DAL router with Neo4j when available for date ordering.
+     * @param groupIds - Group IDs to query
+     */
+    getTasksSimple(groupIds: readonly string[]): Promise<readonly ITask[]>;
+    /**
+     * Get task counts by status.
+     * Uses DAL router with Neo4j when available for efficient aggregation.
+     * @param groupIds - Group IDs to query
+     */
+    getTaskCounts(groupIds: readonly string[]): Promise<ITaskCounts>;
+}
+/**
+ * Write operations for tasks.
+ * Separated for Interface Segregation Principle.
+ */
+export interface ITaskWriter {
+    /**
+     * Create a new task.
+     * @param groupId - Group ID to create task in
+     * @param task - Task input data
+     */
+    createTask(groupId: string, task: ITaskInput): Promise<ITask>;
+    /**
+     * Update an existing task.
+     * @param groupId - Group ID containing the task
+     * @param taskId - Task ID to update
+     * @param updates - Fields to update
+     */
+    updateTask(groupId: string, taskId: string, updates: ITaskUpdate): Promise<ITask>;
+}
+/**
+ * Full task service interface.
+ * Combines read and write operations.
+ */
+export interface ITaskService extends ITaskReader, ITaskWriter {
+}
+//# sourceMappingURL=ITaskService.d.ts.map

package/dist/lib/domain/interfaces/ITaskService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITaskService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ITaskService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CACN,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAE7B;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAEvE;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACnF;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW,EAAE,WAAW;CAAG"}

package/dist/lib/domain/interfaces/ITaskService.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITaskService.js.map

package/dist/lib/domain/interfaces/ITaskService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITaskService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ITaskService.ts"],"names":[],"mappings":""}

package/dist/lib/domain/interfaces/dal/IConnectionManager.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Connection Manager Interfaces
+ *
+ * Abstractions for managing connections to different backends.
+ */
+/**
+ * Base connection configuration.
+ */
+export interface IConnectionConfig {
+    /** Endpoint URL */
+    readonly endpoint: string;
+    /** Connection timeout in milliseconds */
+    readonly timeout?: number;
+}
+/**
+ * MCP-specific connection configuration.
+ */
+export interface IMcpConnectionConfig extends IConnectionConfig {
+    /** API key for authentication (e.g., Zep Cloud) */
+    readonly apiKey?: string;
+}
+/**
+ * Neo4j-specific connection configuration.
+ */
+export interface INeo4jConnectionConfig {
+    /** Bolt URI (e.g., bolt://localhost:7687) */
+    readonly uri: string;
+    /** Database username */
+    readonly username: string;
+    /** Database password */
+    readonly password: string;
+    /** Database name (defaults to neo4j) */
+    readonly database?: string;
+    /** Connection timeout in milliseconds */
+    readonly timeout?: number;
+}
+/**
+ * Zep Cloud-specific connection configuration.
+ */
+export interface IZepConnectionConfig extends IConnectionConfig {
+    /** Zep API key (required) */
+    readonly apiKey: string;
+}
+/**
+ * Connection manager interface.
+ * Manages lifecycle and health of a single backend connection.
+ */
+export interface IConnectionManager<TConfig = IConnectionConfig> {
+    /**
+     * Initialize/establish the connection.
+     * For MCP, this creates a session.
+     * For Neo4j, this verifies connectivity.
+     */
+    connect(): Promise<void>;
+    /**
+     * Check if the connection is healthy.
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Close the connection gracefully.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get the current configuration.
+     */
+    getConfig(): TConfig;
+    /**
+     * Execute a backend-specific query.
+     * @param query - Backend-specific query (Cypher, MCP method, etc.)
+     */
+    execute<T>(query: unknown): Promise<T>;
+}
+/**
+ * MCP connection manager interface.
+ */
+export interface IMcpConnectionManager extends IConnectionManager<IMcpConnectionConfig> {
+    /**
+     * Get the current MCP session ID.
+     */
+    getSessionId(): string | null;
+    /**
+     * Call an MCP method.
+     * @param method - MCP method name
+     * @param params - Method parameters
+     */
+    call<T>(method: string, params?: Record<string, unknown>): Promise<T>;
+}
+/**
+ * Neo4j connection manager interface.
+ */
+export interface INeo4jConnectionManager extends IConnectionManager<INeo4jConnectionConfig> {
+    /**
+     * Execute a Cypher query.
+     * @param cypher - Cypher query string
+     * @param params - Query parameters
+     */
+    query<T>(cypher: string, params?: Record<string, unknown>): Promise<T[]>;
+}
+/**
+ * Zep Cloud connection manager interface.
+ */
+export interface IZepConnectionManager extends IConnectionManager<IZepConnectionConfig> {
+    /**
+     * Make a Zep API request.
+     * @param path - API path
+     * @param options - Fetch options
+     */
+    fetch<T>(path: string, options?: RequestInit): Promise<T>;
+}
+//# sourceMappingURL=IConnectionManager.d.ts.map

package/dist/lib/domain/interfaces/dal/IConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConnectionManager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/IConnectionManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,iBAAiB;IAC7D;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB,CAAC,oBAAoB,CAAC;IACrF;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB,CAAC,sBAAsB,CAAC;IACzF;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB,CAAC,oBAAoB,CAAC;IACrF;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3D"}

package/dist/lib/domain/interfaces/dal/IConnectionManager.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Connection Manager Interfaces
+ *
+ * Abstractions for managing connections to different backends.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IConnectionManager.js.map

package/dist/lib/domain/interfaces/dal/IConnectionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConnectionManager.js","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/IConnectionManager.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/lib/domain/interfaces/dal/IMemoryRepository.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Memory Repository Interface
+ *
+ * Contract for memory data access operations.
+ * Implementations may use MCP, Neo4j, or Zep Cloud as backend.
+ */
+import { IMemoryItem } from '../types/IMemoryResult';
+import { IQueryOptions, IMemoryQueryResult } from './types';
+/**
+ * Options for saving memory.
+ */
+export interface IMemorySaveOptions {
+    /** Tags to apply to the memory */
+    readonly tags?: readonly string[];
+    /** Source identifier (e.g., 'session-stop', 'user-explicit') */
+    readonly source?: string;
+}
+/**
+ * Memory repository read operations.
+ */
+export interface IMemoryRepositoryReader {
+    /**
+     * Find facts by group IDs with optional filtering and sorting.
+     * @param groupIds - Group IDs to search (hierarchical)
+     * @param options - Query options (sort, limit, tags, etc.)
+     */
+    findByGroupIds(groupIds: readonly string[], options?: IQueryOptions): Promise<IMemoryQueryResult>;
+    /**
+     * Semantic search across facts.
+     * Note: Only supported by MCP and Zep backends.
+     * @param groupIds - Group IDs to search
+     * @param query - Search query
+     * @param options - Additional options (limit, tags, etc.)
+     */
+    search(groupIds: readonly string[], query: string, options?: Omit<IQueryOptions, 'query'>): Promise<IMemoryQueryResult>;
+    /**
+     * Find facts by tags.
+     * @param groupIds - Group IDs to search
+     * @param tags - Tags to filter by
+     * @param options - Additional options
+     */
+    findByTags(groupIds: readonly string[], tags: readonly string[], options?: Omit<IQueryOptions, 'tags'>): Promise<IMemoryQueryResult>;
+}
+/**
+ * Memory repository write operations.
+ */
+export interface IMemoryRepositoryWriter {
+    /**
+     * Save a new fact to memory.
+     * @param groupId - Group ID to save to
+     * @param content - Fact content
+     * @param options - Save options (tags, source)
+     */
+    save(groupId: string, content: string, options?: IMemorySaveOptions): Promise<IMemoryItem>;
+    /**
+     * Save multiple facts in batch.
+     * @param groupId - Group ID to save to
+     * @param facts - Facts to save
+     * @param options - Save options (tags, source)
+     */
+    saveBatch(groupId: string, facts: readonly string[], options?: IMemorySaveOptions): Promise<readonly IMemoryItem[]>;
+}
+/**
+ * Memory repository capabilities.
+ */
+export interface IMemoryRepositoryCapabilities {
+    /**
+     * Check if this repository supports semantic search.
+     * Neo4j direct does not; MCP and Zep do.
+     */
+    supportsSemanticSearch(): boolean;
+    /**
+     * Check if this repository supports date-ordered queries.
+     * All backends support this, but Neo4j is most efficient.
+     */
+    supportsDateOrdering(): boolean;
+    /**
+     * Check if this repository supports write operations.
+     * Neo4j direct is read-only; MCP and Zep support writes.
+     */
+    supportsWrite(): boolean;
+}
+/**
+ * Complete memory repository interface.
+ */
+export interface IMemoryRepository extends IMemoryRepositoryReader, IMemoryRepositoryWriter, IMemoryRepositoryCapabilities {
+}
+/**
+ * Read-only memory repository (e.g., Neo4j direct).
+ */
+export interface IReadOnlyMemoryRepository extends IMemoryRepositoryReader, IMemoryRepositoryCapabilities {
+}
+//# sourceMappingURL=IMemoryRepository.d.ts.map

package/dist/lib/domain/interfaces/dal/IMemoryRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryRepository.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/IMemoryRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,cAAc,CACZ,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;OAMG;IACH,MAAM,CACJ,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,UAAU,CACR,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;;;OAKG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,sBAAsB,IAAI,OAAO,CAAC;IAElC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC;IAEhC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBACf,SAAQ,uBAAuB,EAC7B,uBAAuB,EACvB,6BAA6B;CAAG;AAEpC;;GAEG;AACH,MAAM,WAAW,yBACf,SAAQ,uBAAuB,EAC7B,6BAA6B;CAAG"}

package/dist/lib/domain/interfaces/dal/IMemoryRepository.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Memory Repository Interface
+ *
+ * Contract for memory data access operations.
+ * Implementations may use MCP, Neo4j, or Zep Cloud as backend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IMemoryRepository.js.map

package/dist/lib/domain/interfaces/dal/IMemoryRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryRepository.js","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/IMemoryRepository.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/lib/domain/interfaces/dal/IRepositoryRouter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Repository Router Interface
+ *
+ * Routes queries to the optimal backend based on operation type.
+ * Enables using Neo4j for date-ordered queries while using MCP for semantic search.
+ */
+import { IMemoryRepository, IReadOnlyMemoryRepository } from './IMemoryRepository';
+import { ITaskRepository, IReadOnlyTaskRepository } from './ITaskRepository';
+import { OperationType, BackendSource } from './types';
+/**
+ * Routing rule configuration.
+ */
+export interface IRoutingRule {
+    /** Operation type this rule applies to */
+    readonly operation: OperationType;
+    /** Preferred backend for this operation */
+    readonly preferred: BackendSource;
+    /** Fallback backend if preferred is unavailable */
+    readonly fallback?: BackendSource;
+}
+/**
+ * Router configuration.
+ */
+export interface IRouterConfig {
+    /** Available backends */
+    readonly backends: readonly BackendSource[];
+    /** Custom routing rules (overrides defaults) */
+    readonly rules?: readonly IRoutingRule[];
+}
+/**
+ * Default routing rules.
+ * - list: Neo4j (date ordering) -> MCP
+ * - search: MCP (semantic search) -> Zep
+ * - write: MCP (ingestion pipeline) -> Zep
+ * - aggregate: Neo4j (Cypher aggregation) -> MCP
+ */
+export declare const DEFAULT_ROUTING_RULES: readonly IRoutingRule[];
+/**
+ * Repository router interface.
+ * Routes to the optimal backend based on operation type.
+ */
+export interface IRepositoryRouter {
+    /**
+     * Get the optimal memory repository for the given operation.
+     * @param operation - Type of operation to perform
+     */
+    getMemoryRepository(operation: OperationType): IMemoryRepository | IReadOnlyMemoryRepository;
+    /**
+     * Get the optimal task repository for the given operation.
+     * @param operation - Type of operation to perform
+     */
+    getTaskRepository(operation: OperationType): ITaskRepository | IReadOnlyTaskRepository;
+    /**
+     * Get a specific memory repository by backend.
+     * @param backend - Backend to use
+     */
+    getMemoryRepositoryByBackend(backend: BackendSource): IMemoryRepository | IReadOnlyMemoryRepository | null;
+    /**
+     * Get a specific task repository by backend.
+     * @param backend - Backend to use
+     */
+    getTaskRepositoryByBackend(backend: BackendSource): ITaskRepository | IReadOnlyTaskRepository | null;
+    /**
+     * Check if a backend is available.
+     * @param backend - Backend to check
+     */
+    isBackendAvailable(backend: BackendSource): boolean;
+    /**
+     * Get the list of available backends.
+     */
+    getAvailableBackends(): readonly BackendSource[];
+    /**
+     * Get the current routing rules.
+     */
+    getRoutingRules(): readonly IRoutingRule[];
+    /**
+     * Update a routing rule at runtime.
+     * @param operation - Operation to update rule for
+     * @param preferred - New preferred backend
+     * @param fallback - New fallback backend
+     */
+    setRoutingRule(operation: OperationType, preferred: BackendSource, fallback?: BackendSource): void;
+}
+/**
+ * Factory function type for creating a repository router.
+ */
+export type RepositoryRouterFactory = (config?: Partial<IRouterConfig>) => Promise<IRepositoryRouter>;
+//# sourceMappingURL=IRepositoryRouter.d.ts.map

package/dist/lib/domain/interfaces/dal/IRepositoryRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRepositoryRouter.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/IRepositoryRouter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EAKxD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,iBAAiB,GAAG,yBAAyB,CAAC;IAE7F;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,aAAa,GAAG,eAAe,GAAG,uBAAuB,CAAC;IAEvF;;;OAGG;IACH,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,GAAG,yBAAyB,GAAG,IAAI,CAAC;IAE3G;;;OAGG;IACH,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,GAAG,uBAAuB,GAAG,IAAI,CAAC;IAErG;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;IAEpD;;OAEG;IACH,oBAAoB,IAAI,SAAS,aAAa,EAAE,CAAC;IAEjD;;OAEG;IACH,eAAe,IAAI,SAAS,YAAY,EAAE,CAAC;IAE3C;;;;;OAKG;IACH,cAAc,CACZ,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,aAAa,EACxB,QAAQ,CAAC,EAAE,aAAa,GACvB,IAAI,CAAC;CACT;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/lib/domain/interfaces/dal/IRepositoryRouter.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Repository Router Interface
+ *
+ * Routes queries to the optimal backend based on operation type.
+ * Enables using Neo4j for date-ordered queries while using MCP for semantic search.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ROUTING_RULES = void 0;
+/**
+ * Default routing rules.
+ * - list: Neo4j (date ordering) -> MCP
+ * - search: MCP (semantic search) -> Zep
+ * - write: MCP (ingestion pipeline) -> Zep
+ * - aggregate: Neo4j (Cypher aggregation) -> MCP
+ */
+exports.DEFAULT_ROUTING_RULES = [
+    { operation: 'list', preferred: 'neo4j', fallback: 'mcp' },
+    { operation: 'search', preferred: 'mcp', fallback: 'zep' },
+    { operation: 'write', preferred: 'mcp', fallback: 'zep' },
+    { operation: 'aggregate', preferred: 'neo4j', fallback: 'mcp' },
+];
+//# sourceMappingURL=IRepositoryRouter.js.map

package/dist/lib/domain/interfaces/dal/IRepositoryRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRepositoryRouter.js","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/IRepositoryRouter.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA4BH;;;;;;GAMG;AACU,QAAA,qBAAqB,GAA4B;IAC5D,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1D,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1D,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IACzD,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;CAChE,CAAC"}

package/dist/lib/domain/interfaces/dal/ITaskRepository.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Task Repository Interface
+ *
+ * Contract for task data access operations.
+ * Implementations may use MCP, Neo4j, or Zep Cloud as backend.
+ */
+import { ITask, ITaskInput, ITaskUpdate, ITaskCounts } from '../types/ITask';
+import { IQueryOptions, ITaskQueryResult } from './types';
+/**
+ * Task repository read operations.
+ */
+export interface ITaskRepositoryReader {
+    /**
+     * Find tasks by group IDs with optional filtering and sorting.
+     * @param groupIds - Group IDs to search (hierarchical)
+     * @param options - Query options (sort, limit, etc.)
+     */
+    findByGroupIds(groupIds: readonly string[], options?: IQueryOptions): Promise<ITaskQueryResult>;
+    /**
+     * Find a task by its key.
+     * @param groupId - Group ID containing the task
+     * @param taskKey - Task key/identifier
+     */
+    findByKey(groupId: string, taskKey: string): Promise<ITask | null>;
+    /**
+     * Find tasks by status.
+     * @param groupIds - Group IDs to search
+     * @param status - Status to filter by
+     * @param options - Additional options
+     */
+    findByStatus(groupIds: readonly string[], status: ITask['status'], options?: Omit<IQueryOptions, 'tags'>): Promise<ITaskQueryResult>;
+    /**
+     * Get task counts by status.
+     * @param groupIds - Group IDs to count
+     */
+    getCounts(groupIds: readonly string[]): Promise<ITaskCounts>;
+}
+/**
+ * Task repository write operations.
+ */
+export interface ITaskRepositoryWriter {
+    /**
+     * Create a new task.
+     * @param groupId - Group ID to create in
+     * @param task - Task input data
+     */
+    create(groupId: string, task: ITaskInput): Promise<ITask>;
+    /**
+     * Update an existing task.
+     * @param groupId - Group ID containing the task
+     * @param taskKey - Task key/identifier
+     * @param updates - Fields to update
+     */
+    update(groupId: string, taskKey: string, updates: ITaskUpdate): Promise<ITask>;
+    /**
+     * Delete a task.
+     * @param groupId - Group ID containing the task
+     * @param taskKey - Task key/identifier
+     */
+    delete(groupId: string, taskKey: string): Promise<void>;
+}
+/**
+ * Task repository capabilities.
+ */
+export interface ITaskRepositoryCapabilities {
+    /**
+     * Check if this repository supports write operations.
+     * Neo4j direct is read-only; MCP and Zep support writes.
+     */
+    supportsWrite(): boolean;
+    /**
+     * Check if this repository supports task counts aggregation.
+     * Neo4j is most efficient for this.
+     */
+    supportsAggregation(): boolean;
+}
+/**
+ * Complete task repository interface.
+ */
+export interface ITaskRepository extends ITaskRepositoryReader, ITaskRepositoryWriter, ITaskRepositoryCapabilities {
+}
+/**
+ * Read-only task repository (e.g., Neo4j direct).
+ */
+export interface IReadOnlyTaskRepository extends ITaskRepositoryReader, ITaskRepositoryCapabilities {
+}
+//# sourceMappingURL=ITaskRepository.d.ts.map

package/dist/lib/domain/interfaces/dal/ITaskRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITaskRepository.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/ITaskRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,cAAc,CACZ,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7B;;;;OAIG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,YAAY,CACV,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IAElB;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;;OAGG;IACH,mBAAmB,IAAI,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eACf,SAAQ,qBAAqB,EAC3B,qBAAqB,EACrB,2BAA2B;CAAG;AAElC;;GAEG;AACH,MAAM,WAAW,uBACf,SAAQ,qBAAqB,EAC3B,2BAA2B;CAAG"}

package/dist/lib/domain/interfaces/dal/ITaskRepository.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Task Repository Interface
+ *
+ * Contract for task data access operations.
+ * Implementations may use MCP, Neo4j, or Zep Cloud as backend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITaskRepository.js.map

package/dist/lib/domain/interfaces/dal/ITaskRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITaskRepository.js","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/ITaskRepository.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/lib/domain/interfaces/dal/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Data Access Layer (DAL) Interfaces
+ *
+ * Provides abstractions for accessing memory and task data
+ * across multiple backends (MCP, Neo4j, Zep Cloud).
+ */
+export type { SortField, SortOrder, ISortOption, IQueryOptions, BackendSource, IQueryResult, IMemoryQueryResult, ITaskQueryResult, OperationType, } from './types';
+export { DEFAULT_QUERY_OPTIONS, applyQueryDefaults, } from './types';
+export type { IConnectionConfig, IMcpConnectionConfig, INeo4jConnectionConfig, IZepConnectionConfig, IConnectionManager, IMcpConnectionManager, INeo4jConnectionManager, IZepConnectionManager, } from './IConnectionManager';
+export type { IMemorySaveOptions, IMemoryRepositoryReader, IMemoryRepositoryWriter, IMemoryRepositoryCapabilities, IMemoryRepository, IReadOnlyMemoryRepository, } from './IMemoryRepository';
+export type { ITaskRepositoryReader, ITaskRepositoryWriter, ITaskRepositoryCapabilities, ITaskRepository, IReadOnlyTaskRepository, } from './ITaskRepository';
+export type { IRoutingRule, IRouterConfig, IRepositoryRouter, RepositoryRouterFactory, } from './IRepositoryRouter';
+export { DEFAULT_ROUTING_RULES } from './IRepositoryRouter';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/domain/interfaces/dal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/dal/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,eAAe,EACf,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}