@chude/memory 4.0.0

package/dist/domain/services/query-parser.d.ts

@@ -0,0 +1,47 @@
+/**
+ * QueryParser Domain Service
+ *
+ * Parses search query strings into structured query objects.
+ * Supports terms, quoted phrases, and filter syntax.
+ *
+ * Service properties:
+ * - Stateless operations
+ * - Pure functions (no side effects)
+ * - Domain logic only (no infrastructure concerns)
+ */
+export interface ParsedQuery {
+    terms: string[];
+    filters: QueryFilters;
+    originalQuery: string;
+}
+export interface QueryFilters {
+    project?: string;
+    role?: string;
+    tool?: string;
+}
+export declare class QueryParser {
+    /**
+     * Parse a search query string into structured components.
+     * @param query The raw search query
+     * @returns Parsed query with terms and filters
+     */
+    static parse(query: string): ParsedQuery;
+    /**
+     * Convert a parsed query to FTS5 query syntax.
+     * @param parsed The parsed query
+     * @returns FTS5-compatible query string
+     */
+    static toFts5Query(parsed: ParsedQuery): string;
+    /**
+     * Check if a parsed query is effectively empty.
+     * @param parsed The parsed query
+     * @returns true if no terms and no filters
+     */
+    static isEmpty(parsed: ParsedQuery): boolean;
+    /**
+     * Check if a parsed query has any filters.
+     * @param parsed The parsed query
+     * @returns true if any filters are present
+     */
+    static hasFilters(parsed: ParsedQuery): boolean;
+}

package/dist/domain/value-objects/embedding-config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * EmbeddingConfig Value Object
+ *
+ * Represents the configuration for an embedding provider, including
+ * whether embeddings are enabled, the provider name, model, and dimensions.
+ *
+ * Value object properties:
+ * - Immutable after construction
+ * - Equality based on all field values
+ * - Validates on construction (dimensions positive integer, strings non-empty)
+ */
+interface EmbeddingConfigParams {
+    enabled: boolean;
+    provider: string;
+    model: string;
+    dimensions: number;
+}
+export declare class EmbeddingConfig {
+    private readonly _enabled;
+    private readonly _provider;
+    private readonly _model;
+    private readonly _dimensions;
+    private constructor();
+    /**
+     * Create EmbeddingConfig from parameters.
+     * @throws Error if dimensions not positive integer, provider/model empty
+     */
+    static create(params: EmbeddingConfigParams): EmbeddingConfig;
+    /**
+     * Create EmbeddingConfig with default values.
+     * Default: local provider, all-MiniLM-L6-v2, 384 dimensions, enabled.
+     */
+    static defaults(): EmbeddingConfig;
+    /**
+     * Whether embedding generation is enabled.
+     */
+    get enabled(): boolean;
+    /**
+     * The embedding provider identifier (e.g., "local", "openai", "ollama").
+     */
+    get provider(): string;
+    /**
+     * The embedding model identifier.
+     */
+    get model(): string;
+    /**
+     * The number of dimensions in the embedding vectors.
+     */
+    get dimensions(): number;
+    /**
+     * Check equality with another EmbeddingConfig.
+     * Two configs are equal if all fields match.
+     */
+    equals(other: EmbeddingConfig): boolean;
+}
+export {};

package/dist/domain/value-objects/embedding-result.d.ts

@@ -0,0 +1,46 @@
+/**
+ * EmbeddingResult Value Object
+ *
+ * Represents a vector embedding produced by an embedding provider.
+ * Contains the embedding vector, model identifier, and dimension count.
+ *
+ * Value object properties:
+ * - Immutable after construction (Float32Array is copied)
+ * - Equality based on model and embedding values
+ * - Validates on construction (dimensions match, model non-empty)
+ */
+interface EmbeddingResultParams {
+    embedding: Float32Array;
+    model: string;
+    dimensions: number;
+}
+export declare class EmbeddingResult {
+    private readonly _embedding;
+    private readonly _model;
+    private readonly _dimensions;
+    private constructor();
+    /**
+     * Create EmbeddingResult from parameters.
+     * @throws Error if dimensions mismatch, model empty, or embedding empty
+     */
+    static create(params: EmbeddingResultParams): EmbeddingResult;
+    /**
+     * The embedding vector as Float32Array.
+     * Returns a copy to preserve immutability.
+     */
+    get embedding(): Float32Array;
+    /**
+     * The model identifier that produced this embedding.
+     */
+    get model(): string;
+    /**
+     * The number of dimensions in the embedding vector.
+     */
+    get dimensions(): number;
+    /**
+     * Check equality with another EmbeddingResult.
+     * Two results are equal if they have the same model and identical embeddings.
+     */
+    equals(other: EmbeddingResult): boolean;
+}
+export {};

