gate-evm-tools 1.0.27 → 1.0.31

package/dist-runtime/delivery/project.js

@@ -0,0 +1,157 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coreMarker = exports.readFile = exports.projectRoot = exports.confinedFile = exports.stat = void 0;
+exports.parseProjectConfig = parseProjectConfig;
+exports.projectSourcesDirectory = projectSourcesDirectory;
+exports.projectDefaultNetwork = projectDefaultNetwork;
+exports.readProjectNetworkSnapshots = readProjectNetworkSnapshots;
+exports.parseProjectNetworkSnapshots = parseProjectNetworkSnapshots;
+exports.integratedConfig = integratedConfig;
+const node_path_1 = __importDefault(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const protocol_1 = require("./protocol");
+const policy_1 = require("./policy");
+var project_files_1 = require("./project-files");
+Object.defineProperty(exports, "stat", { enumerable: true, get: function () { return project_files_1.stat; } });
+Object.defineProperty(exports, "confinedFile", { enumerable: true, get: function () { return project_files_1.confinedFile; } });
+Object.defineProperty(exports, "projectRoot", { enumerable: true, get: function () { return project_files_1.projectRoot; } });
+Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return project_files_1.readFile; } });
+Object.defineProperty(exports, "coreMarker", { enumerable: true, get: function () { return project_files_1.coreMarker; } });
+const project_files_2 = require("./project-files");
+function unwrap(node) {
+    while (typescript_1.default.isParenthesizedExpression(node) || typescript_1.default.isAsExpression(node) || typescript_1.default.isSatisfiesExpression(node))
+        node = node.expression;
+    return node;
+}
+function properties(node, label) {
+    node = unwrap(node);
+    if (!typescript_1.default.isObjectLiteralExpression(node))
+        throw new Error(`${label} must be a static object literal`);
+    const map = new Map();
+    for (const item of node.properties) {
+        if (!typescript_1.default.isPropertyAssignment(item) || (!typescript_1.default.isIdentifier(item.name) && !typescript_1.default.isStringLiteral(item.name)))
+            throw new Error(`${label} has unsupported computed or spread fields`);
+        const key = item.name.text;
+        if (['__proto__', 'constructor', 'prototype'].includes(key))
+            throw new Error(`Reserved prototype property in ${label}`);
+        if (map.has(key))
+            throw new Error(`Duplicate ${label} field: ${key}`);
+        map.set(key, unwrap(item.initializer));
+    }
+    return map;
+}
+function parseProjectConfig(source) {
+    const file = typescript_1.default.createSourceFile('hardhat.config.ts', source, typescript_1.default.ScriptTarget.Latest, true, typescript_1.default.ScriptKind.TS);
+    const diagnostics = file.parseDiagnostics;
+    if (diagnostics.length)
+        throw new Error('Invalid hardhat.config.ts syntax');
+    const exports = file.statements.filter(typescript_1.default.isExportAssignment);
+    if (exports.length !== 1 || exports[0].isExportEquals)
+        throw new Error('Config requires one default export');
+    let config = unwrap(exports[0].expression);
+    if (typescript_1.default.isIdentifier(config)) {
+        const name = config.text;
+        const declarations = file.statements.filter(typescript_1.default.isVariableStatement).flatMap(statement => [...statement.declarationList.declarations]
+            .map(declaration => ({ declaration, statement }))).filter(({ declaration }) => typescript_1.default.isIdentifier(declaration.name) && declaration.name.text === name);
+        if (declarations.length !== 1 || !(declarations[0].statement.declarationList.flags & typescript_1.default.NodeFlags.Const) || !declarations[0].declaration.initializer)
+            throw new Error('Config requires a static const object');
+        const declaration = declarations[0].declaration;
+        const references = [];
+        const visit = (node) => { if (typescript_1.default.isIdentifier(node) && node.text === name)
+            references.push(node); typescript_1.default.forEachChild(node, visit); };
+        visit(file);
+        if (references.some(node => node !== declaration.name && node !== config))
+            throw new Error('Ambiguous mutable config references');
+        config = unwrap(declaration.initializer);
+    }
+    const fields = properties(config, 'config');
+    const networkNode = fields.get('networks');
+    if (!networkNode)
+        throw new Error('Project config must declare networks');
+    return { file, networks: properties(networkNode, 'networks'), fields };
+}
+function projectSourcesDirectory(root) {
+    const { fields } = parseProjectConfig((0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '');
+    const paths = fields.get('paths');
+    const sources = paths && properties(paths, 'paths').get('sources');
+    if (sources && !typescript_1.default.isStringLiteral(sources))
+        throw new Error('Project paths.sources must be a static string for dependency inspection');
+    const sourcePath = sources && typescript_1.default.isStringLiteral(sources) ? sources.text : 'contracts';
+    const relative = node_path_1.default.relative(root, node_path_1.default.resolve(root, sourcePath)).split(node_path_1.default.sep).join('/');
+    return (0, project_files_2.confinedFile)(root, relative, 'directory');
+}
+function projectDefaultNetwork(root) {
+    const { fields } = parseProjectConfig((0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '');
+    const network = fields.get('defaultNetwork');
+    if (!network)
+        return 'hardhat';
+    if (!typescript_1.default.isStringLiteral(network))
+        throw new Error('Project defaultNetwork must be a static string for delivery routing');
+    return (0, policy_1.validateNetworkAlias)(network.text, 'defaultNetwork');
+}
+function rpcValue(node, env) {
+    node = unwrap(node);
+    if (typescript_1.default.isStringLiteral(node))
+        return node.text;
+    if (typescript_1.default.isPropertyAccessExpression(node) && typescript_1.default.isPropertyAccessExpression(node.expression)
+        && typescript_1.default.isIdentifier(node.expression.expression) && node.expression.expression.text === 'process'
+        && node.expression.name.text === 'env')
+        return env[node.name.text];
+    if (typescript_1.default.isElementAccessExpression(node) && typescript_1.default.isPropertyAccessExpression(node.expression)
+        && typescript_1.default.isIdentifier(node.expression.expression) && node.expression.expression.text === 'process'
+        && node.expression.name.text === 'env' && typescript_1.default.isStringLiteral(node.argumentExpression))
+        return env[node.argumentExpression.text];
+    if (typescript_1.default.isBinaryExpression(node) && [typescript_1.default.SyntaxKind.BarBarToken, typescript_1.default.SyntaxKind.QuestionQuestionToken].includes(node.operatorToken.kind)) {
+        const left = rpcValue(node.left, env);
+        return node.operatorToken.kind === typescript_1.default.SyntaxKind.QuestionQuestionToken
+            ? left ?? rpcValue(node.right, env) : left || rpcValue(node.right, env);
+    }
+    throw new Error('Selected network URL must be a literal or process.env reference');
+}
+/** Read the project-owned definitions without evaluating the config, plugins or HRE. */
+function readProjectNetworkSnapshots(root, aliases, env = process.env) {
+    return parseProjectNetworkSnapshots((0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '', aliases, env);
+}
+/** Parse one captured project definition without rereading files or evaluating plugins/HRE. */
+function parseProjectNetworkSnapshots(source, aliases, env = process.env) {
+    const { networks } = parseProjectConfig(source);
+    return aliases.map(network => {
+        (0, policy_1.validateNetworkAlias)(network, 'network', false);
+        const selected = networks.get(network);
+        if (!selected || network === 'hardhat')
+            throw new Error(`Selected project network is missing or not an RPC target: ${network}`);
+        const fields = properties(selected, `network ${network}`);
+        const chainId = fields.get('chainId');
+        if (!chainId || !typescript_1.default.isNumericLiteral(chainId))
+            throw new Error(`Selected network ${network} requires a static chainId`);
+        if (fields.has('zksync') && fields.get('zksync').kind !== typescript_1.default.SyntaxKind.FalseKeyword)
+            throw new Error('Delivery requires an EVM network');
+        const url = fields.get('url');
+        if (!url)
+            throw new Error(`Selected network ${network} requires an RPC URL definition`);
+        return { network, chainId: (0, protocol_1.positiveInteger)(Number(chainId.text), 'network chainId'), url: rpcValue(url, env) ?? '' };
+    });
+}
+function integratedConfig(source) {
+    const { file } = parseProjectConfig(source);
+    const imports = file.statements.filter(typescript_1.default.isImportDeclaration);
+    const delivery = imports.filter(node => typescript_1.default.isStringLiteral(node.moduleSpecifier) && node.moduleSpecifier.text === 'gate-evm-tools/delivery-hardhat');
+    if (delivery.length > 1 || delivery.some(node => node.importClause))
+        throw new Error('Conflicting manual delivery plugin import');
+    // Place bootstrap before all imports, after leading comments/shebang/directives.
+    const first = file.statements.find(node => !(typescript_1.default.isExpressionStatement(node) && typescript_1.default.isStringLiteral(node.expression)));
+    if (!first)
+        throw new Error('Missing project config statements');
+    if (delivery.length) {
+        if (delivery[0] !== first)
+            throw new Error('Delivery plugin must be the first import; move it before other imports');
+        return source;
+    }
+    const at = first.getStart(file);
+    const newline = source.includes('\r\n') ? '\r\n' : '\n';
+    return source.slice(0, at) + `import "gate-evm-tools/delivery-hardhat";${newline}` + source.slice(at);
+}
+//# sourceMappingURL=project.js.map

package/dist-runtime/delivery/project.js.map

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

package/dist-runtime/delivery/protocol.d.ts

@@ -0,0 +1,49 @@
+export type DeliveryEnvironment = 'dev' | 'prod';
+export type DeliveryMode = 'simulate' | 'execute' | 'export-calldata' | 'reconcile' | 'verify';
+export interface DeliveryRequest {
+    version: 1;
+    environment: DeliveryEnvironment;
+    purpose: 'dev-execution' | 'prod-qualification' | 'prod-execution';
+    mode: DeliveryMode;
+    network: string;
+    sourceRef: {
+        path: string;
+        taskId: string;
+        planKey: string;
+        rev: number;
+    };
+    releaseRef?: {
+        path: string;
+        releaseId: string;
+        inputsHash: string;
+    };
+    fork?: {
+        blockNumber: number;
+        blockHash: string;
+        readOnly: true;
+    };
+    devSigner?: string;
+    operator?: string;
+}
+export interface ProjectNetworkSnapshot {
+    network: string;
+    chainId: number;
+    url: string;
+}
+export declare function object(value: unknown, label: string, keys?: string[]): Record<string, unknown>;
+export declare function safeId(value: unknown, label: string): string;
+export declare function portablePath(value: unknown, label: string): string;
+export declare function address(value: unknown, label: string): string;
+export declare function positiveInteger(value: unknown, label: string): number;
+export declare function parseDeliveryRequest(input: unknown): DeliveryRequest;
+export interface ChainIdProvider {
+    request(args: {
+        method: 'eth_chainId';
+        params: [];
+    }): Promise<unknown>;
+}
+/** Does not load HRE, signers, verify source contents, or grant execution authority. */
+export declare function validateDeliveryRpc(input: unknown, snapshot: ProjectNetworkSnapshot, loadProvider: (snapshot: ProjectNetworkSnapshot) => Promise<ChainIdProvider>): Promise<{
+    request: DeliveryRequest;
+    chainId: number;
+}>;

package/dist-runtime/delivery/protocol.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.object = object;
+exports.safeId = safeId;
+exports.portablePath = portablePath;
+exports.address = address;
+exports.positiveInteger = positiveInteger;
+exports.parseDeliveryRequest = parseDeliveryRequest;
+exports.validateDeliveryRpc = validateDeliveryRpc;
+/** Syntax and routing constraints only. Source verification and host authorization are separate gates. */
+const policy_1 = require("./policy");
+function object(value, label, keys) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)
+        || ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
+        throw new Error(`${label} must be an object`);
+    const result = value;
+    if (keys && Object.keys(result).some(key => !keys.includes(key)))
+        throw new Error(`${label} has unknown fields`);
+    return result;
+}
+function safeId(value, label) {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9_-]{0,199}$/.test(value)
+        || ['__proto__', 'prototype', 'constructor'].includes(value))
+        throw new Error(`Invalid ${label}`);
+    return value;
+}
+function portablePath(value, label) {
+    if (typeof value !== 'string' || !value || /[\\\0:]/.test(value)
+        || value.split('/').some(part => !part || part === '.' || part === '..'
+            || ['__proto__', 'prototype', 'constructor'].includes(part)))
+        throw new Error(`Invalid relative ${label}`);
+    return value;
+}
+function address(value, label) {
+    if (typeof value !== 'string' || !/^0x[\da-fA-F]{40}$/.test(value) || /^0x0{40}$/.test(value))
+        throw new Error(`Invalid ${label} address`);
+    return value;
+}
+function positiveInteger(value, label) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value <= 0)
+        throw new Error(`Invalid ${label}`);
+    return value;
+}
+function parseDeliveryRequest(input) {
+    const value = object(input, 'delivery request', ['version', 'environment', 'purpose', 'mode', 'network', 'sourceRef', 'releaseRef', 'fork', 'devSigner', 'operator']);
+    if (value.version !== 1)
+        throw new Error('Unsupported delivery request version');
+    if (typeof value.environment !== 'string' || !['dev', 'prod'].includes(value.environment))
+        throw new Error('environment must be dev or prod');
+    if (typeof value.purpose !== 'string' || !['dev-execution', 'prod-qualification', 'prod-execution'].includes(value.purpose))
+        throw new Error('Invalid purpose');
+    const dev = value.purpose === 'dev-execution';
+    if (value.environment !== (dev ? 'dev' : 'prod'))
+        throw new Error('purpose conflicts with environment');
+    const modes = dev ? ['simulate', 'execute', 'reconcile', 'verify'] : value.purpose === 'prod-qualification' ? ['simulate', 'verify'] : ['simulate', 'execute', 'export-calldata', 'reconcile', 'verify'];
+    if (typeof value.mode !== 'string' || !modes.includes(value.mode))
+        throw new Error('Explicit valid mode is required for purpose');
+    (0, policy_1.validateNetworkAlias)(value.network, 'network', false);
+    const source = object(value.sourceRef, 'sourceRef', ['path', 'taskId', 'planKey', 'rev']);
+    portablePath(source.path, 'sourceRef.path');
+    safeId(source.taskId, 'taskId');
+    safeId(source.planKey, 'planKey');
+    positiveInteger(source.rev, 'rev');
+    if (dev) {
+        address(value.devSigner, 'devSigner');
+        if ('operator' in value)
+            throw new Error('devSigner and prod operator are separate roles');
+    }
+    else {
+        address(value.operator, 'operator');
+        if ('devSigner' in value)
+            throw new Error('prod operator cannot inherit devSigner');
+    }
+    if (value.purpose === 'prod-execution') {
+        const release = object(value.releaseRef, 'releaseRef', ['path', 'releaseId', 'inputsHash']);
+        portablePath(release.path, 'releaseRef.path');
+        safeId(release.releaseId, 'releaseId');
+        if (typeof release.inputsHash !== 'string' || !/^[a-f0-9]{64}$/.test(release.inputsHash))
+            throw new Error('Invalid releaseRef.inputsHash');
+    }
+    else if ('releaseRef' in value)
+        throw new Error('releaseRef requires prod-execution');
+    if (value.purpose === 'prod-qualification' && value.mode === 'simulate' && !value.fork)
+        throw new Error('prod-qualification simulate requires a pinned read-only fork');
+    if ('fork' in value) {
+        const fork = object(value.fork, 'fork', ['blockNumber', 'blockHash', 'readOnly']);
+        if (typeof fork.blockNumber !== 'number' || !Number.isSafeInteger(fork.blockNumber) || fork.blockNumber < 0)
+            throw new Error('Invalid fork.blockNumber');
+        if (fork.readOnly !== true || typeof fork.blockHash !== 'string' || !/^0x[\da-fA-F]{64}$/.test(fork.blockHash))
+            throw new Error('fork must pin a block hash and be readOnly');
+        if (value.mode !== 'simulate')
+            throw new Error('fork is only valid for simulate mode');
+    }
+    // Return detached data so callers cannot change routing during an asynchronous provider load.
+    return JSON.parse(JSON.stringify(value));
+}
+/** Does not load HRE, signers, verify source contents, or grant execution authority. */
+async function validateDeliveryRpc(input, snapshot, loadProvider) {
+    const request = parseDeliveryRequest(input);
+    if (snapshot.network !== request.network)
+        throw new Error('Selected project network snapshot mismatch');
+    const expected = positiveInteger(snapshot.chainId, 'snapshot.chainId');
+    const provider = await loadProvider({ ...snapshot });
+    const raw = await provider.request({ method: 'eth_chainId', params: [] });
+    if (typeof raw !== 'string' || !/^0x[\da-fA-F]+$/.test(raw))
+        throw new Error('Invalid RPC eth_chainId response');
+    const actual = BigInt(raw);
+    if (actual !== BigInt(expected))
+        throw new Error(`RPC chainId mismatch: expected ${expected}, actual ${actual}`);
+    return { request, chainId: expected };
+}
+//# sourceMappingURL=protocol.js.map

