@dmsdc-ai/aigentry-brain 0.0.1

package/dist/contract/BrainContract.d.ts

@@ -0,0 +1,93 @@
+import type { Entry } from '../core/EntrySchema.js';
+import type { ProfileManager } from '../core/ProfileManager.js';
+import type { SyncStatusStore, SyncStatusFile } from '../status/SyncStatusStore.js';
+import type { ContextResumeOptions, ContextResumeResult } from '../context/ContextRestoreService.js';
+import type { Clock } from '../shared/Clock.js';
+import type { AuditTrail } from '../audit/AuditTrail.js';
+import { type PolicyConfig } from '../policy/PolicyEngine.js';
+/**
+ * Minimal interface required by BrainContract for sync operations.
+ * The real SyncEngine must be wrapped to match this shape (see cli.ts adapter).
+ */
+export interface SyncEngine {
+    pull(): Promise<{
+        pulled: boolean;
+        status: string;
+    }>;
+    push(): Promise<{
+        pushed: boolean;
+        status: string;
+    }>;
+}
+export interface QueryFilter {
+    category?: string;
+    source?: string;
+    since?: string;
+    contentQuery?: string;
+    tags?: string[];
+}
+export interface BrainContractConfig {
+    profileManager: ProfileManager;
+    statusStore: SyncStatusStore;
+    clock?: Clock;
+    syncEngine?: SyncEngine | null;
+    auditTrail?: AuditTrail;
+    policyConfig?: PolicyConfig;
+}
+export declare const MAX_ACTIVE_MEDIA_PROVIDERS = 3;
+/**
+ * Thin Contract v0.1 — Public API for aigentry-brain.
+ *
+ * 8 operations: append, query, syncStatus, erase, contextResume, health, appendBatch, eraseBatch
+ */
+export declare class BrainContract {
+    private profileManager;
+    private statusStore;
+    private restoreService;
+    private syncEngine;
+    private auditTrail;
+    private policyEngine;
+    constructor(config: BrainContractConfig);
+    /** Append a new entry (or update existing by id). */
+    append(partial: Partial<Entry> & {
+        category: string;
+        content: string;
+        source: string;
+    }): Promise<Entry>;
+    /** Query entries with optional filters. Returns active (non-deleted) entries. */
+    query(filter?: QueryFilter): Promise<Entry[]>;
+    /** Get current sync status. */
+    syncStatus(): Promise<SyncStatusFile>;
+    /** Soft-delete an entry by id. Returns true if deleted, false if not found. */
+    erase(id: string): Promise<boolean>;
+    /** Restore context from synced profile for AI consumption. */
+    contextResume(options: ContextResumeOptions): Promise<ContextResumeResult>;
+    /** Get system health report. */
+    health(): Promise<{
+        profileAccessible: boolean;
+        entryCount: number;
+        syncStatus: string;
+        uptimeMs: number;
+    }>;
+    /** Append multiple entries in a single operation (single read + N mutations + single write). */
+    appendBatch(items: Array<Partial<Entry> & {
+        category: string;
+        content: string;
+        source: string;
+    }>): Promise<Entry[]>;
+    /** Pull changes from remote repository. */
+    syncPull(): Promise<{
+        pulled: boolean;
+        status: string;
+    }>;
+    /** Push local changes to remote repository. */
+    syncPush(): Promise<{
+        pushed: boolean;
+        status: string;
+    }>;
+    /** Soft-delete multiple entries by id. Returns count of successfully deleted. */
+    eraseBatch(ids: string[]): Promise<{
+        deleted: number;
+        total: number;
+    }>;
+}

package/dist/contract/BrainContract.js

