@getbourdon/conformance 0.2.2 → 0.3.0

package/fixtures/mcp_snapshots/resource_agent_memory.res.json

@@ -0,0 +1,80 @@
+{
+  "agent": {
+    "id": "claude-code",
+    "instance": "workstation-01",
+    "role_narrative": "Lead code-assistant on the federation substrate.",
+    "type": "code-assistant"
+  },
+  "capabilities": [
+    "code-read",
+    "code-write"
+  ],
+  "known_entities": [
+    {
+      "aliases": [
+        "NeuroLayer",
+        "Continuo"
+      ],
+      "name": "Bourdon",
+      "summary": "Cross-agent memory federation (granted side).",
+      "tags": [
+        "infra"
+      ],
+      "type": "project",
+      "visibility": "public"
+    }
+  ],
+  "known_workstreams": [
+    {
+      "last_touched": "2026-06-10",
+      "name": "Release",
+      "related_entities": [
+        "Bourdon"
+      ],
+      "status": "active",
+      "summary": "Prepare the public Bourdon release.",
+      "tags": [
+        "launch"
+      ],
+      "visibility": "public"
+    }
+  ],
+  "last_updated": "<frozen>",
+  "notes": [
+    {
+      "date": "2026-06-09",
+      "related_entities": [
+        "Bourdon"
+      ],
+      "text": "Public release note.",
+      "visibility": "public"
+    }
+  ],
+  "recent_sessions": [
+    {
+      "cwd": "/home/example/repos/bourdon",
+      "date": "2026-06-08",
+      "files_touched": [
+        "tools/gen_conformance.py"
+      ],
+      "key_actions": [
+        "wired tier matrix fixtures"
+      ],
+      "project_focus": [
+        "Bourdon"
+      ],
+      "visibility": "public"
+    }
+  ],
+  "spec_version": "0.1",
+  "visibility_policy": {
+    "default": "public",
+    "private_tags": [
+      "financial",
+      "personal"
+    ],
+    "team_tags": [
+      "team"
+    ]
+  }
+}

package/fixtures/mcp_snapshots/resource_agents.req.json

@@ -0,0 +1,4 @@
+{
+  "params": {},
+  "resource": "agent-library://agents"
+}

package/fixtures/mcp_snapshots/resource_agents.res.json

@@ -0,0 +1,4 @@
+[
+  "claude-code",
+  "codex"
+]

package/fixtures/mcp_snapshots/resource_entity.req.json

@@ -0,0 +1,6 @@
+{
+  "params": {
+    "name": "Bourdon"
+  },
+  "resource": "agent-library://entities/{name}"
+}

package/fixtures/mcp_snapshots/resource_entity.res.json

@@ -0,0 +1,19 @@
+[
+  {
+    "agents": [
+      "claude-code",
+      "codex"
+    ],
+    "name": "Bourdon",
+    "summaries": {
+      "claude-code": "Cross-agent memory federation (granted side).",
+      "codex": "Federation, codex view."
+    },
+    "tags": [
+      "infra"
+    ],
+    "types": [
+      "project"
+    ]
+  }
+]

package/fixtures/mcp_snapshots/rollback_agent_memory.req.json

@@ -0,0 +1,7 @@
+{
+  "args": {
+    "agent_id": "claude-code",
+    "version_id": "20260628T120000000000Z-7ec802e0"
+  },
+  "tool": "rollback_agent_memory"
+}

package/fixtures/mcp_snapshots/rollback_agent_memory.res.json

@@ -0,0 +1,7 @@
+{
+  "agent_id": "claude-code",
+  "digest": "<frozen>",
+  "path": "<frozen>",
+  "replaced_digest": "efe5467ee41bfe807098f2339dda7295f236c1ae7f575016b2402f9ba1988f7c",
+  "restored_version": "20260628T120000000000Z-7ec802e0"
+}

package/fixtures/mcp_snapshots/seed_library.json

