@timurproko/a1 0.1.0

package/dist/src/foundation/release/cohort-state.d.ts

@@ -0,0 +1,68 @@
+import type { MaterializedRelease } from "./release-store.js";
+export type ReleaseApproval = "candidate" | "approved" | "rejected";
+export interface ReleaseRecord {
+    readonly releaseId: string;
+    readonly releaseRoot: string;
+    readonly packageVersion: string;
+    readonly contentDigest: string;
+    readonly approval: ReleaseApproval;
+    readonly materializedAt: string;
+    readonly certifiedAt: string | null;
+    readonly diagnosticsPath: string | null;
+}
+export interface ReleaseReferences {
+    readonly active: string | null;
+    readonly pending: string | null;
+    readonly approved: string | null;
+    readonly rollback: string | null;
+    readonly retention: readonly string[];
+}
+export interface CohortState {
+    readonly schemaVersion: 1;
+    readonly revision: number;
+    readonly releases: Readonly<Record<string, ReleaseRecord>>;
+    readonly references: ReleaseReferences;
+    readonly activation: {
+        readonly state: "idle" | "pending" | "draining" | "blocked" | "failed";
+        readonly reason: string | null;
+        readonly blockerGenerationIds: readonly string[];
+        readonly updatedAt: string;
+    };
+}
+export interface EndpointOwnership {
+    readonly state: "idle" | "busy" | "draining" | "released" | "blocked";
+    readonly liveGenerationIds: readonly string[];
+    readonly nonResumableGenerationIds: readonly string[];
+}
+export interface SupervisorEndpointMetadata {
+    readonly supervisorId: string;
+    readonly endpoint: string;
+    readonly pid: number;
+    readonly pidStartIdentity: string;
+    readonly bootNonce: string;
+    readonly startedAt: string;
+    readonly releaseId: string;
+    readonly releaseRoot: string;
+    readonly contentDigest: string;
+    readonly ownership: EndpointOwnership;
+    readonly envelope: string;
+    readonly envelopeRevision: number;
+    readonly requiredFeatures: readonly string[];
+    readonly optionalFeatures: readonly string[];
+    readonly contractDigest: string;
+}
+export declare class CohortStateStore {
+    readonly path: string;
+    constructor(dataDir: string);
+    read(): Promise<CohortState>;
+    update(operation: (current: CohortState) => CohortState): Promise<CohortState>;
+    recordCandidate(release: MaterializedRelease): Promise<CohortState>;
+    approve(releaseId: string, diagnosticsPath: string): Promise<CohortState>;
+    activate(releaseId: string): Promise<CohortState>;
+    blockPending(reason: string, blockerGenerationIds: readonly string[]): Promise<CohortState>;
+    rollback(ownershipReleased: boolean): Promise<CohortState>;
+    setRetention(releaseIds: readonly string[]): Promise<CohortState>;
+    removeUnreferencedRelease(releaseId: string, externalReferences: readonly string[]): Promise<CohortState>;
+}
+export declare function emptyState(): CohortState;
+//# sourceMappingURL=cohort-state.d.ts.map

package/dist/src/foundation/release/cohort-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cohort-state.d.ts","sourceRoot":"","sources":["../../../../src/foundation/release/cohort-state.ts"],"names":[],"mappings":"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"}

package/dist/src/foundation/release/cohort-state.js

