@msn-control/liftoff 0.6.2 → 0.8.0

package/dist/repository-governance.js

@@ -0,0 +1,507 @@
+import { readFileSync } from 'node:fs';
+import { supportedStack } from './supported-stack.js';
+export const governancePolicySchemaVersion = 1;
+export const governancePolicyVersion = '1';
+export const governanceContextSchemaVersion = 1;
+export const governanceArtifactPaths = {
+    policy: ['.liftoff', 'governance', 'policy.md'],
+    context: ['.liftoff', 'governance', 'context.json'],
+    guide: ['.liftoff', 'governance', 'README.md'],
+    'github-copilot': [
+        '.github',
+        'prompts',
+        'liftoff-repository-governance.prompt.md'
+    ],
+    claude: [
+        '.claude',
+        'commands',
+        'liftoff-repository-governance.md'
+    ]
+};
+const suppliedPolicy = readFileSync(new URL('../assets/governance/single-maintainer-gitflow/policy.md', import.meta.url), 'utf8').replace(/\r\n/g, '\n').trimEnd();
+export function renderCanonicalGovernancePolicy() {
+    const rendered = suppliedPolicy;
+    validateGovernancePolicy(rendered);
+    assertGovernanceContentSafe(rendered);
+    return `${rendered.trimEnd()}\n`;
+}
+const requiredPolicyFragments = [
+    'schemaVersion: 1',
+    'profile: single-maintainer-gitflow',
+    'policyVersion: "1"',
+    'develop` is the integration branch and the **default branch**',
+    'main` is production truth',
+    'release/X.Y.Z',
+    'hotfix/X.Y.Z',
+    'required_approving_review_count: 0',
+    'require_code_owner_review: false',
+    'require_last_push_approval: false',
+    'Do not create a `CODEOWNERS` file',
+    'no required reviewers',
+    'GITHUB_TOKEN',
+    'Repository-scoped only',
+    'GitHub Secret Protection',
+    'Dependabot + Dependency Review',
+    'CodeQL + Copilot Autofix',
+    'Checkov',
+    'Trivy',
+    'Grype',
+    'OWASP ZAP',
+    'slsa-github-generator',
+    'OSSF Scorecard',
+    'Explicitly excluded as duplicates',
+    'build once',
+    'zero traffic',
+    'fresh baseline revision',
+    'Rollback must never be gated',
+    'Alerting is infrastructure as code',
+    'Route everything to Slack',
+    'Add a heartbeat',
+    'Test that each alert fires',
+    'shallow from deep checks',
+    'DORA four keys',
+    'trusted_root.jsonl',
+    'Fail-closed sequencing.',
+    'Prove each check fails',
+    'STOP FOR EXPLICIT USER APPROVAL',
+    'governance/activation-baseline.json',
+    'rulesets idempotently last',
+    'read the live rulesets'
+];
+export function validateGovernancePolicy(policy) {
+    const missing = requiredPolicyFragments.filter((fragment) => !policy.includes(fragment));
+    if (missing.length > 0) {
+        throw new Error(`Governance policy is missing required contract fragment: ${missing[0]}`);
+    }
+    if (!/No change in this repository\s+requires another person's approval/.test(policy) ||
+        !policy.includes('Never enable a ruleset whose required contexts have not been observed green')) {
+        throw new Error('Governance policy does not preserve fail-closed single-maintainer invariants.');
+    }
+}
+const secretValuePatterns = [
+    /\bghp_[A-Za-z0-9]{20,}\b/,
+    /\bgithub_pat_[A-Za-z0-9_]{20,}\b/,
+    /https:\/\/hooks\.slack\.com\/services\/[A-Za-z0-9/]+/,
+    /\bAccountKey=[^;\s]+/i,
+    /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/
+];
+export function assertGovernanceContentSafe(content) {
+    for (const pattern of secretValuePatterns) {
+        if (pattern.test(content)) {
+            throw new Error('Governance artifact contains a credential-shaped value.');
+        }
+    }
+}
+function apiCommands(plan) {
+    const backend = plan.apiStack.id === 'python-fastapi'
+        ? [
+            {
+                id: 'backend-install',
+                cwdPathParts: ['backend'],
+                executable: 'uv',
+                args: [
+                    'sync',
+                    '--frozen',
+                    '--extra',
+                    'test',
+                    ...(plan.workload === 'genai' && plan.pattern.worker
+                        ? ['--extra', 'functions']
+                        : [])
+                ]
+            },
+            {
+                id: 'backend-test',
+                cwdPathParts: ['backend'],
+                executable: 'uv',
+                args: ['run', 'python', '-m', 'pytest', '-q']
+            }
+        ]
+        : plan.apiStack.id === 'node-fastify'
+            ? [
+                {
+                    id: 'backend-install',
+                    cwdPathParts: ['backend'],
+                    executable: 'npm',
+                    args: ['ci']
+                },
+                {
+                    id: 'backend-build',
+                    cwdPathParts: ['backend'],
+                    executable: 'npm',
+                    args: ['run', 'build']
+                },
+                {
+                    id: 'backend-test',
+                    cwdPathParts: ['backend'],
+                    executable: 'npm',
+                    args: ['test']
+                }
+            ]
+            : [
+                {
+                    id: 'backend-install',
+                    cwdPathParts: ['backend'],
+                    executable: 'go',
+                    args: ['mod', 'download']
+                },
+                {
+                    id: 'backend-test',
+                    cwdPathParts: ['backend'],
+                    executable: 'go',
+                    args: ['test', './...']
+                }
+            ];
+    return [
+        ...backend,
+        ...(plan.includeFrontend
+            ? [
+                {
+                    id: 'frontend-install',
+                    cwdPathParts: ['frontend'],
+                    executable: 'npm',
+                    args: ['ci']
+                },
+                {
+                    id: 'frontend-build',
+                    cwdPathParts: ['frontend'],
+                    executable: 'npm',
+                    args: ['run', 'build']
+                }
+            ]
+            : []),
+        ...(plan.workload === 'genai' && plan.pattern.worker
+            ? [{
+                    id: 'function-worker-test',
+                    cwdPathParts: ['functions', `${plan.pattern.id}-worker`],
+                    executable: 'uv',
+                    args: [
+                        'run',
+                        '--project',
+                        '../../backend',
+                        '--directory',
+                        '.',
+                        'python',
+                        '-m',
+                        'pytest',
+                        '-q'
+                    ]
+                }]
+            : []),
+        {
+            id: 'local-stack-validate',
+            cwdPathParts: [],
+            executable: 'docker',
+            args: ['compose', 'config', '-q']
+        },
+        {
+            id: 'opentofu-format',
+            cwdPathParts: ['infrastructure', 'opentofu', 'azure'],
+            executable: 'tofu',
+            args: ['fmt', '-check', '-recursive']
+        },
+        {
+            id: 'opentofu-initialize',
+            cwdPathParts: ['infrastructure', 'opentofu', 'azure'],
+            executable: 'tofu',
+            args: ['init', '-backend=false']
+        },
+        {
+            id: 'opentofu-validate',
+            cwdPathParts: ['infrastructure', 'opentofu', 'azure'],
+            executable: 'tofu',
+            args: ['validate']
+        }
+    ];
+}
+function governanceContext(plan) {
+    const common = {
+        schemaVersion: governanceContextSchemaVersion,
+        policy: {
+            profile: plan.governanceProfile.id,
+            version: governancePolicyVersion,
+            state: 'handoff-generated',
+            liveEnforcement: 'not-active'
+        },
+        project: {
+            name: plan.projectName,
+            safeName: plan.safeProjectName,
+            workload: plan.workload,
+            artifactForm: plan.workload === 'power-apps-code-app'
+                ? 'browser-hosted-power-apps-code-app'
+                : plan.includeFrontend
+                    ? 'containerized-api-with-web-frontend'
+                    : 'containerized-api'
+        },
+        supportedStack: {
+            id: supportedStack.id,
+            verifiedOn: supportedStack.verifiedOn,
+            node: supportedStack.runtimes.node.version,
+            npm: supportedStack.packageManagers.npm.version,
+            framework: {
+                id: plan.framework.id,
+                version: plan.framework.version
+            }
+        },
+        agents: plan.agents.map((agent) => agent.id),
+        framework: {
+            id: plan.specWorkflow.id,
+            version: plan.framework.version,
+            ...(plan.defaultAgent
+                ? { defaultAgent: plan.defaultAgent.id }
+                : {})
+        },
+        discovery: {
+            githubRepository: 'undiscovered',
+            defaultBranch: 'undiscovered',
+            refs: 'undiscovered',
+            workflowsAndExactChecks: 'undiscovered',
+            rulesets: 'undiscovered',
+            releasesAndTags: 'undiscovered',
+            licensedSecurityFeatures: 'undiscovered',
+            privateRunnerAccess: 'undiscovered',
+            liveDeployments: 'undiscovered',
+            parallelVersionCapability: 'undiscovered',
+            canaryTrafficVolume: 'undiscovered',
+            monitoringAndAlerts: 'undiscovered',
+            slackSeverityRoutes: 'undiscovered',
+            providerStatus: 'undiscovered'
+        }
+    };
+    if (plan.workload === 'power-apps-code-app') {
+        return {
+            ...common,
+            supportedStack: {
+                ...common.supportedStack,
+                application: {
+                    react: supportedStack.npmProjects['power-apps-code-app']
+                        .resolved.dependencies.react,
+                    vite: supportedStack.npmProjects['power-apps-code-app']
+                        .resolved.devDependencies.vite,
+                    typescript: supportedStack.npmProjects['power-apps-code-app']
+                        .resolved.devDependencies.typescript,
+                    powerAppsSdk: supportedStack.npmProjects['power-apps-code-app']
+                        .resolved.dependencies['@microsoft/power-apps']
+                }
+            },
+            source: {
+                repository: plan.starter.repository,
+                path: plan.starter.path,
+                commit: plan.starter.commit
+            },
+            commands: [
+                { id: 'root-install', cwdPathParts: [], executable: 'npm', args: ['ci'] },
+                { id: 'root-lint', cwdPathParts: [], executable: 'npm', args: ['run', 'lint'] },
+                { id: 'root-build', cwdPathParts: [], executable: 'npm', args: ['run', 'build'] }
+            ],
+            generatedBoundaries: {
+                rootApplication: 'generated',
+                backend: 'inapplicable',
+                database: 'inapplicable',
+                docker: 'inapplicable',
+                opentofu: 'inapplicable',
+                apiEnvironments: 'inapplicable',
+                customContainerPromotion: 'inapplicable',
+                apiDast: 'inapplicable',
+                backendHealth: 'inapplicable',
+                powerPlatformDeployment: 'live-discovery-required'
+            },
+            environments: []
+        };
+    }
+    const worker = plan.workload === 'genai' && plan.pattern.worker;
+    return {
+        ...common,
+        supportedStack: {
+            ...common.supportedStack,
+            backendRuntime: plan.apiStack.id === 'python-fastapi'
+                ? supportedStack.runtimes.python.version
+                : plan.apiStack.id === 'node-fastify'
+                    ? supportedStack.runtimes.node.version
+                    : supportedStack.runtimes.go.version,
+            opentofu: supportedStack.runtimes.opentofu.version
+        },
+        api: {
+            stack: plan.apiStack.id,
+            ...(plan.workload === 'genai'
+                ? { pattern: plan.pattern.id }
+                : {})
+        },
+        commands: apiCommands(plan),
+        generatedBoundaries: {
+            backend: {
+                state: 'generated',
+                pathParts: ['backend']
+            },
+            frontend: plan.includeFrontend
+                ? { state: 'generated', pathParts: ['frontend'] }
+                : { state: 'inapplicable' },
+            worker: worker
+                ? {
+                    state: 'generated',
+                    pathParts: ['functions', `${plan.pattern.id}-worker`]
+                }
+                : { state: 'inapplicable' },
+            docker: {
+                state: 'generated',
+                pathParts: ['docker-compose.yml']
+            },
+            opentofu: {
+                state: 'generated-not-deployed',
+                pathParts: ['infrastructure', 'opentofu', 'azure']
+            }
+        },
+        environments: plan.environments.map((environment) => environment.id),
+        deployment: {
+            provider: plan.provider.id,
+            region: plan.region.slug,
+            liveState: 'undiscovered',
+            customContainerPromotion: 'requires-live-discovery',
+            apiDast: 'requires-live-staging-and-runner-discovery'
+        },
+        health: [
+            {
+                component: 'backend',
+                path: '/health',
+                depth: 'shallow'
+            },
+            {
+                component: 'backend',
+                path: '/ready',
+                depth: 'shallow',
+                gap: 'generated endpoint does not prove dependency reachability'
+            }
+        ]
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function validateGovernanceContext(value) {
+    if (!isRecord(value) || value.schemaVersion !== governanceContextSchemaVersion) {
+        throw new Error('Governance context must use schemaVersion 1.');
+    }
+    if (!isRecord(value.policy)) {
+        throw new Error('Governance context policy identity is missing.');
+    }
+    if (value.policy.profile !== 'single-maintainer-gitflow' ||
+        value.policy.version !== governancePolicyVersion ||
+        value.policy.state !== 'handoff-generated' ||
+        value.policy.liveEnforcement !== 'not-active') {
+        throw new Error('Governance context cannot claim live enforcement.');
+    }
+    if (!isRecord(value.discovery)) {
+        throw new Error('Governance context discovery state is missing.');
+    }
+    if (Object.values(value.discovery).some((entry) => entry !== 'undiscovered')) {
+        throw new Error('Governance context contains a fabricated live discovery fact.');
+    }
+    if (!Array.isArray(value.commands) || value.commands.length === 0) {
+        throw new Error('Governance context must contain real generated commands.');
+    }
+    if (!isRecord(value.generatedBoundaries)) {
+        throw new Error('Governance context generated boundaries are missing.');
+    }
+}
+export function renderGovernanceContext(plan) {
+    const value = governanceContext(plan);
+    validateGovernanceContext(value);
+    const rendered = `${JSON.stringify(value, null, 2)}\n`;
+    assertGovernanceContentSafe(rendered);
+    return rendered;
+}
+function renderGovernanceGuide(plan) {
+    const launchers = plan.agents.map((agent) => agent.id === 'github-copilot'
+        ? '- GitHub Copilot: `/liftoff-repository-governance` from the repository root.'
+        : '- Claude Code: `/liftoff-repository-governance` from the repository root.').join('\n');
+    return `# Repository governance handoff
+
+State: **handoff generated; live enforcement is not active**.
+
+Liftoff generated deterministic policy and workload context only. It did not
+create or change branches, commits, tags, remotes, pull requests, releases,
+rulesets, GitHub settings, security features, environments, runners, cloud
+resources, deployments, monitoring, alerts, or Slack routes.
+
+## Before activation
+
+1. Review \`policy.md\` and \`context.json\`.
+2. Commit the complete project and push it to its intended GitHub repository.
+3. Invoke one selected-agent launcher:
+
+${launchers}
+
+4. The agent performs read-only Phase 0, reports evidence, gaps,
+   inapplicable controls, the proposed current \`main\` activation SHA, and an
+   ordered plan.
+5. The agent stops. Explicitly approve or revise that conversational plan.
+   This approval is required before implementation and is distinct from the
+   policy's prohibition on human merge or deployment approval gates.
+6. After approval, the agent creates a new ${plan.specWorkflow.label}
+   governance change. Liftoff does not own or recreate that change.
+
+Live status must be proven from user-owned activation evidence and GitHub
+read-back, never inferred from these local files.
+`;
+}
+function renderAgentLauncher(plan) {
+    return `# Activate Liftoff repository governance
+
+Require a committed and pushed GitHub repository. Read
+\`.liftoff/governance/policy.md\` and
+\`.liftoff/governance/context.json\` as the canonical inputs.
+
+Perform only the policy's read-only Phase 0. Report all evidence, gaps,
+inapplicable controls, GitFlow or continuous-delivery conflicts, the proposed
+current \`main\` activation baseline SHA, and the ordered implementation plan.
+Then stop for explicit user approval.
+
+Before approval, do not write files, create a ${plan.specWorkflow.label} change,
+mutate Git, call a mutating GitHub API, configure security, deploy, or create
+monitoring. After approval, create a new ${plan.specWorkflow.label} governance
+change from the discovered facts. Never treat the Liftoff handoff as live
+enforcement and never create or modify
+\`governance/activation-baseline.json\` before approval.
+`;
+}
+export function buildRepositoryGovernanceArtifacts(plan) {
+    if (plan.governanceProfile.id === 'none') {
+        return [];
+    }
+    const policy = renderCanonicalGovernancePolicy();
+    const context = renderGovernanceContext(plan);
+    const guide = `${renderGovernanceGuide(plan).trimEnd()}\n`;
+    const launcher = `${renderAgentLauncher(plan).trimEnd()}\n`;
+    const artifacts = [
+        {
+            logicalName: 'repository-governance-policy',
+            category: 'governance',
+            pathParts: [...governanceArtifactPaths.policy],
+            content: policy
+        },
+        {
+            logicalName: 'repository-governance-context',
+            category: 'governance',
+            pathParts: [...governanceArtifactPaths.context],
+            content: context
+        },
+        {
+            logicalName: 'repository-governance-guide',
+            category: 'governance',
+            pathParts: [...governanceArtifactPaths.guide],
+            content: guide
+        },
+        ...plan.agents.map((agent) => ({
+            logicalName: agent.id === 'github-copilot'
+                ? 'repository-governance-copilot-launcher'
+                : 'repository-governance-claude-launcher',
+            category: 'governance',
+            pathParts: [...governanceArtifactPaths[agent.id]],
+            content: launcher
+        }))
+    ];
+    for (const artifact of artifacts) {
+        assertGovernanceContentSafe(artifact.content);
+    }
+    return artifacts;
+}
+//# sourceMappingURL=repository-governance.js.map

package/dist/repository-governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-governance.js","sourceRoot":"","sources":["../src/repository-governance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAKvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAU,CAAC;AACxD,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAY,CAAC;AACpD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC;AAEzD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;IAC/C,OAAO,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,cAAc,CAAC;IACnD,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;IAC9C,gBAAgB,EAAE;QAChB,SAAS;QACT,SAAS;QACT,yCAAyC;KAC1C;IACD,MAAM,EAAE;QACN,SAAS;QACT,UAAU;QACV,kCAAkC;KACnC;CACO,CAAC;AAEX,MAAM,cAAc,GAAG,YAAY,CACjC,IAAI,GAAG,CACL,0DAA0D,EAC1D,OAAO,IAAI,CAAC,GAAG,CAChB,EACD,MAAM,CACP,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAEnC,MAAM,UAAU,+BAA+B;IAC7C,MAAM,QAAQ,GAAG,cAAc,CAAC;IAChC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACnC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,uBAAuB,GAAG;IAC9B,kBAAkB;IAClB,oCAAoC;IACpC,oBAAoB;IACpB,+DAA+D;IAC/D,2BAA2B;IAC3B,eAAe;IACf,cAAc;IACd,oCAAoC;IACpC,kCAAkC;IAClC,mCAAmC;IACnC,mCAAmC;IACnC,uBAAuB;IACvB,cAAc;IACd,wBAAwB;IACxB,0BAA0B;IAC1B,gCAAgC;IAChC,0BAA0B;IAC1B,SAAS;IACT,OAAO;IACP,OAAO;IACP,WAAW;IACX,uBAAuB;IACvB,gBAAgB;IAChB,mCAAmC;IACnC,YAAY;IACZ,cAAc;IACd,yBAAyB;IACzB,8BAA8B;IAC9B,oCAAoC;IACpC,2BAA2B;IAC3B,iBAAiB;IACjB,4BAA4B;IAC5B,0BAA0B;IAC1B,gBAAgB;IAChB,oBAAoB;IACpB,yBAAyB;IACzB,wBAAwB;IACxB,iCAAiC;IACjC,qCAAqC;IACrC,4BAA4B;IAC5B,wBAAwB;CAChB,CAAC;AAEX,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC1D,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC3B,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,4DAA4D,OAAO,CAAC,CAAC,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,IACE,CAAC,mEAAmE,CAAC,IAAI,CAAC,MAAM,CAAC;QACjF,CAAC,MAAM,CAAC,QAAQ,CAAC,6EAA6E,CAAC,EAC/F,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACnG,CAAC;AACH,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC1B,0BAA0B;IAC1B,kCAAkC;IAClC,sDAAsD;IACtD,uBAAuB;IACvB,mDAAmD;CAC3C,CAAC;AAEX,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;AACH,CAAC;AASD,SAAS,WAAW,CAAC,IAA+D;IAClF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,gBAAgB;QACnD,CAAC,CAAC;YACE;gBACE,EAAE,EAAE,iBAAiB;gBACrB,YAAY,EAAE,CAAC,SAAS,CAAC;gBACzB,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE;oBACJ,MAAM;oBACN,UAAU;oBACV,SAAS;oBACT,MAAM;oBACN,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;wBAClD,CAAC,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC;wBAC1B,CAAC,CAAC,EAAE,CAAC;iBACR;aACF;YACD;gBACE,EAAE,EAAE,cAAc;gBAClB,YAAY,EAAE,CAAC,SAAS,CAAC;gBACzB,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC;aAC9C;SACF;QACH,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,cAAc;YACnC,CAAC,CAAC;gBACE;oBACE,EAAE,EAAE,iBAAiB;oBACrB,YAAY,EAAE,CAAC,SAAS,CAAC;oBACzB,UAAU,EAAE,KAAK;oBACjB,IAAI,EAAE,CAAC,IAAI,CAAC;iBACb;gBACD;oBACE,EAAE,EAAE,eAAe;oBACnB,YAAY,EAAE,CAAC,SAAS,CAAC;oBACzB,UAAU,EAAE,KAAK;oBACjB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;iBACvB;gBACD;oBACE,EAAE,EAAE,cAAc;oBAClB,YAAY,EAAE,CAAC,SAAS,CAAC;oBACzB,UAAU,EAAE,KAAK;oBACjB,IAAI,EAAE,CAAC,MAAM,CAAC;iBACf;aACF;YACH,CAAC,CAAC;gBACE;oBACE,EAAE,EAAE,iBAAiB;oBACrB,YAAY,EAAE,CAAC,SAAS,CAAC;oBACzB,UAAU,EAAE,IAAI;oBAChB,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC;iBAC1B;gBACD;oBACE,EAAE,EAAE,cAAc;oBAClB,YAAY,EAAE,CAAC,SAAS,CAAC;oBACzB,UAAU,EAAE,IAAI;oBAChB,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;iBACxB;aACF,CAAC;IACR,OAAO;QACL,GAAG,OAAO;QACV,GAAG,CAAC,IAAI,CAAC,eAAe;YACtB,CAAC,CAAC;gBACE;oBACE,EAAE,EAAE,kBAAkB;oBACtB,YAAY,EAAE,CAAC,UAAU,CAAC;oBAC1B,UAAU,EAAE,KAAK;oBACjB,IAAI,EAAE,CAAC,IAAI,CAAC;iBACb;gBACD;oBACE,EAAE,EAAE,gBAAgB;oBACpB,YAAY,EAAE,CAAC,UAAU,CAAC;oBAC1B,UAAU,EAAE,KAAK;oBACjB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;iBACvB;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YAClD,CAAC,CAAC,CAAC;oBACC,EAAE,EAAE,sBAAsB;oBAC1B,YAAY,EAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;oBACxD,UAAU,EAAE,IAAI;oBAChB,IAAI,EAAE;wBACJ,KAAK;wBACL,WAAW;wBACX,eAAe;wBACf,aAAa;wBACb,GAAG;wBACH,QAAQ;wBACR,IAAI;wBACJ,QAAQ;wBACR,IAAI;qBACL;iBACF,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QACP;YACE,EAAE,EAAE,sBAAsB;YAC1B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;SAClC;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,YAAY,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,CAAC;YACrD,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC;SACtC;QACD;YACE,EAAE,EAAE,qBAAqB;YACzB,YAAY,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,CAAC;YACrD,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC;SACjC;QACD;YACE,EAAE,EAAE,mBAAmB;YACvB,YAAY,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,CAAC;YACrD,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,CAAC,UAAU,CAAC;SACnB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAiB;IAC1C,MAAM,MAAM,GAAG;QACb,aAAa,EAAE,8BAA8B;QAC7C,MAAM,EAAE;YACN,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE;YAClC,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,mBAAmB;YAC1B,eAAe,EAAE,YAAY;SAC9B;QACD,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,CAAC,WAAW;YACtB,QAAQ,EAAE,IAAI,CAAC,eAAe;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,QAAQ,KAAK,qBAAqB;gBACnD,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,IAAI,CAAC,eAAe;oBACpB,CAAC,CAAC,qCAAqC;oBACvC,CAAC,CAAC,mBAAmB;SAC1B;QACD,cAAc,EAAE;YACd,EAAE,EAAE,cAAc,CAAC,EAAE;YACrB,UAAU,EAAE,cAAc,CAAC,UAAU;YACrC,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO;YAC1C,GAAG,EAAE,cAAc,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO;YAC/C,SAAS,EAAE;gBACT,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE;gBACrB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO;aAChC;SACF;QACD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,SAAS,EAAE;YACT,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE;YACxB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO;YAC/B,GAAG,CAAC,IAAI,CAAC,YAAY;gBACnB,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE;gBACxC,CAAC,CAAC,EAAE,CAAC;SACR;QACD,SAAS,EAAE;YACT,gBAAgB,EAAE,cAAc;YAChC,aAAa,EAAE,cAAc;YAC7B,IAAI,EAAE,cAAc;YACpB,uBAAuB,EAAE,cAAc;YACvC,QAAQ,EAAE,cAAc;YACxB,eAAe,EAAE,cAAc;YAC/B,wBAAwB,EAAE,cAAc;YACxC,mBAAmB,EAAE,cAAc;YACnC,eAAe,EAAE,cAAc;YAC/B,yBAAyB,EAAE,cAAc;YACzC,mBAAmB,EAAE,cAAc;YACnC,mBAAmB,EAAE,cAAc;YACnC,mBAAmB,EAAE,cAAc;YACnC,cAAc,EAAE,cAAc;SAC/B;KACF,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,KAAK,qBAAqB,EAAE,CAAC;QAC5C,OAAO;YACL,GAAG,MAAM;YACT,cAAc,EAAE;gBACd,GAAG,MAAM,CAAC,cAAc;gBACxB,WAAW,EAAE;oBACX,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,qBAAqB,CAAC;yBACrD,QAAQ,CAAC,YAAY,CAAC,KAAK;oBAC9B,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,qBAAqB,CAAC;yBACpD,QAAQ,CAAC,eAAe,CAAC,IAAI;oBAChC,UAAU,EAAE,cAAc,CAAC,WAAW,CAAC,qBAAqB,CAAC;yBAC1D,QAAQ,CAAC,eAAe,CAAC,UAAU;oBACtC,YAAY,EAAE,cAAc,CAAC,WAAW,CAAC,qBAAqB,CAAC;yBAC5D,QAAQ,CAAC,YAAY,CAAC,uBAAuB,CAAC;iBAClD;aACF;YACD,MAAM,EAAE;gBACN,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;gBACnC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;gBACvB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;aAC5B;YACD,QAAQ,EAAE;gBACR,EAAE,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;gBACzE,EAAE,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE;gBAC/E,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;aAClF;YACD,mBAAmB,EAAE;gBACnB,eAAe,EAAE,WAAW;gBAC5B,OAAO,EAAE,cAAc;gBACvB,QAAQ,EAAE,cAAc;gBACxB,MAAM,EAAE,cAAc;gBACtB,QAAQ,EAAE,cAAc;gBACxB,eAAe,EAAE,cAAc;gBAC/B,wBAAwB,EAAE,cAAc;gBACxC,OAAO,EAAE,cAAc;gBACvB,aAAa,EAAE,cAAc;gBAC7B,uBAAuB,EAAE,yBAAyB;aACnD;YACD,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAChE,OAAO;QACL,GAAG,MAAM;QACT,cAAc,EAAE;YACd,GAAG,MAAM,CAAC,cAAc;YACxB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,gBAAgB;gBACnD,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO;gBACxC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,cAAc;oBACnC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO;oBACtC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO;YACxC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO;SACnD;QACD,GAAG,EAAE;YACH,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YACvB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO;gBAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE;gBAC9B,CAAC,CAAC,EAAE,CAAC;SACR;QACD,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC;QAC3B,mBAAmB,EAAE;YACnB,OAAO,EAAE;gBACP,KAAK,EAAE,WAAW;gBAClB,SAAS,EAAE,CAAC,SAAS,CAAC;aACvB;YACD,QAAQ,EAAE,IAAI,CAAC,eAAe;gBAC5B,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE;gBACjD,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE;YAC7B,MAAM,EAAE,MAAM;gBACZ,CAAC,CAAC;oBACE,KAAK,EAAE,WAAW;oBAClB,SAAS,EAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;iBACtD;gBACH,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE;YAC7B,MAAM,EAAE;gBACN,KAAK,EAAE,WAAW;gBAClB,SAAS,EAAE,CAAC,oBAAoB,CAAC;aAClC;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,wBAAwB;gBAC/B,SAAS,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,CAAC;aACnD;SACF;QACD,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QACpE,UAAU,EAAE;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACxB,SAAS,EAAE,cAAc;YACzB,wBAAwB,EAAE,yBAAyB;YACnD,OAAO,EAAE,4CAA4C;SACtD;QACD,MAAM,EAAE;YACN;gBACE,SAAS,EAAE,SAAS;gBACpB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,SAAS;aACjB;YACD;gBACE,SAAS,EAAE,SAAS;gBACpB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAAS;gBAChB,GAAG,EAAE,2DAA2D;aACjE;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,8BAA8B,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IACE,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,2BAA2B;QACpD,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,uBAAuB;QAChD,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,mBAAmB;QAC1C,KAAK,CAAC,MAAM,CAAC,eAAe,KAAK,YAAY,EAC7C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,cAAc,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAiB;IACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACtC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACvD,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAiB;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1C,KAAK,CAAC,EAAE,KAAK,gBAAgB;QAC3B,CAAC,CAAC,8EAA8E;QAChF,CAAC,CAAC,2EAA2E,CAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO;;;;;;;;;;;;;;;EAeP,SAAS;;;;;;;;6CAQkC,IAAI,CAAC,YAAY,CAAC,KAAK;;;;;CAKnE,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAiB;IAC5C,OAAO;;;;;;;;;;;gDAWuC,IAAI,CAAC,YAAY,CAAC,KAAK;;2CAE5B,IAAI,CAAC,YAAY,CAAC,KAAK;;;;CAIjE,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,IAAiB;IAEjB,IAAI,IAAI,CAAC,iBAAiB,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,+BAA+B,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;IAC3D,MAAM,QAAQ,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;IAC5D,MAAM,SAAS,GAAwB;QACrC;YACE,WAAW,EAAE,8BAA8B;YAC3C,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,CAAC,GAAG,uBAAuB,CAAC,MAAM,CAAC;YAC9C,OAAO,EAAE,MAAM;SAChB;QACD;YACE,WAAW,EAAE,+BAA+B;YAC5C,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,CAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC;YAC/C,OAAO,EAAE,OAAO;SACjB;QACD;YACE,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC;YAC7C,OAAO,EAAE,KAAK;SACf;QACD,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAqB,EAAE,CAAC,CAAC;YAChD,WAAW,EAAE,KAAK,CAAC,EAAE,KAAK,gBAAgB;gBACxC,CAAC,CAAC,wCAAwC;gBAC1C,CAAC,CAAC,uCAAuC;YAC3C,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjD,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;KACJ,CAAC;IACF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,2BAA2B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/runtime.d.ts

@@ -1,2 +1,2 @@
-export declare const minimumNodeVersion = "20.19.0";
+export declare const minimumNodeVersion: string;
 export declare function nodeRuntimeError(observedVersion?: string): string | undefined;

package/dist/runtime.js

@@ -1,5 +1,7 @@
 import { compareSemver } from './semver.js';
-export const minimumNodeVersion = '20.19.0';
+import { supportedStack } from './supported-stack.js';
+export const minimumNodeVersion = supportedStack.runtimes.node.minimumVersion ??
+    supportedStack.runtimes.node.version;
 export function nodeRuntimeError(observedVersion = process.versions.node) {
     if (compareSemver(observedVersion, minimumNodeVersion) >= 0) {
         return undefined;

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,MAAM,UAAU,gBAAgB,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI;IACtE,IAAI,aAAa,CAAC,eAAe,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,4BAA4B,kBAAkB,oBAAoB,eAAe,oCAAoC,CAAC;AAC/H,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc;IAC3E,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI;IACtE,IAAI,aAAa,CAAC,eAAe,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,4BAA4B,kBAAkB,oBAAoB,eAAe,oCAAoC,CAAC;AAC/H,CAAC"}

package/dist/self-upgrade.d.ts

@@ -0,0 +1,77 @@
+import type { Stats } from 'node:fs';
+import { type StableRelease } from './stable-release.js';
+import { type CommandRunner } from './process-runner.js';
+import type { ExternalCommand } from './types.js';
+export declare const selfUpgradeSchemaVersion: 1;
+export declare const selfUpgradeInstallTimeoutMs: number;
+export declare const selfUpgradeProbeTimeoutMs = 30000;
+export declare const selfUpgradeVerificationTimeoutMs = 15000;
+export type SelfUpgradeMode = 'apply' | 'check';
+export type SelfUpgradeStatus = 'blocked' | 'current' | 'failed' | 'update-available' | 'upgraded';
+export type SelfUpgradeRegistryKind = 'canonical' | 'configured';
+export type SelfUpgradeReasonCode = 'canonical_invalid' | 'canonical_timeout' | 'canonical_unavailable' | 'current' | 'downgrade_refused' | 'invalid_global_root' | 'invalid_package' | 'npm_install_failed' | 'npm_install_timeout' | 'npm_unavailable' | 'registry_invalid' | 'registry_stale' | 'registry_unavailable' | 'unsupported_installation' | 'update_available' | 'upgrade_complete' | 'verification_failed';
+interface SelfUpgradeResultBase {
+    schemaVersion: typeof selfUpgradeSchemaVersion;
+    mode: SelfUpgradeMode;
+    status: SelfUpgradeStatus;
+    currentVersion: string;
+    reasonCode: SelfUpgradeReasonCode;
+}
+export type SelfUpgradeResult = (SelfUpgradeResultBase & {
+    status: 'current';
+    reasonCode: 'current';
+}) | (SelfUpgradeResultBase & {
+    status: 'update-available';
+    reasonCode: 'update_available';
+    targetVersion: string;
+    registryKind: SelfUpgradeRegistryKind;
+}) | (SelfUpgradeResultBase & {
+    status: 'upgraded';
+    reasonCode: 'upgrade_complete';
+    targetVersion: string;
+    registryKind: SelfUpgradeRegistryKind;
+}) | (SelfUpgradeResultBase & {
+    status: 'blocked' | 'failed';
+    targetVersion?: string;
+    registryKind?: SelfUpgradeRegistryKind;
+});
+export type SelfUpgradeStage = 'Inspect global installation' | 'Resolve canonical stable target' | 'Verify configured registry parity' | 'Install exact Liftoff release' | 'Verify replacement';
+export interface SelfUpgradeRequest {
+    mode: SelfUpgradeMode;
+    currentVersion: string;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+    json: boolean;
+    runningPackageRoot?: string;
+    onStage?: (stage: SelfUpgradeStage, detail?: string) => void;
+    onInstallCommand?: (command: ExternalCommand) => void;
+}
+export type SelfUpgradeExecutor = (request: SelfUpgradeRequest) => Promise<SelfUpgradeResult>;
+export interface SelfUpgradeDependencies {
+    runner: CommandRunner;
+    lookupStableRelease(): Promise<StableRelease>;
+    makeNeutralDirectory(): Promise<string>;
+    removeNeutralDirectory(directory: string): Promise<void>;
+    readJson(filePath: string): Promise<unknown>;
+    lstat(filePath: string): Promise<Stats>;
+    realpath(filePath: string): Promise<string>;
+    platform: NodeJS.Platform;
+    execPath: string;
+    environment: NodeJS.ProcessEnv;
+}
+export type ConfiguredRegistryTargetResult = {
+    status: 'available';
+    registryKind: SelfUpgradeRegistryKind;
+} | {
+    status: 'stale' | 'unavailable';
+};
+export type ConfiguredRegistryTargetLookup = (targetVersion: string) => Promise<ConfiguredRegistryTargetResult>;
+export declare function pathIsContained(root: string, candidate: string, platform: NodeJS.Platform): boolean;
+export declare function expectedGlobalPackageRoot(globalRoot: string, platform: NodeJS.Platform): string;
+export declare function buildGlobalNpmInstallCommand(targetVersion: string, platform: NodeJS.Platform): ExternalCommand;
+export declare function selfUpgradeExitCode(value: SelfUpgradeResult): number;
+export declare function selfUpgradeRemedy(value: SelfUpgradeResult): string | undefined;
+export declare function selfUpgradeSummary(value: SelfUpgradeResult): string;
+export declare function checkConfiguredRegistryTarget(targetVersion: string, overrides?: Partial<SelfUpgradeDependencies>): Promise<ConfiguredRegistryTargetResult>;
+export declare function runSelfUpgrade(request: SelfUpgradeRequest, overrides?: Partial<SelfUpgradeDependencies>): Promise<SelfUpgradeResult>;
+export {};