@project-ava-supernova/core 0.2.71

package/dist/memory/training-export.js

@@ -0,0 +1,122 @@
+/**
+ * Export training examples from the graph by traversing decision chains.
+ */
+export function exportTrainingData(graph) {
+    const examples = [];
+    const now = new Date().toISOString();
+    const nodes = graph.getActiveNodes();
+    for (const node of nodes) {
+        // Skip low-confidence nodes — they're not reliable training signal
+        const conf = graph.getEffectiveConfidence(node);
+        if (conf < 0.4)
+            continue;
+        // ── Decision chains: decision + because edges ────────────────────
+        if (node.category === 'decision') {
+            const becauseChain = graph.traverseChain(node.id, 'because', 3);
+            const approvalEdges = graph.getEdgesTo(node.id, 'approved-by');
+            if (becauseChain.length > 0 || approvalEdges.length > 0) {
+                const reasoning = becauseChain.map(n => n.content).join(' → ');
+                const approvalContext = approvalEdges.length > 0
+                    ? graph.getNode(approvalEdges[0].fromNodeId)?.content ?? ''
+                    : '';
+                examples.push({
+                    prompt: `What was decided and why?`,
+                    response: node.content,
+                    reasoning: reasoning || approvalContext || undefined,
+                    edgeTypes: becauseChain.length > 0 ? ['because'] : ['approved-by'],
+                    confidence: conf,
+                    category: 'decision',
+                    metadata: {
+                        nodeIds: [node.id, ...becauseChain.map(n => n.id)],
+                        generatedAt: now,
+                    },
+                });
+            }
+        }
+        // ── Bug fix chains: bug + resolved-by ────────────────────────────
+        if (node.category === 'bug-fix') {
+            const resolvedBy = graph.traverseChain(node.id, 'resolved-by', 2);
+            const generalised = graph.traverseChain(node.id, 'generalised-to', 2);
+            if (resolvedBy.length > 0) {
+                examples.push({
+                    prompt: `Bug: ${node.content.slice(0, 200)}`,
+                    response: resolvedBy.map(n => n.content).join('\n'),
+                    reasoning: generalised.length > 0
+                        ? `Generalised lesson: ${generalised.map(n => n.content).join(' → ')}`
+                        : undefined,
+                    edgeTypes: ['resolved-by', ...(generalised.length > 0 ? ['generalised-to'] : [])],
+                    confidence: conf,
+                    category: 'bug-fix',
+                    metadata: {
+                        nodeIds: [node.id, ...resolvedBy.map(n => n.id), ...generalised.map(n => n.id)],
+                        generatedAt: now,
+                    },
+                });
+            }
+        }
+        // ── Architecture/preference as context examples ──────────────────
+        if (node.category === 'architecture' || node.category === 'preference') {
+            const implicationsChain = graph.traverseChain(node.id, 'implies', 2);
+            examples.push({
+                prompt: `What are the conventions/preferences for this project?`,
+                response: node.content,
+                reasoning: implicationsChain.length > 0
+                    ? `Implies: ${implicationsChain.map(n => n.content).join(' → ')}`
+                    : undefined,
+                edgeTypes: implicationsChain.length > 0 ? ['implies'] : [],
+                confidence: conf,
+                category: node.category,
+                metadata: {
+                    nodeIds: [node.id, ...implicationsChain.map(n => n.id)],
+                    generatedAt: now,
+                },
+            });
+        }
+    }
+    // Sort by confidence descending — highest quality examples first
+    examples.sort((a, b) => b.confidence - a.confidence);
+    return examples;
+}
+/**
+ * Format training examples as JSONL for SFT (supervised fine-tuning).
+ */
+export function toJsonlSft(examples) {
+    return examples.map(ex => {
+        const entry = {
+            messages: [
+                { role: 'user', content: ex.prompt },
+                { role: 'assistant', content: ex.response },
+            ],
+            metadata: {
+                category: ex.category,
+                confidence: ex.confidence,
+                reasoning: ex.reasoning,
+                edgeTypes: ex.edgeTypes,
+                ...ex.metadata,
+            },
+        };
+        return JSON.stringify(entry);
+    }).join('\n');
+}
+/**
+ * Format as JSONL with reasoning chains visible in the response.
+ * More suitable for training models that should show their work.
+ */
+export function toJsonlWithReasoning(examples) {
+    return examples.filter(ex => ex.reasoning).map(ex => {
+        const entry = {
+            messages: [
+                { role: 'user', content: ex.prompt },
+                { role: 'assistant', content: `${ex.response}\n\nReasoning: ${ex.reasoning}` },
+            ],
+            metadata: {
+                category: ex.category,
+                confidence: ex.confidence,
+                edgeTypes: ex.edgeTypes,
+                ...ex.metadata,
+            },
+        };
+        return JSON.stringify(entry);
+    }).join('\n');
+}
+//# sourceMappingURL=training-export.js.map

