@getbourdon/conformance 0.2.1 → 0.3.0

package/fixtures/l5_manifests/valid/team-and-private.json

@@ -1,7 +1,7 @@
 {
   "spec_version": "0.1",
   "agent": {
-    "id": "clair",
+    "id": "beta-agent",
     "type": "note-capture"
   },
   "last_updated": "2026-06-29T12:00:00+00:00",

package/fixtures/l5_schema.json

@@ -4,17 +4,26 @@
   "title": "Bourdon L5 Agent Memory Manifest",
   "description": "A per-agent public memory glossary. L5 is a projection of L0-L4 personal memory into a standardized, agent-readable form with visibility filtering applied. L6 (the federation library) aggregates L5 manifests across agents.",
   "type": "object",
-  "required": ["spec_version", "agent", "last_updated"],
+  "required": [
+    "spec_version",
+    "agent",
+    "last_updated"
+  ],
   "properties": {
     "spec_version": {
       "description": "Bourdon spec version this manifest conforms to (semver). L6 warns when reading a manifest with an incompatible version.",
       "type": "string",
       "pattern": "^\\d+\\.\\d+$",
-      "examples": ["0.1"]
+      "examples": [
+        "0.1"
+      ]
     },
     "agent": {
       "type": "object",
-      "required": ["id", "type"],
+      "required": [
+        "id",
+        "type"
+      ],
       "properties": {
         "id": {
           "description": "Unique slug for this agent. Used as the L6 filename and cross-agent reference key.",
@@ -22,7 +31,12 @@
           "pattern": "^[a-z0-9][a-z0-9_-]*$",
           "minLength": 1,
           "maxLength": 64,
-          "examples": ["clyde", "claude-code", "codex", "clair"]
+          "examples": [
+            "alpha-agent",
+            "claude-code",
+            "codex",
+            "beta-agent"
+          ]
         },
         "type": {
           "description": "Agent category. Informs L6 query routing and UI grouping.",
@@ -43,12 +57,18 @@
           "description": "Optional machine/deployment identifier. Helps federate memory across multiple instances of the same agent on different machines.",
           "type": "string",
           "maxLength": 128,
-          "examples": ["pc-threadripper", "mac-m1max"]
+          "examples": [
+            "workstation-01",
+            "laptop-01"
+          ]
         },
         "spec_version_compat": {
           "description": "Version range of Bourdon specs this manifest is compatible with. Uses npm-style semver ranges. If omitted, assumed equal to spec_version.",
           "type": "string",
-          "examples": [">=0.1", "^0.1.0"]
+          "examples": [
+            ">=0.1",
+            "^0.1.0"
+          ]
         },
         "role_narrative": {
           "description": "Free-text description of the agent's role within a fleet. Differentiates agents that share the same `type` slug (e.g. multiple code-assistants playing different roles like manager, lead author, debugger, throwaway). Used by L6 to answer 'who should I ask about X?' style queries.",
@@ -58,7 +78,7 @@
             "Agentic manager and code-assistant. Coordinates the agent fleet, reviews PRs, and consults on solutions.",
             "Lead code-assistant. Organizes project code and executes prime code. Consults with Claude on solutions, problems, and issues via PR or Slack #agents channel.",
             "Code-assistant invoked for debugging, issues, quick fixes, and short-task throwaway sessions.",
-            "General-purpose RADLAB assistant with deep project memory."
+            "General-purpose personal assistant with deep project memory."
           ]
         }
       }
@@ -78,19 +98,44 @@
       "uniqueItems": true,
       "maxItems": 64,
       "examples": [
-        ["code-read", "code-write", "web-search", "image-analysis"]
+        [
+          "code-read",
+          "code-write",
+          "web-search",
+          "image-analysis"
+        ]
       ]
     },
     "recent_sessions": {
       "description": "Rolling window of recent sessions. Typical retention: 30 days or 100 sessions, whichever is greater. Older sessions should be rolled up into L3/L4 personal memory and omitted from L5.",
       "type": "array",
-      "items": { "$ref": "#/$defs/Session" },
+      "items": {
+        "$ref": "#/$defs/Session"
+      },
       "maxItems": 500
     },
     "known_entities": {
       "description": "The glossary surface. Each entity is something this agent knows about and can provide context on. L6 uses this for cross-agent entity lookup. Respect visibility_policy when emitting.",
       "type": "array",
-      "items": { "$ref": "#/$defs/Entity" },
+      "items": {
+        "$ref": "#/$defs/Entity"
+      },
+      "maxItems": 1000
+    },
+    "known_workstreams": {
+      "description": "Ongoing multi-session initiatives, distinct from a single dated Session and from a named glossary Entity. A workstream has a status and accrues sessions/entities over time. L6 uses this to answer 'what's currently in flight?' style queries.",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/Workstream"
+      },
+      "maxItems": 200
+    },
+    "notes": {
+      "description": "Freestanding unstructured notes not tied to a specific named entity or a single session's action log. Closer to a journal entry than a glossary term.",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/Note"
+      },
       "maxItems": 1000
     },
     "visibility_policy": {
@@ -103,13 +148,25 @@
         "private_tags": {
           "description": "Entity tags that auto-mark the entity as private (overriding any explicit visibility setting).",
           "type": "array",
-          "items": { "type": "string" },
-          "examples": [["personal", "financial", "credential", "health", "family"]]
+          "items": {
+            "type": "string"
+          },
+          "examples": [
+            [
+              "personal",
+              "financial",
+              "credential",
+              "health",
+              "family"
+            ]
+          ]
         },
         "team_tags": {
           "description": "Entity tags that mark entities as team-visibility (shared with team L6 but not public).",
           "type": "array",
-          "items": { "type": "string" }
+          "items": {
+            "type": "string"
+          }
         }
       }
     }
