@getbourdon/conformance 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -1,34 +1,36 @@
-export interface RedactionSecretCase {
+interface RedactionSecretCase {
     /** Joined at load (`assembleSecret`) so no contiguous secret literal lands in git. */
     fragments: string[];
     expect_redacted: string;
     expect_contains_secret: boolean;
 }
-export interface RedactionBenignCase {
+interface RedactionBenignCase {
     text: string;
     expect_redacted: string;
     expect_contains_secret: boolean;
 }
-export interface RedactionBattery {
+interface RedactionBattery {
     redacted_sentinel: string;
     benign_limit: number;
     secrets: RedactionSecretCase[];
     benign: RedactionBenignCase[];
 }
-export interface ConformanceFixtureMeta {
+interface ConformanceFixtureMeta {
     path: string;
     sha256: string;
     producer: string;
 }
-export interface ConformanceManifest {
+interface ConformanceManifest {
     conformance_version: string;
     produced_against: {
         bourdon_version: string;
     };
     fixtures: ConformanceFixtureMeta[];
 }
-export declare function conformanceDir(): string;
-export declare function loadManifest(): ConformanceManifest;
-export declare function loadRedactionBattery(): RedactionBattery;
+declare function conformanceDir(): string;
+declare function loadManifest(): ConformanceManifest;
+declare function loadRedactionBattery(): RedactionBattery;
 /** Reconstruct a secret case's runtime string from its fragments. */
-export declare function assembleSecret(secret: RedactionSecretCase): string;
+declare function assembleSecret(secret: RedactionSecretCase): string;
+
+export { type ConformanceFixtureMeta, type ConformanceManifest, type RedactionBattery, type RedactionBenignCase, type RedactionSecretCase, assembleSecret, conformanceDir, loadManifest, loadRedactionBattery };

package/dist/index.js

@@ -1,33 +1,36 @@
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+// src/index.ts
+import { existsSync, readFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 function moduleDir() {
-    if (typeof import.meta !== "undefined" && import.meta.url) {
-        return dirname(fileURLToPath(import.meta.url));
-    }
-    return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+  if (typeof import.meta !== "undefined" && import.meta.url) {
+    return dirname(fileURLToPath(import.meta.url));
+  }
+  return typeof __dirname !== "undefined" ? __dirname : process.cwd();
 }
-export function conformanceDir() {
-    const override = process.env.BOURDON_CONFORMANCE_DIR;
-    if (override)
-        return override;
-    // Bundled snapshot: <pkg>/fixtures, one level up from src/ or dist/.
-    const bundled = resolve(moduleDir(), "..", "fixtures");
-    if (existsSync(resolve(bundled, "manifest.json")))
-        return bundled;
-    // Dev fallback: the sibling Python oracle checkout.
-    return resolve(process.cwd(), "..", "..", "bourdon", "conformance");
+function conformanceDir() {
+  const override = process.env.BOURDON_CONFORMANCE_DIR;
+  if (override) return override;
+  const bundled = resolve(moduleDir(), "..", "fixtures");
+  if (existsSync(resolve(bundled, "manifest.json"))) return bundled;
+  return resolve(process.cwd(), "..", "..", "bourdon", "conformance");
 }
 function loadJson(name) {
-    return JSON.parse(readFileSync(resolve(conformanceDir(), name), "utf8"));
+  return JSON.parse(readFileSync(resolve(conformanceDir(), name), "utf8"));
 }
-export function loadManifest() {
-    return loadJson("manifest.json");
+function loadManifest() {
+  return loadJson("manifest.json");
 }
-export function loadRedactionBattery() {
-    return loadJson("redaction_battery.json");
+function loadRedactionBattery() {
+  return loadJson("redaction_battery.json");
 }
-/** Reconstruct a secret case's runtime string from its fragments. */
-export function assembleSecret(secret) {
-    return secret.fragments.join("");
+function assembleSecret(secret) {
+  return secret.fragments.join("");
 }
+export {
+  assembleSecret,
+  conformanceDir,
+  loadManifest,
+  loadRedactionBattery
+};
+//# sourceMappingURL=index.js.map

package/fixtures/README.md

@@ -19,7 +19,7 @@ uncommitted diff (`git diff --exit-code -- conformance/`).
 python tools/gen_conformance.py     # rewrites conformance/ + manifest.json
 ```
 
-After changing a pattern in `core.redaction` (or any oracle), regenerate, review the
+After changing a pattern in `bourdon.core.redaction` (or any oracle), regenerate, review the
 diff, and bump `conformance_version` in `tools/gen_conformance.py` (patch = added cases,
 minor = new family, major = a changed expected-output = a reviewed behavior change).
 
@@ -44,7 +44,7 @@ dict. `on_disk/` holds Python-written artifacts the TS side must parse identical
 never a contiguous literal), and an append-only audit log produced by the real `record()` with frozen
 timestamps. Both pytest (`tests/test_federation_conformance.py`) and the TS vitest suite assert these.
 
-The `mcp_snapshots/` family pins the **JSON-in-TextContent wire contract** for all 10 L6
+The `mcp_snapshots/` family pins the **JSON-in-TextContent wire contract** for all 12 L6
 MCP tools. Each `*.res.json` is the live tool's payload (as `RemoteL6Client` recovers it:
 `json.loads` of the single `TextContent.text` = `json.dumps(payload)`) run through one codified
 NORMALIZER — sort object keys, round floats to 4dp, drop null/empty-list fields (to_dict
@@ -57,5 +57,5 @@ Token-shaped secrets are stored as **fragment arrays** joined at load time, so n
 contiguous secret literal ever lands in git (GitHub push-protection scans literals).
 Both loaders `"".join(fragments)`.
 
-See the master plan: `claude-brain/PROJECTS/NEUROLAYER/PLAN_TS_MIRROR_2026-06-29.md` and
+See the master plan: `agent-brain/PROJECTS/NEUROLAYER/PLAN_TS_MIRROR_2026-06-29.md` and
 the `bourdon-parity-fixture-harness` / `bourdon-py-to-ts-port` skills.

package/fixtures/fed_seed_library/agents/claude-code.l5.yaml

@@ -2,7 +2,7 @@ spec_version: '0.1'
 agent:
   id: claude-code
   type: code-assistant
-  instance: pc-threadripper
+  instance: workstation-01
   role_narrative: Lead code-assistant on the federation substrate.
 last_updated: '2026-06-29T12:00:00+00:00'
 capabilities:
@@ -32,7 +32,7 @@ known_entities:
   visibility: private
 recent_sessions:
 - date: '2026-06-08'
-  cwd: /c/Users/cumul/repos/bourdon
+  cwd: /home/example/repos/bourdon
   project_focus:
   - Bourdon
   key_actions:
@@ -41,19 +41,46 @@ recent_sessions:
   - tools/gen_conformance.py
   visibility: public
 - date: '2026-06-07'
-  cwd: /c/Users/cumul/repos/bourdon
+  cwd: /home/example/repos/bourdon
   project_focus:
   - Roadmap
   key_actions:
   - team planning
   visibility: team
 - date: '2026-06-06'
-  cwd: /c/Users/cumul/repos/bourdon
+  cwd: /home/example/repos/bourdon
   project_focus:
   - Quarterly Revenue
   key_actions:
   - private review
   visibility: private
+known_workstreams:
+- name: Release
+  summary: Prepare the public Bourdon release.
+  status: active
+  last_touched: '2026-06-10'
+  related_entities:
+  - Bourdon
+  tags:
+  - launch
+  visibility: public
+- name: Private Planning
+  status: paused
+  last_touched: '2026-06-09'
+  tags:
+  - financial
+  visibility: private
+notes:
+- date: '2026-06-09'
+  text: Public release note.
+  related_entities:
+  - Bourdon
+  visibility: public
+- date: '2026-06-08'
+  text: Team release note.
+  tags:
+  - team
+  visibility: team
 visibility_policy:
   default: public
   private_tags:

package/fixtures/fed_seed_library/agents/codex.l5.yaml

@@ -33,3 +33,18 @@ recent_sessions:
   key_actions:
   - codex private
   visibility: team
+known_workstreams:
+- name: release
+  status: paused
+  last_touched: '2026-06-11'
+  related_entities:
+  - Bourdon
+  tags:
+  - coordination
+  visibility: public
+notes:
+- date: '2026-06-10'
+  text: Codex public release note.
+  related_entities:
+  - Bourdon
+  visibility: public

package/fixtures/l5_manifests/invalid/bad-agent-type-enum.json

@@ -1,7 +1,7 @@
 {
   "spec_version": "0.1",
   "agent": {
-    "id": "clyde",
+    "id": "alpha-agent",
     "type": "wizard"
   },
   "last_updated": "2026-06-29T12:00:00+00:00"

package/fixtures/l5_manifests/invalid/bad-spec-version-pattern.json

@@ -1,7 +1,7 @@
 {
   "spec_version": "0.1.0",
   "agent": {
-    "id": "clyde",
+    "id": "alpha-agent",
     "type": "note-capture"
   },
   "last_updated": "2026-06-29T12:00:00+00:00"

package/fixtures/l5_manifests/invalid/entity-bad-visibility-enum.json

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

package/fixtures/l5_manifests/invalid/entity-missing-name.json

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

package/fixtures/l5_manifests/invalid/missing-required-last_updated.json

@@ -1,7 +1,7 @@
 {
   "spec_version": "0.1",
   "agent": {
-    "id": "clyde",
+    "id": "alpha-agent",
     "type": "note-capture"
   }
 }

package/fixtures/l5_manifests/valid/full.json

@@ -3,7 +3,7 @@
   "agent": {
     "id": "claude-code",
     "type": "code-assistant",
-    "instance": "pc-threadripper",
+    "instance": "workstation-01",
     "spec_version_compat": ">=0.1",
     "role_narrative": "Lead code-assistant. Organizes project code."
   },
@@ -16,7 +16,7 @@
   "recent_sessions": [
     {
       "date": "2026-06-28",
-      "cwd": "/c/Users/cumul/repos/bourdon",
+      "cwd": "/home/example/repos/bourdon",
       "project_focus": [
         "bourdon"
       ],

package/fixtures/l5_manifests/valid/minimal.json

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

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

@@ -22,7 +22,7 @@
           "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,7 +43,7 @@
           "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.",
@@ -58,7 +58,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."
           ]
         }
       }
@@ -93,6 +93,18 @@
       "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": {
       "description": "Default visibility rules applied when an entity does not declare its own visibility.",
       "type": "object",
@@ -204,6 +216,84 @@
           "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"
+        },
+        "last_touched": {
+          "description": "ISO 8601 date of the most recent activity on this workstream.",
+          "type": "string",
+          "format": "date"
+        },
+        "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"
+        },
+        "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",