@monoes/memory 1.0.4 → 1.0.6

package/dist/agent-memory-scope.d.ts

@@ -1,131 +0,0 @@
-/**
- * Agent-Scoped Memory - Support for Claude Code's 3-scope agent memory directories
- *
- * Claude Code organizes agent memory into three scopes:
- * - **project**: Shared across all collaborators (checked into git)
- * - **local**: Machine-specific, not shared (gitignored)
- * - **user**: Global per-user, spans all projects
- *
- * Each scope stores agent-specific memory in a named subdirectory,
- * enabling isolated yet transferable knowledge between agents.
- *
- * @module @monomind/memory/agent-memory-scope
- */
-import type { IMemoryBackend } from './types.js';
-import { AutoMemoryBridge } from './auto-memory-bridge.js';
-import type { AutoMemoryBridgeConfig, InsightCategory } from './auto-memory-bridge.js';
-/** Claude Code's 3-scope agent memory system */
-export type AgentMemoryScope = 'project' | 'local' | 'user';
-/** Configuration for agent-scoped memory bridge */
-export interface AgentScopedConfig extends AutoMemoryBridgeConfig {
-    /** Agent name (used in directory path) */
-    agentName: string;
-    /** Memory scope */
-    scope: AgentMemoryScope;
-}
-/** Options for knowledge transfer between agents */
-export interface TransferOptions {
-    /** Source namespace to transfer from */
-    sourceNamespace: string;
-    /** Minimum confidence to include (default: 0.8) */
-    minConfidence?: number;
-    /** Maximum entries to transfer (default: 20) */
-    maxEntries?: number;
-    /** Filter by categories */
-    categories?: InsightCategory[];
-}
-/** Result of a knowledge transfer */
-export interface TransferResult {
-    /** Number of entries transferred */
-    transferred: number;
-    /** Number of entries skipped (below threshold or duplicate) */
-    skipped: number;
-}
-/**
- * Resolve the agent memory directory for a given agent name, scope, and working directory.
- *
- * Path resolution matches Claude Code binary behavior:
- * ```
- * project: <gitRoot>/.claude/agent-memory/<agentName>/
- * local:   <gitRoot>/.claude/agent-memory-local/<agentName>/
- * user:    ~/.claude/agent-memory/<agentName>/
- * ```
- *
- * Agent names are sanitized to prevent path traversal attacks.
- *
- * @param agentName - The agent identifier
- * @param scope - Memory scope: project, local, or user
- * @param workingDir - Working directory for git root detection (defaults to cwd)
- * @returns Absolute path to the agent's memory directory
- */
-export declare function resolveAgentMemoryDir(agentName: string, scope: AgentMemoryScope, workingDir?: string): string;
-/**
- * Create an AutoMemoryBridge configured for a specific agent scope.
- *
- * This is the primary factory for creating scoped bridges. It resolves
- * the correct memory directory based on agent name and scope, then
- * delegates to AutoMemoryBridge for the actual sync logic.
- *
- * @param backend - the LanceDB memory backend
- * @param config - Agent-scoped configuration
- * @returns A configured AutoMemoryBridge instance
- *
- * @example
- * ```typescript
- * const bridge = createAgentBridge(backend, {
- *   agentName: 'coder',
- *   scope: 'project',
- *   syncMode: 'on-write',
- * });
- * await bridge.recordInsight({ ... });
- * ```
- */
-export declare function createAgentBridge(backend: IMemoryBackend, config: AgentScopedConfig): AutoMemoryBridge;
-/**
- * Transfer knowledge from a source backend namespace into a target bridge.
- *
- * Queries high-confidence entries from the source and records them as
- * insights in the target bridge. Useful for cross-agent knowledge sharing
- * or promoting learnings from one scope to another.
- *
- * @param sourceBackend - Backend to query entries from
- * @param targetBridge - Bridge to record insights into
- * @param options - Transfer options (namespace, filters, limits)
- * @returns Transfer result with counts of transferred and skipped entries
- *
- * @example
- * ```typescript
- * const result = await transferKnowledge(sourceBackend, targetBridge, {
- *   sourceNamespace: 'learnings',
- *   minConfidence: 0.9,
- *   maxEntries: 10,
- *   categories: ['architecture', 'security'],
- * });
- * console.log(`Transferred ${result.transferred}, skipped ${result.skipped}`);
- * ```
- */
-export declare function transferKnowledge(sourceBackend: IMemoryBackend, targetBridge: AutoMemoryBridge, options: TransferOptions): Promise<TransferResult>;
-/**
- * List all agent scopes and their agents for the current project.
- *
- * Scans the three scope directories (project, local, user) and returns
- * the agent names found in each. Useful for discovery and diagnostics.
- *
- * @param workingDir - Working directory for git root detection (defaults to cwd)
- * @returns Array of scope/agents pairs
- *
- * @example
- * ```typescript
- * const scopes = listAgentScopes('/workspaces/my-project');
- * // [
- * //   { scope: 'project', agents: ['coder', 'tester'] },
- * //   { scope: 'local', agents: ['researcher'] },
- * //   { scope: 'user', agents: ['planner'] },
- * // ]
- * ```
- */
-export declare function listAgentScopes(workingDir?: string): Array<{
-    scope: AgentMemoryScope;
-    agents: string[];
-}>;
-//# sourceMappingURL=agent-memory-scope.d.ts.map

