@tonycasey/lisa 2.25.4 → 2.27.0

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

@@ -0,0 +1,28 @@
+/**
+ * IFileSystem
+ *
+ * Minimal file system abstraction for application-layer services
+ * that need to read/write files without directly depending on Node's fs.
+ *
+ * Infrastructure provides the real implementation (NodeFileSystem);
+ * tests provide a mock.
+ */
+/**
+ * File stat information.
+ */
+export interface IFileStat {
+    /** File modification time in milliseconds since epoch. */
+    readonly mtimeMs: number;
+}
+/**
+ * Minimal file system operations.
+ */
+export interface IFileSystem {
+    /** Read a file and return its content as a UTF-8 string. Throws if not found. */
+    readFile(filePath: string): Promise<string>;
+    /** Write content to a file. Creates parent directories if needed. */
+    writeFile(filePath: string, content: string): Promise<void>;
+    /** Get file stats. Returns null if file does not exist. */
+    stat(filePath: string): Promise<IFileStat | null>;
+}
+//# sourceMappingURL=IFileSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFileSystem.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IFileSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C,qEAAqE;IACrE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,2DAA2D;IAC3D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACnD"}

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

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * IFileSystem
+ *
+ * Minimal file system abstraction for application-layer services
+ * that need to read/write files without directly depending on Node's fs.
+ *
+ * Infrastructure provides the real implementation (NodeFileSystem);
+ * tests provide a mock.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IFileSystem.js.map

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

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

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

@@ -35,6 +35,66 @@ export interface IGitDiffOptions {
     /** Working directory for the git command. */
     readonly cwd?: string;
 }
+/**
+ * Options for detailed git log operations (triage).
+ */
+export interface IGitLogDetailedOptions {
+    /** Only show commits after this date (YYYY-MM-DD or ISO). */
+    readonly since?: string;
+    /** Only show commits before this date (YYYY-MM-DD or ISO). */
+    readonly until?: string;
+    /** Maximum number of commits to return. */
+    readonly maxCount?: number;
+    /** Working directory for the git command. */
+    readonly cwd?: string;
+}
+/**
+ * Parsed commit from detailed log.
+ */
+export interface IGitLogCommit {
+    /** Full SHA. */
+    readonly sha: string;
+    /** Short SHA. */
+    readonly shortSha: string;
+    /** Parent SHAs (space-separated in raw form). */
+    readonly parentShas: readonly string[];
+    /** Commit subject. */
+    readonly subject: string;
+    /** Commit body (may be empty). */
+    readonly body: string;
+    /** Author name. */
+    readonly authorName: string;
+    /** Author email. */
+    readonly authorEmail: string;
+    /** Author timestamp (Unix epoch). */
+    readonly authorTimestamp: number;
+    /** Ref names (tags, branches) if any. */
+    readonly refNames: string;
+}
+/**
+ * Commit stat entry from --numstat.
+ */
+export interface IGitCommitStatEntry {
+    /** Lines added (may be '-' for binary). */
+    readonly added: number | null;
+    /** Lines deleted (may be '-' for binary). */
+    readonly deleted: number | null;
+    /** File path. */
+    readonly path: string;
+    /** Whether file was added (new). */
+    readonly isNew: boolean;
+    /** Whether file was deleted. */
+    readonly isDeleted: boolean;
+}
+/**
+ * Tag information from git.
+ */
+export interface IGitTag {
+    /** Tag name. */
+    readonly name: string;
+    /** Commit SHA the tag points to. */
+    readonly sha: string;
+}
 /**
  * Git client interface for shell-free application layer code.
  */