@@ -0,0 +1,245 @@
+import { ContextRestoreService } from '../context/ContextRestoreService.js';
+import { PolicyEngine } from '../policy/PolicyEngine.js';
+const MESSENGER_PROVIDERS = new Set([
+    'telegram',
+    'whatsapp',
+    'messenger',
+    'discord',
+    'slack',
+    'line',
+    'kakao',
+]);
+const MAX_MEDIA_POINTERS_PER_ENTRY = 20;
+export const MAX_ACTIVE_MEDIA_PROVIDERS = 3;
+function normalizeProvider(provider) {
+    return provider.trim().toLowerCase();
+}
+function inferMediaChannel(provider) {
+    return MESSENGER_PROVIDERS.has(normalizeProvider(provider)) ? 'messenger' : 'platform';
+}
+function normalizeMediaPointers(pointers) {
+    if (pointers === undefined)
+        return undefined;
+    if (pointers.length === 0)
+        return [];
+    if (pointers.length > MAX_MEDIA_POINTERS_PER_ENTRY) {
+        throw new Error(`Too many media pointers: max ${MAX_MEDIA_POINTERS_PER_ENTRY} per entry`);
+    }
+    const normalized = pointers.map((pointer, idx) => {
+        const provider = normalizeProvider(pointer.provider ?? '');
+        const url = (pointer.url ?? '').trim();
+        if (!provider)
+            throw new Error(`media_pointers[${idx}] provider is required`);
+        if (!url)
+            throw new Error(`media_pointers[${idx}] url is required`);
+        const channel = pointer.channel ?? inferMediaChannel(provider);
+        const purpose = pointer.purpose ?? (channel === 'messenger' ? 'share' : 'storage');
+        if (channel === 'messenger' && purpose === 'storage') {
+            throw new Error('Messenger channels are share-only and cannot be used as canonical storage');
+        }
+        if (pointer.duration_sec !== undefined && pointer.duration_sec < 0) {
+            throw new Error(`media_pointers[${idx}] duration_sec must be >= 0`);
+        }
+        return {
+            ...pointer,
+            provider,
+            url,
+            channel,
+            purpose,
+            ...(pointer.title !== undefined ? { title: pointer.title.trim() } : {}),
+        };
+    });
+    const activeStorageProviders = new Set(normalized
+        .filter(p => p.channel === 'platform' && p.purpose === 'storage')
+        .map(p => p.provider));
+    if (activeStorageProviders.size > MAX_ACTIVE_MEDIA_PROVIDERS) {
+        throw new Error(`Too many active media providers: max ${MAX_ACTIVE_MEDIA_PROVIDERS}`);
+    }
+    return normalized;
+}
+function applyMediaPolicy(partial) {
+    if (partial.media_pointers === undefined)
+        return partial;
+    return {
+        ...partial,
+        media_pointers: normalizeMediaPointers(partial.media_pointers),
+    };
+}
+/**
+ * Thin Contract v0.1 — Public API for aigentry-brain.
+ *
+ * 8 operations: append, query, syncStatus, erase, contextResume, health, appendBatch, eraseBatch
+ */
+export class BrainContract {
+    profileManager;
+    statusStore;
+    restoreService;
+    syncEngine;
+    auditTrail;
+    policyEngine;
+    constructor(config) {
+        this.profileManager = config.profileManager;
+        this.statusStore = config.statusStore;
+        this.syncEngine = config.syncEngine ?? null;
+        this.auditTrail = config.auditTrail ?? null;
+        this.policyEngine = config.policyConfig
+            ? new PolicyEngine(config.policyConfig)
+            : null;
+        this.restoreService = new ContextRestoreService(config.profileManager, config.clock);
+    }
+    /** Append a new entry (or update existing by id). */
+    async append(partial) {
+        let processed = applyMediaPolicy(partial);
+        // CMP: validate policy on write
+        if (this.policyEngine) {
+            this.policyEngine.validateWrite(processed.policy);
+            if (processed.policy || processed.policy === undefined) {
+                processed = { ...processed, policy: this.policyEngine.applyDefaults(processed.policy) };
+            }
+        }
+        const entry = await this.profileManager.upsert(processed);
+        if (this.auditTrail) {
+            this.auditTrail.log({
+                ts: new Date().toISOString(),
+                action: 'append',
+                entry_id: entry.id,
+                device_id: this.profileManager.getDeviceId(),
+            }).catch(() => { });
+        }
+        return entry;
+    }
+    /** Query entries with optional filters. Returns active (non-deleted) entries. */
+    async query(filter) {
+        let entries = await this.profileManager.getAll();
+        // CMP: filter by policy (retention_ttl expiration + scope/projectId)
+        if (this.policyEngine) {
+            entries = this.policyEngine.filterRead(entries);
+        }
+        if (filter?.category) {
+            entries = entries.filter(e => e.category === filter.category);
+        }
+        if (filter?.source) {
+            entries = entries.filter(e => e.source === filter.source);
+        }
+        if (filter?.since) {
+            const sinceMs = new Date(filter.since).getTime();
+            if (!Number.isNaN(sinceMs)) {
+                entries = entries.filter(e => new Date(e.updated).getTime() >= sinceMs);
+            }
+        }
+        if (filter?.contentQuery) {
+            const q = filter.contentQuery.toLowerCase();
+            entries = entries.filter(e => e.content.toLowerCase().includes(q));
+        }
+        if (filter?.tags && filter.tags.length > 0) {
+            entries = entries.filter(e => {
+                const entryTags = e.tags ?? [];
+                return filter.tags.every(t => entryTags.includes(t));
+            });
+        }
+        return entries;
+    }
+    /** Get current sync status. */
+    async syncStatus() {
+        return this.statusStore.get();
+    }
+    /** Soft-delete an entry by id. Returns true if deleted, false if not found. */
+    async erase(id) {
+        const deleted = await this.profileManager.softDelete(id);
+        if (deleted && this.auditTrail) {
+            this.auditTrail.log({
+                ts: new Date().toISOString(),
+                action: 'erase',
+                entry_id: id,
+                device_id: this.profileManager.getDeviceId(),
+            }).catch(() => { });
+        }
+        return deleted;
+    }
+    /** Restore context from synced profile for AI consumption. */
+    async contextResume(options) {
+        return this.restoreService.restore(options);
+    }
+    /** Get system health report. */
+    async health() {
+        let profileAccessible = true;
+        let entryCount = 0;
+        try {
+            const entries = await this.profileManager.getAll();
+            entryCount = entries.length;
+        }
+        catch {
+            profileAccessible = false;
+        }
+        const status = await this.statusStore.get();
+        return {
+            profileAccessible,
+            entryCount,
+            syncStatus: status.status,
+            uptimeMs: Math.floor(process.uptime() * 1000),
+        };
+    }
+    /** Append multiple entries in a single operation (single read + N mutations + single write). */
+    async appendBatch(items) {
+        const processed = items.map(item => {
+            const normalizedItem = applyMediaPolicy(item);
+            if (this.policyEngine) {
+                this.policyEngine.validateWrite(normalizedItem.policy);
+                return { ...normalizedItem, policy: this.policyEngine.applyDefaults(normalizedItem.policy) };
+            }
+            return normalizedItem;
+        });
+        const results = await this.profileManager.upsertBatch(processed);
+        if (this.auditTrail) {
+            for (const entry of results) {
+                this.auditTrail.log({
+                    ts: new Date().toISOString(),
+                    action: 'append',
+                    entry_id: entry.id,
+                    device_id: this.profileManager.getDeviceId(),
+                }).catch(() => { });
+            }
+        }
+        return results;
+    }
+    /** Pull changes from remote repository. */
+    async syncPull() {
+        if (!this.syncEngine) {
+            return { pulled: false, status: 'no_sync_engine' };
+        }
+        const result = await this.syncEngine.pull();
+        if (result.pulled && this.auditTrail) {
+            this.auditTrail.log({
+                ts: new Date().toISOString(),
+                action: 'sync.pull',
+                device_id: this.profileManager.getDeviceId(),
+            }).catch(() => { });
+        }
+        return result;
+    }
+    /** Push local changes to remote repository. */
+    async syncPush() {
+        if (!this.syncEngine) {
+            return { pushed: false, status: 'no_sync_engine' };
+        }
+        const result = await this.syncEngine.push();
+        if (result.pushed && this.auditTrail) {
+            this.auditTrail.log({
+                ts: new Date().toISOString(),
+                action: 'sync.push',
+                device_id: this.profileManager.getDeviceId(),
+            }).catch(() => { });
+        }
+        return result;
+    }
+    /** Soft-delete multiple entries by id. Returns count of successfully deleted. */
+    async eraseBatch(ids) {
+        let deleted = 0;
+        for (const id of ids) {
+            if (await this.erase(id))
+                deleted++;
+        }
+        return { deleted, total: ids.length };
+    }
+}
+//# sourceMappingURL=BrainContract.js.map

