@logicsrc/schemas 0.1.0

package/schemas/logicsrc-openontology-constraint.schema.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/openontology/constraint.schema.json",
+  "title": "LogicSRC OpenOntology Constraint",
+  "description": "A deterministic validation rule over the knowledge layer. Constraints never require an LLM to decide conformance.",
+  "type": "object",
+  "required": ["openontology", "kind", "id", "description", "rule"],
+  "additionalProperties": false,
+  "properties": {
+    "openontology": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "kind": { "const": "Constraint" },
+    "id": { "type": "string", "minLength": 1 },
+    "description": { "type": "string", "minLength": 1 },
+    "severity": {
+      "type": "string",
+      "enum": ["error", "warning", "info", "policy"],
+      "default": "error"
+    },
+    "code": {
+      "type": "string",
+      "description": "Stable machine-readable code reported on violation, e.g. 'OO-C-REQUIRED-PREDICATE'."
+    },
+    "remediation": { "type": "string", "description": "Hint shown with the violation." },
+    "rule": { "$ref": "#/$defs/rule" },
+    "extensions": { "type": "object" }
+  },
+  "$defs": {
+    "rule": {
+      "type": "object",
+      "required": ["type"],
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "required": ["type", "entityType", "predicate"],
+          "properties": {
+            "type": { "const": "required-predicate" },
+            "entityType": { "type": "string" },
+            "predicate": { "type": "string" }
+          }
+        },
+        {
+          "additionalProperties": false,
+          "required": ["type", "predicate"],
+          "properties": {
+            "type": { "const": "cardinality" },
+            "predicate": { "type": "string" },
+            "entityType": { "type": "string" },
+            "min": { "type": "integer", "minimum": 0 },
+            "max": { "type": "integer", "minimum": 0 }
+          }
+        },
+        {
+          "additionalProperties": false,
+          "required": ["type", "predicate"],
+          "properties": {
+            "type": { "const": "unique" },
+            "predicate": { "type": "string" },
+            "entityType": { "type": "string" },
+            "scope": { "type": "string", "enum": ["ontology", "entity-type"], "default": "ontology" }
+          }
+        },
+        {
+          "additionalProperties": false,
+          "required": ["type", "predicate", "values"],
+          "properties": {
+            "type": { "const": "allowed-values" },
+            "predicate": { "type": "string" },
+            "values": { "type": "array", "items": {}, "minItems": 1 }
+          }
+        },
+        {
+          "additionalProperties": false,
+          "required": ["type", "predicate"],
+          "properties": {
+            "type": { "const": "domain-range" },
+            "predicate": { "type": "string" },
+            "from": { "type": "array", "items": { "type": "string" } },
+            "to": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        {
+          "additionalProperties": false,
+          "required": ["type", "predicate"],
+          "properties": {
+            "type": { "const": "temporal-bounds" },
+            "predicate": { "type": "string" },
+            "notBefore": { "type": "string", "format": "date-time" },
+            "notAfter": { "type": "string", "format": "date-time" },
+            "requireValidFrom": { "type": "boolean" }
+          }
+        },
+        {
+          "additionalProperties": false,
+          "required": ["type", "query"],
+          "properties": {
+            "type": { "const": "query" },
+            "query": { "type": "string", "description": "Saved query id. Any result row is a violation." },
+            "expect": { "type": "string", "enum": ["empty", "non-empty"], "default": "empty" }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/logicsrc-openontology-entity-type.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/openontology/entity-type.schema.json",
+  "title": "LogicSRC OpenOntology Entity Type",
+  "description": "An identity-bearing noun of a domain — the kind of thing an entity is.",
+  "type": "object",
+  "required": ["openontology", "kind", "id", "label", "description"],
+  "additionalProperties": false,
+  "properties": {
+    "openontology": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "kind": { "const": "EntityType" },
+    "id": { "type": "string", "minLength": 1 },
+    "label": { "type": "string", "minLength": 1 },
+    "labels": { "$ref": "#/$defs/languageMap" },
+    "description": { "type": "string", "minLength": 1 },
+    "descriptions": { "$ref": "#/$defs/languageMap" },
+    "extends": {
+      "description": "Parent entity type ids. Inherited properties MUST NOT conflict.",
+      "type": "array",
+      "items": { "type": "string" },
+      "uniqueItems": true
+    },
+    "keyProperties": {
+      "description": "Properties that together identify an entity of this type for resolution and uniqueness checks.",
+      "type": "array",
+      "items": { "type": "string" },
+      "uniqueItems": true
+    },
+    "properties": {
+      "type": "object",
+      "description": "Property name to inline property definition.",
+      "additionalProperties": { "$ref": "#/$defs/propertyDefinition" }
+    },
+    "deprecated": { "type": "boolean", "default": false },
+    "deprecationNote": { "type": "string" },
+    "extensions": { "type": "object" }
+  },
+  "$defs": {
+    "valueType": {
+      "type": "string",
+      "enum": [
+        "string",
+        "number",
+        "integer",
+        "boolean",
+        "date",
+        "date-time",
+        "duration",
+        "url",
+        "email",
+        "enum",
+        "object",
+        "array",
+        "binary-reference",
+        "entity-reference"
+      ]
+    },
+    "propertyDefinition": {
+      "type": "object",
+      "required": ["type"],
+      "additionalProperties": false,
+      "properties": {
+        "label": { "type": "string" },
+        "labels": { "$ref": "#/$defs/languageMap" },
+        "description": { "type": "string" },
+        "descriptions": { "$ref": "#/$defs/languageMap" },
+        "type": { "$ref": "#/$defs/valueType" },
+        "items": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "type": { "$ref": "#/$defs/valueType" },
+            "entityType": { "type": "string" },
+            "enum": { "type": "array", "items": {} }
+          }
+        },
+        "entityType": {
+          "anyOf": [
+            { "type": "string" },
+            { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+          ]
+        },
+        "required": { "type": "boolean", "default": false },
+        "cardinality": { "type": "string", "enum": ["one", "many"], "default": "one" },
+        "unique": { "type": "boolean", "default": false },
+        "default": {},
+        "examples": { "type": "array", "items": {} },
+        "enum": { "type": "array", "items": {} },
+        "pattern": { "type": "string" },
+        "minimum": { "type": "number" },
+        "maximum": { "type": "number" },
+        "minLength": { "type": "integer", "minimum": 0 },
+        "maxLength": { "type": "integer", "minimum": 0 },
+        "deprecated": { "type": "boolean", "default": false },
+        "deprecationNote": { "type": "string" },
+        "extensions": { "type": "object" }
+      }
+    },
+    "languageMap": {
+      "type": "object",
+      "patternProperties": {
+        "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$": { "type": "string" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/logicsrc-openontology-entity.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/openontology/entity.schema.json",
+  "title": "LogicSRC OpenOntology Entity",
+  "description": "A specific thing with a stable identity. Entity ids never change when display names or aliases change; deletion is expressed as tombstone/archived/superseded state, never erasure.",
+  "type": "object",
+  "required": ["openontology", "kind", "id", "type", "canonicalName", "createdAt", "createdBy"],
+  "additionalProperties": false,
+  "properties": {
+    "openontology": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "kind": { "const": "Entity" },
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Stable id. Package-qualified compact form (prefix:type:slug), an http(s) IRI, or a urn:logicsrc: identifier."
+    },
+    "type": { "type": "string", "minLength": 1, "description": "Entity type id." },
+    "canonicalName": { "type": "string", "minLength": 1 },
+    "labels": { "$ref": "#/$defs/languageMap" },
+    "aliases": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "externalIds": {
+      "type": "object",
+      "description": "Namespaced external identifiers (github, wikidata, orcid, did, ...). External services are never treated as canonical identity authorities.",
+      "additionalProperties": { "type": "string" }
+    },
+    "status": {
+      "type": "string",
+      "enum": ["active", "archived", "tombstone", "superseded", "merged"],
+      "default": "active"
+    },
+    "supersededBy": {
+      "type": "string",
+      "description": "Entity id that replaced this one after a merge. Old ids remain resolvable as redirects."
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "createdBy": { "type": "string", "minLength": 1 },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "visibility": {
+      "type": "string",
+      "enum": ["public", "internal", "private"],
+      "default": "public"
+    },
+    "tags": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+    "extensions": { "type": "object" }
+  },
+  "$defs": {
+    "languageMap": {
+      "type": "object",
+      "patternProperties": {
+        "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$": { "type": "string" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/logicsrc-openontology-event.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/openontology/event.schema.json",
+  "title": "LogicSRC OpenOntology Event",
+  "description": "An append-only audit record. Every applied change emits at least one event, attributable to an actor, a policy decision, and a resulting revision.",
+  "type": "object",
+  "required": ["openontology", "kind", "id", "type", "at", "actor"],
+  "additionalProperties": false,
+  "properties": {
+    "openontology": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "kind": { "const": "Event" },
+    "id": { "type": "string", "minLength": 1 },
+    "type": {
+      "type": "string",
+      "enum": [
+        "package.validated",
+        "entity.proposed",
+        "entity.added",
+        "entity.merged",
+        "entity.archived",
+        "claim.proposed",
+        "claim.asserted",
+        "claim.disputed",
+        "claim.retracted",
+        "claim.superseded",
+        "changeset.created",
+        "changeset.reviewed",
+        "changeset.approved",
+        "changeset.rejected",
+        "changeset.applied",
+        "import.completed",
+        "export.completed",
+        "constraint.violated",
+        "action.executed",
+        "schema.migrated"
+      ]
+    },
+    "ontology": { "type": "string" },
+    "at": { "type": "string", "format": "date-time" },
+    "actor": { "type": "string", "minLength": 1 },
+    "actorType": { "type": "string", "enum": ["human", "service", "agent"] },
+    "client": { "type": "string" },
+    "requestId": { "type": "string" },
+    "runId": { "type": "string" },
+    "changeSet": { "type": "string" },
+    "subject": { "type": "string", "description": "Primary object id the event concerns." },
+    "revision": { "type": "string" },
+    "policyDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "rule": { "type": "string" },
+        "decision": { "type": "string", "enum": ["allow", "deny", "require-approval"] },
+        "reason": { "type": "string" }
+      }
+    },
+    "data": { "type": "object", "description": "Event-specific payload. Redacted per policy." },
+    "extensions": { "type": "object" }
+  }
+}

package/schemas/logicsrc-openontology-evidence.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/openontology/evidence.schema.json",
+  "title": "LogicSRC OpenOntology Evidence",
+  "description": "A machine-readable pointer into a source that supports a claim. Excerpts are optional and bounded by source licensing, privacy, and configured excerpt limits.",
+  "type": "object",
+  "required": ["openontology", "kind", "id", "source", "selector"],
+  "additionalProperties": false,
+  "properties": {
+    "openontology": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "kind": { "const": "Evidence" },
+    "id": { "type": "string", "minLength": 1 },
+    "source": { "type": "string", "minLength": 1, "description": "Source id." },
+    "selector": { "$ref": "#/$defs/selector" },
+    "excerpt": {
+      "type": "string",
+      "description": "Optional short excerpt. Omitted when licensing, privacy, or excerpt limits forbid it."
+    },
+    "contentHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "visibility": {
+      "type": "string",
+      "enum": ["public", "internal", "private"],
+      "default": "public"
+    },
+    "extensions": { "type": "object" }
+  },
+  "$defs": {
+    "selector": {
+      "type": "object",
+      "required": ["type"],
+      "description": "One selector shape per source medium.",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "line-range" },
+            "start": { "type": "integer", "minimum": 1 },
+            "end": { "type": "integer", "minimum": 1 },
+            "path": { "type": "string" }
+          },
+          "required": ["type", "start", "end"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "page" },
+            "page": { "type": "integer", "minimum": 1 }
+          },
+          "required": ["type", "page"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "time-range" },
+            "start": { "type": "number", "minimum": 0 },
+            "end": { "type": "number", "minimum": 0 }
+          },
+          "required": ["type", "start", "end"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "json-pointer" },
+            "pointer": { "type": "string" }
+          },
+          "required": ["type", "pointer"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "xpath" },
+            "expression": { "type": "string" }
+          },
+          "required": ["type", "expression"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "css-selector" },
+            "expression": { "type": "string" }
+          },
+          "required": ["type", "expression"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "database-key" },
+            "table": { "type": "string" },
+            "key": { "type": "string" }
+          },
+          "required": ["type", "key"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "commit-path" },
+            "path": { "type": "string" },
+            "commit": { "type": "string" }
+          },
+          "required": ["type", "path"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "api-field" },
+            "field": { "type": "string" },
+            "endpoint": { "type": "string" }
+          },
+          "required": ["type", "field"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "whole-document" }
+          },
+          "required": ["type"]
+        }
+      ]
+    }
+  }
+}