@@ -0,0 +1,201 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, open, readFile, rename, rm } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+export class CohortStateStore {
+    path;
+    constructor(dataDir) {
+        this.path = resolve(dataDir, "release-state.json");
+    }
+    async read() {
+        try {
+            const state = JSON.parse(await readFile(this.path, "utf8"));
+            validateState(state);
+            return state;
+        }
+        catch (error) {
+            if (error instanceof Error && "code" in error && error.code === "ENOENT")
+                return emptyState();
+            throw error;
+        }
+    }
+    async update(operation) {
+        await mkdir(dirname(this.path), { recursive: true, mode: 0o700 });
+        const lockPath = `${this.path}.lock`;
+        const lock = await acquireLock(lockPath);
+        try {
+            const current = await this.read();
+            const next = operation(current);
+            validateTransition(current, next);
+            const committed = { ...next, revision: current.revision + 1 };
+            const temporary = `${this.path}.${process.pid}.${randomUUID()}.tmp`;
+            const file = await open(temporary, "wx", 0o600);
+            try {
+                await file.writeFile(JSON.stringify(committed, null, 2));
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
+            await rename(temporary, this.path);
+            return committed;
+        }
+        finally {
+            await lock.close();
+            await rm(lockPath, { force: true });
+        }
+    }
+    async recordCandidate(release) {
+        return await this.update(current => {
+            const existing = current.releases[release.releaseId];
+            const record = existing ?? {
+                releaseId: release.releaseId,
+                releaseRoot: release.releaseRoot,
+                packageVersion: release.packageVersion,
+                contentDigest: release.contentDigest,
+                approval: "candidate",
+                materializedAt: new Date().toISOString(),
+                certifiedAt: null,
+                diagnosticsPath: null,
+            };
+            return {
+                ...current,
+                releases: { ...current.releases, [release.releaseId]: record },
+                references: {
+                    ...current.references,
+                    pending: current.references.active === release.releaseId ? current.references.pending : release.releaseId,
+                    retention: unique([...current.references.retention, release.releaseId]),
+                },
+                activation: activation("pending", "candidate awaits certification and safe activation"),
+            };
+        });
+    }
+    async approve(releaseId, diagnosticsPath) {
+        return await this.update(current => {
+            const release = requiredRelease(current, releaseId);
+            return {
+                ...current,
+                releases: { ...current.releases, [releaseId]: { ...release, approval: "approved", certifiedAt: new Date().toISOString(), diagnosticsPath } },
+                references: { ...current.references, approved: releaseId, pending: current.references.active === releaseId ? null : releaseId },
+            };
+        });
+    }
+    async activate(releaseId) {
+        return await this.update(current => {
+            const release = requiredRelease(current, releaseId);
+            if (release.approval !== "approved")
+                throw new Error(`cannot activate unverified release ${releaseId}`);
+            const prior = current.references.active;
+            return {
+                ...current,
+                references: {
+                    active: releaseId,
+                    pending: null,
+                    approved: releaseId,
+                    rollback: prior && prior !== releaseId ? prior : current.references.rollback,
+                    retention: unique([...current.references.retention, releaseId, ...(prior ? [prior] : [])]),
+                },
+                activation: activation("idle", null),
+            };
+        });
+    }
+    async blockPending(reason, blockerGenerationIds) {
+        return await this.update(current => ({ ...current, activation: { ...activation("blocked", reason), blockerGenerationIds: [...blockerGenerationIds] } }));
+    }
+    async rollback(ownershipReleased) {
+        if (!ownershipReleased)
+            throw new Error("cannot roll back before current cohort ownership is released");
+        return await this.update(current => {
+            const rollbackId = current.references.rollback;
+            if (!rollbackId)
+                throw new Error("no rollback release is recorded");
+            const rollback = requiredRelease(current, rollbackId);
+            if (rollback.approval !== "approved")
+                throw new Error(`cannot roll back to unverified release ${rollbackId}`);
+            return {
+                ...current,
+                references: {
+                    ...current.references,
+                    active: rollbackId,
+                    pending: null,
+                    approved: rollbackId,
+                    rollback: current.references.active,
+                    retention: unique([...current.references.retention, rollbackId, ...(current.references.active ? [current.references.active] : [])]),
+                },
+                activation: activation("idle", null),
+            };
+        });
+    }
+    async setRetention(releaseIds) {
+        return await this.update(current => {
+            for (const releaseId of releaseIds)
+                requiredRelease(current, releaseId);
+            return { ...current, references: { ...current.references, retention: unique(releaseIds) } };
+        });
+    }
+    async removeUnreferencedRelease(releaseId, externalReferences) {
+        return await this.update(current => {
+            requiredRelease(current, releaseId);
+            const protectedIds = new Set([
+                current.references.active,
+                current.references.pending,
+                current.references.approved,
+                current.references.rollback,
+                ...current.references.retention,
+                ...externalReferences,
+            ].filter((value) => value !== null));
+            if (protectedIds.has(releaseId))
+                throw new Error(`release ${releaseId} is still referenced and cannot be collected`);
+            const releases = { ...current.releases };
+            delete releases[releaseId];
+            return { ...current, releases };
+        });
+    }
+}
+export function emptyState() {
+    return {
+        schemaVersion: 1,
+        revision: 0,
+        releases: {},
+        references: { active: null, pending: null, approved: null, rollback: null, retention: [] },
+        activation: activation("idle", null),
+    };
+}
+function activation(state, reason) {
+    return { state, reason, blockerGenerationIds: [], updatedAt: new Date().toISOString() };
+}
+function requiredRelease(state, releaseId) {
+    const release = state.releases[releaseId];
+    if (!release)
+        throw new Error(`unknown release ${releaseId}`);
+    return release;
+}
+function unique(values) { return [...new Set(values)]; }
+async function acquireLock(path) {
+    const deadline = Date.now() + 5_000;
+    while (true) {
+        try {
+            return await open(path, "wx", 0o600);
+        }
+        catch (error) {
+            if (!(error instanceof Error && "code" in error && error.code === "EEXIST") || Date.now() >= deadline)
+                throw error;
+            await new Promise(resolvePromise => setTimeout(resolvePromise, 20));
+        }
+    }
+}
+function validateState(state) {
+    if (state.schemaVersion !== 1 || !Number.isSafeInteger(state.revision) || state.revision < 0)
+        throw new Error("invalid release cohort state");
+    for (const reference of [state.references.active, state.references.pending, state.references.approved, state.references.rollback]) {
+        if (reference !== null && !state.releases[reference])
+            throw new Error(`release reference points to an unknown release: ${reference}`);
+    }
+}
+function validateTransition(current, next) {
+    validateState(next);
+    if (next.schemaVersion !== current.schemaVersion)
+        throw new Error("release cohort schema cannot change during a state update");
+    if (next.revision !== current.revision)
+        throw new Error("release cohort revision is controlled by the state store");
+}
+//# sourceMappingURL=cohort-state.js.map

package/dist/src/foundation/release/cohort-state.js.map

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

package/dist/src/foundation/release/development-preview-release.d.ts

@@ -0,0 +1,49 @@
+export interface DevelopmentPreviewCandidate {
+    readonly version: string;
+    readonly requiresVersionCommit: boolean;
+}
+export interface DevelopmentPreviewRegistryState {
+    readonly published: boolean;
+    readonly nextVersion: string | null;
+}
+export interface DevelopmentPreviewVerificationOptions {
+    readonly attempts?: number;
+    readonly delayMs?: number;
+    readonly delay?: (milliseconds: number) => Promise<void>;
+}
+export interface DevelopmentPreviewPublishResult {
+    readonly published: boolean;
+    readonly recoveredPublishError: unknown | null;
+}
+export interface UncertifiedDevelopmentPreviewEvidenceInput {
+    readonly packageName: string;
+    readonly version: string;
+    readonly commit: string;
+    readonly tarball: string;
+    readonly integrity: string;
+    readonly shasum: string;
+    readonly platform: NodeJS.Platform;
+    readonly architecture: string;
+    readonly recordedAt: string;
+}
+export interface UncertifiedDevelopmentPreviewEvidence extends UncertifiedDevelopmentPreviewEvidenceInput {
+    readonly schema: "addone-development-preview-certification-v2";
+    readonly channel: "next";
+    readonly certificationStatus: "uncertified-development-preview";
+    readonly terminalCapability: "owned-ui";
+    readonly manualAcceptance: "accepted";
+    readonly physicalHostCertification: "deferred";
+    readonly crossPlatformCertification: "deferred";
+    readonly stableReleaseEligible: false;
+}
+export declare function createUncertifiedDevelopmentPreviewEvidence(input: UncertifiedDevelopmentPreviewEvidenceInput): UncertifiedDevelopmentPreviewEvidence;
+export declare function requireManuallyAcceptedDevelopmentPreview(version: string, acceptedVersion: string): void;
+export declare function selectDevelopmentPreviewCandidate(currentVersion: string, publishedVersions: readonly string[]): DevelopmentPreviewCandidate;
+/**
+ * Treats npm's process result as provisional: browser-auth completion can fail
+ * after the immutable upload succeeds. Registry identity remains authoritative.
+ */
+export declare function publishDevelopmentPreviewWithRecovery(publish: () => Promise<void>, verify: () => Promise<void>): Promise<DevelopmentPreviewPublishResult>;
+export declare function verifyDevelopmentPreviewRegistry(version: string, observe: () => Promise<DevelopmentPreviewRegistryState>, repairNextTag: () => Promise<void>, options?: DevelopmentPreviewVerificationOptions): Promise<void>;
+export declare function developmentPreviewTarballName(packageName: string, version: string): string;
+//# sourceMappingURL=development-preview-release.d.ts.map

package/dist/src/foundation/release/development-preview-release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-preview-release.d.ts","sourceRoot":"","sources":["../../../../src/foundation/release/development-preview-release.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qCAAsC,SAAQ,0CAA0C;IACvG,QAAQ,CAAC,MAAM,EAAE,6CAA6C,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,iCAAiC,CAAC;IAChE,QAAQ,CAAC,kBAAkB,EAAE,UAAU,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;IACtC,QAAQ,CAAC,yBAAyB,EAAE,UAAU,CAAC;IAC/C,QAAQ,CAAC,0BAA0B,EAAE,UAAU,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,KAAK,CAAC;CACvC;AAED,wBAAgB,2CAA2C,CACzD,KAAK,EAAE,0CAA0C,GAChD,qCAAqC,CAgBvC;AAED,wBAAgB,yCAAyC,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAQxG;AAED,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,2BAA2B,CA8B7B;AAED;;;GAGG;AACH,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC5B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC1B,OAAO,CAAC,+BAA+B,CAAC,CAW1C;AAED,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,OAAO,CAAC,+BAA+B,CAAC,EACvD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAClC,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK1F"}

package/dist/src/foundation/release/development-preview-release.js

@@ -0,0 +1,113 @@
+import { compare, inc, prerelease, valid } from "semver";
+export function createUncertifiedDevelopmentPreviewEvidence(input) {
+    const prereleaseParts = prerelease(input.version);
+    if (valid(input.version) === null || prereleaseParts?.[0] !== "dev") {
+        throw new Error(`uncertified preview requires a development prerelease: ${input.version}`);
+    }
+    return {
+        schema: "addone-development-preview-certification-v2",
+        channel: "next",
+        certificationStatus: "uncertified-development-preview",
+        terminalCapability: "owned-ui",
+        manualAcceptance: "accepted",
+        physicalHostCertification: "deferred",
+        crossPlatformCertification: "deferred",
+        stableReleaseEligible: false,
+        ...input,
+    };
+}
+export function requireManuallyAcceptedDevelopmentPreview(version, acceptedVersion) {
+    const acceptedPrerelease = prerelease(acceptedVersion);
+    if (valid(acceptedVersion) === null || acceptedPrerelease?.[0] !== "dev") {
+        throw new Error(`invalid manually accepted development preview: ${acceptedVersion}`);
+    }
+    if (version !== acceptedVersion) {
+        throw new Error(`development preview ${version} has no exact manual acceptance; accepted version is ${acceptedVersion}`);
+    }
+}
+export function selectDevelopmentPreviewCandidate(currentVersion, publishedVersions) {
+    if (valid(currentVersion) === null)
+        throw new Error(`invalid current package version: ${currentVersion}`);
+    const published = publishedVersions.map(version => {
+        if (valid(version) === null)
+            throw new Error(`invalid published package version: ${version}`);
+        return version;
+    });
+    const publishedSet = new Set(published);
+    const highestPublished = published.reduce((highest, version) => highest === null || compare(version, highest) > 0 ? version : highest, null);
+    const currentPrerelease = prerelease(currentVersion);
+    const currentIsUnpublishedLeadingDev = currentPrerelease?.[0] === "dev"
+        && !publishedSet.has(currentVersion)
+        && (highestPublished === null || compare(currentVersion, highestPublished) > 0);
+    if (currentIsUnpublishedLeadingDev)
+        return { version: currentVersion, requiresVersionCommit: false };
+    const base = highestPublished === null || compare(currentVersion, highestPublished) > 0
+        ? currentVersion
+        : highestPublished;
+    const basePrerelease = prerelease(base);
+    let candidate = basePrerelease?.[0] === "dev"
+        ? inc(base, "prerelease", "dev")
+        : inc(base, "prepatch", "dev");
+    if (candidate === null)
+        throw new Error(`could not increment development preview from ${base}`);
+    while (publishedSet.has(candidate)) {
+        candidate = inc(candidate, "prerelease", "dev");
+        if (candidate === null)
+            throw new Error(`could not increment development preview from ${base}`);
+    }
+    return { version: candidate, requiresVersionCommit: candidate !== currentVersion };
+}
+/**
+ * Treats npm's process result as provisional: browser-auth completion can fail
+ * after the immutable upload succeeds. Registry identity remains authoritative.
+ */
+export async function publishDevelopmentPreviewWithRecovery(publish, verify) {
+    let publishError = null;
+    try {
+        await publish();
+    }
+    catch (error) {
+        publishError = error;
+    }
+    try {
+        await verify();
+        return { published: true, recoveredPublishError: publishError };
+    }
+    catch (verificationError) {
+        if (publishError !== null)
+            throw new AggregateError([publishError, verificationError], "npm publish failed and the exact version could not be verified in the registry");
+        throw verificationError;
+    }
+}
+export async function verifyDevelopmentPreviewRegistry(version, observe, repairNextTag, options = {}) {
+    const attempts = options.attempts ?? 12;
+    const delayMs = options.delayMs ?? 2_000;
+    const delay = options.delay ?? (async (milliseconds) => await new Promise(resolvePromise => setTimeout(resolvePromise, milliseconds)));
+    if (!Number.isInteger(attempts) || attempts < 1)
+        throw new Error(`invalid registry verification attempts: ${attempts}`);
+    let repaired = false;
+    let last = { published: false, nextVersion: null };
+    for (let attempt = 1; attempt <= attempts; attempt += 1) {
+        last = await observe();
+        if (last.published && last.nextVersion === version)
+            return;
+        if (last.published && !repaired) {
+            await repairNextTag();
+            repaired = true;
+        }
+        if (attempt < attempts)
+            await delay(delayMs);
+    }
+    if (!last.published)
+        throw new Error(`npm registry did not expose published version ${version} after ${attempts} attempts`);
+    throw new Error(`npm next resolved ${last.nextVersion ?? "nothing"}; expected ${version} after ${attempts} attempts`);
+}
+export function developmentPreviewTarballName(packageName, version) {
+    if (valid(version) === null)
+        throw new Error(`invalid development preview version: ${version}`);
+    const unscopedName = packageName.startsWith("@") ? packageName.slice(1).replace("/", "-") : packageName;
+    if (!/^[a-z0-9._-]+$/i.test(unscopedName))
+        throw new Error(`invalid package name: ${packageName}`);
+    return `${unscopedName}-${version}.tgz`;
+}
+//# sourceMappingURL=development-preview-release.js.map

package/dist/src/foundation/release/development-preview-release.js.map

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

package/dist/src/foundation/release/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./bootstrap.js";
+export * from "./cohort-selection.js";
+export * from "./cohort-state.js";
+export * from "./development-preview-release.js";
+export * from "./process-cleanup.js";
+export * from "./release.js";
+export * from "./release-gc.js";
+export * from "./release-store.js";
+export * from "./stable-release.js";
+export * from "./update.js";
+export * from "./update-transaction.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/release/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/release/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}

package/dist/src/foundation/release/index.js

@@ -0,0 +1,12 @@
+export * from "./bootstrap.js";
+export * from "./cohort-selection.js";
+export * from "./cohort-state.js";
+export * from "./development-preview-release.js";
+export * from "./process-cleanup.js";
+export * from "./release.js";
+export * from "./release-gc.js";
+export * from "./release-store.js";
+export * from "./stable-release.js";
+export * from "./update.js";
+export * from "./update-transaction.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/release/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/release/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}

package/dist/src/foundation/release/process-cleanup.d.ts

@@ -0,0 +1,15 @@
+import type { SupervisorEndpointMetadata } from "./cohort-state.js";
+export interface CleanupDiagnostics {
+    readonly pid: number;
+    readonly attempted: readonly string[];
+    readonly terminated: boolean;
+    readonly elapsedMs: number;
+}
+export declare function processIsAlive(pid: number): boolean;
+export declare function cleanupProvenIdleOwner(metadata: SupervisorEndpointMetadata, graceMs?: number): Promise<CleanupDiagnostics>;
+export declare function cleanupVerifiedOwner(metadata: SupervisorEndpointMetadata, options?: {
+    readonly graceMs?: number;
+    readonly allowLiveGenerations?: boolean;
+    readonly reason?: "stale-idle-owner" | "explicit-update" | "legacy-mutable-install";
+}): Promise<CleanupDiagnostics>;
+//# sourceMappingURL=process-cleanup.d.ts.map

package/dist/src/foundation/release/process-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-cleanup.d.ts","sourceRoot":"","sources":["../../../../src/foundation/release/process-cleanup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,0BAA0B,EAAE,OAAO,SAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE/H;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,0BAA0B,EACpC,OAAO,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,wBAAwB,CAAA;CAAO,GACxK,OAAO,CAAC,kBAAkB,CAAC,CAiB7B"}

package/dist/src/foundation/release/process-cleanup.js

@@ -0,0 +1,67 @@
+import { spawn } from "node:child_process";
+export function processIsAlive(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error instanceof Error && "code" in error && error.code === "EPERM";
+    }
+}
+export async function cleanupProvenIdleOwner(metadata, graceMs = 1_500) {
+    return await cleanupVerifiedOwner(metadata, { graceMs, allowLiveGenerations: false });
+}
+export async function cleanupVerifiedOwner(metadata, options = {}) {
+    const graceMs = options.graceMs ?? 1_500;
+    if (!options.allowLiveGenerations && (metadata.ownership.liveGenerationIds.length > 0 || metadata.ownership.nonResumableGenerationIds.length > 0)) {
+        throw new Error("refusing to terminate an owner with recorded live generations");
+    }
+    const started = Date.now();
+    const attempted = [];
+    if (!processIsAlive(metadata.pid))
+        return { pid: metadata.pid, attempted: ["owner-already-dead"], terminated: true, elapsedMs: Date.now() - started };
+    attempted.push("graceful-termination");
+    await terminate(metadata.pid, false);
+    if (await waitUntilDead(metadata.pid, graceMs))
+        return { pid: metadata.pid, attempted, terminated: true, elapsedMs: Date.now() - started };
+    attempted.push("forced-process-tree-termination");
+    await terminate(metadata.pid, true);
+    const terminated = await waitUntilDead(metadata.pid, graceMs);
+    return { pid: metadata.pid, attempted, terminated, elapsedMs: Date.now() - started };
+}
+async function terminate(pid, force) {
+    if (process.platform === "win32") {
+        await new Promise(resolvePromise => {
+            const child = spawn("taskkill.exe", ["/PID", String(pid), "/T", ...(force ? ["/F"] : [])], {
+                shell: false,
+                windowsHide: true,
+                stdio: "ignore",
+            });
+            child.once("error", () => resolvePromise());
+            child.once("close", () => resolvePromise());
+        });
+        return;
+    }
+    const signal = force ? "SIGKILL" : "SIGTERM";
+    try {
+        process.kill(-pid, signal);
+    }
+    catch {
+        try {
+            process.kill(pid, signal);
+        }
+        catch { }
+    }
+}
+async function waitUntilDead(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!processIsAlive(pid))
+            return true;
+        await new Promise(resolvePromise => setTimeout(resolvePromise, 25));
+    }
+    return !processIsAlive(pid);
+}
+//# sourceMappingURL=process-cleanup.js.map

