@adammcarter/use-cases 0.1.0

package/packages/core/dist/schemas/v1/evidence-status-result.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/evidence-status-result.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "const": 1 },
+    "complete": { "type": "boolean" },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "state": { "enum": ["clean", "partial", "unusable"] },
+        "unknown_scope_damage": { "type": "boolean" },
+        "invalid_aggregate_count": { "type": "integer", "minimum": 0 },
+        "torn_tail_count": { "type": "integer", "minimum": 0 }
+      },
+      "required": ["state", "unknown_scope_damage", "invalid_aggregate_count", "torn_tail_count"]
+    },
+    "ledgers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "complete": { "type": "boolean" },
+          "events_loaded": { "type": "integer", "minimum": 0 },
+          "torn_tail": { "type": "boolean" },
+          "unknown_scope_damage": { "type": "boolean" }
+        },
+        "required": ["path", "complete", "events_loaded", "torn_tail", "unknown_scope_damage"]
+      }
+    },
+    "aggregates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "evidence_id": { "$ref": "common.schema.json#/$defs/id" },
+          "status": { "enum": ["active", "voided", "invalidated", "superseded", "invalid"] },
+          "event_ids": {
+            "type": "array",
+            "items": { "$ref": "common.schema.json#/$defs/id" }
+          },
+          "target_links": { "type": "array" },
+          "assurance": { "type": "object" },
+          "freshness_inputs": { "type": "object" }
+        },
+        "required": ["evidence_id", "status", "event_ids", "target_links", "assurance", "freshness_inputs"]
+      }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "ledgers": { "type": "integer", "minimum": 0 },
+        "events_loaded": { "type": "integer", "minimum": 0 },
+        "aggregates_total": { "type": "integer", "minimum": 0 },
+        "aggregates_active": { "type": "integer", "minimum": 0 },
+        "aggregates_invalid": { "type": "integer", "minimum": 0 }
+      },
+      "required": ["ledgers", "events_loaded", "aggregates_total", "aggregates_active", "aggregates_invalid"]
+    }
+  },
+  "required": ["schema_version", "complete", "integrity", "ledgers", "aggregates", "counts"]
+}

package/packages/core/dist/schemas/v1/host-profile.schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/host-profile.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "const": 1 },
+    "profile_id": { "$ref": "common.schema.json#/$defs/id" },
+    "host": { "enum": ["claude", "codex", "copilot", "opencode"] },
+    "surface": { "$ref": "common.schema.json#/$defs/host_surface" },
+    "profile_version": { "type": "integer", "minimum": 1 },
+    "host_version": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "min": { "type": ["string", "null"] },
+        "tested": { "type": ["string", "null"] },
+        "notes": { "type": ["string", "null"] }
+      },
+      "required": ["min", "tested", "notes"]
+    },
+    "os_runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "supported": {
+          "type": "array",
+          "items": { "enum": ["darwin", "linux", "windows", "unknown"] }
+        }
+      },
+      "required": ["supported"]
+    },
+    "installation_mode": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "expected": { "type": "string", "minLength": 1 }
+      },
+      "required": ["expected"]
+    },
+    "permission_mode": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "expected": { "type": "string", "minLength": 1 }
+      },
+      "required": ["expected"]
+    },
+    "expected_capabilities": {
+      "type": "object",
+      "additionalProperties": { "enum": ["required", "optional", "unsupported"] }
+    },
+    "projection_targets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "kind": { "enum": ["activation_stub", "skill_stub"] },
+          "path": { "type": "string", "minLength": 1 },
+          "managed": { "type": "boolean" },
+          "content_policy": { "enum": ["thin_stub", "full_copy_required"] }
+        },
+        "required": ["kind", "path", "managed", "content_policy"]
+      }
+    },
+    "known_limitations": { "type": "array", "items": { "type": "string" } },
+    "doctor_checks": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "conformance_checks": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "extensions": { "$ref": "common.schema.json#/$defs/extensions" }
+  },
+  "required": [
+    "schema_version",
+    "profile_id",
+    "host",
+    "surface",
+    "profile_version",
+    "host_version",
+    "os_runtime",
+    "installation_mode",
+    "permission_mode",
+    "expected_capabilities",
+    "projection_targets",
+    "doctor_checks",
+    "conformance_checks",
+    "known_limitations"
+  ]
+}

