structured-context 0.9.0

package/dist/schema/metadata-contract.d.ts

@@ -0,0 +1,538 @@
+import type { FromSchema } from 'json-schema-to-ts';
+export declare const SCHEMA_META_ID = "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/_structured_context_schema_meta.json";
+/** Schema objects wrapping each prop group for type derivation via FromSchema. */
+declare const EDGE_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly field: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly fieldOn: {
+            readonly enum: readonly ["child", "parent"];
+        };
+        readonly multiple: {
+            readonly type: "boolean";
+        };
+    };
+    readonly additionalProperties: false;
+};
+declare const EMBEDDING_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly templateFormat: {
+            readonly enum: readonly ["heading", "list", "table", "page"];
+        };
+        readonly matchers: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly minItems: 1;
+        };
+        readonly embeddedTemplateFields: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+    };
+    readonly additionalProperties: false;
+};
+declare const HIERARCHY_LEVEL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly selfRef: {
+            readonly type: "boolean";
+        };
+        readonly selfRefField: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly templateFormat: {
+            readonly enum: readonly ["heading", "list", "table", "page"];
+        };
+        readonly matchers: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly minItems: 1;
+        };
+        readonly embeddedTemplateFields: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly field: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly fieldOn: {
+            readonly enum: readonly ["child", "parent"];
+        };
+        readonly multiple: {
+            readonly type: "boolean";
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+    };
+    readonly required: readonly ["type"];
+    readonly additionalProperties: false;
+};
+declare const RULE_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly category: {
+            readonly enum: readonly ["validation", "coherence", "workflow", "best-practice"];
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly check: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly scope: {
+            readonly enum: readonly ["global"];
+        };
+        readonly override: {
+            readonly type: "boolean";
+        };
+    };
+    readonly required: readonly ["id", "category", "description", "check"];
+    readonly additionalProperties: false;
+};
+declare const RULE_REF_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly $ref: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+    };
+    readonly required: readonly ["$ref"];
+    readonly additionalProperties: false;
+};
+declare const RELATIONSHIP_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly templateFormat: {
+            readonly enum: readonly ["heading", "list", "table", "page"];
+        };
+        readonly matchers: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly minItems: 1;
+        };
+        readonly embeddedTemplateFields: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly field: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly fieldOn: {
+            readonly enum: readonly ["child", "parent"];
+        };
+        readonly multiple: {
+            readonly type: "boolean";
+        };
+        readonly parent: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+    };
+    readonly required: readonly ["parent", "type"];
+    readonly additionalProperties: false;
+};
+export declare const METADATA_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly hierarchy: {
+            readonly type: "object";
+            readonly properties: {
+                readonly levels: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly items: {
+                        readonly oneOf: readonly [{
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        }, {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly selfRef: {
+                                    readonly type: "boolean";
+                                };
+                                readonly selfRefField: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly templateFormat: {
+                                    readonly enum: readonly ["heading", "list", "table", "page"];
+                                };
+                                readonly matchers: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                    };
+                                    readonly minItems: 1;
+                                };
+                                readonly embeddedTemplateFields: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                    };
+                                };
+                                readonly field: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly fieldOn: {
+                                    readonly enum: readonly ["child", "parent"];
+                                };
+                                readonly multiple: {
+                                    readonly type: "boolean";
+                                };
+                                readonly type: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                            };
+                            readonly required: readonly ["type"];
+                            readonly additionalProperties: false;
+                        }];
+                    };
+                };
+                readonly allowSkipLevels: {
+                    readonly type: "boolean";
+                };
+            };
+            readonly required: readonly ["levels"];
+            readonly additionalProperties: false;
+        };
+        readonly relationships: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly templateFormat: {
+                        readonly enum: readonly ["heading", "list", "table", "page"];
+                    };
+                    readonly matchers: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly minItems: 1;
+                    };
+                    readonly embeddedTemplateFields: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly field: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly fieldOn: {
+                        readonly enum: readonly ["child", "parent"];
+                    };
+                    readonly multiple: {
+                        readonly type: "boolean";
+                    };
+                    readonly parent: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly required: readonly ["parent", "type"];
+                readonly additionalProperties: false;
+            };
+        };
+        readonly aliases: {
+            readonly type: "object";
+            readonly additionalProperties: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly rules: {
+            readonly type: "array";
+            readonly items: {
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly category: {
+                            readonly enum: readonly ["validation", "coherence", "workflow", "best-practice"];
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly check: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly scope: {
+                            readonly enum: readonly ["global"];
+                        };
+                        readonly override: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["id", "category", "description", "check"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly $ref: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly required: readonly ["$ref"];
+                    readonly additionalProperties: false;
+                }];
+            };
+        };
+    };
+    readonly additionalProperties: false;
+};
+export declare const DIALECT_META_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/_structured_context_schema_meta.json";
+    readonly title: "structured-context schema dialect";
+    readonly description: "Extends JSON Schema Draft-07 with top-level $metadata for hierarchy and rule metadata.";
+    readonly type: "object";
+    readonly allOf: readonly [{
+        readonly $ref: "http://json-schema.org/draft-07/schema#";
+    }];
+    readonly properties: {
+        readonly $metadata: {
+            readonly type: "object";
+            readonly properties: {
+                readonly hierarchy: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly levels: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly items: {
+                                readonly oneOf: readonly [{
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                }, {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly selfRef: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly selfRefField: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly templateFormat: {
+                                            readonly enum: readonly ["heading", "list", "table", "page"];
+                                        };
+                                        readonly matchers: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                            };
+                                            readonly minItems: 1;
+                                        };
+                                        readonly embeddedTemplateFields: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                            };
+                                        };
+                                        readonly field: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly fieldOn: {
+                                            readonly enum: readonly ["child", "parent"];
+                                        };
+                                        readonly multiple: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly type: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                    };
+                                    readonly required: readonly ["type"];
+                                    readonly additionalProperties: false;
+                                }];
+                            };
+                        };
+                        readonly allowSkipLevels: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["levels"];
+                    readonly additionalProperties: false;
+                };
+                readonly relationships: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly templateFormat: {
+                                readonly enum: readonly ["heading", "list", "table", "page"];
+                            };
+                            readonly matchers: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly minItems: 1;
+                            };
+                            readonly embeddedTemplateFields: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                            };
+                            readonly field: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly fieldOn: {
+                                readonly enum: readonly ["child", "parent"];
+                            };
+                            readonly multiple: {
+                                readonly type: "boolean";
+                            };
+                            readonly parent: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                        readonly required: readonly ["parent", "type"];
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly aliases: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly rules: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly oneOf: readonly [{
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly category: {
+                                    readonly enum: readonly ["validation", "coherence", "workflow", "best-practice"];
+                                };
+                                readonly description: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly check: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly type: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly scope: {
+                                    readonly enum: readonly ["global"];
+                                };
+                                readonly override: {
+                                    readonly type: "boolean";
+                                };
+                            };
+                            readonly required: readonly ["id", "category", "description", "check"];
+                            readonly additionalProperties: false;
+                        }, {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly $ref: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                            };
+                            readonly required: readonly ["$ref"];
+                            readonly additionalProperties: false;
+                        }];
+                    };
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+};
+export type MetadataContract = FromSchema<typeof METADATA_SCHEMA>;
+export type MetadataContractHierarchyLevel = FromSchema<typeof HIERARCHY_LEVEL_SCHEMA>;
+export type MetadataContractRelationship = FromSchema<typeof RELATIONSHIP_SCHEMA>;
+export type SharedEdgeFields = FromSchema<typeof EDGE_SCHEMA>;
+export type SharedEmbeddingFields = FromSchema<typeof EMBEDDING_SCHEMA>;
+export type Rule = FromSchema<typeof RULE_SCHEMA>;
+export type RuleRef = FromSchema<typeof RULE_REF_SCHEMA>;
+export type RuleEntry = Rule | RuleRef;
+export {};

