@oscharko-dev/keiko-memory-consolidation 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import type { MemoryEdge, MemoryEdgeId, MemoryId } from "@oscharko-dev/keiko-contracts/memory";
+import type { MemoryUpdate } from "@oscharko-dev/keiko-contracts/memory";
+export type ConsolidationJobState = "queued" | "running" | "completed" | "failed" | "canceled" | "skipped";
+export interface ConsolidationJob {
+    readonly id: string;
+    readonly state: ConsolidationJobState;
+    readonly startedAt?: number;
+    readonly completedAt?: number;
+    readonly result?: ConsolidationResult;
+    readonly error?: string;
+}
+export type StaleReason = "expired" | "low-confidence" | "aged-out";
+export interface StaleFlag {
+    readonly memoryId: MemoryId;
+    readonly reason: StaleReason;
+    readonly detectedAt: number;
+}
+export type ReviewReason = "multi-way-duplicate" | "potential-conflict";
+export type ProposedAction = {
+    readonly kind: "merge";
+    readonly winner: MemoryId;
+    readonly losers: readonly MemoryId[];
+} | {
+    readonly kind: "supersede";
+    readonly newer: MemoryId;
+    readonly older: MemoryId;
+};
+export interface ReviewItem {
+    readonly id: string;
+    readonly reason: ReviewReason;
+    readonly relatedMemoryIds: readonly MemoryId[];
+    readonly proposedAction?: ProposedAction;
+    readonly proposedEdges?: readonly MemoryEdge[];
+    readonly detectedAt: number;
+}
+export interface ConsolidationOptions {
+    readonly nowMs: number;
+    readonly newEdgeId: () => MemoryEdgeId;
+    readonly newReviewItemId: () => string;
+    readonly jaccardThreshold?: number;
+    readonly staleConfidenceThreshold?: number;
+    readonly maxAgeMs?: number;
+    readonly maxClustersPerRun?: number;
+    readonly maxRecordsPerRun?: number;
+    readonly cancellationSignal?: () => boolean;
+    readonly summaryGenerator?: (text: string) => Promise<string>;
+}
+export interface ConsolidationResult {
+    readonly state: "completed" | "canceled" | "skipped" | "failed";
+    readonly edgesProposed: readonly MemoryEdge[];
+    readonly updatesProposed: readonly MemoryUpdate[];
+    readonly staleFlags: readonly StaleFlag[];
+    readonly reviewItems: readonly ReviewItem[];
+    readonly clustersInspected: number;
+    readonly conflictPairsDetected: number;
+    readonly recordsInspected: number;
+    readonly truncated: boolean;
+    readonly elapsedMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,19 @@
+// Public surface for keiko-memory-consolidation (Epic #204 child #208).
+//
+// Consolidation is a PURE-FUNCTION engine. The caller pre-fetches MemoryRecords from the vault
+// (#206), invokes `runConsolidation`, and applies the proposed edges, supersessions, and
+// review-item resolutions back to the vault and audit ledger (#214). The engine itself never
+// touches storage, never reads the clock, and never generates random ids — everything that would
+// be impure is injected through `ConsolidationOptions` (`nowMs`, `newEdgeId`, `newReviewItemId`,
+// `cancellationSignal`). This keeps the layer trivially reproducible: same input + same options
+// => byte-identical result.
+//
+// Design choice (preserved across review and pinned here so future contributors do not "fix" it):
+// `updatesProposed` is reserved for a future model-assisted body-summarisation pass. v1 NEVER
+// emits `MemoryUpdate` envelopes: every merge / supersession is routed through a `ReviewItem`
+// carrying a `ProposedAction`, so the caller (#211 MemoriaViva UI or a workflow) materialises
+// the actual `MemorySupersession` envelope after explicit review. This preserves the Epic #204
+// invariant: "consolidation never mutates accepted memories without preserving provenance and
+// audit history" — the caller's supersession is the audited transition, not a silent in-place
+// patch.
+export {};

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const KEIKO_MEMORY_CONSOLIDATION_VERSION: "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kCAAkC,EAAG,OAAgB,CAAC"}

package/dist/version.js

@@ -0,0 +1 @@
+export const KEIKO_MEMORY_CONSOLIDATION_VERSION = "0.1.0";

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@oscharko-dev/keiko-memory-consolidation",
+  "version": "0.2.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "description": "MemoriaViva — Internal memory-consolidation package: pure-function engine that takes a bounded set of accepted MemoryRecords and returns proposed relationship edges, stale flags, and review items (multi-way duplicates and potential conflicts). The engine NEVER mutates accepted memories: every merge/supersession is routed through a ReviewItem so the caller (#211 MemoriaViva UI or a workflow) materializes the actual MemorySupersession envelope after explicit review. No IO, no clock, no randomness (caller supplies nowMs and id factories via ConsolidationOptions). ADR-0019 direction rule 3h (consolidation may depend only on keiko-contracts and keiko-security). Not published independently.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json",
+    "test": "vitest run"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@oscharko-dev/keiko-contracts": "0.2.0",
+    "@oscharko-dev/keiko-security": "0.2.0"
+  }
+}