@agent-teams/engineering-foundation 0.17.0-rc.8 → 0.18.0

package/dist/repository-mutation/application/policies/classify-known-file-recovery-transition.js

@@ -0,0 +1,19 @@
+/**
+ * Classifies the next top-level transition for an already parsed and validated
+ * known-file v1 recovery envelope. Evidence parsing and all effects remain the
+ * responsibility of the calling adapter.
+ */
+export function classifyKnownFileRecoveryTransition(input) {
+    if (input.envelope.foundation.version !== input.installedBuild.version ||
+        input.envelope.foundation.buildIdentity !== input.installedBuild.buildIdentity) {
+        return {
+            action: "reject",
+            code: "KNOWN_FILE_EXACT_BUILD_REQUIRED",
+            message: "The exact Foundation build that created this journal must recover it."
+        };
+    }
+    return input.envelope.state === "COMMITTED"
+        ? { action: "resume-committed-cleanup" }
+        : { action: "rollback-applying" };
+}
+//# sourceMappingURL=classify-known-file-recovery-transition.js.map

package/dist/repository-mutation/application/policies/classify-known-file-recovery-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-known-file-recovery-transition.js","sourceRoot":"","sources":["../../../../src/repository-mutation/application/policies/classify-known-file-recovery-transition.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAGnD;IACC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,KAAK,KAAK,CAAC,cAAc,CAAC,OAAO;QACpE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,KAAK,KAAK,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;QACjF,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,iCAAiC;YACvC,OAAO,EAAE,uEAAuE;SACjF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,WAAW;QACzC,CAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE;QACxC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;AACtC,CAAC"}

package/dist/schema-ids.d.ts

@@ -1,4 +1,4 @@
-export declare const FOUNDATION_SCHEMA_IDS: readonly ["architecture-source-dependencies/v1", "contract-json-schema-release-baseline/v1", "contract-json-schema-releases/v1", "contract-protobuf-breaking-qualification/v1", "contract-protobuf-evolution-baseline/v1", "contract-protobuf-evolution/v1", "document-authoring-profile/v1", "document-authoring-profile/v2", "document-command-envelope/v1", "document-command-envelope/v2", "document-intent/v1", "document-parent-materialization/v2", "document-plan/v1", "document-plan/v2", "document-receipt/v1", "document-receipt/v2", "documentation-local-references/v1", "foundation-command-error/v1", "foundation-config/v1", "foundation-check-report/v1", "foundation-transaction-envelope/v2", "foundation-transaction-envelope/v3", "foundation-transaction-envelope/v4", "foundation-transaction-envelope/v5", "governance-architecture-decision-baseline/v1", "governance-architecture-decisions/v1", "known-file-transaction-plan/v1", "known-file-transaction-receipt/v1", "package-public-api-baseline/v1", "package-public-api-compatibility/v1", "quality-executable-specification-catalog/v1", "quality-executable-specifications/v1", "quality-suppression-governance/v1", "repository-agent-workflow/v1", "repository-security-baseline/v1", "scaffold-authority-evidence/v1", "scaffold-intent/v1", "scaffold-plan/v1", "scaffold-receipt/v1", "scaffold-recovery-journal/v1", "scaffold-target-catalog/v1", "scaffolding-config/v1", "workspace-dependency-declarations/v1"];
+export declare const FOUNDATION_SCHEMA_IDS: readonly ["architecture-source-dependencies/v1", "contract-json-schema-release-baseline/v1", "contract-json-schema-releases/v1", "contract-protobuf-breaking-qualification/v1", "contract-protobuf-evolution-baseline/v1", "contract-protobuf-evolution/v1", "document-authoring-profile/v1", "document-authoring-profile/v2", "document-command-envelope/v1", "document-command-envelope/v2", "document-intent/v1", "document-parent-materialization/v2", "document-plan/v1", "document-plan/v2", "document-receipt/v1", "document-receipt/v2", "documentation-local-references/v1", "foundation-command-error/v1", "foundation-config/v1", "foundation-check-report/v1", "foundation-transaction-envelope/v2", "foundation-transaction-envelope/v3", "foundation-transaction-envelope/v4", "foundation-transaction-envelope/v5", "governance-architecture-decision-baseline/v1", "governance-architecture-decisions/v1", "known-file-transaction-plan/v1", "known-file-transaction-receipt/v1", "package-public-api-baseline/v1", "package-public-api-compatibility/v1", "quality-executable-specification-catalog/v1", "quality-executable-specifications/v1", "quality-gate-run-report/v1", "quality-gate-runner/v1", "quality-suppression-governance/v1", "repository-agent-workflow/v1", "repository-security-baseline/v1", "scaffold-authority-evidence/v1", "scaffold-intent/v1", "scaffold-plan/v1", "scaffold-receipt/v1", "scaffold-recovery-journal/v1", "scaffold-target-catalog/v1", "scaffolding-config/v1", "workspace-dependency-declarations/v1"];
 export type FoundationSchemaId = (typeof FOUNDATION_SCHEMA_IDS)[number];
 export type FoundationSchemaCatalogId = FoundationSchemaId;
 //# sourceMappingURL=schema-ids.d.ts.map

