@fortemi/core 2026.9.5 → 2026.9.7

package/schemas/metadata-search/candidate/1.0.0/predicates.schema.json

@@ -0,0 +1,287 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://fortemi.dev/schemas/metadata-search/candidate/1.0.0/predicates.schema.json",
+  "title": "Candidate typed metadata predicates",
+  "type": "array",
+  "maxItems": 8,
+  "items": {
+    "$ref": "#/$defs/predicate"
+  },
+  "$defs": {
+    "scalar": {
+      "oneOf": [
+        {
+          "type": "string",
+          "maxLength": 256,
+          "pattern": "^[^\\u0000]*$"
+        },
+        {
+          "type": "number",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "bound": {
+      "oneOf": [
+        {
+          "type": "string",
+          "maxLength": 256,
+          "pattern": "^[^\\u0000]*$"
+        },
+        {
+          "type": "number",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        }
+      ]
+    },
+    "predicate": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "path",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "path": {
+              "enum": [
+                "provider",
+                "model",
+                "role",
+                "event_kind",
+                "sensitivity",
+                "import_run_id"
+              ]
+            },
+            "op": {
+              "const": "eq"
+            },
+            "value": {
+              "$ref": "#/$defs/scalar"
+            }
+          },
+          "allOf": [
+            {
+              "if": {
+                "properties": {
+                  "path": {
+                    "const": "import_run_id"
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "value": {
+                    "type": "string",
+                    "maxLength": 200,
+                    "pattern": "^[^\\u0000]*$",
+                    "minLength": 1
+                  }
+                }
+              }
+            }
+          ]
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "path",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "path": {
+              "enum": [
+                "provider",
+                "model",
+                "role",
+                "event_kind",
+                "sensitivity",
+                "import_run_id"
+              ]
+            },
+            "op": {
+              "const": "in"
+            },
+            "value": {
+              "type": "array",
+              "maxItems": 32,
+              "items": {
+                "$ref": "#/$defs/scalar"
+              }
+            }
+          },
+          "allOf": [
+            {
+              "if": {
+                "properties": {
+                  "path": {
+                    "const": "import_run_id"
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "value": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "maxLength": 200,
+                      "pattern": "^[^\\u0000]*$",
+                      "minLength": 1
+                    }
+                  }
+                }
+              }
+            }
+          ]
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "path",
+            "op"
+          ],
+          "properties": {
+            "path": {
+              "enum": [
+                "provider",
+                "model",
+                "role",
+                "event_kind",
+                "sensitivity",
+                "import_run_id"
+              ]
+            },
+            "op": {
+              "const": "range"
+            },
+            "gte": {
+              "$ref": "#/$defs/bound"
+            },
+            "lte": {
+              "$ref": "#/$defs/bound"
+            }
+          },
+          "anyOf": [
+            {
+              "properties": {
+                "gte": {
+                  "$ref": "#/$defs/bound"
+                }
+              },
+              "required": [
+                "gte"
+              ]
+            },
+            {
+              "properties": {
+                "lte": {
+                  "$ref": "#/$defs/bound"
+                }
+              },
+              "required": [
+                "lte"
+              ]
+            }
+          ],
+          "oneOf": [
+            {
+              "properties": {
+                "gte": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "pattern": "^[^\\u0000]*$"
+                },
+                "lte": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "pattern": "^[^\\u0000]*$"
+                }
+              }
+            },
+            {
+              "properties": {
+                "gte": {
+                  "type": "number",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                },
+                "lte": {
+                  "type": "number",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                }
+              }
+            }
+          ],
+          "allOf": [
+            {
+              "if": {
+                "properties": {
+                  "path": {
+                    "const": "import_run_id"
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "gte": {
+                    "type": "string",
+                    "maxLength": 200,
+                    "pattern": "^[^\\u0000]*$",
+                    "minLength": 1
+                  },
+                  "lte": {
+                    "type": "string",
+                    "maxLength": 200,
+                    "pattern": "^[^\\u0000]*$",
+                    "minLength": 1
+                  }
+                }
+              }
+            }
+          ]
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "path",
+            "op"
+          ],
+          "properties": {
+            "path": {
+              "enum": [
+                "provider",
+                "model",
+                "role",
+                "event_kind",
+                "sensitivity",
+                "import_run_id"
+              ]
+            },
+            "op": {
+              "const": "exists"
+            },
+            "value": {
+              "type": "boolean"
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/metadata-search/candidate/1.0.0/resolution.receipt.json

@@ -0,0 +1,44 @@
+{
+  "schemaVersion": 1,
+  "status": "candidate-unpublished",
+  "authority": {
+    "repository": "Fortemi/fortemi",
+    "issue": 1091,
+    "baseCommit": "a701847db779a0a3adfa36a09dfa1055a10a0a0a",
+    "sourceState": "uncommitted candidate; base is not contract revision",
+    "path": "contracts/metadata-search/candidate/1.0.0/",
+    "files": {
+      "evidence-resolution.schema.json": "92c0cd616d26fad83e56e602d8393a8b6135175c849284d97721da146d923723",
+      "evidence-resolution-vectors.json": "3d217a489a29be0eb152a8efb4f569e7942d4ae2af921218e295c0dba8a38aea",
+      "predicates.schema.json": "e325707ce20abb88ef3a8f4bbb0d02ab09501b1ffe9b48b0c92a96e97dda00c3",
+      "evidence-locator.schema.json": "cd8427c507bca1a08bdb68da0a5d2759d1d7805401db3c00372ab249652efb7a"
+    },
+    "openapi": {
+      "path": "contracts/openapi/openapi.yaml",
+      "sha256": "240d4b16916d7218119937255c0646da8db3ea50bb4313137be9f2f9c42f1b01"
+    }
+  },
+  "consumer": {
+    "repository": "Fortemi/fortemi-react",
+    "issue": 405,
+    "backend": "remote",
+    "test": "src/__tests__/remote-evidence-resolution.test.ts",
+    "operation": "resolveEvidence(locator, { metadataPredicates?, includeArchived?, signal? })",
+    "endpoint": "POST /api/v1/search/evidence/resolve",
+    "requestByteLimit": 65536,
+    "unitByteLimit": 16777216,
+    "deadlineMilliseconds": 30000,
+    "scope": "Existing transport headers carry authorized tenant/archive context; caller-supplied tenant/archive/visibility fields reject before I/O.",
+    "response": "Strict schema, well-formed UTF-8 and exact span byte length. Producer checks current full-text digest and policy; partial text cannot independently prove that digest.",
+    "transport": "No-store request/response, redirect error, bounded streamed JSON, abort and deadline, no detail rebinding or retained server error body."
+  },
+  "claims": {
+    "promotedContract": false,
+    "fullIssueAcceptance": false,
+    "suiteParity": false,
+    "evidenceLocators": false,
+    "liveProducerAcceptance": false,
+    "publishedRuntimeAcceptance": false
+  },
+  "priorReceipt": "contract.receipt.json and rest.receipt.json remain unchanged historical evidence."
+}

package/schemas/metadata-search/candidate/1.0.0/rest.receipt.json

@@ -0,0 +1,51 @@
+{
+  "schemaVersion": 1,
+  "status": "candidate-unpublished",
+  "authority": {
+    "repository": "Fortemi/fortemi",
+    "issue": 1091,
+    "baseCommit": "a701847db779a0a3adfa36a09dfa1055a10a0a0a",
+    "sourceState": "uncommitted candidate; base is not contract revision",
+    "path": "contracts/metadata-search/candidate/1.0.0/",
+    "files": {
+      "search-rest.schema.json": "df4bdf5c61187a66cc90b760ce9ebc71d062688d67858ed519fbd27141db9470",
+      "search-rest-vectors.json": "eac3b3739aedf037671be4cbd4a89f336d405de8cf06ea7ddebae9d1e4e288f2",
+      "predicates.schema.json": "e325707ce20abb88ef3a8f4bbb0d02ab09501b1ffe9b48b0c92a96e97dda00c3",
+      "evidence-locator.schema.json": "cd8427c507bca1a08bdb68da0a5d2759d1d7805401db3c00372ab249652efb7a",
+      "evidence-set.schema.json": "da7e5d41bd563cb2cfe424cf7dfa92007a865ee0e1a9a4832ef669039d80717e"
+    },
+    "openapi": {
+      "path": "contracts/openapi/openapi.yaml",
+      "sha256": "31a156b1acf34c1f48c5283bd6c53f971e8f30c8b01e167d71e95ffec056e9a2"
+    }
+  },
+  "consumer": {
+    "repository": "Fortemi/fortemi-react",
+    "issue": 405,
+    "backend": "remote",
+    "test": "src/__tests__/remote-rest-contract.test.ts",
+    "response": "schema validation before projection; semantic note/total/evidence checks retained",
+    "requestSubset": [
+      "q",
+      "mode",
+      "limit",
+      "tags"
+    ],
+    "requestLimits": {
+      "minimum": 1,
+      "maximum": 100,
+      "default": 20
+    },
+    "defaultMode": "fts",
+    "unsupportedOptions": "rejected before I/O; candidate schema is not additional feature authorization"
+  },
+  "claims": {
+    "promotedContract": false,
+    "fullIssueAcceptance": false,
+    "suiteParity": false,
+    "evidenceLocators": false,
+    "liveProducerAcceptance": false,
+    "publishedRuntimeAcceptance": false
+  },
+  "priorReceipt": "contract.receipt.json is retained unchanged for historical predicate/evidence adoption"
+}

package/schemas/metadata-search/candidate/1.0.0/search-rest-vectors.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": "fortemi.search-rest-vectors.candidate.v1",
+  "boundary": "Synthetic schema and actual Rust wire checks, not fresh live HTTP, authorization or released-consumer qualification. Cross-field and evidence-binding semantic negatives also run in search_contract::tests.",
+  "requests": [
+    {"id":"empty-text-defaults","valid":true,"value":{"q":""}},
+    {"id":"legacy-unknown-mode","valid":true,"value":{"q":"x","mode":"legacy-unknown","limit":0,"since":"ignored-invalid"}},
+    {"id":"upper-limit-and-clamped-diversity","valid":true,"value":{"q":"x","limit":1000,"diversity":2}},
+    {"id":"decoded-json-content","valid":true,"value":{"q":"x","metadata_predicates":[],"strict_filter":{"min_tag_count":null,"unknown_ignored":true}}},
+    {"id":"missing-query","valid":false,"value":{"limit":1}},
+    {"id":"negative-limit","valid":false,"value":{"q":"x","limit":-1}},
+    {"id":"over-limit","valid":false,"value":{"q":"x","limit":1001}},
+    {"id":"non-integer-limit","valid":false,"value":{"q":"x","limit":1.5}},
+    {"id":"invalid-date","valid":false,"value":{"q":"x","created_after":"invalid"}},
+    {"id":"outside-f32","valid":false,"value":{"q":"x","diversity":1e100}},
+    {"id":"bad-strict-boolean","valid":false,"value":{"q":"x","strict_filter":{"include_untagged":0}}},
+    {"id":"unknown-metadata-field","valid":false,"value":{"q":"x","metadata_predicates":[{"field":"unknown","op":"eq","value":"x"}]}}
+  ],
+  "responses": [
+    {"id":"legacy-empty","valid":true,"value":{"results":[],"query":"","total":0,"degraded":false}},
+    {"id":"legacy-hit","valid":true,"value":{"results":[{"note_id":"00000000-0000-0000-0000-000000000001","score":0.5,"snippet":null}],"query":"x","total":1,"degraded":false}},
+    {"id":"explicit-degradation","valid":true,"value":{"results":[],"query":"x","total":0,"degraded":true,"degradation":{"code":"embedding_unavailable","effective_mode":"fts"}}},
+    {"id":"missing-query","valid":false,"value":{"results":[],"total":0,"degraded":false}},
+    {"id":"missing-degradation","valid":false,"value":{"results":[],"query":"x","total":0,"degraded":true}},
+    {"id":"null-is-not-absent","valid":false,"value":{"results":[],"query":"x","total":0,"degraded":false,"degradation":null}},
+    {"id":"wrong-effective-mode","valid":false,"value":{"results":[],"query":"x","total":0,"degraded":true,"degradation":{"code":"embedding_unavailable","effective_mode":"semantic"}}},
+    {"id":"null-evidence","valid":false,"value":{"results":[{"note_id":"00000000-0000-0000-0000-000000000001","score":0.5,"snippet":"display","evidence":null}],"query":"x","total":1,"degraded":false}}
+  ]
+}