@logicsrc/schemas 0.1.0

package/fixtures/openontology/conformance.json

@@ -0,0 +1,158 @@
+{
+  "openontologyConformance": "0.1",
+  "description": "Conformance fixtures for LogicSRC OpenOntology. A third-party implementation can run these against the published JSON Schemas with no LogicSRC code: every valid fixture must validate, every invalid fixture must fail.",
+  "valid": [
+    {
+      "fixture": "valid/manifest.json",
+      "kind": "openontology-manifest"
+    },
+    {
+      "fixture": "valid/namespace.json",
+      "kind": "openontology-namespace"
+    },
+    {
+      "fixture": "valid/entity-type.json",
+      "kind": "openontology-entity-type"
+    },
+    {
+      "fixture": "valid/property.json",
+      "kind": "openontology-property"
+    },
+    {
+      "fixture": "valid/relationship-type.json",
+      "kind": "openontology-relationship-type"
+    },
+    {
+      "fixture": "valid/constraint.json",
+      "kind": "openontology-constraint"
+    },
+    {
+      "fixture": "valid/query.json",
+      "kind": "openontology-query"
+    },
+    {
+      "fixture": "valid/query-adhoc.json",
+      "kind": "openontology-query"
+    },
+    {
+      "fixture": "valid/action.json",
+      "kind": "openontology-action"
+    },
+    {
+      "fixture": "valid/entity.json",
+      "kind": "openontology-entity"
+    },
+    {
+      "fixture": "valid/claim-relationship.json",
+      "kind": "openontology-claim"
+    },
+    {
+      "fixture": "valid/claim-value.json",
+      "kind": "openontology-claim"
+    },
+    {
+      "fixture": "valid/source.json",
+      "kind": "openontology-source"
+    },
+    {
+      "fixture": "valid/evidence.json",
+      "kind": "openontology-evidence"
+    },
+    {
+      "fixture": "valid/changeset.json",
+      "kind": "openontology-changeset"
+    },
+    {
+      "fixture": "valid/review.json",
+      "kind": "openontology-review"
+    },
+    {
+      "fixture": "valid/approval.json",
+      "kind": "openontology-approval"
+    },
+    {
+      "fixture": "valid/event.json",
+      "kind": "openontology-event"
+    }
+  ],
+  "invalid": [
+    {
+      "fixture": "invalid/claim-both-objects.json",
+      "kind": "openontology-claim",
+      "mustFail": true,
+      "reason": "A claim object carries an entity reference or a typed value, never both."
+    },
+    {
+      "fixture": "invalid/claim-unknown-status.json",
+      "kind": "openontology-claim",
+      "mustFail": true,
+      "reason": "status must be one of the six declared claim states."
+    },
+    {
+      "fixture": "invalid/claim-confidence-out-of-range.json",
+      "kind": "openontology-claim",
+      "mustFail": true,
+      "reason": "confidence must be between 0 and 1."
+    },
+    {
+      "fixture": "invalid/claim-extra-property.json",
+      "kind": "openontology-claim",
+      "mustFail": true,
+      "reason": "Undeclared properties are rejected; extensions must go in the namespaced extensions object."
+    },
+    {
+      "fixture": "invalid/entity-missing-canonical-name.json",
+      "kind": "openontology-entity",
+      "mustFail": true,
+      "reason": "canonicalName is required on every entity."
+    },
+    {
+      "fixture": "invalid/manifest-no-maintainer.json",
+      "kind": "openontology-manifest",
+      "mustFail": true,
+      "reason": "At least one maintainer is required."
+    },
+    {
+      "fixture": "invalid/manifest-bad-version.json",
+      "kind": "openontology-manifest",
+      "mustFail": true,
+      "reason": "Package versions must be semantic versions."
+    },
+    {
+      "fixture": "invalid/manifest-bad-id.json",
+      "kind": "openontology-manifest",
+      "mustFail": true,
+      "reason": "Package ids are lowercase kebab-case."
+    },
+    {
+      "fixture": "invalid/relationship-no-range.json",
+      "kind": "openontology-relationship-type",
+      "mustFail": true,
+      "reason": "A relationship type must declare at least one allowed object type."
+    },
+    {
+      "fixture": "invalid/evidence-unknown-selector.json",
+      "kind": "openontology-evidence",
+      "mustFail": true,
+      "reason": "Evidence selectors must use one of the declared machine-readable shapes."
+    },
+    {
+      "fixture": "invalid/changeset-empty-operations.json",
+      "kind": "openontology-changeset",
+      "mustFail": true,
+      "reason": "A change set must contain at least one operation."
+    },
+    {
+      "fixture": "invalid/changeset-unknown-op.json",
+      "kind": "openontology-changeset",
+      "mustFail": true,
+      "reason": "Hard deletion is not an operation; use retract-claim or archive-entity."
+    },
+    {
+      "fixture": "invalid/action-no-permissions.json",
+      "kind": "openontology-action",
+      "mustFail": true,
+      "reason": "Actions must declare the scopes they require."
+    }
+  ]
+}

