@getbourdon/conformance 0.2.1 → 0.3.0

package/fixtures/mcp_snapshots/prepare_recognition_context_drifting.res.json

@@ -0,0 +1,26 @@
+{
+  "access_level": "team",
+  "confidence": "medium",
+  "drifting_surfaces": [
+    {
+      "agent": "codex",
+      "checked_at": "2026-06-29T12:00:00Z",
+      "reason": "yielded nothing this run - last yielded 400 record(s) at 2026-06-29T09:00:00Z"
+    }
+  ],
+  "hydration_scheduled": true,
+  "include_private": false,
+  "matched_entities": [
+    {
+      "name": "Bourdon",
+      "source_agents": [
+        "claude-code",
+        "codex"
+      ],
+      "type": "project"
+    }
+  ],
+  "prompt": "what about Bourdon",
+  "prompt_context": "Bourdon recognition context\nImmediate recognition: Oh -- Bourdon, the project.\nMatched entities:\n- Bourdon (project) via claude-code, codex: Cross-agent memory federation (granted side).\nUse this as timing-layer context, not as a final answer.",
+  "recognition": "Oh -- Bourdon, the project."
+}

package/fixtures/mcp_snapshots/resource_agent_memory.req.json

@@ -0,0 +1,6 @@
+{
+  "params": {
+    "agent_id": "claude-code"
+  },
+  "resource": "agent-library://agents/{agent_id}/memory"
+}

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 10 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,18 +7,126 @@
   "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": [
+      {
+        "id": "0192bbbb-2222-7000-8000-00000000b002",
+        "thread_name": "Parity fixture harness",
+        "updated_at": "2026-06-29T10:30:00Z"
+      },
+      {
+        "id": "0192aaaa-1111-7000-8000-00000000a001",
+        "thread_name": "Bourdon federation review",
+        "updated_at": "2026-06-29T09:00:00Z"
+      },
+      {
+        "id": "0192dddd-4444-7000-8000-00000000d004",
+        "thread_name": "Schema drift triage",
+        "updated_at": "2026-06-28T22:05:00Z"
+      }
+    ],
+    "host": "conformance-host",
+    "pid": 4242,
+    "sessions": [
+      {
+        "agent_id": "codex",
+        "cwd": "/home/example/repos/bourdon",
+        "session_id": "0192aaaa-1111-7000-8000-00000000a001",
+        "started_at": "2026-06-29T09:00:00Z"
+      },
+      {
+        "agent_id": "codex",
+        "cwd": "/home/example/repos/parity-fixtures",
+        "session_id": "0192bbbb-2222-7000-8000-00000000b002",
+        "started_at": "2026-06-29T10:30:00Z"
+      },
+      {
+        "agent_id": "claude-code",
+        "cwd": "/home/example/repos/bourdon",
+        "session_id": "0192cccc-3333-7000-8000-00000000c003",
+        "started_at": "2026-06-29T08:15:00Z"
+      }
+    ]
+  },
+  "resources": [
+    "agent-library://agents",
+    "agent-library://agents/{agent_id}/memory",
+    "agent-library://entities/{name}"
+  ],
   "seed_library": "fed_seed_library",
   "tools": [
     "query_agent_memory",
     "list_recent_work",
     "find_entity",
+    "list_workstreams",
+    "list_notes",
     "list_agents",
     "export_agents",
     "commit_to_federation",
     "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/native_stores/claude_code/expected_l5.json

@@ -5,7 +5,7 @@
     "type": "code-assistant",
     "instance": "conformance-host",
     "spec_version_compat": ">=0.1",
-    "role_narrative": "Agentic manager and code-assistant. Coordinates the RADLAB agent fleet, reviews PRs, and consults on architectural decisions. Capable of authoring code but typically reviews + delegates to specialised code-assistants like Codex for prime-code execution."
+    "role_narrative": "Agentic manager and code-assistant. Coordinates the agent fleet, reviews PRs, and consults on architectural decisions. Capable of authoring code but typically reviews + delegates to specialised code-assistants like Codex for prime-code execution."
   },
   "last_updated": "2026-06-29T00:00:00+00:00",
   "capabilities": [
@@ -26,18 +26,18 @@
   ],
   "known_entities": [
     {
-      "name": "Bourdon",
-      "type": "project",
-      "summary": "Cross-agent memory federation substrate. L5 manifests + L6 library."
-    },
-    {
-      "name": "Clyde",
+      "name": "Alpha Agent",
       "type": "project",
       "summary": "Local AI assistant entity.",
       "tags": [
         "infra"
       ]
     },
+    {
+      "name": "Bourdon",
+      "type": "project",
+      "summary": "Cross-agent memory federation substrate. L5 manifests + L6 library."
+    },
     {
       "name": "OldThing",
       "type": "project",
@@ -47,7 +47,7 @@
       ]
     },
     {
-      "name": "OMNIvour",
+      "name": "Zephyr",
       "type": "project",
       "summary": "File conversion app.",
       "tags": [

package/fixtures/native_stores/claude_code/store/auto_memory/{clyde.md → alpha-agent.md}

@@ -1,7 +1,7 @@
 ---
-name: Clyde
+name: Alpha Agent
 type: project
 description: Local AI assistant entity.
 tags: [infra]
 ---
-# Clyde
+# Alpha Agent

package/fixtures/native_stores/claude_code/store/auto_memory/{ry-guy.md → example-user.md}

@@ -1,6 +1,6 @@
 ---
-name: Ry Guy
+name: Example User
 type: person
 description: The owner.
 ---
-# Ry Guy
+# Example User

package/fixtures/native_stores/claude_code/store/knowledge_graph/memory.jsonl

@@ -1,3 +1,3 @@
-{"type":"entity","name":"OMNIvour","entityType":"project","observations":["File conversion app."]}
+{"type":"entity","name":"Zephyr","entityType":"project","observations":["File conversion app."]}
 {"type":"entity","name":"SecretCreds","entityType":"concept","observations":["the service_role key for supabase"]}
-{"type":"relation","from":"OMNIvour","to":"Bourdon","relationType":"uses"}
+{"type":"relation","from":"Zephyr","to":"Bourdon","relationType":"uses"}

package/fixtures/recognition_golden_v1.yaml

@@ -6,11 +6,11 @@
 #   - single + multi-entity recognition
 #   - alias matching
 #   - negative controls (must match NOTHING)
-#   - the short-name false-positive guard ("ILTTed" must not match "ILTT")
+#   - the short-name false-positive guard ("QUIPped" must not match "QUIP")
 #   - visibility filtering (private entities never surface)
 #   - confidence buckets (top-anchor parity contract)
 #
-# Scored by core.recognition_eval. Run:  bourdon recognition eval
+# Scored by bourdon.core.recognition_eval. Run:  bourdon recognition eval
 version: recognition-eval/v1
 cases:
   - id: single-exact
@@ -22,34 +22,34 @@ cases:
     expected_confidence: medium
 
   - id: single-case-insensitive
-    prompt: "what is happening with omnivour today"
+    prompt: "what is happening with zephyr today"
     manifest:
       known_entities:
-        - {name: OMNIvour, type: project}
-    expected_entities: [OMNIvour]
+        - {name: Zephyr, type: project}
+    expected_entities: [Zephyr]
 
   - id: alias-match
-    prompt: "any update on if_lift_then_that"
+    prompt: "any update on quick_unified_insight_pipeline"
     manifest:
       known_entities:
-        - {name: ILTT, type: product, aliases: [if_lift_then_that]}
-    expected_entities: [ILTT]
+        - {name: QUIP, type: product, aliases: [quick_unified_insight_pipeline]}
+    expected_entities: [QUIP]
 
   - id: multi-entity
-    prompt: "compare Bourdon and OMNIvour for me"
+    prompt: "compare Bourdon and Zephyr for me"
     manifest:
       known_entities:
         - {name: Bourdon, type: project}
-        - {name: OMNIvour, type: project}
+        - {name: Zephyr, type: project}
         - {name: Unrelated, type: project}
-    expected_entities: [Bourdon, OMNIvour]
+    expected_entities: [Bourdon, Zephyr]
 
   - id: negative-control-weather
     prompt: "what's the weather like today"
     manifest:
       known_entities:
         - {name: Bourdon, type: project}
-        - {name: OMNIvour, type: project}
+        - {name: Zephyr, type: project}
     expected_entities: []
 
   - id: negative-control-empty-manifest
@@ -59,10 +59,10 @@ cases:
     expected_entities: []
 
   - id: short-name-guard
-    prompt: "the build ILTTed yesterday and broke"
+    prompt: "the build QUIPped yesterday and broke"
     manifest:
       known_entities:
-        - {name: ILTT, type: product}
+        - {name: QUIP, type: product}
     expected_entities: []
 
   - id: substring-not-token
@@ -89,11 +89,11 @@ cases:
     expected_entities: [Multi Word Project]
 
   - id: archived-entity-still-recognized
-    prompt: "remind me what Coolculator was"
+    prompt: "remind me what Nimbletron was"
     manifest:
       known_entities:
-        - {name: Coolculator, type: project, valid_to: "2026-01-01"}
-    expected_entities: [Coolculator]
+        - {name: Nimbletron, type: project, valid_to: "2026-01-01"}
+    expected_entities: [Nimbletron]
 
   - id: three-entities
     prompt: "status on Alpha, Beta, and Gamma please"

package/fixtures/recognition_vectors.json

@@ -18,17 +18,17 @@
       "confidence": "medium"
     },
     {
-      "prompt": "how is ILTT going",
+      "prompt": "how is QUIP going",
       "names": [
-        "ILTT"
+        "QUIP"
       ],
       "tier": "NAME_SUBSTRING",
       "confidence": "medium"
     },
     {
-      "prompt": "we ILTTed the build",
+      "prompt": "we QUIPped the build",
       "names": [
-        "ILTT"
+        "QUIP"
       ],
       "tier": "NONE",
       "confidence": "none"
@@ -208,7 +208,7 @@
     },
     {
       "name": "two_matches",
-      "prompt": "compare Bourdon and OMNIvour for me",
+      "prompt": "compare Bourdon and Zephyr for me",
       "manifest": {
         "known_entities": [
           {
@@ -216,7 +216,7 @@
             "type": "project"
           },
           {
-            "name": "OMNIvour",
+            "name": "Zephyr",
             "type": "project"
           },
           {
@@ -228,13 +228,13 @@
       "access_level": "team",
       "matched_names": [
         "Bourdon",
-        "OMNIvour"
+        "Zephyr"
       ],
-      "recognition": "You're asking about Bourdon and OMNIvour -- I have both.",
+      "recognition": "You're asking about Bourdon and Zephyr -- I have both.",
       "confidence": "medium",
       "entity_confidences": {
         "Bourdon": "medium",
-        "OMNIvour": "medium"
+        "Zephyr": "medium"
       }
     },
     {
@@ -272,11 +272,11 @@
     },
     {
       "name": "short_name_guard",
-      "prompt": "the build ILTTed yesterday and broke",
+      "prompt": "the build QUIPped yesterday and broke",
       "manifest": {
         "known_entities": [
           {
-            "name": "ILTT",
+            "name": "QUIP",
             "type": "product"
           }
         ]
@@ -336,11 +336,11 @@
     },
     {
       "name": "archived_valid_to",
-      "prompt": "remind me what Coolculator was",
+      "prompt": "remind me what Nimbletron was",
       "manifest": {
         "known_entities": [
           {
-            "name": "Coolculator",
+            "name": "Nimbletron",
             "type": "project",
             "valid_to": "2026-01-01"
           }
@@ -348,12 +348,12 @@
       },
       "access_level": "team",
       "matched_names": [
-        "Coolculator"
+        "Nimbletron"
       ],
-      "recognition": "Oh -- Coolculator, the project (archived 2026-01-01).",
+      "recognition": "Oh -- Nimbletron, the project (archived 2026-01-01).",
       "confidence": "medium",
       "entity_confidences": {
-        "Coolculator": "medium"
+        "Nimbletron": "medium"
       }
     },
     {
@@ -382,26 +382,26 @@
     },
     {
       "name": "alias_match",
-      "prompt": "any update on if_lift_then_that",
+      "prompt": "any update on quick_unified_insight_pipeline",
       "manifest": {
         "known_entities": [
           {
-            "name": "ILTT",
+            "name": "QUIP",
             "type": "product",
             "aliases": [
-              "if_lift_then_that"
+              "quick_unified_insight_pipeline"
             ]
           }
         ]
       },
       "access_level": "team",
       "matched_names": [
-        "ILTT"
+        "QUIP"
       ],
-      "recognition": "Oh -- ILTT, the product.",
+      "recognition": "Oh -- QUIP, the product.",
       "confidence": "medium",
       "entity_confidences": {
-        "ILTT": "medium"
+        "QUIP": "medium"
       }
     },
     {
@@ -413,7 +413,7 @@
             "name": "Bourdon"
           },
           {
-            "name": "OMNIvour"
+            "name": "Zephyr"
           }
         ]
       },

package/fixtures/tier_matrix.json

@@ -105,10 +105,10 @@
     {
       "tool": "commit_to_federation",
       "tier": "trusted",
-      "namespace": "clyde",
+      "namespace": "alpha-agent",
       "granted": null,
       "args": {
-        "agent_id": "clyde",
+        "agent_id": "alpha-agent",
         "agent_type": "other",
         "entities": [
           {

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.1",
+  "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,7 +16,9 @@
   },
   "files": [
     "dist",
-    "fixtures"
+    "fixtures",
+    "fixtures.pin.json",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=20"
@@ -28,7 +30,7 @@
   "homepage": "https://bourdon.ai",
   "repository": {
     "type": "git",
-    "url": "git+https://gitlab.com/getbourdon/bourdon-js.git",
+    "url": "git+https://gitlab.com/bourdonai/bourdon-js.git",
     "directory": "packages/conformance"
   },
   "scripts": {
@@ -36,4 +38,4 @@
     "test": "vitest run",
     "sync-fixtures": "node scripts/sync-fixtures.mjs"
   }
-}
+}