@@ -1,5 +1,5 @@
 {
-  "_doc": "The 12 mcp_snapshots/*.res.json were produced by driving the live create_l6_server tool closures (OPERATOR / trusted, = stdio) over a TEMP copy of this seed library, then normalizing each response. The TS mirror loads the SAME seed and must reproduce every normalized res. Each tool's payload travels the wire as a single TextContent whose .text = json.dumps(payload); the snapshot is the json.loads of that text.",
+  "_doc": "The mcp_snapshots/*.res.json were produced by driving the live create_l6_server tool + resource closures (OPERATOR / trusted, = stdio) over a TEMP copy of this seed library, then normalizing each response. Every tool and resource the server registers is covered (the generator refuses to emit otherwise). The TS mirror loads the SAME seed and must reproduce every normalized res. Each payload travels the wire as a single TextContent whose .text = json.dumps(payload); the snapshot is the json.loads of that text. resource_* snapshots are taken FIRST (pure seed view); rollback_agent_memory runs LAST (it restores the seeded prior version of claude-code).",
   "caller": {
     "agent_id": "operator",
     "tier": "trusted"
@@ -7,6 +7,16 @@
   "deferred": [
     "compile_codex_turn"
   ],
+  "drift_seed": {
+    "_doc": "prepare_recognition_context_drifting.{req,res}.json were driven under this SEEDED participant drift watermark (written through the real participant_watermark.record writer, stamps then pinned), taken BEFORE the main tool loop and removed afterwards -- the plain prepare_recognition_context.res.json is therefore the healthy half of the pair, with drifting_surfaces ABSENT. The TS mirror must seed the SAME record to reproduce the drifting res.",
+    "agent_id": "codex",
+    "first_seen_at": "2026-06-29T09:00:00Z",
+    "last_check_at": "2026-06-29T12:00:00Z",
+    "last_ok_at": "2026-06-29T09:00:00Z",
+    "last_record_count": 400,
+    "last_verdict": "drift",
+    "last_verdict_reason": "yielded nothing this run - last yielded 400 record(s) at 2026-06-29T09:00:00Z"
+  },
   "presence_seed": {
     "_doc": "export_agents joins LIVE-SESSION PRESENCE and the Codex thread index onto each agent row. Both stores are pinned to hermetic temp dirs and seeded with these fixed synthetic records -- nothing comes from the generating machine. The TS mirror must seed the SAME records to reproduce export_agents.res.json. `age_s` is derived from wall-clock now at read time and is therefore FROZEN by the normalizer; every other presence field is pinned by value.",
     "codex_session_index": [
@@ -49,6 +59,11 @@
       }
     ]
   },
+  "resources": [
+    "agent-library://agents",
+    "agent-library://agents/{agent_id}/memory",
+    "agent-library://entities/{name}"
+  ],
   "seed_library": "fed_seed_library",
   "tools": [
     "query_agent_memory",
@@ -62,7 +77,56 @@
     "get_cross_agent_summary",
     "prepare_recognition_context",
     "compile_codex_turn",
-    "get_deeper_context"
+    "get_deeper_context",
+    "list_memory_versions",
+    "explain_memory_change",
+    "rollback_agent_memory"
   ],
-  "transport": "in-process (create_l6_server tool closures); wire-equivalent to stdio / streamable-HTTP JSON-in-TextContent"
+  "transport": "in-process (create_l6_server tool closures); wire-equivalent to stdio / streamable-HTTP JSON-in-TextContent",
+  "version_history_seed": {
+    "_doc": "list_memory_versions / explain_memory_change / rollback_agent_memory are driven over this deterministic seed: ONE archived claude-code version (fixed bytes under the <stamp>-<sha256(bytes)[:8]>.l5.yaml filename contract) plus ONE provenance entry whose new_digest is the version's full sha256 and whose ts is pinned. The TS mirror must seed the SAME records to reproduce those res snapshots.",
+    "digest": "7ec802e09dd4a4d43eaa643a096d3e12269d72200017e73db27591257ea3eebe",
+    "manifest": {
+      "agent": {
+        "id": "claude-code",
+        "instance": "workstation-01",
+        "role_narrative": "Lead code-assistant on the federation substrate.",
+        "type": "code-assistant"
+      },
+      "capabilities": [
+        "code-read",
+        "code-write"
+      ],
+      "known_entities": [
+        {
+          "aliases": [
+            "NeuroLayer",
+            "Continuo"
+          ],
+          "name": "Bourdon",
+          "summary": "Cross-agent memory federation (granted side).",
+          "tags": [
+            "infra"
+          ],
+          "type": "project",
+          "visibility": "public"
+        }
+      ],
+      "last_updated": "2026-06-28T12:00:00+00:00",
+      "spec_version": "0.1"
+    },
+    "provenance": {
+      "base_digest": null,
+      "caller": "operator",
+      "counts": {
+        "entities_added": 1
+      },
+      "new_digest": "7ec802e09dd4a4d43eaa643a096d3e12269d72200017e73db27591257ea3eebe",
+      "op": "commit",
+      "session_id": "0192eeee-5555-7000-8000-00000000e005",
+      "ts": "2026-06-28T12:00:00.000000Z"
+    },
+    "stamp": "20260628T120000000000Z",
+    "version_id": "20260628T120000000000Z-7ec802e0"
+  }
 }

package/fixtures.pin.json

@@ -0,0 +1,5 @@
+{
+  "_doc": "The recorded fixture pin. CI and the package tests assert the vendored fixtures/manifest.json hashes to exactly this value, so the fixture set in any build is provably the reviewed one. Refresh via the re-pin ritual in README.md.",
+  "conformance_version": "2.1.0",
+  "manifest_sha256": "f854d2a75d4616554e97e5c746f5ca9ae30ff23ed21a6d023424922e2e70813e"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getbourdon/conformance",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Language-neutral cross-implementation parity fixtures for Bourdon. Python (pip install bourdon) is the oracle; the @getbourdon/* TypeScript mirror asserts against these exact bytes.",
   "license": "Apache-2.0",
   "type": "module",
@@ -16,19 +16,21 @@
   },
   "files": [
     "dist",
-    "fixtures"
+    "fixtures",
+    "fixtures.pin.json",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=20"
   },
   "publishConfig": {
     "access": "public",
-    "provenance": false
+    "provenance": true
   },
   "homepage": "https://bourdon.ai",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/getbourdon/bourdon-js.git",
+    "url": "git+https://gitlab.com/bourdonai/bourdon-js.git",
     "directory": "packages/conformance"
   },
   "scripts": {