@mirnoorata/codexa 0.2.0

package/dist/session-memory/runtime.js

@@ -0,0 +1,289 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { stableId, uniqueSorted } from "../util.js";
+import { COMPACTIONS_DIR, EVENTS_FILE, MAX_EVENT_REPLAY_BYTES, MAX_EVIDENCE_PER_ENTRY, MAX_REFS_PER_ENTRY } from "./model.js";
+import { derivedEntriesForTool, isOrientationOnlyChangePlan, refsFromQueryResult, taskIdFromToolData, viewedSummary } from "./derivation.js";
+import { acquireSessionMemoryLock, appendSessionMemoryEvent, atomicJsonWrite, countEventLines, memoryStorePath, readJson, relativeMemoryPath, resolveSessionId, rewriteEvents, sessionDir, shouldCompactEvents, writeStoreAndLatest } from "./event-log.js";
+import { bucketMemory, filterEntries, renderSessionMemoryMarkdown } from "./formatting.js";
+import { emptyStore, isSessionMemoryEvent, isSessionMemoryStore, markStoreStaleness, normalizeEntryInput, normalizeIdentifier, normalizeText, positiveInt, refKey, sanitizeStoreTrust, sha1, sortEntries, upsertEntry } from "./store.js";
+export { SESSION_MEMORY_DIR, SESSION_MEMORY_LOCK_DIR } from "./model.js";
+export { sessionMemoryCacheDir } from "./event-log.js";
+export async function loadSessionMemory(input) {
+    const repoRoot = path.resolve(input.repoRoot);
+    const sessionId = await resolveSessionId(repoRoot, input.sessionId);
+    const memoryPath = memoryStorePath(repoRoot, sessionId);
+    const warnings = [];
+    const parsed = await readJson(memoryPath);
+    if (parsed.ok && isSessionMemoryStore(parsed.value, sessionId)) {
+        return {
+            store: markStoreStaleness(sanitizeStoreTrust(parsed.value), input.freshness),
+            path: memoryPath,
+            warnings
+        };
+    }
+    if (parsed.ok) {
+        warnings.push("session memory store invalid: schema is invalid");
+    }
+    if (!parsed.ok && !parsed.missing) {
+        warnings.push(`session memory store invalid: ${parsed.error}`);
+    }
+    const replay = await replaySessionMemoryEvents(repoRoot, sessionId, input.freshness);
+    warnings.push(...replay.warnings);
+    return { ...replay, path: memoryPath, warnings };
+}
+export async function recordSessionMemory(input) {
+    const repoRoot = path.resolve(input.repoRoot);
+    const release = await acquireSessionMemoryLock(repoRoot);
+    try {
+        const sessionId = await resolveSessionId(repoRoot, input.sessionId);
+        const loaded = await loadSessionMemory({ repoRoot, sessionId, freshness: input.freshness });
+        let store = loaded.store;
+        const warnings = [...loaded.warnings];
+        const effectiveTaskId = normalizeIdentifier(input.taskId) ?? store.activeTaskId;
+        const now = new Date().toISOString();
+        const callId = normalizeText(input.callId, 80) ?? randomUUID();
+        const entries = input.entries.map((entry) => normalizeEntryInput({
+            repoRoot,
+            sessionId,
+            taskId: effectiveTaskId,
+            task: input.task,
+            entry,
+            freshness: input.freshness,
+            source: input.source ?? "agent",
+            toolName: input.toolName,
+            callId,
+            createdAt: now
+        }));
+        const recordedIds = [];
+        for (const entry of entries) {
+            store = upsertEntry(store, entry);
+            recordedIds.push(entry.id);
+        }
+        store = {
+            ...store,
+            activeTaskId: effectiveTaskId ?? store.activeTaskId,
+            updatedAt: now,
+            revision: store.revision + 1,
+            entries: sortEntries(store.entries)
+        };
+        await appendSessionMemoryEvent(repoRoot, store, {
+            schemaVersion: 1,
+            eventId: stableId("session-memory-event", sessionId, now, recordedIds.join("\n"), String(store.revision)),
+            event: "record",
+            createdAt: now,
+            sessionId,
+            taskId: effectiveTaskId,
+            entries,
+            revision: store.revision
+        });
+        await writeStoreAndLatest(repoRoot, store, effectiveTaskId);
+        let compacted = false;
+        if (await shouldCompactEvents(repoRoot, sessionId)) {
+            store = await compactSessionMemoryStore(repoRoot, store, input.freshness);
+            compacted = true;
+        }
+        const memory = bucketMemory(markStoreStaleness(store, input.freshness).entries, { limit: 20 });
+        return {
+            sessionId,
+            taskId: effectiveTaskId,
+            revision: store.revision,
+            memory,
+            writes: {
+                sessionId,
+                taskId: effectiveTaskId,
+                revision: store.revision,
+                recordedEntryIds: uniqueSorted(recordedIds),
+                compacted,
+                path: relativeMemoryPath(sessionId)
+            },
+            warnings
+        };
+    }
+    finally {
+        await release();
+    }
+}
+export async function readSessionMemory(input) {
+    const loaded = await loadSessionMemory(input);
+    const limit = positiveInt(input.limit, 30);
+    const filtered = filterEntries(loaded.store.entries, input, limit);
+    return {
+        sessionId: loaded.store.sessionId,
+        taskId: input.taskId ?? loaded.store.activeTaskId,
+        revision: loaded.store.revision,
+        memory: bucketMemory(filtered, { limit }),
+        warnings: loaded.warnings
+    };
+}
+export async function summarizeSessionMemory(input) {
+    const limit = positiveInt(input.limit, 12);
+    const result = await readSessionMemory({ ...input, limit, includeStale: input.includeStale ?? true });
+    return {
+        ...result,
+        memory: {
+            ...result.memory,
+            markdown: renderSessionMemoryMarkdown(result.memory, limit)
+        }
+    };
+}
+export async function compactSessionMemory(input) {
+    const repoRoot = path.resolve(input.repoRoot);
+    const release = await acquireSessionMemoryLock(repoRoot);
+    try {
+        const loaded = await loadSessionMemory(input);
+        const store = await compactSessionMemoryStore(repoRoot, loaded.store, input.freshness);
+        return {
+            sessionId: store.sessionId,
+            taskId: input.taskId ?? store.activeTaskId,
+            revision: store.revision,
+            memory: bucketMemory(filterEntries(markStoreStaleness(store, input.freshness).entries, input, positiveInt(input.limit, 30)), { limit: positiveInt(input.limit, 30) }),
+            writes: {
+                sessionId: store.sessionId,
+                taskId: input.taskId ?? store.activeTaskId,
+                revision: store.revision,
+                recordedEntryIds: [],
+                compacted: true,
+                path: relativeMemoryPath(store.sessionId)
+            },
+            warnings: loaded.warnings
+        };
+    }
+    finally {
+        await release();
+    }
+}
+export async function pointerForSessionMemory(input) {
+    const result = await summarizeSessionMemory({ ...input, limit: input.limit ?? 8 });
+    const ids = result.memory.entries.map((entry) => entry.id).slice(0, 20);
+    if (ids.length === 0) {
+        return undefined;
+    }
+    return {
+        sessionId: result.sessionId,
+        revision: result.revision,
+        entryIds: ids,
+        summaryHash: sha1(result.memory.markdown ?? ids.join("\n"))
+    };
+}
+export async function recordViewedMemoryForTool(input) {
+    const rawRefs = refsFromQueryResult(input.result.data, input.index);
+    const refs = isOrientationOnlyChangePlan(input.toolName, input.result.data) ? rawRefs.filter((ref) => ref.kind !== "test") : rawRefs;
+    const files = uniqueSorted(refs.map((ref) => ref.path).filter((value) => Boolean(value)));
+    const symbols = uniqueSorted(refs.filter((ref) => ref.kind === "symbol").map((ref) => ref.id));
+    const tests = uniqueSorted(refs.filter((ref) => ref.kind === "test").map((ref) => ref.path ?? ref.id));
+    const workflows = uniqueSorted(refs.filter((ref) => ref.kind === "workflow").map((ref) => ref.id));
+    const taskId = input.taskId ?? taskIdFromToolData(input.result.data);
+    const scope = {
+        files,
+        symbols,
+        tests,
+        workflows,
+        refs
+    };
+    const entries = [
+        ...(refs.length > 0
+            ? [
+                {
+                    kind: "viewed",
+                    key: `viewed:${input.toolName}:${stableId("viewed-refs", refs.map(refKey).sort().join("\n")).slice(0, 16)}`,
+                    summary: viewedSummary(input.toolName, refs, files, symbols, tests),
+                    provenance: "codexa-derived",
+                    confidence: "derived",
+                    evidenceTier: "derived",
+                    scope: {
+                        ...scope,
+                        topics: input.task ? [input.task] : []
+                    }
+                }
+            ]
+            : []),
+        ...derivedEntriesForTool(input.toolName, input.result.data, scope)
+    ];
+    if (entries.length === 0) {
+        return undefined;
+    }
+    const result = await recordSessionMemory({
+        repoRoot: input.repoRoot,
+        sessionId: input.sessionId,
+        taskId,
+        task: input.task,
+        freshness: input.result.freshness,
+        source: "mcp_tool",
+        toolName: input.toolName,
+        callId: input.callId,
+        entries
+    });
+    return result.writes;
+}
+async function compactSessionMemoryStore(repoRoot, store, freshness) {
+    const now = new Date().toISOString();
+    const retained = sortEntries(store.entries)
+        .filter((entry) => entry.status !== "resolved" && entry.status !== "rejected")
+        .map((entry) => ({ ...entry, evidence: entry.evidence.slice(0, MAX_EVIDENCE_PER_ENTRY), scope: { ...entry.scope, refs: entry.scope.refs.slice(0, MAX_REFS_PER_ENTRY) } }));
+    const dropped = store.entries.length - retained.length;
+    const compacted = {
+        ...store,
+        updatedAt: now,
+        revision: store.revision + 1,
+        entries: markStoreStaleness({ ...store, entries: retained }, freshness).entries,
+        compaction: {
+            compactedAt: now,
+            sourceEventCount: await countEventLines(repoRoot, store.sessionId),
+            retainedEntryCount: retained.length,
+            droppedEntryCount: dropped
+        }
+    };
+    const compactionDir = path.join(sessionDir(repoRoot, store.sessionId), COMPACTIONS_DIR);
+    await fs.mkdir(compactionDir, { recursive: true });
+    await atomicJsonWrite(path.join(compactionDir, `${compacted.revision}.json`), compacted);
+    await writeStoreAndLatest(repoRoot, compacted, compacted.activeTaskId);
+    await rewriteEvents(repoRoot, compacted);
+    return compacted;
+}
+async function replaySessionMemoryEvents(repoRoot, sessionId, freshness) {
+    const warnings = [];
+    const base = emptyStore(sessionId);
+    const eventsPath = path.join(sessionDir(repoRoot, sessionId), EVENTS_FILE);
+    let store = base;
+    try {
+        const stat = await fs.stat(eventsPath);
+        if (stat.size > MAX_EVENT_REPLAY_BYTES) {
+            warnings.push(`session memory replay skipped: events.ndjson exceeds ${MAX_EVENT_REPLAY_BYTES} bytes`);
+            return {
+                store: markStoreStaleness(sanitizeStoreTrust(store), freshness),
+                path: memoryStorePath(repoRoot, sessionId),
+                warnings
+            };
+        }
+        const text = await fs.readFile(eventsPath, "utf8");
+        for (const line of text.split(/\r?\n/u).filter(Boolean)) {
+            try {
+                const event = JSON.parse(line);
+                if (!isSessionMemoryEvent(event, sessionId)) {
+                    warnings.push("ignored invalid session memory event");
+                    continue;
+                }
+                for (const entry of event.entries) {
+                    store = upsertEntry(store, entry);
+                }
+                store = { ...store, revision: Math.max(store.revision, event.revision), updatedAt: event.createdAt };
+            }
+            catch (error) {
+                warnings.push(`ignored invalid session memory event: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+        if (code !== "ENOENT") {
+            warnings.push(`session memory replay failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return {
+        store: markStoreStaleness(sanitizeStoreTrust(store), freshness),
+        path: memoryStorePath(repoRoot, sessionId),
+        warnings
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/session-memory/runtime.js.map

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

package/dist/session-memory/store.d.ts

@@ -0,0 +1,27 @@
+import type { FreshnessInfo, SessionMemoryEntryFact, SessionMemoryEvidence, SessionMemoryInput, SessionMemoryRef, SessionMemoryStore } from "../types.js";
+import { type SessionMemoryEvent } from "./model.js";
+export declare function normalizeEntryInput(input: {
+    repoRoot: string;
+    sessionId: string;
+    taskId?: string;
+    task?: string;
+    entry: NonNullable<SessionMemoryInput["entries"]>[number];
+    freshness: FreshnessInfo;
+    source: SessionMemoryEvidence["source"];
+    toolName?: string;
+    callId: string;
+    createdAt: string;
+}): SessionMemoryEntryFact;
+export declare function upsertEntry(store: SessionMemoryStore, next: SessionMemoryEntryFact): SessionMemoryStore;
+export declare function sanitizeStoreTrust(store: SessionMemoryStore): SessionMemoryStore;
+export declare function markStoreStaleness(store: SessionMemoryStore, freshness?: FreshnessInfo): SessionMemoryStore;
+export declare function emptyStore(sessionId: string): SessionMemoryStore;
+export declare function refKey(ref: SessionMemoryRef): string;
+export declare function uniqueRefs(refs: SessionMemoryRef[]): SessionMemoryRef[];
+export declare function sortEntries(entries: SessionMemoryEntryFact[]): SessionMemoryEntryFact[];
+export declare function isSessionMemoryStore(value: unknown, sessionId: string): value is SessionMemoryStore;
+export declare function isSessionMemoryEvent(value: unknown, sessionId: string): value is SessionMemoryEvent;
+export declare function normalizeIdentifier(value: string | undefined): string | undefined;
+export declare function normalizeText(value: string | undefined, limit: number): string | undefined;
+export declare function positiveInt(value: number | undefined, fallback: number): number;
+export declare function sha1(value: string): string;