@openge/forge-release-vercel 0.1.0-rc.1 → 0.1.0

package/dist/node/git-stream.d.ts

@@ -0,0 +1,5 @@
+import type { Execution } from './execution.js';
+/** Git 的 NUL 协议不得经过 trim、行拆分或有损 UTF-8 解码。 */
+export declare function gitRecords(execution: Execution, args: readonly string[], consume: (value: string) => void): Promise<void>;
+export declare function gitBlob(execution: Execution, object: string, maxBytes?: number): Promise<Buffer>;
+//# sourceMappingURL=git-stream.d.ts.map

package/dist/node/git-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-stream.d.ts","sourceRoot":"","sources":["../../src/node/git-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,6CAA6C;AAC7C,wBAAsB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/H;AACD,wBAAsB,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzG"}

package/dist/node/git-stream.js

@@ -0,0 +1,41 @@
+import { ReleaseError } from './errors.js';
+/** Git 的 NUL 协议不得经过 trim、行拆分或有损 UTF-8 解码。 */
+export async function gitRecords(execution, args, consume) {
+    const decoder = new TextDecoder('utf-8', { fatal: true });
+    let pending = '', count = 0;
+    try {
+        await execution.streamGit(args, chunk => {
+            pending += decoder.decode(chunk, { stream: true });
+            let end;
+            while ((end = pending.indexOf('\0')) !== -1) {
+                const value = pending.slice(0, end);
+                pending = pending.slice(end + 1);
+                if (++count > 500_000 || Buffer.byteLength(value) > 65_536)
+                    throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'TREE_LIMIT' });
+                consume(value);
+            }
+            if (Buffer.byteLength(pending) > 65_536)
+                throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'TREE_RECORD_LIMIT' });
+        });
+        pending += decoder.decode();
+        if (pending !== '')
+            throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'INCOMPLETE_GIT_RECORD' });
+    }
+    catch (error) {
+        if (error instanceof TypeError)
+            throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'INVALID_UTF8' });
+        throw error;
+    }
+}
+export async function gitBlob(execution, object, maxBytes = 1_048_576) {
+    const chunks = [];
+    let bytes = 0;
+    await execution.streamGit(['cat-file', 'blob', object], chunk => {
+        bytes += chunk.byteLength;
+        if (bytes > maxBytes)
+            throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'BLOB_LIMIT' });
+        chunks.push(Buffer.from(chunk));
+    });
+    return Buffer.concat(chunks);
+}
+//# sourceMappingURL=git-stream.js.map

package/dist/node/git-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-stream.js","sourceRoot":"","sources":["../../src/node/git-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,6CAA6C;AAC7C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAoB,EAAE,IAAuB,EAAE,OAAgC;IAC9G,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,OAAO,GAAG,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;YACtC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,IAAI,GAAW,CAAC;YAChB,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACtE,IAAI,EAAE,KAAK,GAAG,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM;oBAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;gBACnI,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YACD,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM;gBAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACzH,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,EAAE;YAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;IACxG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS;YAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QACzG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,SAAoB,EAAE,MAAc,EAAE,QAAQ,GAAG,SAAS;IACtF,MAAM,MAAM,GAAa,EAAE,CAAC;IAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IAC3C,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE;QAC9D,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;QAC1B,IAAI,KAAK,GAAG,QAAQ;YAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAC7F,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/node/git.js

@@ -39,7 +39,7 @@ export async function assertCandidate(execution, config, sha) {
     const head = await execution.git(['rev-parse', 'HEAD']);
     const dirty = await execution.git(['status', '--porcelain=v1', '--untracked-files=all']);
     if (sha !== undefined && (head !== sha || dirty !== ''))
-        throw new ReleaseError('CANDIDATE_CHANGED');
+        throw new ReleaseError('CANDIDATE_CHANGED', { reason: head !== sha ? 'HEAD_CHANGED' : 'WORKTREE_CHANGED', head, dirty });
     if (dirty !== '')
         throw new ReleaseError('GIT_DIRTY');
     return head;

package/dist/node/git.js.map

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

package/dist/node/lock.d.ts

@@ -2,5 +2,11 @@ export interface OwnedLock {
     assertOwned(): Promise<void>;
     release(): Promise<void>;
 }
-export declare function acquireLock(path: string): Promise<OwnedLock>;
+export declare function acquireLock(path: string, metadata?: {
+    readonly runId: string;
+    readonly identity: {
+        readonly pid: number;
+        readonly startToken: string;
+    };
+}): Promise<OwnedLock>;
 //# sourceMappingURL=lock.d.ts.map

package/dist/node/lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/node/lock.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AACD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAgBlE"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/node/lock.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AACD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAgBnL"}