package/dist/schema/metadata-contract.js

@@ -0,0 +1,115 @@
+export const SCHEMA_META_ID = 'https://raw.githubusercontent.com/mindsocket/structured-context/main/schemas/generated/_structured_context_schema_meta.json';
+/** Graph edge routing fields shared by hierarchy levels and relationships. */
+const EDGE_PROPS = {
+    field: { type: 'string', minLength: 1 },
+    fieldOn: { enum: ['child', 'parent'] },
+    multiple: { type: 'boolean' },
+};
+/** Embedding/template hint fields shared by hierarchy levels and relationships. */
+const EMBEDDING_PROPS = {
+    templateFormat: { enum: ['heading', 'list', 'table', 'page'] },
+    matchers: { type: 'array', items: { type: 'string', minLength: 1 }, minItems: 1 },
+    embeddedTemplateFields: { type: 'array', items: { type: 'string', minLength: 1 } },
+};
+/** Schema objects wrapping each prop group for type derivation via FromSchema. */
+const EDGE_SCHEMA = {
+    type: 'object',
+    properties: EDGE_PROPS,
+    additionalProperties: false,
+};
+const EMBEDDING_SCHEMA = {
+    type: 'object',
+    properties: EMBEDDING_PROPS,
+    additionalProperties: false,
+};
+const HIERARCHY_LEVEL_SCHEMA = {
+    type: 'object',
+    properties: {
+        type: { type: 'string', minLength: 1 },
+        ...EDGE_PROPS,
+        ...EMBEDDING_PROPS,
+        selfRef: { type: 'boolean' },
+        selfRefField: { type: 'string', minLength: 1 },
+    },
+    required: ['type'],
+    additionalProperties: false,
+};
+const RULE_SCHEMA = {
+    type: 'object',
+    properties: {
+        id: { type: 'string', minLength: 1 },
+        category: { enum: ['validation', 'coherence', 'workflow', 'best-practice'] },
+        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,
+};
+const RULE_REF_SCHEMA = {
+    type: 'object',
+    properties: {
+        $ref: { type: 'string', minLength: 1 },
+    },
+    required: ['$ref'],
+    additionalProperties: false,
+};
+const RELATIONSHIP_SCHEMA = {
+    type: 'object',
+    properties: {
+        parent: { type: 'string', minLength: 1 },
+        type: { type: 'string', minLength: 1 },
+        ...EDGE_PROPS,
+        ...EMBEDDING_PROPS,
+    },
+    required: ['parent', 'type'],
+    additionalProperties: false,
+};
+export const METADATA_SCHEMA = {
+    type: 'object',
+    properties: {
+        hierarchy: {
+            type: 'object',
+            properties: {
+                levels: {
+                    type: 'array',
+                    minItems: 1,
+                    items: {
+                        oneOf: [{ type: 'string', minLength: 1 }, HIERARCHY_LEVEL_SCHEMA],
+                    },
+                },
+                allowSkipLevels: { type: 'boolean' },
+            },
+            required: ['levels'],
+            additionalProperties: false,
+        },
+        relationships: {
+            type: 'array',
+            items: RELATIONSHIP_SCHEMA,
+        },
+        aliases: {
+            type: 'object',
+            additionalProperties: { type: 'string', minLength: 1 },
+        },
+        rules: {
+            type: 'array',
+            items: {
+                oneOf: [RULE_SCHEMA, RULE_REF_SCHEMA],
+            },
+        },
+    },
+    additionalProperties: false,
+};
+export const DIALECT_META_SCHEMA = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    $id: SCHEMA_META_ID,
+    title: 'structured-context schema dialect',
+    description: 'Extends JSON Schema Draft-07 with top-level $metadata for hierarchy and rule metadata.',
+    type: 'object',
+    allOf: [{ $ref: 'http://json-schema.org/draft-07/schema#' }],
+    properties: {
+        $metadata: METADATA_SCHEMA,
+    },
+};

