@tonycasey/lisa 2.25.4 → 2.27.0

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

@@ -0,0 +1,180 @@
+/**
+ * IGitTriageService
+ *
+ * Domain interface for git history triage.
+ * Scans local git history and scores commits for "interestingness"
+ * to identify which commits warrant API enrichment.
+ *
+ * Part of the Git-Powered Memory feature (LISA-7).
+ */
+/**
+ * Raw commit data extracted from git log.
+ */
+export interface IGitCommitData {
+    /** Full commit SHA. */
+    readonly sha: string;
+    /** Short commit SHA. */
+    readonly shortSha: string;
+    /** Commit subject (first line of message). */
+    readonly subject: string;
+    /** Commit body (rest of message after subject). */
+    readonly body: string;
+    /** Number of parent commits (1 = normal, 2+ = merge). */
+    readonly parentCount: number;
+    /** Author name. */
+    readonly author: string;
+    /** Author email. */
+    readonly authorEmail: string;
+    /** Commit timestamp. */
+    readonly timestamp: Date;
+    /** Ref names pointing to this commit (tags, branches). */
+    readonly refs: readonly string[];
+}
+/**
+ * Diff statistics for a commit.
+ */
+export interface IGitCommitStats {
+    /** Number of files changed. */
+    readonly filesChanged: number;
+    /** Number of lines added. */
+    readonly insertions: number;
+    /** Number of lines deleted. */
+    readonly deletions: number;
+    /** List of file paths that were added (new files). */
+    readonly filesAdded: readonly string[];
+    /** List of file paths that were deleted. */
+    readonly filesDeleted: readonly string[];
+    /** List of directories created (first appearance). */
+    readonly directoriesCreated: readonly string[];
+}
+/**
+ * Interest signals detected for a commit.
+ */
+export interface ICommitInterestSignals {
+    /** Large diff: 10+ files changed. */
+    readonly largeDiffFiles: boolean;
+    /** Large diff: 500+ lines changed. */
+    readonly largeDiffLines: boolean;
+    /** Merge commit with PR reference. */
+    readonly mergeCommitWithPR: boolean;
+    /** Has conventional commit prefix (feat:, fix:, refactor:, etc.). */
+    readonly hasConventionalPrefix: boolean;
+    /** Conventional commit type if detected. */
+    readonly conventionalType: string | null;
+    /** Contains decision keywords (migrate, replace, rewrite, etc.). */
+    readonly hasDecisionKeywords: boolean;
+    /** Creates new top-level directory. */
+    readonly createsNewDirectory: boolean;
+    /** Within N commits of a version tag. */
+    readonly isTagAdjacent: boolean;
+    /** Has multi-line commit body. */
+    readonly hasLongMessageBody: boolean;
+    /** Extracted PR number from merge commit message. */
+    readonly prNumber: number | null;
+}
+/**
+ * A scored commit ready for triage decision.
+ */
+export interface IScoredCommit {
+    /** The commit data. */
+    readonly commit: IGitCommitData;
+    /** Diff statistics (may be null if not fetched). */
+    readonly stats: IGitCommitStats | null;
+    /** Interest signals detected. */
+    readonly signals: ICommitInterestSignals;
+    /** Calculated interest score. */
+    readonly score: number;
+    /** Whether this commit passed the triage threshold. */
+    readonly passedTriage: boolean;
+}
+/**
+ * Result of a triage scan.
+ */
+export interface ITriageResult {
+    /** Total commits scanned. */
+    readonly totalCommits: number;
+    /** Commits below threshold (skipped). */
+    readonly belowThreshold: number;
+    /** Commits with minor interest (extracted from message only). */
+    readonly minorInterest: number;
+    /** High-interest commits queued for API enrichment. */
+    readonly highInterest: readonly IScoredCommit[];
+    /** Commits linked to PRs (subset of highInterest). */
+    readonly linkedToPRs: number;
+    /** Commits linked to tags/releases. */
+    readonly linkedToTags: number;
+    /** Hotspot files (most frequently changed). */
+    readonly hotspots: readonly IFileHotspot[];
+    /** Tags found in the scanned range. */
+    readonly tags: readonly ITagInfo[];
+    /** Scan duration in milliseconds. */
+    readonly durationMs: number;
+}
+/**
+ * File hotspot information.
+ */
+export interface IFileHotspot {
+    /** File path. */
+    readonly path: string;
+    /** Number of commits touching this file. */
+    readonly commitCount: number;
+    /** Total lines changed across all commits. */
+    readonly totalLinesChanged: number;
+}
+/**
+ * Tag information.
+ */
+export interface ITagInfo {
+    /** Tag name. */
+    readonly name: string;
+    /** Commit SHA the tag points to. */
+    readonly sha: string;
+    /** Whether this looks like a version tag (v1.0.0, 1.0.0, etc.). */
+    readonly isVersionTag: boolean;
+}
+/**
+ * Options for triage scan.
+ */
+export interface ITriageOptions {
+    /** Start date for scan (default: 3 months ago). */
+    readonly since?: Date;
+    /** End date for scan (default: now). */
+    readonly until?: Date;
+    /** Score threshold for high interest (default: 3). */
+    readonly threshold?: number;
+    /** Maximum commits to scan (default: unlimited). */
+    readonly maxCommits?: number;
+    /** Working directory (default: current). */
+    readonly cwd?: string;
+    /** Whether to fetch stats for all commits (slower) or only high-interest. */
+    readonly fetchAllStats?: boolean;
+}
+/**
+ * Git triage service interface.
+ *
+ * Scans git history to identify commits worth investigating via API.
+ */
+export interface IGitTriageService {
+    /**
+     * Perform a triage scan of git history.
+     * @param options - Scan options.
+     * @returns Triage results with scored commits.
+     */
+    triage(options?: ITriageOptions): Promise<ITriageResult>;
+    /**
+     * Score a single commit.
+     *
+     * Note: For tag-adjacency, the caller should pre-compute whether the commit
+     * is within N commits of a tag (using positional analysis). If `isTagAdjacent`
+     * is not provided, this method falls back to checking if the commit itself
+     * is a tagged commit (SHA in tagShas), which is a weaker signal.
+     *
+     * @param commit - Commit data.
+     * @param stats - Optional diff stats.
+     * @param tagShas - Set of SHAs that have tags (used for fallback if isTagAdjacent not provided).
+     * @param isTagAdjacent - Pre-computed tag adjacency (recommended for accurate scoring).
+     * @returns Scored commit with signals.
+     */
+    scoreCommit(commit: IGitCommitData, stats: IGitCommitStats | null, tagShas: ReadonlySet<string>, isTagAdjacent?: boolean): IScoredCommit;
+}
+//# sourceMappingURL=IGitTriageService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IGitTriageService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IGitTriageService.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * IGitTriageService
+ *
+ * Domain interface for git history triage.
+ * Scans local git history and scores commits for "interestingness"
+ * to identify which commits warrant API enrichment.
+ *
+ * Part of the Git-Powered Memory feature (LISA-7).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IGitTriageService.js.map

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

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

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