package/fixtures/openontology/invalid/action-no-permissions.json

@@ -0,0 +1,13 @@
+{
+  "openontology": "0.1",
+  "kind": "Action",
+  "id": "doThing",
+  "label": "Do thing",
+  "executor": {
+    "type": "http",
+    "endpoint": "https://example.org/do"
+  },
+  "approval": {
+    "mode": "none"
+  }
+}

package/fixtures/openontology/invalid/changeset-empty-operations.json

@@ -0,0 +1,10 @@
+{
+  "openontology": "0.1",
+  "kind": "ChangeSet",
+  "id": "changeset:bad",
+  "title": "Nothing",
+  "createdAt": "2026-07-26T00:00:00Z",
+  "createdBy": "curator",
+  "operations": [],
+  "status": "proposed"
+}

package/fixtures/openontology/invalid/changeset-unknown-op.json

@@ -0,0 +1,15 @@
+{
+  "openontology": "0.1",
+  "kind": "ChangeSet",
+  "id": "changeset:bad2",
+  "title": "Delete everything",
+  "createdAt": "2026-07-26T00:00:00Z",
+  "createdBy": "curator",
+  "operations": [
+    {
+      "op": "delete-claim",
+      "target": "ex:claim:0001"
+    }
+  ],
+  "status": "proposed"
+}

package/fixtures/openontology/invalid/claim-both-objects.json

@@ -0,0 +1,14 @@
+{
+  "openontology": "0.1",
+  "kind": "Claim",
+  "id": "ex:claim:bad",
+  "subject": "ex:person:alice",
+  "predicate": "worksOn",
+  "object": {
+    "entity": "ex:project:zk",
+    "value": "ZK"
+  },
+  "status": "asserted",
+  "assertedAt": "2026-07-26T00:00:00Z",
+  "assertedBy": "curator"
+}

package/fixtures/openontology/invalid/claim-confidence-out-of-range.json

@@ -0,0 +1,14 @@
+{
+  "openontology": "0.1",
+  "kind": "Claim",
+  "id": "ex:claim:bad3",
+  "subject": "ex:person:alice",
+  "predicate": "worksOn",
+  "object": {
+    "entity": "ex:project:zk"
+  },
+  "status": "asserted",
+  "confidence": 1.4,
+  "assertedAt": "2026-07-26T00:00:00Z",
+  "assertedBy": "curator"
+}

package/fixtures/openontology/invalid/claim-extra-property.json

@@ -0,0 +1,14 @@
+{
+  "openontology": "0.1",
+  "kind": "Claim",
+  "id": "ex:claim:bad4",
+  "subject": "ex:person:alice",
+  "predicate": "worksOn",
+  "object": {
+    "entity": "ex:project:zk"
+  },
+  "status": "asserted",
+  "assertedAt": "2026-07-26T00:00:00Z",
+  "assertedBy": "curator",
+  "chainOfThought": "first I considered..."
+}

package/fixtures/openontology/invalid/claim-unknown-status.json