package/dist/contract/BrainContract.js.map

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

package/dist/core/ContentDedup.d.ts

@@ -0,0 +1,43 @@
+import type { Entry } from './EntrySchema.js';
+import type { DecayConfig } from './MemoryDecay.js';
+export interface DedupConfig {
+    similarityThreshold: number;
+    minTokens: number;
+}
+export declare const DEFAULT_DEDUP_CONFIG: DedupConfig;
+export interface DedupResult {
+    entries: Entry[];
+    merged: number;
+    pairs: Array<{
+        kept: string;
+        removed: string;
+        similarity: number;
+    }>;
+}
+/**
+ * Tokenize text: lowercase, split on whitespace/punctuation, filter short tokens.
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Build TF (term frequency) vector for a document.
+ * Values are normalized by document length.
+ */
+export declare function buildTF(tokens: string[]): Map<string, number>;
+/**
+ * Build IDF (inverse document frequency) from multiple TF vectors.
+ */
+export declare function buildIDF(documents: Map<string, number>[]): Map<string, number>;
+/**
+ * Compute TF-IDF vector from a TF vector and an IDF map.
+ */
+export declare function tfidfVector(tf: Map<string, number>, idf: Map<string, number>): Map<string, number>;
+/**
+ * Cosine similarity between two sparse vectors.
+ */
+export declare function cosineSimilarity(a: Map<string, number>, b: Map<string, number>): number;
+/**
+ * Deduplicate entries within each category using TF-IDF cosine similarity.
+ * When duplicates found: keep the one with higher effectiveConfidence,
+ * soft-delete the other.
+ */
+export declare function deduplicateEntries(entries: Entry[], now: Date, decayConfig: DecayConfig, dedupConfig?: DedupConfig): DedupResult;