package/dist/agent-memory-scope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-memory-scope.d.ts","sourceRoot":"","sources":["../src/agent-memory-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,sBAAsB,EAEtB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAIjC,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,mDAAmD;AACnD,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;AAmDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAyBR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,iBAAiB,GACxB,gBAAgB,CAWlB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAwDzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkBtD"}

package/dist/agent-memory-scope.js

@@ -1,230 +0,0 @@
-/**
- * Agent-Scoped Memory - Support for Claude Code's 3-scope agent memory directories
- *
- * Claude Code organizes agent memory into three scopes:
- * - **project**: Shared across all collaborators (checked into git)
- * - **local**: Machine-specific, not shared (gitignored)
- * - **user**: Global per-user, spans all projects
- *
- * Each scope stores agent-specific memory in a named subdirectory,
- * enabling isolated yet transferable knowledge between agents.
- *
- * @module @monomind/memory/agent-memory-scope
- */
-import * as path from 'node:path';
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { AutoMemoryBridge } from './auto-memory-bridge.js';
-// ===== Internal Helpers =====
-/**
- * Find the git root directory by walking up from a starting directory.
- * Synchronous variant for path resolution (no async needed for stat checks).
- */
-// Cache git-root lookups — the result is stable for the process lifetime
-const gitRootCache = new Map();
-function findGitRootSync(dir) {
-    const resolved = path.resolve(dir);
-    if (gitRootCache.has(resolved))
-        return gitRootCache.get(resolved);
-    let current = resolved;
-    const root = path.parse(current).root;
-    while (current !== root) {
-        if (existsSync(path.join(current, '.git'))) {
-            gitRootCache.set(resolved, current);
-            return current;
-        }
-        current = path.dirname(current);
-    }
-    gitRootCache.set(resolved, null);
-    return null;
-}
-/**
- * List agent subdirectories inside a given directory.
- * Returns an empty array if the directory does not exist or is unreadable.
- */
-function listAgentsInDir(dir) {
-    if (!existsSync(dir))
-        return [];
-    try {
-        return readdirSync(dir).filter((name) => {
-            try {
-                return statSync(path.join(dir, name)).isDirectory();
-            }
-            catch {
-                return false;
-            }
-        });
-    }
-    catch {
-        return [];
-    }
-}
-// ===== Public Functions =====
-/**
- * Resolve the agent memory directory for a given agent name, scope, and working directory.
- *
- * Path resolution matches Claude Code binary behavior:
- * ```
- * project: <gitRoot>/.claude/agent-memory/<agentName>/
- * local:   <gitRoot>/.claude/agent-memory-local/<agentName>/
- * user:    ~/.claude/agent-memory/<agentName>/
- * ```
- *
- * Agent names are sanitized to prevent path traversal attacks.
- *
- * @param agentName - The agent identifier
- * @param scope - Memory scope: project, local, or user
- * @param workingDir - Working directory for git root detection (defaults to cwd)
- * @returns Absolute path to the agent's memory directory
- */
-export function resolveAgentMemoryDir(agentName, scope, workingDir) {
-    // Sanitize agent name to prevent path traversal
-    const safeName = agentName.replace(/[^a-zA-Z0-9_-]/g, '_');
-    if (scope === 'user') {
-        const home = process.env.HOME
-            || process.env.USERPROFILE
-            || (process.env.HOMEDRIVE && process.env.HOMEPATH ? process.env.HOMEDRIVE + process.env.HOMEPATH : '');
-        if (!home) {
-            throw new Error('Cannot determine home directory: HOME, USERPROFILE, and HOMEDRIVE+HOMEPATH are all undefined');
-        }
-        return path.join(home, '.claude', 'agent-memory', safeName);
-    }
-    // For project and local scopes, find git root
-    const effectiveDir = workingDir || process.cwd();
-    const gitRoot = findGitRootSync(effectiveDir);
-    const baseDir = gitRoot || effectiveDir;
-    if (scope === 'local') {
-        return path.join(baseDir, '.claude', 'agent-memory-local', safeName);
-    }
-    // scope === 'project'
-    return path.join(baseDir, '.claude', 'agent-memory', safeName);
-}
-/**
- * Create an AutoMemoryBridge configured for a specific agent scope.
- *
- * This is the primary factory for creating scoped bridges. It resolves
- * the correct memory directory based on agent name and scope, then
- * delegates to AutoMemoryBridge for the actual sync logic.
- *
- * @param backend - the LanceDB memory backend
- * @param config - Agent-scoped configuration
- * @returns A configured AutoMemoryBridge instance
- *
- * @example
- * ```typescript
- * const bridge = createAgentBridge(backend, {
- *   agentName: 'coder',
- *   scope: 'project',
- *   syncMode: 'on-write',
- * });
- * await bridge.recordInsight({ ... });
- * ```
- */
-export function createAgentBridge(backend, config) {
-    const memoryDir = resolveAgentMemoryDir(config.agentName, config.scope, config.workingDir);
-    return new AutoMemoryBridge(backend, {
-        ...config,
-        memoryDir,
-    });
-}
-/**
- * Transfer knowledge from a source backend namespace into a target bridge.
- *
- * Queries high-confidence entries from the source and records them as
- * insights in the target bridge. Useful for cross-agent knowledge sharing
- * or promoting learnings from one scope to another.
- *
- * @param sourceBackend - Backend to query entries from
- * @param targetBridge - Bridge to record insights into
- * @param options - Transfer options (namespace, filters, limits)
- * @returns Transfer result with counts of transferred and skipped entries
- *
- * @example
- * ```typescript
- * const result = await transferKnowledge(sourceBackend, targetBridge, {
- *   sourceNamespace: 'learnings',
- *   minConfidence: 0.9,
- *   maxEntries: 10,
- *   categories: ['architecture', 'security'],
- * });
- * console.log(`Transferred ${result.transferred}, skipped ${result.skipped}`);
- * ```
- */
-export async function transferKnowledge(sourceBackend, targetBridge, options) {
-    const { sourceNamespace, minConfidence = 0.8, maxEntries = 20, categories, } = options;
-    let transferred = 0;
-    let skipped = 0;
-    // Query high-confidence entries from source (fetch extra to allow for filtering)
-    const entries = await sourceBackend.query({
-        type: 'hybrid',
-        namespace: sourceNamespace,
-        tags: ['insight'],
-        limit: maxEntries * 2,
-    });
-    for (const entry of entries) {
-        if (transferred >= maxEntries)
-            break;
-        const confidence = entry.metadata?.confidence || 0;
-        if (confidence < minConfidence) {
-            skipped++;
-            continue;
-        }
-        // Filter by category if specified
-        const entryCategory = entry.metadata?.category;
-        if (categories &&
-            categories.length > 0 &&
-            entryCategory &&
-            !categories.includes(entryCategory)) {
-            skipped++;
-            continue;
-        }
-        // Record as insight in target bridge
-        const insight = {
-            category: entryCategory || 'project-patterns',
-            summary: entry.metadata?.summary || entry.content.split('\n')[0],
-            detail: entry.content,
-            source: `transfer:${sourceNamespace}`,
-            confidence,
-            memoryEntryId: entry.id,
-        };
-        await targetBridge.recordInsight(insight);
-        transferred++;
-    }
-    return { transferred, skipped };
-}
-/**
- * List all agent scopes and their agents for the current project.
- *
- * Scans the three scope directories (project, local, user) and returns
- * the agent names found in each. Useful for discovery and diagnostics.
- *
- * @param workingDir - Working directory for git root detection (defaults to cwd)
- * @returns Array of scope/agents pairs
- *
- * @example
- * ```typescript
- * const scopes = listAgentScopes('/workspaces/my-project');
- * // [
- * //   { scope: 'project', agents: ['coder', 'tester'] },
- * //   { scope: 'local', agents: ['researcher'] },
- * //   { scope: 'user', agents: ['planner'] },
- * // ]
- * ```
- */
-export function listAgentScopes(workingDir) {
-    const effectiveDir = workingDir || process.cwd();
-    const gitRoot = findGitRootSync(effectiveDir);
-    const baseDir = gitRoot || effectiveDir;
-    const home = process.env.HOME
-        || process.env.USERPROFILE
-        || (process.env.HOMEDRIVE && process.env.HOMEPATH ? process.env.HOMEDRIVE + process.env.HOMEPATH : '')
-        || '';
-    const projectDir = path.join(baseDir, '.claude', 'agent-memory');
-    const localDir = path.join(baseDir, '.claude', 'agent-memory-local');
-    const userDir = path.join(home, '.claude', 'agent-memory');
-    return [
-        { scope: 'project', agents: listAgentsInDir(projectDir) },
-        { scope: 'local', agents: listAgentsInDir(localDir) },
-        { scope: 'user', agents: listAgentsInDir(userDir) },
-    ];
-}
-//# sourceMappingURL=agent-memory-scope.js.map

