@dmsdc-ai/aigentry-brain 0.0.1

package/dist/core/EntityGraph.js

@@ -0,0 +1,196 @@
+// ---------------------------------------------------------------------------
+// Entity extraction (deterministic, no LLM)
+// ---------------------------------------------------------------------------
+/** Known technology keywords for deterministic matching. */
+const TECH_KEYWORDS = new Set([
+    'react', 'vue', 'angular', 'svelte', 'next', 'nuxt',
+    'node', 'deno', 'bun', 'typescript', 'javascript', 'python', 'rust', 'go',
+    'docker', 'kubernetes', 'postgres', 'redis', 'mongodb', 'sqlite',
+    'graphql', 'rest', 'grpc', 'websocket',
+    'git', 'github', 'gitlab', 'npm', 'yarn', 'pnpm',
+    'vitest', 'jest', 'mocha', 'pytest',
+    'aws', 'gcp', 'azure', 'vercel', 'netlify',
+    'linux', 'macos', 'windows',
+    'age', 'sops', 'encryption', 'oauth', 'jwt',
+]);
+/** Common English words excluded from capitalized-phrase detection. */
+const COMMON_WORDS = new Set([
+    'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'can', 'shall', 'for', 'and', 'nor', 'but',
+    'or', 'yet', 'so', 'in', 'on', 'at', 'to', 'of', 'by', 'with', 'from',
+    'up', 'about', 'into', 'over', 'after', 'this', 'that', 'these', 'those',
+    'it', 'its', 'not', 'no', 'all', 'each', 'every', 'both', 'few', 'more',
+    'most', 'other', 'some', 'such', 'only', 'own', 'same', 'than', 'too',
+    'very',
+]);
+/**
+ * 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 function extractEntities(text) {
+    const entities = [];
+    const seen = new Set();
+    function add(name, type) {
+        const normalized = name.toLowerCase().trim();
+        if (normalized.length < 2 || seen.has(normalized))
+            return;
+        seen.add(normalized);
+        entities.push({ name: normalized, type });
+    }
+    // URLs
+    const urlRegex = /https?:\/\/[^\s<>"']+/g;
+    for (const m of text.matchAll(urlRegex)) {
+        add(m[0], 'url');
+    }
+    // File paths (Unix-style or with extensions)
+    const pathRegex = /(?:\/[\w.-]+){2,}|[\w.-]+\.(?:ts|js|tsx|jsx|py|go|rs|json|yaml|yml|md|toml|sh)/g;
+    for (const m of text.matchAll(pathRegex)) {
+        add(m[0], 'path');
+    }
+    // @mentions
+    const mentionRegex = /@([\w-]+)/g;
+    for (const m of text.matchAll(mentionRegex)) {
+        add(m[1], 'person');
+    }
+    // Project-like names (kebab-case: word-word-word)
+    const projectRegex = /\b([a-z][a-z0-9]+-[a-z][a-z0-9]+(?:-[a-z][a-z0-9]+)*)\b/g;
+    for (const m of text.matchAll(projectRegex)) {
+        if (m[1].length >= 5)
+            add(m[1], 'project');
+    }
+    // Known technology keywords
+    const words = text.toLowerCase().split(/[\s\p{P}]+/u);
+    for (const word of words) {
+        if (TECH_KEYWORDS.has(word)) {
+            add(word, 'technology');
+        }
+    }
+    // Capitalized multi-word phrases (likely names / concepts) — skip common words
+    const capitalRegex = /\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)+)\b/g;
+    for (const m of text.matchAll(capitalRegex)) {
+        const phraseWords = m[1].split(/\s+/);
+        if (phraseWords.every(w => !COMMON_WORDS.has(w.toLowerCase()))) {
+            add(m[1], 'concept');
+        }
+    }
+    return entities;
+}
+// ---------------------------------------------------------------------------
+// Graph building
+// ---------------------------------------------------------------------------
+/**
+ * Build an entity graph from entries.
+ * Only considers active (non-deleted) entries.
+ */
+export function buildEntityGraph(entries) {
+    const nodes = {};
+    const edges = [];
+    const activeEntries = entries.filter(e => !e.deleted);
+    // Extract entities from each entry
+    for (const entry of activeEntries) {
+        const extracted = extractEntities(entry.content);
+        const entryEntityNames = [];
+        for (const { name, type } of extracted) {
+            if (!nodes[name]) {
+                nodes[name] = { name, type, entryIds: [] };
+            }
+            if (!nodes[name].entryIds.includes(entry.id)) {
+                nodes[name].entryIds.push(entry.id);
+            }
+            entryEntityNames.push(name);
+        }
+        // Create edges for co-occurring entities within same entry
+        for (let i = 0; i < entryEntityNames.length; i++) {
+            for (let j = i + 1; j < entryEntityNames.length; j++) {
+                edges.push({
+                    source: entryEntityNames[i],
+                    target: entryEntityNames[j],
+                    entryId: entry.id,
+                });
+            }
+        }
+    }
+    return {
+        nodes,
+        edges,
+        metadata: {
+            builtAt: new Date().toISOString(),
+            entryCount: activeEntries.length,
+            nodeCount: Object.keys(nodes).length,
+            edgeCount: edges.length,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Scoring
+// ---------------------------------------------------------------------------
+/**
+ * Score entries by their entity connectedness.
+ * Hub entries (connected to many other entries via shared entities) get higher scores.
+ */
+export function scoreEntries(entries, graph) {
+    const activeEntries = entries.filter(e => !e.deleted);
+    return activeEntries.map(entry => {
+        // Find all entities this entry references
+        const myEntities = [];
+        for (const [name, node] of Object.entries(graph.nodes)) {
+            if (node.entryIds.includes(entry.id)) {
+                myEntities.push(name);
+            }
+        }
+        // Count unique other entries that share entities
+        const connectedEntries = new Set();
+        for (const entityName of myEntities) {
+            const node = graph.nodes[entityName];
+            if (node) {
+                for (const eid of node.entryIds) {
+                    if (eid !== entry.id)
+                        connectedEntries.add(eid);
+                }
+            }
+        }
+        return {
+            entryId: entry.id,
+            hubScore: myEntities.length,
+            connectedness: connectedEntries.size,
+        };
+    });
+}
+/**
+ * Get confidence boost based on entity connectedness.
+ * Entries connected to 3+ others get a boost.
+ */
+export function connectednessBoost(score) {
+    if (score.connectedness >= 5)
+        return 0.2;
+    if (score.connectedness >= 3)
+        return 0.1;
+    if (score.connectedness >= 1)
+        return 0.05;
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Serialization (git-diffable JSON)
+// ---------------------------------------------------------------------------
+/**
+ * Serialize graph to JSON (for graph.json file, git-diffable).
+ */
+export function serializeGraph(graph) {
+    return JSON.stringify(graph, null, 2);
+}
+/**
+ * Deserialize graph from JSON string.
+ */
+export function deserializeGraph(json) {
+    return JSON.parse(json);
+}
+//# sourceMappingURL=EntityGraph.js.map

package/dist/core/EntityGraph.js.map

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

package/dist/core/EntrySchema.d.ts

@@ -0,0 +1,46 @@
+import type { PolicyEnvelope } from '../policy/PolicyEnvelope.js';
+export interface ConflictLogEntry {
+    at: string;
+    loser_device: string;
+    loser_updated: string;
+    resolution: 'lww' | 'append' | 'tie_deleted' | 'tie_id';
+}
+export type MediaKind = 'video' | 'audio' | 'image';
+export type MediaChannel = 'platform' | 'messenger';
+export type MediaPurpose = 'storage' | 'share';
+export type MediaStatus = 'ready' | 'pending' | 'broken';
+export interface MediaPointer {
+    kind: MediaKind;
+    provider: string;
+    url: string;
+    title?: string;
+    duration_sec?: number;
+    checksum?: string;
+    channel?: MediaChannel;
+    purpose?: MediaPurpose;
+    status?: MediaStatus;
+}
+export interface Entry {
+    id: string;
+    created: string;
+    updated: string;
+    category: string;
+    content: string;
+    source: string;
+    confidence: number;
+    tags?: string[];
+    device_id?: string;
+    pinned?: boolean;
+    deleted?: boolean;
+    deleted_at?: string;
+    conflict_log?: ConflictLogEntry[];
+    policy?: PolicyEnvelope;
+    media_pointers?: MediaPointer[];
+}
+export interface MemoryProfile {
+    version: number;
+    device_id: string;
+    last_sync: string;
+    entries: Entry[];
+}
+export declare function createEntryId(): string;

package/dist/core/EntrySchema.js

@@ -0,0 +1,4 @@
+export function createEntryId() {
+    return `mem_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+//# sourceMappingURL=EntrySchema.js.map

package/dist/core/EntrySchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntrySchema.js","sourceRoot":"","sources":["../../src/core/EntrySchema.ts"],"names":[],"mappings":"AAmDA,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACpF,CAAC"}

package/dist/core/GraphStore.d.ts

@@ -0,0 +1,16 @@
+import type { EntityGraph } from './EntityGraph.js';
+/**
+ * Derive graph.json path from profile path.
+ * e.g. "memory-profile.enc.json" → "memory-profile.graph.json"
+ *      "memory-profile.yaml" → "memory-profile.graph.json"
+ */
+export declare function deriveGraphPath(profilePath: string): string;
+/**
+ * Read an EntityGraph from a graph.json file.
+ * Returns null if file doesn't exist.
+ */
+export declare function readGraphFile(graphPath: string): Promise<EntityGraph | null>;
+/**
+ * Write an EntityGraph to a graph.json file using atomic write.
+ */
+export declare function writeGraphFile(graphPath: string, graph: EntityGraph): Promise<void>;

package/dist/core/GraphStore.js

@@ -0,0 +1,29 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { atomicWrite } from '../shared/AtomicWrite.js';
+import { serializeGraph, deserializeGraph } from './EntityGraph.js';
+/**
+ * Derive graph.json path from profile path.
+ * e.g. "memory-profile.enc.json" → "memory-profile.graph.json"
+ *      "memory-profile.yaml" → "memory-profile.graph.json"
+ */
+export function deriveGraphPath(profilePath) {
+    return profilePath.replace(/\.enc\.json$|\.yaml$/, '.graph.json');
+}
+/**
+ * Read an EntityGraph from a graph.json file.
+ * Returns null if file doesn't exist.
+ */
+export async function readGraphFile(graphPath) {
+    if (!existsSync(graphPath))
+        return null;
+    const content = await readFile(graphPath, 'utf-8');
+    return deserializeGraph(content);
+}
+/**
+ * Write an EntityGraph to a graph.json file using atomic write.
+ */
+export async function writeGraphFile(graphPath, graph) {
+    await atomicWrite(graphPath, serializeGraph(graph));
+}
+//# sourceMappingURL=GraphStore.js.map

package/dist/core/GraphStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphStore.js","sourceRoot":"","sources":["../../src/core/GraphStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,WAAW,CAAC,OAAO,CAAC,sBAAsB,EAAE,aAAa,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,KAAkB;IACxE,MAAM,WAAW,CAAC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/MemoryDecay.d.ts

@@ -0,0 +1,49 @@
+import type { Entry } from './EntrySchema.js';
+export interface DecayConfig {
+    halfLife: {
+        user: number | null;
+        observation: number;
+        inference: number;
+        session: number;
+        [key: string]: number | null;
+    };
+    threshold: number;
+    minAge: number;
+}
+export interface MemoryConfig {
+    maxEntries: number;
+    decay: DecayConfig;
+}
+export declare const DEFAULT_CONFIG: MemoryConfig;
+export interface CompactResult {
+    tombstonesRemoved: number;
+    softDeleted: number;
+    survived: number;
+    byCategory: Record<string, number>;
+}
+/**
+ * Compute the effective (time-decayed) confidence for an entry.
+ * Pure function -- no side effects.
+ */
+export declare function effectiveConfidence(entry: Entry, now: Date, config: DecayConfig): number;
+/**
+ * Apply decay-based soft-delete to entries whose effective confidence
+ * has dropped below the configured threshold (and are older than minAge).
+ */
+export declare function applyDecay(entries: Entry[], now: Date, config: MemoryConfig): {
+    entries: Entry[];
+    softDeleted: number;
+};
+/**
+ * Enforce maxEntries limit by soft-deleting the lowest effectiveConfidence
+ * entries. Pinned entries are never removed.
+ */
+export declare function enforceMaxEntries(entries: Entry[], now: Date, config: MemoryConfig): {
+    entries: Entry[];
+    softDeleted: number;
+};
+/**
+ * Parse a MemoryConfig from raw JSON data (e.g. from enc.json),
+ * merging missing fields with DEFAULT_CONFIG.
+ */
+export declare function parseMemoryConfig(raw: unknown): MemoryConfig;

package/dist/core/MemoryDecay.js

@@ -0,0 +1,113 @@
+export const DEFAULT_CONFIG = {
+    maxEntries: 2000,
+    decay: {
+        halfLife: {
+            user: null,
+            observation: 90,
+            inference: 30,
+            session: 10,
+        },
+        threshold: 0.1,
+        minAge: 1,
+    },
+};
+// ---------------------------------------------------------------------------
+// Pure functions
+// ---------------------------------------------------------------------------
+/**
+ * Compute the effective (time-decayed) confidence for an entry.
+ * Pure function -- no side effects.
+ */
+export function effectiveConfidence(entry, now, config) {
+    if (entry.pinned)
+        return entry.confidence;
+    const days = (now.getTime() - new Date(entry.updated).getTime()) / 86_400_000;
+    const rawHl = config.halfLife[entry.source];
+    if (rawHl === null)
+        return entry.confidence;
+    const hl = rawHl ?? 30;
+    return entry.confidence * Math.pow(0.5, days / hl);
+}
+/**
+ * Apply decay-based soft-delete to entries whose effective confidence
+ * has dropped below the configured threshold (and are older than minAge).
+ */
+export function applyDecay(entries, now, config) {
+    let softDeleted = 0;
+    const result = entries.map(entry => {
+        // Skip already deleted entries
+        if (entry.deleted)
+            return entry;
+        // Skip pinned entries
+        if (entry.pinned)
+            return entry;
+        // Skip entries whose source has null halfLife (no decay, e.g. user source)
+        if (config.decay.halfLife[entry.source] === null)
+            return entry;
+        const ec = effectiveConfidence(entry, now, config.decay);
+        const ageDays = (now.getTime() - new Date(entry.created).getTime()) / 86_400_000;
+        if (ec < config.decay.threshold && ageDays > config.decay.minAge) {
+            softDeleted++;
+            return { ...entry, deleted: true, deleted_at: now.toISOString() };
+        }
+        return entry;
+    });
+    return { entries: result, softDeleted };
+}
+/**
+ * Enforce maxEntries limit by soft-deleting the lowest effectiveConfidence
+ * entries. Pinned entries are never removed.
+ */
+export function enforceMaxEntries(entries, now, config) {
+    const active = entries.filter(e => !e.deleted);
+    if (active.length <= config.maxEntries) {
+        return { entries, softDeleted: 0 };
+    }
+    // Sort unpinned active entries by effectiveConfidence (ascending)
+    const scored = active
+        .filter(e => !e.pinned)
+        .map(e => ({ entry: e, score: effectiveConfidence(e, now, config.decay) }))
+        .sort((a, b) => a.score - b.score);
+    const toDelete = active.length - config.maxEntries;
+    const deleteIds = new Set(scored.slice(0, toDelete).map(s => s.entry.id));
+    let softDeleted = 0;
+    const result = entries.map(entry => {
+        if (deleteIds.has(entry.id)) {
+            softDeleted++;
+            return { ...entry, deleted: true, deleted_at: now.toISOString() };
+        }
+        return entry;
+    });
+    return { entries: result, softDeleted };
+}
+/**
+ * Parse a MemoryConfig from raw JSON data (e.g. from enc.json),
+ * merging missing fields with DEFAULT_CONFIG.
+ */
+export function parseMemoryConfig(raw) {
+    if (!raw || typeof raw !== 'object')
+        return { ...DEFAULT_CONFIG };
+    const obj = raw;
+    const rawDecay = (typeof obj.decay === 'object' && obj.decay !== null)
+        ? obj.decay
+        : {};
+    const rawHL = (typeof rawDecay.halfLife === 'object' && rawDecay.halfLife !== null)
+        ? rawDecay.halfLife
+        : {};
+    return {
+        maxEntries: typeof obj.maxEntries === 'number' ? obj.maxEntries : DEFAULT_CONFIG.maxEntries,
+        decay: {
+            halfLife: {
+                ...DEFAULT_CONFIG.decay.halfLife,
+                ...rawHL,
+            },
+            threshold: typeof rawDecay.threshold === 'number'
+                ? rawDecay.threshold
+                : DEFAULT_CONFIG.decay.threshold,
+            minAge: typeof rawDecay.minAge === 'number'
+                ? rawDecay.minAge
+                : DEFAULT_CONFIG.decay.minAge,
+        },
+    };
+}
+//# sourceMappingURL=MemoryDecay.js.map

package/dist/core/MemoryDecay.js.map

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

package/dist/core/ProfileFormat.d.ts

@@ -0,0 +1,38 @@
+import type { MemoryProfile } from './EntrySchema.js';
+/** Encrypted profile JSON structure (v2 age-block format). */
+export interface EncryptedProfile {
+    _aigentry: {
+        version: number;
+        format: 'age-block' | 'plaintext-fallback';
+        recipients: string[];
+        modified: string;
+        device_id?: string;
+    };
+    entries: Record<string, string>;
+}
+export declare class ProfileFormat {
+    static serialize(profile: MemoryProfile): string;
+    static deserialize(content: string): MemoryProfile;
+    /**
+     * Read profile from file, handling all formats:
+     * - age-block JSON (v2 encrypted)
+     * - plaintext JSON (v2 fallback)
+     * - plaintext YAML (legacy v1/v2)
+     * - sops YAML (legacy, read as plaintext — sops binary no longer used)
+     */
+    static readFromFile(filePath: string): Promise<MemoryProfile>;
+    /**
+     * Write profile to encrypted JSON format.
+     * Falls back to plaintext JSON if encryption fails (Invisible Security).
+     */
+    static writeToFile(filePath: string, profile: MemoryProfile): Promise<void>;
+    /** Read and decrypt an age-block JSON profile. */
+    private static readEncryptedJson;
+    /** Encrypt a MemoryProfile into EncryptedProfile format. Preserves existing recipients from file. */
+    private static encryptProfile;
+    /**
+     * Migrate legacy YAML to new enc.json format.
+     * Called after reading legacy format — backs up .yaml to .yaml.bak.
+     */
+    static migrateLegacyYaml(yamlPath: string): Promise<void>;
+}