@tonycasey/lisa 2.12.0 → 2.25.2

package/dist/lib/domain/interfaces/types/IMemoryLifecycle.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Memory Lifecycle Types
+ *
+ * Defines lifecycle tiers for memory facts, controlling retention and expiration.
+ *
+ * Tiers:
+ * - permanent: Never expires (e.g., project conventions, key decisions)
+ * - project: Lives for the project lifetime, no automatic expiration
+ * - session: Expires after 24h (e.g., session-captured work)
+ * - ephemeral: Expires after 1h (e.g., user prompts, transient context)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIFECYCLE_DEFAULTS = exports.LIFECYCLE_VALUES = void 0;
+exports.resolveLifecycleTag = resolveLifecycleTag;
+exports.parseLifecycleTag = parseLifecycleTag;
+exports.isValidLifecycle = isValidLifecycle;
+exports.computeExpiresAt = computeExpiresAt;
+/**
+ * All valid lifecycle values.
+ */
+exports.LIFECYCLE_VALUES = [
+    'permanent',
+    'project',
+    'session',
+    'ephemeral',
+];
+/**
+ * Default TTL (in milliseconds) for each lifecycle tier.
+ * null means no automatic expiration.
+ */
+exports.LIFECYCLE_DEFAULTS = {
+    permanent: null,
+    project: null,
+    session: 24 * 60 * 60 * 1000, // 24 hours
+    ephemeral: 60 * 60 * 1000, // 1 hour
+};
+/**
+ * Tag prefix used for lifecycle tags.
+ */
+const LIFECYCLE_TAG_PREFIX = 'lifecycle:';
+/**
+ * Resolve a lifecycle tier to its corresponding tag string.
+ *
+ * @param lifecycle - The lifecycle tier
+ * @returns Tag string, e.g. 'lifecycle:permanent'
+ */
+function resolveLifecycleTag(lifecycle) {
+    return `${LIFECYCLE_TAG_PREFIX}${lifecycle}`;
+}
+/**
+ * Parse the lifecycle tier from a tag array.
+ * Looks for tags matching 'lifecycle:<tier>'.
+ *
+ * @param tags - Array of tags to search
+ * @returns The lifecycle tier found, or 'project' as default
+ */
+function parseLifecycleTag(tags) {
+    for (const tag of tags) {
+        if (tag.startsWith(LIFECYCLE_TAG_PREFIX)) {
+            const tier = tag.slice(LIFECYCLE_TAG_PREFIX.length);
+            if (exports.LIFECYCLE_VALUES.includes(tier)) {
+                return tier;
+            }
+        }
+    }
+    return 'project';
+}
+/**
+ * Check if a string is a valid MemoryLifecycle value.
+ *
+ * @param value - The string to check
+ * @returns true if valid lifecycle tier
+ */
+function isValidLifecycle(value) {
+    return exports.LIFECYCLE_VALUES.includes(value);
+}
+/**
+ * Compute the expiration date for a lifecycle tier.
+ *
+ * @param lifecycle - The lifecycle tier
+ * @param ttlMs - Optional custom TTL override in milliseconds
+ * @param now - Optional reference time (defaults to current time)
+ * @returns Expiration Date, or null if the tier never expires
+ */
+function computeExpiresAt(lifecycle, ttlMs, now) {
+    const ttl = ttlMs ?? exports.LIFECYCLE_DEFAULTS[lifecycle];
+    if (ttl === null) {
+        return null;
+    }
+    const referenceTime = now ?? new Date();
+    return new Date(referenceTime.getTime() + ttl);
+}
+//# sourceMappingURL=IMemoryLifecycle.js.map