@@ -0,0 +1,13 @@
+{
+  "openontology": "0.1",
+  "kind": "Claim",
+  "id": "ex:claim:bad2",
+  "subject": "ex:person:alice",
+  "predicate": "worksOn",
+  "object": {
+    "entity": "ex:project:zk"
+  },
+  "status": "probably",
+  "assertedAt": "2026-07-26T00:00:00Z",
+  "assertedBy": "curator"
+}

package/fixtures/openontology/invalid/entity-missing-canonical-name.json

@@ -0,0 +1,8 @@
+{
+  "openontology": "0.1",
+  "kind": "Entity",
+  "id": "ex:person:bob",
+  "type": "Person",
+  "createdAt": "2026-07-26T00:00:00Z",
+  "createdBy": "curator"
+}

package/fixtures/openontology/invalid/evidence-unknown-selector.json

@@ -0,0 +1,10 @@
+{
+  "openontology": "0.1",
+  "kind": "Evidence",
+  "id": "ex:evidence:bad",
+  "source": "ex:source:repo",
+  "selector": {
+    "type": "vibes",
+    "hint": "somewhere in the file"
+  }
+}

package/fixtures/openontology/invalid/manifest-bad-id.json

@@ -0,0 +1,15 @@
+{
+  "openontology": "0.1",
+  "kind": "OntologyPackage",
+  "id": "Example_Ontology",
+  "name": "Example",
+  "version": "0.1.0",
+  "namespace": "https://logicsrc.com/ontology/example/",
+  "description": "Id is not kebab-case.",
+  "license": "CC-BY-4.0",
+  "maintainers": [
+    {
+      "id": "mailto:c@example.org"
+    }
+  ]
+}

package/fixtures/openontology/invalid/manifest-bad-version.json

@@ -0,0 +1,15 @@
+{
+  "openontology": "0.1",
+  "kind": "OntologyPackage",
+  "id": "example-ontology",
+  "name": "Example",
+  "version": "v1",
+  "namespace": "https://logicsrc.com/ontology/example/",
+  "description": "Version is not semver.",
+  "license": "CC-BY-4.0",
+  "maintainers": [
+    {
+      "id": "mailto:c@example.org"
+    }
+  ]
+}

package/fixtures/openontology/invalid/manifest-no-maintainer.json

@@ -0,0 +1,11 @@
+{
+  "openontology": "0.1",
+  "kind": "OntologyPackage",
+  "id": "example-ontology",
+  "name": "Example",
+  "version": "0.1.0",
+  "namespace": "https://logicsrc.com/ontology/example/",
+  "description": "Missing maintainers.",
+  "license": "CC-BY-4.0",
+  "maintainers": []
+}

package/fixtures/openontology/invalid/relationship-no-range.json

@@ -0,0 +1,11 @@
+{
+  "openontology": "0.1",
+  "kind": "RelationshipType",
+  "id": "worksOn",
+  "label": "works on",
+  "description": "Missing to.",
+  "from": [
+    "Person"
+  ],
+  "to": []
+}

package/fixtures/openontology/valid/action.json

@@ -0,0 +1,29 @@
+{
+  "openontology": "0.1",
+  "kind": "Action",
+  "id": "createProjectReviewTask",
+  "label": "Create project review task",
+  "input": {
+    "project": {
+      "entityType": "Project",
+      "required": true
+    }
+  },
+  "executor": {
+    "type": "logicsrc-plugin-tool",
+    "plugin": "commandboard",
+    "tool": "task.create"
+  },
+  "permissions": {
+    "required": [
+      "ontology:action:execute"
+    ]
+  },
+  "approval": {
+    "mode": "policy"
+  },
+  "sideEffects": [
+    "creates-task",
+    "emits-event"
+  ]
+}

package/fixtures/openontology/valid/approval.json

@@ -0,0 +1,12 @@
+{
+  "openontology": "0.1",
+  "kind": "Approval",
+  "id": "approval:0001",
+  "changeSet": "changeset:0001",
+  "approver": "mailto:curator@example.org",
+  "approverType": "human",
+  "scopes": [
+    "ontology:changeset:approve"
+  ],
+  "createdAt": "2026-07-26T00:00:00Z"
+}

package/fixtures/openontology/valid/changeset.json

