@windagency/valora-plugin-memory-vault 1.0.0

package/dist/migration/json-to-vault.js.map

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

package/dist/migration/vault-version.d.ts

@@ -0,0 +1,4 @@
+export declare const VAULT_SCHEMA_VERSION = 1;
+export declare function readVaultVersion(vaultDir: string): null | number;
+export declare function writeVaultVersion(vaultDir: string, version?: number): void;
+//# sourceMappingURL=vault-version.d.ts.map

package/dist/migration/vault-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-version.d.ts","sourceRoot":"","sources":["../../src/migration/vault-version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQhE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAA6B,GAAG,IAAI,CAGhG"}

package/dist/migration/vault-version.js

@@ -0,0 +1,19 @@
+import { mkdirSync, readFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { atomicWriteFile } from '../vault/file-format.js';
+export const VAULT_SCHEMA_VERSION = 1;
+const VERSION_FILENAME = 'version';
+export function readVaultVersion(vaultDir) {
+	try {
+		const raw = readFileSync(path.join(vaultDir, VERSION_FILENAME), 'utf-8').trim();
+		const n = parseInt(raw, 10);
+		return isNaN(n) ? null : n;
+	} catch {
+		return null;
+	}
+}
+export function writeVaultVersion(vaultDir, version = VAULT_SCHEMA_VERSION) {
+	mkdirSync(vaultDir, { recursive: true });
+	atomicWriteFile(path.join(vaultDir, VERSION_FILENAME), String(version));
+}
+//# sourceMappingURL=vault-version.js.map

package/dist/migration/vault-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-version.js","sourceRoot":"","sources":["../../src/migration/vault-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEnC,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAChD,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAChF,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,UAAkB,oBAAoB;IACzF,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/retrieval/cosine-ann.d.ts

@@ -0,0 +1,13 @@
+import type { VectorStore } from '../embeddings/vector-store.js';
+export interface AnnCandidate {
+	id: string;
+	score: number;
+}
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+export declare function topKCosine(
+	queryVec: Float32Array,
+	vectorStore: VectorStore,
+	candidateIds: string[],
+	k: number
+): AnnCandidate[];
+//# sourceMappingURL=cosine-ann.d.ts.map

package/dist/retrieval/cosine-ann.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine-ann.d.ts","sourceRoot":"","sources":["../../src/retrieval/cosine-ann.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAgBzE;AAED,wBAAgB,UAAU,CACzB,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,MAAM,EAAE,EACtB,CAAC,EAAE,MAAM,GACP,YAAY,EAAE,CAWhB"}

package/dist/retrieval/cosine-ann.js

@@ -0,0 +1,26 @@
+export function cosineSimilarity(a, b) {
+	if (a.length !== b.length) return 0;
+	let dot = 0;
+	let normA = 0;
+	let normB = 0;
+	for (let i = 0; i < a.length; i++) {
+		dot += a[i] * b[i];
+		normA += a[i] * a[i];
+		normB += b[i] * b[i];
+	}
+	const denom = Math.sqrt(normA) * Math.sqrt(normB);
+	if (denom === 0) return 0;
+	const score = dot / denom;
+	return Number.isFinite(score) ? score : 0;
+}
+export function topKCosine(queryVec, vectorStore, candidateIds, k) {
+	const scored = [];
+	for (const id of candidateIds) {
+		const vec = vectorStore.read(id);
+		if (vec === null) continue;
+		scored.push({ id, score: cosineSimilarity(queryVec, vec) });
+	}
+	scored.sort((a, b) => b.score - a.score);
+	return scored.slice(0, k);
+}
+//# sourceMappingURL=cosine-ann.js.map

package/dist/retrieval/cosine-ann.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine-ann.js","sourceRoot":"","sources":["../../src/retrieval/cosine-ann.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAChE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAEpC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE1B,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU,CACzB,QAAsB,EACtB,WAAwB,EACxB,YAAsB,EACtB,CAAS;IAET,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,IAAI;YAAE,SAAS;QAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/retrieval/spreading-activation.d.ts

@@ -0,0 +1,12 @@
+import type { Edge } from '@windagency/valora-plugin-api';
+import type { VaultRecord } from '../vault/vault-index.js';
+export declare function spreadActivation(
+	seeds: Map<string, number>,
+	byId: Map<string, VaultRecord>,
+	outEdges: Map<string, Edge[]>,
+	inEdges: Map<string, Set<string>>,
+	depth: number,
+	gamma: number,
+	now?: number
+): Map<string, number>;
+//# sourceMappingURL=spreading-activation.d.ts.map

package/dist/retrieval/spreading-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spreading-activation.d.ts","sourceRoot":"","sources":["../../src/retrieval/spreading-activation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAsB3D,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,SAAa,GACd,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAerB"}

package/dist/retrieval/spreading-activation.js

@@ -0,0 +1,70 @@
+import { computeStrength } from '../decay.js';
+const CONFIDENCE_WEIGHT = {
+	inferred: 0.4,
+	observed: 0.7,
+	stale: 0.1,
+	verified: 1.0
+};
+const TRAVERSAL_KINDS = new Set(['co_accessed', 'related']);
+/**
+ * Edges whose backward traversal carries semantic weight. `co_accessed` is
+ * symmetric (Hebbian co-retrieval), so reverse propagation is meaningful.
+ * `related` is directional in our schema; we choose not to propagate backwards
+ * to avoid amplifying activation through one-way authorial intent (e.g.,
+ * "promotion-from-X" should not flood X's neighbours).
+ */
+const REVERSE_TRAVERSAL_KINDS = new Set(['co_accessed']);
+export function spreadActivation(seeds, byId, outEdges, inEdges, depth, gamma, now = Date.now()) {
+	if (gamma > 1) throw new Error(`spreadActivation: gamma must be <= 1 (got ${gamma})`);
+	const activation = new Map(seeds);
+	const queue = [...seeds.keys()].map((id) => [id, depth]);
+	let head = 0;
+	while (head < queue.length) {
+		const [currentId, remaining] = queue[head++];
+		if (remaining === 0) continue;
+		const act = activation.get(currentId) ?? 0;
+		propagateForward(currentId, act, remaining, gamma, outEdges, activation, queue);
+		propagateReverse(currentId, act, remaining, gamma, outEdges, inEdges, activation, queue);
+	}
+	return scoreActivation(activation, byId, now);
+}
+/**
+ * Apply a candidate activation to a node and re-enqueue it for further
+ * propagation if the new activation is strictly higher than what is already
+ * recorded. The activation guard alone terminates cycles because activation
+ * decays by `gamma < 1` at every hop, so a node revisited via a longer path
+ * always carries a smaller candidate.
+ */
+function propagate(id, activation, remaining, activationMap, queue) {
+	const current = activationMap.get(id) ?? 0;
+	if (activation <= current) return;
+	activationMap.set(id, activation);
+	if (remaining > 0) queue.push([id, remaining]);
+}
+function propagateForward(currentId, act, remaining, gamma, outEdges, activation, queue) {
+	for (const edge of outEdges.get(currentId) ?? []) {
+		if (!TRAVERSAL_KINDS.has(edge.kind)) continue;
+		propagate(edge.toId, act * (edge.weight ?? 1.0) * gamma, remaining - 1, activation, queue);
+	}
+}
+function propagateReverse(currentId, act, remaining, gamma, outEdges, inEdges, activation, queue) {
+	for (const neighborId of inEdges.get(currentId) ?? []) {
+		const edge = (outEdges.get(neighborId) ?? []).find(
+			(e) => e.toId === currentId && REVERSE_TRAVERSAL_KINDS.has(e.kind)
+		);
+		if (!edge) continue;
+		propagate(neighborId, act * (edge.weight ?? 1.0) * gamma, remaining - 1, activation, queue);
+	}
+}
+function scoreActivation(activation, byId, now) {
+	const scores = new Map();
+	for (const [id, act] of activation) {
+		const record = byId.get(id);
+		if (!record) continue;
+		const decay = computeStrength(record.entry.createdAt, record.entry.halfLifeDays, now);
+		const confidence = CONFIDENCE_WEIGHT[record.entry.confidence] ?? 0.7;
+		scores.set(id, act * decay * confidence);
+	}
+	return scores;
+}
+//# sourceMappingURL=spreading-activation.js.map

package/dist/retrieval/spreading-activation.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Memory Store — file-based JSON persistence for memory entries.
+ *
+ * Stores three JSON files in .valora/memory/:
+ *   - episodic.json  (timestamped memories, 7-day half-life)
+ *   - semantic.json  (consolidated patterns, 30-day half-life)
+ *   - decisions.json (architectural decisions, 21-day half-life)
+ *
+ * Follows the SessionStore/SessionLifecycle persistence pattern:
+ * in-memory cache + dirty tracking + debounced writes.
+ */
+import type { MemoryCategory, MemoryEntry, MemoryStoreFile } from '@windagency/valora-plugin-api';
+export declare class MemoryStore {
+	private readonly cache;
+	private readonly dirty;
+	private readonly memoryDir;
+	private readonly persistTimers;
+	constructor(memoryDir?: string);
+	appendEntry(category: MemoryCategory, entry: MemoryEntry, _links?: unknown): Promise<void>;
+	flush(): Promise<void>;
+	getEntries(category: MemoryCategory): Promise<MemoryEntry[]>;
+	getMetadata(category: MemoryCategory): Promise<{
+		lastConsolidatedAt?: string;
+		lastWrittenAt: string;
+		version: number;
+	}>;
+	load(category: MemoryCategory): MemoryStoreFile;
+	removeEntries(category: MemoryCategory, ids: Set<string>): Promise<number>;
+	removeEntry(category: MemoryCategory, id: string): Promise<boolean>;
+	save(category: MemoryCategory, immediate?: boolean): void;
+	setEntries(category: MemoryCategory, entries: MemoryEntry[]): Promise<void>;
+	setLastConsolidatedAt(timestamp: string): Promise<void>;
+	updateEntry(category: MemoryCategory, id: string, patch: Partial<MemoryEntry>): Promise<boolean>;
+	private createEmptyStoreFile;
+	private getStorePath;
+	private persistImmediate;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQlG,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqD;gBAEvE,SAAS,CAAC,EAAE,MAAM;IAO9B,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBpF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,UAAU,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK5D,WAAW,CACV,QAAQ,EAAE,cAAc,GACtB,OAAO,CAAC;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQnF,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,eAAe;IA2B/C,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1E,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnE,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,UAAQ,GAAG,IAAI;IAoBvD,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3E,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAYhG,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,gBAAgB;CAqBxB"}

package/dist/store.js

@@ -0,0 +1,192 @@
+/**
+ * Memory Store — file-based JSON persistence for memory entries.
+ *
+ * Stores three JSON files in .valora/memory/:
+ *   - episodic.json  (timestamped memories, 7-day half-life)
+ *   - semantic.json  (consolidated patterns, 30-day half-life)
+ *   - decisions.json (architectural decisions, 21-day half-life)
+ *
+ * Follows the SessionStore/SessionLifecycle persistence pattern:
+ * in-memory cache + dirty tracking + debounced writes.
+ */
+import { getLogger, getRuntimeDataDir } from '@windagency/valora-runtime';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { MEMORY_PERSIST_DEBOUNCE_MS, MEMORY_STORE_VERSION } from './constants.js';
+export class MemoryStore {
+	cache;
+	dirty;
+	memoryDir;
+	persistTimers;
+	constructor(memoryDir) {
+		this.memoryDir = memoryDir ?? path.join(getRuntimeDataDir(), 'memory');
+		this.cache = new Map();
+		this.dirty = new Set();
+		this.persistTimers = new Map();
+	}
+	appendEntry(category, entry, _links) {
+		// Idempotent on `entry.id` — replace if present, push otherwise. Matches
+		// the vault backend's overwrite semantics so the manager can safely
+		// re-append an entry when persisting late-arriving fields (e.g. the
+		// supersedes wikilink in `promote()`). The `_links` argument is part of
+		// the port contract for graph-aware backends; this legacy JSON store
+		// does not track edges, so it is intentionally ignored.
+		const storeFile = this.load(category);
+		const existingIdx = storeFile.entries.findIndex((e) => e.id === entry.id);
+		if (existingIdx >= 0) {
+			storeFile.entries[existingIdx] = entry;
+		} else {
+			storeFile.entries.push(entry);
+		}
+		this.dirty.add(category);
+		this.save(category);
+		return Promise.resolve();
+	}
+	async flush() {
+		for (const [, timer] of this.persistTimers) {
+			clearTimeout(timer);
+		}
+		this.persistTimers.clear();
+		const categories = ['episodic', 'semantic', 'decisions'];
+		for (const category of categories) {
+			if (this.dirty.has(category)) {
+				this.persistImmediate(category);
+			}
+		}
+		// Yield to event loop after synchronous file writes, preserving async contract
+		// for callers and ensuring written data is observable in subsequent microtasks.
+		await Promise.resolve();
+	}
+	getEntries(category) {
+		const storeFile = this.load(category);
+		return Promise.resolve(storeFile.entries);
+	}
+	getMetadata(category) {
+		const storeFile = this.load(category);
+		return Promise.resolve({
+			lastConsolidatedAt: storeFile.lastConsolidatedAt,
+			lastWrittenAt: storeFile.lastWrittenAt,
+			version: storeFile.version
+		});
+	}
+	load(category) {
+		const cached = this.cache.get(category);
+		if (cached !== undefined) {
+			return cached;
+		}
+		mkdirSync(this.memoryDir, { recursive: true });
+		const storePath = this.getStorePath(category);
+		try {
+			const raw = readFileSync(storePath, 'utf-8');
+			const storeFile = JSON.parse(raw);
+			this.cache.set(category, storeFile);
+			return storeFile;
+		} catch (error) {
+			const nodeError = error;
+			if (nodeError.code === 'ENOENT') {
+				const empty = this.createEmptyStoreFile();
+				this.cache.set(category, empty);
+				return empty;
+			}
+			getLogger().warn(`Failed to load memory store for category '${category}': ${nodeError.message}`);
+			const empty = this.createEmptyStoreFile();
+			this.cache.set(category, empty);
+			return empty;
+		}
+	}
+	removeEntries(category, ids) {
+		const storeFile = this.load(category);
+		const originalLength = storeFile.entries.length;
+		storeFile.entries = storeFile.entries.filter((e) => !ids.has(e.id));
+		const removed = originalLength - storeFile.entries.length;
+		if (removed > 0) {
+			this.dirty.add(category);
+			this.save(category, true);
+		}
+		return Promise.resolve(removed);
+	}
+	removeEntry(category, id) {
+		const storeFile = this.load(category);
+		const originalLength = storeFile.entries.length;
+		storeFile.entries = storeFile.entries.filter((e) => e.id !== id);
+		if (storeFile.entries.length !== originalLength) {
+			this.dirty.add(category);
+			this.save(category);
+			return Promise.resolve(true);
+		}
+		return Promise.resolve(false);
+	}
+	save(category, immediate = false) {
+		this.dirty.add(category);
+		const existing = this.persistTimers.get(category);
+		if (existing !== undefined) {
+			clearTimeout(existing);
+			this.persistTimers.delete(category);
+		}
+		if (immediate) {
+			this.persistImmediate(category);
+			return;
+		}
+		const timer = setTimeout(() => {
+			this.persistImmediate(category);
+		}, MEMORY_PERSIST_DEBOUNCE_MS);
+		this.persistTimers.set(category, timer);
+	}
+	setEntries(category, entries) {
+		const storeFile = this.load(category);
+		storeFile.entries = entries;
+		this.dirty.add(category);
+		this.save(category);
+		return Promise.resolve();
+	}
+	setLastConsolidatedAt(timestamp) {
+		const categories = ['episodic', 'semantic', 'decisions'];
+		for (const category of categories) {
+			const storeFile = this.load(category);
+			storeFile.lastConsolidatedAt = timestamp;
+			this.dirty.add(category);
+			this.save(category);
+		}
+		return Promise.resolve();
+	}
+	updateEntry(category, id, patch) {
+		const storeFile = this.load(category);
+		const entry = storeFile.entries.find((e) => e.id === id);
+		if (entry === undefined) {
+			return Promise.resolve(false);
+		}
+		Object.assign(entry, patch);
+		this.dirty.add(category);
+		this.save(category);
+		return Promise.resolve(true);
+	}
+	createEmptyStoreFile() {
+		return {
+			entries: [],
+			lastWrittenAt: new Date().toISOString(),
+			version: MEMORY_STORE_VERSION
+		};
+	}
+	getStorePath(category) {
+		return path.join(this.memoryDir, `${category}.json`);
+	}
+	persistImmediate(category) {
+		if (!this.dirty.has(category)) {
+			return;
+		}
+		const storeFile = this.cache.get(category) ?? this.createEmptyStoreFile();
+		storeFile.lastWrittenAt = new Date().toISOString();
+		const storePath = this.getStorePath(category);
+		mkdirSync(this.memoryDir, { recursive: true });
+		try {
+			writeFileSync(storePath, JSON.stringify(storeFile, null, 2));
+			this.dirty.delete(category);
+		} catch (error) {
+			// ADR-011 graceful-degradation contract: persistence failures must
+			// be non-fatal so the pipeline can continue. The dirty flag is
+			// retained, so a subsequent `flush()` will retry the write.
+			getLogger().warn(`Failed to persist memory store for category '${category}': ${error.message}`);
+		}
+	}
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/vault/default-vault-dir.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolve the default per-project vault directory.
+ *
+ * The vault is the authoritative memory store (ADR-013). All production code
+ * paths — pipeline, CLI, services — must agree on this single location so the
+ * agent and the operator are reading and writing the same data.
+ */
+export declare function getDefaultVaultDir(): string;
+/**
+ * Resolve the directory that historically held the legacy JSON memory stores
+ * (`episodic.json` etc.). Identical to {@link getDefaultVaultDir} because the
+ * vault was introduced under the same root: the auto-migration helper inspects
+ * this directory for legacy `*.json` files and, if found, migrates them in
+ * place into the per-memory Markdown vault.
+ */
+export declare function getLegacyJsonDir(): string;
+//# sourceMappingURL=default-vault-dir.d.ts.map

package/dist/vault/default-vault-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-vault-dir.d.ts","sourceRoot":"","sources":["../../src/vault/default-vault-dir.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/vault/default-vault-dir.js

@@ -0,0 +1,23 @@
+import { getRuntimeDataDir } from '@windagency/valora-runtime';
+import * as path from 'node:path';
+/**
+ * Resolve the default per-project vault directory.
+ *
+ * The vault is the authoritative memory store (ADR-013). All production code
+ * paths — pipeline, CLI, services — must agree on this single location so the
+ * agent and the operator are reading and writing the same data.
+ */
+export function getDefaultVaultDir() {
+	return path.join(getRuntimeDataDir(), 'memory');
+}
+/**
+ * Resolve the directory that historically held the legacy JSON memory stores
+ * (`episodic.json` etc.). Identical to {@link getDefaultVaultDir} because the
+ * vault was introduced under the same root: the auto-migration helper inspects
+ * this directory for legacy `*.json` files and, if found, migrates them in
+ * place into the per-memory Markdown vault.
+ */
+export function getLegacyJsonDir() {
+	return getDefaultVaultDir();
+}
+//# sourceMappingURL=default-vault-dir.js.map

package/dist/vault/default-vault-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-vault-dir.js","sourceRoot":"","sources":["../../src/vault/default-vault-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC/B,OAAO,kBAAkB,EAAE,CAAC;AAC7B,CAAC"}

package/dist/vault/file-format.d.ts

@@ -0,0 +1,44 @@
+import type { Edge, MemoryEntry } from '@windagency/valora-plugin-api';
+/**
+ * Compute the canonical SHA-256 content hash for a memory entry's body.
+ * Used by both the serialiser (to stamp the file with a fresh hash on every
+ * write) and the parser (to detect drift between the on-disk hash and the
+ * actual body, which signals an external edit — typically through Obsidian).
+ */
+export interface ParsedMemoryFile {
+	entry: MemoryEntry;
+	links: Edge[];
+}
+export declare function computeContentHash(content: string): string;
+/**
+ * Parse `[[id|kind]]` and `[[id]]` wikilinks from a Markdown body.
+ *
+ * The alias position serves a dual purpose: Obsidian renders it as the link's
+ * display text, and Valora parses it as a typed `EdgeKind`. Because users can
+ * edit the alias in Obsidian — e.g. changing `[[abc|related]]` to a more
+ * readable `[[abc|see also]]` — the parser cannot trust unknown values. Aliases
+ * outside the {@link EdgeKind} enum default to `related` rather than being cast
+ * blindly into the type system, where they would silently corrupt the in-memory
+ * adjacency index.
+ */
+export declare function parseVaultLinks(fromId: string, body: string): Edge[];
+/**
+ * Parse a memory vault Markdown file into an entry and its outgoing edges.
+ * The `id` parameter is the file's ID (used to populate edge `fromId`).
+ */
+export declare function parseMemoryFile(content: string, id: string): ParsedMemoryFile;
+/** Serialise a memory entry + outgoing edges into vault Markdown format. */
+export declare function serialiseMemoryFile(entry: MemoryEntry, links: Edge[]): string;
+/**
+ * Write content to a file atomically: write to a unique `.tmp` sibling first,
+ * then rename. Creates parent directories as needed. The tmp filename includes
+ * the writing process PID and a counter so concurrent writers never collide
+ * on the staging file.
+ */
+export declare function atomicWriteFile(filePath: string, content: string): void;
+/**
+ * Write a Buffer (binary payload) atomically via tmp+rename. Counterpart to
+ * `atomicWriteFile` for non-text data such as packed embedding vectors.
+ */
+export declare function atomicWriteBuffer(filePath: string, data: Buffer): void;
+//# sourceMappingURL=file-format.d.ts.map

package/dist/vault/file-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-format.d.ts","sourceRoot":"","sources":["../../src/vault/file-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAY,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAMjF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAwBD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAUpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAQ7E;AAiDD,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAkC7E;AAaD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKtE"}