package/dist/lib/domain/interfaces/types/IMemoryLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryLifecycle.js","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/types/IMemoryLifecycle.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAuCH,kDAEC;AASD,8CAUC;AAQD,4CAEC;AAUD,4CAWC;AApFD;;GAEG;AACU,QAAA,gBAAgB,GAA+B;IAC1D,WAAW;IACX,SAAS;IACT,SAAS;IACT,WAAW;CACH,CAAC;AAEX;;;GAGG;AACU,QAAA,kBAAkB,GAAqD;IAClF,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAI,WAAW;IAC3C,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAQ,SAAS;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,SAA0B;IAC5D,OAAO,GAAG,oBAAoB,GAAG,SAAS,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,IAAuB;IACvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAoB,CAAC;YACvE,IAAI,wBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,OAAO,wBAAgB,CAAC,QAAQ,CAAC,KAAwB,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,SAA0B,EAC1B,KAAc,EACd,GAAU;IAEV,MAAM,GAAG,GAAG,KAAK,IAAI,0BAAkB,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,aAAa,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/domain/interfaces/types/IMemoryQuality.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Memory Quality & Source Tracking Types
+ *
+ * Defines confidence levels, source types, and helper functions for
+ * tracking fact provenance and quality. Follows the same tag-based
+ * pattern as IMemoryLifecycle.
+ *
+ * Confidence levels:
+ * - verified: Confirmed by user, code check, or test (1.0)
+ * - high: User-stated or documented (0.8)
+ * - medium: Auto-captured, consistent with other facts (0.5)
+ * - low: Inferred or from low-fidelity source (0.3)
+ * - uncertain: Needs verification (0.1)
+ *
+ * Source types:
+ * - user-explicit: User directly stated via `lisa memory add`
+ * - session-capture: Extracted from session stop handler
+ * - prompt-capture: Captured from user prompt submit
+ * - code-analysis: Inferred from code inspection
+ * - auto-inferred: System-generated inference
+ * - external-sync: Synced from external system (Jira, GitHub, etc.)
+ */
+/**
+ * Confidence level for a memory fact.
+ */
+export type ConfidenceLevel = 'verified' | 'high' | 'medium' | 'low' | 'uncertain';
+/**
+ * All valid confidence levels, ordered from highest to lowest.
+ */
+export declare const CONFIDENCE_VALUES: readonly ConfidenceLevel[];
+/**
+ * Numeric score for each confidence level (0.0 - 1.0).
+ */
+export declare const CONFIDENCE_SCORES: Readonly<Record<ConfidenceLevel, number>>;
+/**
+ * Source type indicating where a fact originated.
+ */
+export type SourceType = 'user-explicit' | 'session-capture' | 'prompt-capture' | 'code-analysis' | 'auto-inferred' | 'external-sync';
+/**
+ * All valid source types.
+ */
+export declare const SOURCE_VALUES: readonly SourceType[];
+/**
+ * Default confidence level assigned for each source type.
+ */
+export declare const DEFAULT_CONFIDENCE: Readonly<Record<SourceType, ConfidenceLevel>>;
+/**
+ * Resolve a confidence level to its corresponding tag string.
+ *
+ * @param level - The confidence level
+ * @returns Tag string, e.g. 'confidence:high'
+ */
+export declare function resolveConfidenceTag(level: ConfidenceLevel): string;
+/**
+ * Parse the confidence level from a tag array.
+ * Looks for tags matching 'confidence:<level>'.
+ *
+ * @param tags - Array of tags to search
+ * @returns The confidence level found, or null if none present
+ */
+export declare function parseConfidenceTag(tags: readonly string[]): ConfidenceLevel | null;
+/**
+ * Check if a string is a valid ConfidenceLevel value.
+ *
+ * @param value - The string to check
+ * @returns true if valid confidence level
+ */
+export declare function isValidConfidence(value: string): value is ConfidenceLevel;
+/**
+ * Convert a confidence level to its numeric score.
+ *
+ * @param level - The confidence level
+ * @returns Numeric score between 0.0 and 1.0
+ */
+export declare function confidenceToScore(level: ConfidenceLevel): number;
+/**
+ * Convert a numeric score to the nearest confidence level.
+ * Uses closest-match: finds the level whose score is nearest.
+ *
+ * @param score - Numeric score (0.0 - 1.0)
+ * @returns The nearest confidence level
+ */
+export declare function scoreToConfidence(score: number): ConfidenceLevel;
+/**
+ * Resolve a source type to its corresponding tag string.
+ *
+ * @param source - The source type
+ * @returns Tag string, e.g. 'source:user-explicit'
+ */
+export declare function resolveSourceTag(source: SourceType): string;
+/**
+ * Parse the source type from a tag array.
+ * Looks for tags matching 'source:<type>'.
+ *
+ * @param tags - Array of tags to search
+ * @returns The source type found, or null if none present
+ */
+export declare function parseSourceTag(tags: readonly string[]): SourceType | null;
+/**
+ * Check if a string is a valid SourceType value.
+ *
+ * @param value - The string to check
+ * @returns true if valid source type
+ */
+export declare function isValidSource(value: string): value is SourceType;
+/**
+ * Get the default confidence level for a given source type.
+ *
+ * @param source - The source type
+ * @returns The default confidence level
+ */
+export declare function defaultConfidenceForSource(source: SourceType): ConfidenceLevel;
+//# sourceMappingURL=IMemoryQuality.d.ts.map

