feat(release): re-verify a promoted release in archived mode (13-04)
Provider evidence expires two hours after issue, so no repo tool could re-verify a release before deploying it later or rolling back to it. verify:promotion --archived keeps every signature, digest and member check and judges freshness at the recorded promotion time; the FE-RB-005 drill takes the extracted release with --release-root. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
1a1cfe6605
commit
839205c134
@@ -249,6 +249,31 @@ try {
|
||||
},
|
||||
nowEpochMs: () => now,
|
||||
} as const;
|
||||
// 13-04: the same bundle three hours later. Current freshness refuses the
|
||||
// expired provider evidence; archived freshness accepts it at the recorded
|
||||
// promotion time, and still refuses a tampered archive.
|
||||
const threeHoursLater = now + 3 * 60 * 60 * 1_000;
|
||||
const archivedAfterWindow = await captureRejection(async () => {
|
||||
await verifyExactPromotionBundle(exactFiles, {
|
||||
...bundleTrust,
|
||||
nowEpochMs: () => threeHoursLater,
|
||||
freshness: "archived",
|
||||
});
|
||||
});
|
||||
const currentAfterWindow = await captureRejection(async () => {
|
||||
await verifyExactPromotionBundle(exactFiles, {
|
||||
...bundleTrust,
|
||||
nowEpochMs: () => threeHoursLater,
|
||||
});
|
||||
});
|
||||
const tamperedArchive = Buffer.from(exactFiles["release-candidate.tar.gz"]);
|
||||
tamperedArchive[tamperedArchive.length - 1] ^= 0xff;
|
||||
const archivedTampered = await captureRejection(async () => {
|
||||
await verifyExactPromotionBundle(
|
||||
{ ...exactFiles, "release-candidate.tar.gz": tamperedArchive },
|
||||
{ ...bundleTrust, nowEpochMs: () => threeHoursLater, freshness: "archived" },
|
||||
);
|
||||
});
|
||||
const absentFiles = { ...exactFiles } as Partial<typeof exactFiles>;
|
||||
delete absentFiles["provider-verification.json"];
|
||||
const absent = await captureRejection(async () => {
|
||||
@@ -282,7 +307,8 @@ try {
|
||||
await captureCiCandidateArchive({ archivePath, expectedSha256: "0".repeat(64) });
|
||||
});
|
||||
const passed =
|
||||
validImmutable && absent.rejected && invalidTar.rejected && wrongDigest.rejected;
|
||||
validImmutable && absent.rejected && invalidTar.rejected && wrongDigest.rejected &&
|
||||
!archivedAfterWindow.rejected && currentAfterWindow.rejected && archivedTampered.rejected;
|
||||
await cleanupFinalizedPromotion({
|
||||
runnerTempRoot,
|
||||
stagingRoot: finalized.stagingRoot,
|
||||
@@ -314,12 +340,24 @@ try {
|
||||
status: invalidTar.rejected ? "FAIL_UNVERIFIED" : "PASS",
|
||||
failures: [invalidTar.failure],
|
||||
},
|
||||
archivedAfterWindow: {
|
||||
status: archivedAfterWindow.rejected ? "FAIL_UNVERIFIED" : "PASS",
|
||||
failures: archivedAfterWindow.rejected ? [archivedAfterWindow.failure] : [],
|
||||
},
|
||||
currentAfterWindow: {
|
||||
status: currentAfterWindow.rejected ? "FAIL_UNVERIFIED" : "PASS",
|
||||
failures: [currentAfterWindow.failure],
|
||||
},
|
||||
archivedTampered: {
|
||||
status: archivedTampered.rejected ? "FAIL_UNVERIFIED" : "PASS",
|
||||
failures: [archivedTampered.failure],
|
||||
},
|
||||
},
|
||||
externalTreeCanary: {
|
||||
status: validImmutable ? "PASS" : "FAIL_UNVERIFIED",
|
||||
failures: validImmutable ? [] : ["external tree canary influenced captured archive"],
|
||||
},
|
||||
passingFixtureCount: validImmutable ? 1 : 0,
|
||||
passingFixtureCount: (validImmutable ? 1 : 0) + (archivedAfterWindow.rejected ? 0 : 1),
|
||||
status: passed ? "PASS" : "FAIL",
|
||||
},
|
||||
});
|
||||
|
||||
@@ -1297,6 +1297,10 @@ export const supplyChainProviderFixturesArtifactSchema = z
|
||||
validImmutable: providerFixtureResultSchema,
|
||||
wrongDigest: providerFixtureResultSchema,
|
||||
invalidTar: providerFixtureResultSchema,
|
||||
// 13-04: archived re-verification of the same bundle three hours on.
|
||||
archivedAfterWindow: providerFixtureResultSchema,
|
||||
currentAfterWindow: providerFixtureResultSchema,
|
||||
archivedTampered: providerFixtureResultSchema,
|
||||
})
|
||||
.strict(),
|
||||
externalTreeCanary: providerFixtureResultSchema,
|
||||
@@ -1308,11 +1312,19 @@ export const supplyChainProviderFixturesArtifactSchema = z
|
||||
const expectedPass =
|
||||
artifact.actualDefaultVerifier.status === "PASS" &&
|
||||
artifact.fixtures.validImmutable.status === "PASS" &&
|
||||
artifact.fixtures.archivedAfterWindow.status === "PASS" &&
|
||||
artifact.externalTreeCanary.status === "PASS" &&
|
||||
[artifact.fixtures.absent, artifact.fixtures.wrongDigest, artifact.fixtures.invalidTar]
|
||||
.every(({ status }) => status === "FAIL_UNVERIFIED");
|
||||
if (artifact.passingFixtureCount !== (artifact.fixtures.validImmutable.status === "PASS" ? 1 : 0)) {
|
||||
context.addIssue({ code: "custom", path: ["passingFixtureCount"], message: "must count the passing immutable fixture" });
|
||||
[
|
||||
artifact.fixtures.absent,
|
||||
artifact.fixtures.wrongDigest,
|
||||
artifact.fixtures.invalidTar,
|
||||
artifact.fixtures.currentAfterWindow,
|
||||
artifact.fixtures.archivedTampered,
|
||||
].every(({ status }) => status === "FAIL_UNVERIFIED");
|
||||
const passing = [artifact.fixtures.validImmutable, artifact.fixtures.archivedAfterWindow]
|
||||
.filter(({ status }) => status === "PASS").length;
|
||||
if (artifact.passingFixtureCount !== passing) {
|
||||
context.addIssue({ code: "custom", path: ["passingFixtureCount"], message: "must count the passing fixtures" });
|
||||
}
|
||||
if ((artifact.status === "PASS") !== expectedPass) {
|
||||
context.addIssue({ code: "custom", path: ["status"], message: "must agree with required fixture outcomes" });
|
||||
|
||||
@@ -72,8 +72,12 @@ export type RollbackCoherenceOptions = Readonly<{
|
||||
}>;
|
||||
|
||||
export type DrillOptions = Readonly<{
|
||||
/** Directory holding `dist/` and `config/runbooks/`. Defaults to the cwd. */
|
||||
root?: string;
|
||||
/**
|
||||
* Directory holding the release's `dist/`. Defaults to the cwd (the local
|
||||
* build). 13-04: pass an extracted candidate or promoted archive to drill
|
||||
* the release that is actually deployed or rolled back to.
|
||||
*/
|
||||
releaseRoot?: string;
|
||||
contractPackages?: readonly InstalledContractPackageIdentity[];
|
||||
}>;
|
||||
|
||||
@@ -389,11 +393,11 @@ export async function verifyRollbackReleaseCoherence(
|
||||
|
||||
export async function runRunbookDrill(runbookId: string, options: DrillOptions = {}) {
|
||||
const context: DrillContext = {
|
||||
root: options.root ?? process.cwd(),
|
||||
root: options.releaseRoot ?? process.cwd(),
|
||||
contractPackages: options.contractPackages ?? EXPECTED_CONTRACT_SET_PACKAGES,
|
||||
};
|
||||
const document = JSON.parse(
|
||||
await readFile(path.join(context.root, "config/runbooks/runbooks.json"), "utf8"),
|
||||
await readFile("config/runbooks/runbooks.json", "utf8"),
|
||||
) as RunbookDocument;
|
||||
const specification = document.runbooks[runbookId];
|
||||
const drill = drillById[runbookId];
|
||||
@@ -435,12 +439,16 @@ async function main(): Promise<void> {
|
||||
const runbookId = process.argv
|
||||
.slice(2)
|
||||
.find((argument) => /^FE-RB-00[1-5]$/.test(argument));
|
||||
if (!runbookId) {
|
||||
process.stderr.write("Usage: drill:runbook -- FE-RB-001..FE-RB-005\n");
|
||||
const releaseRootFlag = process.argv.indexOf("--release-root");
|
||||
const releaseRoot = releaseRootFlag >= 0 ? process.argv[releaseRootFlag + 1] : undefined;
|
||||
if (!runbookId || (releaseRootFlag >= 0 && !releaseRoot)) {
|
||||
process.stderr.write(
|
||||
"Usage: drill:runbook -- FE-RB-001..FE-RB-005 [--release-root <extracted release archive>]\n",
|
||||
);
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
const { gateId, ...record } = await runRunbookDrill(runbookId);
|
||||
const { gateId, ...record } = await runRunbookDrill(runbookId, releaseRoot ? { releaseRoot } : {});
|
||||
const artifactDirectory = `artifacts/runbooks/${runbookId}`;
|
||||
await mkdir(artifactDirectory, { recursive: true });
|
||||
await writeValidatedJsonArtifact({
|
||||
|
||||
@@ -9,6 +9,7 @@ import {
|
||||
import {
|
||||
PROMOTION_VERIFIER_ID,
|
||||
PROMOTION_VERIFIER_VERSION,
|
||||
PROVIDER_FUTURE_SKEW_MS,
|
||||
assertDistinctProviderTrust,
|
||||
evaluatePromotionEvidence,
|
||||
providerVerificationArtifactSchema,
|
||||
@@ -35,6 +36,29 @@ export type ExactPromotionExpectedContext = Readonly<{
|
||||
lockfileSha256?: string;
|
||||
}>;
|
||||
|
||||
/**
|
||||
* 13-04. `current` checks provider evidence against the clock, as a new
|
||||
* promotion must. `archived` re-verifies a release promoted earlier (deploying
|
||||
* it later, or rolling back to it): signatures, digests and members are checked
|
||||
* the same way, but freshness is judged at the promotion's recorded
|
||||
* `verifiedAt`, which may not lie in the future. Promotion itself
|
||||
* (promotion-stager.ts) never passes `archived`.
|
||||
*/
|
||||
export type PromotionFreshness = "current" | "archived";
|
||||
|
||||
export function promotionEvidenceTime(
|
||||
freshness: PromotionFreshness,
|
||||
verifiedAt: string,
|
||||
now: number,
|
||||
): number {
|
||||
if (freshness === "current") return now;
|
||||
const verified = Date.parse(verifiedAt);
|
||||
if (!Number.isFinite(verified) || verified > now + PROVIDER_FUTURE_SKEW_MS) {
|
||||
throw new Error("archived promotion verifiedAt is in the future or invalid");
|
||||
}
|
||||
return verified;
|
||||
}
|
||||
|
||||
export async function verifyExactPromotionBundle(
|
||||
files: ExactPromotionBundle,
|
||||
options: Readonly<{
|
||||
@@ -42,6 +66,7 @@ export async function verifyExactPromotionBundle(
|
||||
provenanceTrust: ProviderTrust;
|
||||
expected: ExactPromotionExpectedContext;
|
||||
nowEpochMs?: () => number;
|
||||
freshness?: PromotionFreshness;
|
||||
}>,
|
||||
): Promise<Readonly<{ status: "PASS" }>> {
|
||||
assertDistinctProviderTrust(options);
|
||||
@@ -286,7 +311,12 @@ export async function verifyExactPromotionBundle(
|
||||
provenanceAttestation: provenance,
|
||||
vulnerabilityTrust: options.vulnerabilityTrust,
|
||||
provenanceTrust: options.provenanceTrust,
|
||||
nowEpochMs: options.nowEpochMs,
|
||||
nowEpochMs: () =>
|
||||
promotionEvidenceTime(
|
||||
options.freshness ?? "current",
|
||||
promotion.verifiedAt,
|
||||
(options.nowEpochMs ?? Date.now)(),
|
||||
),
|
||||
});
|
||||
if (
|
||||
reevaluated.status !== "PASS" ||
|
||||
|
||||
@@ -55,9 +55,13 @@ const files = Object.fromEntries(
|
||||
] as const),
|
||||
),
|
||||
);
|
||||
// 13-04: `--archived` re-verifies a release promoted earlier (deploy later or
|
||||
// roll back to it); freshness is judged at its recorded promotion time.
|
||||
const freshness = process.argv.includes("--archived") ? "archived" : "current";
|
||||
await verifyExactPromotionBundle(files, {
|
||||
vulnerabilityTrust,
|
||||
provenanceTrust,
|
||||
freshness,
|
||||
expected: {
|
||||
run: {
|
||||
id: required("EXPECTED_PROMOTION_RUN_ID"),
|
||||
@@ -71,7 +75,7 @@ await verifyExactPromotionBundle(files, {
|
||||
...optionalDigest("lockfileSha256", "EXPECTED_PROMOTION_LOCKFILE_SHA256"),
|
||||
},
|
||||
});
|
||||
process.stdout.write("Exact promotion bundle verification: PASS\n");
|
||||
process.stdout.write(`Exact promotion bundle verification (${freshness}): PASS\n`);
|
||||
|
||||
function asciiCompare(left: string, right: string): number {
|
||||
return left < right ? -1 : left > right ? 1 : 0;
|
||||
|
||||
Reference in New Issue
Block a user