@tanqory/dev-mcp 0.0.0-stage → 0.1.0-alpha.1

package/bundled/theme-conformance/schema/conformance-report.v2.schema.json

@@ -0,0 +1,482 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.tanqory.com/theme-artifact/v1/conformance-report.v2.schema.json",
+  "title": "Conformance check report v2 (conformance-report.json)",
+  "description": "Normative schema for b/<buildId>/conformance-report.json, owned by theme-artifact-v1.md §2.1. Derived from the report @tanqory/theme-conformance emits, extended for security v1.10.8 (B-17): the production shim digest, who produced each result, and CPU attempts. The runner ships a copy of this file; where the two differ, this one wins.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "format",
+    "abiVersion",
+    "limitsVersion",
+    "passed",
+    "runner",
+    "artifact",
+    "suites",
+    "measurements",
+    "globals",
+    "startedAt",
+    "finishedAt",
+    "determinism",
+    "selfCheck",
+    "shimDigest"
+  ],
+  "properties": {
+    "format": {
+      "const": "tanqory-conformance-report/2"
+    },
+    "abiVersion": {
+      "type": "string",
+      "pattern": "^2\\.[0-9]+$"
+    },
+    "limitsVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+$"
+    },
+    "passed": {
+      "type": "boolean"
+    },
+    "runner": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "version",
+        "gitHead",
+        "workerd",
+        "chromium",
+        "compatibilityDate",
+        "cpuMeasurement",
+        "compatibilityFlags"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        },
+        "gitHead": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$",
+          "description": "Build commit of the runner (theme-artifact-v1.md §2.1 canonical runner identity)."
+        },
+        "workerd": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]{8}\\.[0-9]+$"
+        },
+        "chromium": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Chromium version suite 5 drove; null only when suite 5 launched no browser."
+        },
+        "compatibilityDate": {
+          "type": "string",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+          "description": "Must equal RUNTIME_COMPATIBILITY_DATE exported by @tanqory/theme-abi."
+        },
+        "cpuMeasurement": {
+          "const": "wall-clock-in-isolate",
+          "description": "Elapsed time measured inside the isolate: an upper bound on CPU."
+        },
+        "compatibilityFlags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true,
+          "description": "Must equal RUNTIME_COMPATIBILITY_FLAGS exported by @tanqory/theme-abi."
+        }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "kind",
+        "manifestDigest",
+        "entryDigest",
+        "artifactDigest"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "not": {
+            "pattern": "^(/|[A-Za-z]:[\\\\/]|~)"
+          },
+          "description": "relative path or directory name — never an absolute local path"
+        },
+        "kind": {
+          "enum": [
+            "artifact-dir",
+            "theme-dir"
+          ]
+        },
+        "manifestDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "entryDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "artifactDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "name": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        }
+      }
+    },
+    "suites": {
+      "type": "array",
+      "minItems": 9,
+      "maxItems": 9,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "name",
+          "status",
+          "checks",
+          "durationMs",
+          "producedBy"
+        ],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 9
+          },
+          "name": {
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/$defs/suiteStatus"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "durationMs": {
+            "type": "number",
+            "minimum": 0
+          },
+          "checks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "id",
+                "status"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "status": {
+                  "$ref": "#/$defs/status"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "details": {}
+              }
+            }
+          },
+          "producedBy": {
+            "$ref": "#/$defs/producedBy"
+          }
+        }
+      }
+    },
+    "measurements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "unit",
+          "value",
+          "budget",
+          "hard",
+          "status",
+          "producedBy"
+        ],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "unit": {
+            "enum": [
+              "ms",
+              "bytes",
+              "count",
+              "percent"
+            ]
+          },
+          "value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "samples": {
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "budget": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "hard": {
+            "type": [
+              "number",
+              "null"
+            ],
+            "description": "null = budget-only row (theme-abi-v2.md §8): never refuses."
+          },
+          "status": {
+            "enum": [
+              "ok",
+              "budget_exceeded",
+              "hard_exceeded",
+              "not_measured"
+            ]
+          },
+          "note": {
+            "type": "string"
+          },
+          "producedBy": {
+            "$ref": "#/$defs/producedBy"
+          },
+          "method": {
+            "enum": [
+              "wall-clock-in-isolate"
+            ],
+            "description": "CPU rows only."
+          },
+          "upperBound": {
+            "const": true,
+            "description": "CPU rows only: the value bounds CPU from above."
+          },
+          "attempts": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 3,
+            "items": {
+              "$ref": "#/$defs/cpuAttempt"
+            },
+            "description": "CPU rows only: each attempt is a fresh isolate rendering every sample including the cold one."
+          },
+          "attemptCount": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 3
+          }
+        }
+      }
+    },
+    "globals": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "snapshot",
+        "deleted",
+        "notDeletable",
+        "unexpected",
+        "enforcement"
+      ],
+      "properties": {
+        "snapshot": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "deleted": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "notDeletable": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "unexpected": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "enforcement": {
+          "type": "object",
+          "additionalProperties": {
+            "enum": [
+              "deleted",
+              "shadowed",
+              "tripwired",
+              "absent",
+              "unenforced"
+            ]
+          }
+        },
+        "shadowed": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Names made unreachable by an own shadowing property (ABI Appendix C.2)."
+        }
+      }
+    },
+    "startedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "finishedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "determinism": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "runtimeVersion",
+        "compatibilityDate",
+        "fixture",
+        "outputSha256"
+      ],
+      "properties": {
+        "runtimeVersion": {
+          "type": "string",
+          "pattern": "^workerd@1\\.[0-9]{8}\\.[0-9]+$"
+        },
+        "compatibilityDate": {
+          "type": "string",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+        },
+        "fixture": {
+          "type": "string"
+        },
+        "outputSha256": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/digest"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "selfCheck": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "runner",
+        "version",
+        "gitHead",
+        "workerd",
+        "passed"
+      ],
+      "properties": {
+        "runner": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        },
+        "gitHead": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        },
+        "workerd": {
+          "type": "string"
+        },
+        "passed": {
+          "type": "boolean"
+        }
+      }
+    },
+    "shimDigest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$",
+      "description": "Digest of the production host shim whose bytes produced every result marked production-shim. Defined by capability-security §6.6.3."
+    }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "status": {
+      "enum": [
+        "pass",
+        "fail",
+        "skipped",
+        "not_applicable"
+      ]
+    },
+    "suiteStatus": {
+      "enum": [
+        "pass",
+        "fail",
+        "incomplete",
+        "not_applicable"
+      ]
+    },
+    "producedBy": {
+      "enum": [
+        "production-shim",
+        "static",
+        "none",
+        "other"
+      ],
+      "description": "production-shim: every render behind this result ran on the bytes named by shimDigest. static: computed from the artifact bytes, no render. none: the suite did not run (allowed only where it may be not_applicable). other: anything else; satisfies nothing."
+    },
+    "cpuAttempt": {
+      "type": "object",
+      "required": [
+        "samples",
+        "loadAverage"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "samples": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "number",
+            "minimum": 0
+          },
+          "description": "Every sample of this attempt in order; the first is the cold one."
+        },
+        "loadAverage": {
+          "type": "array",
+          "minItems": 3,
+          "maxItems": 3,
+          "items": {
+            "type": "number",
+            "minimum": 0
+          },
+          "description": "1, 5 and 15 minute load average of the machine when the attempt started."
+        }
+      }
+    }
+  }
+}

