structured-context 0.10.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

@@ -0,0 +1,27 @@
+import { type Config } from './config';
+import type { SpaceContext } from './types';
+/** Thrown by createSpaceContext when no space matches the given name. */
+export declare class SpaceNotFoundError extends Error {
+    readonly spaceName: string;
+    constructor(spaceName: string);
+}
+export interface CreateSpaceContextOptions {
+    /**
+     * Directory to anchor relative plugin-config paths against. Defaults to the source
+     * directory recorded by loadConfig (space.sourceDir). Required for a hand-assembled
+     * Config, which has no source file — pass e.g. process.cwd(), or the directory the
+     * paths are relative to.
+     */
+    configDir?: string;
+}
+/**
+ * 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).
+ */
+export declare function createSpaceContext(spaceName: string, config: Config, options?: CreateSpaceContextOptions): SpaceContext;

package/dist/space-context.js

@@ -0,0 +1,46 @@
+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 {
+    spaceName;
+    constructor(spaceName) {
+        super(`Unknown space "${spaceName}"`);
+        this.spaceName = spaceName;
+        this.name = 'SpaceNotFoundError';
+    }
+}
+/**
+ * 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).
+ */
+export function createSpaceContext(spaceName, config, options = {}) {
+    const space = config.spaces.find((s) => s.name === spaceName);
+    if (!space) {
+        throw new SpaceNotFoundError(spaceName);
+    }
+    const configDir = options.configDir ?? space.sourceDir;
+    if (configDir === undefined) {
+        throw new Error(`Cannot resolve a config directory for space "${spaceName}": its Config was not loaded from a ` +
+            `file. Pass options.configDir (e.g. process.cwd()) to anchor relative plugin paths, or load ` +
+            `the config with loadConfig().`);
+    }
+    const resolvedSchemaPath = resolveSchema(config, space, { configDir });
+    const pluginSchemas = resolveSpacePluginSchemas(space, config, configDir);
+    const { schema, schemaRefRegistry, schemaValidator } = loadSchema(resolvedSchemaPath, pluginSchemas);
+    return {
+        space,
+        config,
+        resolvedSchemaPath,
+        schema,
+        schemaRefRegistry,
+        schemaValidator,
+        configDir,
+    };
+}