sneakoscope 8.3.2 → 8.4.0

package/schemas/architecture-baseline.v1.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sneakoscope.local/schemas/architecture-baseline.v1.schema.json",
+  "title": "SKS Architecture Baseline V1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema",
+    "missionId",
+    "required",
+    "capturedBeforeMutation",
+    "worktreeFingerprintHash",
+    "graphHash",
+    "policyHash",
+    "analyzerVersion",
+    "serializerVersion",
+    "metrics",
+    "findings",
+    "canonicalPayloadHash",
+    "seal"
+  ],
+  "properties": {
+    "schema": { "const": "sks.architecture-baseline.v1" },
+    "missionId": { "type": "string", "minLength": 1 },
+    "routeId": { "type": "string" },
+    "taskProfile": { "type": "string" },
+    "required": { "const": true },
+    "capturedAt": { "type": "string", "minLength": 1 },
+    "capturedBeforeMutation": { "const": true },
+    "repositoryHead": { "type": ["string", "null"] },
+    "worktreeFingerprintHash": { "type": "string", "minLength": 1 },
+    "preexistingDirtyPaths": { "type": "array", "items": { "type": "string" } },
+    "graphHash": { "type": "string", "minLength": 1 },
+    "topologyHash": { "type": "string" },
+    "ssotInventoryHash": { "type": "string" },
+    "voxelContextHash": { "type": "string" },
+    "policyHash": { "type": "string", "minLength": 1 },
+    "analyzerVersion": { "type": "string", "minLength": 1 },
+    "serializerVersion": { "type": "string", "minLength": 1 },
+    "scope": { "type": "object" },
+    "metrics": { "type": "object" },
+    "findings": { "type": "array" },
+    "viewHashes": { "type": "object" },
+    "canonicalPayloadHash": { "type": "string", "minLength": 1 },
+    "seal": { "type": "string", "minLength": 1 }
+  }
+}

package/schemas/architecture-map-manifest.v1.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sneakoscope.local/schemas/architecture-map-manifest.v1.schema.json",
+  "title": "SKS Architecture Map Manifest V1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema",
+    "graphHash",
+    "policyHash",
+    "serializerVersion",
+    "views",
+    "projectionAccounting"
+  ],
+  "properties": {
+    "schema": { "const": "sks.architecture-map-manifest.v1" },
+    "missionId": { "type": ["string", "null"] },
+    "graphHash": { "type": "string", "minLength": 1 },
+    "topologyHash": { "type": "string" },
+    "policyHash": { "type": "string", "minLength": 1 },
+    "inputBundleHash": { "type": "string" },
+    "analyzerVersion": { "type": "string", "minLength": 1 },
+    "serializerVersion": { "type": "string", "minLength": 1 },
+    "views": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["viewId", "contentHash", "byteLength"],
+        "properties": {
+          "viewId": { "type": "string", "minLength": 1 },
+          "contentHash": { "type": "string", "minLength": 1 },
+          "byteLength": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "projectionAccounting": { "type": "object" },
+    "sourceBinding": { "type": "object" }
+  }
+}