@@ -117,17 +174,31 @@
   "$defs": {
     "Visibility": {
       "type": "string",
-      "enum": ["public", "team", "private"],
+      "enum": [
+        "public",
+        "team",
+        "private"
+      ],
       "description": "public = published to all L6 stores | team = team L6 only | private = local L6 only, never federated outward"
     },
     "Session": {
       "type": "object",
-      "required": ["date"],
+      "required": [
+        "date"
+      ],
       "properties": {
         "date": {
-          "description": "ISO 8601 date the session occurred (date-only, no time).",
+          "description": "ISO 8601 date the session occurred (date-only, no time). An empty string means the native store carried no recognisable timestamp; readers MUST NOT substitute the current date, which would make a manifest look more current than reality. The pattern rejects impossible months/days (e.g. 2026-99-99) even under pattern-only validators; the anyOf format branch additionally rejects impossible calendar dates the pattern cannot express (e.g. Feb 30) wherever format checking is enabled.",
           "type": "string",
-          "format": "date"
+          "pattern": "^(\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))?$",
+          "anyOf": [
+            {
+              "format": "date"
+            },
+            {
+              "const": ""
+            }
+          ]
         },
         "cwd": {
           "description": "Working directory of the session. Optional but highly useful for developer-tool participants.",
@@ -137,26 +208,37 @@
         "project_focus": {
           "description": "Entity IDs the session focused on. Cross-references known_entities.",
           "type": "array",
-          "items": { "type": "string" }
+          "items": {
+            "type": "string"
+          }
         },
         "key_actions": {
           "description": "Brief list of what happened. 1-5 short strings.",
           "type": "array",
-          "items": { "type": "string", "maxLength": 256 },
+          "items": {
+            "type": "string",
+            "maxLength": 256
+          },
           "maxItems": 10
         },
         "files_touched": {
           "description": "Paths or patterns modified during the session. Optional.",
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "maxItems": 50
         },
-        "visibility": { "$ref": "#/$defs/Visibility" }
+        "visibility": {
+          "$ref": "#/$defs/Visibility"
+        }
       }
     },
     "Entity": {
       "type": "object",
-      "required": ["name"],
+      "required": [
+        "name"
+      ],
       "properties": {
         "name": {
           "description": "Human-readable entity name. Used for L0 keyword matching.",
@@ -172,7 +254,9 @@
         "aliases": {
           "description": "Alternative names or abbreviations that should also match for L0 detection.",
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "maxItems": 16
         },
         "summary": {
@@ -182,28 +266,133 @@
         },
         "last_touched": {
           "type": "string",
-          "format": "date"
+          "format": "date",
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
         },
         "valid_from": {
           "description": "ISO 8601 date this entity became active in the agent's worldview. When omitted, the entity has either always been valid or its start date is unknown. L6 queries can filter on this to answer 'what was active in Q1 2026?' style questions. Inspired by Zep's Graphiti temporal validity model.",
           "type": "string",
-          "format": "date"
+          "format": "date",
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
         },
         "valid_to": {
           "description": "ISO 8601 date this entity stopped being active. Participants typically populate this when an entity is tagged 'archived' or 'canceled'. Absent (or null) means the entity is still active as of last_updated. Federation queries that filter by current time treat missing valid_to as 'still valid'.",
           "type": "string",
-          "format": "date"
+          "format": "date",
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
         },
         "tags": {
           "description": "Free-text tags. Used for visibility_policy.private_tags/team_tags matching and for filtering in L6 queries.",
           "type": "array",
-          "items": { "type": "string" }
+          "items": {
+            "type": "string"
+          }
         },
         "visibility": {
           "$ref": "#/$defs/Visibility",
           "description": "Overrides visibility_policy.default for this entity. Private entities MUST be omitted from federated L6 stores."
         }
       }
+    },
+    "Workstream": {
+      "type": "object",
+      "required": [
+        "name",
+        "status"
+      ],
+      "properties": {
+        "name": {
+          "description": "Human-readable workstream name.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "summary": {
+          "description": "Short description of what this workstream is (~1-3 sentences, <500 chars).",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "status": {
+          "description": "Current lifecycle state.",
+          "type": "string",
+          "enum": [
+            "active",
+            "paused",
+            "done",
+            "archived"
+          ]
+        },
+        "started": {
+          "description": "ISO 8601 date this workstream began.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
+        },
+        "last_touched": {
+          "description": "ISO 8601 date of the most recent activity on this workstream.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
+        },
+        "related_entities": {
+          "description": "Entity names this workstream references. Cross-references known_entities.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 32
+        },
+        "tags": {
+          "description": "Free-text tags. Used for visibility_policy matching and L6 query filtering.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "visibility": {
+          "$ref": "#/$defs/Visibility",
+          "description": "Overrides visibility_policy.default for this workstream. Private workstreams MUST be omitted from federated L6 stores."
+        }
+      }
+    },
+    "Note": {
+      "type": "object",
+      "required": [
+        "date",
+        "text"
+      ],
+      "properties": {
+        "date": {
+          "description": "ISO 8601 date the note was written.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
+        },
+        "text": {
+          "description": "Freeform note content. Larger than a Session.key_actions line -- this is a journal entry, not an action log.",
+          "type": "string",
+          "maxLength": 4000
+        },
+        "related_entities": {
+          "description": "Entity names this note references. Cross-references known_entities. Optional.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 16
+        },
+        "tags": {
+          "description": "Free-text tags. Used for visibility_policy matching and L6 query filtering.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "visibility": {
+          "$ref": "#/$defs/Visibility",
+          "description": "Overrides visibility_policy.default for this note. Private notes MUST be omitted from federated L6 stores."
+        }
+      }
     }
   }
 }

package/fixtures/l5_todict.json

@@ -6,7 +6,7 @@
       "input": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clyde",
+          "id": "alpha-agent",
           "type": "note-capture",
           "instance": null
         },
@@ -19,7 +19,7 @@
       "expected": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clyde",
+          "id": "alpha-agent",
           "type": "note-capture"
         },
         "last_updated": "2026-06-29T12:00:00+00:00"
