@getbourdon/conformance 0.1.0

package/fixtures/l5_manifests/invalid/reasons.json

@@ -0,0 +1,75 @@
+{
+  "_doc": "Each invalid manifest's expected primary failure. `expected` (keyword + ajv-style instancePath) is the cross-impl assertion; `errors` lists every violation for debugging. Oracle: jsonschema Draft202012Validator over spec/L5_schema.json.",
+  "reasons": {
+    "missing-required-last_updated.json": {
+      "valid": false,
+      "expected": {
+        "keyword": "required",
+        "instancePath": ""
+      },
+      "errors": [
+        {
+          "keyword": "required",
+          "instancePath": "",
+          "message": "'last_updated' is a required property"
+        }
+      ]
+    },
+    "bad-spec-version-pattern.json": {
+      "valid": false,
+      "expected": {
+        "keyword": "pattern",
+        "instancePath": "/spec_version"
+      },
+      "errors": [
+        {
+          "keyword": "pattern",
+          "instancePath": "/spec_version",
+          "message": "'0.1.0' does not match '^\\\\d+\\\\.\\\\d+$'"
+        }
+      ]
+    },
+    "bad-agent-type-enum.json": {
+      "valid": false,
+      "expected": {
+        "keyword": "enum",
+        "instancePath": "/agent/type"
+      },
+      "errors": [
+        {
+          "keyword": "enum",
+          "instancePath": "/agent/type",
+          "message": "'wizard' is not one of ['code-assistant', 'note-capture', 'local-swarm', 'customer-support', 'research-assistant', 'creative-collaborator', 'project-manager', 'tutor', 'other']"
+        }
+      ]
+    },
+    "entity-bad-visibility-enum.json": {
+      "valid": false,
+      "expected": {
+        "keyword": "enum",
+        "instancePath": "/known_entities/0/visibility"
+      },
+      "errors": [
+        {
+          "keyword": "enum",
+          "instancePath": "/known_entities/0/visibility",
+          "message": "'secret' is not one of ['public', 'team', 'private']"
+        }
+      ]
+    },
+    "entity-missing-name.json": {
+      "valid": false,
+      "expected": {
+        "keyword": "required",
+        "instancePath": "/known_entities/0"
+      },
+      "errors": [
+        {
+          "keyword": "required",
+          "instancePath": "/known_entities/0",
+          "message": "'name' is a required property"
+        }
+      ]
+    }
+  }
+}

package/fixtures/l5_manifests/valid/full.json

@@ -0,0 +1,60 @@
+{
+  "spec_version": "0.1",
+  "agent": {
+    "id": "claude-code",
+    "type": "code-assistant",
+    "instance": "pc-threadripper",
+    "spec_version_compat": ">=0.1",
+    "role_narrative": "Lead code-assistant. Organizes project code."
+  },
+  "last_updated": "2026-06-29T12:00:00+00:00",
+  "capabilities": [
+    "code-read",
+    "code-write",
+    "web-search"
+  ],
+  "recent_sessions": [
+    {
+      "date": "2026-06-28",
+      "cwd": "/c/Users/cumul/repos/bourdon",
+      "project_focus": [
+        "bourdon"
+      ],
+      "key_actions": [
+        "wired l5 conformance fixtures"
+      ],
+      "files_touched": [
+        "tools/gen_conformance.py"
+      ],
+      "visibility": "public"
+    }
+  ],
+  "known_entities": [
+    {
+      "name": "Bourdon",
+      "type": "project",
+      "aliases": [
+        "NeuroLayer",
+        "Continuo"
+      ],
+      "summary": "Cross-agent memory federation.",
+      "last_touched": "2026-06-29",
+      "valid_from": "2026-01-01",
+      "tags": [
+        "infra"
+      ],
+      "visibility": "public"
+    }
+  ],
+  "visibility_policy": {
+    "default": "public",
+    "private_tags": [
+      "personal",
+      "financial",
+      "credential"
+    ],
+    "team_tags": [
+      "team"
+    ]
+  }
+}

package/fixtures/l5_manifests/valid/minimal.json

@@ -0,0 +1,8 @@
+{
+  "spec_version": "0.1",
+  "agent": {
+    "id": "clyde",
+    "type": "note-capture"
+  },
+  "last_updated": "2026-06-29T12:00:00+00:00"
+}

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