package/dist-runtime/delivery/protocol.js.map

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

package/dist-runtime/delivery/references.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFERRED: unique symbol;
+export interface ReferenceObservation {
+    reference: string;
+    contentIdentity: string;
+    resolvedIdentity: string;
+}
+export interface BusinessReferenceContext {
+    params: unknown;
+    target: unknown;
+    state(): unknown;
+}
+export declare function parseBusinessReference(raw: unknown): string | null;
+export declare function resolveBusinessValue(raw: unknown, context: BusinessReferenceContext, options?: {
+    deferState?: boolean;
+}): {
+    value: unknown;
+    observations: ReferenceObservation[];
+};
+export declare function containsDeferred(value: unknown): boolean;

package/dist-runtime/delivery/references.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFERRED = void 0;
+exports.parseBusinessReference = parseBusinessReference;
+exports.resolveBusinessValue = resolveBusinessValue;
+exports.containsDeferred = containsDeferred;
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+const data_1 = require("./data");
+const target_fields_1 = require("./target-fields");
+exports.DEFERRED = Symbol("delivery.future-state");
+const PUBLIC_TARGET = target_fields_1.PUBLIC_TARGET_FIELDS;
+function parseBusinessReference(raw) {
+    const value = (0, data_1.strictData)(raw);
+    let ref;
+    if (typeof value === "string" && value.startsWith("$"))
+        ref = value.slice(1);
+    else if (value &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        Object.hasOwn(value, "$ref")) {
+        if (Object.keys(value).length !== 1)
+            throw new Error("Business $ref requires exact shape");
+        ref = value.$ref;
+    }
+    else
+        return null;
+    if (typeof ref !== "string" ||
+        !/^(param|target|state)\.[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*$/.test(ref))
+        throw new Error("Invalid business reference namespace or path");
+    if (ref.startsWith("target.") && !PUBLIC_TARGET.has(ref.slice(7)))
+        throw new Error("Reference is outside public target boundary");
+    return ref;
+}
+function resolveBusinessValue(raw, context, options = {}) {
+    const params = (0, data_1.strictData)(context.params), input = (0, data_1.strictData)(raw), active = new Set();
+    const observations = [];
+    let state, stateRead = false;
+    const visit = (value) => {
+        const ref = parseBusinessReference(value);
+        if (ref) {
+            if (active.has(ref))
+                throw new Error(`Business reference cycle: ${ref}`);
+            const [ns, ...parts] = ref.split(".");
+            if (ns === "state" && options.deferState)
+                return exports.DEFERRED;
+            if (ns === "state" && !stateRead) {
+                // Runtime producers may retain unrelated optional undefined metadata.
+                // Validate the selected subtree below, never invoke descriptors on the path.
+                state = context.state();
+                stateRead = true;
+            }
+            // Read only the allowlisted target leaf; secret fields are never traversed or observed.
+            const source = (0, data_1.strictData)((0, data_1.ownPath)(ns === "param" ? params : ns === "state" ? state : context.target, parts, ref));
+            if (ns === "target" && (source === null || typeof source === "object"))
+                throw new Error("Public target references require scalar leaves");
+            active.add(ref);
+            const resolved = visit(source);
+            active.delete(ref);
+            if (!containsDeferred(resolved))
+                observations.push({
+                    reference: ref,
+                    contentIdentity: (0, canonicalData_1.semanticHash)(source),
+                    resolvedIdentity: (0, canonicalData_1.semanticHash)(resolved),
+                });
+            return resolved;
+        }
+        if (Array.isArray(value))
+            return value.map(visit);
+        if (value && typeof value === "object")
+            return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, visit(v)]));
+        return value;
+    };
+    return (0, canonicalData_1.deepFreeze)({
+        value: visit(input),
+        observations: observations.sort((a, b) => a.reference < b.reference ? -1 : a.reference > b.reference ? 1 : 0),
+    });
+}
+function containsDeferred(value) {
+    return (value === exports.DEFERRED ||
+        !!(value &&
+            typeof value === "object" &&
+            Object.values(value).some(containsDeferred)));
+}
+//# sourceMappingURL=references.js.map