package/schemas/logicsrc-openontology-manifest.schema.json

@@ -0,0 +1,148 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/openontology/manifest.schema.json",
+  "title": "LogicSRC OpenOntology Package Manifest",
+  "description": "The openontology.yaml (or canonical JSON equivalent) that opens every OpenOntology package. Declares identity, namespace, license, maintainers, imports, and the schema/data files that make up the package.",
+  "type": "object",
+  "required": [
+    "openontology",
+    "kind",
+    "id",
+    "name",
+    "version",
+    "namespace",
+    "description",
+    "license",
+    "maintainers"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "openontology": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+(\\.\\d+)?$",
+      "description": "OpenOntology standard version this package conforms to, e.g. '0.1'."
+    },
+    "kind": { "const": "OntologyPackage" },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "description": "Lowercase kebab-case package id, globally disambiguated by namespace when imported."
+    },
+    "name": { "type": "string", "minLength": 1 },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[0-9A-Za-z.-]+)?(\\+[0-9A-Za-z.-]+)?$",
+      "description": "Semantic version."
+    },
+    "namespace": {
+      "type": "string",
+      "format": "uri",
+      "description": "Base IRI that compact package-qualified ids canonicalize against."
+    },
+    "description": { "type": "string", "minLength": 1 },
+    "license": {
+      "type": "string",
+      "minLength": 1,
+      "description": "SPDX identifier, license URL, or the literal 'unknown'."
+    },
+    "maintainers": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/maintainer" }
+    },
+    "imports": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/import" },
+      "description": "Other ontology packages imported by immutable version or digest."
+    },
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Relative paths (or inline arrays) for each schema-layer file.",
+      "properties": {
+        "namespaces": { "$ref": "#/$defs/fileOrInline" },
+        "entityTypes": { "$ref": "#/$defs/fileOrInline" },
+        "properties": { "$ref": "#/$defs/fileOrInline" },
+        "relationships": { "$ref": "#/$defs/fileOrInline" },
+        "constraints": { "$ref": "#/$defs/fileOrInline" },
+        "queries": { "$ref": "#/$defs/fileOrInline" },
+        "actions": { "$ref": "#/$defs/fileOrInline" }
+      }
+    },
+    "data": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Relative paths (or inline arrays) for each knowledge-layer file.",
+      "properties": {
+        "entities": { "$ref": "#/$defs/fileOrInline" },
+        "claims": { "$ref": "#/$defs/fileOrInline" },
+        "sources": { "$ref": "#/$defs/fileOrInline" },
+        "evidence": { "$ref": "#/$defs/fileOrInline" }
+      }
+    },
+    "context": {
+      "type": "string",
+      "description": "Relative path to the package's JSON-LD 1.1 context document."
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$",
+      "description": "Content digest over the canonical manifest and every declared file. Present on published packages."
+    },
+    "signatures": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/signature" },
+      "description": "Detached maintainer signatures over the package digest."
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Namespaced extension point. Keys SHOULD be prefixed to avoid collisions."
+    }
+  },
+  "$defs": {
+    "maintainer": {
+      "type": "object",
+      "required": ["id"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "URI-shaped identity: mailto:, did:, https:, or urn:."
+        },
+        "name": { "type": "string" }
+      }
+    },
+    "import": {
+      "type": "object",
+      "required": ["id"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+        "version": { "type": "string" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "namespace": { "type": "string", "format": "uri" },
+        "prefix": { "type": "string" }
+      }
+    },
+    "fileOrInline": {
+      "anyOf": [
+        { "type": "string", "minLength": 1 },
+        { "type": "array", "items": { "type": "object" } }
+      ]
+    },
+    "signature": {
+      "type": "object",
+      "required": ["algorithm", "signer", "value"],
+      "additionalProperties": false,
+      "description": "Pluggable signature envelope. 'jws-ed25519' is the minimal profile every implementation SHOULD understand.",
+      "properties": {
+        "algorithm": { "type": "string", "minLength": 1 },
+        "signer": { "type": "string", "minLength": 1 },
+        "value": { "type": "string", "minLength": 1 },
+        "created": { "type": "string", "format": "date-time" },
+        "keyId": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/logicsrc-openontology-namespace.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/openontology/namespace.schema.json",
+  "title": "LogicSRC OpenOntology Namespace",
+  "description": "A prefix binding used to disambiguate ids and to canonicalize compact package-qualified ids into resolvable IRIs.",
+  "type": "object",
+  "required": ["openontology", "kind", "prefix", "uri"],
+  "additionalProperties": false,
+  "properties": {
+    "openontology": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "kind": { "const": "Namespace" },
+    "prefix": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "description": "Compact prefix, e.g. 'ethereum' in 'ethereum:person:alice'."
+    },
+    "uri": { "type": "string", "format": "uri" },
+    "description": { "type": "string" },
+    "extensions": { "type": "object" }
+  }
+}