@tonycasey/lisa 2.12.0 → 2.25.2

package/dist/lib/skills/shared/services/interfaces/IMemoryService.d.ts

@@ -2,6 +2,8 @@
  * Memory service interface for skill scripts.
  * Provides a clean API for memory/fact CRUD operations.
  */
+import type { CurationMark } from '../../../../domain/interfaces/ICurationService';
+import type { ConsolidationAction } from '../../../../domain/interfaces/IConsolidationService';
 /**
  * A memory/fact item.
  */
@@ -46,6 +48,7 @@ export interface IMemoryAddOptions {
     tag?: string | null;
     type?: string;
     source?: string;
+    ttl?: number;
 }
 /**
  * Options for loading memories with date filtering.
@@ -54,6 +57,95 @@ export interface IMemoryLoadOptions {
     since?: Date;
     until?: Date;
 }
+/**
+ * Result of a memory expire operation.
+ */
+export interface IMemoryExpireResult {
+    status: 'ok';
+    action: 'expire';
+    group: string;
+    uuid: string;
+    found: boolean;
+    mode: 'neo4j';
+}
+/**
+ * Result of a memory cleanup operation.
+ */
+export interface IMemoryCleanupResult {
+    status: 'ok';
+    action: 'cleanup';
+    group: string;
+    expiredCount: number;
+    dryRun: boolean;
+    mode: 'neo4j';
+}
+/**
+ * A group of potentially conflicting facts sharing a topic.
+ */
+export interface IConflictGroup {
+    topic: string;
+    facts: IFact[];
+    detectedAt: string;
+}
+/**
+ * Result of a memory conflicts operation.
+ */
+export interface IMemoryConflictsResult {
+    status: 'ok';
+    action: 'conflicts';
+    group: string;
+    groups: string[];
+    topic: string;
+    conflictGroups: IConflictGroup[];
+    totalConflicts: number;
+    mode: 'neo4j';
+}
+/**
+ * A group of duplicate facts detected by deduplication.
+ */
+export interface IDuplicateGroup {
+    reason: 'exact-match' | 'tag-overlap' | 'similar-content' | 'llm-semantic';
+    facts: IFact[];
+    similarity: number;
+    suggestedMerge?: string;
+}
+/**
+ * Result of a memory deduplication scan.
+ */
+export interface IMemoryDedupeResult {
+    status: 'ok';
+    action: 'dedupe';
+    group: string;
+    totalFactsScanned: number;
+    duplicateGroups: IDuplicateGroup[];
+    totalDuplicates: number;
+    minSimilarity: number;
+    mode: 'neo4j';
+}
+/**
+ * Result of a memory curate operation.
+ */
+export interface IMemoryCurateResult {
+    status: 'ok';
+    action: 'curate';
+    group: string;
+    uuid: string;
+    mark: CurationMark;
+    mode: 'neo4j';
+}
+/**
+ * Result of a memory consolidate operation.
+ */
+export interface IMemoryConsolidateResult {
+    status: 'ok';
+    action: 'consolidate';
+    group: string;
+    consolidationAction: ConsolidationAction;
+    retainedUuid: string;
+    archivedUuids: string[];
+    relationshipsCreated: number;
+    mode: 'neo4j';
+}
 /**
  * Memory service interface.
  */
@@ -77,5 +169,61 @@ export interface IMemoryService {
      * @param options - Additional options (tag, type, source)
      */
     add(text: string, groupId: string, options: IMemoryAddOptions): Promise<IMemoryAddResult>;
+    /**
+     * Expire a single fact by UUID.
+     * Uses Neo4j direct to set expired_at.
+     *
+     * @param groupId - Group identifier
+     * @param uuid - UUID of the fact to expire
+     */
+    expire(groupId: string, uuid: string): Promise<IMemoryExpireResult>;
+    /**
+     * Clean up expired facts based on lifecycle TTL defaults.
+     * Expires session facts >24h and ephemeral facts >1h.
+     *
+     * @param groupId - Group identifier
+     * @param dryRun - If true, count without expiring
+     */
+    cleanup(groupId: string, dryRun: boolean): Promise<IMemoryCleanupResult>;
+    /**
+     * Find groups of potentially conflicting facts.
+     * Detects facts sharing a type:* tag but with differing content.
+     *
+     * @param groupIds - Group identifiers to search
+     * @param topic - Optional topic tag to filter by
+     */
+    conflicts(groupIds: string[], topic?: string): Promise<IMemoryConflictsResult>;
+    /**
+     * Detect duplicate facts within a group.
+     * Three-pass detection: exact match, tag overlap, Jaccard similarity.
+     *
+     * @param groupId - Group identifier to scan
+     * @param options - Detection options
+     */
+    dedupe(groupId: string, options?: {
+        minSimilarity?: number;
+        limit?: number;
+        since?: Date;
+    }): Promise<IMemoryDedupeResult>;
+    /**
+     * Mark a fact with a curation status.
+     *
+     * @param groupId - Group identifier
+     * @param uuid - UUID of the fact to mark
+     * @param mark - Curation mark (authoritative, draft, deprecated, needs-review)
+     */
+    curate(groupId: string, uuid: string, mark: CurationMark): Promise<IMemoryCurateResult>;
+    /**
+     * Consolidate multiple facts.
+     *
+     * @param groupId - Group identifier
+     * @param factUuids - UUIDs of facts to consolidate (minimum 2)
+     * @param action - Consolidation action (merge, archive-duplicates, keep-all)
+     * @param options - Additional options (retainUuid, mergedText)
+     */
+    consolidate(groupId: string, factUuids: string[], action: ConsolidationAction, options?: {
+        retainUuid?: string;
+        mergedText?: string;
+    }): Promise<IMemoryConsolidateResult>;
 }
 //# sourceMappingURL=IMemoryService.d.ts.map

package/dist/lib/skills/shared/services/interfaces/IMemoryService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMemoryService.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/services/interfaces/IMemoryService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,KAAK,GAAG,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;;;;;;OAOG;IACH,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"IMemoryService.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/services/interfaces/IMemoryService.ts"],"names":[],"mappings":"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"}

package/dist/lib/skills/shared/services/interfaces/IMemoryService.js

@@ -1,7 +1,3 @@
 "use strict";
-/**
- * Memory service interface for skill scripts.
- * Provides a clean API for memory/fact CRUD operations.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=IMemoryService.js.map

package/dist/lib/skills/shared/services/interfaces/IMemoryService.js.map

@@ -1 +1 @@
-{"version":3,"file":"IMemoryService.js","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/services/interfaces/IMemoryService.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
+{"version":3,"file":"IMemoryService.js","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/services/interfaces/IMemoryService.ts"],"names":[],"mappings":""}