package/dist/schema/schema-refs.d.ts

@@ -0,0 +1,22 @@
+import type { AnySchemaObject } from 'ajv';
+export { decodeJsonPointerToken, isObject, resolveJsonPointer, resolveRefTarget };
+declare function isObject(value: unknown): value is Record<string, unknown>;
+declare function decodeJsonPointerToken(token: string): string;
+declare function resolveJsonPointer(root: AnySchemaObject, pointer: string, fullRef: string): AnySchemaObject;
+declare function resolveRefTarget(ref: string, currentRootSchema: AnySchemaObject, schemaRefRegistry: Map<string, AnySchemaObject>): {
+    schema: AnySchemaObject;
+    rootSchema: AnySchemaObject;
+    refKey: string;
+};
+/**
+ * Resolve a schema definition, following cross-file and internal refs transitively.
+ */
+export declare function resolveRef(propDef: AnySchemaObject | undefined, schema: AnySchemaObject, schemaRefRegistry: Map<string, AnySchemaObject>): AnySchemaObject | undefined;
+/**
+ * Merge properties and required fields from allOf entries recursively across refs.
+ * allOf entries are flattened depth-first; direct properties on later fragments override earlier ones.
+ */
+export declare function mergeVariantProperties(variant: AnySchemaObject, schema: AnySchemaObject, schemaRefRegistry: Map<string, AnySchemaObject>): {
+    properties: Record<string, AnySchemaObject>;
+    required: string[];
+};