fix(packaging): ship rules.manifest + schemas to npm; prepare runs build

Closes three packaging defects flagged in the post-governance audit:

- package.json files: add rules.manifest.json so consumers installing
  from npm can read the canonical machine-readable rule surface the
  repo now treats as load-bearing. (schema/ was already covered.)

- prepare: was tsc only; now runs the full build pipeline (tsc +
  schemas + rules manifest). git-based installs and any workflow that
  triggers npm prepare get every generated artefact, not just the
  TypeScript compiler output.

- schema/rules.manifest.schema.json: the source comments referenced
  this file as the validating JSON Schema for rules.manifest.json
  but it was never emitted. build-schemas.mjs now generates it from
  RulesManifestSchema alongside the submission-related schemas.

Author: jasonodoom

package.json

@@ -13,7 +13,7 @@
   },
   "scripts": {
     "build": "tsc && node scripts/build-schemas.mjs && node scripts/build-rules-manifest.mjs",
-    "prepare": "tsc",
+    "prepare": "tsc && node scripts/build-schemas.mjs && node scripts/build-rules-manifest.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
@@ -35,6 +35,7 @@
     "docs/artwork/*.svg",
     "docs/artwork/README.md",
     "schema",
+    "rules.manifest.json",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",

schema/rules.manifest.schema.json

@@ -0,0 +1,139 @@
+{
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Manifest format version. Independent of the framework version that generated it."
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "counts": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "experimental": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "stable": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "deprecated": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "byEngine": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "propertyNames": {
+            "enum": [
+              "source",
+              "cross",
+              "vision",
+              "mobile"
+            ]
+          }
+        }
+      },
+      "required": [
+        "total",
+        "experimental",
+        "stable",
+        "deprecated",
+        "byEngine"
+      ],
+      "additionalProperties": false,
+      "description": "Pre-computed counts for downstream consumers (parity CI, release notes, README). Derivable from `rules` but emitted to keep readers from having to recount."
+    },
+    "rules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^ahd\\/[a-z0-9/-]+$"
+          },
+          "engine": {
+            "type": "string",
+            "enum": [
+              "source",
+              "cross",
+              "vision",
+              "mobile"
+            ]
+          },
+          "surface": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Subsurfaces the rule operates on (html, css, jsx, tsx, tailwind, svg, vision, mobile, etc.). Optional; mobile and vision rules typically omit since the engine implies the surface."
+          },
+          "severity": {
+            "type": "string",
+            "enum": [
+              "error",
+              "warn",
+              "info"
+            ],
+            "description": "error fails CI; warn prints; info advisory. Vision rules ship at warn by convention since they emit from a probabilistic critic."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "experimental",
+              "stable",
+              "deprecated"
+            ]
+          },
+          "introducedAt": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Semver-shaped string identifying the version that first shipped the rule. Pre-0.9 rules use '<= 0.8.x'."
+          },
+          "deprecatedAt": {
+            "type": "string"
+          },
+          "deprecationReason": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "id",
+          "engine",
+          "severity",
+          "status",
+          "introducedAt",
+          "description"
+        ],
+        "additionalProperties": false
+      },
+      "minItems": 1
+    }
+  },
+  "required": [
+    "version",
+    "generatedAt",
+    "counts",
+    "rules"
+  ],
+  "additionalProperties": false,
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ahd.adastra.computer/schema/rules.manifest.schema.json",
+  "title": "AHD rules manifest (governance Layer 1)"
+}

scripts/build-schemas.mjs

@@ -26,6 +26,7 @@ const {
   ManifestCurrentSchema,
   ManifestTargetSchema,
   SampleEnvelopeTargetSchema,
+  RulesManifestSchema,
 } = await import(pathToFileURL(distTypes).href);
 
 const schemaDir = resolve(root, "schema");
@@ -67,3 +68,9 @@ emit(
   "https://ahd.adastra.computer/schema/sample-envelope.target.schema.json",
   "AHD per-sample envelope (target shape)",
 );
+emit(
+  "rules.manifest",
+  RulesManifestSchema,
+  "https://ahd.adastra.computer/schema/rules.manifest.schema.json",
+  "AHD rules manifest (governance Layer 1)",
+);