structured-context 0.11.0 → 0.13.0

package/schemas/generated/latest/_structured_context_schema_meta.json

@@ -0,0 +1,400 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/0.13.0/_structured_context_schema_meta.json",
+  "title": "structured-context schema dialect",
+  "description": "Extends JSON Schema 2020-12 with top-level $metadata for imports, hierarchy, relationships, aliases and rules.",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "https://json-schema.org/draft/2020-12/schema"
+    }
+  ],
+  "properties": {
+    "$metadata": {
+      "type": "object",
+      "properties": {
+        "imports": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "hierarchy": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "override": {
+                  "type": "boolean"
+                },
+                "levels": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {
+                    "oneOf": [
+                      {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "field": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "fieldOn": {
+                            "enum": ["child", "parent"]
+                          },
+                          "multiple": {
+                            "type": "boolean"
+                          },
+                          "templateFormat": {
+                            "enum": ["heading", "list", "table", "page"]
+                          },
+                          "matchers": {
+                            "type": "array",
+                            "items": {
+                              "type": "string",
+                              "minLength": 1
+                            },
+                            "minItems": 1
+                          },
+                          "embeddedTemplateFields": {
+                            "type": "array",
+                            "items": {
+                              "type": "string",
+                              "minLength": 1
+                            }
+                          },
+                          "selfRef": {
+                            "type": "boolean"
+                          },
+                          "selfRefField": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["type"],
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                },
+                "allowSkipLevels": {
+                  "type": "boolean"
+                }
+              },
+              "required": ["levels"],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "$ref": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": ["$ref"],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "relationships": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "parent": {
+                "type": "string",
+                "minLength": 1
+              },
+              "type": {
+                "type": "string",
+                "minLength": 1
+              },
+              "field": {
+                "type": "string",
+                "minLength": 1
+              },
+              "fieldOn": {
+                "enum": ["child", "parent"]
+              },
+              "multiple": {
+                "type": "boolean"
+              },
+              "templateFormat": {
+                "enum": ["heading", "list", "table", "page"]
+              },
+              "matchers": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "minItems": 1
+              },
+              "embeddedTemplateFields": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "override": {
+                "type": "boolean"
+              }
+            },
+            "required": ["parent", "type"],
+            "additionalProperties": false
+          }
+        },
+        "aliases": {
+          "type": "object",
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "override": {
+                    "type": "boolean"
+                  }
+                },
+                "required": ["type"],
+                "additionalProperties": false
+              }
+            ]
+          }
+        },
+        "rules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "category": {
+                "enum": ["validation", "coherence", "workflow", "best-practice"]
+              },
+              "severity": {
+                "enum": ["error", "warning", "info"]
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
+              "expression": {
+                "type": "string",
+                "minLength": 1
+              },
+              "when": {
+                "type": "string",
+                "minLength": 1
+              },
+              "semantic": {
+                "oneOf": [
+                  {
+                    "const": true
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "rubric": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "verdicts": {
+                        "type": "object",
+                        "additionalProperties": {
+                          "oneOf": [
+                            {
+                              "type": "string",
+                              "minLength": 1
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "description": {
+                                  "type": "string",
+                                  "minLength": 1
+                                },
+                                "guidance": {
+                                  "type": "string",
+                                  "minLength": 1
+                                }
+                              },
+                              "required": ["description"],
+                              "additionalProperties": false
+                            }
+                          ]
+                        },
+                        "minProperties": 2
+                      },
+                      "severity": {
+                        "type": "object",
+                        "additionalProperties": {
+                          "enum": ["error", "warning", "info", "ignore"]
+                        },
+                        "minProperties": 1
+                      },
+                      "scope": {
+                        "type": "array",
+                        "items": {
+                          "enum": ["parent", "siblings", "children", "ancestors", "descendants", "branch"]
+                        },
+                        "uniqueItems": true
+                      },
+                      "includeContent": {
+                        "enum": ["nodeOnly", "fullScope", true]
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ]
+              },
+              "type": {
+                "type": "string",
+                "minLength": 1
+              },
+              "global": {
+                "type": "boolean"
+              },
+              "override": {
+                "type": "boolean"
+              },
+              "gatesDescendants": {
+                "type": "boolean"
+              }
+            },
+            "required": ["id", "category", "description"],
+            "additionalProperties": false,
+            "allOf": [
+              {
+                "anyOf": [
+                  {
+                    "required": ["expression"]
+                  },
+                  {
+                    "required": ["semantic"]
+                  }
+                ]
+              },
+              {
+                "if": {
+                  "required": ["global"],
+                  "properties": {
+                    "global": {
+                      "const": true
+                    }
+                  }
+                },
+                "then": {
+                  "not": {
+                    "anyOf": [
+                      {
+                        "required": ["when"]
+                      },
+                      {
+                        "required": ["type"]
+                      },
+                      {
+                        "required": ["semantic"]
+                      }
+                    ]
+                  }
+                }
+              },
+              {
+                "if": {
+                  "required": ["semantic"],
+                  "properties": {
+                    "semantic": {
+                      "type": "object",
+                      "required": ["verdicts"]
+                    }
+                  }
+                },
+                "then": {
+                  "properties": {
+                    "semantic": {
+                      "type": "object",
+                      "required": ["severity"]
+                    }
+                  }
+                }
+              },
+              {
+                "if": {
+                  "required": ["semantic"],
+                  "properties": {
+                    "semantic": {
+                      "type": "object",
+                      "not": {
+                        "required": ["verdicts"]
+                      }
+                    }
+                  }
+                },
+                "then": {
+                  "properties": {
+                    "semantic": {
+                      "type": "object",
+                      "properties": {
+                        "severity": {
+                          "type": "object",
+                          "not": {
+                            "required": ["fail"]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              {
+                "if": {
+                  "required": ["semantic"],
+                  "properties": {
+                    "semantic": {
+                      "type": "object",
+                      "required": ["verdicts"]
+                    }
+                  },
+                  "not": {
+                    "required": ["expression"]
+                  }
+                },
+                "then": {
+                  "not": {
+                    "required": ["severity"]
+                  }
+                }
+              }
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/knowledge_wiki.json

@@ -1,15 +1,16 @@
 {
-  "$schema": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/_structured_context_schema_meta.json",
-  "$id": "sctx://knowledge_wiki",
+  "$schema": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/latest/_structured_context_schema_meta.json",
+  "$id": "sctx://core/knowledge_wiki",
   "title": "Knowledge Wiki",
   "description": "Lightweight schema for LLM-maintained knowledge wikis. Supports source pages, concept pages, syntheses, and notes. Designed for compounding knowledge bases where the LLM creates and maintains wiki pages from raw sources.\n\nFlat entity model — no hierarchy, no required parent links. Wikilinks between any pages are valid for arbitrary cross-referencing. The schema validates structure and provenance; it does not constrain meaning.\n\nBased on the pattern described in Karpathy's LLM Wiki (2026).",
-  "allOf": [{ "$ref": "sctx://_knowledge_wiki" }],
+  "$metadata": { "imports": ["sctx://core/_knowledge_wiki"] },
+  "allOf": [{ "$ref": "sctx://core/_knowledge_wiki" }],
   "oneOf": [
-    { "$ref": "sctx://_knowledge_wiki#/$defs/source" },
-    { "$ref": "sctx://_knowledge_wiki#/$defs/concept" },
-    { "$ref": "sctx://_knowledge_wiki#/$defs/entity" },
-    { "$ref": "sctx://_knowledge_wiki#/$defs/synthesis" },
-    { "$ref": "sctx://_knowledge_wiki#/$defs/note" },
-    { "$ref": "sctx://_knowledge_wiki#/$defs/index" }
+    { "$ref": "sctx://core/_knowledge_wiki#/$defs/source" },
+    { "$ref": "sctx://core/_knowledge_wiki#/$defs/concept" },
+    { "$ref": "sctx://core/_knowledge_wiki#/$defs/entity" },
+    { "$ref": "sctx://core/_knowledge_wiki#/$defs/synthesis" },
+    { "$ref": "sctx://core/_knowledge_wiki#/$defs/note" },
+    { "$ref": "sctx://core/_knowledge_wiki#/$defs/index" }
   ]
 }

package/schemas/okf.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/latest/_structured_context_schema_meta.json",
+  "$id": "sctx://core/okf",
+  "title": "Open Knowledge Format",
+  "description": "Validates the frontmatter of Open Knowledge Format (OKF v0.2) concept documents in a bundle. Any `type` is accepted and unknown fields are tolerated; `Attested Computation` concepts additionally carry the computation contract.\n\nSpecification: https://github.com/GoogleCloudPlatform/open-knowledge-format",
+  "$metadata": { "imports": ["sctx://core/_okf"] },
+  "allOf": [{ "$ref": "sctx://core/_okf" }, { "$ref": "sctx://core/_okf#/$defs/concept" }]
+}

package/schemas/strategy_general.json

@@ -1,19 +1,20 @@
 {
-  "$schema": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/_structured_context_schema_meta.json",
-  "$id": "sctx://strategy_general",
+  "$schema": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/latest/_structured_context_schema_meta.json",
+  "$id": "sctx://core/strategy_general",
   "title": "Strategy and opportunity ladder",
-  "description": "Validates frontmatter for space node files. Composes strategy_general entities from the bundled partial. Override the hierarchy in $metadata to customize the level structure.",
-  "allOf": [{ "$ref": "sctx://_strategy_general" }],
+  "description": "Validates frontmatter for space node files. Composes strategy_general entities from the bundled partial. Imports the partial's hierarchy, aliases, relationships and rules.",
+  "$metadata": { "imports": ["sctx://core/_strategy_general"] },
+  "allOf": [{ "$ref": "sctx://core/_strategy_general" }],
   "oneOf": [
-    { "$ref": "sctx://_strategy_general#/$defs/dashboard" },
-    { "$ref": "sctx://_strategy_general#/$defs/ost_on_a_page" },
-    { "$ref": "sctx://_strategy_general#/$defs/vision" },
-    { "$ref": "sctx://_strategy_general#/$defs/mission" },
-    { "$ref": "sctx://_strategy_general#/$defs/goal" },
-    { "$ref": "sctx://_strategy_general#/$defs/opportunity" },
-    { "$ref": "sctx://_strategy_general#/$defs/solution" },
-    { "$ref": "sctx://_strategy_general#/$defs/experiment" },
-    { "$ref": "sctx://_strategy_general#/$defs/assumption" },
-    { "$ref": "sctx://_strategy_general#/$defs/problem_statement" }
+    { "$ref": "sctx://core/_strategy_general#/$defs/dashboard" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/ost_on_a_page" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/vision" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/mission" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/goal" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/opportunity" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/solution" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/experiment" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/assumption" },
+    { "$ref": "sctx://core/_strategy_general#/$defs/problem_statement" }
   ]
 }

package/schemas/strict_ost.json

@@ -1,18 +1,19 @@
 {
-  "$schema": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/_structured_context_schema_meta.json",
-  "$id": "sctx://strict_ost",
+  "$schema": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/latest/_structured_context_schema_meta.json",
+  "$id": "sctx://core/strict_ost",
   "title": "Opportunity Solution Tree (Strict)",
   // Follows Teresa Torres' 4-level OST structure as described in "Continuous Discovery Habits" (2021)
   // and at producttalk.org.
   // Structure: outcome → opportunity → solution → assumption test
   "description": "Validates frontmatter for space node files following the canonical 4-level OST structure: outcome → opportunity → solution → assumption test",
+  "$metadata": { "imports": ["sctx://core/_ost_strict"] },
   "oneOf": [
     {
       "type": "object",
       "allOf": [
-        { "$ref": "sctx://_sctx_base#/$defs/baseNodeProps" },
-        { "$ref": "sctx://_sctx_base#/$defs/ostEntityProps" },
-        { "$ref": "sctx://_ost_strict#/$defs/outcomeProps" }
+        { "$ref": "sctx://core/_sctx_base#/$defs/baseNodeProps" },
+        { "$ref": "sctx://core/_sctx_base#/$defs/ostEntityProps" },
+        { "$ref": "sctx://core/_ost_strict#/$defs/outcomeProps" }
       ],
       "properties": {
         "type": { "const": "outcome" }
@@ -31,10 +32,10 @@
     {
       "type": "object",
       "allOf": [
-        { "$ref": "sctx://_sctx_base#/$defs/baseNodeProps" },
-        { "$ref": "sctx://_sctx_base#/$defs/parentNodeProps" },
-        { "$ref": "sctx://_sctx_base#/$defs/ostEntityProps" },
-        { "$ref": "sctx://_ost_strict#/$defs/opportunityProps" }
+        { "$ref": "sctx://core/_sctx_base#/$defs/baseNodeProps" },
+        { "$ref": "sctx://core/_sctx_base#/$defs/parentNodeProps" },
+        { "$ref": "sctx://core/_sctx_base#/$defs/ostEntityProps" },
+        { "$ref": "sctx://core/_ost_strict#/$defs/opportunityProps" }
       ],
       "properties": {
         "type": { "const": "opportunity" }
@@ -53,9 +54,9 @@
     {
       "type": "object",
       "allOf": [
-        { "$ref": "sctx://_sctx_base#/$defs/baseNodeProps" },
-        { "$ref": "sctx://_sctx_base#/$defs/parentNodeProps" },
-        { "$ref": "sctx://_sctx_base#/$defs/ostEntityProps" }
+        { "$ref": "sctx://core/_sctx_base#/$defs/baseNodeProps" },
+        { "$ref": "sctx://core/_sctx_base#/$defs/parentNodeProps" },
+        { "$ref": "sctx://core/_sctx_base#/$defs/ostEntityProps" }
       ],
       "properties": {
         "type": { "const": "solution" }
@@ -73,10 +74,10 @@
     {
       "type": "object",
       "allOf": [
-        { "$ref": "sctx://_sctx_base#/$defs/baseNodeProps" },
-        { "$ref": "sctx://_sctx_base#/$defs/parentNodeProps" },
-        { "$ref": "sctx://_sctx_base#/$defs/ostEntityProps" },
-        { "$ref": "sctx://_ost_strict#/$defs/assumptionTestProps" }
+        { "$ref": "sctx://core/_sctx_base#/$defs/baseNodeProps" },
+        { "$ref": "sctx://core/_sctx_base#/$defs/parentNodeProps" },
+        { "$ref": "sctx://core/_sctx_base#/$defs/ostEntityProps" },
+        { "$ref": "sctx://core/_ost_strict#/$defs/assumptionTestProps" }
       ],
       "properties": {
         "type": { "const": "assumption_test" }