package/dist/node/lock.js

@@ -2,9 +2,9 @@ import { randomUUID } from 'node:crypto';
 import { mkdir, open, readFile, unlink } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { ReleaseError } from './errors.js';
-export async function acquireLock(path) {
+export async function acquireLock(path, metadata) {
     await mkdir(dirname(path), { recursive: true });
-    const owner = JSON.stringify({ pid: process.pid, token: randomUUID(), startedAt: new Date().toISOString() });
+    const owner = JSON.stringify({ pid: process.pid, token: randomUUID(), startedAt: new Date().toISOString(), ...metadata });
     let handle;
     try {
         handle = await open(path, 'wx');

package/dist/node/lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/node/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7G,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;IACxC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACjI,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAC9C,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;IACxE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;QAC7B,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,KAAK;YAAE,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC;IACF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/node/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,QAA+G;IAC7J,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAC1H,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;IACxC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACjI,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAC9C,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;IACxE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;QAC7B,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,KAAK;YAAE,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC;IACF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5F,CAAC"}

package/dist/node/managed-budget.d.ts

@@ -0,0 +1,28 @@
+import type { ManagedSourceConfig, ReleaseBudget } from '../contracts.js';
+import type { ManagedPaths } from './release-context.js';
+import { measureManagedUsageOnce } from './managed-io.js';
+export interface BudgetObservation {
+    readonly bytes: number;
+    readonly freeBytes: number;
+    readonly observedAt: number;
+}
+export declare function observeBudget(paths: ManagedPaths, config: ManagedSourceConfig, scan?: typeof measureManagedUsageOnce): Promise<BudgetObservation>;
+export declare class BudgetMonitor {
+    readonly paths: ManagedPaths;
+    readonly config: ManagedSourceConfig;
+    private readonly observe;
+    private count;
+    private maxBytes;
+    private minFree;
+    private maxGap;
+    private lastObserved;
+    private complete;
+    private running;
+    private sampling;
+    constructor(paths: ManagedPaths, config: ManagedSourceConfig, observe?: typeof observeBudget);
+    sample(): Promise<void>;
+    private sampleNow;
+    run<T>(operation: (signal: AbortSignal) => Promise<T>, signal?: AbortSignal): Promise<T>;
+    summary(): ReleaseBudget;
+}
+//# sourceMappingURL=managed-budget.d.ts.map

package/dist/node/managed-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-budget.d.ts","sourceRoot":"","sources":["../../src/node/managed-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAuB,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,MAAM,WAAW,iBAAiB;IAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACtH,wBAAsB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,iCAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAahJ;AACD,qBAAa,aAAa;IASZ,QAAQ,CAAC,KAAK,EAAE,YAAY;IAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAqB;gBAChB,KAAK,EAAE,YAAY,EAAW,MAAM,EAAE,mBAAmB,EAC3D,OAAO,GAAE,OAAO,aAA6B;IAC1D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAKf,SAAS;IASjB,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA2B9F,OAAO,IAAI,aAAa;CAEzB"}

package/dist/node/managed-budget.js

@@ -0,0 +1,131 @@
+import { ReleaseError } from './errors.js';
+import { measureManagedUsage, measureManagedUsageOnce } from './managed-io.js';
+import { assertManagedPaths } from './managed-paths.js';
+export async function observeBudget(paths, config, scan = measureManagedUsageOnce) {
+    const controller = new AbortController();
+    let timer;
+    const deadline = new Promise((_accept, reject) => {
+        timer = setTimeout(() => { controller.abort(); reject(new ReleaseError('BUDGET_UNKNOWN', { reason: 'OBSERVATION_DEADLINE' })); }, 30_000 + config.sampleIntervalMs);
+    });
+    const observation = async () => {
+        await assertManagedPaths(paths);
+        const value = await measureManagedUsage(paths, controller.signal, scan);
+        return { ...value, observedAt: Date.now() };
+    };
+    try {
+        return await Promise.race([observation(), deadline]);
+    }
+    catch (error) {
+        if (error instanceof ReleaseError)
+            throw error;
+        throw new ReleaseError('BUDGET_UNKNOWN', { reason: 'OBSERVATION_FAILED' });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export class BudgetMonitor {
+    paths;
+    config;
+    observe;
+    count = 0;
+    maxBytes = 0;
+    minFree = Number.MAX_SAFE_INTEGER;
+    maxGap = 0;
+    lastObserved;
+    complete = true;
+    running = false;
+    sampling = Promise.resolve();
+    constructor(paths, config, observe = observeBudget) {
+        this.paths = paths;
+        this.config = config;
+        this.observe = observe;
+    }
+    async sample() {
+        const observation = this.sampling.then(() => this.sampleNow());
+        this.sampling = observation.catch(() => { });
+        return observation;
+    }
+    async sampleNow() {
+        let observation;
+        try {
+            observation = await this.observe(this.paths, this.config);
+        }
+        catch (error) {
+            this.complete = false;
+            if (error instanceof ReleaseError)
+                throw error;
+            throw new ReleaseError('BUDGET_UNKNOWN', { reason: 'OBSERVATION_FAILED' });
+        }
+        this.count++;
+        this.maxBytes = Math.max(this.maxBytes, observation.bytes);
+        this.minFree = Math.min(this.minFree, observation.freeBytes);
+        if (this.lastObserved !== undefined)
+            this.maxGap = Math.max(this.maxGap, observation.observedAt - this.lastObserved);
+        this.lastObserved = observation.observedAt;
+        if (observation.bytes > this.config.maxBytes || observation.freeBytes < this.config.minFreeBytes)
+            throw new ReleaseError('BUDGET_EXCEEDED', { bytes: observation.bytes, freeBytes: observation.freeBytes });
+    }
+    async run(operation, signal) {
+        if (this.running)
+            throw new ReleaseError('BUDGET_UNKNOWN', { reason: 'OVERLAPPING_OPERATION' });
+        this.running = true;
+        const controller = new AbortController();
+        const combined = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
+        let stopped = false, failure, wake, timer;
+        let loop;
+        try {
+            await this.sample();
+            loop = (async () => {
+                while (!stopped) {
+                    await new Promise(accept => { wake = accept; timer = setTimeout(accept, this.config.sampleIntervalMs); });
+                    if (stopped)
+                        break;
+                    try {
+                        await this.sample();
+                    }
+                    catch (error) {
+                        failure = error;
+                        controller.abort();
+                        break;
+                    }
+                }
+            })();
+            let result, operationFailed = false, operationError;
+            try {
+                result = await operation(combined);
+            }
+            catch (error) {
+                operationFailed = true;
+                operationError = error;
+            }
+            stopped = true;
+            clearTimeout(timer);
+            wake?.();
+            await loop;
+            try {
+                await this.sample();
+            }
+            catch (error) {
+                failure ??= error;
+            }
+            if (failure !== undefined)
+                throw failure;
+            if (operationFailed)
+                throw operationError;
+            return result;
+        }
+        finally {
+            stopped = true;
+            clearTimeout(timer);
+            wake?.();
+            await loop;
+            this.running = false;
+        }
+    }
+    summary() {
+        return { sampleCount: this.count, maxObservedBytes: this.maxBytes, minObservedFreeBytes: this.count ? this.minFree : 0,
+            maxObservationGapMs: this.maxGap, observationsComplete: this.complete && this.count > 0 };
+    }
+}
+//# sourceMappingURL=managed-budget.js.map

package/dist/node/managed-budget.js.map

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

package/dist/node/managed-checkout.d.ts

@@ -0,0 +1,5 @@
+import type { ManagedSession } from './release-context.js';
+export declare function assertCheckoutFrozen(session: ManagedSession): Promise<void>;
+export declare function prepareCheckout(session: ManagedSession): Promise<void>;
+export declare function prepareEnvironment(session: ManagedSession): Promise<void>;
+//# sourceMappingURL=managed-checkout.d.ts.map

package/dist/node/managed-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-checkout.d.ts","sourceRoot":"","sources":["../../src/node/managed-checkout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAS3D,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF;AACD,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B5E;AACD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/E"}

package/dist/node/managed-checkout.js

@@ -0,0 +1,104 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { Execution } from './execution.js';
+import { assertCandidate, assertRepository } from './git.js';
+import { assertSourceFrozen, readCommittedConfig } from './source.js';
+import { assertManagedPaths } from './managed-paths.js';
+import { gitBlob } from './git-stream.js';
+import { pathExists } from './managed-io.js';
+import { record, ReleaseError } from './errors.js';
+export async function assertCheckoutFrozen(session) {
+    const { slot, execution } = session;
+    await assertManagedPaths(slot.paths);
+    await slot.lock.assertOwned();
+    await assertRepository(execution, slot.source.config);
+    await assertCandidate(execution, slot.source.config, slot.source.sha);
+    const committed = await readCommittedConfig(execution, slot.source.sha, slot.source.configPath);
+    if (committed.oid !== slot.source.configBlobOid || !(await readFile(resolve(slot.paths.checkoutRoot, slot.source.configPath))).equals(committed.bytes))
+        throw new ReleaseError('CANDIDATE_CHANGED', { reason: 'CHECKOUT_CONFIG' });
+}
+export async function prepareCheckout(session) {
+    const { slot, execution } = session, { source, paths } = slot;
+    const original = new Execution(source.root, source.config, undefined, []);
+    session.state.stage = 'checkout';
+    await session.persist();
+    await assertSourceFrozen(source, original);
+    await assertManagedPaths(paths);
+    const exists = await pathExists(paths.checkoutRoot);
+    if (!exists) {
+        // 仅为本次 clone 和新建 checkout 启用长路径，不修改源仓库或宿主 Git 配置。
+        await session.executionAt(paths.slotRoot).git(['-c', 'core.longpaths=true', 'clone', '--no-checkout', '--no-local', '--template=', '--config', 'core.autocrlf=false', '--config', 'core.eol=lf', '--config', 'core.longpaths=true', '--origin', source.config.git.remote, '--', source.fetchUrl, paths.checkoutRoot]);
+    }
+    else {
+        await assertRepository(execution, source.config);
+        await assertCandidate(execution, source.config);
+    }
+    await assertManagedPaths(paths);
+    await assertSourceFrozen(source, original);
+    await assertRepository(execution, source.config);
+    await execution.git(['fetch', '--no-tags', '--no-recurse-submodules', '--', source.root, source.sha]);
+    await assertSourceFrozen(source, original);
+    if (!exists) {
+        let branchExists = false;
+        try {
+            await execution.git(['show-ref', '--verify', '--quiet', `refs/heads/${source.config.git.developmentBranch}`]);
+            branchExists = true;
+        }
+        catch (error) {
+            if (!(error instanceof ReleaseError && error.code === 'GIT_FAILED' && error.details.exitCode === 1))
+                throw error;
+        }
+        if (branchExists) {
+            // 新 clone 的默认分支可能已是开发分支；正常检出后仅允许快进，不重置已有引用。
+            await execution.git(['switch', '--detach', source.sha]);
+            await execution.git(['switch', source.config.git.developmentBranch]);
+            await execution.git(['merge', '--ff-only', source.sha]);
+        }
+        else
+            await execution.git(['switch', '--create', source.config.git.developmentBranch, source.sha]);
+    }
+    else if (await execution.git(['rev-parse', 'HEAD']) !== source.sha) {
+        try {
+            await execution.git(['merge-base', '--is-ancestor', 'HEAD', source.sha]);
+        }
+        catch (error) {
+            if (error instanceof ReleaseError && error.details.exitCode === 1)
+                throw new ReleaseError('SLOT_NOT_FAST_FORWARD');
+            throw error;
+        }
+        await execution.git(['merge', '--ff-only', source.sha]);
+    }
+    await assertCheckoutFrozen(session);
+}
+export async function prepareEnvironment(session) {
+    const { slot, execution } = session, { source } = slot;
+    session.state.stage = 'install';
+    await session.persist();
+    const manifestOid = await execution.git(['rev-parse', '--verify', `${source.sha}:package.json`]);
+    const manifestBytes = await gitBlob(execution, manifestOid);
+    let manifest;
+    try {
+        manifest = record(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(manifestBytes)));
+    }
+    catch {
+        throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'PACKAGE_MANIFEST' });
+    }
+    const match = typeof manifest.packageManager === 'string' ? /^pnpm@(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)(?:\+sha(?:224|256|384|512)\.[a-f0-9]+)?$/u.exec(manifest.packageManager) : null;
+    if (!match)
+        throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'EXACT_PNPM_REQUIRED' });
+    await execution.git(['rev-parse', '--verify', `${source.sha}:pnpm-lock.yaml`]);
+    const values = { COREPACK_ENABLE_PROJECT_SPEC: '0', npm_config_manage_package_manager_versions: 'false' };
+    const version = await execution.run('package-manager-version', { command: 'pnpm', args: ['--version'] }, 'COMMAND_FAILED', values);
+    if (version !== match[1])
+        throw new ReleaseError('SOURCE_UNSUPPORTED', { reason: 'PNPM_VERSION', expected: match[1], actual: version });
+    await execution.run('install', { command: 'pnpm', args: ['install', '--frozen-lockfile'] }, 'COMMAND_FAILED', values);
+    await assertCheckoutFrozen(session);
+    if (source.config.source.mode !== 'managed-commit')
+        throw new ReleaseError('SOURCE_UNSUPPORTED');
+    session.state.stage = 'prepare';
+    await session.persist();
+    for (const [index, check] of source.config.source.prepare.entries())
+        await execution.run(`prepare:${String(index)}`, check, 'COMMAND_FAILED');
+    await assertCheckoutFrozen(session);
+}
+//# sourceMappingURL=managed-checkout.js.map