package/dist/domain/value-objects/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Domain Value Objects
+ *
+ * Immutable objects defined by their attributes, not identity.
+ */
+export { EmbeddingConfig } from "./embedding-config.js";
+export { EmbeddingResult } from "./embedding-result.js";
+export { ProjectPath } from "./project-path.js";
+export { SearchQuery } from "./search-query.js";
+export { SearchResult } from "./search-result.js";

package/dist/domain/value-objects/project-path.d.ts

@@ -0,0 +1,92 @@
+/**
+ * ProjectPath Value Object
+ *
+ * Represents a project directory path that can be encoded for filesystem-safe
+ * storage (e.g., as directory names) and decoded back to the original path.
+ *
+ * IMPORTANT: Claude Code's encoding is LOSSY. Three different characters all
+ * become single dashes in the encoded form:
+ * - Backslash (path separator): \ -> -
+ * - Forward slash (path separator): / -> -
+ * - Space (in folder names): " " -> -
+ * - Hyphen (in folder names): - -> - (unchanged, but indistinguishable)
+ *
+ * Since information is lost during encoding, the decoded path is "best effort"
+ * and may not match the original path exactly. Use the encoded form as the
+ * canonical identifier for matching and comparison.
+ *
+ * Encoding rules (matching Claude Code behavior):
+ * - Windows drive letter + colon + backslash -> double-dash (C:\ -> C--)
+ * - All other backslashes -> single-dash
+ * - Forward slashes -> single-dash
+ * - Spaces -> single-dash
+ * - Hyphens -> single-dash (preserved but indistinguishable)
+ *
+ * Value object properties:
+ * - Immutable after construction
+ * - Equality based on encoded path value (canonical identifier)
+ * - Validates on construction (rejects empty paths)
+ */
+export declare class ProjectPath {
+    private readonly _decoded;
+    private readonly _encoded;
+    private readonly _projectName;
+    private constructor();
+    /**
+     * Create ProjectPath from a decoded (original) path.
+     * @param path The original filesystem path (e.g., "C:\Users\Destiny\Projects\foo")
+     * @throws Error if path is empty or whitespace-only
+     */
+    static fromDecoded(path: string): ProjectPath;
+    /**
+     * Create ProjectPath from an encoded path.
+     * @param encoded The encoded path (e.g., "C--Users-Destiny-Projects-foo")
+     * @throws Error if path is empty or whitespace-only
+     */
+    static fromEncoded(encoded: string): ProjectPath;
+    /**
+     * The original filesystem path.
+     */
+    get decoded(): string;
+    /**
+     * The filesystem-safe encoded path.
+     */
+    get encoded(): string;
+    /**
+     * The project name (last segment of the path).
+     */
+    get projectName(): string;
+    /**
+     * Return a new ProjectPath with an overridden project name.
+     * Preserves encoded and decoded paths. Useful when the correct
+     * project name is resolved via filesystem lookup.
+     */
+    withProjectName(name: string): ProjectPath;
+    /**
+     * Check equality with another ProjectPath.
+     * Two paths are equal if their decoded values match.
+     */
+    equals(other: ProjectPath): boolean;
+    /**
+     * Encode a path for filesystem-safe storage.
+     * Matches Claude Code's encoding behavior:
+     * - Windows drive (C:\) becomes C--
+     * - All backslashes become single-dash
+     * - All forward slashes become single-dash
+     * - All spaces become single-dash
+     * - Hyphens remain as single-dash (lossy - indistinguishable from separators)
+     */
+    private static encode;
+    /**
+     * Decode an encoded path back to the original format.
+     * Detects Windows vs Unix based on pattern:
+     * - Windows paths have drive letter followed by double-dash (e.g., "C--")
+     * - Unix paths start with a dash (from leading /)
+     */
+    private static decode;
+    /**
+     * Extract the project name from the decoded path.
+     * Handles both Windows and Unix paths, and trailing separators.
+     */
+    private extractProjectName;
+}

package/dist/domain/value-objects/search-query.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SearchQuery Value Object
+ *
+ * Represents a validated search query for full-text search operations.
+ *
+ * Value object properties:
+ * - Immutable after construction
+ * - Equality based on query value
+ * - Validates on construction (rejects empty queries)
+ * - Trims whitespace but preserves case and special characters
+ */
+export declare class SearchQuery {
+    private readonly _value;
+    private constructor();
+    /**
+     * Create SearchQuery from a query string.
+     * @param query The search query string
+     * @throws Error if query is empty or whitespace-only
+     */
+    static from(query: string): SearchQuery;
+    /**
+     * The search query value.
+     */
+    get value(): string;
+    /**
+     * Check equality with another SearchQuery.
+     * Comparison is case-sensitive.
+     */
+    equals(other: SearchQuery): boolean;
+}