package/packages/core/dist/schemas/v1/host-status-result.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/host-status-result.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "const": 1 },
+    "status": {
+      "enum": [
+        "expected",
+        "installed",
+        "projected",
+        "conformant_static",
+        "verified_with_evidence",
+        "partial_with_evidence",
+        "blocked",
+        "unsupported",
+        "not_tested"
+      ]
+    },
+    "profile_id": { "$ref": "common.schema.json#/$defs/id" },
+    "host_surface": { "$ref": "common.schema.json#/$defs/host_surface" },
+    "host_version": { "type": "string", "minLength": 1 },
+    "environment": { "type": "object" },
+    "evidence_event_ids": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/id" }
+    },
+    "assessed_at": { "$ref": "common.schema.json#/$defs/timestamp" },
+    "extensions": { "$ref": "common.schema.json#/$defs/extensions" }
+  },
+  "required": ["schema_version", "status", "profile_id", "host_surface", "host_version", "environment", "evidence_event_ids", "assessed_at"],
+  "allOf": [
+    {
+      "if": {
+        "properties": { "status": { "enum": ["verified_with_evidence", "partial_with_evidence"] } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "evidence_event_ids": {
+            "type": "array",
+            "minItems": 1
+          }
+        }
+      }
+    }
+  ]
+}

package/packages/core/dist/schemas/v1/keyring.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/keyring.schema.json",
+  "title": "ucase-public-key-registry-v1",
+  "description": "The public-key registry (keyring) for verifying trusted-CI proof-event signatures. Documents the intended key-management shape: a keyId resolves to an ed25519 public key with a validity window and a status. v1 trusts a single active key (see proofSignature.ts verifyEvent + singleKeyResolver in markers/cli/shared.ts); this keyring generalises that to a registry of keys.",
+  "type": "object",
+  "additionalProperties": false,
+  "$defs": {
+    "key": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "key_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Stable identifier referenced by a proof-event signature's key_id."
+        },
+        "algorithm": {
+          "const": "ed25519",
+          "description": "Only ed25519 is supported (matches proofSignature.ts)."
+        },
+        "public_key": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The PEM-encoded ed25519 public key."
+        },
+        "valid_from": { "$ref": "common.schema.json#/$defs/timestamp" },
+        "valid_until": {
+          "anyOf": [
+            { "$ref": "common.schema.json#/$defs/timestamp" },
+            { "type": "null" }
+          ],
+          "description": "End of the validity window, or null for open-ended."
+        },
+        "status": {
+          "enum": ["active", "revoked"],
+          "description": "active keys may verify new proofs; revoked keys must not."
+        }
+      },
+      "required": ["key_id", "algorithm", "public_key", "valid_from", "valid_until", "status"]
+    }
+  },
+  "properties": {
+    "keyring_schema_id": {
+      "const": "ucase-public-key-registry-v1"
+    },
+    "keys": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/key" }
+    }
+  },
+  "required": ["keyring_schema_id", "keys"],
+  "examples": [
+    {
+      "keyring_schema_id": "ucase-public-key-registry-v1",
+      "keys": [
+        {
+          "key_id": "ci-key-1",
+          "algorithm": "ed25519",
+          "public_key": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAexampleexampleexampleexampleexampleexampleAB=\n-----END PUBLIC KEY-----\n",
+          "valid_from": "2026-01-01T00:00:00Z",
+          "valid_until": null,
+          "status": "active"
+        },
+        {
+          "key_id": "ci-key-0",
+          "algorithm": "ed25519",
+          "public_key": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAoldoldoldoldoldoldoldoldoldoldoldoldoldoldAB=\n-----END PUBLIC KEY-----\n",
+          "valid_from": "2025-01-01T00:00:00Z",
+          "valid_until": "2026-01-01T00:00:00Z",
+          "status": "revoked"
+        }
+      ]
+    }
+  ]
+}