@@ -30,7 +30,7 @@
       "input": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clair",
+          "id": "beta-agent",
           "type": "note-capture"
         },
         "last_updated": "2026-06-29T12:00:00+00:00",
@@ -53,7 +53,7 @@
       "expected": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clair",
+          "id": "beta-agent",
           "type": "note-capture"
         },
         "last_updated": "2026-06-29T12:00:00+00:00",
@@ -79,7 +79,7 @@
       "input": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clyde",
+          "id": "alpha-agent",
           "type": "note-capture"
         },
         "last_updated": "2026-06-29T12:00:00+00:00",
@@ -96,7 +96,7 @@
       "expected": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clyde",
+          "id": "alpha-agent",
           "type": "note-capture"
         },
         "last_updated": "2026-06-29T12:00:00+00:00",
@@ -114,7 +114,7 @@
       "input": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clyde",
+          "id": "alpha-agent",
           "type": "note-capture"
         },
         "last_updated": "2026-06-29T12:00:00+00:00",
@@ -123,7 +123,7 @@
       "expected": {
         "spec_version": "0.1",
         "agent": {
-          "id": "clyde",
+          "id": "alpha-agent",
           "type": "note-capture"
         },
         "last_updated": "2026-06-29T12:00:00+00:00",
@@ -139,7 +139,7 @@
         "agent": {
           "id": "claude-code",
           "type": "code-assistant",
-          "instance": "pc-threadripper",
+          "instance": "workstation-01",
           "spec_version_compat": ">=0.1",
           "role_narrative": "Lead code-assistant."
         },
@@ -196,7 +196,7 @@
         "agent": {
           "id": "claude-code",
           "type": "code-assistant",
-          "instance": "pc-threadripper",
+          "instance": "workstation-01",
           "spec_version_compat": ">=0.1",
           "role_narrative": "Lead code-assistant."
         },

package/fixtures/leak_cases.json

@@ -1,5 +1,5 @@
 {
-  "_doc": "Cross-impl federation leak-audit parity. Oracle = core.leak_audit.audit_manifest. Each case feeds `manifest` through the auditor; `expected_findings` pins [{kind, location}] in the oracle's emission order (visibility entities, visibility sessions, then the total credential walk). kind in {'credential','visibility'}; location is a json-path like 'known_entities[0].summary'. audit_manifest NEVER raises -- garbage manifests yield []. Credential cases use keyword-shaped triggers only; no token literal is committed.",
+  "_doc": "Cross-impl federation leak-audit parity. Oracle = bourdon.core.leak_audit.audit_manifest. Each case feeds `manifest` through the auditor; `expected_findings` pins [{kind, location}] in the oracle's emission order (visibility entities, visibility sessions, then the total credential walk). kind in {'credential','visibility'}; location is a json-path like 'known_entities[0].summary'. audit_manifest NEVER raises -- garbage manifests yield []. Credential cases use keyword-shaped triggers only; no token literal is committed.",
   "audit_schema_version": "federation-leak-audit/v1",
   "private_tag_families": [
     "credential",