open-multi-agent-kit 0.80.7 → 0.80.8

package/dist/core/context-graph-ontology-generation.js

@@ -1,135 +0,0 @@
-import { hashCanonicalJson } from "./exact-cache-policy.js";
-export const ONTOLOGY_GENERATION_ID_VERSION = "v1";
-export const ONTOLOGY_GENERATION_CACHE_KEY_VERSION = "v1";
-export const ONTOLOGY_GENERATION_STATUSES = ["draft", "active", "superseded", "failed"];
-export function evaluateUaGraphFreshnessFromMetadata(currentMetadata, graphMetadata, dirtyPaths) {
-    const diagnostics = [];
-    addRequiredComparisonDiagnostic(diagnostics, "schema_mismatch", "schemaVersion", firstNonEmptyString(currentMetadata.ontologySchemaVersion, currentMetadata.schemaVersion), graphMetadata.schemaVersion);
-    addRequiredComparisonDiagnostic(diagnostics, "graph_commit_mismatch", "graphRepoSha", currentMetadata.repoSha, firstNonEmptyString(graphMetadata.graphRepoSha, graphMetadata.graphCommitSha, graphMetadata.repoSha));
-    addRequiredComparisonDiagnostic(diagnostics, "meta_commit_mismatch", "metadataRepoSha", currentMetadata.repoSha, firstNonEmptyString(graphMetadata.metadataRepoSha, graphMetadata.metaRepoSha, graphMetadata.repoSha));
-    addRequiredComparisonDiagnostic(diagnostics, "branch_mismatch", "branch", currentMetadata.branch, graphMetadata.branch);
-    addRequiredComparisonDiagnostic(diagnostics, "graph_hash_mismatch", "uaGraphSha256", firstNonEmptyString(currentMetadata.uaGraphSha256, currentMetadata.graphSha256), firstNonEmptyString(graphMetadata.uaGraphSha256, graphMetadata.graphSha256));
-    const dirtyCoveredPaths = findDirtyCoveredPaths(graphMetadata.coveredPaths ?? [], dirtyPaths);
-    if (dirtyCoveredPaths.length > 0) {
-        diagnostics.push({
-            reason: "dirty_covered_paths",
-            field: "coveredPaths",
-            dirtyCoveredPaths,
-            actual: dirtyCoveredPaths.join(","),
-        });
-    }
-    if (diagnostics.length === 0) {
-        return { fresh: true, reasons: ["fresh"], diagnostics: [], dirtyCoveredPaths: [] };
-    }
-    return {
-        fresh: false,
-        reasons: uniqueReasons(diagnostics),
-        diagnostics,
-        dirtyCoveredPaths,
-    };
-}
-export function createOntologyGenerationIdMaterial(input) {
-    return {
-        schemaVersion: requireNonEmptyString("schemaVersion", input.schemaVersion),
-        registryVersion: requireNonEmptyString("registryVersion", input.registryVersion),
-        uaGraphSha256: requireNonEmptyString("uaGraphSha256", input.uaGraphSha256),
-        workspaceId: requireNonEmptyString("workspaceId", input.workspaceId),
-        repositoryId: requireNonEmptyString("repositoryId", input.repositoryId),
-        repoSha: requireNonEmptyString("repoSha", input.repoSha),
-        branch: requireNonEmptyString("branch", input.branch),
-    };
-}
-export function computeOntologyGenerationId(input) {
-    return hashCanonicalJson(createOntologyGenerationIdMaterial(input));
-}
-export function createOntologyGenerationCacheKeyMaterial(input) {
-    const material = createOntologyGenerationIdMaterial(input);
-    return {
-        kind: "ontology-generation",
-        version: ONTOLOGY_GENERATION_CACHE_KEY_VERSION,
-        schemaVersion: material.schemaVersion,
-        registryVersion: material.registryVersion,
-        generationId: computeOntologyGenerationId(input),
-        workspaceId: material.workspaceId,
-        repositoryId: material.repositoryId,
-        repoSha: material.repoSha,
-        branch: material.branch,
-        uaGraphSha256: material.uaGraphSha256,
-    };
-}
-export function createOntologyGenerationCacheKey(input) {
-    const material = createOntologyGenerationCacheKeyMaterial(input);
-    const hash = hashCanonicalJson(material);
-    return {
-        kind: "ontology-generation",
-        version: ONTOLOGY_GENERATION_CACHE_KEY_VERSION,
-        key: `ontology-generation:${ONTOLOGY_GENERATION_CACHE_KEY_VERSION}:${hash}`,
-        hash,
-        material,
-    };
-}
-export function canActivateOntologyGeneration(input) {
-    if (input.status === "failed") {
-        return denyActivation("generation_failed", ["failed generations are immutable and cannot be activated"]);
-    }
-    if (input.status === "superseded") {
-        return denyActivation("generation_superseded", ["superseded generations cannot be reactivated"]);
-    }
-    if (!input.freshness.fresh) {
-        return denyActivation("stale_source_graph", input.freshness.reasons, input.freshness.diagnostics);
-    }
-    const errors = (input.validationIssues ?? []).filter((issue) => issue.severity === "error");
-    if (errors.length > 0) {
-        return denyActivation("validation_errors", errors.map((issue) => issue.code), errors);
-    }
-    return { ok: true, reason: "eligible", nextStatus: "active" };
-}
-function addRequiredComparisonDiagnostic(diagnostics, reason, field, expected, actual) {
-    const normalizedExpected = normalizeMetadataValue(expected);
-    const normalizedActual = normalizeMetadataValue(actual);
-    if (normalizedExpected === undefined || normalizedActual === undefined) {
-        diagnostics.push({ reason: "metadata_missing", field, expected: normalizedExpected, actual: normalizedActual });
-        return;
-    }
-    if (normalizedExpected !== normalizedActual) {
-        diagnostics.push({ reason, field, expected: normalizedExpected, actual: normalizedActual });
-    }
-}
-function findDirtyCoveredPaths(coveredPaths, dirtyPaths) {
-    const normalizedCoveredPaths = coveredPaths.map(normalizePath).filter((path) => path.length > 0);
-    return [
-        ...new Set(dirtyPaths
-            .map(normalizePath)
-            .filter((path) => path.length > 0)
-            .filter((dirtyPath) => normalizedCoveredPaths.some((coveredPath) => pathsOverlap(coveredPath, dirtyPath)))),
-    ].sort();
-}
-function pathsOverlap(coveredPath, dirtyPath) {
-    return (dirtyPath === coveredPath || dirtyPath.startsWith(`${coveredPath}/`) || coveredPath.startsWith(`${dirtyPath}/`));
-}
-function uniqueReasons(diagnostics) {
-    return [...new Set(diagnostics.map((diagnostic) => diagnostic.reason))];
-}
-function firstNonEmptyString(...values) {
-    return values.find((value) => normalizeMetadataValue(value) !== undefined);
-}
-function normalizeMetadataValue(value) {
-    if (value === undefined)
-        return undefined;
-    const normalized = value.trim();
-    return normalized.length === 0 ? undefined : normalized;
-}
-function normalizePath(path) {
-    return path.trim().replace(/\\/g, "/").replace(/\/+/g, "/").replace(/^\.\//, "").replace(/\/$/, "");
-}
-function requireNonEmptyString(name, value) {
-    const normalized = value.trim();
-    if (normalized.length === 0) {
-        throw new TypeError(`${name} must be a non-empty string`);
-    }
-    return normalized;
-}
-function denyActivation(reason, blockers, diagnostics) {
-    return diagnostics === undefined ? { ok: false, reason, blockers } : { ok: false, reason, blockers, diagnostics };
-}
-//# sourceMappingURL=context-graph-ontology-generation.js.map

package/dist/core/context-graph-ontology-generation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-graph-ontology-generation.js","sourceRoot":"","sources":["../../src/core/context-graph-ontology-generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC;AAE7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAC;AACnD,MAAM,CAAC,MAAM,qCAAqC,GAAG,IAAI,CAAC;AAE1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAwHjG,MAAM,UAAU,oCAAoC,CACnD,eAA0C,EAC1C,aAA8B,EAC9B,UAA6B,EACA;IAC7B,MAAM,WAAW,GAAiC,EAAE,CAAC;IAErD,+BAA+B,CAC9B,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,mBAAmB,CAAC,eAAe,CAAC,qBAAqB,EAAE,eAAe,CAAC,aAAa,CAAC,EACzF,aAAa,CAAC,aAAa,CAC3B,CAAC;IACF,+BAA+B,CAC9B,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,eAAe,CAAC,OAAO,EACvB,mBAAmB,CAAC,aAAa,CAAC,YAAY,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,CACpG,CAAC;IACF,+BAA+B,CAC9B,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,CAAC,OAAO,EACvB,mBAAmB,CAAC,aAAa,CAAC,eAAe,EAAE,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CACpG,CAAC;IACF,+BAA+B,CAC9B,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,eAAe,CAAC,MAAM,EACtB,aAAa,CAAC,MAAM,CACpB,CAAC;IACF,+BAA+B,CAC9B,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,mBAAmB,CAAC,eAAe,CAAC,aAAa,EAAE,eAAe,CAAC,WAAW,CAAC,EAC/E,mBAAmB,CAAC,aAAa,CAAC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,CAC3E,CAAC;IAEF,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,aAAa,CAAC,YAAY,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;IAC9F,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC;YAChB,MAAM,EAAE,qBAAqB;YAC7B,KAAK,EAAE,cAAc;YACrB,iBAAiB;YACjB,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;SACnC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC;IACpF,CAAC;IAED,OAAO;QACN,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC;QACnC,WAAW;QACX,iBAAiB;KACjB,CAAC;AAAA,CACF;AAED,MAAM,UAAU,kCAAkC,CACjD,KAAsC,EACP;IAC/B,OAAO;QACN,aAAa,EAAE,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC;QAC1E,eAAe,EAAE,qBAAqB,CAAC,iBAAiB,EAAE,KAAK,CAAC,eAAe,CAAC;QAChF,aAAa,EAAE,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC;QAC1E,WAAW,EAAE,qBAAqB,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC;QACpE,YAAY,EAAE,qBAAqB,CAAC,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC;QACvE,OAAO,EAAE,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;QACxD,MAAM,EAAE,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;KACrD,CAAC;AAAA,CACF;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAsC,EAAU;IAC3F,OAAO,iBAAiB,CAAC,kCAAkC,CAAC,KAAK,CAAC,CAAC,CAAC;AAAA,CACpE;AAED,MAAM,UAAU,wCAAwC,CACvD,KAAsC,EACD;IACrC,MAAM,QAAQ,GAAG,kCAAkC,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO;QACN,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,qCAAqC;QAC9C,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,YAAY,EAAE,2BAA2B,CAAC,KAAK,CAAC;QAChD,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,aAAa,EAAE,QAAQ,CAAC,aAAa;KACrC,CAAC;AAAA,CACF;AAED,MAAM,UAAU,gCAAgC,CAAC,KAAsC,EAA8B;IACpH,MAAM,QAAQ,GAAG,wCAAwC,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO;QACN,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,qCAAqC;QAC9C,GAAG,EAAE,uBAAuB,qCAAqC,IAAI,IAAI,EAAE;QAC3E,IAAI;QACJ,QAAQ;KACR,CAAC;AAAA,CACF;AAED,MAAM,UAAU,6BAA6B,CAC5C,KAAwC,EACD;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,cAAc,CAAC,mBAAmB,EAAE,CAAC,0DAA0D,CAAC,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,OAAO,cAAc,CAAC,uBAAuB,EAAE,CAAC,8CAA8C,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC,oBAAoB,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,cAAc,CACpB,mBAAmB,EACnB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EACjC,MAAM,CACN,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAAA,CAC9D;AAED,SAAS,+BAA+B,CACvC,WAAyC,EACzC,MAA6F,EAC7F,KAAa,EACb,QAA4B,EAC5B,MAA0B,EACnB;IACP,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,kBAAkB,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxE,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAChH,OAAO;IACR,CAAC;IACD,IAAI,kBAAkB,KAAK,gBAAgB,EAAE,CAAC;QAC7C,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC7F,CAAC;AAAA,CACD;AAED,SAAS,qBAAqB,CAAC,YAA+B,EAAE,UAA6B,EAAqB;IACjH,MAAM,sBAAsB,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjG,OAAO;QACN,GAAG,IAAI,GAAG,CACT,UAAU;aACR,GAAG,CAAC,aAAa,CAAC;aAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aACjC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAC3G;KACD,CAAC,IAAI,EAAE,CAAC;AAAA,CACT;AAED,SAAS,YAAY,CAAC,WAAmB,EAAE,SAAiB,EAAW;IACtE,OAAO,CACN,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAC/G,CAAC;AAAA,CACF;AAED,SAAS,aAAa,CAAC,WAAkD,EAAqC;IAC7G,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAAA,CACxE;AAED,SAAS,mBAAmB,CAAC,GAAG,MAAuC,EAAsB;IAC5F,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;AAAA,CAC3E;AAED,SAAS,sBAAsB,CAAC,KAAyB,EAAsB;IAC9E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAAA,CACxD;AAED,SAAS,aAAa,CAAC,IAAY,EAAU;IAC5C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAAA,CACpG;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,KAAa,EAAU;IACnE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,UAAU,CAAC;AAAA,CAClB;AAED,SAAS,cAAc,CACtB,MAA+D,EAC/D,QAA2B,EAC3B,WAAkG,EAC3D;IACvC,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAAA,CAClH","sourcesContent":["import { hashCanonicalJson, type JsonObject } from \"./exact-cache-policy.ts\";\n\nexport const ONTOLOGY_GENERATION_ID_VERSION = \"v1\";\nexport const ONTOLOGY_GENERATION_CACHE_KEY_VERSION = \"v1\";\n\nexport const ONTOLOGY_GENERATION_STATUSES = [\"draft\", \"active\", \"superseded\", \"failed\"] as const;\n\nexport type OntologyGenerationStatus = (typeof ONTOLOGY_GENERATION_STATUSES)[number];\n\nexport type UaGraphFreshnessReason =\n\t| \"fresh\"\n\t| \"metadata_missing\"\n\t| \"schema_mismatch\"\n\t| \"graph_commit_mismatch\"\n\t| \"meta_commit_mismatch\"\n\t| \"branch_mismatch\"\n\t| \"graph_hash_mismatch\"\n\t| \"dirty_covered_paths\";\n\nexport interface CurrentRepositoryMetadata {\n\treadonly repoSha: string;\n\treadonly branch: string;\n\treadonly ontologySchemaVersion?: string;\n\treadonly schemaVersion?: string;\n\treadonly uaGraphSha256?: string;\n\treadonly graphSha256?: string;\n}\n\nexport interface UaGraphMetadata {\n\treadonly schemaVersion: string;\n\treadonly branch: string;\n\treadonly graphRepoSha?: string;\n\treadonly graphCommitSha?: string;\n\treadonly repoSha?: string;\n\treadonly metadataRepoSha?: string;\n\treadonly metaRepoSha?: string;\n\treadonly uaGraphSha256?: string;\n\treadonly graphSha256?: string;\n\treadonly coveredPaths?: readonly string[];\n}\n\nexport interface UaGraphFreshnessDiagnostic {\n\treadonly reason: Exclude<UaGraphFreshnessReason, \"fresh\">;\n\treadonly field: string;\n\treadonly expected?: string;\n\treadonly actual?: string;\n\treadonly dirtyCoveredPaths?: readonly string[];\n}\n\nexport interface UaGraphFreshnessEvaluation {\n\treadonly fresh: boolean;\n\treadonly reasons: readonly UaGraphFreshnessReason[];\n\treadonly diagnostics: readonly UaGraphFreshnessDiagnostic[];\n\treadonly dirtyCoveredPaths: readonly string[];\n}\n\nexport interface OntologyGenerationIdentityInput {\n\treadonly schemaVersion: string;\n\treadonly registryVersion: string;\n\treadonly uaGraphSha256: string;\n\treadonly workspaceId: string;\n\treadonly repositoryId: string;\n\treadonly repoSha: string;\n\treadonly branch: string;\n}\n\nexport interface OntologyGenerationIdMaterial extends JsonObject {\n\treadonly schemaVersion: string;\n\treadonly registryVersion: string;\n\treadonly uaGraphSha256: string;\n\treadonly workspaceId: string;\n\treadonly repositoryId: string;\n\treadonly repoSha: string;\n\treadonly branch: string;\n}\n\nexport interface OntologyGenerationCacheKeyMaterial extends JsonObject {\n\treadonly kind: \"ontology-generation\";\n\treadonly version: typeof ONTOLOGY_GENERATION_CACHE_KEY_VERSION;\n\treadonly schemaVersion: string;\n\treadonly registryVersion: string;\n\treadonly generationId: string;\n\treadonly workspaceId: string;\n\treadonly repositoryId: string;\n\treadonly repoSha: string;\n\treadonly branch: string;\n\treadonly uaGraphSha256: string;\n}\n\nexport interface OntologyGenerationCacheKey {\n\treadonly kind: \"ontology-generation\";\n\treadonly version: typeof ONTOLOGY_GENERATION_CACHE_KEY_VERSION;\n\treadonly key: string;\n\treadonly hash: string;\n\treadonly material: OntologyGenerationCacheKeyMaterial;\n}\n\nexport interface OntologyGenerationValidationIssue {\n\treadonly code: string;\n\treadonly severity: \"error\" | \"warning\" | \"info\";\n\treadonly message: string;\n}\n\nexport type OntologyGenerationActivationReason =\n\t| \"eligible\"\n\t| \"stale_source_graph\"\n\t| \"generation_failed\"\n\t| \"generation_superseded\"\n\t| \"validation_errors\";\n\nexport type OntologyGenerationActivationDecision =\n\t| { readonly ok: true; readonly reason: \"eligible\"; readonly nextStatus: \"active\" }\n\t| {\n\t\t\treadonly ok: false;\n\t\t\treadonly reason: Exclude<OntologyGenerationActivationReason, \"eligible\">;\n\t\t\treadonly blockers: readonly string[];\n\t\t\treadonly diagnostics?: readonly UaGraphFreshnessDiagnostic[] | readonly OntologyGenerationValidationIssue[];\n\t  };\n\nexport interface OntologyGenerationActivationInput {\n\treadonly status: OntologyGenerationStatus;\n\treadonly freshness: UaGraphFreshnessEvaluation;\n\treadonly validationIssues?: readonly OntologyGenerationValidationIssue[];\n}\n\nexport function evaluateUaGraphFreshnessFromMetadata(\n\tcurrentMetadata: CurrentRepositoryMetadata,\n\tgraphMetadata: UaGraphMetadata,\n\tdirtyPaths: readonly string[],\n): UaGraphFreshnessEvaluation {\n\tconst diagnostics: UaGraphFreshnessDiagnostic[] = [];\n\n\taddRequiredComparisonDiagnostic(\n\t\tdiagnostics,\n\t\t\"schema_mismatch\",\n\t\t\"schemaVersion\",\n\t\tfirstNonEmptyString(currentMetadata.ontologySchemaVersion, currentMetadata.schemaVersion),\n\t\tgraphMetadata.schemaVersion,\n\t);\n\taddRequiredComparisonDiagnostic(\n\t\tdiagnostics,\n\t\t\"graph_commit_mismatch\",\n\t\t\"graphRepoSha\",\n\t\tcurrentMetadata.repoSha,\n\t\tfirstNonEmptyString(graphMetadata.graphRepoSha, graphMetadata.graphCommitSha, graphMetadata.repoSha),\n\t);\n\taddRequiredComparisonDiagnostic(\n\t\tdiagnostics,\n\t\t\"meta_commit_mismatch\",\n\t\t\"metadataRepoSha\",\n\t\tcurrentMetadata.repoSha,\n\t\tfirstNonEmptyString(graphMetadata.metadataRepoSha, graphMetadata.metaRepoSha, graphMetadata.repoSha),\n\t);\n\taddRequiredComparisonDiagnostic(\n\t\tdiagnostics,\n\t\t\"branch_mismatch\",\n\t\t\"branch\",\n\t\tcurrentMetadata.branch,\n\t\tgraphMetadata.branch,\n\t);\n\taddRequiredComparisonDiagnostic(\n\t\tdiagnostics,\n\t\t\"graph_hash_mismatch\",\n\t\t\"uaGraphSha256\",\n\t\tfirstNonEmptyString(currentMetadata.uaGraphSha256, currentMetadata.graphSha256),\n\t\tfirstNonEmptyString(graphMetadata.uaGraphSha256, graphMetadata.graphSha256),\n\t);\n\n\tconst dirtyCoveredPaths = findDirtyCoveredPaths(graphMetadata.coveredPaths ?? [], dirtyPaths);\n\tif (dirtyCoveredPaths.length > 0) {\n\t\tdiagnostics.push({\n\t\t\treason: \"dirty_covered_paths\",\n\t\t\tfield: \"coveredPaths\",\n\t\t\tdirtyCoveredPaths,\n\t\t\tactual: dirtyCoveredPaths.join(\",\"),\n\t\t});\n\t}\n\n\tif (diagnostics.length === 0) {\n\t\treturn { fresh: true, reasons: [\"fresh\"], diagnostics: [], dirtyCoveredPaths: [] };\n\t}\n\n\treturn {\n\t\tfresh: false,\n\t\treasons: uniqueReasons(diagnostics),\n\t\tdiagnostics,\n\t\tdirtyCoveredPaths,\n\t};\n}\n\nexport function createOntologyGenerationIdMaterial(\n\tinput: OntologyGenerationIdentityInput,\n): OntologyGenerationIdMaterial {\n\treturn {\n\t\tschemaVersion: requireNonEmptyString(\"schemaVersion\", input.schemaVersion),\n\t\tregistryVersion: requireNonEmptyString(\"registryVersion\", input.registryVersion),\n\t\tuaGraphSha256: requireNonEmptyString(\"uaGraphSha256\", input.uaGraphSha256),\n\t\tworkspaceId: requireNonEmptyString(\"workspaceId\", input.workspaceId),\n\t\trepositoryId: requireNonEmptyString(\"repositoryId\", input.repositoryId),\n\t\trepoSha: requireNonEmptyString(\"repoSha\", input.repoSha),\n\t\tbranch: requireNonEmptyString(\"branch\", input.branch),\n\t};\n}\n\nexport function computeOntologyGenerationId(input: OntologyGenerationIdentityInput): string {\n\treturn hashCanonicalJson(createOntologyGenerationIdMaterial(input));\n}\n\nexport function createOntologyGenerationCacheKeyMaterial(\n\tinput: OntologyGenerationIdentityInput,\n): OntologyGenerationCacheKeyMaterial {\n\tconst material = createOntologyGenerationIdMaterial(input);\n\treturn {\n\t\tkind: \"ontology-generation\",\n\t\tversion: ONTOLOGY_GENERATION_CACHE_KEY_VERSION,\n\t\tschemaVersion: material.schemaVersion,\n\t\tregistryVersion: material.registryVersion,\n\t\tgenerationId: computeOntologyGenerationId(input),\n\t\tworkspaceId: material.workspaceId,\n\t\trepositoryId: material.repositoryId,\n\t\trepoSha: material.repoSha,\n\t\tbranch: material.branch,\n\t\tuaGraphSha256: material.uaGraphSha256,\n\t};\n}\n\nexport function createOntologyGenerationCacheKey(input: OntologyGenerationIdentityInput): OntologyGenerationCacheKey {\n\tconst material = createOntologyGenerationCacheKeyMaterial(input);\n\tconst hash = hashCanonicalJson(material);\n\treturn {\n\t\tkind: \"ontology-generation\",\n\t\tversion: ONTOLOGY_GENERATION_CACHE_KEY_VERSION,\n\t\tkey: `ontology-generation:${ONTOLOGY_GENERATION_CACHE_KEY_VERSION}:${hash}`,\n\t\thash,\n\t\tmaterial,\n\t};\n}\n\nexport function canActivateOntologyGeneration(\n\tinput: OntologyGenerationActivationInput,\n): OntologyGenerationActivationDecision {\n\tif (input.status === \"failed\") {\n\t\treturn denyActivation(\"generation_failed\", [\"failed generations are immutable and cannot be activated\"]);\n\t}\n\tif (input.status === \"superseded\") {\n\t\treturn denyActivation(\"generation_superseded\", [\"superseded generations cannot be reactivated\"]);\n\t}\n\tif (!input.freshness.fresh) {\n\t\treturn denyActivation(\"stale_source_graph\", input.freshness.reasons, input.freshness.diagnostics);\n\t}\n\n\tconst errors = (input.validationIssues ?? []).filter((issue) => issue.severity === \"error\");\n\tif (errors.length > 0) {\n\t\treturn denyActivation(\n\t\t\t\"validation_errors\",\n\t\t\terrors.map((issue) => issue.code),\n\t\t\terrors,\n\t\t);\n\t}\n\n\treturn { ok: true, reason: \"eligible\", nextStatus: \"active\" };\n}\n\nfunction addRequiredComparisonDiagnostic(\n\tdiagnostics: UaGraphFreshnessDiagnostic[],\n\treason: Exclude<UaGraphFreshnessReason, \"fresh\" | \"dirty_covered_paths\" | \"metadata_missing\">,\n\tfield: string,\n\texpected: string | undefined,\n\tactual: string | undefined,\n): void {\n\tconst normalizedExpected = normalizeMetadataValue(expected);\n\tconst normalizedActual = normalizeMetadataValue(actual);\n\tif (normalizedExpected === undefined || normalizedActual === undefined) {\n\t\tdiagnostics.push({ reason: \"metadata_missing\", field, expected: normalizedExpected, actual: normalizedActual });\n\t\treturn;\n\t}\n\tif (normalizedExpected !== normalizedActual) {\n\t\tdiagnostics.push({ reason, field, expected: normalizedExpected, actual: normalizedActual });\n\t}\n}\n\nfunction findDirtyCoveredPaths(coveredPaths: readonly string[], dirtyPaths: readonly string[]): readonly string[] {\n\tconst normalizedCoveredPaths = coveredPaths.map(normalizePath).filter((path) => path.length > 0);\n\treturn [\n\t\t...new Set(\n\t\t\tdirtyPaths\n\t\t\t\t.map(normalizePath)\n\t\t\t\t.filter((path) => path.length > 0)\n\t\t\t\t.filter((dirtyPath) => normalizedCoveredPaths.some((coveredPath) => pathsOverlap(coveredPath, dirtyPath))),\n\t\t),\n\t].sort();\n}\n\nfunction pathsOverlap(coveredPath: string, dirtyPath: string): boolean {\n\treturn (\n\t\tdirtyPath === coveredPath || dirtyPath.startsWith(`${coveredPath}/`) || coveredPath.startsWith(`${dirtyPath}/`)\n\t);\n}\n\nfunction uniqueReasons(diagnostics: readonly UaGraphFreshnessDiagnostic[]): readonly UaGraphFreshnessReason[] {\n\treturn [...new Set(diagnostics.map((diagnostic) => diagnostic.reason))];\n}\n\nfunction firstNonEmptyString(...values: readonly (string | undefined)[]): string | undefined {\n\treturn values.find((value) => normalizeMetadataValue(value) !== undefined);\n}\n\nfunction normalizeMetadataValue(value: string | undefined): string | undefined {\n\tif (value === undefined) return undefined;\n\tconst normalized = value.trim();\n\treturn normalized.length === 0 ? undefined : normalized;\n}\n\nfunction normalizePath(path: string): string {\n\treturn path.trim().replace(/\\\\/g, \"/\").replace(/\\/+/g, \"/\").replace(/^\\.\\//, \"\").replace(/\\/$/, \"\");\n}\n\nfunction requireNonEmptyString(name: string, value: string): string {\n\tconst normalized = value.trim();\n\tif (normalized.length === 0) {\n\t\tthrow new TypeError(`${name} must be a non-empty string`);\n\t}\n\treturn normalized;\n}\n\nfunction denyActivation(\n\treason: Exclude<OntologyGenerationActivationReason, \"eligible\">,\n\tblockers: readonly string[],\n\tdiagnostics?: readonly UaGraphFreshnessDiagnostic[] | readonly OntologyGenerationValidationIssue[],\n): OntologyGenerationActivationDecision {\n\treturn diagnostics === undefined ? { ok: false, reason, blockers } : { ok: false, reason, blockers, diagnostics };\n}\n"]}