package/packages/core/dist/schemas/v1/ledger.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/ledger.schema.json",
+  "title": "ucase-evidence-ledger-v1",
+  "description": "The whole proof/evidence ledger (`.use-cases/proofs.jsonl`) modelled as an ordered, append-only sequence of proof events. This is the file-level contract — distinct from the per-entry proof-event schema (ucase-proof-event-v1). The append-only/ordering contract: existing lines are never edited or deleted, new proof events are only appended at the tail, and entry index order is significant and immutable. Each entry MUST additionally validate against the ucase-proof-event-v1 schema.",
+  "type": "object",
+  "additionalProperties": false,
+  "$defs": {
+    "entry": {
+      "type": "object",
+      "$comment": "additionalProperties is true so a full ucase-proof-event-v1 object validates here; only the envelope fields needed to enforce the ledger contract are constrained. Each entry MUST also validate against ucase-proof-event-v1.",
+      "additionalProperties": true,
+      "properties": {
+        "schema": { "const": "ucase-proof-event-v1" },
+        "event_id": { "type": "string", "minLength": 1 },
+        "created_at": { "type": "string", "minLength": 1 },
+        "entry_index": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "OPTIONAL tamper-evident chain field: the entry's absolute 0-based position in the ledger. When present it MUST equal the line's index. Omitted on legacy proofs minted before the chain existed."
+        },
+        "previous_entry_hash": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$",
+          "description": "OPTIONAL tamper-evident chain field: sha256 of the previous entry's full canonical JSON, or the genesis sentinel (sha256:<64 zeros>) for the first entry. Omitted on legacy proofs."
+        },
+        "row": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "row_id": { "type": "string", "minLength": 1 }
+          },
+          "required": ["row_id"]
+        },
+        "signature": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "alg": { "const": "ed25519" },
+            "key_id": { "type": "string", "minLength": 1 },
+            "value": { "type": "string", "minLength": 1 }
+          },
+          "required": ["alg", "key_id", "value"]
+        }
+      },
+      "required": ["schema", "event_id", "created_at", "row", "signature"]
+    }
+  },
+  "properties": {
+    "ledger_schema_id": {
+      "const": "ucase-evidence-ledger-v1",
+      "description": "File-level ledger schema id (distinct from the per-entry ucase-proof-event-v1)."
+    },
+    "append_only": {
+      "const": true,
+      "description": "Asserts the append-only discipline: existing lines are immutable; events are only appended at the tail."
+    },
+    "entries": {
+      "type": "array",
+      "description": "Proof events in file/append order. Index order is significant and immutable; line N maps to entries[N-1].",
+      "items": { "$ref": "#/$defs/entry" }
+    }
+  },
+  "required": ["ledger_schema_id", "append_only", "entries"],
+  "examples": [
+    {
+      "ledger_schema_id": "ucase-evidence-ledger-v1",
+      "append_only": true,
+      "entries": [
+        {
+          "schema": "ucase-proof-event-v1",
+          "event_type": "row_proof_passed",
+          "event_id": "evt_0001",
+          "created_at": "2026-06-28T12:00:00Z",
+          "producer": {
+            "kind": "trusted-ci-prover",
+            "id": "ucm-ci",
+            "version": "1.0.0",
+            "ci_run_id": "run-123",
+            "repo": "example/app",
+            "commit": "abc123"
+          },
+          "row": {
+            "row_id": "checkout.apply_coupon",
+            "row_hash_id": "existing-semantic-row-hash",
+            "row_hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+            "verification_policy_hash": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+            "approval_policy_hash": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
+          },
+          "signature": {
+            "alg": "ed25519",
+            "key_id": "ci-key-1",
+            "value": "c2lnbmF0dXJl"
+          }
+        }
+      ]
+    }
+  ]
+}

