@toolproof-core/genesis 1.0.48 → 1.0.50

package/generated-src/schemas/schemas.json

@@ -75,9 +75,9 @@
             },
             "additionalProperties": true
         },
-        "TypeRef": {
+        "AtomicTypeRef": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$comment": "A type reference is either resource-backed (resourceTypeHandle, strategy-legal) or schema-backed (roleSchema, internal/Core-only). The roleSchema branch holds an object whose $ref names the type parameter (e.g. '#OperandType'), matching an entry in the template's GenericAssignmentByRoleName.mapKeys. Exactly one branch must be present.",
+            "$comment": "An atomic type reference is either resource-backed (resourceTypeHandle, strategy-legal) or schema-backed (roleSchema, internal/Core-only). The roleSchema branch holds an object whose $ref names the type parameter (e.g. '#OperandType'), matching an entry in the template's GenericAssignmentByRoleName.mapKeys. Exactly one atomic branch must be present.",
             "oneOf": [
                 {
                     "type": "object",
@@ -116,6 +116,31 @@
                 }
             ]
         },
+        "TypeRef": {
+            "$comment": "A type reference is either a single AtomicTypeRef or a finite sum type expressed as oneOfTypeRefs. The oneOfTypeRefs branch permits a union of atomic successful value alternatives and does not permit nested unions.",
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/AtomicTypeRef"
+                },
+                {
+                    "type": "object",
+                    "required": [
+                        "oneOfTypeRefs"
+                    ],
+                    "properties": {
+                        "oneOfTypeRefs": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/$defs/AtomicTypeRef"
+                            },
+                            "minItems": 2,
+                            "uniqueItems": true
+                        }
+                    },
+                    "additionalProperties": false
+                }
+            ]
+        },
         "Embedding": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
@@ -151,16 +176,20 @@
             "required": [
                 "handle"
             ],