package/dist/node/managed-checkout.js.map

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

package/dist/node/managed-closure.d.ts

@@ -0,0 +1,4 @@
+import type { ManagedCommand } from './release-context.js';
+/** 历史轮询见证保留可读；只有同一实例和绑定的 OS 关闭事实可以复用。 */
+export declare function hasVerifiedManagedClosure(command: ManagedCommand): boolean;
+//# sourceMappingURL=managed-closure.d.ts.map

package/dist/node/managed-closure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-closure.d.ts","sourceRoot":"","sources":["../../src/node/managed-closure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,yCAAyC;AACzC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAO1E"}

package/dist/node/managed-closure.js

@@ -0,0 +1,10 @@
+/** 历史轮询见证保留可读；只有同一实例和绑定的 OS 关闭事实可以复用。 */
+export function hasVerifiedManagedClosure(command) {
+    const closure = command.closure, owned = closure?.ownedScope;
+    return command.status === 'closed' && command.observationComplete && !!command.identity && !!command.scope && !!closure
+        && closure.termination === 'exit' && closure.exitCode !== null && Number.isSafeInteger(closure.exitCode)
+        && Number.isFinite(Date.parse(closure.observedAt)) && owned?.status === 'closed' && owned.reason === 'normal' && owned.empty === true
+        && owned.scopeId === command.scope.scopeId && owned.binding === command.scope.binding
+        && owned.rootIdentity.pid === command.identity.pid && owned.rootIdentity.startToken === command.identity.startToken;
+}
+//# sourceMappingURL=managed-closure.js.map