@@ -0,0 +1,34 @@
+{
+  "openontology": "0.1",
+  "kind": "ChangeSet",
+  "id": "changeset:0001",
+  "ontology": "example-ontology@0.1.0",
+  "title": "Add Alice as a contributor",
+  "rationale": "Repository activity identifies the contribution.",
+  "createdAt": "2026-07-26T00:00:00Z",
+  "createdBy": "agent:research-mapper",
+  "actorType": "agent",
+  "runId": "run_01J3EXAMPLE",
+  "operations": [
+    {
+      "op": "add-entity",
+      "value": {
+        "id": "ex:person:alice",
+        "type": "Person",
+        "canonicalName": "Alice Reyes"
+      }
+    },
+    {
+      "op": "assert-claim",
+      "value": {
+        "subject": "ex:person:alice",
+        "predicate": "worksOn",
+        "object": {
+          "entity": "ex:project:zk"
+        }
+      }
+    }
+  ],
+  "requiredApprovals": 1,
+  "status": "proposed"
+}

package/fixtures/openontology/valid/claim-relationship.json

@@ -0,0 +1,23 @@
+{
+  "openontology": "0.1",
+  "kind": "Claim",
+  "id": "ex:claim:0001",
+  "ontology": "example-ontology@0.1.0",
+  "subject": "ex:person:alice",
+  "predicate": "worksOn",
+  "object": {
+    "entity": "ex:project:zk"
+  },
+  "status": "asserted",
+  "confidence": 0.94,
+  "validTime": {
+    "from": "2026-04-01T00:00:00Z",
+    "to": null
+  },
+  "assertedAt": "2026-07-26T00:00:00Z",
+  "assertedBy": "agent:research-mapper",
+  "runId": "run_01J3EXAMPLE",
+  "sources": [
+    "ex:source:repo"
+  ]
+}

package/fixtures/openontology/valid/claim-value.json

@@ -0,0 +1,15 @@
+{
+  "openontology": "0.1",
+  "kind": "Claim",
+  "id": "ex:claim:0002",
+  "subject": "ex:project:zk",
+  "predicate": "homepage",
+  "object": {
+    "value": "https://example.org/zk",
+    "datatype": "url"
+  },
+  "status": "asserted",
+  "assertedAt": "2026-07-26T00:00:00Z",
+  "assertedBy": "mailto:curator@example.org",
+  "firstParty": true
+}

package/fixtures/openontology/valid/constraint.json

@@ -0,0 +1,12 @@
+{
+  "openontology": "0.1",
+  "kind": "Constraint",
+  "id": "project-has-homepage",
+  "description": "Projects should record a homepage.",
+  "severity": "warning",
+  "rule": {
+    "type": "required-predicate",
+    "entityType": "Project",
+    "predicate": "homepage"
+  }
+}

package/fixtures/openontology/valid/entity-type.json

@@ -0,0 +1,16 @@
+{
+  "openontology": "0.1",
+  "kind": "EntityType",
+  "id": "Person",
+  "label": "Person",
+  "description": "A human participant.",
+  "keyProperties": [
+    "canonicalName"
+  ],
+  "properties": {
+    "role": {
+      "type": "string",
+      "required": false
+    }
+  }
+}

package/fixtures/openontology/valid/entity.json

@@ -0,0 +1,16 @@
+{
+  "openontology": "0.1",
+  "kind": "Entity",
+  "id": "ex:person:alice",
+  "type": "Person",
+  "canonicalName": "Alice Reyes",
+  "aliases": [
+    "alice.eth"
+  ],
+  "externalIds": {
+    "github": "alice"
+  },
+  "status": "active",
+  "createdAt": "2026-07-26T00:00:00Z",
+  "createdBy": "mailto:curator@example.org"
+}

package/fixtures/openontology/valid/event.json