package/packages/core/dist/schemas/v1/marker.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/marker.schema.json",
+  "title": "ucase-marker-v1",
+  "description": "A single parsed in-code use-case marker (the `ucase-marker-v1` shape). Markers carry identity ONLY: a start (begin) or `end` marker for a slug at a physical source location. The slug grammar and the row/binding distinction follow the marker grammar (spec 1.2/1.3); the const ids mirror packages/core/src/markers/constants.ts.",
+  "type": "object",
+  "additionalProperties": false,
+  "$defs": {
+    "row_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*)*$"
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*)*(?:#[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)*)?$"
+    }
+  },
+  "properties": {
+    "marker_schema_id": {
+      "const": "ucase-marker-v1",
+      "description": "Identity-only marker schema id (MARKER_SCHEMA_ID in constants.ts)."
+    },
+    "kind": {
+      "enum": ["start", "end"],
+      "description": "start = a begin marker (`<prefix>: @use-case: <slug>`); end = `<prefix>: @use-case: end <slug>`."
+    },
+    "slug": {
+      "$ref": "#/$defs/slug",
+      "description": "The full marker slug: row-id with an optional `#binding-suffix`."
+    },
+    "row_id": {
+      "$ref": "#/$defs/row_id",
+      "description": "The row-id portion of the slug (the part before any `#`)."
+    },
+    "suffix": {
+      "type": ["string", "null"],
+      "description": "The binding-suffix after `#`, or null for a bare row-id marker."
+    },
+    "role": {
+      "enum": ["row", "binding"],
+      "description": "row = a bare row-id slug (no suffix); binding = the slug carries a `#suffix`."
+    },
+    "file": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Workspace-relative POSIX path of the file the marker was found in."
+    },
+    "line": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "1-based physical line number of the marker."
+    },
+    "column": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "1-based column where the comment prefix begins."
+    }
+  },
+  "required": ["marker_schema_id", "kind", "slug", "row_id", "suffix", "role", "file", "line", "column"],
+  "examples": [
+    {
+      "marker_schema_id": "ucase-marker-v1",
+      "kind": "start",
+      "slug": "checkout.apply_coupon",
+      "row_id": "checkout.apply_coupon",
+      "suffix": null,
+      "role": "row",
+      "file": "Sources/Checkout/CouponService.swift",
+      "line": 3,
+      "column": 1
+    },
+    {
+      "marker_schema_id": "ucase-marker-v1",
+      "kind": "end",
+      "slug": "checkout.apply_coupon#web",
+      "row_id": "checkout.apply_coupon",
+      "suffix": "web",
+      "role": "binding",
+      "file": "Sources/Checkout/CouponService.swift",
+      "line": 11,
+      "column": 1
+    }
+  ]
+}

package/packages/core/dist/schemas/v1/matrix-list-result.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/matrix-list-result.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "const": 1 },
+    "complete": { "type": "boolean" },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "state": { "enum": ["clean", "partial", "unusable"] },
+        "populated": { "type": "boolean" },
+        "blocking_diagnostic_count": { "type": "integer", "minimum": 0 }
+      },
+      "required": ["state", "populated", "blocking_diagnostic_count"]
+    },
+    "use_cases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "id": { "$ref": "common.schema.json#/$defs/id" },
+          "title": { "type": "string", "minLength": 1 },
+          "feature_id": { "$ref": "common.schema.json#/$defs/id" },
+          "lifecycle": { "enum": ["planned", "active", "deprecated", "removed"] },
+          "value_tier": { "enum": ["critical", "core", "supporting", "long_tail"] },
+          "journey_role": { "enum": ["golden", "alternate", "edge", "negative", "failure"] },
+          "source_path": { "type": "string", "minLength": 1 },
+          "semantic_hash": { "$ref": "common.schema.json#/$defs/hash" },
+          "host_surfaces": {
+            "type": "array",
+            "items": { "$ref": "common.schema.json#/$defs/host_surface" }
+          },
+          "tags": {
+            "type": "array",
+            "items": { "$ref": "common.schema.json#/$defs/id" }
+          }
+        },
+        "required": [
+          "id",
+          "title",
+          "feature_id",
+          "lifecycle",
+          "value_tier",
+          "journey_role",
+          "source_path",
+          "semantic_hash",
+          "host_surfaces",
+          "tags"
+        ]
+      }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "returned": { "type": "integer", "minimum": 0 },
+        "total_addressable": { "type": "integer", "minimum": 0 }
+      },
+      "required": ["returned", "total_addressable"]
+    }
+  },
+  "required": ["schema_version", "complete", "integrity", "use_cases", "counts"]
+}

