@enwithai/product-check 0.1.0-alpha.0 → 0.2.0

package/schemas/as-built-spec.schema.json

@@ -0,0 +1,356 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/enwithai/product-check/schemas/as-built-spec.schema.json",
+  "title": "Product Check as-built specification",
+  "description": "A specification reverse-engineered from a repository's structure: the discovered surface (pages, endpoints, entities, integrations, configuration names, authentication boundaries, test titles) with evidence, the requirements derived from it with their certainty, and the clarifications the code cannot answer. Nothing was executed.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "kind",
+    "generated_at",
+    "tool",
+    "target",
+    "surface",
+    "stories",
+    "requirements",
+    "non_functional",
+    "success_criteria",
+    "edge_cases",
+    "clarifications",
+    "uncertainties",
+    "evidence",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": {
+      "$ref": "common.schema.json#/$defs/schema_version"
+    },
+    "kind": {
+      "const": "as-built-spec"
+    },
+    "generated_at": {
+      "$ref": "common.schema.json#/$defs/timestamp"
+    },
+    "tool": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "const": "product-check"
+        },
+        "version": {
+          "type": "string"
+        }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "repository", "commit", "ref"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "repository": {
+          "type": "string"
+        },
+        "commit": {
+          "type": ["string", "null"]
+        },
+        "ref": {
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "surface": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/surface_entry"
+      }
+    },
+    "stories": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/story"
+      }
+    },
+    "requirements": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/requirement"
+      }
+    },
+    "non_functional": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/requirement"
+      }
+    },
+    "success_criteria": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/requirement"
+      }
+    },
+    "edge_cases": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/requirement"
+      }
+    },
+    "clarifications": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "uncertainties": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "$ref": "evidence.schema.json"
+      }
+    },
+    "limitations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["code", "message", "count", "paths"],
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "paths": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "surface_entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "kind",
+        "name",
+        "method",
+        "area",
+        "detail",
+        "location",
+        "certainty",
+        "auth_hint",
+        "evidence_ids"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^SRF-[0-9A-F]{10}$"
+        },
+        "kind": {
+          "enum": ["page", "endpoint", "entity", "config", "integration", "auth-boundary", "test"]
+        },
+        "name": {
+          "type": "string"
+        },
+        "method": {
+          "type": ["string", "null"]
+        },
+        "area": {
+          "type": "string"
+        },
+        "detail": {
+          "type": "string"
+        },
+        "location": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "line"],
+          "properties": {
+            "path": {
+              "type": "string"
+            },
+            "line": {
+              "type": ["integer", "null"],
+              "minimum": 1
+            }
+          }
+        },
+        "certainty": {
+          "enum": ["observed", "inferred"]
+        },
+        "auth_hint": {
+          "type": "boolean"
+        },
+        "evidence_ids": {
+          "type": "array",
+          "items": {
+            "$ref": "common.schema.json#/$defs/evidence_id"
+          }
+        }
+      }
+    },
+    "story": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "area",
+        "title",
+        "critical_journey",
+        "surface_ids",
+        "requirement_ids",
+        "test_behaviours"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^US-[0-9]+$"
+        },
+        "area": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "critical_journey": {
+          "type": ["string", "null"]
+        },
+        "surface_ids": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^SRF-[0-9A-F]{10}$"
+          }
+        },
+        "requirement_ids": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^FR-[0-9]{3,}$"
+          }
+        },
+        "test_behaviours": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "statement", "certainty", "surface_ids", "evidence_ids"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^(FR|NFR|SC|EC)-[0-9]{3,}$"
+        },
+        "statement": {
+          "type": "string"
+        },
+        "certainty": {
+          "enum": ["observed", "inferred", "hypothesis"]
+        },
+        "surface_ids": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^SRF-[0-9A-F]{10}$"
+          }
+        },
+        "evidence_ids": {
+          "type": "array",
+          "items": {
+            "$ref": "common.schema.json#/$defs/evidence_id"
+          }
+        }
+      }
+    },
+    "body": {
+      "description": "The derived content of an as-built spec, as embedded in a blueprint (`as_is.as_built`).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "surface",
+        "stories",
+        "requirements",
+        "non_functional",
+        "success_criteria",
+        "edge_cases",
+        "clarifications",
+        "uncertainties"
+      ],
+      "properties": {
+        "surface": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/surface_entry"
+          }
+        },
+        "stories": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/story"
+          }
+        },
+        "requirements": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "non_functional": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "success_criteria": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "edge_cases": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "clarifications": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "uncertainties": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/blueprint.schema.json

@@ -62,6 +62,9 @@
           "items": {
             "type": "string"
           }
+        },
+        "as_built": {
+          "$ref": "as-built-spec.schema.json#/$defs/body"
         }
       }
     },

package/schemas/scan-contract.schema.json

@@ -282,6 +282,26 @@
         },
         "outcome_check": {
           "type": ["string", "null"]
+        },
+        "architecture_check": {
+          "type": ["string", "null"],
+          "description": "Architecture Check report (schema 1.0 or 1.1). Optional, so contracts from 0.1.0 stay valid."
+        },
+        "openslo": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "maxItems": 50,
+          "description": "OpenSLO v1 files. Optional, so contracts from 0.1.0 stay valid."
+        },
+        "alert_rules": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "maxItems": 50,
+          "description": "Prometheus/Mimir rule files, PrometheusRule resources or /api/v1/rules exports. Optional."
+        },
+        "service_graph": {
+          "type": ["string", "null"],
+          "description": "Jaeger /api/dependencies or service-graph metrics query result. Optional."
         }
       }
     },

package/schemas/scorecard.schema.json

@@ -26,7 +26,7 @@
       "const": "scorecard"
     },
     "rubric_version": {
-      "const": "pc-rubric-0.1"
+      "enum": ["pc-rubric-0.1", "pc-rubric-0.2"]
     },
     "pillars": {
       "type": "object",