@totemsdk/proofgraph 1.1.0 → 1.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 Local deterministic proof relationship graph for Totem Edge — indexes proofs, identities, manifests, anchors, and subjects into a queryable, content-addressed DAG.
 
-No network. No storage. Pure in-memory immutable graph with SHA3-256 content addressing.
+No network. The graph is in-memory by default; a CAS-backed durable store and a replicated evidence adapter ship with the package. SHA3-256 content addressing throughout.
 
 ## Installation
 
@@ -19,7 +19,8 @@ Key properties:
 - **Immutable** — every add/mutation returns a new `ProofGraph`; originals are never modified
 - **Idempotent** — adding the same node or edge twice has no effect (deduplication by content ID)
 - **Content-deterministic** — `graphId` excludes `createdAt` timestamps so identical content always hashes identically
-- **Interface-only storage** — `ProofGraphStoragePort` is an interface; no concrete adapter ships in this package
+- **Optional durability** — `createDurableProofGraphStore` persists graphs over any CAS-capable adapter, with restart recovery and concurrent-save serialization
+- **Replicated evidence** — `createReplicatedProofGraphEvidenceStore` binds evidence nodes to content-addressed artifacts
 
 ## All exports
 
@@ -221,19 +222,34 @@ console.assert(restored.graphId === graph.graphId);
 
 Every function that modifies a graph (`addProof`, `addEdge`, etc.) returns a new `ProofGraph` with a recomputed `graphId`. Calling the same add function twice with the same arguments returns a graph identical to calling it once — duplicate nodes and edges are silently ignored.
 
-### `ProofGraphStoragePort`
+### Durable storage
 
-This package exports a `ProofGraphStoragePort` interface only. If you need persistent storage, implement the interface in your own adapter:
+`createDurableProofGraphStore(adapter)` persists graphs over a CAS-capable
+storage adapter (`@totemsdk/storage`). It maintains a head pointer and a
+per-node reverse index, serializes concurrent saves per adapter, and refuses an
+adapter that does not acknowledge durable, atomic, conditional writes — there is
+no silent downgrade.
 
 ```typescript
-import type { ProofGraphStoragePort, ProofGraph } from '@totemsdk/proofgraph';
+import { createDurableProofGraphStore } from '@totemsdk/proofgraph';
+import { SqliteStore } from '@totemsdk/storage/sqlite';
 
-class MyStorage implements ProofGraphStoragePort {
-  async save(graph: ProofGraph): Promise<void> { /* ... */ }
-  async load(graphId: string): Promise<ProofGraph | null> { /* ... */ }
-}
+const store = createDurableProofGraphStore(new SqliteStore('./proofgraph.sqlite'));
+await store.save(graph);
+const latest = await store.latest();      // most recently saved graph
+const report = await store.recover();     // reconcile head + index after a crash
 ```
 
+`ProofGraphStoragePort` remains available if a deployment wants its own adapter
+(`save`/`load` only).
+
+### Replicated evidence
+
+`createReplicatedProofGraphEvidenceStore({ artifacts, index })` writes evidence
+nodes to an `ArtifactStore` and indexes their content-addressed refs. Reads
+distinguish `ok`, `not-found`, `corrupt` and `unavailable`, and a claim
+commitment that does not match the stored bytes is rejected before indexing.
+
 ## Related packages
 
 - [`@totemsdk/proof`](https://www.npmjs.com/package/@totemsdk/proof) — signed proof creation and verification
@@ -244,3 +260,8 @@ class MyStorage implements ProofGraphStoragePort {
 ## License
 
 Apache-2.0 — see [LICENSE](./LICENSE) and [NOTICE](./NOTICE).
+
+
+## Testing
+
+Tests live outside the published package in `tests/unit/proofgraph/`. Package `test:*` scripts are repository delegates.

package/dist/cjs/query.js

@@ -37,7 +37,7 @@ function getEdgesFrom(graph, nodeIdOrRefId) {
     const node = findNode(graph, nodeIdOrRefId);
     if (!node)
         return [];
-    return graph.edges.filter((e) => e.from === node.refId);
+    return graph.edges.filter((e) => e.from === node.refId || e.from === node.id);
 }
 /**
  * Return all incoming edges to a node (identified by node ID or refId).
@@ -46,7 +46,7 @@ function getEdgesTo(graph, nodeIdOrRefId) {
     const node = findNode(graph, nodeIdOrRefId);
     if (!node)
         return [];
-    return graph.edges.filter((e) => e.to === node.refId);
+    return graph.edges.filter((e) => e.to === node.refId || e.to === node.id);
 }
 /**
  * Return all edges of a given type.

package/dist/query.js

@@ -17,7 +17,7 @@ export function getEdgesFrom(graph, nodeIdOrRefId) {
     const node = findNode(graph, nodeIdOrRefId);
     if (!node)
         return [];
-    return graph.edges.filter((e) => e.from === node.refId);
+    return graph.edges.filter((e) => e.from === node.refId || e.from === node.id);
 }
 /**
  * Return all incoming edges to a node (identified by node ID or refId).
@@ -26,7 +26,7 @@ export function getEdgesTo(graph, nodeIdOrRefId) {
     const node = findNode(graph, nodeIdOrRefId);
     if (!node)
         return [];
-    return graph.edges.filter((e) => e.to === node.refId);
+    return graph.edges.filter((e) => e.to === node.refId || e.to === node.id);
 }
 /**
  * Return all edges of a given type.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totemsdk/proofgraph",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Local deterministic proof relationship graph for Totem Edge — indexes proofs, identities, manifests, and subjects into a queryable content-addressed DAG",
   "main": "dist/cjs/index.js",
   "types": "dist/cjs/index.d.ts",
@@ -26,10 +26,10 @@
   ],
   "dependencies": {
     "@totemsdk/core": "^1.4.2",
-    "@totemsdk/proof": "^1.0.2",
-    "@totemsdk/storage": "^0.2.2",
+    "@totemsdk/proof": "^1.0.3",
+    "@totemsdk/manifest": "^2.1.0",
     "@totemsdk/identity": "^1.1.0",
-    "@totemsdk/manifest": "^2.1.0"
+    "@totemsdk/storage": "^0.2.2"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
@@ -76,6 +76,9 @@
     "build": "tsc && tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'})+'\\n')\"",
     "build:wasm": "cd rust && wasm-pack build --target bundler --out-dir pkg && wasm-pack build --target nodejs --out-dir pkg-node",
     "clean": "rm -rf dist rust/pkg rust/pkg-node rust/target",
-    "test": "jest"
+    "test": "jest --config ../../tests/jest/proofgraph.cjs",
+    "test:integration": "node --test ../../tests/qualification/proofgraph/integration.test.mjs",
+    "test:conformance": "node --test ../../tests/qualification/proofgraph/conformance.test.mjs",
+    "test:recovery": "node --test ../../tests/qualification/proofgraph/recovery.test.mjs"
   }
 }