package/dist/node/managed-closure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-closure.js","sourceRoot":"","sources":["../../src/node/managed-closure.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,UAAU,yBAAyB,CAAC,OAAuB;IAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,EAAE,UAAU,CAAC;IAC7D,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO;WAClH,OAAO,CAAC,WAAW,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC;WACrG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,EAAE,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;WAClI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO;WAClF,KAAK,CAAC,YAAY,CAAC,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,YAAY,CAAC,UAAU,KAAK,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;AACxH,CAAC"}

package/dist/node/managed-io.d.ts

@@ -0,0 +1,23 @@
+import type { FileIdentity, ManagedPaths } from './release-context.js';
+export declare const within: (root: string, path: string) => boolean;
+export declare const fileIdentity: (path: string) => Promise<FileIdentity>;
+export declare const sameIdentity: (a: {
+    readonly dev?: unknown;
+    readonly ino?: unknown;
+}, b: {
+    readonly dev?: unknown;
+    readonly ino?: unknown;
+}) => boolean;
+export declare function pathExists(path: string): Promise<boolean>;
+export declare function assertPathChain(root: string, path: string): Promise<void>;
+export declare function readBoundedJson(path: string, maxBytes?: number): Promise<unknown>;
+export declare function measureManagedUsageOnce(paths: ManagedPaths, signal?: AbortSignal): Promise<{
+    bytes: number;
+    freeBytes: number;
+}>;
+export declare function measureManagedUsage(paths: ManagedPaths, signal?: AbortSignal, scan?: typeof measureManagedUsageOnce): Promise<{
+    bytes: number;
+    freeBytes: number;
+}>;
+export declare function atomicJson(path: string, value: unknown, maxBytes: number, paths: ManagedPaths, guard: () => Promise<void>, maxTotal: number, minFree: number): Promise<void>;
+//# sourceMappingURL=managed-io.d.ts.map

package/dist/node/managed-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-io.d.ts","sourceRoot":"","sources":["../../src/node/managed-io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGvE,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OAEnD,CAAC;AACF,eAAO,MAAM,YAAY,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,YAAY,CAAyH,CAAC;AAChM,eAAO,MAAM,YAAY,GAAI,GAAG;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,OAG3I,CAAC;AACF,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;AACD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/E;AACD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB1F;AACD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCtI;AACD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,iCAA0B,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAQlK;AACD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAclL"}