package/schemas/architecture-map-policy.v1.schema.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sneakoscope.local/schemas/architecture-map-policy.v1.schema.json",
+  "title": "SKS Architecture Map Policy V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "layers", "boundaries", "thresholds", "exceptions"],
+  "properties": {
+    "schema": { "const": "sks.architecture-map-policy.v1" },
+    "version": { "type": "integer", "minimum": 1 },
+    "module_id_source": { "type": "string", "minLength": 1 },
+    "layers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "purpose", "modules"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "purpose": { "type": "string", "minLength": 1 },
+          "modules": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "boundaries": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "allow"],
+      "properties": {
+        "mode": { "const": "allow-list" },
+        "allow": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["from", "to"],
+            "properties": {
+              "from": { "type": "string", "minLength": 1 },
+              "to": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+            }
+          }
+        }
+      }
+    },
+    "thresholds": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "max_diagram_nodes",
+        "max_diagram_edges",
+        "max_diagram_bytes",
+        "max_module_fan_out",
+        "max_module_fan_in"
+      ],
+      "properties": {
+        "max_diagram_nodes": { "type": "integer", "minimum": 1 },
+        "max_diagram_edges": { "type": "integer", "minimum": 1 },
+        "max_diagram_bytes": { "type": "integer", "minimum": 1 },
+        "max_module_fan_out": { "type": "integer", "minimum": 1 },
+        "max_module_fan_in": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "profiles": { "type": "object", "additionalProperties": true },
+    "absoluteTokenCeiling": { "type": "integer", "minimum": 0 },
+    "globalAtlasMaxBytes": { "type": "integer", "minimum": 1 },
+    "missionArtifactsMaxBytes": { "type": "integer", "minimum": 1 },
+    "accuracyFloors": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "changedPathAccounting": { "type": "number", "minimum": 0, "maximum": 1 },
+        "projectionAccounting": { "type": "number", "minimum": 0, "maximum": 1 },
+        "protectedRelationRecall": { "type": "number", "minimum": 0, "maximum": 1 },
+        "eligibleExtractionSuccess": { "type": "number", "minimum": 0, "maximum": 1 },
+        "deterministicHashRuns": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "dependencyRules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["id", "effect", "severity"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "from": { "type": "string" },
+          "to": { "type": "string" },
+          "effect": { "enum": ["deny", "allow"] },
+          "severity": { "enum": ["blocking", "warning", "info"] },
+          "description": { "type": "string" }
+        }
+      }
+    },
+    "viewBudgets": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "maxNodes": { "type": "integer", "minimum": 1 },
+          "maxEdges": { "type": "integer", "minimum": 1 }
+        }
+      }
+    },
+    "blockingCodes": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "exceptions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "entries"],
+      "properties": {
+        "mode": { "const": "shrink-only" },
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "reason",
+              "edges",
+              "baseline_module_edges",
+              "ceiling_module_edges"
+            ],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "reason": { "type": "string", "minLength": 1 },
+              "edges": {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": "string", "minLength": 1 }
+              },
+              "baseline_module_edges": { "type": "integer", "minimum": 1 },
+              "ceiling_module_edges": { "type": "integer", "minimum": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/architecture-review.v1.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sneakoscope.local/schemas/architecture-review.v1.schema.json",
+  "title": "SKS Architecture Review V1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema",
+    "missionId",
+    "baselineSeal",
+    "baselineHash",
+    "afterInputHash",
+    "changedPaths",
+    "accountedChangedPaths",
+    "unaccountedChangedPaths",
+    "beforeMetrics",
+    "afterMetrics",
+    "newFindings",
+    "verdict",
+    "blockingFindingIds",
+    "canonicalPayloadHash"
+  ],
+  "properties": {
+    "schema": { "const": "sks.architecture-review.v1" },
+    "missionId": { "type": "string", "minLength": 1 },
+    "baselineSeal": { "type": "string", "minLength": 1 },
+    "baselineHash": { "type": "string", "minLength": 1 },
+    "afterInputHash": { "type": "string", "minLength": 1 },
+    "changedPaths": { "type": "array" },
+    "accountedChangedPaths": { "type": "array", "items": { "type": "string" } },
+    "unaccountedChangedPaths": { "type": "array", "items": { "type": "string" } },
+    "beforeMetrics": { "type": "object" },
+    "afterMetrics": { "type": "object" },
+    "metricDelta": { "type": "object" },
+    "newFindings": { "type": "array" },
+    "resolvedFindings": { "type": "array" },
+    "persistentFindings": { "type": "array" },
+    "acceptedExceptions": { "type": "array" },
+    "projectionAccounting": { "type": "object" },
+    "verification": { "type": "object" },
+    "verdict": { "enum": ["pass", "block"] },
+    "blockingFindingIds": { "type": "array", "items": { "type": "string" } },
+    "canonicalPayloadHash": { "type": "string", "minLength": 1 },
+    "generatedAt": { "type": "string" }
+  }
+}

package/schemas/mermaid-projection.v1.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sneakoscope.local/schemas/mermaid-projection.v1.schema.json",
+  "title": "SKS Mermaid Projection V1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema",
+    "viewId",
+    "direction",
+    "title",
+    "source",
+    "accounting",
+    "contentHash"
+  ],
+  "properties": {
+    "schema": { "const": "sks.mermaid-projection.v1" },
+    "viewId": { "type": "string", "minLength": 1 },
+    "direction": { "enum": ["LR", "TD"] },
+    "title": { "type": "string", "minLength": 1 },
+    "source": { "type": "string", "minLength": 1 },
+    "accounting": {
+      "type": "object",
+      "required": [
+        "selectedNodeIds",
+        "emittedNodeIds",
+        "omittedNodes",
+        "selectedEdgeIds",
+        "emittedEdgeIds",
+        "omittedEdges"
+      ],
+      "properties": {
+        "selectedNodeIds": { "type": "array", "items": { "type": "string" } },
+        "emittedNodeIds": { "type": "array", "items": { "type": "string" } },
+        "aggregatedNodeMembers": { "type": "object" },
+        "omittedNodes": { "type": "array" },
+        "selectedEdgeIds": { "type": "array", "items": { "type": "string" } },
+        "emittedEdgeIds": { "type": "array", "items": { "type": "string" } },
+        "aggregatedEdgeMembers": { "type": "object" },
+        "omittedEdges": { "type": "array" }
+      }
+    },
+    "contentHash": { "type": "string", "minLength": 1 },
+    "byteLength": { "type": "integer", "minimum": 0 },
+    "omissions": { "type": "array" }
+  }
+}