package/dist/lib/domain/interfaces/types/IMemoryQuality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryQuality.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/types/IMemoryQuality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,WAAW,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAM9C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAMvE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,eAAe,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAOrC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAO5E,CAAC;AAYF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,GAAG,IAAI,CAUlF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAYhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAUzE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAE9E"}

package/dist/lib/domain/interfaces/types/IMemoryQuality.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Memory Quality & Source Tracking Types
+ *
+ * Defines confidence levels, source types, and helper functions for
+ * tracking fact provenance and quality. Follows the same tag-based
+ * pattern as IMemoryLifecycle.
+ *
+ * Confidence levels:
+ * - verified: Confirmed by user, code check, or test (1.0)
+ * - high: User-stated or documented (0.8)
+ * - medium: Auto-captured, consistent with other facts (0.5)
+ * - low: Inferred or from low-fidelity source (0.3)
+ * - uncertain: Needs verification (0.1)
+ *
+ * Source types:
+ * - user-explicit: User directly stated via `lisa memory add`
+ * - session-capture: Extracted from session stop handler
+ * - prompt-capture: Captured from user prompt submit
+ * - code-analysis: Inferred from code inspection
+ * - auto-inferred: System-generated inference
+ * - external-sync: Synced from external system (Jira, GitHub, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIDENCE = exports.SOURCE_VALUES = exports.CONFIDENCE_SCORES = exports.CONFIDENCE_VALUES = void 0;
+exports.resolveConfidenceTag = resolveConfidenceTag;
+exports.parseConfidenceTag = parseConfidenceTag;
+exports.isValidConfidence = isValidConfidence;
+exports.confidenceToScore = confidenceToScore;
+exports.scoreToConfidence = scoreToConfidence;
+exports.resolveSourceTag = resolveSourceTag;
+exports.parseSourceTag = parseSourceTag;
+exports.isValidSource = isValidSource;
+exports.defaultConfidenceForSource = defaultConfidenceForSource;
+/**
+ * All valid confidence levels, ordered from highest to lowest.
+ */
+exports.CONFIDENCE_VALUES = [
+    'verified',
+    'high',
+    'medium',
+    'low',
+    'uncertain',
+];
+/**
+ * Numeric score for each confidence level (0.0 - 1.0).
+ */
+exports.CONFIDENCE_SCORES = {
+    verified: 1.0,
+    high: 0.8,
+    medium: 0.5,
+    low: 0.3,
+    uncertain: 0.1,
+};
+/**
+ * All valid source types.
+ */
+exports.SOURCE_VALUES = [
+    'user-explicit',
+    'session-capture',
+    'prompt-capture',
+    'code-analysis',
+    'auto-inferred',
+    'external-sync',
+];
+/**
+ * Default confidence level assigned for each source type.
+ */
+exports.DEFAULT_CONFIDENCE = {
+    'user-explicit': 'high',
+    'session-capture': 'medium',
+    'prompt-capture': 'low',
+    'code-analysis': 'medium',
+    'auto-inferred': 'low',
+    'external-sync': 'medium',
+};
+/**
+ * Tag prefix used for confidence tags.
+ */
+const CONFIDENCE_TAG_PREFIX = 'confidence:';
+/**
+ * Tag prefix used for source tags.
+ */
+const SOURCE_TAG_PREFIX = 'source:';
+/**
+ * Resolve a confidence level to its corresponding tag string.
+ *
+ * @param level - The confidence level
+ * @returns Tag string, e.g. 'confidence:high'
+ */
+function resolveConfidenceTag(level) {
+    return `${CONFIDENCE_TAG_PREFIX}${level}`;
+}
+/**
+ * Parse the confidence level from a tag array.
+ * Looks for tags matching 'confidence:<level>'.
+ *
+ * @param tags - Array of tags to search
+ * @returns The confidence level found, or null if none present
+ */
+function parseConfidenceTag(tags) {
+    for (const tag of tags) {
+        if (tag.startsWith(CONFIDENCE_TAG_PREFIX)) {
+            const level = tag.slice(CONFIDENCE_TAG_PREFIX.length);
+            if (exports.CONFIDENCE_VALUES.includes(level)) {
+                return level;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check if a string is a valid ConfidenceLevel value.
+ *
+ * @param value - The string to check
+ * @returns true if valid confidence level
+ */
+function isValidConfidence(value) {
+    return exports.CONFIDENCE_VALUES.includes(value);
+}
+/**
+ * Convert a confidence level to its numeric score.
+ *
+ * @param level - The confidence level
+ * @returns Numeric score between 0.0 and 1.0
+ */
+function confidenceToScore(level) {
+    return exports.CONFIDENCE_SCORES[level];
+}
+/**
+ * Convert a numeric score to the nearest confidence level.
+ * Uses closest-match: finds the level whose score is nearest.
+ *
+ * @param score - Numeric score (0.0 - 1.0)
+ * @returns The nearest confidence level
+ */
+function scoreToConfidence(score) {
+    const clamped = Math.max(0, Math.min(1, score));
+    let closest = 'uncertain';
+    let minDiff = Infinity;
+    for (const level of exports.CONFIDENCE_VALUES) {
+        const diff = Math.abs(exports.CONFIDENCE_SCORES[level] - clamped);
+        if (diff < minDiff) {
+            minDiff = diff;
+            closest = level;
+        }
+    }
+    return closest;
+}
+/**
+ * Resolve a source type to its corresponding tag string.
+ *
+ * @param source - The source type
+ * @returns Tag string, e.g. 'source:user-explicit'
+ */
+function resolveSourceTag(source) {
+    return `${SOURCE_TAG_PREFIX}${source}`;
+}
+/**
+ * Parse the source type from a tag array.
+ * Looks for tags matching 'source:<type>'.
+ *
+ * @param tags - Array of tags to search
+ * @returns The source type found, or null if none present
+ */
+function parseSourceTag(tags) {
+    for (const tag of tags) {
+        if (tag.startsWith(SOURCE_TAG_PREFIX)) {
+            const source = tag.slice(SOURCE_TAG_PREFIX.length);
+            if (exports.SOURCE_VALUES.includes(source)) {
+                return source;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check if a string is a valid SourceType value.
+ *
+ * @param value - The string to check
+ * @returns true if valid source type
+ */
+function isValidSource(value) {
+    return exports.SOURCE_VALUES.includes(value);
+}
+/**
+ * Get the default confidence level for a given source type.
+ *
+ * @param source - The source type
+ * @returns The default confidence level
+ */
+function defaultConfidenceForSource(source) {
+    return exports.DEFAULT_CONFIDENCE[source];
+}
+//# sourceMappingURL=IMemoryQuality.js.map

package/dist/lib/domain/interfaces/types/IMemoryQuality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryQuality.js","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/types/IMemoryQuality.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAgFH,oDAEC;AASD,gDAUC;AAQD,8CAEC;AAQD,8CAEC;AASD,8CAYC;AAQD,4CAEC;AASD,wCAUC;AAQD,sCAEC;AAQD,gEAEC;AAxLD;;GAEG;AACU,QAAA,iBAAiB,GAA+B;IAC3D,UAAU;IACV,MAAM;IACN,QAAQ;IACR,KAAK;IACL,WAAW;CACH,CAAC;AAEX;;GAEG;AACU,QAAA,iBAAiB,GAA8C;IAC1E,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,GAAG;IACX,GAAG,EAAE,GAAG;IACR,SAAS,EAAE,GAAG;CACf,CAAC;AAaF;;GAEG;AACU,QAAA,aAAa,GAA0B;IAClD,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,eAAe;CACP,CAAC;AAEX;;GAEG;AACU,QAAA,kBAAkB,GAAkD;IAC/E,eAAe,EAAE,MAAM;IACvB,iBAAiB,EAAE,QAAQ;IAC3B,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,QAAQ;IACzB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,QAAQ;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,KAAsB;IACzD,OAAO,GAAG,qBAAqB,GAAG,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,IAAuB;IACxD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAoB,CAAC;YACzE,IAAI,yBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,OAAO,yBAAiB,CAAC,QAAQ,CAAC,KAAwB,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,KAAsB;IACtD,OAAO,yBAAiB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAChD,IAAI,OAAO,GAAoB,WAAW,CAAC;IAC3C,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,yBAAiB,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,yBAAiB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC;QAC1D,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,MAAkB;IACjD,OAAO,GAAG,iBAAiB,GAAG,MAAM,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,IAAuB;IACpD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAe,CAAC;YACjE,IAAI,qBAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnC,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAa;IACzC,OAAO,qBAAa,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,MAAkB;IAC3D,OAAO,0BAAkB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/domain/interfaces/types/IMemoryRelationship.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Memory Relationship Types
+ *
+ * Defines typed relationships between memory facts, enabling structured
+ * knowledge graphs where decisions can supersede others, facts can support
+ * or contradict each other, and implementations can be linked to decisions.
+ *
+ * Relationship types:
+ * - supersedes: One fact replaces another (e.g., a new decision overrides an old one)
+ * - supports: Evidence backing a decision or fact
+ * - contradicts: Conflicting information between facts
+ * - implements: Implementation of a decision or plan
+ * - relates_to: General association (catch-all)
+ * - refines: Clarification or narrowing of a fact
+ */
+/**
+ * Typed relationship between two memory facts.
+ */
+export type MemoryRelationType = 'supersedes' | 'supports' | 'contradicts' | 'implements' | 'relates_to' | 'refines';
+/**
+ * All valid memory relation type values.
+ */
+export declare const MEMORY_RELATION_VALUES: readonly MemoryRelationType[];
+/**
+ * A relationship between two memory facts.
+ */
+export interface IMemoryRelationship {
+    readonly sourceUuid: string;
+    readonly targetUuid: string;
+    readonly relationType: MemoryRelationType;
+    readonly metadata?: string;
+    readonly createdAt?: string;
+}
+/**
+ * Human-readable labels for each relation type.
+ */
+export declare const RELATION_LABELS: Readonly<Record<MemoryRelationType, string>>;
+/**
+ * Inverse labels for display (how the target describes its relationship to the source).
+ */
+export declare const INVERSE_RELATIONS: Readonly<Record<MemoryRelationType, string>>;
+/**
+ * Check if a string is a valid MemoryRelationType value.
+ *
+ * @param value - The string to check
+ * @returns true if valid relation type
+ */
+export declare function isValidRelationType(value: string): value is MemoryRelationType;
+//# sourceMappingURL=IMemoryRelationship.d.ts.map

package/dist/lib/domain/interfaces/types/IMemoryRelationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryRelationship.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/types/IMemoryRelationship.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,UAAU,GACV,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,kBAAkB,EAOtD,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAOxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAO1E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE9E"}

package/dist/lib/domain/interfaces/types/IMemoryRelationship.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Memory Relationship Types
+ *
+ * Defines typed relationships between memory facts, enabling structured
+ * knowledge graphs where decisions can supersede others, facts can support
+ * or contradict each other, and implementations can be linked to decisions.
+ *
+ * Relationship types:
+ * - supersedes: One fact replaces another (e.g., a new decision overrides an old one)
+ * - supports: Evidence backing a decision or fact
+ * - contradicts: Conflicting information between facts
+ * - implements: Implementation of a decision or plan
+ * - relates_to: General association (catch-all)
+ * - refines: Clarification or narrowing of a fact
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVERSE_RELATIONS = exports.RELATION_LABELS = exports.MEMORY_RELATION_VALUES = void 0;
+exports.isValidRelationType = isValidRelationType;
+/**
+ * All valid memory relation type values.
+ */
+exports.MEMORY_RELATION_VALUES = [
+    'supersedes',
+    'supports',
+    'contradicts',
+    'implements',
+    'relates_to',
+    'refines',
+];
+/**
+ * Human-readable labels for each relation type.
+ */
+exports.RELATION_LABELS = {
+    supersedes: 'supersedes',
+    supports: 'supports',
+    contradicts: 'contradicts',
+    implements: 'implements',
+    relates_to: 'relates to',
+    refines: 'refines',
+};
+/**
+ * Inverse labels for display (how the target describes its relationship to the source).
+ */
+exports.INVERSE_RELATIONS = {
+    supersedes: 'superseded by',
+    supports: 'supported by',
+    contradicts: 'contradicted by',
+    implements: 'implemented by',
+    relates_to: 'related to',
+    refines: 'refined by',
+};
+/**
+ * Check if a string is a valid MemoryRelationType value.
+ *
+ * @param value - The string to check
+ * @returns true if valid relation type
+ */
+function isValidRelationType(value) {
+    return exports.MEMORY_RELATION_VALUES.includes(value);
+}
+//# sourceMappingURL=IMemoryRelationship.js.map

package/dist/lib/domain/interfaces/types/IMemoryRelationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryRelationship.js","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/types/IMemoryRelationship.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAkEH,kDAEC;AAvDD;;GAEG;AACU,QAAA,sBAAsB,GAAkC;IACnE,YAAY;IACZ,UAAU;IACV,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,SAAS;CACD,CAAC;AAaX;;GAEG;AACU,QAAA,eAAe,GAAiD;IAC3E,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;GAEG;AACU,QAAA,iBAAiB,GAAiD;IAC7E,UAAU,EAAE,eAAe;IAC3B,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,iBAAiB;IAC9B,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,OAAO,8BAAsB,CAAC,QAAQ,CAAC,KAA2B,CAAC,CAAC;AACtE,CAAC"}

package/dist/lib/domain/interfaces/types/ITaskType.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Task Type & Context Strategy Types
+ *
+ * Defines task types for mode-aware retrieval and context strategies
+ * that control how memory is searched based on what the user is doing.
+ *
+ * Task types:
+ * - planning: Designing architecture, making decisions, evaluating trade-offs
+ * - execution: Implementing features, writing code, building functionality
+ * - exploration: Brainstorming, investigating possibilities, research
+ * - debugging: Fixing bugs, diagnosing errors, troubleshooting
+ */
+/**
+ * Task type for mode-aware retrieval.
+ */
+export type TaskType = 'planning' | 'execution' | 'exploration' | 'debugging';
+/**
+ * All valid task type values.
+ */
+export declare const TASK_TYPE_VALUES: readonly TaskType[];
+/**
+ * Context strategy that controls retrieval behavior per task type.
+ */
+export interface IContextStrategy {
+    /** Memory search types to query (e.g. 'decision', 'retrospective', 'pattern') */
+    readonly searchTypes: readonly string[];
+    /** Maximum results per search type */
+    readonly maxResults: number;
+    /** Timeout for memory queries (ms) */
+    readonly timeout: number;
+    /** Maximum facts to load in session context */
+    readonly factLimit: number;
+    /** Search breadth: how many topic keywords to use */
+    readonly searchBreadth: number;
+}
+/**
+ * Default context strategies per task type.
+ */
+export declare const DEFAULT_CONTEXT_STRATEGIES: Readonly<Record<TaskType, IContextStrategy>>;
+/**
+ * Detection signal keywords per task type.
+ * Used by TaskTypeDetector for signal-based scoring.
+ */
+export declare const DETECTION_SIGNALS: Readonly<Record<TaskType, readonly string[]>>;
+/**
+ * Check if a string is a valid TaskType value.
+ *
+ * @param value - The string to check
+ * @returns true if valid task type
+ */
+export declare function isValidTaskType(value: string): value is TaskType;
+/**
+ * Get the default context strategy for a task type.
+ *
+ * @param taskType - The task type
+ * @returns The default context strategy
+ */
+export declare function getDefaultStrategy(taskType: TaskType): IContextStrategy;
+//# sourceMappingURL=ITaskType.d.ts.map

package/dist/lib/domain/interfaces/types/ITaskType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITaskType.d.ts","sourceRoot":"","sources":["../../../../../src/lib/domain/interfaces/types/ITaskType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,EAKtC,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CA6BnF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC,CAqB3E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAEvE"}