@@ -0,0 +1,51 @@
+{
+  "spec_version": "0.1",
+  "agent": {
+    "id": "clair",
+    "type": "note-capture"
+  },
+  "last_updated": "2026-06-29T12:00:00+00:00",
+  "known_entities": [
+    {
+      "name": "Quarterly Revenue",
+      "type": "concept",
+      "tags": [
+        "financial"
+      ],
+      "summary": "Q2 numbers.",
+      "visibility": "private"
+    },
+    {
+      "name": "Roadmap",
+      "type": "concept",
+      "tags": [
+        "team"
+      ],
+      "visibility": "team"
+    },
+    {
+      "name": "Public Blog",
+      "type": "site",
+      "visibility": "public"
+    }
+  ],
+  "recent_sessions": [
+    {
+      "date": "2026-06-27",
+      "visibility": "private"
+    },
+    {
+      "date": "2026-06-28",
+      "visibility": "team"
+    }
+  ],
+  "visibility_policy": {
+    "default": "team",
+    "private_tags": [
+      "financial"
+    ],
+    "team_tags": [
+      "team"
+    ]
+  }
+}

package/fixtures/l5_schema.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://bourdon.ai/schema/L5_manifest_v0.1.json",
+  "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"],
+  "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"]
+    },
+    "agent": {
+      "type": "object",
+      "required": ["id", "type"],
+      "properties": {
+        "id": {
+          "description": "Unique slug for this agent. Used as the L6 filename and cross-agent reference key.",
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9_-]*$",
+          "minLength": 1,
+          "maxLength": 64,
+          "examples": ["clyde", "claude-code", "codex", "clair"]
+        },
+        "type": {
+          "description": "Agent category. Informs L6 query routing and UI grouping.",
+          "type": "string",
+          "enum": [
+            "code-assistant",
+            "note-capture",
+            "local-swarm",
+            "customer-support",
+            "research-assistant",
+            "creative-collaborator",
+            "project-manager",
+            "tutor",
+            "other"
+          ]
+        },
+        "instance": {
+          "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"]
+        },
+        "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"]
+        },
+        "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.",
+          "type": "string",
+          "maxLength": 500,
+          "examples": [
+            "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."
+          ]
+        }
+      }
+    },
+    "last_updated": {
+      "description": "ISO 8601 UTC timestamp of when this manifest was last regenerated.",
+      "type": "string",
+      "format": "date-time"
+    },
+    "capabilities": {
+      "description": "Optional list of capabilities this agent offers. Enables L6 queries like 'which agent can analyze images?' Free-text slugs; no central registry (yet).",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "maxLength": 64
+      },
+      "uniqueItems": true,
+      "maxItems": 64,
+      "examples": [
+        ["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" },
+      "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" },
+      "maxItems": 1000
+    },
+    "visibility_policy": {
+      "description": "Default visibility rules applied when an entity does not declare its own visibility.",
+      "type": "object",
+      "properties": {
+        "default": {
+          "$ref": "#/$defs/Visibility"
+        },
+        "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"]]
+        },
+        "team_tags": {
+          "description": "Entity tags that mark entities as team-visibility (shared with team L6 but not public).",
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "Visibility": {
+      "type": "string",
+      "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"],
+      "properties": {
+        "date": {
+          "description": "ISO 8601 date the session occurred (date-only, no time).",
+          "type": "string",
+          "format": "date"
+        },
+        "cwd": {
+          "description": "Working directory of the session. Optional but highly useful for developer-tool participants.",
+          "type": "string",
+          "maxLength": 512
+        },
+        "project_focus": {
+          "description": "Entity IDs the session focused on. Cross-references known_entities.",
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "key_actions": {
+          "description": "Brief list of what happened. 1-5 short strings.",
+          "type": "array",
+          "items": { "type": "string", "maxLength": 256 },
+          "maxItems": 10
+        },
+        "files_touched": {
+          "description": "Paths or patterns modified during the session. Optional.",
+          "type": "array",
+          "items": { "type": "string" },
+          "maxItems": 50
+        },
+        "visibility": { "$ref": "#/$defs/Visibility" }
+      }
+    },
+    "Entity": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "description": "Human-readable entity name. Used for L0 keyword matching.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "type": {
+          "description": "Semantic category. Extensible free-text; common values: project, product, person, customer, ticket, concept, compound, draft, site, client, decision.",
+          "type": "string",
+          "maxLength": 64
+        },
+        "aliases": {
+          "description": "Alternative names or abbreviations that should also match for L0 detection.",
+          "type": "array",
+          "items": { "type": "string" },
+          "maxItems": 16
+        },
+        "summary": {
+          "description": "Short description (~1-3 sentences, <500 chars). L6 consumers see this as the entity's 'glossary entry.'",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "last_touched": {
+          "type": "string",
+          "format": "date"
+        },
+        "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"
+        },
+        "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"
+        },
+        "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" }
+        },
+        "visibility": {
+          "$ref": "#/$defs/Visibility",
+          "description": "Overrides visibility_policy.default for this entity. Private entities MUST be omitted from federated L6 stores."
+        }
+      }
+    }
+  }
+}

package/fixtures/l5_todict.json

