@logicsrc/schemas 0.1.0

package/fixtures/opencontext/resolution/redaction/expected.json

@@ -0,0 +1,28 @@
+{
+  "description": "Redaction runs after authorization: the consumer is entitled to the record, and still does not receive the SSN. The bundle discloses that redaction happened without disclosing what was redacted.",
+  "resolve": {
+    "role": "support",
+    "at": "2026-08-09T12:00:00Z"
+  },
+  "expect": {
+    "included": [
+      "customers.acme"
+    ],
+    "redacted": {
+      "customers.acme": [
+        "ssn",
+        "contacts[*].email"
+      ]
+    },
+    "contentAbsent": {
+      "customers.acme": [
+        "ssn"
+      ]
+    },
+    "contentEquals": {
+      "customers.acme": {
+        "contacts.0.email": "[REDACTED]"
+      }
+    }
+  }
+}

package/fixtures/opencontext/resolution/redaction/opencontext.yaml

@@ -0,0 +1,19 @@
+opencontext: "1.0"
+id: redaction-test
+name: Redaction
+
+collections:
+  customers: ./context/customers/**
+
+roles:
+  support:
+    include:
+      - customers.*
+    max_classification: confidential
+    redact:
+      - path: ssn
+        mode: remove
+        reason: PII
+      - path: contacts[*].email
+        mode: mask
+        replacement: "[REDACTED]"

package/fixtures/opencontext/resolution/supersession/context/pricing/enterprise.v1.md

@@ -0,0 +1,12 @@
+---
+id: pricing.enterprise
+type: policy
+layer: L3
+version: 1
+authority: canonical
+owner: sales
+canonical_source: true
+updated: 2026-01-01T00:00:00Z
+---
+
+Enterprise plans start at $1,800/month.

package/fixtures/opencontext/resolution/supersession/context/pricing/enterprise.v2.md

@@ -0,0 +1,14 @@
+---
+id: pricing.enterprise
+type: policy
+layer: L3
+version: 2
+authority: canonical
+owner: sales
+canonical_source: true
+updated: 2026-08-01T00:00:00Z
+supersedes:
+  - pricing.enterprise@1
+---
+
+Enterprise plans start at $2,500/month.

package/fixtures/opencontext/resolution/supersession/expected.json

@@ -0,0 +1,33 @@
+{
+  "description": "Superseded versions are retained on disk and excluded from default resolution; --include-historical brings them back so a past view can be reconstructed.",
+  "resolve": {
+    "role": "sales",
+    "at": "2026-08-09T12:00:00Z"
+  },
+  "expect": {
+    "included": [
+      "pricing.enterprise"
+    ],
+    "includedVersions": {
+      "pricing.enterprise": 2
+    },
+    "excluded": [
+      {
+        "id": "pricing.enterprise",
+        "reason": "superseded"
+      }
+    ]
+  },
+  "also": [
+    {
+      "resolve": {
+        "role": "sales",
+        "at": "2026-08-09T12:00:00Z",
+        "includeHistorical": true
+      },
+      "expect": {
+        "objectCount": 2
+      }
+    }
+  ]
+}

package/fixtures/opencontext/resolution/supersession/opencontext.yaml

@@ -0,0 +1,11 @@
+opencontext: "1.0"
+id: supersession-test
+name: Supersession
+
+collections:
+  pricing: ./context/pricing/**
+
+roles:
+  sales:
+    include:
+      - pricing.*

package/fixtures/opencontext/valid/audit-event.json

@@ -0,0 +1,26 @@
+{
+  "opencontext": "1.0",
+  "event": "context.resolve",
+  "at": "2026-08-09T15:00:00Z",
+  "actor": {
+    "type": "agent",
+    "id": "support-agent",
+    "roles": [
+      "support"
+    ],
+    "on_behalf_of": "dana@acme.example"
+  },
+  "task": "Handle refund request for ACME",
+  "objects": [
+    "mission",
+    "policies.refunds"
+  ],
+  "bundle": {
+    "bundle_id": "ocb_3b541a2e1a933b60",
+    "digest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "object_count": 2
+  },
+  "outcome": "partial",
+  "reason": "3 objects excluded by scope",
+  "namespace": "acme"
+}

package/fixtures/opencontext/valid/bundle.json

@@ -0,0 +1,67 @@
+{
+  "opencontext": "1.0",
+  "bundle_id": "ocb_3b541a2e1a933b60",
+  "generated_at": "2026-08-09T15:00:00Z",
+  "namespace": "acme",
+  "consumer": {
+    "type": "agent",
+    "id": "support-agent",
+    "roles": [
+      "support"
+    ]
+  },
+  "task": "Handle refund request for ACME",
+  "as_of": "2026-08-09T15:00:00Z",
+  "objects": [
+    {
+      "id": "mission",
+      "type": "mission",
+      "layer": "L0",
+      "title": "Why ACME exists",
+      "content": "ACME exists to make refunds boring.",
+      "authority": "canonical",
+      "trust": "trusted",
+      "owner": "founders",
+      "lifecycle": "current",
+      "classification": "public"
+    }
+  ],
+  "excluded": [
+    {
+      "id": "finance.payroll",
+      "reason": "permission-denied",
+      "detail": "outside the support scope"
+    },
+    {
+      "id": "policies.refunds.v1",
+      "reason": "superseded",
+      "outranked_by": "policies.refunds"
+    }
+  ],
+  "warnings": [
+    {
+      "code": "stale",
+      "message": "procedures.refund is stale.",
+      "id": "procedures.refund",
+      "severity": "warning"
+    }
+  ],
+  "provenance": [
+    {
+      "id": "mission",
+      "canonical_source": true
+    }
+  ],
+  "permissions": [
+    "customer.read",
+    "ticket.write"
+  ],
+  "stats": {
+    "considered": 12,
+    "included": 1,
+    "excluded": 2,
+    "redacted": 0,
+    "characters": 38
+  },
+  "digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
+}

package/fixtures/opencontext/valid/decision.json

@@ -0,0 +1,51 @@
+{
+  "id": "decision.2026-08-09-model-provider",
+  "type": "decision",
+  "layer": "L5",
+  "title": "Default model provider",
+  "authority": "approved",
+  "owner": "platform",
+  "status": "accepted",
+  "decision": "Use provider X as the default runtime.",
+  "rationale": [
+    "latency",
+    "cost",
+    "reliability"
+  ],
+  "alternatives": [
+    {
+      "option": "provider Y",
+      "rejected_because": "no EU region"
+    }
+  ],
+  "consequences": [
+    "Re-evaluate at renewal."
+  ],
+  "approved_by": [
+    {
+      "role": "CTO",
+      "at": "2026-08-09T15:00:00Z"
+    }
+  ],
+  "decided_by": {
+    "type": "human",
+    "id": "cto@acme.example"
+  },
+  "bundle": {
+    "bundle_id": "ocb_3b541a2e1a933b60",
+    "digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "generated_at": "2026-08-09T15:00:00Z"
+  },
+  "created": "2026-08-09T15:00:00Z",
+  "updated": "2026-08-09T15:00:00Z",
+  "durability": "long-lived",
+  "classification": "internal",
+  "canonical_source": true,
+  "references": [
+    "policies.vendor-selection"
+  ],
+  "tags": [
+    "platform"
+  ],
+  "version": 1
+}

package/fixtures/opencontext/valid/diagnostic.json

@@ -0,0 +1,37 @@
+{
+  "opencontext": "1.0",
+  "ok": false,
+  "generated_at": "2026-08-09T15:00:00Z",
+  "namespace": "acme",
+  "score": 91.5,
+  "counts": {
+    "objects": 42,
+    "errors": 1,
+    "warnings": 3,
+    "info": 0,
+    "stale": 3,
+    "expired": 0,
+    "conflicting": 1,
+    "orphaned": 7,
+    "missing_owner": 3,
+    "broken_sources": 1
+  },
+  "findings": [
+    {
+      "code": "duplicate-canonical",
+      "severity": "error",
+      "message": "2 active canonical objects share the id \"policies.refunds\".",
+      "id": "policies.refunds",
+      "ids": [
+        "context/policies/refunds.md",
+        "context/policies/refunds-new.md"
+      ],
+      "file": "context/policies/refunds.md",
+      "line": 3,
+      "field": "authority",
+      "expected": "exactly one canonical object per id",
+      "actual": 2,
+      "remediation": "Supersede the older one, or lower its authority to reference."
+    }
+  ]
+}

package/fixtures/opencontext/valid/manifest-minimal.json

@@ -0,0 +1,4 @@
+{
+  "opencontext": "1.0",
+  "id": "example"
+}

package/fixtures/opencontext/valid/manifest.json

@@ -0,0 +1,134 @@
+{
+  "opencontext": "1.0",
+  "id": "acme",
+  "name": "ACME Corporation",
+  "description": "Every durable thing ACME's humans and agents need to know.",
+  "context": {
+    "mission": "./context/mission.md",
+    "glossary": "./context/glossary.md"
+  },
+  "collections": {
+    "policies": "./context/policies/**",
+    "procedures": {
+      "source": "./context/sops/**",
+      "type": "procedure",
+      "layer": "L4",
+      "owner": "support"
+    }
+  },
+  "roles": {
+    "support": {
+      "description": "Front-line support.",
+      "include": [
+        "mission",
+        "glossary",
+        "policies.*",
+        "procedures.*"
+      ],
+      "exclude": [
+        "policies.internal.*"
+      ],
+      "permissions": [
+        "customer.read",
+        "ticket.write"
+      ],
+      "max_classification": "internal",
+      "redact": [
+        {
+          "path": "customer.ssn",
+          "mode": "remove",
+          "reason": "PII"
+        }
+      ]
+    },
+    "finance": {
+      "include": [
+        "mission",
+        "policies.*"
+      ],
+      "max_classification": "confidential",
+      "inherits": [
+        "support"
+      ]
+    }
+  },
+  "agents": {
+    "support-agent": {
+      "roles": [
+        "support"
+      ],
+      "description": "Handles tickets."
+    }
+  },
+  "authority": {
+    "precedence": [
+      "canonical",
+      "approved",
+      "reference",
+      "observed",
+      "inferred",
+      "historical"
+    ],
+    "tie_breakers": [
+      "version",
+      "updated",
+      "confidence",
+      "id"
+    ]
+  },
+  "freshness": {
+    "default_ttl": "30d",
+    "stale_is_error": false,
+    "exclude_expired": true
+  },
+  "provenance": {
+    "required": true,
+    "digest": "sha256",
+    "require_digest": false
+  },
+  "audit": {
+    "context_reads": true,
+    "context_writes": true,
+    "decisions": true,
+    "sink": "file://./context/.audit/events.ndjson"
+  },
+  "redact": [
+    {
+      "path": "payment.card",
+      "mode": "mask",
+      "replacement": "[REDACTED]"
+    }
+  ],
+  "review": {
+    "interval": "180d",
+    "required_approvers": 2
+  },
+  "adapters": {
+    "https": {
+      "enabled": true,
+      "trust": "untrusted",
+      "timeout_ms": 5000
+    }
+  },
+  "defaults": {
+    "classification": "internal",
+    "trust": "trusted"
+  },
+  "health": {
+    "minimum_score": 90,
+    "fail_on": "error",
+    "require_owner": true,
+    "weights": {
+      "stale": 0.2
+    }
+  },
+  "related": {
+    "prd": "./openprd.yaml",
+    "topology": "./opentopology.yaml"
+  },
+  "extensions": {
+    "com.acme.region": {
+      "primary": "eu-west-1"
+    }
+  }
+}

package/fixtures/opencontext/valid/object-minimal.json

@@ -0,0 +1,4 @@
+{
+  "id": "policy.refunds",
+  "type": "policy"
+}

package/fixtures/opencontext/valid/object-policy.json

@@ -0,0 +1,75 @@
+{
+  "id": "pricing.enterprise",
+  "type": "policy",
+  "layer": "L3",
+  "title": "Enterprise Pricing",
+  "content": "Enterprise plans start at $2,500/month.\n",
+  "content_type": "text/markdown",
+  "authority": "canonical",
+  "trust": "trusted",
+  "owner": "sales",
+  "status": "approved",
+  "version": 3,
+  "created": "2026-07-01T00:00:00Z",
+  "updated": "2026-08-09T00:00:00Z",
+  "valid_from": "2026-08-01T00:00:00Z",
+  "expires": null,
+  "durability": "long-lived",
+  "classification": "internal",
+  "permissions": {
+    "read": [
+      "sales-agent",
+      "finance-agent"
+    ],
+    "write": [
+      "sales-admin"
+    ]
+  },
+  "sources": [
+    {
+      "uri": "crm://pricing/enterprise",
+      "type": "canonical-record",
+      "retrieved_at": "2026-08-09T15:00:00Z",
+      "digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "trust": "verified"
+    }
+  ],
+  "supersedes": [
+    "pricing.enterprise@2"
+  ],
+  "confidence": 1.0,
+  "tags": [
+    "pricing",
+    "enterprise"
+  ],
+  "applies_to": [
+    "sales"
+  ],
+  "references": [
+    "policies.discounts"
+  ],
+  "approval": {
+    "required": true,
+    "roles": [
+      "finance"
+    ],
+    "minimum": 1,
+    "approved_by": [
+      {
+        "role": "finance",
+        "id": "cfo@acme.example",
+        "at": "2026-08-08T10:00:00Z"
+      }
+    ]
+  },
+  "review": {
+    "interval": "180d",
+    "next_review": "2027-02-09",
+    "last_review": "2026-08-09"
+  },
+  "extensions": {
+    "com.acme.risk": {
+      "score": 0.25
+    }
+  }
+}

package/fixtures/opencontext/valid/object-structured.json

@@ -0,0 +1,34 @@
+{
+  "id": "customers.acme",
+  "type": "customer",
+  "layer": "L2",
+  "title": "ACME Inc.",
+  "content": {
+    "name": "ACME Inc.",
+    "plan": "enterprise",
+    "ssn": "000-00-0000",
+    "contacts": [
+      {
+        "name": "Dana",
+        "email": "dana@acme.example"
+      }
+    ]
+  },
+  "content_type": "application/json",
+  "authority": "reference",
+  "owner": "support",
+  "classification": "confidential",
+  "redact": [
+    {
+      "path": "ssn",
+      "mode": "remove"
+    },
+    {
+      "path": "contacts[*].email",
+      "mode": "hash"
+    }
+  ],
+  "canonical_source": true,
+  "durability": "operational",
+  "trust": "verified"
+}

package/fixtures/opencontext/valid/object-untrusted.json

@@ -0,0 +1,19 @@
+{
+  "id": "operations.ticket-4821",
+  "type": "operational",
+  "layer": "L5",
+  "title": "Ticket 4821",
+  "content_uri": "https://support.example.com/tickets/4821",
+  "authority": "observed",
+  "trust": "untrusted",
+  "owner": "support",
+  "durability": "session",
+  "classification": "internal",
+  "sources": [
+    {
+      "uri": "https://support.example.com/tickets/4821",
+      "type": "conversation",
+      "trust": "untrusted"
+    }
+  ]
+}

package/fixtures/opencontext/valid/provenance-canonical.json

@@ -0,0 +1,4 @@
+{
+  "id": "mission",
+  "canonical_source": true
+}

package/fixtures/opencontext/valid/provenance.json

@@ -0,0 +1,14 @@
+{
+  "id": "policies.refunds",
+  "sources": [
+    {
+      "uri": "git://github.com/acme/context/policies/refunds.md",
+      "type": "document",
+      "retrieved_at": "2026-08-09T15:00:00Z",
+      "digest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "trust": "trusted",
+      "author": "support"
+    }
+  ],
+  "retrieved_at": "2026-08-09T15:00:00Z"
+}

package/fixtures/opencontext/valid/role.json

@@ -0,0 +1,38 @@
+{
+  "id": "support",
+  "description": "Front-line customer support.",
+  "include": [
+    "mission",
+    "organization.public",
+    "products.*",
+    "customers.current",
+    "policies.support.*"
+  ],
+  "exclude": [
+    "finance.payroll.*",
+    "legal.privileged.*"
+  ],
+  "permissions": [
+    "customer.read",
+    "ticket.read",
+    "ticket.write"
+  ],
+  "max_classification": "internal",
+  "redact": [
+    {
+      "path": "customer.ssn"
+    },
+    {
+      "path": "payment.card",
+      "mode": "mask"
+    }
+  ],
+  "inherits": [
+    "everyone"
+  ],
+  "extensions": {
+    "com.acme.tier": {
+      "level": 1
+    }
+  }
+}