@agent-teams/engineering-foundation 0.17.0 → 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/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":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAuB9C,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,cAAc;IACd,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,WAAW;IACX,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,sBAAsB;IACtB,uBAAuB;IACvB,kBAAkB;CACnB,CAAC,CAAC;AAEH,SAAS,oBAAoB,CAAC,KAAc,EAAE,QAAyB;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAI,KAA0C,CAAC,QAAQ,CAAC,CAAC;QACpE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,OAAO,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,0BAA0B,CAAC;AAC5E,CAAC;AAED,SAAS,cAAc,CAAI,KAAc,EAAE,WAAwC;IACjF,IAAI,CAAC;QACH,OAAO,KAAK,YAAY,WAAW,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,IAAwB;IAC/D,OAAO,CACL,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC;QAClC,IAAI,KAAK,iBAAiB;QAC1B,IAAI,KAAK,gBAAgB;QACzB,IAAI,KAAK,gBAAgB,CAC1B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,IAAwB,EACxB,IAAwB;IAExB,OAAO,CACL,CAAC,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,IAAI,IAAI,KAAK,gBAAgB,CAAC;QACrE,IAAI,KAAK,2BAA2B;QACpC,IAAI,KAAK,0BAA0B;QACnC,IAAI,EAAE,UAAU,CAAC,oBAAoB,CAAC,KAAK,IAAI,CAChD,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEjD,IAAI,IAAI,KAAK,wBAAwB,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QAChF,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,KAAK,sBAAsB,IAAI,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QAChH,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,wBAAwB,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC/F,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,aAAa,GAAyD;IAC1E,UAAU,EAAE,4CAA4C;IACxD,MAAM,EAAE,wCAAwC;IAChD,OAAO,EAAE,yCAAyC;IAClD,QAAQ,EAAE,0CAA0C;IACpD,oBAAoB,EAAE,4CAA4C;IAClE,OAAO,EAAE,iCAAiC;CAC3C,CAAC;AAEF,MAAM,YAAY,GAAmF;IACnG,QAAQ,EAAE,6BAA6B;IACvC,UAAU,EAAE,+BAA+B;IAC3C,oBAAoB,EAAE,uCAAuC;IAC7D,MAAM,EAAE,2BAA2B;IACnC,OAAO,EAAE,4BAA4B;IACrC,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,KAAa;IAEb,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;QACxB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;QAC5B,KAAK;QACL,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.17.0",
+  "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"