@@ -1,10 +1,8 @@
 import type { ILisaContext } from './ILisaContext';
 import type { IMemoryService } from './IMemoryService';
 import type { ITaskService } from './ITaskService';
-import type { IMcpClient } from './IMcpClient';
 import type { ISessionCaptureService } from './ISessionCaptureService';
 import type { IEventEmitter } from './IEventEmitter';
-import type { IRepositoryRouter } from './dal';
 import type { IRecursionService } from './IRecursionService';
 import type { ILogger } from './ILogger';
 import type { IGitHubSyncService } from '../../skills/shared/services/GitHubSyncService';
@@ -16,16 +14,9 @@ export interface ILisaServices {
     readonly context: ILisaContext;
     readonly memory: IMemoryService;
     readonly tasks: ITaskService;
-    readonly mcp: IMcpClient;
     readonly events: IEventEmitter;
     readonly sessionCapture: ISessionCaptureService;
     readonly logger: ILogger;
-    /**
-     * Repository router for DAL operations.
-     * Routes to optimal backend (Neo4j, MCP, Zep) based on operation type.
-     * Optional - may be undefined if DAL initialization fails.
-     */
-    readonly router?: IRepositoryRouter;
     /**
      * Recursion service for plan mode memory search.
      * Optional - may be undefined if not needed.

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

@@ -1 +1 @@
-{"version":3,"file":"ILisaServices.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILisaServices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C"}
+{"version":3,"file":"ILisaServices.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILisaServices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C"}

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

@@ -1,8 +1,5 @@
 import type { IMemoryResult, IMemoryItem } from './types';
 import type { IMemorySaveOptions } from './dal/IMemoryRepository';
-import type { IMemoryRelationship, MemoryRelationType } from './types/IMemoryRelationship';
-import type { ConfidenceLevel } from './types/IMemoryQuality';
-import type { IQueryOptions, IConflictGroup } from './dal/types';
 /**
  * Options for date-filtered memory queries.
  */
@@ -15,104 +12,65 @@ export interface IMemoryDateOptions {
 /**
  * Read operations for memory.
  * Separated for Interface Segregation Principle.
+ *
+ * Note: Group IDs are no longer used - the git repo itself provides scoping
+ * via git-mem (git notes in refs/notes/mem).
  */
 export interface IMemoryReader {
     /**
-     * Load memory for a group, querying hierarchically.
-     * @param groupIds - Hierarchical group IDs to query
-     * @param aliases - Project aliases for tagging
-     * @param branch - Current git branch (for tagging)
+     * Load memory from the repository.
      * @param timeoutMs - Timeout in milliseconds
      */
-    loadMemory(groupIds: readonly string[], aliases: readonly string[], branch: string | null, timeoutMs?: number): Promise<IMemoryResult>;
+    loadMemory(timeoutMs?: number): Promise<IMemoryResult>;
     /**
      * Load facts with date ordering (newest first).
-     * Uses DAL router with Neo4j when available for optimal performance.
-     * @param groupIds - Group IDs to query
      * @param limit - Maximum number of facts to return
      * @param options - Optional date filtering options
      */
-    loadFactsDateOrdered(groupIds: readonly string[], limit?: number, options?: IMemoryDateOptions): Promise<IMemoryItem[]>;
+    loadFactsDateOrdered(limit?: number, options?: IMemoryDateOptions): Promise<IMemoryItem[]>;
     /**
      * Semantic search for facts.
-     * Uses DAL router with MCP when available.
-     * @param groupIds - Group IDs to search
      * @param query - Search query
      * @param limit - Maximum number of results
      */
-    searchFacts(groupIds: readonly string[], query: string, limit?: number): Promise<IMemoryItem[]>;
+    searchFacts(query: string, limit?: number): Promise<IMemoryItem[]>;
 }
 /**
  * Write operations for memory.
  * Separated for Interface Segregation Principle.
+ *
+ * Note: Group IDs are no longer used - the git repo itself provides scoping.
  */
 export interface IMemoryWriter {
     /**
      * Save facts to memory.
-     * @param groupId - Group ID to save to
      * @param facts - Facts to save
      */
-    saveMemory(groupId: string, facts: readonly string[]): Promise<void>;
+    saveMemory(facts: readonly string[]): Promise<void>;
     /**
      * Add a single fact to memory.
-     * @param groupId - Group ID to save to
      * @param fact - Fact to add
      * @param tags - Optional tags for the fact
      */
-    addFact(groupId: string, fact: string, tags?: readonly string[]): Promise<void>;
+    addFact(fact: string, tags?: readonly string[]): Promise<void>;
     /**
      * Add a fact with lifecycle metadata.
      * Enriches tags with lifecycle:<tier> tag and delegates to addFact.
-     * @param groupId - Group ID to save to
      * @param fact - Fact to add
      * @param options - Save options including lifecycle and TTL
      */
-    addFactWithLifecycle(groupId: string, fact: string, options: IMemorySaveOptions): Promise<void>;
+    addFactWithLifecycle(fact: string, options: IMemorySaveOptions): Promise<void>;
     /**
      * Expire a single fact by UUID.
-     * Routes to Neo4j repository for direct Cypher expiration.
-     * @param groupId - Group ID the fact belongs to
      * @param uuid - UUID of the fact to expire
      */
-    expireFact(groupId: string, uuid: string): Promise<void>;
+    expireFact(uuid: string): Promise<void>;
     /**
      * Clean up expired facts based on lifecycle TTL defaults.
      * Expires session facts older than 24h and ephemeral facts older than 1h.
-     * @param groupId - Group ID to clean up
      * @returns Number of facts expired
      */
-    cleanupExpired(groupId: string): Promise<number>;
-}
-/**
- * Relationship operations for memory facts.
- * Separated for Interface Segregation Principle.
- * Optional — only available when a relationship-capable backend (e.g., Neo4j) is present.
- */
-export interface IMemoryRelationshipWriter {
-    /**
-     * Create a typed relationship between two facts.
-     * @param groupId - Group ID for scoping
-     * @param sourceUuid - UUID of the source fact
-     * @param targetUuid - UUID of the target fact
-     * @param relationType - Type of relationship
-     * @param metadata - Optional annotation for the relationship
-     */
-    linkFacts(groupId: string, sourceUuid: string, targetUuid: string, relationType: MemoryRelationType, metadata?: string): Promise<void>;
-    /**
-     * Remove a typed relationship between two facts.
-     * @param groupId - Group ID for scoping
-     * @param sourceUuid - UUID of the source fact
-     * @param targetUuid - UUID of the target fact
-     * @param relationType - Type of relationship to remove
-     */
-    unlinkFacts(groupId: string, sourceUuid: string, targetUuid: string, relationType: MemoryRelationType): Promise<void>;
-    /**
-     * Get all relationships for a fact.
-     * @param groupId - Group ID for scoping
-     * @param uuid - UUID of the fact
-     * @param relationType - Optional filter by relation type
-     */
-    getRelatedFacts(groupId: string, uuid: string, relationType?: MemoryRelationType): Promise<IMemoryRelationship[]>;
+    cleanupExpired(): Promise<number>;
 }
 /**
  * Full memory service interface.
@@ -120,37 +78,4 @@ export interface IMemoryRelationshipWriter {
  */
 export interface IMemoryService extends IMemoryReader, IMemoryWriter {
 }
-/**
- * Extended memory service with relationship support.
- * Consumers that need relationship operations can check/cast to this interface.
- */
-export interface IMemoryServiceWithRelationships extends IMemoryService, IMemoryRelationshipWriter {
-}
-/**
- * Quality read operations for memory.
- * Provides confidence filtering and conflict detection.
- * Separated for Interface Segregation Principle.
- */
-export interface IMemoryQualityReader {
-    /**
-     * Find facts at or above a minimum confidence level.
-     * @param groupIds - Group IDs to search
-     * @param minLevel - Minimum confidence level (inclusive)
-     * @param options - Additional query options
-     */
-    findByMinConfidence(groupIds: readonly string[], minLevel: ConfidenceLevel, options?: IQueryOptions): Promise<IMemoryItem[]>;
-    /**
-     * Find groups of potentially conflicting facts.
-     * Detects facts sharing topic tags but with differing content.
-     * @param groupIds - Group IDs to search
-     * @param topic - Optional topic to filter conflicts by
-     */
-    findConflicts(groupIds: readonly string[], topic?: string): Promise<readonly IConflictGroup[]>;
-}
-/**
- * Extended memory service with quality query support.
- * Consumers that need quality operations can check/cast to this interface.
- */
-export interface IMemoryServiceWithQuality extends IMemoryService, IMemoryQualityReader {
-}
 //# sourceMappingURL=IMemoryService.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IMemoryService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IMemoryService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"IMemoryService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IMemoryService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD;;;;OAIG;IACH,oBAAoB,CAClB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACpE;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/E;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa,EAAE,aAAa;CAAG"}

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

@@ -52,6 +52,8 @@ export interface INlCurationResult {
 /**
  * Natural language curation service.
  * Translates natural language into structured memory operations.
+ *
+ * Note: Group IDs are no longer used - the git repo provides scoping via git-mem.
  */
 export interface INlCurationService {
     /**
@@ -59,17 +61,15 @@ export interface INlCurationService {
      * Does NOT execute — returns a plan for user review.
      *
      * @param input - Natural language command
-     * @param groupId - Memory group to operate on
      * @throws LlmDisabledError if LLM is disabled
      * @throws LlmFeatureDisabledError if curation feature is disabled
      */
-    plan(input: string, groupId: string): Promise<INlCurationPlan>;
+    plan(input: string): Promise<INlCurationPlan>;
     /**
      * Execute a previously generated plan.
      *
      * @param plan - The plan to execute
-     * @param groupId - Memory group to operate on
      */
-    execute(plan: INlCurationPlan, groupId: string): Promise<INlCurationResult>;
+    execute(plan: INlCurationPlan): Promise<INlCurationResult>;
 }
 //# sourceMappingURL=INlCurationService.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"INlCurationService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/INlCurationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAMvD,CAAC;AAEX;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAEhF;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;IAC1E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;OAQG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7E"}
+{"version":3,"file":"INlCurationService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/INlCurationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAMvD,CAAC;AAEX;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAEhF;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;IAC1E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9C;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5D"}

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

@@ -31,6 +31,8 @@ export interface IRecursionConfig {
  * When a user submits a prompt, this service searches memory for
  * relevant context: previous decisions, learnings, and tasks.
  * The search strategy adapts based on the detected task type.
+ *
+ * Note: Group IDs are no longer used - the git repo provides scoping via git-mem.
  */
 export interface IRecursionService {
     /**
@@ -38,11 +40,10 @@ export interface IRecursionService {
      * Searches for relevant decisions, learnings, and tasks.
      *
      * @param prompt - The user's prompt text
-     * @param groupIds - Hierarchical group IDs to search
      * @param taskType - Optional task type to adjust search strategy
      * @returns Recursion result with found context
      */
-    run(prompt: string, groupIds: readonly string[], taskType?: TaskType): Promise<IRecursionResult>;
+    run(prompt: string, taskType?: TaskType): Promise<IRecursionResult>;
     /**
      * Check if recursion should run for a given prompt.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"IRecursionService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IRecursionService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;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;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;OAQG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjG;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACjF"}
+{"version":3,"file":"IRecursionService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IRecursionService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;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;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEpE;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACjF"}

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

@@ -0,0 +1,132 @@
+/**
+ * IRepoProfileService
+ *
+ * Domain interface for generating and maintaining a living repo profile
+ * markdown document at `.lisa/data/repo-profile.md`.
+ *
+ * Consumes pipeline data from Phase 1 (triage) and Phase 3 (extraction)
+ * plus init-review codebase summary to produce a structured profile
+ * that gives every session instant understanding of the project.
+ *
+ * Part of LISA-11: Repo Profile Generation.
+ */
+import type { ITriageResult, IGitCommitData } from './IGitTriageService';
+import type { IHeuristicExtractionResult } from './IGitExtractor';
+/**
+ * Freshness state of the repo profile.
+ *
+ * - fresh: updated within 24h
+ * - stale: 1-7 days old
+ * - expired: older than 7 days
+ * - missing: file does not exist
+ */
+export type ProfileFreshness = 'fresh' | 'stale' | 'expired' | 'missing';
+/**
+ * All valid profile freshness values.
+ */
+export declare const PROFILE_FRESHNESS_VALUES: readonly ProfileFreshness[];
+/**
+ * Result of checking profile freshness.
+ */
+export interface IProfileFreshnessResult {
+    /** Current freshness state. */
+    readonly freshness: ProfileFreshness;
+    /** When the profile was last updated (null if missing). */
+    readonly lastUpdated: Date | null;
+    /** Age in hours (null if missing). */
+    readonly ageHours: number | null;
+    /** Human-readable note about freshness. */
+    readonly note: string;
+}
+/**
+ * Input data for generating a repo profile.
+ * Aggregates data from the git pipeline phases.
+ */
+export interface IProfileInput {
+    /** Project name (e.g. from package.json or directory name). */
+    readonly projectName: string;
+    /** Project root path. */
+    readonly projectRoot: string;
+    /** Triage result from Phase 1 (optional - may not have run). */
+    readonly triage?: ITriageResult;
+    /** Heuristic extraction result from Phase 3 (optional). */
+    readonly extraction?: IHeuristicExtractionResult;
+    /** Init-review codebase summary (optional). */
+    readonly codebaseSummary?: string;
+    /** Recent git commits for the "Recent Activity" section. */
+    readonly recentCommits?: readonly IGitCommitData[];
+    /** Timestamp when profile generation was initiated. */
+    readonly generatedAt: Date;
+}
+/**
+ * Result of profile generation.
+ */
+export interface IProfileGenerateResult {
+    /** The generated markdown content. */
+    readonly markdown: string;
+    /** Path where the profile was written. */
+    readonly filePath: string;
+    /** Number of sections that had data populated. */
+    readonly sectionsPopulated: number;
+    /** Total number of sections in the template. */
+    readonly totalSections: number;
+}
+/**
+ * Result of reading an existing profile.
+ */
+export interface IProfileReadResult {
+    /** The markdown content (null if file is missing). */
+    readonly markdown: string | null;
+    /** Freshness information. */
+    readonly freshness: IProfileFreshnessResult;
+    /** Path where the profile would/does live. */
+    readonly filePath: string;
+}
+/**
+ * Options for profile generation.
+ */
+export interface IProfileGenerateOptions {
+    /** Maximum hotspots to include. Default: 10. */
+    readonly maxHotspots?: number;
+    /** Maximum facts per section (decisions, gotchas, conventions). Default: 10. */
+    readonly maxFactsPerSection?: number;
+    /** Maximum recent commits to include. Default: 10. */
+    readonly maxRecentCommits?: number;
+}
+/**
+ * Service for generating and maintaining the repo profile markdown document.
+ */
+export interface IRepoProfileService {
+    /**
+     * Generate a full repo profile from pipeline data.
+     * Writes the markdown file to `.lisa/data/repo-profile.md`.
+     *
+     * @param input - Aggregated pipeline data
+     * @param options - Generation options
+     * @returns Generation result with markdown content and stats
+     */
+    generate(input: IProfileInput, options?: IProfileGenerateOptions): Promise<IProfileGenerateResult>;
+    /**
+     * Read the existing repo profile, if present.
+     * Returns content and freshness information.
+     *
+     * @param projectRoot - Project root directory
+     * @returns Read result with content and freshness
+     */
+    read(projectRoot: string): Promise<IProfileReadResult>;
+    /**
+     * Check the freshness of the existing repo profile.
+     * Lightweight metadata check without reading full content.
+     *
+     * Freshness rules:
+     * - fresh: updated within 24h
+     * - stale: 1-7 days old
+     * - expired: older than 7 days
+     * - missing: file does not exist
+     *
+     * @param projectRoot - Project root directory
+     * @returns Freshness result
+     */
+    checkFreshness(projectRoot: string): Promise<IProfileFreshnessResult>;
+}
+//# sourceMappingURL=IRepoProfileService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IRepoProfileService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IRepoProfileService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAKtD,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IAClC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yBAAyB;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACjD,+CAA+C;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnD,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,QAAQ,CACN,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC;;;;;;OAMG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEvD;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACvE"}

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

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * IRepoProfileService
+ *
+ * Domain interface for generating and maintaining a living repo profile
+ * markdown document at `.lisa/data/repo-profile.md`.
+ *
+ * Consumes pipeline data from Phase 1 (triage) and Phase 3 (extraction)
+ * plus init-review codebase summary to produce a structured profile
+ * that gives every session instant understanding of the project.
+ *
+ * Part of LISA-11: Repo Profile Generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROFILE_FRESHNESS_VALUES = void 0;
+/**
+ * All valid profile freshness values.
+ */
+exports.PROFILE_FRESHNESS_VALUES = [
+    'fresh',
+    'stale',
+    'expired',
+    'missing',
+];
+//# sourceMappingURL=IRepoProfileService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IRepoProfileService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IRepoProfileService.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAeH;;GAEG;AACU,QAAA,wBAAwB,GAAgC;IACnE,OAAO;IACP,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC"}