package/dist/core/ContentDedup.js

@@ -0,0 +1,145 @@
+import { effectiveConfidence } from './MemoryDecay.js';
+export const DEFAULT_DEDUP_CONFIG = {
+    similarityThreshold: 0.85,
+    minTokens: 5,
+};
+// ---------------------------------------------------------------------------
+// Pure functions
+// ---------------------------------------------------------------------------
+/**
+ * Tokenize text: lowercase, split on whitespace/punctuation, filter short tokens.
+ */
+export function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[\s\p{P}]+/u)
+        .filter(t => t.length > 1);
+}
+/**
+ * Build TF (term frequency) vector for a document.
+ * Values are normalized by document length.
+ */
+export function buildTF(tokens) {
+    const tf = new Map();
+    for (const token of tokens) {
+        tf.set(token, (tf.get(token) || 0) + 1);
+    }
+    const len = tokens.length;
+    for (const [key, val] of tf) {
+        tf.set(key, val / len);
+    }
+    return tf;
+}
+/**
+ * Build IDF (inverse document frequency) from multiple TF vectors.
+ */
+export function buildIDF(documents) {
+    const docCount = documents.length;
+    const idf = new Map();
+    const docFreq = new Map();
+    for (const doc of documents) {
+        for (const term of doc.keys()) {
+            docFreq.set(term, (docFreq.get(term) || 0) + 1);
+        }
+    }
+    for (const [term, freq] of docFreq) {
+        idf.set(term, Math.log(1 + docCount / freq));
+    }
+    return idf;
+}
+/**
+ * Compute TF-IDF vector from a TF vector and an IDF map.
+ */
+export function tfidfVector(tf, idf) {
+    const vec = new Map();
+    for (const [term, tfVal] of tf) {
+        const idfVal = idf.get(term) || 0;
+        vec.set(term, tfVal * idfVal);
+    }
+    return vec;
+}
+/**
+ * Cosine similarity between two sparse vectors.
+ */
+export function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (const [key, val] of a) {
+        normA += val * val;
+        const bVal = b.get(key);
+        if (bVal !== undefined) {
+            dot += val * bVal;
+        }
+    }
+    for (const [, val] of b) {
+        normB += val * val;
+    }
+    if (normA === 0 || normB === 0)
+        return 0;
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+/**
+ * Deduplicate entries within each category using TF-IDF cosine similarity.
+ * When duplicates found: keep the one with higher effectiveConfidence,
+ * soft-delete the other.
+ */
+export function deduplicateEntries(entries, now, decayConfig, dedupConfig = DEFAULT_DEDUP_CONFIG) {
+    const pairs = [];
+    const toDelete = new Set();
+    // Group active (non-deleted, non-pinned) entries by category
+    const byCategory = new Map();
+    for (const entry of entries) {
+        if (entry.deleted || entry.pinned)
+            continue;
+        const cat = entry.category;
+        if (!byCategory.has(cat))
+            byCategory.set(cat, []);
+        byCategory.get(cat).push(entry);
+    }
+    // Process each category independently
+    for (const [, catEntries] of byCategory) {
+        if (catEntries.length < 2)
+            continue;
+        // Tokenize all entries, filter those below minTokens
+        const tokenized = catEntries
+            .map(e => ({ entry: e, tokens: tokenize(e.content) }))
+            .filter(t => t.tokens.length >= dedupConfig.minTokens);
+        if (tokenized.length < 2)
+            continue;
+        // Build TF vectors
+        const tfVectors = tokenized.map(t => buildTF(t.tokens));
+        // Build IDF across all documents in this category
+        const idf = buildIDF(tfVectors);
+        // Build TF-IDF vectors
+        const tfidfVectors = tfVectors.map(tf => tfidfVector(tf, idf));
+        // Compare all pairs within this category
+        for (let i = 0; i < tokenized.length; i++) {
+            if (toDelete.has(tokenized[i].entry.id))
+                continue;
+            for (let j = i + 1; j < tokenized.length; j++) {
+                if (toDelete.has(tokenized[j].entry.id))
+                    continue;
+                const sim = cosineSimilarity(tfidfVectors[i], tfidfVectors[j]);
+                if (sim >= dedupConfig.similarityThreshold) {
+                    const scoreI = effectiveConfidence(tokenized[i].entry, now, decayConfig);
+                    const scoreJ = effectiveConfidence(tokenized[j].entry, now, decayConfig);
+                    const [kept, removed] = scoreI >= scoreJ
+                        ? [tokenized[i].entry, tokenized[j].entry]
+                        : [tokenized[j].entry, tokenized[i].entry];
+                    toDelete.add(removed.id);
+                    pairs.push({ kept: kept.id, removed: removed.id, similarity: sim });
+                }
+            }
+        }
+    }
+    // Apply soft-deletes
+    const result = entries.map(entry => {
+        if (toDelete.has(entry.id)) {
+            return { ...entry, deleted: true, deleted_at: now.toISOString() };
+        }
+        return entry;
+    });
+    return { entries: result, merged: toDelete.size, pairs };
+}
+//# sourceMappingURL=ContentDedup.js.map