package/dist/schema-ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-ids.d.ts","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,YAChC,qCAAqC,EACrC,0CAA0C,EAC1C,kCAAkC,EAClC,6CAA6C,EAC7C,yCAAyC,EACzC,gCAAgC,EAChC,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,oCAAoC,EACpC,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,mCAAmC,EACnC,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,oCAAoC,EACpC,oCAAoC,EACpC,oCAAoC,EACpC,oCAAoC,EACpC,8CAA8C,EAC9C,sCAAsC,EACtC,gCAAgC,EAChC,mCAAmC,EACnC,gCAAgC,EAChC,qCAAqC,EACrC,6CAA6C,EAC7C,sCAAsC,EACtC,mCAAmC,EACnC,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,sCAAsC,CAC9B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"schema-ids.d.ts","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,YAChC,qCAAqC,EACrC,0CAA0C,EAC1C,kCAAkC,EAClC,6CAA6C,EAC7C,yCAAyC,EACzC,gCAAgC,EAChC,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,oCAAoC,EACpC,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,mCAAmC,EACnC,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,oCAAoC,EACpC,oCAAoC,EACpC,oCAAoC,EACpC,oCAAoC,EACpC,8CAA8C,EAC9C,sCAAsC,EACtC,gCAAgC,EAChC,mCAAmC,EACnC,gCAAgC,EAChC,qCAAqC,EACrC,6CAA6C,EAC7C,sCAAsC,EACtC,4BAA4B,EAC5B,wBAAwB,EACxB,mCAAmC,EACnC,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,sCAAsC,CAC9B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC"}

package/dist/schema-ids.js