package/bundled/theme-conformance/schema/storefront-report.v1.schema.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.tanqory.com/theme/storefront-report.v1.schema.json",
+  "title": "storefront-report.json — the storefront and budgets tiers (tanqory-storefront-report/1)",
+  "description": "Written by `theme-conformance run <dir> --tier storefront|budgets|all` (docs/storefront-tier.md). Separate from conformance-report.json (format 2), which it never changes.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["format", "hooksVersion", "tiers", "passed", "summary", "runner", "artifact", "fixture", "checks", "measurements", "evidenceDir", "startedAt", "finishedAt"],
+  "properties": {
+    "format": { "const": "tanqory-storefront-report/1" },
+    "hooksVersion": { "const": "tq-storefront-hooks/1" },
+    "tiers": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/tier" } },
+    "passed": { "type": "boolean", "description": "true when no check is fail or incomplete" },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pass", "fail", "warn", "not_applicable", "incomplete"],
+      "properties": { "pass": { "$ref": "#/$defs/count" }, "fail": { "$ref": "#/$defs/count" }, "warn": { "$ref": "#/$defs/count" }, "not_applicable": { "$ref": "#/$defs/count" }, "incomplete": { "$ref": "#/$defs/count" } }
+    },
+    "runner": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version", "gitHead", "workerd", "chromium", "playwright", "shim"],
+      "properties": {
+        "name": { "type": "string" },
+        "version": { "type": "string" },
+        "gitHead": { "type": ["string", "null"] },
+        "workerd": { "type": "string" },
+        "chromium": { "type": ["string", "null"] },
+        "playwright": { "type": "string" },
+        "shim": { "const": "conformance-harness" }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "manifestDigest", "artifactDigest"],
+      "properties": {
+        "path": { "type": "string" },
+        "name": { "type": "string" },
+        "version": { "type": "string" },
+        "manifestDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "artifactDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+      }
+    },
+    "fixture": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "storefront", "languages", "markets"],
+      "properties": {
+        "name": { "type": "string" },
+        "storefront": { "type": "string" },
+        "languages": { "type": "array", "items": { "type": "string" } },
+        "markets": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "checks": { "type": "array", "items": { "$ref": "#/$defs/check" } },
+    "measurements": { "type": "array", "items": { "$ref": "#/$defs/measurement" } },
+    "evidenceDir": { "type": ["string", "null"] },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "finishedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "count": { "type": "integer", "minimum": 0 },
+    "tier": { "enum": ["storefront", "budgets"] },
+    "check": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "tier", "group", "title", "status"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(:[a-z0-9-]+)+$" },
+        "tier": { "$ref": "#/$defs/tier" },
+        "group": { "type": "string" },
+        "title": { "type": "string" },
+        "status": { "enum": ["pass", "fail", "warn", "not_applicable", "incomplete"] },
+        "message": { "type": "string" },
+        "route": { "type": "string" },
+        "locale": { "type": "string" },
+        "viewport": { "enum": ["desktop", "mobile"] },
+        "evidence": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "selector": { "type": "string" },
+            "screenshot": { "type": "string" },
+            "url": { "type": "string" },
+            "details": {}
+          }
+        },
+        "fixHint": { "type": "string" }
+      },
+      "if": { "properties": { "status": { "enum": ["fail", "warn", "incomplete"] } } },
+      "then": { "properties": { "fixHint": { "type": "string", "minLength": 1 } }, "required": ["fixHint"] }
+    },
+    "measurement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "unit", "value", "budget", "method", "status"],
+      "properties": {
+        "name": { "type": "string" },
+        "unit": { "enum": ["bytes", "score", "ms", "unitless"] },
+        "value": { "type": ["number", "null"] },
+        "budget": { "type": ["number", "null"] },
+        "method": { "enum": ["static", "runtime", "lab-approximation"] },
+        "status": { "enum": ["ok", "over_budget", "not_measured"] },
+        "note": { "type": "string" }
+      }
+    }
+  }
+}