package/packages/core/dist/schemas/v1/matrix-mutation-result.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/matrix-mutation-result.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "const": 1 },
+    "operation": { "enum": ["upsert", "remove"] },
+    "status": { "enum": ["created", "updated", "removed", "blocked"] },
+    "use_case_id": {
+      "anyOf": [
+        { "$ref": "common.schema.json#/$defs/id" },
+        { "type": "null" }
+      ]
+    },
+    "file_path": {
+      "anyOf": [
+        { "type": "string", "minLength": 1 },
+        { "type": "null" }
+      ]
+    },
+    "before_hash": {
+      "anyOf": [
+        { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        { "type": "null" }
+      ]
+    },
+    "after_hash": {
+      "anyOf": [
+        { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        { "type": "null" }
+      ]
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/diagnostic" }
+    }
+  },
+  "required": [
+    "schema_version",
+    "operation",
+    "status",
+    "use_case_id",
+    "file_path",
+    "before_hash",
+    "after_hash",
+    "diagnostics"
+  ]
+}

package/packages/core/dist/schemas/v1/matrix-validation-result.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/matrix-validation-result.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "const": 1 },
+    "complete": { "type": "boolean" },
+    "valid": { "type": "boolean" },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "state": { "enum": ["clean", "partial", "unusable"] },
+        "populated": { "type": "boolean" },
+        "blocking_diagnostic_count": { "type": "integer", "minimum": 0 }
+      },
+      "required": ["state", "populated", "blocking_diagnostic_count"]
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "status": { "type": "string", "minLength": 1 },
+          "semantic_hash": { "$ref": "common.schema.json#/$defs/hash" },
+          "file_hash": { "$ref": "common.schema.json#/$defs/hash" }
+        },
+        "required": ["path", "status"]
+      }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "files_discovered": { "type": "integer", "minimum": 0 },
+        "files_loaded": { "type": "integer", "minimum": 0 },
+        "files_excluded": { "type": "integer", "minimum": 0 },
+        "use_case_candidates": { "type": "integer", "minimum": 0 },
+        "use_cases_addressable": { "type": "integer", "minimum": 0 },
+        "use_cases_ambiguous": { "type": "integer", "minimum": 0 },
+        "use_cases_structurally_clean": { "type": "integer", "minimum": 0 },
+        "broken_references": { "type": "integer", "minimum": 0 }
+      },
+      "required": [
+        "files_discovered",
+        "files_loaded",
+        "files_excluded",
+        "use_case_candidates",
+        "use_cases_addressable",
+        "use_cases_ambiguous",
+        "use_cases_structurally_clean",
+        "broken_references"
+      ]
+    },
+    "ambiguous_ids": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "entity_kind": { "enum": ["use_case"] },
+          "id": { "$ref": "common.schema.json#/$defs/id" },
+          "source_paths": {
+            "type": "array",
+            "minItems": 2,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        },
+        "required": ["entity_kind", "id", "source_paths"]
+      }
+    }
+  },
+  "required": ["schema_version", "complete", "valid", "integrity", "files", "counts", "ambiguous_ids"]
+}