@@ -0,0 +1,17 @@
+{
+  "openontology": "0.1",
+  "kind": "Event",
+  "id": "event:0001",
+  "type": "changeset.applied",
+  "ontology": "example-ontology",
+  "at": "2026-07-26T00:00:00Z",
+  "actor": "mailto:curator@example.org",
+  "actorType": "human",
+  "changeSet": "changeset:0001",
+  "revision": "data-000042",
+  "policyDecision": {
+    "rule": "apply.scope",
+    "decision": "allow",
+    "reason": "Actor holds ontology:claim:write"
+  }
+}

package/fixtures/openontology/valid/evidence.json

@@ -0,0 +1,12 @@
+{
+  "openontology": "0.1",
+  "kind": "Evidence",
+  "id": "ex:evidence:0001",
+  "source": "ex:source:repo",
+  "selector": {
+    "type": "line-range",
+    "start": 41,
+    "end": 48
+  },
+  "excerpt": "Alice authored the prover module."
+}

package/fixtures/openontology/valid/manifest.json

@@ -0,0 +1,21 @@
+{
+  "openontology": "0.1",
+  "kind": "OntologyPackage",
+  "id": "example-ontology",
+  "name": "Example Ontology",
+  "version": "0.1.0",
+  "namespace": "https://logicsrc.com/ontology/example/",
+  "description": "A minimal conforming package manifest.",
+  "license": "CC-BY-4.0",
+  "maintainers": [
+    {
+      "id": "mailto:curator@example.org"
+    }
+  ],
+  "schema": {
+    "entityTypes": "schema/entity-types.yaml"
+  },
+  "data": {
+    "entities": "data/entities.ndjson"
+  }
+}

package/fixtures/openontology/valid/namespace.json

@@ -0,0 +1,7 @@
+{
+  "openontology": "0.1",
+  "kind": "Namespace",
+  "prefix": "ex",
+  "uri": "https://logicsrc.com/ontology/example/",
+  "description": "Compact prefix for the example package."
+}

package/fixtures/openontology/valid/property.json

@@ -0,0 +1,8 @@
+{
+  "openontology": "0.1",
+  "kind": "Property",
+  "id": "homepage",
+  "label": "homepage",
+  "description": "Canonical URL.",
+  "type": "url"
+}

package/fixtures/openontology/valid/query-adhoc.json

@@ -0,0 +1,16 @@
+{
+  "openontologyQuery": "0.1",
+  "ontology": "example-ontology@0.1.0",
+  "match": [
+    {
+      "subject": "?person",
+      "predicate": "worksOn",
+      "object": "ex:project:zk"
+    }
+  ],
+  "select": [
+    "?person"
+  ],
+  "asOf": "2026-07-26T00:00:00Z",
+  "limit": 100
+}

package/fixtures/openontology/valid/query.json

@@ -0,0 +1,24 @@
+{
+  "openontology": "0.1",
+  "kind": "SavedQuery",
+  "id": "contributors",
+  "description": "People working on a project.",
+  "query": {
+    "match": [
+      {
+        "subject": "?person",
+        "predicate": "worksOn",
+        "object": "?project"
+      }
+    ],
+    "select": [
+      "?person",
+      "?project"
+    ],
+    "include": {
+      "claimStatus": [
+        "asserted"
+      ]
+    }
+  }
+}

package/fixtures/openontology/valid/relationship-type.json

@@ -0,0 +1,16 @@
+{
+  "openontology": "0.1",
+  "kind": "RelationshipType",
+  "id": "worksOn",
+  "label": "works on",
+  "description": "A person contributes work to a project.",
+  "from": [
+    "Person"
+  ],
+  "to": [
+    "Project"
+  ],
+  "cardinality": "many-to-many",
+  "temporal": true,
+  "inverse": "hasContributor"
+}

package/fixtures/openontology/valid/review.json

@@ -0,0 +1,17 @@
+{
+  "openontology": "0.1",
+  "kind": "Review",
+  "id": "review:0001",
+  "changeSet": "changeset:0001",
+  "reviewer": "mailto:curator@example.org",
+  "state": "changes-requested",
+  "comment": "Second operation lacks a source.",
+  "createdAt": "2026-07-26T00:00:00Z",
+  "operationDecisions": [
+    {
+      "index": 1,
+      "decision": "reject",
+      "comment": "no evidence"
+    }
+  ]
+}