@qa-ai-stlc/schemas 0.0.0

package/dist/json-schema/run-result.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "testCaseId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "testType": {
+      "type": "string",
+      "enum": [
+        "e2e",
+        "api",
+        "a11y"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "passed",
+        "failed",
+        "blocked",
+        "skipped",
+        "uncertain",
+        "partial"
+      ]
+    },
+    "startedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    },
+    "finishedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    },
+    "evidenceIds": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "failure": {
+      "type": "object",
+      "properties": {
+        "message": {
+          "type": "string",
+          "minLength": 1
+        },
+        "stack": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "id",
+    "runId",
+    "testCaseId",
+    "testType",
+    "status",
+    "startedAt",
+    "finishedAt",
+    "evidenceIds"
+  ],
+  "additionalProperties": false
+}

package/dist/json-schema/scope.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    },
+    "requirements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": {
+            "type": "string"
+          },
+          "source": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "const": "file"
+                  },
+                  "path": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "required": [
+                  "kind",
+                  "path"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "const": "text"
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "required": [
+                  "kind",
+                  "label"
+                ],
+                "additionalProperties": false
+              }
+            ]
+          },
+          "inScope": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "id",
+          "title",
+          "source",
+          "inScope"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "requirements"
+  ],
+  "additionalProperties": false
+}

package/dist/json-schema/selector-registry.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    },
+    "elements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "elementId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "kind": {
+            "type": "string",
+            "minLength": 1
+          },
+          "library": {
+            "type": "string"
+          },
+          "locatorCandidates": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "strategy": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "value": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "fragile": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "strategy",
+                "value",
+                "fragile"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "stabilityScore": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          "lastVerifiedAt": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+          },
+          "pii": {
+            "type": "boolean"
+          },
+          "dynamicText": {
+            "type": "boolean"
+          },
+          "source": {
+            "type": "string",
+            "enum": [
+              "crawl",
+              "static",
+              "manual"
+            ]
+          },
+          "deprecatedAt": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+          }
+        },
+        "required": [
+          "elementId",
+          "kind",
+          "locatorCandidates",
+          "stabilityScore",
+          "lastVerifiedAt",
+          "pii",
+          "dynamicText",
+          "source"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "elements"
+  ],
+  "additionalProperties": false
+}

package/dist/json-schema/test-case.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "requirementIds": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "testType": {
+      "type": "string",
+      "enum": [
+        "e2e",
+        "api",
+        "a11y"
+      ]
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "steps": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "description": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "description"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "expectedResult": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft",
+        "approved",
+        "rejected"
+      ]
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "id",
+    "requirementIds",
+    "testType",
+    "title",
+    "steps",
+    "expectedResult",
+    "status",
+    "createdAt"
+  ],
+  "additionalProperties": false
+}