package/dist-runtime/delivery/references.js.map

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

package/dist-runtime/delivery/release-graph.d.ts

@@ -0,0 +1,93 @@
+export interface ReleaseGraphOptions {
+    workspaceRoot: string;
+    projectRoot: string;
+    handoff: string;
+    taskId: string;
+    deploymentId: string;
+    releaseRef: {
+        path: string;
+        releaseId: string;
+        inputsHash: string;
+    };
+}
+export declare const sameReleaseData: (a: unknown, b: unknown, label: string) => void;
+export declare function readReleaseUniverse(input: Omit<ReleaseGraphOptions, 'releaseRef'>): {
+    workspace: string;
+    root: string;
+    text: string;
+    plan: import("../vendor/plan-codec/index.cjs").Plan;
+    entries: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    relevant: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    targets: string[];
+    qualifications: import("../vendor/plan-codec/index.cjs").PlanTask[];
+    upstream: Readonly<{
+        snapshot: import("./source").DeepReadonly<import("./source").DefinitionSnapshot>;
+        bytes: string;
+    }>;
+    developmentNetwork: string;
+};
+export declare function readReleaseGraph(input: ReleaseGraphOptions): {
+    targets: string[];
+    graph: {
+        readonly contract: typeof import("../vendor/plan-codec/index.cjs").DEFINITION_CONTRACT;
+        readonly schema: typeof import("../vendor/plan-codec/index.cjs").SCHEMA;
+        readonly taskId: string;
+        readonly flow?: string | undefined;
+        readonly roots: readonly string[];
+        readonly lanes: {
+            readonly [x: string]: {
+                readonly state: "enabled" | "disabled";
+                readonly skill?: string | undefined;
+                readonly steps: readonly string[];
+            };
+        };
+        readonly tasks: readonly {
+            readonly planKey: string;
+            readonly rev: number;
+            readonly objective: string;
+            readonly acceptance: readonly string[];
+            readonly dependsOn: readonly string[];
+            readonly step?: string | undefined;
+            readonly scope?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+            readonly parameters?: readonly unknown[] | undefined;
+            readonly expectedArtifacts?: readonly string[] | undefined;
+            readonly allowedChanges?: readonly string[] | undefined;
+            readonly lane: string;
+        }[];
+    };
+    prodTaskGraphHash: string;
+};
+/** Progress is deliberately outside sourceDefinitionHash: eligibility is checked anew. */
+export declare function currentReleasePrerequisites(input: Omit<ReleaseGraphOptions, 'releaseRef'>): {
+    required: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    workspace: string;
+    root: string;
+    text: string;
+    plan: import("../vendor/plan-codec/index.cjs").Plan;
+    entries: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    relevant: {
+        lane: string;
+        task: import("../vendor/plan-codec/index.cjs").PlanTask;
+    }[];
+    targets: string[];
+    qualifications: import("../vendor/plan-codec/index.cjs").PlanTask[];
+    upstream: Readonly<{
+        snapshot: import("./source").DeepReadonly<import("./source").DefinitionSnapshot>;
+        bytes: string;
+    }>;
+    developmentNetwork: string;
+};