package/dist/memory/training-export.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,380 @@
+/**
+ * Memory v3 — Three-Layer Memory System.
+ *
+ * Memories are organised into three layers:
+ *   Person   — who the user IS (name, role, values, personal context)
+ *   Workflow — HOW they work (tools, style, feedback prefs, patterns)
+ *   Project  — THIS codebase (architecture, bugs, decisions, conventions)
+ *
+ * Person + Workflow are always recalled. Project only when relevant.
+ * Person and Workflow auto-deduplicate. Project never does.
+ */
+/** The three memory layers — primary organiser for every memory. */
+export type MemoryLayer = 'person' | 'workflow' | 'project';
+/** Categories for memory entries — finer granularity within each layer. */
+export type MemoryCategory = 'pattern' | 'preference' | 'architecture' | 'bug-fix' | 'convention' | 'tool-config' | 'decision' | 'person'
+/**
+ * How this person actually lives and trains.
+ *
+ * The other nine are code-shaped, so a health memory landed in `preference`
+ * or `general` — filed in a drawer that was not made for it, and impossible
+ * to recall selectively or delete as a set. It is one dimension: whichever
+ * room writes it, every persona reads it, which is the point.
+ *
+ * Bounded by two rules that live in the prompt, not the type: log the SHAPE
+ * ("evenings do not work for training"), never a ledger of failures
+ * ("missed 6 of 12"); and a memory must change future advice or it is not
+ * written.
+ */
+ | 'health' | 'general';
+/** A single structured memory entry. */
+export interface MemoryEntry {
+    /** Unique identifier (UUID v4 or nanoid). */
+    id: string;
+    /** What category this memory belongs to. */
+    category: MemoryCategory;
+    /** Which layer: person (who they are), workflow (how they work), project (this codebase). */
+    layer?: MemoryLayer;
+    /** The actual memory content (markdown). */
+    content: string;
+    /** When this memory was first created (ISO 8601). */
+    createdAt: string;
+    /** When this memory was last updated (ISO 8601). */
+    updatedAt: string;
+    /** When this memory was last recalled/used (ISO 8601 or null). */
+    lastRecalledAt: string | null;
+    /** How many times this memory has been recalled. */
+    recallCount: number;
+    /** Which conversation created this memory (for traceability). */
+    sourceConversationId?: string;
+    /** Optional tags for additional filtering. */
+    tags?: string[];
+    /** Whether this entry has been archived (stale, auto-archived). */
+    archived?: boolean;
+    /** When this entry was archived (ISO 8601 or null). */
+    archivedAt?: string | null;
+    /** Git branch this memory is scoped to (null = all branches). */
+    branch?: string | null;
+    /** Directory scope within the project (null = whole project). */
+    directoryScope?: string | null;
+}
+/** The full structured memory store persisted as JSON. */
+export interface MemoryStore {
+    /** Schema version — 2 = flat categories, 3 = three-layer system. */
+    version: 2 | 3;
+    /** When this store was last modified (ISO 8601). */
+    lastModified: string;
+    /** The memory entries. */
+    entries: MemoryEntry[];
+}
+/** Options for saving a memory entry. */
+export interface MemorySaveOptions {
+    scope: 'global' | 'project';
+    content: string;
+    category?: MemoryCategory;
+    /** Which layer. If omitted, inferred from category + scope. */
+    layer?: MemoryLayer;
+    tags?: string[];
+    sourceConversationId?: string;
+    /** Scope this memory to a specific git branch. */
+    branch?: string | null;
+    /** Scope this memory to a specific directory within the project. */
+    directoryScope?: string | null;
+    /**
+     * What triggered this save. Used for the dataset capture layer's
+     * memory_save event so we can train on which save sources produce
+     * memories that get recalled and used vs. which produce noise.
+     * Defaults to 'explicit' (a tool call from the model).
+     */
+    source?: 'explicit' | 'auto-extract' | 'reflection' | 'consolidation' | 'memory-agent';
+}
+/** Options for searching/recalling memories. */
+export interface MemoryRecallOptions {
+    query: string;
+    /** Where to search: "global", "project", "all" (global+current), or "all_projects" (global+every known project). */
+    scope?: 'global' | 'project' | 'all' | 'all_projects';
+    category?: MemoryCategory;
+    /** Filter to a specific layer. */
+    layer?: MemoryLayer;
+    limit?: number;
+    /** Only return memories scoped to this branch (or unscoped). */
+    branch?: string | null;
+    /** Include archived entries in results. Default: false. */
+    includeArchived?: boolean;
+}
+/** A recall result with relevance info. */
+export interface MemoryRecallResult {
+    entry: MemoryEntry;
+    /** Scope label — 'global', 'project', or a project name for cross-project results. */
+    scope: 'global' | 'project' | string;
+    /** How relevant this result is (0–1). Combines TF-IDF, recency, and frequency. */
+    relevance: number;
+    /** How the match was found. */
+    matchType: 'exact' | 'substring' | 'tfidf' | 'semantic';
+    /** Which layer this memory belongs to. */
+    layer?: MemoryLayer;
+}
+/** A group of related memory entries (for consolidation). */
+export interface MemoryConsolidationGroup {
+    /** Representative entry (highest recall count). */
+    primary: MemoryEntry;
+    /** Related entries that could be merged. */
+    related: MemoryEntry[];
+    /** Average pairwise similarity within the group. */
+    avgSimilarity: number;
+    /** Suggested consolidated content (null until model generates it). */
+    suggestedContent?: string | null;
+}
+/** Summary of a memory store for display. */
+export interface MemoryStoreSummary {
+    totalEntries: number;
+    byCategory: Record<MemoryCategory, number>;
+    byLayer: Record<MemoryLayer, number>;
+    oldestEntry: string | null;
+    newestEntry: string | null;
+    staleCount: number;
+    archivedCount: number;
+    branchScoped: number;
+}
+/** All valid categories as an array (for validation). */
+export declare const MEMORY_CATEGORIES: MemoryCategory[];
+/** Typed directed relationships between memory nodes. */
+export type EdgeType = 'because' | 'implies' | 'resolved-by' | 'contradicts' | 'generalised-to' | 'approved-by' | 'supersedes' | 'related-to' | 'depends-on' | 'learned-from';
+export declare const EDGE_TYPES: EdgeType[];
+/** How the initial confidence was determined. */
+export type ConfidenceSource = 'explicit' | 'stated' | 'approved' | 'llm-extract' | 'ambient' | 'auto-extract' | 'compression' | 'migrated';
+/** Initial confidence values per source type. */
+export declare const CONFIDENCE_INITIAL: Record<ConfidenceSource, number>;
+/** Confidence decay rate per day (halves in ~140 days if never reinforced). */
+export declare const CONFIDENCE_DECAY_PER_DAY = 0.005;
+/** Minimum confidence before auto-archival. */
+export declare const CONFIDENCE_ARCHIVE_THRESHOLD = 0.1;
+/** Maximum confidence (capped). */
+export declare const CONFIDENCE_MAX = 1;
+/** Reinforcement boost values per event type. */
+export declare const CONFIDENCE_REINFORCEMENT: {
+    readonly recalled: 0.05;
+    readonly briefed: 0.03;
+    readonly userRecalled: 0.1;
+    readonly restated: 0.2;
+    readonly confirmed: 0.3;
+    readonly edgeAdded: 0.05;
+};
+/** Archive reason for lifecycle tracking. */
+export type ArchiveReason = 'decay' | 'contradiction' | 'manual' | 'stale' | 'superseded' | null;
+/** Source of the memory node (how it was created). */
+export type NodeSource = 'user-explicit' | 'auto-extract' | 'llm-extract' | 'compression' | 'procedural' | 'ambient' | 'tool-save' | 'migrated';
+/**
+ * MemoryNode extends MemoryEntry with graph-specific fields.
+ * Backwards compatible — all new fields are optional with defaults
+ * so v2 entries can be cast to MemoryNode with zero migration.
+ */
+export interface MemoryNode extends MemoryEntry {
+    /** Node confidence 0.0–1.0. Decays over time, reinforced on recall/use. */
+    confidence?: number;
+    /** How the initial confidence was determined. */
+    confidenceSource?: ConfidenceSource;
+    /** When confidence was last boosted (ISO 8601). Resets decay clock. */
+    lastReinforcedAt?: string;
+    /** How many times confidence was boosted. */
+    reinforcementCount?: number;
+    /** Why this node was archived. */
+    archivedReason?: ArchiveReason;
+    /** How this node was created. */
+    source?: NodeSource;
+    /** Which session created this node. */
+    sourceSessionId?: string | null;
+}
+/** A typed directed relationship between two memory nodes. */
+export interface MemoryEdge {
+    /** Unique identifier (UUID). */
+    id: string;
+    /** Source node ID. */
+    fromNodeId: string;
+    /** Target node ID. */
+    toNodeId: string;
+    /** Relationship type. */
+    type: EdgeType;
+    /** Strength of the relationship 0.0–1.0. */
+    weight: number;
+    /** When this edge was created (ISO 8601). */
+    createdAt: string;
+    /** Edge-type-specific metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** The full graph stored as JSON on disk. */
+export interface MemoryGraphStore {
+    /** Schema version — 4 = graph-based. */
+    version: 4;
+    /** All memory nodes (both active and pending-archive). */
+    nodes: MemoryNode[];
+    /** All edges between nodes. */
+    edges: MemoryEdge[];
+    /** When this store was last modified (ISO 8601). */
+    lastModified: string;
+    /** When confidence decay was last applied (ISO 8601). */
+    lastDecayRun: string | null;
+    /** When forgetting pass was last run (ISO 8601). */
+    lastForgetRun: string | null;
+}
+/** Create an empty graph store. */
+export declare function createEmptyGraphStore(): MemoryGraphStore;
+/** A crystallised tool-use sequence learned from observation. */
+export interface ProceduralPattern {
+    /** Unique identifier. */
+    id: string;
+    /** Task type label (e.g. "react-component", "bug-fix", "refactor"). */
+    taskType: string;
+    /** Project root if project-specific, null if global. */
+    project: string | null;
+    /** The learned tool-call sequence. */
+    toolSequence: string[];
+    /** Typical argument patterns (file extensions, path patterns). */
+    argPatterns: Record<string, string>;
+    /** How many times this exact sequence was observed. */
+    observationCount: number;
+    /** Confidence 0.0–1.0 (increases with observations). */
+    confidence: number;
+    /** When this pattern was last observed (ISO 8601). */
+    lastObservedAt: string;
+    /** When this pattern was first created (ISO 8601). */
+    createdAt: string;
+    /** Memory node IDs this was learned from. */
+    linkedNodeIds: string[];
+    /** Whether this pattern has been crystallised (observationCount >= 3 + confidence >= 0.6). */
+    crystallised: boolean;
+}
+/** Procedural patterns store. */
+export interface ProceduralStore {
+    version: 1;
+    patterns: ProceduralPattern[];
+    lastModified: string;
+}
+/** Create an empty procedural store. */
+export declare function createEmptyProceduralStore(): ProceduralStore;
+/** Minimum observations before crystallisation. */
+export declare const PROCEDURAL_MIN_OBSERVATIONS = 3;
+/** Minimum confidence before crystallisation. */
+export declare const PROCEDURAL_MIN_CONFIDENCE = 0.6;
+/** Pre-computed synthesis of all project knowledge. */
+export interface ProjectBrain {
+    /** Which project this brain describes. */
+    projectRoot: string;
+    /** When this brain was generated (ISO 8601). */
+    generatedAt: string;
+    /** How many nodes contributed to this brain. */
+    nodeCount: number;
+    /** The injection text (~200 tokens). */
+    brief: string;
+    /** Detected/remembered technologies. */
+    stack: string[];
+    /** Top decisions by confidence. */
+    keyDecisions: string[];
+    /** Recent session summaries. */
+    activeWork: string[];
+    /** Top procedural patterns. */
+    knownPatterns: string[];
+    /** Average confidence across project nodes. */
+    confidenceAvg: number;
+    /** Date of the last session that touched this project. */
+    lastSessionDate: string;
+    /** Hash of the graph state when this brain was generated (for staleness check). */
+    graphHash: string;
+}
+/** Ava's 7 modes for mode-aware recall weighting. */
+export type AvaMode = 'work' | 'plan' | 'chat' | 'teach' | 'security' | 'brainstorm' | 'write';
+/** Options for graph-based recall (extends v2 RecallOptions). */
+export interface GraphRecallOptions {
+    /** Search query text. */
+    query: string;
+    /** Where to search. */
+    scope: 'global' | 'project' | 'all' | 'all_projects';
+    /** Current mode for category weighting. */
+    mode?: AvaMode;
+    /** Maximum results to return. */
+    limit: number;
+    /** Filter by minimum confidence. */
+    minConfidence?: number;
+    /** Include archived nodes. */
+    includeArchived?: boolean;
+    /** Filter by git branch. */
+    branch?: string | null;
+    /** Filter by category. */
+    category?: MemoryCategory;
+    /** Filter by layer. */
+    layer?: MemoryLayer;
+    /** Follow edges to find contextually related nodes. */
+    edgeTraversal?: boolean;
+    /** How deep to follow edges (default 2). */
+    traversalDepth?: number;
+}
+/** A scored recall result with optional chain information. */
+export interface ScoredNode {
+    /** The memory node. */
+    node: MemoryNode;
+    /** Composite relevance score 0.0–1.0. */
+    score: number;
+    /** How the match was found. */
+    matchType: 'tfidf' | 'edge' | 'embedding' | 'exact';
+    /** Scope label. */
+    scope: 'global' | 'project' | string;
+    /** If found via edge traversal, the path of nodes. */
+    chain?: MemoryNode[];
+    /** Edge types in the traversal path. */
+    chainEdgeTypes?: EdgeType[];
+}
+/** A candidate memory extracted from a turn, pending scoring. */
+export interface CaptureCandidate {
+    /** The user's message in this turn. */
+    userMessage: string;
+    /** Ava's response in this turn. */
+    assistantMessage: string;
+    /** Tools used in this turn. */
+    toolsUsed: string[];
+    /** Turn index in the session. */
+    turnIndex: number;
+    /** Session ID for traceability. */
+    sessionId?: string;
+}
+/** Scoring dimensions for a capture candidate. */
+export interface CandidateScore {
+    /** How different is this from existing nodes? 0=duplicate, 1=completely novel. */
+    novelty: number;
+    /** How likely to be useful in future sessions? */
+    relevance: number;
+    /** How clearly stated/decided is this? */
+    confidence: number;
+    /** Weighted composite score. */
+    composite: number;
+}
+/** Threshold for promoting a candidate to a real node. */
+export declare const AMBIENT_PROMOTE_THRESHOLD = 0.6;
+/** Threshold for holding a candidate (promote if similar appears again). */
+export declare const AMBIENT_HOLD_THRESHOLD = 0.4;
+/** A detected contradiction between two nodes. */
+export interface Contradiction {
+    /** The existing node. */
+    existingNode: MemoryNode;
+    /** The new node that contradicts it. */
+    newNode: MemoryNode;
+    /** Similarity score between the two. */
+    similarity: number;
+    /** The edge connecting them. */
+    edge: MemoryEdge;
+    /** Whether this has been resolved. */
+    resolved: boolean;
+    /** Resolution: which node won, or both kept with context. */
+    resolution?: 'newer-wins' | 'older-wins' | 'context-dependent' | 'user-resolved';
+}
+/** All valid layers as an array. */
+export declare const MEMORY_LAYERS: MemoryLayer[];
+/** Which categories belong to which layer (default mapping). */
+export declare const LAYER_CATEGORY_MAP: Record<MemoryLayer, MemoryCategory[]>;
+/**
+ * Infer layer from category + scope when layer isn't explicitly set.
+ * Used for backwards compat with existing memories and LLM fallback.
+ */
+export declare function inferLayer(category: MemoryCategory, scope: 'global' | 'project'): MemoryLayer;
+/** Default empty store (v3 — three-layer). */
+export declare function createEmptyStore(): MemoryStore;
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5D,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,YAAY,GACZ,cAAc,GACd,SAAS,GACT,YAAY,GACZ,aAAa,GACb,UAAU,GACV,QAAQ;AACV;;;;;;;;;;;;GAYG;GACD,QAAQ,GACR,SAAS,CAAC;AAEd,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAGhB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,eAAe,GAAG,cAAc,CAAC;CACxF;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oHAAoH;IACpH,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,cAAc,CAAC;IACtD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,kCAAkC;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,sFAAsF;IACtF,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC;IACxD,0CAA0C;IAC1C,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,OAAO,EAAE,WAAW,CAAC;IACrB,4CAA4C;IAC5C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAG7C,CAAC;AAcF,yDAAyD;AACzD,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,SAAS,GACT,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,cAAc,CAAC;AAEnB,eAAO,MAAM,UAAU,EAAE,QAAQ,EAGhC,CAAC;AAIF,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,QAAQ,GACR,UAAU,GACV,aAAa,GACb,SAAS,GACT,cAAc,GACd,aAAa,GACb,UAAU,CAAC;AAEf,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAS/D,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C,+CAA+C;AAC/C,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,mCAAmC;AACnC,eAAO,MAAM,cAAc,IAAM,CAAC;AAElC,iDAAiD;AACjD,eAAO,MAAM,wBAAwB;;;;;;;CAO3B,CAAC;AAIX,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,IAAI,CAAC;AAEjG,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,cAAc,GACd,aAAa,GACb,aAAa,GACb,YAAY,GACZ,SAAS,GACT,WAAW,GACX,UAAU,CAAC;AAEf;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,WAAW;IAE7C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,kCAAkC;IAClC,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,iCAAiC;IACjC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAID,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAID,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,OAAO,EAAE,CAAC,CAAC;IACX,0DAA0D;IAC1D,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,+BAA+B;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oDAAoD;IACpD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,IAAI,gBAAgB,CASxD;AAID,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8FAA8F;IAC9F,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wCAAwC;AACxC,wBAAgB,0BAA0B,IAAI,eAAe,CAE5D;AAED,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,iDAAiD;AACjD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAI7C,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gCAAgC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,qDAAqD;AACrD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AAE/F,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,cAAc,CAAC;IACrD,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,uBAAuB;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IACpD,mBAAmB;IACnB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,sDAAsD;IACtD,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,wCAAwC;IACxC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC7B;AAID,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAI1C,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,YAAY,EAAE,UAAU,CAAC;IACzB,wCAAwC;IACxC,OAAO,EAAE,UAAU,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,mBAAmB,GAAG,eAAe,CAAC;CAClF;AAED,oCAAoC;AACpC,eAAO,MAAM,aAAa,EAAE,WAAW,EAAsC,CAAC;AAE9E,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,CAIpE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAK7F;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,IAAI,WAAW,CAM9C"}

package/dist/memory/types.js

@@ -0,0 +1,99 @@
+/**
+ * Memory v3 — Three-Layer Memory System.
+ *
+ * Memories are organised into three layers:
+ *   Person   — who the user IS (name, role, values, personal context)
+ *   Workflow — HOW they work (tools, style, feedback prefs, patterns)
+ *   Project  — THIS codebase (architecture, bugs, decisions, conventions)
+ *
+ * Person + Workflow are always recalled. Project only when relevant.
+ * Person and Workflow auto-deduplicate. Project never does.
+ */
+/** All valid categories as an array (for validation). */
+export const MEMORY_CATEGORIES = [
+    'pattern', 'preference', 'architecture', 'bug-fix',
+    'convention', 'tool-config', 'decision', 'person', 'health', 'general',
+];
+export const EDGE_TYPES = [
+    'because', 'implies', 'resolved-by', 'contradicts', 'generalised-to',
+    'approved-by', 'supersedes', 'related-to', 'depends-on', 'learned-from',
+];
+/** Initial confidence values per source type. */
+export const CONFIDENCE_INITIAL = {
+    explicit: 1.0,
+    stated: 0.9,
+    approved: 0.8,
+    'llm-extract': 0.7,
+    ambient: 0.6,
+    'auto-extract': 0.5,
+    compression: 0.4,
+    migrated: 0.5,
+};
+/** Confidence decay rate per day (halves in ~140 days if never reinforced). */
+export const CONFIDENCE_DECAY_PER_DAY = 0.005;
+/** Minimum confidence before auto-archival. */
+export const CONFIDENCE_ARCHIVE_THRESHOLD = 0.1;
+/** Maximum confidence (capped). */
+export const CONFIDENCE_MAX = 1.0;
+/** Reinforcement boost values per event type. */
+export const CONFIDENCE_REINFORCEMENT = {
+    recalled: 0.05, // Surfaced in recall result
+    briefed: 0.03, // Included in project brain
+    userRecalled: 0.10, // User explicitly recalled and used
+    restated: 0.20, // User restated the same fact
+    confirmed: 0.30, // User confirmed during contradiction resolution
+    edgeAdded: 0.05, // Another node linked to this one
+};
+/** Create an empty graph store. */
+export function createEmptyGraphStore() {
+    return {
+        version: 4,
+        nodes: [],
+        edges: [],
+        lastModified: new Date().toISOString(),
+        lastDecayRun: null,
+        lastForgetRun: null,
+    };
+}
+/** Create an empty procedural store. */
+export function createEmptyProceduralStore() {
+    return { version: 1, patterns: [], lastModified: new Date().toISOString() };
+}
+/** Minimum observations before crystallisation. */
+export const PROCEDURAL_MIN_OBSERVATIONS = 3;
+/** Minimum confidence before crystallisation. */
+export const PROCEDURAL_MIN_CONFIDENCE = 0.6;
+/** Threshold for promoting a candidate to a real node. */
+export const AMBIENT_PROMOTE_THRESHOLD = 0.6;
+/** Threshold for holding a candidate (promote if similar appears again). */
+export const AMBIENT_HOLD_THRESHOLD = 0.4;
+/** All valid layers as an array. */
+export const MEMORY_LAYERS = ['person', 'workflow', 'project'];
+/** Which categories belong to which layer (default mapping). */
+export const LAYER_CATEGORY_MAP = {
+    person: ['person', 'general'],
+    workflow: ['preference', 'convention', 'tool-config', 'pattern'],
+    project: ['architecture', 'bug-fix', 'decision', 'general'],
+};
+/**
+ * Infer layer from category + scope when layer isn't explicitly set.
+ * Used for backwards compat with existing memories and LLM fallback.
+ */
+export function inferLayer(category, scope) {
+    if (scope === 'project')
+        return 'project';
+    if (category === 'person')
+        return 'person';
+    if (['preference', 'convention', 'tool-config', 'pattern'].includes(category))
+        return 'workflow';
+    return 'workflow'; // safe default for global scope
+}
+/** Default empty store (v3 — three-layer). */
+export function createEmptyStore() {
+    return {
+        version: 3,
+        lastModified: new Date().toISOString(),
+        entries: [],
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

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