@@ -69,5 +129,31 @@ export interface IGitClient {
      * @returns True if the ref exists.
      */
     refExists(ref: string, cwd?: string): boolean;
+    /**
+     * Get detailed commit log for triage analysis.
+     * Returns structured commit data including parents, body, refs.
+     * @param options - Log options.
+     * @returns Array of parsed commits.
+     */
+    logDetailed(options: IGitLogDetailedOptions): IGitLogCommit[];
+    /**
+     * Get file statistics for a specific commit.
+     * @param sha - Commit SHA.
+     * @param cwd - Working directory.
+     * @returns Array of stat entries per file.
+     */
+    getCommitStats(sha: string, cwd?: string): IGitCommitStatEntry[];
+    /**
+     * List all tags in the repository.
+     * @param cwd - Working directory.
+     * @returns Array of tag info.
+     */
+    listTags(cwd?: string): IGitTag[];
+    /**
+     * Get the total number of commits in the repository.
+     * @param cwd - Working directory.
+     * @returns Total commit count.
+     */
+    countCommits(cwd?: string): number;
 }
 //# sourceMappingURL=IGitClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IGitClient.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IGitClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC;IAErC;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnD;;;;OAIG;IACH,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC;IAEvC;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/C"}
+{"version":3,"file":"IGitClient.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IGitClient.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,160 @@
+/**
+ * Git Extractor Interface
+ *
+ * Defines the contract for heuristic-based extraction of structured facts
+ * from GitHub PR data (descriptions, review comments, linked issues).
+ * Complements the LLM-based CommitEnricher with fast, no-cost extraction.
+ *
+ * Part of LISA-9: Phase 3 Git-Powered Memory Extraction.
+ */
+import type { ConfidenceLevel } from './types/IMemoryQuality';
+/**
+ * Fact types that can be extracted via heuristics.
+ * Subset of memory types focused on patterns detectable without LLM.
+ */
+export type HeuristicFactType = 'decision' | 'gotcha' | 'convention';
+/**
+ * All valid heuristic fact types.
+ */
+export declare const HEURISTIC_FACT_TYPE_VALUES: readonly HeuristicFactType[];
+/**
+ * Type guard for HeuristicFactType.
+ */
+export declare function isValidHeuristicFactType(value: string): value is HeuristicFactType;
+/**
+ * Source of the extracted fact.
+ */
+export type FactSource = 'pr-description' | 'review-comment' | 'issue-body' | 'commit-pattern';
+/**
+ * All valid fact sources.
+ */
+export declare const FACT_SOURCE_VALUES: readonly FactSource[];
+/**
+ * A fact extracted via heuristic pattern matching (no LLM).
+ */
+export interface IHeuristicFact {
+    /** Self-contained description of the fact. */
+    readonly text: string;
+    /** Type of fact extracted. */
+    readonly type: HeuristicFactType;
+    /** Source of the extraction. */
+    readonly source: FactSource;
+    /** Confidence level of the extraction. */
+    readonly confidence: ConfidenceLevel;
+    /** Relevant tags (file paths, technologies, components). */
+    readonly tags: readonly string[];
+    /** PR number if sourced from GitHub PR. */
+    readonly prNumber?: number;
+    /** Issue number if sourced from linked issue. */
+    readonly issueNumber?: number;
+    /** Commit SHA if sourced from commit pattern. */
+    readonly commitSha?: string;
+    /** Name of the pattern that matched. */
+    readonly matchedPattern?: string;
+}
+/**
+ * Enriched PR data fetched from GitHub API.
+ */
+export interface IEnrichedPR {
+    /** PR number. */
+    readonly number: number;
+    /** PR title. */
+    readonly title: string;
+    /** PR description/body. */
+    readonly body: string;
+    /** PR author login. */
+    readonly author: string;
+    /** Review comments on the PR. */
+    readonly reviewComments: readonly IReviewComment[];
+    /** Issues linked to this PR. */
+    readonly linkedIssues: readonly ILinkedIssue[];
+}
+/**
+ * A review comment from a PR.
+ */
+export interface IReviewComment {
+    /** Comment ID. */
+    readonly id: number;
+    /** Comment author login. */
+    readonly author: string;
+    /** Comment body text. */
+    readonly body: string;
+    /** File path if this is a line comment. */
+    readonly path?: string;
+    /** Whether this comment thread is resolved. */
+    readonly isResolved: boolean;
+}
+/**
+ * A linked issue from a PR.
+ */
+export interface ILinkedIssue {
+    /** Issue number. */
+    readonly number: number;
+    /** Issue title. */
+    readonly title: string;
+    /** Issue body text. */
+    readonly body: string;
+}
+/**
+ * Result of heuristic extraction.
+ */
+export interface IHeuristicExtractionResult {
+    /** Extracted facts from all processed PRs. */
+    readonly facts: readonly IHeuristicFact[];
+    /** Number of PRs that were processed. */
+    readonly prsProcessed: number;
+    /** Number of PRs that were skipped (already processed or fetch failed). */
+    readonly prsSkipped: number;
+    /** Number of patterns that matched. */
+    readonly patternsMatched: number;
+}
+/**
+ * Options for heuristic extraction.
+ */
+export interface IHeuristicExtractionOptions {
+    /** Maximum PRs to process. Default: 10. */
+    readonly maxPRs?: number;
+    /** PR numbers to skip (e.g., already processed). */
+    readonly skipPRs?: readonly number[];
+    /** Restrict extraction to specific fact types. Default: all types. */
+    readonly extractTypes?: readonly HeuristicFactType[];
+    /** Minimum confidence level to include. Default: 'low'. */
+    readonly minConfidence?: ConfidenceLevel;
+}
+/**
+ * Service for heuristic-based fact extraction from GitHub PR data.
+ */
+export interface IGitExtractor {
+    /**
+     * Extract facts from PRs linked to high-interest commits.
+     *
+     * Fetches PR descriptions, review comments, and linked issues,
+     * then applies pattern matching to extract decision, gotcha,
+     * and convention facts.
+     *
+     * @param prNumbers - PR numbers to process
+     * @param repo - Repository in "owner/repo" format
+     * @param options - Extraction options
+     * @returns Extracted facts, processing stats
+     */
+    extractFromPRs(prNumbers: readonly number[], repo: string, options?: IHeuristicExtractionOptions): Promise<IHeuristicExtractionResult>;
+}
+/**
+ * Interface for fetching GitHub PR/issue data.
+ * Abstracts the underlying GitHub client for testability.
+ */
+export interface IGitHubDataFetcher {
+    /**
+     * Fetch enriched PR data including description, reviews, and linked issues.
+     *
+     * @param repo - Repository in "owner/repo" format
+     * @param prNumber - PR number to fetch
+     * @returns Enriched PR data, or null if fetch failed
+     */
+    fetchPR(repo: string, prNumber: number): Promise<IEnrichedPR | null>;
+    /**
+     * Check if GitHub API is available.
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=IGitExtractor.d.ts.map

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

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

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

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Git Extractor Interface
+ *
+ * Defines the contract for heuristic-based extraction of structured facts
+ * from GitHub PR data (descriptions, review comments, linked issues).
+ * Complements the LLM-based CommitEnricher with fast, no-cost extraction.
+ *
+ * Part of LISA-9: Phase 3 Git-Powered Memory Extraction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FACT_SOURCE_VALUES = exports.HEURISTIC_FACT_TYPE_VALUES = void 0;
+exports.isValidHeuristicFactType = isValidHeuristicFactType;
+/**
+ * All valid heuristic fact types.
+ */
+exports.HEURISTIC_FACT_TYPE_VALUES = [
+    'decision',
+    'gotcha',
+    'convention',
+];
+/**
+ * Type guard for HeuristicFactType.
+ */
+function isValidHeuristicFactType(value) {
+    return exports.HEURISTIC_FACT_TYPE_VALUES.includes(value);
+}
+/**
+ * All valid fact sources.
+ */
+exports.FACT_SOURCE_VALUES = [
+    'pr-description',
+    'review-comment',
+    'issue-body',
+    'commit-pattern',
+];
+//# sourceMappingURL=IGitExtractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IGitExtractor.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IGitExtractor.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAsBH,4DAEC;AAdD;;GAEG;AACU,QAAA,0BAA0B,GAAiC;IACtE,UAAU;IACV,QAAQ;IACR,YAAY;CACJ,CAAC;AAEX;;GAEG;AACH,SAAgB,wBAAwB,CAAC,KAAa;IACpD,OAAO,kCAA0B,CAAC,QAAQ,CAAC,KAA0B,CAAC,CAAC;AACzE,CAAC;AAWD;;GAEG;AACU,QAAA,kBAAkB,GAA0B;IACvD,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,gBAAgB;CACR,CAAC"}

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

@@ -0,0 +1,69 @@
+/**
+ * Git Indexing Service Interface
+ *
+ * Defines the contract for saving extracted git facts to memory with
+ * appropriate quality tags, lifecycle metadata, and deduplication.
+ *
+ * Part of LISA-10: Phase 4 Indexing.
+ */
+import type { IHeuristicFact } from './IGitExtractor';
+/**
+ * Conventional commit types that can be mapped to memory types.
+ */
+export type ConventionalCommitType = 'feat' | 'fix' | 'refactor' | 'docs' | 'test' | 'chore' | 'style' | 'perf' | 'ci' | 'build';
+/**
+ * Memory types derived from conventional commit types.
+ */
+export type GitMemoryType = 'milestone' | 'gotcha' | 'decision' | 'convention';
+/**
+ * All valid conventional commit types.
+ */
+export declare const CONVENTIONAL_COMMIT_TYPES: readonly ConventionalCommitType[];
+/**
+ * Mapping from conventional commit types to memory types.
+ * Returns null for types that should be skipped (e.g., chore).
+ */
+export declare const COMMIT_TYPE_TO_MEMORY_TYPE: Readonly<Record<ConventionalCommitType, GitMemoryType | null>>;
+/**
+ * Options for indexing git facts.
+ */
+export interface IGitIndexingOptions {
+    /** Conventional commit type for memory type mapping. */
+    readonly conventionalType?: ConventionalCommitType;
+    /** Skip deduplication check. Default: false. */
+    readonly skipDeduplication?: boolean;
+    /** Similarity threshold for deduplication (0-1). Default: 0.85. */
+    readonly similarityThreshold?: number;
+}
+/**
+ * Result of git fact indexing.
+ */
+export interface IGitIndexingResult {
+    /** Number of facts successfully indexed. */
+    readonly indexed: number;
+    /** Number of facts skipped (e.g., chore type). */
+    readonly skipped: number;
+    /** Number of duplicate facts not re-indexed. */
+    readonly duplicates: number;
+}
+/**
+ * Service for indexing extracted git facts to memory.
+ *
+ * Note: Group IDs are no longer used - the git repo provides scoping via git-mem.
+ */
+export interface IGitIndexingService {
+    /**
+     * Index extracted facts to memory with quality tags and deduplication.
+     *
+     * Applies:
+     * - Quality defaults: source:code-analysis, confidence from fact, lifecycle:project
+     * - Memory type mapping based on conventional commit type
+     * - Deduplication against existing memories
+     *
+     * @param facts - Facts extracted from git history
+     * @param options - Indexing options
+     * @returns Indexing result with counts
+     */
+    indexFacts(facts: readonly IHeuristicFact[], options?: IGitIndexingOptions): Promise<IGitIndexingResult>;
+}
+//# sourceMappingURL=IGitIndexingService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IGitIndexingService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IGitIndexingService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,KAAK,GACL,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,IAAI,GACJ,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAW7D,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,aAAa,GAAG,IAAI,CAAC,CAWrG,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IACnD,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;OAWG;IACH,UAAU,CACR,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

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

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Git Indexing Service Interface
+ *
+ * Defines the contract for saving extracted git facts to memory with
+ * appropriate quality tags, lifecycle metadata, and deduplication.
+ *
+ * Part of LISA-10: Phase 4 Indexing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMIT_TYPE_TO_MEMORY_TYPE = exports.CONVENTIONAL_COMMIT_TYPES = void 0;
+/**
+ * All valid conventional commit types.
+ */
+exports.CONVENTIONAL_COMMIT_TYPES = [
+    'feat',
+    'fix',
+    'refactor',
+    'docs',
+    'test',
+    'chore',
+    'style',
+    'perf',
+    'ci',
+    'build',
+];
+/**
+ * Mapping from conventional commit types to memory types.
+ * Returns null for types that should be skipped (e.g., chore).
+ */
+exports.COMMIT_TYPE_TO_MEMORY_TYPE = {
+    feat: 'milestone',
+    fix: 'gotcha',
+    refactor: 'decision',
+    docs: 'convention',
+    test: 'convention',
+    chore: null, // Skip
+    style: null, // Skip
+    perf: 'decision',
+    ci: null, // Skip
+    build: null, // Skip
+};
+//# sourceMappingURL=IGitIndexingService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IGitIndexingService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IGitIndexingService.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAwBH;;GAEG;AACU,QAAA,yBAAyB,GAAsC;IAC1E,MAAM;IACN,KAAK;IACL,UAAU;IACV,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,IAAI;IACJ,OAAO;CACC,CAAC;AAEX;;;GAGG;AACU,QAAA,0BAA0B,GAAmE;IACxG,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,QAAQ;IACb,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,IAAI,EAAG,OAAO;IACrB,KAAK,EAAE,IAAI,EAAG,OAAO;IACrB,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,IAAI,EAAM,OAAO;IACrB,KAAK,EAAE,IAAI,EAAG,OAAO;CACtB,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Git-mem Client Interface
+ *
+ * Contract for interacting with the git-mem CLI.
+ * Lives in the domain layer — implementations in infrastructure.
+ */
+import type { IGitMemEntry, IRememberOptions, IRecallOptions, IContextOptions, IRetrofitOptions, IRetrofitResult } from '../../infrastructure/git-mem/types';
+/**
+ * Client for git-mem CLI operations.
+ *
+ * All methods handle errors gracefully:
+ * - remember: returns false on failure
+ * - recall/context: return empty arrays on failure
+ * - retrofit: returns { success: false } on failure
+ */
+export interface IGitMemClient {
+    /**
+     * Store a memory in git-mem.
+     * @param text - The memory content to store
+     * @param options - Type, lifecycle, confidence, tags, commit
+     * @returns true if stored successfully, false on error
+     */
+    remember(text: string, options?: IRememberOptions): Promise<boolean>;
+    /**
+     * Search and retrieve memories.
+     * @param query - Optional search text (empty returns all)
+     * @param options - Limit, type filter, since date, tag filter
+     * @returns Array of memory entries (empty on error)
+     */
+    recall(query?: string, options?: IRecallOptions): Promise<readonly IGitMemEntry[]>;
+    /**
+     * Get memories relevant to currently staged git changes.
+     * @param options - Limit and relevance threshold
+     * @returns Array of relevant memory entries (empty on error)
+     */
+    context(options?: IContextOptions): Promise<readonly IGitMemEntry[]>;
+    /**
+     * Scan commit history and extract memories.
+     * @param options - Since date, max commits, threshold, dry run
+     * @returns Result with success status and output
+     */
+    retrofit(options?: IRetrofitOptions): Promise<IRetrofitResult>;
+}
+//# sourceMappingURL=IGitMemClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IGitMemClient.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IGitMemClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErE;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAEnF;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAErE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE"}

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

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Git-mem Client Interface
+ *
+ * Contract for interacting with the git-mem CLI.
+ * Lives in the domain layer — implementations in infrastructure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IGitMemClient.js.map

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

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