package/dist/agent-memory-scope.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-memory-scope.js","sourceRoot":"","sources":["../src/agent-memory-scope.ts"],"names":[],"mappings":"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"}

package/dist/auto-memory-bridge.d.ts

@@ -1,230 +0,0 @@
-/**
- * AutoMemoryBridge - Bidirectional sync between Claude Code Auto Memory and LanceDB
- *
- * Per ADR-048: Bridges Claude Code's auto memory (markdown files at
- * ~/.claude/projects/<project>/memory/) with monomind's unified memory
- * (LanceDB + ANN).
- *
- * Auto memory files are human-readable markdown that Claude loads into its
- * system prompt. MEMORY.md (first 200 lines) is the entrypoint; topic files
- * store detailed notes and are read on demand.
- *
- * @module @monomind/memory/auto-memory-bridge
- */
-import { EventEmitter } from 'node:events';
-import { type IMemoryBackend } from './types.js';
-import { type LearningBridgeConfig } from './learning-bridge.js';
-import { type MemoryGraphConfig } from './memory-graph.js';
-/** Insight category for organization in MEMORY.md */
-export type InsightCategory = 'project-patterns' | 'debugging' | 'architecture' | 'performance' | 'security' | 'preferences' | 'swarm-results';
-/** Sync direction */
-export type SyncDirection = 'to-auto' | 'from-auto' | 'bidirectional';
-/** Sync mode determines when syncs occur */
-export type SyncMode = 'on-write' | 'on-session-end' | 'periodic';
-/** Prune strategy for keeping MEMORY.md under line limit */
-export type PruneStrategy = 'confidence-weighted' | 'fifo' | 'lru';
-/** Configuration for AutoMemoryBridge */
-export interface AutoMemoryBridgeConfig {
-    /** Auto memory directory path (auto-resolved if not provided) */
-    memoryDir?: string;
-    /** Working directory for git root detection */
-    workingDir?: string;
-    /** Max lines for MEMORY.md index (default: 180, Claude reads first 200) */
-    maxIndexLines?: number;
-    /** Topic file mapping: category → filename */
-    topicMapping?: Partial<Record<InsightCategory, string>>;
-    /** Sync mode (default: 'on-session-end') */
-    syncMode?: SyncMode;
-    /** Periodic sync interval in ms (if syncMode is 'periodic') */
-    syncIntervalMs?: number;
-    /** Minimum confidence for syncing to auto memory (default: 0.7) */
-    minConfidence?: number;
-    /** Maximum lines per topic file (default: 500) */
-    maxTopicFileLines?: number;
-    /** Prune strategy for MEMORY.md (default: 'confidence-weighted') */
-    pruneStrategy?: PruneStrategy;
-    /**
-     * Learning bridge config (ADR-049). When set, insights trigger neural learning.
-     * Tip: pass `embedder: bridgeGenerateEmbedding` from @monomind/cli's memory-bridge
-     * to give LearningBridge real semantic embeddings instead of hash fallback.
-     */
-    learning?: LearningBridgeConfig;
-    /** Knowledge graph config (ADR-049). When set, graph-aware curation is enabled. */
-    graph?: MemoryGraphConfig;
-}
-/** A memory insight to record */
-export interface MemoryInsight {
-    /** Category for organization */
-    category: InsightCategory;
-    /** One-line summary for MEMORY.md index */
-    summary: string;
-    /** Detailed content (goes in topic file if > 2 lines) */
-    detail?: string;
-    /** Source: which agent/hook discovered this */
-    source: string;
-    /** Confidence score (0-1), used for curation priority */
-    confidence: number;
-    /** memory entry ID for cross-reference */
-    memoryEntryId?: string;
-}
-/** Result of a sync operation */
-export interface SyncResult {
-    /** Number of entries synced */
-    synced: number;
-    /** Categories that were updated */
-    categories: string[];
-    /** Duration of sync in milliseconds */
-    durationMs: number;
-    /** Any errors encountered */
-    errors: string[];
-}
-/** Result of an import operation */
-export interface ImportResult {
-    /** Number of entries imported */
-    imported: number;
-    /** Number of entries skipped (already stored) */
-    skipped: number;
-    /** Files processed */
-    files: string[];
-    /** Duration in milliseconds */
-    durationMs: number;
-}
-/** Parsed markdown entry from a topic file */
-interface ParsedEntry {
-    heading: string;
-    content: string;
-    metadata: Record<string, string>;
-}
-/**
- * Bidirectional bridge between Claude Code auto memory and LanceDB.
- *
- * @example
- * ```typescript
- * const bridge = new AutoMemoryBridge(memoryBackend, {
- *   workingDir: '/workspaces/my-project',
- * });
- *
- * // Record an insight
- * await bridge.recordInsight({
- *   category: 'debugging',
- *   summary: 'HNSW index requires initialization before search',
- *   source: 'agent:tester',
- *   confidence: 0.95,
- * });
- *
- * // Sync to auto memory files
- * await bridge.syncToAutoMemory();
- *
- * // Import auto memory into LanceDB
- * await bridge.importFromAutoMemory();
- * ```
- */
-export declare class AutoMemoryBridge extends EventEmitter {
-    private config;
-    private backend;
-    private lastSyncTime;
-    private syncTimer;
-    private insights;
-    /** Track memory keys of insights already written to files during this session */
-    private syncedInsightKeys;
-    /** Monotonic counter to prevent key collisions within the same ms */
-    private insightCounter;
-    /** Optional learning bridge (ADR-049) */
-    private learningBridge?;
-    /** Optional knowledge graph (ADR-049) */
-    private memoryGraph?;
-    constructor(backend: IMemoryBackend, config?: AutoMemoryBridgeConfig);
-    /** Get the resolved auto memory directory path */
-    getMemoryDir(): string;
-    /** Get the path to MEMORY.md */
-    getIndexPath(): string;
-    /** Get the path to a topic file */
-    getTopicPath(category: InsightCategory): string;
-    /**
-     * Record a memory insight.
-     * Stores in the in-memory buffer and optionally writes immediately.
-     */
-    recordInsight(insight: MemoryInsight): Promise<void>;
-    /**
-     * Sync high-confidence memory entries to auto memory files.
-     * Called on session-end or periodically.
-     */
-    syncToAutoMemory(): Promise<SyncResult>;
-    /**
-     * Import auto memory files into memory backend.
-     * Called on session-start to hydrate memory backend with previous learnings.
-     * Uses bulk insert for efficiency.
-     */
-    importFromAutoMemory(): Promise<ImportResult>;
-    /**
-     * Curate MEMORY.md to stay under the line limit.
-     * Groups entries by category and prunes low-confidence items.
-     */
-    curateIndex(): Promise<void>;
-    /**
-     * Get auto memory status: directory info, file count, line counts.
-     */
-    getStatus(): {
-        memoryDir: string;
-        exists: boolean;
-        files: {
-            name: string;
-            lines: number;
-        }[];
-        totalLines: number;
-        indexLines: number;
-        lastSyncTime: number;
-        bufferedInsights: number;
-    };
-    /** Stop periodic sync and clean up */
-    destroy(): void;
-    private ensureMemoryDir;
-    private storeInsight;
-    private writeInsightToFiles;
-    private queryRecentInsights;
-    private classifyEntry;
-    private appendToTopicFile;
-    /** Fetch all existing content hashes from the auto-memory namespace in one query */
-    private fetchExistingContentHashes;
-    private startPeriodicSync;
-}
-/**
- * Resolve the auto memory directory for a given working directory.
- * Mirrors Claude Code's path derivation from git root.
- */
-export declare function resolveAutoMemoryDir(workingDir: string): string;
-/**
- * Find the git root directory by walking up from workingDir.
- */
-export declare function findGitRoot(dir: string): string | null;
-/**
- * Parse markdown content into structured entries.
- * Splits on ## headings and extracts content under each.
- */
-export declare function parseMarkdownEntries(content: string): ParsedEntry[];
-/**
- * Extract clean one-line summaries from a topic file.
- * Returns bullet-point items (lines starting with '- '), stripping
- * metadata annotations like _(source, date, conf: 0.95)_.
- */
-export declare function extractSummaries(content: string): string[];
-/**
- * Format an insight as a markdown line for topic files.
- */
-export declare function formatInsightLine(insight: MemoryInsight): string;
-/**
- * Hash content for deduplication.
- */
-export declare function hashContent(content: string): string;
-/**
- * Prune a topic file to stay under the line limit.
- * Removes oldest entries (those closest to the top after the header).
- */
-export declare function pruneTopicFile(content: string, maxLines: number): string;
-/**
- * Check if a summary already exists as a bullet line in topic file content.
- * Uses exact bullet prefix matching (not substring) to avoid false positives.
- */
-export declare function hasSummaryLine(content: string, summary: string): boolean;
-export default AutoMemoryBridge;
-//# sourceMappingURL=auto-memory-bridge.d.ts.map

package/dist/auto-memory-bridge.d.ts.map

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