@@ -31,6 +31,8 @@ export const FOUNDATION_SCHEMA_IDS = [
     "package-public-api-compatibility/v1",
     "quality-executable-specification-catalog/v1",
     "quality-executable-specifications/v1",
+    "quality-gate-run-report/v1",
+    "quality-gate-runner/v1",
     "quality-suppression-governance/v1",
     "repository-agent-workflow/v1",
     "repository-security-baseline/v1",

package/dist/schema-ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-ids.js","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qCAAqC;IACrC,0CAA0C;IAC1C,kCAAkC;IAClC,6CAA6C;IAC7C,yCAAyC;IACzC,gCAAgC;IAChC,+BAA+B;IAC/B,+BAA+B;IAC/B,8BAA8B;IAC9B,8BAA8B;IAC9B,oBAAoB;IACpB,oCAAoC;IACpC,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,qBAAqB;IACrB,mCAAmC;IACnC,6BAA6B;IAC7B,sBAAsB;IACtB,4BAA4B;IAC5B,oCAAoC;IACpC,oCAAoC;IACpC,oCAAoC;IACpC,oCAAoC;IACpC,8CAA8C;IAC9C,sCAAsC;IACtC,gCAAgC;IAChC,mCAAmC;IACnC,gCAAgC;IAChC,qCAAqC;IACrC,6CAA6C;IAC7C,sCAAsC;IACtC,mCAAmC;IACnC,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,8BAA8B;IAC9B,4BAA4B;IAC5B,uBAAuB;IACvB,sCAAsC;CAC9B,CAAC"}
+{"version":3,"file":"schema-ids.js","sourceRoot":"","sources":["../src/schema-ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qCAAqC;IACrC,0CAA0C;IAC1C,kCAAkC;IAClC,6CAA6C;IAC7C,yCAAyC;IACzC,gCAAgC;IAChC,+BAA+B;IAC/B,+BAA+B;IAC/B,8BAA8B;IAC9B,8BAA8B;IAC9B,oBAAoB;IACpB,oCAAoC;IACpC,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,qBAAqB;IACrB,mCAAmC;IACnC,6BAA6B;IAC7B,sBAAsB;IACtB,4BAA4B;IAC5B,oCAAoC;IACpC,oCAAoC;IACpC,oCAAoC;IACpC,oCAAoC;IACpC,8CAA8C;IAC9C,sCAAsC;IACtC,gCAAgC;IAChC,mCAAmC;IACnC,gCAAgC;IAChC,qCAAqC;IACrC,6CAA6C;IAC7C,sCAAsC;IACtC,4BAA4B;IAC5B,wBAAwB;IACxB,mCAAmC;IACnC,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,8BAA8B;IAC9B,4BAA4B;IAC5B,uBAAuB;IACvB,sCAAsC;CAC9B,CAAC"}

package/dist/unexpected-failure.d.ts

@@ -0,0 +1,9 @@
+export interface UnexpectedFailureProblem {
+    readonly code: "UNEXPECTED_CONTRACT_FAILURE" | "UNEXPECTED_FAILURE" | "UNEXPECTED_FILESYSTEM_FAILURE" | "UNEXPECTED_INTERNAL_INVARIANT_FAILURE" | "UNEXPECTED_PARSER_FAILURE" | "UNEXPECTED_PROCESS_FAILURE";
+    readonly message: string;
+    readonly phase: string;
+    readonly retryable: false;
+}
+export declare function isProcessCancellationFailure(error: unknown): boolean;
+export declare function classifyUnexpectedFailure(error: unknown, phase: string): UnexpectedFailureProblem;
+//# sourceMappingURL=unexpected-failure.d.ts.map

package/dist/unexpected-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unexpected-failure.d.ts","sourceRoot":"","sources":["../src/unexpected-failure.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EACT,6BAA6B,GAC7B,oBAAoB,GACpB,+BAA+B,GAC/B,uCAAuC,GACvC,2BAA2B,GAC3B,4BAA4B,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;CAC3B;AAuCD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpE;AAwED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,wBAAwB,CAQ1B"}

package/dist/unexpected-failure.js

@@ -0,0 +1,105 @@
+import { FoundationError } from "./errors.js";
+const FILESYSTEM_ERROR_CODES = new Set([
+    "EACCES",
+    "EBADF",
+    "EBUSY",
+    "EEXIST",
+    "EFBIG",
+    "EISDIR",
+    "ELOOP",
+    "EMFILE",
+    "ENAMETOOLONG",
+    "ENFILE",
+    "ENOENT",
+    "ENOSPC",
+    "ENOTDIR",
+    "ENOTEMPTY",
+    "EPERM",
+    "EROFS"
+]);
+const CONTRACT_ERROR_CODES = new Set([
+    "ERR_INVALID_ARG_TYPE",
+    "ERR_INVALID_ARG_VALUE",
+    "ERR_OUT_OF_RANGE"
+]);
+function stableStringProperty(error, property) {
+    if (typeof error !== "object" || error === null) {
+        return undefined;
+    }
+    try {
+        const value = error[property];
+        return typeof value === "string" ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function isProcessCancellationFailure(error) {
+    return stableStringProperty(error, "name") === "ProcessCancellationError";
+}
+function safeInstanceOf(error, constructor) {
+    try {
+        return error instanceof constructor;
+    }
+    catch {
+        return false;
+    }
+}
+function isParserFailure(error, name) {
+    return (safeInstanceOf(error, SyntaxError) ||
+        name === "StrictJsonError" ||
+        name === "JSONParseError" ||
+        name === "YAMLParseError");
+}
+function isProcessFailure(error, code, name) {
+    return ((safeInstanceOf(error, FoundationError) && code === "PROCESS_FAILED") ||
+        name === "PackageScriptTimeoutError" ||
+        name === "ProcessCancellationError" ||
+        code?.startsWith("ERR_CHILD_PROCESS_") === true);
+}
+function causeKind(error) {
+    const code = stableStringProperty(error, "code");
+    const name = stableStringProperty(error, "name");
+    if (name === "ContainedFileReadError" || FILESYSTEM_ERROR_CODES.has(code ?? "")) {
+        return "filesystem";
+    }
+    if (isParserFailure(error, name)) {
+        return "parser";
+    }
+    if (isProcessFailure(error, code, name)) {
+        return "process";
+    }
+    if (name === "CapabilityInputError" || safeInstanceOf(error, TypeError) || CONTRACT_ERROR_CODES.has(code ?? "")) {
+        return "contract";
+    }
+    if (name === "AssertionError" || name === "InternalInvariantError" || code === "ERR_ASSERTION") {
+        return "internal-invariant";
+    }
+    return "unknown";
+}
+const SAFE_MESSAGES = {
+    filesystem: "An unexpected filesystem failure occurred.",
+    parser: "An unexpected parser failure occurred.",
+    process: "An unexpected process failure occurred.",
+    contract: "An unexpected contract failure occurred.",
+    "internal-invariant": "An internal invariant failed unexpectedly.",
+    unknown: "An unexpected failure occurred."
+};
+const STABLE_CODES = {
+    contract: "UNEXPECTED_CONTRACT_FAILURE",
+    filesystem: "UNEXPECTED_FILESYSTEM_FAILURE",
+    "internal-invariant": "UNEXPECTED_INTERNAL_INVARIANT_FAILURE",
+    parser: "UNEXPECTED_PARSER_FAILURE",
+    process: "UNEXPECTED_PROCESS_FAILURE",
+    unknown: "UNEXPECTED_FAILURE"
+};
+export function classifyUnexpectedFailure(error, phase) {
+    const kind = causeKind(error);
+    return Object.freeze({
+        code: STABLE_CODES[kind],
+        message: SAFE_MESSAGES[kind],
+        phase,
+        retryable: false
+    });
+}
+//# sourceMappingURL=unexpected-failure.js.map

package/dist/unexpected-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unexpected-failure.js","sourceRoot":"","sources":["../src/unexpected-failure.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.17.0-rc.8",
+  "version": "0.18.0",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",
@@ -29,6 +29,10 @@
       "types": "./dist/mutation/index.d.ts",
       "import": "./dist/mutation/index.js"
     },
+    "./mutation/qualification": {
+      "types": "./dist/mutation/qualification/index.d.ts",
+      "import": "./dist/mutation/qualification/index.js"
+    },
     "./scaffolding": {
       "types": "./dist/scaffolding/index.d.ts",
       "import": "./dist/scaffolding/index.js"
@@ -78,6 +82,8 @@
     "schemas/package-public-api-compatibility/v1.schema.json",
     "schemas/quality-executable-specification-catalog/v1.schema.json",
     "schemas/quality-executable-specifications/v1.schema.json",
+    "schemas/quality-gate-run-report/v1.schema.json",
+    "schemas/quality-gate-runner/v1.schema.json",
     "schemas/quality-suppression-governance/v1.schema.json",
     "schemas/repository-agent-workflow/v1.schema.json",
     "schemas/repository-security-baseline/v1.schema.json",

package/schemas/foundation-config/v1.schema.json

@@ -95,6 +95,16 @@
             }
           }
         },
+        "quality.gate-runner": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["configPath"],
+          "properties": {
+            "configPath": {
+              "$ref": "#/$defs/repositoryRelativeYamlPath"
+            }
+          }
+        },
         "quality.executable-specifications": {
           "type": "object",
           "additionalProperties": false,

package/schemas/quality-gate-run-report/v1.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/quality-gate-run-report/v1",
+  "title": "Quality gate run report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "reportSchemaVersion",
+    "profileId",
+    "outcome",
+    "durationMs",
+    "tasks"
+  ],
+  "properties": {
+    "reportSchemaVersion": { "const": 1 },
+    "profileId": { "type": "string" },
+    "outcome": {
+      "enum": ["passed", "failed", "cancelled"]
+    },
+    "durationMs": { "type": "integer", "minimum": 0 },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "outcome",
+          "durationMs",
+          "exitCode",
+          "signal",
+          "failureTail"
+        ],
+        "properties": {
+          "id": { "type": "string" },
+          "outcome": {
+            "enum": ["passed", "failed", "timed-out", "blocked", "cancelled"]
+          },
+          "durationMs": { "type": "integer", "minimum": 0 },
+          "exitCode": { "type": ["integer", "null"] },
+          "signal": { "type": ["string", "null"] },
+          "failureTail": { "type": "string", "maxLength": 8192 }
+        }
+      }
+    }
+  }
+}

package/schemas/quality-gate-runner/v1.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/quality-gate-runner/v1",
+  "title": "Deterministic quality gate runner configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "packageManager", "profiles"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "packageManager": { "const": "pnpm" },
+    "profiles": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "concurrency", "tasks"],
+        "properties": {
+          "id": { "$ref": "#/$defs/profileId" },
+          "concurrency": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 16
+          },
+          "tasks": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 128,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id"],
+              "properties": {
+                "id": { "$ref": "#/$defs/scriptId" },
+                "needs": {
+                  "type": "array",
+                  "maxItems": 64,
+                  "uniqueItems": true,
+                  "items": { "$ref": "#/$defs/scriptId" }
+                },
+                "after": {
+                  "type": "array",
+                  "maxItems": 64,
+                  "uniqueItems": true,
+                  "items": { "$ref": "#/$defs/scriptId" }
+                },
+                "timeoutMs": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 2147483647
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "profileId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 63,
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "scriptId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]*$"
+    }
+  }
+}