structured-context 0.11.0 → 0.12.0

package/dist/schemas/generated/0.12.0/_structured_context_schema_meta.json

@@ -0,0 +1,229 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/0.12.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
+              },
+              "check": {
+                "type": "string",
+                "minLength": 1
+              },
+              "type": {
+                "type": "string",
+                "minLength": 1
+              },
+              "scope": {
+                "enum": ["global"]
+              },
+              "override": {
+                "type": "boolean"
+              }
+            },
+            "required": ["id", "category", "description", "check"],
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/dist/schemas/generated/latest/_structured_context_schema_meta.json

@@ -0,0 +1,229 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/0.12.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
+              },
+              "check": {
+                "type": "string",
+                "minLength": 1
+              },
+              "type": {
+                "type": "string",
+                "minLength": 1
+              },
+              "scope": {
+                "enum": ["global"]
+              },
+              "override": {
+                "type": "boolean"
+              }
+            },
+            "required": ["id", "category", "description", "check"],
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/dist/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/dist/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/dist/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" }

package/dist/space-context.d.ts

@@ -17,6 +17,9 @@ export interface CreateSpaceContextOptions {
 /**
  * Build a SpaceContext for a named space from an already-loaded config.
  *
+ * Synchronously resolves schemas (including plugin-contributed schemas),
+ * indexes partials into the registry, and compiles the schema validator.
+ *
  * Library-safe: throws {@link SpaceNotFoundError} on an unknown space rather than
  * writing to the console or exiting the process. CLI callers that want the
  * exit-on-error behaviour should wrap this (see buildSpaceContext in index.ts).

package/dist/space-context.js

@@ -1,4 +1,5 @@
 import { resolveSchema } from './config';
+import { resolveSpacePluginSchemas } from './plugins/util';
 import { loadSchema } from './schema/schema';
 /** Thrown by createSpaceContext when no space matches the given name. */
 export class SpaceNotFoundError extends Error {
@@ -12,6 +13,9 @@ export class SpaceNotFoundError extends Error {
 /**
  * Build a SpaceContext for a named space from an already-loaded config.
  *
+ * Synchronously resolves schemas (including plugin-contributed schemas),
+ * indexes partials into the registry, and compiles the schema validator.
+ *
  * Library-safe: throws {@link SpaceNotFoundError} on an unknown space rather than
  * writing to the console or exiting the process. CLI callers that want the
  * exit-on-error behaviour should wrap this (see buildSpaceContext in index.ts).
@@ -27,8 +31,9 @@ export function createSpaceContext(spaceName, config, options = {}) {
             `file. Pass options.configDir (e.g. process.cwd()) to anchor relative plugin paths, or load ` +
             `the config with loadConfig().`);
     }
-    const resolvedSchemaPath = resolveSchema(config, space);
-    const { schema, schemaRefRegistry, schemaValidator } = loadSchema(resolvedSchemaPath);
+    const resolvedSchemaPath = resolveSchema(config, space, { configDir });
+    const pluginSchemas = resolveSpacePluginSchemas(space, config, configDir);
+    const { schema, schemaRefRegistry, schemaValidator } = loadSchema(resolvedSchemaPath, pluginSchemas);
     return {
         space,
         config,

package/dist/space-graph.d.ts

@@ -1,8 +1,10 @@
-import type { HierarchyLevel, SpaceNode } from './types';
+import type { Hierarchy, SpaceNode } from './types';
 /**
  * A navigable graph over a set of SpaceNodes.
  *
- * Built once from SpaceNode[] + hierarchy levels via buildSpaceGraph().
+ * Built once from SpaceNode[] + one selected hierarchy via buildSpaceGraph().
+ * The hierarchy-specific views (roots, orphans, hierarchyChildren, ...) cover only that hierarchy;
+ * nodes of other hierarchies' types are non-hierarchy nodes in this graph.
  * Provides typed access to nodes, edges, traversal, and classification
  * so consumers don't need to build their own indexes.
  */
@@ -15,14 +17,14 @@ export type SpaceGraph = {
     readonly orphans: readonly SpaceNode[];
     /** Non-hierarchy nodes: type not in the hierarchy levels definition. */
     readonly nonHierarchy: readonly SpaceNode[];
-    /** Hierarchy children map: parent title → direct children connected via hierarchy edges only. */
+    /** Hierarchy children map: parent title → direct children connected via this hierarchy's edges only. */
     readonly hierarchyChildren: ReadonlyMap<string, readonly SpaceNode[]>;
     /** All-edges children map: parent title → direct children connected via any edge (hierarchy + relationship). */
     readonly children: ReadonlyMap<string, readonly SpaceNode[]>;
     /** Set of all node titles that are part of the hierarchy (roots + their descendants + orphans). */
     readonly hierarchyTitles: ReadonlySet<string>;
-    /** Hierarchy levels used to build this graph. */
-    readonly levels: readonly HierarchyLevel[];
+    /** The hierarchy used to build this graph, if the schema has one. */
+    readonly hierarchy: Hierarchy | undefined;
 };
-/** Build a SpaceGraph from a flat list of SpaceNodes and hierarchy level definitions. */
-export declare function buildSpaceGraph(nodes: SpaceNode[], levels: readonly HierarchyLevel[]): SpaceGraph;
+/** Build a SpaceGraph from a flat list of SpaceNodes and the hierarchy to structure it by. */
+export declare function buildSpaceGraph(nodes: SpaceNode[], hierarchy: Hierarchy | undefined): SpaceGraph;