+            "semanticValidation": "If ingestorToolHandle is present, verify that it references an existing non-template Tool whose distinguished raw-instance input semantically matches ingestorToolInputSchema when provided, whose distinguished Boolean output reports whether the raw instance is valid for this ResourceType, and whose distinguished projection output is typed as this ResourceType and conforms to projectionSchema when projectionSchema is present.",
             "properties": {
                 "handle": {
                     "$ref": "#/$defs/ResourceTypeHandle"
                 },
-                "valueSchema": {
+                "projectionSchema": {
                     "$ref": "#/$defs/JsonSchemaObject"
                 },
-                "parserToolHandle": {
+                "ingestorToolHandle": {
                     "$ref": "#/$defs/ToolHandle"
                 },
+                "ingestorToolInputSchema": {
+                    "$ref": "#/$defs/JsonSchemaObject"
+                },
                 "embeddingModelTools": {
                     "type": "array",
                     "items": {
@@ -175,19 +204,31 @@
                     "$ref": "#/$defs/DocumentationSpec"
                 },
                 {
-                    "$comment": "A ResourceType must specify either a valueSchema or a parserToolHandle, or both. If only a valueSchema is specified, the author assumes no burden of implementing a parser for the ResourceType. They can rely on the valueSchema for validation. If only a parserToolHandle is specified, the author assumes the burden of implementing a parser that can validate instances of the ResourceType. If both are specified, the author assumes the burden of implementing an augmented parser that also serves as a generator between the raw data and an instance of the valueSchema.",
+                    "$comment": "A ResourceType ultimately describes both raw instances and their Core-visible JSON projection. Inside ToolProof Core, the ResourceType denotes the projection. projectionSchema describes the shape of that Core-visible projection. ingestorToolHandle identifies the Tool that ingests raw instances for this ResourceType by validating them against the built-in format grammar and, when projectionSchema is present, emitting the corresponding projection for Core. ingestorToolInputSchema describes the raw-instance input accepted by that ingestor. A ResourceType must specify either a projectionSchema or an ingestorToolHandle, or both. If only a projectionSchema is specified, the author relies on schema-based validation of the Core-visible projection and does not designate an ingestor. If only an ingestorToolHandle is specified, the author designates an ingestor that is authoritative for validating raw instances of the ResourceType. If both are specified, the ingestor must emit projections that conform to projectionSchema.",
                     "anyOf": [
                         {
                             "required": [
-                                "valueSchema"
+                                "projectionSchema"
                             ]
                         },
                         {
                             "required": [
-                                "parserToolHandle"
+                                "ingestorToolHandle"
                             ]
                         }
                     ]
+                },
+                {
+                    "if": {
+                        "required": [
+                            "ingestorToolInputSchema"
+                        ]
+                    },
+                    "then": {
+                        "required": [
+                            "ingestorToolHandle"
+                        ]
+                    }
                 }
             ],
             "unevaluatedProperties": false
@@ -207,7 +248,7 @@
         },
         "RoleValue": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$comment": "Pairs a type reference (typeRef) with a container shape. typeRef is either resource-backed (resourceTypeHandle) or schema-backed (roleSchema).",
+            "$comment": "Pairs a type reference (typeRef) with a container shape. typeRef may be a single atomic type reference or a finite sum type over atomic successful value alternatives.",
             "type": "object",
             "required": [
                 "typeRef",
@@ -408,14 +449,6 @@
             "type": "string",
             "pattern": "^TOOL-.+$"
         },
-        "ToolKind": {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "type": "string",
-            "enum": [
-                "runtime",
-                "buildtime"
-            ]
-        },
         "Tool": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
@@ -427,17 +460,17 @@
                 "handle": {
                     "$ref": "#/$defs/ToolHandle"
                 },
-                "isTemplate": {
-                    "type": "boolean"
-                },
                 "templateToolHandle": {
                     "$ref": "#/$defs/ToolHandle"
                 },
+                "isTemplate": {
+                    "type": "boolean"
+                },
                 "instantiationRoleSpec": {
                     "$ref": "#/$defs/RoleSpec"
                 }
             },
-            "$comment": "Template Tools own dispatch contract: Core scans all instantiation Tools grouped by templateToolHandle, derives a specializationKey from each tool's generic role assignment (canonical order of genericRoleName -> resourceTypeHandle pairs), and asserts injectivity (no two instantiation Tools share the same key for the same template). At invocation time Core injects the specializationKey -> instantiationToolHandle lookup as the second input, then resolves the first input against it to return one instantiation Tool. Cross-resource compatibility between an instantiation Tool's roleSpec and the template's instantiationRoleSpec is deferred to the validation package.",
+            "$comment": "Template Tools own dispatch contract: Core scans all instantiation Tools grouped by templateToolHandle, derives a specializationKey from each instantiation tool's generic assignment by taking the canonical order of genericRoleName -> assigned ResourceType.resourceTypeHandle pairs, and asserts injectivity (no two instantiation Tools share the same key for the same template). At invocation time Core injects the specializationKey -> instantiationToolHandle lookup as the second input, then the template resolves the first input against it to return one instantiation Tool. Cross-resource compatibility between an instantiation Tool's roleSpec and the template's instantiationRoleSpec is deferred to the validation package.",
             "semanticValidation": "Deferred: verify injectivity of specializationKey map per template; verify instantiation Tool roleSpec matches template instantiationRoleSpec; verify every supplied generic assignment key-set exactly equals roleSpec.inputRoleValueByName.GenericAssignmentByRoleName.mapKeys; verify every supplied generic assignment matches a registered specializationKey.",
             "allOf": [
                 {
@@ -468,7 +501,7 @@
                     }
                 },
                 {
-                    "$comment": "Template Tools must declare named roles: two map inputs (GenericAssignmentByRoleName and InstantiationToolHandleBySpecializationKey) and one scalar TYPE-Tool output (InstantiationTool). Runtime semantic validation enforces that invocation input keys for GenericAssignmentByRoleName exactly match this role's declared mapKeys.",
+                    "$comment": "Template Tools must declare named roles: two map inputs (GenericAssignmentByRoleName and InstantiationToolHandleBySpecializationKey) and one scalar TYPE-Tool output (InstantiationTool). GenericAssignmentByRoleName.mapKeys declares the generic parameter names accepted by the template. Runtime semantic validation enforces that each invocation's GenericAssignmentByRoleName object has exactly that key set: no missing keys, no extra keys. These keys are the generic parameter names later referenced via roleSchema refs such as #OperandType; they are not required to match the top-level role names of instantiationRoleSpec.",
                     "if": {
                         "required": [
                             "isTemplate"
@@ -878,8 +911,7 @@
             "type": "object",
             "required": [
                 "id",
-                "resourceTypeHandle",
-                "version"
+                "resourceTypeHandle"
             ],
             "properties": {
                 "id": {
@@ -887,9 +919,6 @@
                 },
                 "resourceTypeHandle": {
                     "$ref": "#/$defs/ResourceTypeHandle"
-                },
-                "version": {
-                    "const": 1
                 }
             },
             "allOf": [
@@ -903,12 +932,12 @@
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "required": [
-                "value"
+                "projection"
             ],
             "properties": {
-                "value": true
+                "projection": true
             },
-            "$comment": "This will be overlaid dynamically to match the data structure of the underlying ResourceType's valueSchema.",
+            "$comment": "The projection field stores the Core-visible JSON projection of the Resource, not the raw underlying artifact. This will be overlaid dynamically to match the data structure of the underlying ResourceType's projectionSchema.",
             "allOf": [
                 {
                     "$ref": "#/$defs/ResourcePointer"
@@ -1665,6 +1694,146 @@
                 }
             ],
             "unevaluatedProperties": false
+        },
+        "JsonScalarLink": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "type": "object",
+            "required": [
+                "kind",
+                "filePath",
+                "pointer"
+            ],
+            "properties": {
+                "kind": {
+                    "const": "json-pointer"
+                },
+                "filePath": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "pointer": {
+                    "type": "string",
+                    "pattern": "^(?:/(?:[^~/]|~0|~1)*)+$",
+                    "$comment": "RFC 6901 JSON Pointer. Requires at least one reference token."
+                }
+            },
+            "unevaluatedProperties": false
+        },
+        "Suite": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "type": "object",
+            "allOf": [
+                {
+                    "type": "object",
+                    "required": [
+                        "name",
+                        "version",
+                        "description"
+                    ],
+                    "properties": {
+                        "name": {
+                            "$ref": "#/$defs/Name"
+                        },
+                        "version": {
+                            "type": "string",
+                            "minLength": 1
+                        },
+                        "description": {
+                            "$ref": "#/$defs/Description"
+                        }
+                    }
+                },
+                {
+                    "type": "object",
+                    "required": [
+                        "resourceTypes",
+                        "tools"
+                    ],
+                    "properties": {
+                        "resourceTypes": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/$defs/ResourceType"
+                            },
+                            "uniqueItems": true
+                        },
+                        "tools": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/$defs/Tool"
+                            },
+                            "uniqueItems": true
+                        }
+                    }
+                }
+            ],
+            "unevaluatedProperties": false
+        },
+        "SuiteIngestorInputSchema": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "type": "object",
+            "allOf": [
+                {
+                    "type": "object",
+                    "required": [
+                        "name",
+                        "version",
+                        "description"
+                    ],
+                    "properties": {
+                        "name": {
+                            "oneOf": [
+                                {
+                                    "$ref": "#/$defs/Name"
+                                },
+                                {
+                                    "$ref": "#/$defs/JsonScalarLink"
+                                }
+                            ]
+                        },
+                        "version": {
+                            "oneOf": [
+                                {
+                                    "type": "string",
+                                    "minLength": 1
+                                },
+                                {
+                                    "$ref": "#/$defs/JsonScalarLink"
+                                }
+                            ]
+                        },
+                        "description": {
+                            "oneOf": [
+                                {
+                                    "$ref": "#/$defs/Description"
+                                },
+                                {
+                                    "$ref": "#/$defs/JsonScalarLink"
+                                }
+                            ]
+                        }
+                    }
+                },
+                {
+                    "type": "object",
+                    "required": [
+                        "resourceTypesPath",
+                        "toolsPath"
+                    ],
+                    "properties": {
+                        "resourceTypesPath": {
+                            "type": "string",
+                            "minLength": 1
+                        },
+                        "toolsPath": {
+                            "type": "string",
+                            "minLength": 1
+                        }
+                    }
+                }
+            ],
+            "semanticValidation": "Verify that resourceTypesPath and toolsPath are relative paths rooted within the suite root, that toolproof.json provides the required suite metadata, and that the referenced files exist and match the expected declaration schemas.",
+            "unevaluatedProperties": false
         }
     }
 }

