Files
pikasTech-unidesk/scripts/native/cicd/pac-status-evaluator.cjs
T
Codex 1eafb1f89e fix: 修复 PaC reused delivery 终态证据
从目标 TaskRun condition/result 与结构化合同日志恢复 artifact catalog、digest 和 GitOps 证据,并为真实 PipelineRun 增加有界 debug-step。严格保留缺 artifact、缺 GitOps、runtime mismatch 与冲突证据的 fail-closed closeout。
2026-07-11 01:29:22 +02:00

738 lines
34 KiB
JavaScript

"use strict";
function record(value) {
return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
}
function stringOrNull(value) {
return typeof value === "string" && value.length > 0 ? value : null;
}
function stringArray(value) {
return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : null;
}
function digestFromImage(value) {
if (typeof value !== "string" || !value.includes("@")) return null;
return value.split("@").slice(1).join("@") || null;
}
function exactSkipMarker(records, event) {
return [...records].reverse().find((item) => item.event === event
&& item.status === "skipped"
&& item.reason === "no-build-no-rollout-plan") || null;
}
const pacContractTasks = new Set(["plan-artifacts", "collect-artifacts", "gitops-promote"]);
function taskTerminalRecord(value) {
const taskRun = record(value);
const metadata = record(taskRun.metadata);
const labels = record(metadata.labels);
const pipelineTask = stringOrNull(labels["tekton.dev/pipelineTask"]);
if (pipelineTask === null || !pacContractTasks.has(pipelineTask)) return null;
const status = record(taskRun.status);
const condition = Array.isArray(status.conditions)
? status.conditions.map(record).find((item) => item.type === "Succeeded") || {}
: {};
const conditionStatus = stringOrNull(condition.status);
const normalizedStatus = conditionStatus === "True"
? "succeeded"
: conditionStatus === "False"
? "failed"
: "running";
return {
event: "pac-task-terminal",
pipelineTask,
taskRun: stringOrNull(metadata.name),
status: normalizedStatus,
reason: stringOrNull(condition.reason),
results: Array.isArray(status.results)
? status.results.map(record).map((item) => stringOrNull(item.name)).filter(Boolean)
: [],
};
}
function parsePacLogRecords(value) {
const records = [];
const lines = String(value || "").split(/\r?\n/u);
let pending = "";
for (const line of lines) {
const trimmed = line.trim();
if (pending.length === 0) {
if (!trimmed.startsWith("{")) continue;
pending = trimmed;
} else {
pending += `\n${line}`;
}
try {
records.push(JSON.parse(pending));
pending = "";
} catch {
if (pending.length > 2 * 1024 * 1024) pending = "";
}
}
return records;
}
function exactTaskTerminal(records, pipelineTask) {
return [...records].reverse().find((item) => item.event === "pac-task-terminal"
&& item.pipelineTask === pipelineTask) || null;
}
function terminalSource(task, marker, markerStatus = "skipped", markerSource = "structured-log-marker") {
return {
present: task !== null || marker !== null,
status: task?.status || (marker === null ? "missing" : markerStatus),
source: task !== null ? "taskrun-condition" : marker === null ? null : markerSource,
taskRun: task?.taskRun || null,
reason: task?.reason || marker?.reason || null,
results: Array.isArray(task?.results) ? task.results : [],
markerPresent: marker !== null,
markerSource: marker === null ? null : markerSource,
};
}
function extractPacSourceObservation(recordsInput) {
const records = Array.isArray(recordsInput) ? recordsInput.map(record) : [];
const plan = [...records].reverse().find((item) => item.event === "g14-ci-plan") || null;
const collectMarker = exactSkipMarker(records, "collect-artifacts");
const promoteMarker = exactSkipMarker(records, "gitops-promote");
const planTask = exactTaskTerminal(records, "plan-artifacts");
const collectTask = exactTaskTerminal(records, "collect-artifacts");
const promoteTask = exactTaskTerminal(records, "gitops-promote");
if (plan === null && collectMarker === null && promoteMarker === null && planTask === null && collectTask === null && promoteTask === null) return null;
const affected = stringArray(plan?.affectedServices);
const rollout = stringArray(plan?.rolloutServices);
const build = stringArray(plan?.buildServices);
const reused = stringArray(plan?.reusedServices);
const sourceCommit = stringOrNull(plan?.sourceCommitId);
const planShapeValid = affected !== null && rollout !== null && build !== null;
const sourceCommitValid = sourceCommit !== null && /^[0-9a-f]{40}$/iu.test(sourceCommit);
const noRuntimeChangePlan = planShapeValid
&& affected.length === 0
&& rollout.length === 0
&& build.length === 0;
const noRuntimeChangeMarkers = collectMarker !== null && promoteMarker !== null;
const skipMarkerSeen = collectMarker !== null || promoteMarker !== null;
const skipMarkerConflict = skipMarkerSeen && !noRuntimeChangePlan;
const deliveryTerminalReady = planTask?.status === "succeeded"
&& collectTask?.status === "succeeded"
&& promoteTask?.status === "succeeded";
const deliveryTerminalFailed = planTask?.status === "failed"
|| collectTask?.status === "failed"
|| promoteTask?.status === "failed";
let mode = "inconsistent";
let valid = false;
let reason = "structured-plan-or-terminal-marker-is-incomplete";
if (planShapeValid && sourceCommitValid && noRuntimeChangePlan && noRuntimeChangeMarkers) {
mode = "no-runtime-change";
valid = true;
reason = "no-build-no-rollout-plan";
} else if (planShapeValid && sourceCommitValid && !noRuntimeChangePlan && !skipMarkerConflict && deliveryTerminalReady) {
mode = "delivery";
valid = true;
reason = "artifact-or-runtime-delivery-required";
} else if (!sourceCommitValid) {
reason = "source-commit-invalid-or-missing";
} else if (!planShapeValid) {
reason = "delivery-plan-shape-invalid-or-missing";
} else if (skipMarkerConflict) {
reason = "no-runtime-change-marker-conflicts-with-delivery-plan";
} else if (deliveryTerminalFailed) {
reason = "delivery-terminal-failed";
} else if (!noRuntimeChangePlan) {
reason = "delivery-terminal-evidence-incomplete";
}
return {
schemaVersion: "v1",
contract: "hwlab-g14-ci-plan",
mode,
valid,
reason,
sourceCommit,
plan: {
affectedServiceCount: affected?.length ?? null,
rolloutServiceCount: rollout?.length ?? null,
buildServiceCount: build?.length ?? null,
reusedServiceCount: reused?.length ?? null,
},
terminal: {
planArtifacts: planTask?.status || (plan === null ? "missing" : "observed"),
collectArtifacts: collectMarker !== null ? "no-build-no-rollout-plan" : collectTask?.status || "missing",
gitopsPromote: promoteMarker !== null ? "no-build-no-rollout-plan" : promoteTask?.status || "missing",
},
terminalSources: {
planArtifacts: terminalSource(planTask, plan, "observed", "g14-ci-plan-structured-log"),
collectArtifacts: terminalSource(collectTask, collectMarker),
gitopsPromote: terminalSource(promoteTask, promoteMarker),
},
valuesPrinted: false,
};
}
function digestOf(item) {
const digest = stringOrNull(item.digest);
if (digest !== null) return digest;
const digestRef = stringOrNull(item.digestRef);
return digestRef !== null && digestRef.includes("@") ? digestRef.split("@").slice(1).join("@") : null;
}
function extractPacArtifactEvidence(recordsInput, logText) {
const records = Array.isArray(recordsInput) ? recordsInput.map(record) : [];
const sourceObservation = extractPacSourceObservation(records);
const catalog = [...records].reverse().find((item) => item.status === "published"
&& Array.isArray(item.services)
&& typeof item.registryVerified === "boolean") || null;
const publish = [...records].reverse().find((item) => item.phase === "gitops-publish" || stringOrNull(item.gitopsCommit) !== null) || null;
const image = publish || [...records].reverse().find((item) => stringOrNull(item.imageStatus) !== null
|| item.status === "reused"
|| item.status === "built") || null;
const logLines = String(logText || "").split(/\r?\n/u);
const gitopsCommit = stringOrNull(image?.gitopsCommit)
|| [...logLines].reverse().map((line) => line.match(/^\[[^\]]+\s+([0-9a-f]{7,64})\]/u)?.[1] || null).find(Boolean)
|| null;
const catalogDigests = catalog === null
? []
: [...new Set(catalog.services.map(record).map(digestOf).filter((value) => /^sha256:[0-9a-f]{64}$/iu.test(value || "")))];
const loggedDigests = [...new Set(logLines.flatMap((line) => [...line.matchAll(/"(?:digest|environmentDigest)"\s*:\s*"(sha256:[0-9a-f]{64})"/gu)].map((match) => match[1])))];
const digests = catalogDigests.length > 0 ? catalogDigests : loggedDigests;
const envHeaderIndex = logLines.findIndex((line) => /^ENV_REUSE\s+NODE_DEPS\s+/u.test(line.trim()));
let humanEnv = null;
if (envHeaderIndex >= 0) {
const row = (logLines.slice(envHeaderIndex + 1).find((line) => line.trim()) || "").trim().split(/\s+/u);
if (row.length >= 5) humanEnv = { envReuse: row[0], nodeDeps: row[1], buildPackage: row[2], buildNetwork: row[3], cache: row[4] };
}
if (catalog !== null) {
const reusedCount = Number.isInteger(catalog.reusedCount) ? catalog.reusedCount : null;
const publishedCount = Number.isInteger(catalog.publishedCount) ? catalog.publishedCount : null;
return {
imageStatus: reusedCount !== null && reusedCount > 0 && publishedCount === 0 ? "reused" : "published",
envIdentity: null,
envReuse: reusedCount !== null && reusedCount > 0 ? "hit" : null,
nodeDepsReuse: null,
buildCache: null,
digest: digests.length === 1 ? digests[0] : null,
digests,
gitopsCommit,
sourceCommit: stringOrNull(catalog.sourceCommitId) || sourceObservation?.sourceCommit || null,
runtimeSourceCommit: null,
action: "artifact-catalog-published",
reason: reusedCount !== null && reusedCount > 0 ? "reused-env-catalog" : "artifact-catalog",
catalog: {
present: true,
status: stringOrNull(catalog.status),
sourceCommit: stringOrNull(catalog.sourceCommitId),
registryVerified: catalog.registryVerified === true,
publishedCount,
reusedCount,
requiredServiceCount: Number.isInteger(catalog.requiredServiceCount) ? catalog.requiredServiceCount : null,
digestCount: digests.length,
source: "collect-artifacts-structured-log",
valuesPrinted: false,
},
sourceObservation,
valuesPrinted: false,
};
}
if (image !== null) {
const env = record(image.envReuse);
return {
imageStatus: stringOrNull(image.imageStatus) || stringOrNull(image.status) || (stringOrNull(image.digestRef) !== null ? "built" : null),
envIdentity: stringOrNull(image.envIdentity),
envReuse: stringOrNull(env.dependencyReuse) || stringOrNull(env.mode) || stringOrNull(image.envReuseStatus),
nodeDepsReuse: null,
buildCache: null,
digest: digestOf(image) || (digests.length === 1 ? digests[0] : null),
digests,
gitopsCommit,
sourceCommit: stringOrNull(image.sourceCommit) || sourceObservation?.sourceCommit || null,
runtimeSourceCommit: stringOrNull(image.runtimeSourceCommit),
baselineSourceCommit: stringOrNull(image.baselineSourceCommit),
action: stringOrNull(image.action),
reason: stringOrNull(image.reason),
sourceObservation,
valuesPrinted: false,
};
}
if (sourceObservation !== null) {
return {
imageStatus: sourceObservation.mode === "no-runtime-change" && sourceObservation.valid === true ? "retained" : null,
envIdentity: null,
envReuse: null,
nodeDepsReuse: null,
buildCache: null,
digest: null,
digests: [],
gitopsCommit,
sourceCommit: sourceObservation.sourceCommit || null,
runtimeSourceCommit: null,
action: sourceObservation.mode,
reason: sourceObservation.reason,
sourceObservation,
valuesPrinted: false,
};
}
return {
imageStatus: humanEnv !== null ? "published" : null,
envIdentity: null,
envReuse: humanEnv?.envReuse || null,
nodeDepsReuse: humanEnv?.nodeDeps || null,
buildCache: humanEnv?.cache || null,
buildPackage: humanEnv?.buildPackage || null,
buildNetwork: humanEnv?.buildNetwork || null,
digest: digests.length === 1 ? digests[0] : null,
digests,
gitopsCommit,
sourceCommit: null,
sourceObservation: null,
valuesPrinted: false,
};
}
function evaluatePacStatus(inputValue) {
const input = record(inputValue);
const artifact = record(input.artifact);
const argo = record(input.argo);
const runtime = record(input.runtime);
const sourceObservation = record(artifact.sourceObservation);
const revisionRelation = record(argo.revisionRelation);
const gitopsRelation = stringOrNull(revisionRelation.relation) || "unknown";
const sourceCommit = stringOrNull(input.sourceCommit);
const registryDigest = stringOrNull(input.registryDigest);
const artifactDigest = stringOrNull(artifact.digest);
const expectedDigest = registryDigest || artifactDigest;
const runtimeImage = stringOrNull(runtime.image);
const runtimeDigest = stringOrNull(runtime.digest) || digestFromImage(runtimeImage);
const runtimeMatches = expectedDigest === null || runtimeDigest === expectedDigest;
const runtimeReady = Number.isInteger(runtime.replicas)
&& runtime.replicas > 0
&& runtime.readyReplicas === runtime.replicas;
const selectedArtifactDigests = [...new Set([
artifactDigest,
...(Array.isArray(artifact.digests) ? artifact.digests : []),
].filter((value) => typeof value === "string" && value.length > 0))];
const selectedArtifactMatchesRuntime = runtimeDigest !== null && selectedArtifactDigests.includes(runtimeDigest);
const registryMatchesArtifact = registryDigest === null || artifactDigest === null || registryDigest === artifactDigest;
const healthUrl = stringOrNull(input.healthUrl);
const healthStatus = stringOrNull(input.healthStatus);
const healthReady = healthUrl === null || healthStatus === "200";
const gitopsReady = stringOrNull(artifact.gitopsCommit) !== null && stringOrNull(argo.revision) !== null;
const gitopsRevisionAligned = gitopsRelation === "exact" || gitopsRelation === "descendant";
const deliveryDisabled = artifact.imageStatus === "disabled";
const deliverySkipped = artifact.imageStatus === "skipped";
const sourceObservationMode = stringOrNull(sourceObservation.mode);
const hwlabCatalogDelivery = sourceObservationMode === "delivery"
&& sourceObservation.contract === "hwlab-g14-ci-plan";
const noRuntimeChange = sourceObservationMode === "no-runtime-change";
const catalog = record(artifact.catalog);
const catalogPresent = catalog.present === true;
const catalogSourceCommit = stringOrNull(catalog.sourceCommit);
const catalogSourceMatches = catalogSourceCommit !== null && catalogSourceCommit === sourceCommit;
const catalogDeliveryEvidence = sourceObservationMode === "delivery"
&& sourceObservation.valid === true
&& catalogPresent
&& catalog.status === "published"
&& catalog.registryVerified === true
&& catalogSourceMatches;
const registryEvidenceReady = input.registryPresent === true || catalogDeliveryEvidence;
const sourceObservationInconsistent = sourceObservationMode === "inconsistent"
|| (sourceObservationMode !== null && sourceObservation.valid !== true);
const observationSourceCommit = stringOrNull(sourceObservation.sourceCommit);
const observationSourceMatches = sourceCommit !== null && observationSourceCommit === sourceCommit;
const retainedRevision = stringOrNull(argo.revision);
const retainedDigestReady = runtimeDigest !== null && /^sha256:[0-9a-f]{64}$/iu.test(runtimeDigest);
const retainedOutputConflict = noRuntimeChange
&& (stringOrNull(artifact.gitopsCommit) !== null
|| artifactDigest !== null
|| selectedArtifactDigests.length > 0);
let code = "pac-diagnostics-not-applicable";
let phase = "not-applicable";
let ok = true;
let hint = "consumer did not expose artifact or runtime alignment evidence";
if (deliveryDisabled) {
code = "pac-delivery-disabled";
phase = "disabled";
hint = "delivery is disabled by YAML; registry, GitOps and runtime artifacts are intentionally absent";
} else if (!sourceCommit) {
ok = false;
code = "pac-source-unknown";
phase = "source-unknown";
hint = "latest PaC PipelineRun did not expose a source commit";
} else if (sourceObservationInconsistent) {
ok = false;
code = "pac-source-observation-inconsistent";
phase = "source-observation-inconsistent";
hint = "structured delivery plan or terminal evidence is incomplete or contradictory";
} else if (sourceObservationMode !== null && !observationSourceMatches) {
ok = false;
code = "pac-source-observation-mismatch";
phase = "source-observation-mismatch";
hint = "the structured source observation does not belong to the selected PipelineRun source commit";
} else if (noRuntimeChange && retainedOutputConflict) {
ok = false;
code = "pac-retained-output-conflict";
phase = "source-only-output-conflict";
hint = "a no-runtime-change PipelineRun unexpectedly reported a new artifact or GitOps output";
} else if (noRuntimeChange && retainedRevision === null) {
ok = false;
code = "pac-retained-gitops-missing";
phase = "retained-gitops-missing";
hint = "the no-runtime-change observation is valid but the retained Argo GitOps revision is missing";
} else if (noRuntimeChange && (argo.sync !== "Synced" || argo.health !== "Healthy")) {
ok = false;
code = "pac-retained-argo-not-ready";
phase = "retained-argo-not-ready";
hint = "the no-runtime-change observation is valid but retained Argo is not Synced/Healthy";
} else if (noRuntimeChange && gitopsRelation !== "retained") {
ok = false;
code = "pac-retained-revision-unproven";
phase = "retained-revision-unproven";
hint = "the retained GitOps revision was not linked to the structured no-runtime-change observation";
} else if (noRuntimeChange && !runtimeReady) {
ok = false;
code = "pac-retained-runtime-not-ready";
phase = "retained-runtime-not-ready";
hint = "the retained runtime ready replicas do not match the desired replica count";
} else if (noRuntimeChange && !retainedDigestReady) {
ok = false;
code = "pac-retained-runtime-digest-missing";
phase = "retained-runtime-digest-missing";
hint = "the retained runtime is not pinned to a visible sha256 digest";
} else if (noRuntimeChange && !healthReady) {
ok = false;
code = "pac-retained-health-not-ready";
phase = "retained-health-not-ready";
hint = "the retained runtime health endpoint is not ready";
} else if (noRuntimeChange) {
code = "pac-ready-no-runtime-change";
phase = "ready-no-runtime-change";
hint = "the successful source observation requires no artifact, GitOps or runtime change; retained Argo and runtime provenance remain healthy";
} else if (catalogPresent && !catalogSourceMatches) {
ok = false;
code = "pac-artifact-catalog-source-mismatch";
phase = "artifact-catalog-source-mismatch";
hint = "the artifact catalog source commit does not match the selected PipelineRun";
} else if (hwlabCatalogDelivery && (!catalogPresent || catalog.status !== "published")) {
ok = false;
code = "pac-artifact-catalog-missing";
phase = "artifact-catalog-missing";
hint = "the HWLAB delivery plan completed but a published artifact catalog is not visible";
} else if (hwlabCatalogDelivery && catalog.registryVerified !== true) {
ok = false;
code = "pac-artifact-catalog-unverified";
phase = "artifact-catalog-unverified";
hint = "the HWLAB artifact catalog did not prove registry verification";
} else if (hwlabCatalogDelivery && selectedArtifactDigests.length === 0) {
ok = false;
code = "pac-artifact-catalog-digest-missing";
phase = "artifact-catalog-digest-missing";
hint = "the HWLAB artifact catalog did not expose any sha256 digest";
} else if (stringOrNull(input.imageRepository) !== null && !registryEvidenceReady) {
ok = false;
code = "pac-registry-missing";
phase = "source-ready-registry-missing";
hint = "PaC source commit is known but neither the configured registry tag nor a verified artifact catalog is visible";
} else if (!registryMatchesArtifact) {
ok = false;
code = "pac-artifact-registry-mismatch";
phase = "artifact-registry-mismatch";
hint = "PipelineRun artifact digest does not match the configured registry digest";
} else if (!gitopsReady) {
ok = false;
code = "pac-gitops-missing";
phase = "artifact-ready-gitops-missing";
hint = "PipelineRun completed but its GitOps commit is not visible";
} else if (argo.sync !== "Synced" || argo.health !== "Healthy") {
ok = false;
code = "pac-argo-not-ready";
phase = "gitops-ready-argo-pending";
hint = "GitOps exists but Argo is not Synced/Healthy";
} else if (!gitopsRevisionAligned) {
ok = false;
code = `pac-argo-revision-${gitopsRelation}`;
phase = `gitops-ready-argo-revision-${gitopsRelation}`;
hint = `Argo revision relation is ${gitopsRelation}; only exact or commit-graph-proven descendant is deployable`;
} else if (catalogDeliveryEvidence && !selectedArtifactMatchesRuntime) {
ok = false;
code = "pac-catalog-artifact-runtime-mismatch";
phase = "artifact-catalog-runtime-mismatch";
hint = "the runtime digest is not present in the verified artifact catalog for this PipelineRun";
} else if (gitopsRelation === "descendant" && !selectedArtifactMatchesRuntime) {
ok = false;
code = "pac-descendant-artifact-runtime-mismatch";
phase = "argo-descendant-runtime-mismatch";
hint = "a GitOps descendant is ready only when the selected PipelineRun artifact digest exactly matches the runtime digest";
} else if (!runtimeMatches) {
ok = false;
code = "pac-runtime-not-aligned";
phase = "argo-ready-runtime-mismatch";
hint = "runtime image digest does not match the artifact digest produced by the selected PipelineRun";
} else if (!runtimeReady) {
ok = false;
code = "pac-runtime-not-ready";
phase = "runtime-replicas-not-ready";
hint = "runtime ready replicas do not match the desired replica count";
} else if (!healthReady) {
ok = false;
code = "pac-health-not-ready";
phase = "runtime-ready-health-pending";
hint = "runtime image is aligned but the configured health endpoint is not ready";
} else if (artifactDigest || selectedArtifactDigests.length > 0 || stringOrNull(input.imageRepository) !== null) {
code = deliverySkipped
? "pac-ready-runtime-unchanged"
: gitopsRelation === "descendant"
? "pac-ready-gitops-descendant"
: "pac-ready-gitops-exact";
phase = "ready";
hint = deliverySkipped
? "YAML-declared runtime inputs are unchanged; the existing image, GitOps manifest, runtime and health remain aligned"
: gitopsRelation === "descendant"
? "Argo is on a commit-graph-proven GitOps descendant and the selected artifact, runtime, Argo and health are aligned"
: "Argo is on the exact selected GitOps commit and the artifact, runtime, Argo and health are aligned";
}
return {
ok,
code,
phase,
hint,
sourceCommit,
runtimeSourceCommit: stringOrNull(input.runtimeSourceCommit),
imageRepository: stringOrNull(input.imageRepository),
registryProbeBase: stringOrNull(input.registryProbeBase),
imageTag: stringOrNull(input.imageTag),
registry: {
present: registryEvidenceReady,
probePresent: input.registryPresent === true,
catalogVerified: catalogDeliveryEvidence,
digest: registryDigest,
url: stringOrNull(input.registryUrl),
},
selectedArtifactDigests,
gitops: {
branch: stringOrNull(input.gitopsBranch),
manifestPath: stringOrNull(input.gitopsManifestPath),
commit: noRuntimeChange ? retainedRevision : stringOrNull(artifact.gitopsCommit) || retainedRevision,
revisionRelation,
},
argo: {
sync: stringOrNull(argo.sync),
health: stringOrNull(argo.health),
revision: retainedRevision,
repoURL: stringOrNull(argo.repoURL),
targetRevision: stringOrNull(argo.targetRevision),
revisionRelation,
},
runtime: {
image: runtimeImage,
digest: runtimeDigest,
readyReplicas: runtime.readyReplicas ?? null,
replicas: runtime.replicas ?? null,
},
health: { url: healthUrl, status: healthStatus, ready: healthReady },
pipelineRun: stringOrNull(input.pipelineRun),
deliveryDisabled,
deliverySkipped,
deliveryMode: noRuntimeChange ? "no-runtime-change" : sourceObservationMode || "delivery",
sourceObservation: Object.keys(sourceObservation).length > 0 ? sourceObservation : null,
provenance: noRuntimeChange ? {
relation: "retained",
sourceCommit,
gitopsRevision: retainedRevision,
runtimeImage,
runtimeDigest,
newArtifact: false,
newGitopsRevision: false,
runtimeChanged: false,
valuesPrinted: false,
} : {
relation: gitopsRelation,
sourceCommit,
gitopsRevision: retainedRevision,
runtimeImage,
runtimeDigest,
valuesPrinted: false,
},
valuesPrinted: false,
};
}
function fixtureInput(overrides = {}) {
const digest = `sha256:${"a".repeat(64)}`;
const revision = "b".repeat(40);
return {
sourceCommit: "c".repeat(40),
artifact: {},
argo: {
sync: "Synced",
health: "Healthy",
revision,
revisionRelation: { relation: "retained", observedRevision: revision },
},
runtime: { image: `registry/service@${digest}`, digest, replicas: 1, readyReplicas: 1 },
registryPresent: false,
healthUrl: null,
healthStatus: null,
...overrides,
};
}
function noRuntimeChangeObservation(sourceCommit = "c".repeat(40)) {
return extractPacSourceObservation([
{
event: "g14-ci-plan",
sourceCommitId: sourceCommit,
affectedServices: [],
rolloutServices: [],
buildServices: [],
reusedServices: ["service"],
},
{ event: "collect-artifacts", status: "skipped", reason: "no-build-no-rollout-plan" },
{ event: "gitops-promote", status: "skipped", reason: "no-build-no-rollout-plan" },
]);
}
function deliveryObservation(sourceCommit = "c".repeat(40)) {
return extractPacSourceObservation([
{
event: "g14-ci-plan",
sourceCommitId: sourceCommit,
affectedServices: ["service"],
rolloutServices: ["service"],
buildServices: ["service"],
reusedServices: [],
},
{ event: "pac-task-terminal", pipelineTask: "plan-artifacts", taskRun: "plan", status: "succeeded", reason: "Succeeded", results: [] },
{ event: "pac-task-terminal", pipelineTask: "collect-artifacts", taskRun: "collect", status: "succeeded", reason: "Succeeded", results: [] },
{ event: "pac-task-terminal", pipelineTask: "gitops-promote", taskRun: "promote", status: "succeeded", reason: "Succeeded", results: [] },
]);
}
function publishedCatalog(sourceCommit = "c".repeat(40)) {
return { present: true, status: "published", sourceCommit, registryVerified: true };
}
function runPacStatusFixtureChecks() {
const digestA = `sha256:${"a".repeat(64)}`;
const digestD = `sha256:${"d".repeat(64)}`;
const revision = "b".repeat(40);
const retained = noRuntimeChangeObservation();
const delivery = deliveryObservation();
const exactArgo = { sync: "Synced", health: "Healthy", revision, revisionRelation: { relation: "exact", expectedRevision: revision, observedRevision: revision } };
const cases = [
{
id: "retained-ready",
expectedOk: true,
expectedCode: "pac-ready-no-runtime-change",
input: fixtureInput({ artifact: { imageStatus: "retained", sourceObservation: retained } }),
},
{
id: "retained-gitops-missing",
expectedOk: false,
expectedCode: "pac-retained-gitops-missing",
input: fixtureInput({ artifact: { imageStatus: "retained", sourceObservation: retained }, argo: { sync: "Synced", health: "Healthy", revision: null, revisionRelation: { relation: "unknown" } } }),
},
{
id: "delivery-ready-exact",
expectedOk: true,
expectedCode: "pac-ready-gitops-exact",
input: fixtureInput({ artifact: { imageStatus: "built", digest: digestA, digests: [digestA], gitopsCommit: revision, sourceObservation: delivery, catalog: publishedCatalog() }, argo: exactArgo, runtime: { image: `registry/service@${digestA}`, digest: digestA, replicas: 1, readyReplicas: 1 } }),
},
{
id: "delivery-gitops-missing",
expectedOk: false,
expectedCode: "pac-gitops-missing",
input: fixtureInput({ artifact: { imageStatus: "built", digest: digestA, digests: [digestA], sourceObservation: delivery, catalog: publishedCatalog() }, argo: { sync: "Synced", health: "Healthy", revision: null, revisionRelation: { relation: "unknown" } } }),
},
{
id: "delivery-runtime-mismatch",
expectedOk: false,
expectedCode: "pac-catalog-artifact-runtime-mismatch",
input: fixtureInput({ artifact: { imageStatus: "built", digest: digestA, digests: [digestA], gitopsCommit: revision, sourceObservation: delivery, catalog: publishedCatalog() }, argo: exactArgo, runtime: { image: `registry/service@${digestD}`, digest: digestD, replicas: 1, readyReplicas: 1 } }),
},
{
id: "catalog-delivery-ready",
expectedOk: true,
expectedCode: "pac-ready-gitops-exact",
input: fixtureInput({ imageRepository: "registry/service", artifact: { imageStatus: "reused", digests: [digestA], gitopsCommit: revision, sourceObservation: delivery, catalog: { present: true, status: "published", sourceCommit: "c".repeat(40), registryVerified: true } }, argo: exactArgo, runtime: { image: `registry/service@${digestA}`, digest: digestA, replicas: 1, readyReplicas: 1 } }),
},
{
id: "catalog-delivery-missing",
expectedOk: false,
expectedCode: "pac-artifact-catalog-missing",
input: fixtureInput({ imageRepository: "registry/service", artifact: { imageStatus: "reused", digest: digestA, digests: [digestA], gitopsCommit: revision, sourceObservation: delivery }, registryPresent: true, argo: exactArgo, runtime: { image: `registry/service@${digestA}`, digest: digestA, replicas: 1, readyReplicas: 1 } }),
},
{
id: "catalog-delivery-unverified",
expectedOk: false,
expectedCode: "pac-artifact-catalog-unverified",
input: fixtureInput({ imageRepository: "registry/service", artifact: { imageStatus: "reused", digest: digestA, digests: [digestA], gitopsCommit: revision, sourceObservation: delivery, catalog: { present: true, status: "published", sourceCommit: "c".repeat(40), registryVerified: false } }, registryPresent: true, argo: exactArgo, runtime: { image: `registry/service@${digestA}`, digest: digestA, replicas: 1, readyReplicas: 1 } }),
},
{
id: "catalog-delivery-digest-missing",
expectedOk: false,
expectedCode: "pac-artifact-catalog-digest-missing",
input: fixtureInput({ imageRepository: "registry/service", artifact: { imageStatus: "reused", gitopsCommit: revision, sourceObservation: delivery, catalog: { present: true, status: "published", sourceCommit: "c".repeat(40), registryVerified: true } }, registryPresent: true, argo: exactArgo, runtime: { image: `registry/service@${digestA}`, digest: digestA, replicas: 1, readyReplicas: 1 } }),
},
{
id: "catalog-delivery-runtime-mismatch",
expectedOk: false,
expectedCode: "pac-catalog-artifact-runtime-mismatch",
input: fixtureInput({ imageRepository: "registry/service", artifact: { imageStatus: "reused", digests: [digestA], gitopsCommit: revision, sourceObservation: delivery, catalog: { present: true, status: "published", sourceCommit: "c".repeat(40), registryVerified: true } }, argo: exactArgo, runtime: { image: `registry/service@${digestD}`, digest: digestD, replicas: 1, readyReplicas: 1 } }),
},
{
id: "delivery-terminal-evidence-missing",
expectedOk: false,
expectedCode: "pac-source-observation-inconsistent",
input: fixtureInput({ artifact: { sourceObservation: extractPacSourceObservation([{ event: "g14-ci-plan", sourceCommitId: "c".repeat(40), affectedServices: ["service"], rolloutServices: ["service"], buildServices: [], reusedServices: ["service"] }]) } }),
},
{
id: "incomplete-no-runtime-change-markers",
expectedOk: false,
expectedCode: "pac-source-observation-inconsistent",
input: fixtureInput({ artifact: { sourceObservation: extractPacSourceObservation([{ event: "g14-ci-plan", sourceCommitId: "c".repeat(40), affectedServices: [], rolloutServices: [], buildServices: [], reusedServices: [] }]) } }),
},
{
id: "retained-source-mismatch",
expectedOk: false,
expectedCode: "pac-source-observation-mismatch",
input: fixtureInput({ sourceCommit: "e".repeat(40), artifact: { imageStatus: "retained", sourceObservation: retained } }),
},
{
id: "delivery-one-sided-skip-conflict",
expectedOk: false,
expectedCode: "pac-source-observation-inconsistent",
input: fixtureInput({ artifact: { sourceObservation: extractPacSourceObservation([
{ event: "g14-ci-plan", sourceCommitId: "c".repeat(40), affectedServices: ["service"], rolloutServices: ["service"], buildServices: ["service"], reusedServices: [] },
{ event: "gitops-promote", status: "skipped", reason: "no-build-no-rollout-plan" },
]) } }),
},
];
const checks = cases.map((item) => {
const result = evaluatePacStatus(item.input);
return {
id: item.id,
ok: result.ok === item.expectedOk && result.code === item.expectedCode,
expectedOk: item.expectedOk,
actualOk: result.ok,
expectedCode: item.expectedCode,
actualCode: result.code,
};
});
return { ok: checks.every((item) => item.ok), checks, valuesPrinted: false };
}
module.exports = {
evaluatePacStatus,
extractPacArtifactEvidence,
extractPacSourceObservation,
parsePacLogRecords,
runPacStatusFixtureChecks,
taskTerminalRecord,
};