shadowgraph_search

Added value: +"Restrict results to decisions or to attempts. A structured filter, never a content match."

Previous value: -"Page size. Omitted means a declared default, never silent truncation."New value: +"Maximum items to return, 1-1000; the default is 50 and completeness.limitSource reports which applied. Out of range is rejected, never silently clamped."

Added value: +"Return only decisions whose current confidence is at least this value, 0-1. A structured filter, never a content match."

Previous value: -"Page offset."New value: +"Items to skip before this window. Ordering is total and deterministic, so paging cannot drop or duplicate an item."

Added value: +"Restrict to one project. Omitted, decisions and facts are searched across projects, while memories stay in the default project and all-null scope."

Added value: +"Whitespace-separated terms, matched case-insensitively as substrings against the declared content fields (title, goal, chosen, assumption, evidence, alternative, attempt solution, attempt result, attempt reason, environment). Every term must match something, so more terms narrow the result. Omit to filter without searching."

Added value: +"Return only records carrying this claimed origin class. A structured filter, never a content match."

Added value: +"Return only decisions in this lifecycle state. A structured filter, so matching it is never counted as a content match."

Previous value: -nullNew value: +{
+  "description": "Matching records with their pagination and completeness declaration.",
+  "properties": {
+    "completeness": {
+      "description": "Declares exactly what this response left out, so a truncated result can never look complete.",
+      "properties": {
+        "complete": {
+          "description": "True only when every matching item is present.",
+          "type": "boolean"
+        },
+        "contentFields": {
+          "description": "The declared content fields a query term could match.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "limitSource": {
+          "description": "Whose choice bounded the result.",
+          "enum": [
+            "caller",
+            "default"
+          ],
+          "type": "string"
+        },
+        "losslessItems": {
+          "description": "Always true: each returned item is a full-fidelity record, never a summary or a truncated field.",
+          "type": "boolean"
+        },
+        "omitted": {
+          "description": "total minus returned.",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "returned": {
+          "description": "Items in this response.",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "scope": {
+          "description": "The project, query, and structured filters that produced this result, so it explains its own derivation.",
+          "type": "object"
+        },
+        "total": {
+          "description": "Items that matched in total.",
+          "minimum": 0,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "scope",
+        "returned",
+        "total",
+        "complete",
+        "omitted",
+        "losslessItems",
+        "limitSource",
+        "contentFields"
+      ],
+      "type": "object"
+    },
+    "items": {
+      "description": "The items in this window, in deterministic order.",
+      "items": {
+        "description": "One hit and the evidence for why it matched.",
+        "properties": {
+          "filters": {
+            "description": "The structured filters that were applied.",
+            "type": "object"
+          },
+          "matched": {
+            "description": "The content fields that actually matched, never schema keys.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "matchedBy": {
+            "description": "content when query terms matched, filter when only structured filters applied, graph when the item was pulled in as a neighbour.",
+            "enum": [
+              "content",
+              "filter",
+              "graph"
+            ],
+            "type": "string"
+          },
+          "reason": {
+            "description": "Human-readable explanation built from matched, so it can never claim a match it cannot name.",
+            "type": "string"
+          },
+          "record": {
+            "description": "One stored entity: a decision, attempt, memory, fact, or alternative. Fields vary by kind, and an entity imported from an older schema may carry fewer of them.",
+            "properties": {
+              "actor": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Who performed the write."
+              },
+              "client": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Which client performed the write."
+              },
+              "createdAt": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "ISO 8601 creation time."
+              },
+              "id": {
+                "description": "Stable entity identifier.",
+                "type": "string"
+              },
+              "kind": {
+                "description": "Entity kind: decision, attempt, memory, fact, relation, review, or alternative.",
+                "type": "string"
+              },
+              "project": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Project namespace; records imported from a schema that predates projects may carry null."
+              },
+              "schemaVersion": {
+                "description": "Storage schema version this entity was written under. A value above the build’s own version is preserved rather than downgraded.",
+                "type": "integer"
+              },
+              "sessionId": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Session identifier recorded with the write."
+              },
+              "sourceClass": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Claimed origin class recorded with the write. A claim, never proof."
+              },
+              "sourceRaw": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The original origin label when it differed from sourceClass. Audit only; never evidence."
+              },
+              "updatedAt": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "ISO 8601 time of the last change."
+              }
+            },
+            "type": "object"
+          },
+          "score": {
+            "description": "Relevance score; 0 when no query terms were supplied.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "record",
+          "score",
+          "matched",
+          "reason",
+          "matchedBy",
+          "filters"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "page": {
+      "description": "The window actually applied to the matching items.",
+      "properties": {
+        "hasMore": {
+          "description": "True when matching items exist beyond this window.",
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Window size applied, whether the caller set it or the default did.",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "offset": {
+          "description": "Index of the first item returned.",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "total": {
+          "description": "Matching items before the window was applied.",
+          "minimum": 0,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "offset",
+        "limit",
+        "total",
+        "hasMore"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "items",
+    "page",
+    "completeness"
+  ],
+  "type": "object"
+}