package/dist/core/ContentDedup.js.map

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

package/dist/core/EntityGraph.d.ts

@@ -0,0 +1,66 @@
+import type { Entry } from './EntrySchema.js';
+export interface EntityNode {
+    name: string;
+    type: EntityType;
+    entryIds: string[];
+}
+export type EntityType = 'person' | 'project' | 'technology' | 'path' | 'url' | 'concept';
+export interface EntityEdge {
+    source: string;
+    target: string;
+    entryId: string;
+}
+export interface EntityGraph {
+    nodes: Record<string, EntityNode>;
+    edges: EntityEdge[];
+    metadata: {
+        builtAt: string;
+        entryCount: number;
+        nodeCount: number;
+        edgeCount: number;
+    };
+}
+export interface EntityScore {
+    entryId: string;
+    hubScore: number;
+    connectedness: number;
+}
+/**
+ * Extract entities from text using pattern matching.
+ * Patterns:
+ * - URLs → url
+ * - File paths (/, .ts, .js, etc.) → path
+ * - @mentions → person
+ * - Kebab-case multi-part names → project
+ * - Known tech keywords → technology
+ * - Capitalized multi-word phrases → concept
+ *
+ * Deterministic: same input always produces same output.
+ */
+export declare function extractEntities(text: string): Array<{
+    name: string;
+    type: EntityType;
+}>;
+/**
+ * Build an entity graph from entries.
+ * Only considers active (non-deleted) entries.
+ */
+export declare function buildEntityGraph(entries: Entry[]): EntityGraph;
+/**
+ * Score entries by their entity connectedness.
+ * Hub entries (connected to many other entries via shared entities) get higher scores.
+ */
+export declare function scoreEntries(entries: Entry[], graph: EntityGraph): EntityScore[];
+/**
+ * Get confidence boost based on entity connectedness.
+ * Entries connected to 3+ others get a boost.
+ */
+export declare function connectednessBoost(score: EntityScore): number;
+/**
+ * Serialize graph to JSON (for graph.json file, git-diffable).
+ */
+export declare function serializeGraph(graph: EntityGraph): string;
+/**
+ * Deserialize graph from JSON string.
+ */
+export declare function deserializeGraph(json: string): EntityGraph;