package/dist/manifest.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const ManifestEntrySchema: z.ZodObject<{
+    sha256: z.ZodString;
+    registeredAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type ManifestEntry = z.infer<typeof ManifestEntrySchema>;
+export declare const ManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    artifacts: z.ZodRecord<z.ZodString, z.ZodObject<{
+        sha256: z.ZodString;
+        registeredAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Manifest = z.infer<typeof ManifestSchema>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,cAAc;;;;;;iBAIzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,19 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { z } from 'zod';
+import { IsoDateTimeSchema, RelativePathSchema, Sha256HexSchema } from './primitives.js';
+import { SCHEMA_VERSION, SchemaVersionSchema } from './version.js';
+export const ManifestEntrySchema = z.object({
+    sha256: Sha256HexSchema,
+    registeredAt: IsoDateTimeSchema,
+});
+// `.qa/manifest.json`: the hash of every registered artifact (AGENTS.md 2.5). `qa validate` and
+// every MCP mutation reject a file that is unregistered or whose content no longer matches its
+// recorded hash, so an agent cannot make a direct filesystem write pass for an engine-produced
+// artifact.
+export const ManifestSchema = z.object({
+    schemaVersion: SchemaVersionSchema.default(SCHEMA_VERSION),
+    // Keyed by the artifact's project-relative path.
+    artifacts: z.record(RelativePathSchema, ManifestEntrySchema),
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,eAAe;IACvB,YAAY,EAAE,iBAAiB;CAChC,CAAC,CAAC;AAGH,gGAAgG;AAChG,+FAA+F;AAC/F,+FAA+F;AAC/F,YAAY;AACZ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,aAAa,EAAE,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC;IAC1D,iDAAiD;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;CAC7D,CAAC,CAAC"}

package/dist/primitives.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const Sha256HexSchema: z.ZodString;
+export type Sha256Hex = z.infer<typeof Sha256HexSchema>;
+export declare const RelativePathSchema: z.ZodString;
+export type RelativePath = z.infer<typeof RelativePathSchema>;
+export declare const IsoDateTimeSchema: z.ZodISODateTime;
+export type IsoDateTime = z.infer<typeof IsoDateTimeSchema>;
+export declare const IdentifierSchema: z.ZodString;
+export type Identifier = z.infer<typeof IdentifierSchema>;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe,aAEqD,CAAC;AAClF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAQxD,eAAO,MAAM,kBAAkB,aAU5B,CAAC;AACJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB,kBAAmC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,gBAAgB,aAAoB,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/primitives.js

@@ -0,0 +1,21 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { z } from 'zod';
+export const Sha256HexSchema = z
+    .string()
+    .regex(/^[0-9a-f]{64}$/, 'must be a lowercase 64-character SHA-256 hex digest');
+// Artifact paths are project-relative and use `/` on every OS (AGENTS.md 5.6), never an absolute
+// path or a Windows backslash, so a hash or a reference recorded on one OS still resolves on
+// another. A drive-letter prefix (`C:/x`, `C:x`) is also absolute on Windows even though it
+// starts with neither `/` nor `\`.
+const DRIVE_LETTER_PREFIX = /^[A-Za-z]:/;
+export const RelativePathSchema = z
+    .string()
+    .min(1)
+    .refine((value) => !value.startsWith('/') &&
+    !value.includes('\\') &&
+    !DRIVE_LETTER_PREFIX.test(value) &&
+    !value.split('/').includes('..'), 'must be a project-relative, forward-slash path with no ".." segments');
+export const IsoDateTimeSchema = z.iso.datetime({ offset: true });
+export const IdentifierSchema = z.string().min(1);
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,KAAK,CAAC,gBAAgB,EAAE,qDAAqD,CAAC,CAAC;AAGlF,iGAAiG;AACjG,6FAA6F;AAC7F,4FAA4F;AAC5F,mCAAmC;AACnC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;IACtB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;IACrB,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;IAChC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAClC,sEAAsE,CACvE,CAAC;AAGJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAGlE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/dist/rca.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const RcaHypothesisSchema: z.ZodObject<{
+    description: z.ZodString;
+    confidence: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>;
+    evidenceNeeded: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RcaHypothesis = z.infer<typeof RcaHypothesisSchema>;
+export declare const RcaStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    rejected: "rejected";
+    approved: "approved";
+}>;
+export type RcaStatus = z.infer<typeof RcaStatusSchema>;
+export declare const RcaSchema: z.ZodObject<{
+    schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    defectId: z.ZodString;
+    facts: z.ZodArray<z.ZodString>;
+    hypotheses: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        confidence: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>;
+        evidenceNeeded: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    remediation: z.ZodArray<z.ZodString>;
+    regressionRecommendation: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        draft: "draft";
+        rejected: "rejected";
+        approved: "approved";
+    }>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type Rca = z.infer<typeof RcaSchema>;
+//# sourceMappingURL=rca.d.ts.map

package/dist/rca.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rca.d.ts","sourceRoot":"","sources":["../src/rca.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,mBAAmB;;;;;;;;iBAI9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;EAA4C,CAAC;AACzE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAKxD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;iBASpB,CAAC;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/rca.js

@@ -0,0 +1,26 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { z } from 'zod';
+import { IdentifierSchema, IsoDateTimeSchema } from './primitives.js';
+import { SecurityConfidenceSchema } from './defect.js';
+import { SCHEMA_VERSION, SchemaVersionSchema } from './version.js';
+export const RcaHypothesisSchema = z.object({
+    description: z.string().min(1),
+    confidence: SecurityConfidenceSchema,
+    evidenceNeeded: z.string().optional(),
+});
+export const RcaStatusSchema = z.enum(['draft', 'approved', 'rejected']);
+// An RCA exists only for a defect in state `accepted` and separates confirmed facts from
+// hypotheses (development plan section 2.4). Only an `approved` RCA attaches to the report and
+// the release recommendation.
+export const RcaSchema = z.object({
+    schemaVersion: SchemaVersionSchema.default(SCHEMA_VERSION),
+    defectId: IdentifierSchema,
+    facts: z.array(z.string().min(1)),
+    hypotheses: z.array(RcaHypothesisSchema).min(1),
+    remediation: z.array(z.string().min(1)),
+    regressionRecommendation: z.string().optional(),
+    status: RcaStatusSchema,
+    createdAt: IsoDateTimeSchema,
+});
+//# sourceMappingURL=rca.js.map

package/dist/rca.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rca.js","sourceRoot":"","sources":["../src/rca.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,UAAU,EAAE,wBAAwB;IACpC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAGzE,yFAAyF;AACzF,+FAA+F;AAC/F,8BAA8B;AAC9B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,aAAa,EAAE,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC;IAC1D,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvC,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/C,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,iBAAiB;CAC7B,CAAC,CAAC"}

package/dist/run-result.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export declare const RunResultStatusSchema: z.ZodEnum<{
+    passed: "passed";
+    failed: "failed";
+    blocked: "blocked";
+    skipped: "skipped";
+    uncertain: "uncertain";
+    partial: "partial";
+}>;
+export type RunResultStatus = z.infer<typeof RunResultStatusSchema>;
+export declare const RunResultFailureSchema: z.ZodObject<{
+    message: z.ZodString;
+    stack: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RunResultFailure = z.infer<typeof RunResultFailureSchema>;
+export declare const RunResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    id: z.ZodString;
+    runId: z.ZodString;
+    testCaseId: z.ZodString;
+    testType: z.ZodEnum<{
+        e2e: "e2e";
+        api: "api";
+        a11y: "a11y";
+    }>;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        blocked: "blocked";
+        skipped: "skipped";
+        uncertain: "uncertain";
+        partial: "partial";
+    }>;
+    startedAt: z.ZodISODateTime;
+    finishedAt: z.ZodISODateTime;
+    evidenceIds: z.ZodArray<z.ZodString>;
+    failure: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RunResult = z.infer<typeof RunResultSchema>;
+//# sourceMappingURL=run-result.d.ts.map

package/dist/run-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result.d.ts","sourceRoot":"","sources":["../src/run-result.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,qBAAqB;;;;;;;EAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBxB,CAAC;AACL,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/run-result.js

@@ -0,0 +1,44 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { z } from 'zod';
+import { IdentifierSchema, IsoDateTimeSchema } from './primitives.js';
+import { TestTypeSchema } from './test-case.js';
+import { SCHEMA_VERSION, SchemaVersionSchema } from './version.js';
+// `blocked`, `skipped`, `uncertain` and `partial` are honest statuses, never reported as `passed`
+// or `failed` (AGENTS.md 12.5): a result the engine could not fully determine must say so.
+export const RunResultStatusSchema = z.enum([
+    'passed',
+    'failed',
+    'blocked',
+    'skipped',
+    'uncertain',
+    'partial',
+]);
+export const RunResultFailureSchema = z.object({
+    message: z.string().min(1),
+    stack: z.string().optional(),
+});
+export const RunResultSchema = z
+    .object({
+    schemaVersion: SchemaVersionSchema.default(SCHEMA_VERSION),
+    id: IdentifierSchema,
+    runId: IdentifierSchema,
+    testCaseId: IdentifierSchema,
+    testType: TestTypeSchema,
+    status: RunResultStatusSchema,
+    startedAt: IsoDateTimeSchema,
+    finishedAt: IsoDateTimeSchema,
+    evidenceIds: z.array(IdentifierSchema),
+    failure: RunResultFailureSchema.optional(),
+})
+    // Valid JSON is not a correct result: a result that finished before it started, or that claims
+    // to have failed without saying what failed, is not a shape the engine ever produces.
+    .refine((result) => new Date(result.finishedAt) >= new Date(result.startedAt), {
+    message: '"finishedAt" must not be earlier than "startedAt"',
+    path: ['finishedAt'],
+})
+    .refine((result) => result.status !== 'failed' || result.failure !== undefined, {
+    message: '"failure" is required when status is "failed"',
+    path: ['failure'],
+});
+//# sourceMappingURL=run-result.js.map

package/dist/run-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result.js","sourceRoot":"","sources":["../src/run-result.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnE,kGAAkG;AAClG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC1C,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT,WAAW;IACX,SAAS;CACV,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,aAAa,EAAE,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC;IAC1D,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,gBAAgB;IAC5B,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,qBAAqB;IAC7B,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,iBAAiB;IAC7B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACtC,OAAO,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC3C,CAAC;IACF,+FAA+F;IAC/F,sFAAsF;KACrF,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;IAC7E,OAAO,EAAE,mDAAmD;IAC5D,IAAI,EAAE,CAAC,YAAY,CAAC;CACrB,CAAC;KACD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE;IAC9E,OAAO,EAAE,+CAA+C;IACxD,IAAI,EAAE,CAAC,SAAS,CAAC;CAClB,CAAC,CAAC"}