package/dist/domain/value-objects/search-result.d.ts

@@ -0,0 +1,92 @@
+/**
+ * SearchResult Value Object
+ *
+ * Represents a single search result from a full-text search query.
+ * Contains the matched message reference, relevance score, and snippet.
+ *
+ * Value object properties:
+ * - Immutable after construction
+ * - Equality based on sessionId and messageId (identity of the match)
+ * - Validates on construction (rejects invalid scores, empty IDs)
+ */
+interface SearchResultParams {
+    sessionId: string;
+    messageId: string;
+    snippet: string;
+    score: number;
+    timestamp: Date;
+    role: string;
+    /** Source ranker(s) that produced this result */
+    source?: "fts" | "vector" | "both" | undefined;
+    /** Raw scores from individual rankers before normalization */
+    rawScores?: {
+        bm25?: number | undefined;
+        cosine?: number | undefined;
+        rrf?: number | undefined;
+    } | undefined;
+}
+export declare class SearchResult {
+    private readonly _sessionId;
+    private readonly _messageId;
+    private readonly _snippet;
+    private readonly _score;
+    private readonly _timestamp;
+    private readonly _role;
+    private readonly _source?;
+    private readonly _rawScores?;
+    private constructor();
+    /**
+     * Create SearchResult from parameters.
+     * @throws Error if any required field is empty or score is out of range
+     */
+    static create(params: SearchResultParams): SearchResult;
+    /**
+     * The session ID containing this result.
+     */
+    get sessionId(): string;
+    /**
+     * The message ID within the session.
+     */
+    get messageId(): string;
+    /**
+     * The text snippet containing the match.
+     */
+    get snippet(): string;
+    /**
+     * The relevance score (0-1, higher is more relevant).
+     */
+    get score(): number;
+    /**
+     * The timestamp of the matched message.
+     */
+    get timestamp(): Date;
+    /**
+     * The role of the message author (user, assistant, system).
+     */
+    get role(): string;
+    /**
+     * The source ranker(s) that produced this result.
+     * Undefined for legacy FTS-only results.
+     */
+    get source(): "fts" | "vector" | "both" | undefined;
+    /**
+     * Raw scores from individual rankers before normalization.
+     * Undefined for legacy FTS-only results.
+     */
+    get rawScores(): {
+        bm25?: number | undefined;
+        cosine?: number | undefined;
+        rrf?: number | undefined;
+    } | undefined;
+    /**
+     * Check equality with another SearchResult.
+     * Two results are equal if they reference the same message.
+     */
+    equals(other: SearchResult): boolean;
+    /**
+     * Compare by score for sorting (descending order - higher scores first).
+     * Returns negative if this result should come before other.
+     */
+    compareByScore(other: SearchResult): number;
+}
+export {};

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @chude/memory
+ *
+ * Cross-project context persistence for Claude Code sessions.
+ *
+ * This module exports:
+ * - Domain layer: entities, value objects, services, errors
+ * - Application layer: use cases and application services
+ * - Presentation API: execute*Command functions for programmatic use
+ */
+export * from "./domain/index.js";
+export * from "./application/index.js";
+export { executeSyncCommand, executeSearchCommand, executeListCommand, executeStatsCommand, executeContextCommand, executeRelatedCommand, executeShowCommand, executeBrowseCommand, executeQueryCommand, executeInstallCommand, executeUninstallCommand, executeStatusCommand, executeDoctorCommand, executePurgeCommand, executeExportCommand, executeImportCommand, executeCompletionCommand, executeFrictionCommand, } from "./presentation/cli/commands/index.js";
+export type { CommandResult } from "./presentation/cli/commands/index.js";
+export type { SyncCommandOptions, EmbeddingPassDeps, BackgroundModeDeps, SearchCommandOptions, ListCommandOptions, StatsCommandOptions, ContextCommandOptions, RelatedCommandOptions, ShowCommandOptions, QueryCommandOptions, BrowseCommandOptions, InstallOptions, UninstallOptions, DoctorOptions, PurgeCommandOptions, PurgeResult, ExportOptions, ImportOptions, ShellType, StatusInfo, EmbeddingStatus, StatusOptions, GatherStatusOptions, FrictionCommandOptions, FrictionLogOptions, FrictionListOptions, FrictionResolveOptions, FrictionExecuteOptions, } from "./presentation/cli/commands/index.js";