@@ -0,0 +1,253 @@
+{
+  "_doc": "L5Manifest.to_dict() parity. The TS port rebuilds objects from `input` (declarative dataclass-spec: visibility as a lowercase string, null=None, []=empty list) and asserts toDict()==`expected`. Rules pinned: drop None fields, drop empty-list fields, Visibility enum -> lowercase value, key order = dataclass field order, and VisibilityPolicy.default always emitted (defaults to 'public').",
+  "cases": [
+    {
+      "name": "drops_empty_lists_and_none",
+      "input": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clyde",
+          "type": "note-capture",
+          "instance": null
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "capabilities": [],
+        "recent_sessions": [],
+        "known_entities": [],
+        "visibility_policy": null
+      },
+      "expected": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clyde",
+          "type": "note-capture"
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00"
+      }
+    },
+    {
+      "name": "visibility_lowercased",
+      "input": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clair",
+          "type": "note-capture"
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "recent_sessions": [
+          {
+            "date": "2026-06-28",
+            "visibility": "team"
+          }
+        ],
+        "known_entities": [
+          {
+            "name": "Secret",
+            "visibility": "private"
+          }
+        ],
+        "visibility_policy": {
+          "default": "public"
+        }
+      },
+      "expected": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clair",
+          "type": "note-capture"
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "recent_sessions": [
+          {
+            "date": "2026-06-28",
+            "visibility": "team"
+          }
+        ],
+        "known_entities": [
+          {
+            "name": "Secret",
+            "visibility": "private"
+          }
+        ],
+        "visibility_policy": {
+          "default": "public"
+        }
+      }
+    },
+    {
+      "name": "entity_empty_inner_lists_dropped",
+      "input": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clyde",
+          "type": "note-capture"
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "known_entities": [
+          {
+            "name": "Bourdon",
+            "type": "project",
+            "summary": "Federation layer.",
+            "aliases": [],
+            "tags": []
+          }
+        ]
+      },
+      "expected": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clyde",
+          "type": "note-capture"
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "known_entities": [
+          {
+            "name": "Bourdon",
+            "type": "project",
+            "summary": "Federation layer."
+          }
+        ]
+      }
+    },
+    {
+      "name": "policy_default_injected",
+      "input": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clyde",
+          "type": "note-capture"
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "visibility_policy": {}
+      },
+      "expected": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "clyde",
+          "type": "note-capture"
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "visibility_policy": {
+          "default": "public"
+        }
+      }
+    },
+    {
+      "name": "full_key_order",
+      "input": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "claude-code",
+          "type": "code-assistant",
+          "instance": "pc-threadripper",
+          "spec_version_compat": ">=0.1",
+          "role_narrative": "Lead code-assistant."
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "capabilities": [
+          "code-read",
+          "code-write"
+        ],
+        "recent_sessions": [
+          {
+            "date": "2026-06-28",
+            "cwd": "/repo",
+            "project_focus": [
+              "bourdon"
+            ],
+            "key_actions": [
+              "ported l5"
+            ],
+            "files_touched": [
+              "a.py"
+            ],
+            "visibility": "public"
+          }
+        ],
+        "known_entities": [
+          {
+            "name": "Bourdon",
+            "type": "project",
+            "aliases": [
+              "NeuroLayer"
+            ],
+            "summary": "Federation.",
+            "last_touched": "2026-06-29",
+            "tags": [
+              "infra"
+            ],
+            "visibility": "team",
+            "valid_from": "2026-01-01",
+            "valid_to": "2026-12-31"
+          }
+        ],
+        "visibility_policy": {
+          "default": "public",
+          "private_tags": [
+            "financial"
+          ],
+          "team_tags": [
+            "team"
+          ]
+        }
+      },
+      "expected": {
+        "spec_version": "0.1",
+        "agent": {
+          "id": "claude-code",
+          "type": "code-assistant",
+          "instance": "pc-threadripper",
+          "spec_version_compat": ">=0.1",
+          "role_narrative": "Lead code-assistant."
+        },
+        "last_updated": "2026-06-29T12:00:00+00:00",
+        "capabilities": [
+          "code-read",
+          "code-write"
+        ],
+        "recent_sessions": [
+          {
+            "date": "2026-06-28",
+            "cwd": "/repo",
+            "project_focus": [
+              "bourdon"
+            ],
+            "key_actions": [
+              "ported l5"
+            ],
+            "files_touched": [
+              "a.py"
+            ],
+            "visibility": "public"
+          }
+        ],
+        "known_entities": [
+          {
+            "name": "Bourdon",
+            "type": "project",
+            "aliases": [
+              "NeuroLayer"
+            ],
+            "summary": "Federation.",
+            "last_touched": "2026-06-29",
+            "tags": [
+              "infra"
+            ],
+            "visibility": "team",
+            "valid_from": "2026-01-01",
+            "valid_to": "2026-12-31"
+          }
+        ],
+        "visibility_policy": {
+          "default": "public",
+          "private_tags": [
+            "financial"
+          ],
+          "team_tags": [
+            "team"
+          ]
+        }
+      }
+    }
+  ]
+}