package/generated-src/schemas/standalone/Resource.json

@@ -8,12 +8,12 @@
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
       "required": [
-        "value"
+        "projection"
       ],
       "properties": {
-        "value": true
+        "projection": true
       },
-      "$comment": "This will be overlaid dynamically to match the data structure of the underlying ResourceType's valueSchema.",
+      "$comment": "The projection field stores the Core-visible JSON projection of the Resource, not the raw underlying artifact. This will be overlaid dynamically to match the data structure of the underlying ResourceType's projectionSchema.",
       "allOf": [
         {
           "$ref": "#/$defs/ResourcePointer"
@@ -25,8 +25,7 @@
       "type": "object",
       "required": [
         "id",
-        "resourceTypeHandle",
-        "version"
+        "resourceTypeHandle"
       ],
       "properties": {
         "id": {
@@ -34,9 +33,6 @@
         },
         "resourceTypeHandle": {
           "$ref": "#/$defs/ResourceTypeHandle"
-        },
-        "version": {
-          "const": 1
         }
       },
       "allOf": [

package/generated-src/schemas/standalone/ResourceType.json

@@ -4,16 +4,20 @@
   "required": [
     "handle"
   ],
+  "semanticValidation": "If ingestorToolHandle is present, verify that it references an existing non-template Tool whose distinguished raw-instance input semantically matches ingestorToolInputSchema when provided, whose distinguished Boolean output reports whether the raw instance is valid for this ResourceType, and whose distinguished projection output is typed as this ResourceType and conforms to projectionSchema when projectionSchema is present.",
   "properties": {
     "handle": {
       "$ref": "#/$defs/ResourceTypeHandle"
     },
-    "valueSchema": {
+    "projectionSchema": {
       "$ref": "#/$defs/JsonSchemaObject"
     },
-    "parserToolHandle": {
+    "ingestorToolHandle": {
       "$ref": "#/$defs/ToolHandle"
     },
+    "ingestorToolInputSchema": {
+      "$ref": "#/$defs/JsonSchemaObject"
+    },
     "embeddingModelTools": {
       "type": "array",
       "items": {
@@ -28,19 +32,31 @@
       "$ref": "#/$defs/DocumentationSpec"
     },
     {
-      "$comment": "A ResourceType must specify either a valueSchema or a parserToolHandle, or both. If only a valueSchema is specified, the author assumes no burden of implementing a parser for the ResourceType. They can rely on the valueSchema for validation. If only a parserToolHandle is specified, the author assumes the burden of implementing a parser that can validate instances of the ResourceType. If both are specified, the author assumes the burden of implementing an augmented parser that also serves as a generator between the raw data and an instance of the valueSchema.",
+      "$comment": "A ResourceType ultimately describes both raw instances and their Core-visible JSON projection. Inside ToolProof Core, the ResourceType denotes the projection. projectionSchema describes the shape of that Core-visible projection. ingestorToolHandle identifies the Tool that ingests raw instances for this ResourceType by validating them against the built-in format grammar and, when projectionSchema is present, emitting the corresponding projection for Core. ingestorToolInputSchema describes the raw-instance input accepted by that ingestor. A ResourceType must specify either a projectionSchema or an ingestorToolHandle, or both. If only a projectionSchema is specified, the author relies on schema-based validation of the Core-visible projection and does not designate an ingestor. If only an ingestorToolHandle is specified, the author designates an ingestor that is authoritative for validating raw instances of the ResourceType. If both are specified, the ingestor must emit projections that conform to projectionSchema.",
       "anyOf": [
         {
           "required": [
-            "valueSchema"
+            "projectionSchema"
           ]
         },
         {
           "required": [
-            "parserToolHandle"
+            "ingestorToolHandle"
           ]
         }
       ]
+    },
+    {
+      "if": {
+        "required": [
+          "ingestorToolInputSchema"
+        ]
+      },
+      "then": {
+        "required": [
+          "ingestorToolHandle"
+        ]
+      }
     }
   ],
   "unevaluatedProperties": false,

package/generated-src/schemas/standalone/Strategy.json

@@ -474,12 +474,12 @@
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
       "required": [
-        "value"
+        "projection"
       ],
       "properties": {
-        "value": true
+        "projection": true
       },
-      "$comment": "This will be overlaid dynamically to match the data structure of the underlying ResourceType's valueSchema.",
+      "$comment": "The projection field stores the Core-visible JSON projection of the Resource, not the raw underlying artifact. This will be overlaid dynamically to match the data structure of the underlying ResourceType's projectionSchema.",
       "allOf": [
         {
           "$ref": "#/$defs/ResourcePointer"
@@ -526,8 +526,7 @@
       "type": "object",
       "required": [
         "id",
-        "resourceTypeHandle",
-        "version"
+        "resourceTypeHandle"
       ],
       "properties": {
         "id": {
@@ -535,9 +534,6 @@
         },
         "resourceTypeHandle": {
           "$ref": "#/$defs/ResourceTypeHandle"
-        },
-        "version": {
-          "const": 1
         }
       },
       "allOf": [

package/generated-src/schemas/standalone/StrategyTrace.json

@@ -654,12 +654,12 @@
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
       "required": [
-        "value"
+        "projection"
       ],
       "properties": {
-        "value": true
+        "projection": true
       },
-      "$comment": "This will be overlaid dynamically to match the data structure of the underlying ResourceType's valueSchema.",
+      "$comment": "The projection field stores the Core-visible JSON projection of the Resource, not the raw underlying artifact. This will be overlaid dynamically to match the data structure of the underlying ResourceType's projectionSchema.",
       "allOf": [
         {
           "$ref": "#/$defs/ResourcePointer"
@@ -706,8 +706,7 @@
       "type": "object",
       "required": [
         "id",
-        "resourceTypeHandle",
-        "version"
+        "resourceTypeHandle"
       ],
       "properties": {
         "id": {
@@ -715,9 +714,6 @@
         },
         "resourceTypeHandle": {
           "$ref": "#/$defs/ResourceTypeHandle"
-        },
-        "version": {
-          "const": 1
         }
       },
       "allOf": [