package/dist/src/foundation/release/process-cleanup.js.map

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

package/dist/src/foundation/release/release-gc.d.ts

@@ -0,0 +1,6 @@
+import { CohortStateStore } from "./cohort-state.js";
+/** Remove only a release that has no active, pending, approval, rollback,
+ * retention, process, agent, or migration reference. State is detached first;
+ * a filesystem failure can leave a safe orphan but never a dangling selector. */
+export declare function collectRelease(store: CohortStateStore, dataDir: string, releaseId: string, externalReferences: readonly string[]): Promise<void>;
+//# sourceMappingURL=release-gc.d.ts.map

package/dist/src/foundation/release/release-gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-gc.d.ts","sourceRoot":"","sources":["../../../../src/foundation/release/release-gc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;iFAEiF;AACjF,wBAAsB,cAAc,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,SAAS,MAAM,EAAE,GACpC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/src/foundation/release/release-gc.js

@@ -0,0 +1,17 @@
+import { rm } from "node:fs/promises";
+import { resolve } from "node:path";
+import { CohortStateStore } from "./cohort-state.js";
+import { verifyMaterializedRelease } from "./release-store.js";
+/** Remove only a release that has no active, pending, approval, rollback,
+ * retention, process, agent, or migration reference. State is detached first;
+ * a filesystem failure can leave a safe orphan but never a dangling selector. */
+export async function collectRelease(store, dataDir, releaseId, externalReferences) {
+    const state = await store.read();
+    const release = state.releases[releaseId];
+    if (!release)
+        throw new Error(`unknown release ${releaseId}`);
+    await verifyMaterializedRelease(release.releaseRoot, undefined, resolve(dataDir, "releases"));
+    await store.removeUnreferencedRelease(releaseId, externalReferences);
+    await rm(release.releaseRoot, { recursive: true, force: false });
+}
+//# sourceMappingURL=release-gc.js.map

package/dist/src/foundation/release/release-gc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-gc.js","sourceRoot":"","sources":["../../../../src/foundation/release/release-gc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;iFAEiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAuB,EACvB,OAAe,EACf,SAAiB,EACjB,kBAAqC;IAErC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;IAC9D,MAAM,yBAAyB,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9F,MAAM,KAAK,CAAC,yBAAyB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACrE,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC"}