package/bundled/theme-conformance/schema/x-tanqory-ai.v0.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.tanqory.com/theme/x-tanqory-ai.v0.schema.json",
+  "title": "x-tanqory-ai profile (draft v0)",
+  "description": "DRAFT, owned by the theme-kit / AI-compat work (docs/storefront-tier.md §7). Declared as manifest[\"x-tanqory-ai\"]. It tells Tanqory AI which of the theme's own sections and settings play the roles it fills (hero, header menu, footer menus, brand), so AI can compose any theme without Nova's vocabulary. The storefront tier only WARNS on it until the profile is final.",
+  "type": "object",
+  "required": ["version", "roles"],
+  "additionalProperties": false,
+  "properties": {
+    "version": { "const": 0 },
+    "roles": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "hero": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/hero" } },
+        "headerMenu": { "$ref": "#/$defs/menuRole" },
+        "footerMenus": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/menuRole" } },
+        "footerBrand": { "$ref": "#/$defs/target" },
+        "productGrid": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/resourceRole" } },
+        "richText": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/textRole" } }
+      }
+    }
+  },
+  "$defs": {
+    "key": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$" },
+    "target": {
+      "type": "object",
+      "required": ["component"],
+      "properties": {
+        "component": { "$ref": "#/$defs/key", "description": "manifest.components key of the section" },
+        "block": { "$ref": "#/$defs/key", "description": "manifest.components key of a block inside it, when the role lives on a block" }
+      }
+    },
+    "hero": {
+      "allOf": [{ "$ref": "#/$defs/target" }],
+      "type": "object",
+      "unevaluatedProperties": false,
+      "properties": {
+        "component": true, "block": true,
+        "heading": { "$ref": "#/$defs/key" },
+        "subheading": { "$ref": "#/$defs/key" },
+        "image": { "$ref": "#/$defs/key" },
+        "button": { "$ref": "#/$defs/key" },
+        "link": { "$ref": "#/$defs/key" }
+      },
+      "required": ["heading"]
+    },
+    "menuRole": {
+      "allOf": [{ "$ref": "#/$defs/target" }],
+      "type": "object",
+      "unevaluatedProperties": false,
+      "properties": { "component": true, "block": true, "setting": { "$ref": "#/$defs/key", "description": "a setting of type menu" } },
+      "required": ["setting"]
+    },
+    "resourceRole": {
+      "allOf": [{ "$ref": "#/$defs/target" }],
+      "type": "object",
+      "unevaluatedProperties": false,
+      "properties": { "component": true, "block": true, "setting": { "$ref": "#/$defs/key", "description": "a setting of type collection or product" }, "heading": { "$ref": "#/$defs/key" } },
+      "required": ["setting"]
+    },
+    "textRole": {
+      "allOf": [{ "$ref": "#/$defs/target" }],
+      "type": "object",
+      "unevaluatedProperties": false,
+      "properties": { "component": true, "block": true, "heading": { "$ref": "#/$defs/key" }, "body": { "$ref": "#/$defs/key" } }
+    }
+  }
+}