@lesliechan721/aw 0.1.0-beta.3 → 0.1.0-beta.31

package/dist/src/utils/plugin-intent-state.js

@@ -0,0 +1,320 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { parsePluginId } from './multi-source-catalog.js';
+import { atomicReplaceConfigFile, resolveAwProjectRoot, } from './plugin-config.js';
+import { assertCanonicalProjectManagedRoots, assertProjectSharedConfigPathVisible, } from './project-boundary.js';
+import { resolveAwHome } from './state-paths.js';
+import { assertTestReadablePath, assertTestWritablePath, } from './test-path-fence.js';
+export const PLUGIN_INTENT_SCHEMA_VERSION = 2;
+export const PLUGIN_INTENT_KIND = 'aw-plugin-intents';
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertExactKeys(value, expected, fieldName) {
+    const allowed = new Set(expected);
+    const unknown = Object.keys(value).filter((key) => !allowed.has(key));
+    const missing = expected.filter((key) => !(key in value));
+    if (unknown.length > 0 || missing.length > 0) {
+        throw new Error(`Invalid ${fieldName}: expected exactly ${expected.join(', ')}.`
+            + `${unknown.length > 0 ? ` Unknown: ${unknown.sort(compareText).join(', ')}.` : ''}`
+            + `${missing.length > 0 ? ` Missing: ${missing.join(', ')}.` : ''}`);
+    }
+}
+function parseCanonicalPluginId(value, fieldName) {
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid ${fieldName}: expected a source-qualified plugin ID.`);
+    }
+    const parsed = parsePluginId(value);
+    if (!parsed.sourceId) {
+        throw new Error(`Invalid ${fieldName}: expected a source-qualified plugin ID.`);
+    }
+    return `${parsed.sourceId}/${parsed.pluginName}`;
+}
+function parsePlatform(value, fieldName) {
+    if (value !== 'codex' && value !== 'claude') {
+        throw new Error(`Invalid ${fieldName}: expected codex or claude.`);
+    }
+    return value;
+}
+function parseScope(value, fieldName) {
+    if (value !== 'project' && value !== 'user') {
+        throw new Error(`Invalid ${fieldName}: expected project or user.`);
+    }
+    return value;
+}
+function canonicalPlatforms(platforms) {
+    return [...new Set(platforms)].sort(compareText);
+}
+export function createEmptyPluginIntentState() {
+    return {
+        schemaVersion: PLUGIN_INTENT_SCHEMA_VERSION,
+        kind: PLUGIN_INTENT_KIND,
+        roots: [],
+        dependencyScopeOverrides: [],
+    };
+}
+export function canonicalizePluginIntentState(state) {
+    const roots = state.roots.map((root) => ({
+        pluginId: parseCanonicalPluginId(root.pluginId, 'roots[].pluginId'),
+        platforms: canonicalPlatforms(root.platforms.map((platform) => parsePlatform(platform, 'roots[].platforms[]'))),
+    }));
+    if (roots.some((root) => root.platforms.length === 0)) {
+        throw new Error('Invalid roots[].platforms: expected at least one platform.');
+    }
+    if (new Set(roots.map((root) => root.pluginId)).size !== roots.length) {
+        throw new Error('Invalid roots: duplicate pluginId.');
+    }
+    const dependencyScopeOverrides = state.dependencyScopeOverrides.map((override) => ({
+        pluginId: parseCanonicalPluginId(override.pluginId, 'dependencyScopeOverrides[].pluginId'),
+        platform: parsePlatform(override.platform, 'dependencyScopeOverrides[].platform'),
+        scope: parseScope(override.scope, 'dependencyScopeOverrides[].scope'),
+    }));
+    const overrideKeys = dependencyScopeOverrides.map((override) => `${override.pluginId}\0${override.platform}`);
+    if (new Set(overrideKeys).size !== overrideKeys.length) {
+        throw new Error('Invalid dependencyScopeOverrides: duplicate pluginId/platform target.');
+    }
+    return {
+        schemaVersion: PLUGIN_INTENT_SCHEMA_VERSION,
+        kind: PLUGIN_INTENT_KIND,
+        roots: roots.sort((left, right) => compareText(left.pluginId, right.pluginId)),
+        dependencyScopeOverrides: dependencyScopeOverrides.sort((left, right) => compareText(`${left.pluginId}\0${left.platform}`, `${right.pluginId}\0${right.platform}`)),
+    };
+}
+export function parsePluginIntentState(value) {
+    if (!isRecord(value))
+        throw new Error('Invalid plugin intent state: expected an object.');
+    assertExactKeys(value, ['schemaVersion', 'kind', 'roots', 'dependencyScopeOverrides'], 'plugin intent state');
+    if (value.schemaVersion !== PLUGIN_INTENT_SCHEMA_VERSION) {
+        throw new Error('Invalid plugin intent state schemaVersion: expected 2.');
+    }
+    if (value.kind !== PLUGIN_INTENT_KIND) {
+        throw new Error(`Invalid plugin intent state kind: expected ${PLUGIN_INTENT_KIND}.`);
+    }
+    if (!Array.isArray(value.roots))
+        throw new Error('Invalid roots: expected an array.');
+    if (!Array.isArray(value.dependencyScopeOverrides)) {
+        throw new Error('Invalid dependencyScopeOverrides: expected an array.');
+    }
+    const roots = value.roots.map((entry, index) => {
+        if (!isRecord(entry))
+            throw new Error(`Invalid roots[${index}]: expected an object.`);
+        assertExactKeys(entry, ['pluginId', 'platforms'], `roots[${index}]`);
+        if (!Array.isArray(entry.platforms)) {
+            throw new Error(`Invalid roots[${index}].platforms: expected an array.`);
+        }
+        return {
+            pluginId: parseCanonicalPluginId(entry.pluginId, `roots[${index}].pluginId`),
+            platforms: entry.platforms.map((platform, platformIndex) => parsePlatform(platform, `roots[${index}].platforms[${platformIndex}]`)),
+        };
+    });
+    const dependencyScopeOverrides = value.dependencyScopeOverrides.map((entry, index) => {
+        if (!isRecord(entry)) {
+            throw new Error(`Invalid dependencyScopeOverrides[${index}]: expected an object.`);
+        }
+        assertExactKeys(entry, ['pluginId', 'platform', 'scope'], `dependencyScopeOverrides[${index}]`);
+        return {
+            pluginId: parseCanonicalPluginId(entry.pluginId, `dependencyScopeOverrides[${index}].pluginId`),
+            platform: parsePlatform(entry.platform, `dependencyScopeOverrides[${index}].platform`),
+            scope: parseScope(entry.scope, `dependencyScopeOverrides[${index}].scope`),
+        };
+    });
+    return canonicalizePluginIntentState({
+        schemaVersion: PLUGIN_INTENT_SCHEMA_VERSION,
+        kind: PLUGIN_INTENT_KIND,
+        roots,
+        dependencyScopeOverrides,
+    });
+}
+export function serializePluginIntentState(state) {
+    return `${JSON.stringify(canonicalizePluginIntentState(state), null, 2)}\n`;
+}
+export function calculatePluginIntentDigest(state) {
+    const canonical = canonicalizePluginIntentState(state);
+    const digest = crypto.createHash('sha256').update(JSON.stringify(canonical)).digest('hex');
+    return `sha256:${digest}`;
+}
+export function upsertPluginIntentRoot(state, root) {
+    const pluginId = parseCanonicalPluginId(root.pluginId, 'root.pluginId');
+    return canonicalizePluginIntentState({
+        ...state,
+        roots: [
+            ...state.roots.filter((entry) => entry.pluginId !== pluginId),
+            { pluginId, platforms: [...root.platforms] },
+        ],
+    });
+}
+export function mergePluginIntentRootPlatforms(state, root) {
+    const pluginId = parseCanonicalPluginId(root.pluginId, 'root.pluginId');
+    const current = state.roots.find((entry) => entry.pluginId === pluginId);
+    return upsertPluginIntentRoot(state, {
+        pluginId,
+        platforms: [...(current?.platforms ?? []), ...root.platforms],
+    });
+}
+export function addPluginIntentRoot(state, root) {
+    const pluginId = parseCanonicalPluginId(root.pluginId, 'root.pluginId');
+    if (state.roots.some((entry) => entry.pluginId === pluginId)) {
+        throw new Error(`Plugin intent root already exists: ${pluginId}`);
+    }
+    return upsertPluginIntentRoot(state, { ...root, pluginId });
+}
+export function removePluginIntentRoot(state, pluginId) {
+    const canonicalPluginId = parseCanonicalPluginId(pluginId, 'pluginId');
+    return canonicalizePluginIntentState({
+        ...state,
+        roots: state.roots.filter((entry) => entry.pluginId !== canonicalPluginId),
+    });
+}
+export function removePluginIntentRootPlatforms(state, root) {
+    const pluginId = parseCanonicalPluginId(root.pluginId, 'root.pluginId');
+    const removed = new Set(root.platforms.map((platform) => parsePlatform(platform, 'root.platforms[]')));
+    const current = state.roots.find((entry) => entry.pluginId === pluginId);
+    if (!current)
+        return state;
+    const platforms = current.platforms.filter((platform) => !removed.has(platform));
+    return platforms.length === 0
+        ? removePluginIntentRoot(state, pluginId)
+        : upsertPluginIntentRoot(state, { pluginId, platforms });
+}
+export function resolvePluginIntentStatePath(location, access) {
+    const filePath = location.scope === 'user'
+        ? path.join(resolveAwHome(location.env), 'plugin-intents.json')
+        : path.join(resolveAwProjectRoot(location.cwd), '.agent-workflows', 'plugin-intents.json');
+    if (access === 'read') {
+        return assertTestReadablePath(filePath, `${location.scope} plugin intent state`, '用测试隔离环境登记可读 project 或 AW_HOME 根。');
+    }
+    if (access === 'write') {
+        return assertTestWritablePath(filePath, `${location.scope} plugin intent state`, '用 createIsolatedTestEnv() 或 withSafeTestCwd() 登记可写根。');
+    }
+    return filePath;
+}
+function assertPathInsideRoot(allowedRoot, filePath) {
+    const relative = path.relative(path.resolve(allowedRoot), path.resolve(filePath));
+    if (relative === ''
+        || relative === '..'
+        || relative.startsWith(`..${path.sep}`)
+        || path.isAbsolute(relative)) {
+        throw new Error('Plugin intent path escapes its allowed root.');
+    }
+}
+async function assertReadableIntentPath(allowedRoot, filePath) {
+    assertPathInsideRoot(allowedRoot, filePath);
+    const root = path.resolve(allowedRoot);
+    const rootStats = await fs.lstat(root).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!rootStats)
+        return false;
+    if (rootStats.isSymbolicLink() || !rootStats.isDirectory()) {
+        throw new Error(`Plugin intent root must be a regular directory: ${root}`);
+    }
+    let current = root;
+    for (const segment of path.relative(root, path.resolve(filePath)).split(path.sep).filter(Boolean)) {
+        current = path.join(current, segment);
+        const stats = await fs.lstat(current).catch((error) => {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        });
+        if (!stats)
+            return false;
+        if (stats.isSymbolicLink()) {
+            throw new Error(`Plugin intent path cannot contain a symbolic link: ${current}`);
+        }
+        if (current === path.resolve(filePath) && !stats.isFile()) {
+            throw new Error(`Plugin intent target must be a regular file: ${filePath}`);
+        }
+        if (current !== path.resolve(filePath) && !stats.isDirectory()) {
+            throw new Error(`Plugin intent path parent must be a directory: ${current}`);
+        }
+    }
+    return true;
+}
+async function resolveIntentLocation(location) {
+    if (location.scope === 'user') {
+        const allowedRoot = resolveAwHome(location.env);
+        return {
+            allowedRoot,
+            filePath: resolvePluginIntentStatePath(location),
+        };
+    }
+    const allowedRoot = await assertCanonicalProjectManagedRoots({
+        cwd: location.cwd,
+        rootNames: [],
+        managedPaths: ['.agent-workflows'],
+    });
+    return {
+        allowedRoot,
+        filePath: path.join(allowedRoot, '.agent-workflows', 'plugin-intents.json'),
+    };
+}
+async function readPluginIntentStateObservationUnsafe(location) {
+    resolvePluginIntentStatePath(location, 'read');
+    const { allowedRoot, filePath } = await resolveIntentLocation(location);
+    if (!await assertReadableIntentPath(allowedRoot, filePath)) {
+        return { state: 'absent' };
+    }
+    let value;
+    try {
+        value = JSON.parse(await fs.readFile(filePath, 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error('Invalid plugin intent state JSON.');
+        }
+        throw error;
+    }
+    return { state: 'ready', value: parsePluginIntentState(value) };
+}
+function invalidIntentPathError(error) {
+    if (!(error instanceof Error))
+        return false;
+    return /(?:symbolic link|regular (?:directory|file)|escapes its allowed root|符号链接|realpath 越界|必须位于 repo 内)/iu
+        .test(error.message);
+}
+export async function observePluginIntentState(location) {
+    try {
+        return await readPluginIntentStateObservationUnsafe(location);
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError')
+            throw error;
+        const invalid = invalidIntentPathError(error)
+            || error instanceof SyntaxError
+            || error instanceof Error && /^Invalid (?:plugin intent|roots|dependencyScopeOverrides)/u.test(error.message);
+        return invalid ? {
+            state: 'invalid',
+            code: 'pluginIntentStateInvalid',
+            message: '插件声明格式无效或路径不安全。',
+        } : {
+            state: 'unavailable',
+            code: 'pluginIntentStateUnavailable',
+            message: '无法读取插件声明。',
+        };
+    }
+}
+export async function readPluginIntentState(location) {
+    const observation = await readPluginIntentStateObservationUnsafe(location);
+    return observation.state === 'ready' ? observation.value : createEmptyPluginIntentState();
+}
+export async function writePluginIntentState(location, state) {
+    const requestedPath = resolvePluginIntentStatePath(location, 'write');
+    if (location.scope === 'project') {
+        await assertProjectSharedConfigPathVisible({ cwd: location.cwd, targetPath: requestedPath });
+    }
+    const { allowedRoot, filePath } = await resolveIntentLocation(location);
+    const canonical = canonicalizePluginIntentState(state);
+    await atomicReplaceConfigFile({
+        filePath,
+        allowedRoot,
+        content: serializePluginIntentState(canonical),
+    });
+    return canonical;
+}
+//# sourceMappingURL=plugin-intent-state.js.map

package/dist/src/utils/plugin-intent-state.js.map

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

package/dist/src/utils/plugin-scripts.d.ts

@@ -1,118 +1,56 @@
+import { spawn } from 'node:child_process';
 import type { CommandExecutionContext } from '../commands/runtime.js';
-import type { GeneratedArtifact, PlatformName, DistributionName, PluginLifecycleEvent, PluginLifecycleRuntimeOs, PluginLifecycleScriptEntry, NormalizedPluginManifest, PluginMeta, Scope } from '../types.js';
-export { calculateFileDigest, calculatePluginBundleFingerprint, } from './bundle-integrity.js';
-export type LifecycleScriptTargetSource = 'currentCatalog' | 'none';
-export interface LifecycleScriptTarget {
-    noOp: boolean;
-    source: LifecycleScriptTargetSource;
-    entry?: PluginLifecycleScriptEntry;
-    entryPath?: string;
-    bundleRoot?: string;
-    sourceManifest?: NormalizedPluginManifest;
-    manifestPath?: string;
-    manifestDigest?: string;
-    warnings: string[];
-}
-export interface ResolveLifecycleScriptTargetOptions {
-    event: PluginLifecycleEvent;
-    pluginName: string;
-    platform: PlatformName;
-    currentPlugin?: PluginMeta;
-    cwd: string;
-    env?: NodeJS.ProcessEnv;
-    runtimeOs?: PluginLifecycleRuntimeOs;
-}
-export interface LifecycleScriptContext {
-    event: PluginLifecycleEvent | 'test';
-    plugin: {
-        name: string;
-        version: string;
-        rootDir: string;
-        sourceId?: string;
-        sourceIdentity?: string;
-        pluginId?: string;
-    };
-    platform: PlatformName;
-    scope: Scope;
-    cwd: string;
-    paths: {
-        awHome: string;
-        codexHome: string;
-        claudeHome: string;
-        manifestPath: string;
-        configStores?: {
-            user: string;
-            project: string;
-            projectLocal: string;
-        };
-    };
-    config: {
-        schema?: NonNullable<NormalizedPluginManifest['config']>['schema'];
-        values: Record<string, string | number | boolean>;
-        sources: Record<string, string>;
-        issues: unknown[];
-    };
-    script: {
-        runner: PluginLifecycleScriptEntry['runner'];
-        path: string;
-        args: string[];
-        source: LifecycleScriptTargetSource;
-        manifestDigest: string;
-    };
-    artifacts: GeneratedArtifact[];
-}
-export interface WrittenLifecycleScriptContext {
-    context: LifecycleScriptContext;
-    contextPath: string;
-    tempDir: string;
-    sensitiveValues: string[];
-    cleanup: () => Promise<void>;
-}
-export interface LifecycleScriptInvocation {
+import type { DistributionName, NormalizedPluginManifest, PlatformName, PluginConfigValue, PluginMeta, Scope } from '../types.js';
+import { observeProcessTree, terminateProcessTree, type WindowsJobInvocation } from './process-tree.js';
+export { calculateFileDigest } from './bundle-integrity.js';
+export declare const PLUGIN_SCRIPT_TIMEOUT_DEFAULT_MS = 300000;
+export declare const PLUGIN_SCRIPT_TIMEOUT_MIN_MS = 1000;
+export declare const PLUGIN_SCRIPT_TIMEOUT_MAX_MS = 1800000;
+export interface PluginScriptInvocation {
     command: string;
     args: string[];
     cwd: string;
     env: NodeJS.ProcessEnv;
+    stdin?: string;
 }
-export interface LifecycleProcessResult {
+export interface PluginProcessResult {
     exitCode: number | null;
     signal: NodeJS.Signals | null;
     stdout: string;
     stderr: string;
     timedOut: boolean;
 }
-export interface LifecycleProcessRunner {
-    run(invocation: LifecycleScriptInvocation, options: {
+export interface PluginProcessRunner {
+    run(invocation: PluginScriptInvocation, options: {
         timeoutMs: number;
         signal?: AbortSignal;
-    }): Promise<LifecycleProcessResult>;
+    }): Promise<PluginProcessResult>;
+}
+interface DefaultPluginProcessRunOptions {
+    timeoutMs: number;
+    signal?: AbortSignal;
+    sensitiveValues?: readonly string[];
 }
-export interface RunLifecycleScriptResult {
-    executed: boolean;
-    target: LifecycleScriptTarget;
-    exitCode?: number | null;
-    signal?: NodeJS.Signals | null;
-    stdout?: string;
-    stderr?: string;
-    timedOut?: boolean;
+/** @internal Test-only dependency seam. It is not exported from the package entrypoint. */
+interface DefaultPluginProcessRunnerDependencies {
+    platform?: NodeJS.Platform;
+    spawn?: typeof spawn;
+    observeProcessTree?: typeof observeProcessTree;
+    terminateProcessTree?: typeof terminateProcessTree;
+    createWindowsJobInvocation?: (executable: string, args: readonly string[]) => WindowsJobInvocation;
 }
 export declare function resolveBundledPluginFilePath(options: {
     bundleRoot: string;
     pluginRelativePath: string;
     fieldName: string;
 }): Promise<string>;
-export declare function resolveLifecycleScriptTarget(options: ResolveLifecycleScriptTargetOptions): Promise<LifecycleScriptTarget>;
-export declare function quoteCmdArgument(value: string): string;
-export declare function buildLifecycleScriptInvocation(options: {
-    entry: PluginLifecycleScriptEntry;
+export declare function buildNodeScriptInvocation(options: {
     entryPath: string;
     cwd: string;
     env: NodeJS.ProcessEnv;
-}): LifecycleScriptInvocation;
-export declare function resolveLifecycleScriptTimeoutMs(options: {
-    cliTimeoutMs?: number;
-    manifest?: NormalizedPluginManifest;
-}): number;
+    args?: string[];
+    stdin?: string;
+}): PluginScriptInvocation;
 export declare function buildPluginScriptSpawnEnv(options: {
     commandEnv: NodeJS.ProcessEnv;
     contextPath: string;
@@ -126,47 +64,46 @@ export declare function buildPluginScriptSpawnEnv(options: {
     distribution?: DistributionName;
     scope: Scope;
     bundleRoot: string;
-    runtimeOs?: PluginLifecycleRuntimeOs;
 }): NodeJS.ProcessEnv;
-export declare function buildLifecycleSpawnEnv(options: {
-    commandEnv: NodeJS.ProcessEnv;
-    contextPath: string;
-    tempDir: string;
+export declare function resolvePluginScriptTimeoutMs(options: {
+    cliTimeoutMs?: number;
+    manifestTimeoutMs?: number;
+}): number;
+export declare function collectSensitivePluginConfigValues(manifest: NormalizedPluginManifest, values: Record<string, PluginConfigValue>): string[];
+export declare function assertNoSensitiveConfigValues(value: unknown, sensitiveValues: readonly string[], message: string): void;
+export declare function assertNoSensitiveConfigInFiles(files: Readonly<Record<string, Buffer>>, sensitiveValues: readonly string[], message: string): void;
+export declare function redactPluginScriptOutput(value: string, sensitiveValues: readonly string[]): string;
+export declare function truncatePluginScriptOutput(value: string): string;
+export declare function summarizePluginScriptOutput(value: string, sensitiveValues: readonly string[]): string;
+export declare function createDefaultPluginProcessRunner(dependencies?: DefaultPluginProcessRunnerDependencies): {
+    run(invocation: PluginScriptInvocation, options: DefaultPluginProcessRunOptions): Promise<PluginProcessResult>;
+};
+export declare const defaultPluginProcessRunner: {
+    run(invocation: PluginScriptInvocation, options: DefaultPluginProcessRunOptions): Promise<PluginProcessResult>;
+};
+export interface PreApplyContextV1 {
+    schemaVersion: 1;
     plugin: {
+        pluginId: string;
         name: string;
         version: string;
+        rootDir: string;
     };
-    event: PluginLifecycleEvent | 'test';
-    platform: PlatformName;
-    scope: Scope;
-    bundleRoot: string;
-    runtimeOs?: PluginLifecycleRuntimeOs;
-}): NodeJS.ProcessEnv;
-export declare function collectSensitivePluginConfigValues(manifest: NormalizedPluginManifest, values: Record<string, string | number | boolean>): string[];
-export declare function redactPluginScriptOutput(value: string, sensitiveValues: readonly string[]): string;
-export declare function summarizePluginScriptOutput(value: string, sensitiveValues: readonly string[]): string;
-export declare function writeLifecycleScriptContext(options: {
-    sourceId?: string;
-    sourceIdentity?: string;
-    target: LifecycleScriptTarget;
-    event: PluginLifecycleEvent | 'test';
-    platform: PlatformName;
-    scope: Scope;
-    cwd: string;
-    commandEnv: NodeJS.ProcessEnv;
-    artifacts?: GeneratedArtifact[];
-}): Promise<WrittenLifecycleScriptContext>;
-export declare const defaultPluginProcessRunner: LifecycleProcessRunner;
-export declare function runLifecycleScript(options: {
-    event: PluginLifecycleEvent;
-    pluginName: string;
+    target: {
+        platform: PlatformName;
+        scope: Scope;
+        projectRoot?: string;
+    };
+    config: {
+        values: Record<string, PluginConfigValue>;
+    };
+}
+export declare function runPreApplyScript(options: {
+    plugin: PluginMeta;
     platform: PlatformName;
     scope: Scope;
     cwd: string;
     context: CommandExecutionContext;
-    currentPlugin?: PluginMeta;
-    artifacts?: GeneratedArtifact[];
     scriptTimeoutMs?: number;
-    runner?: LifecycleProcessRunner;
-    runtimeOs?: PluginLifecycleRuntimeOs;
-}): Promise<RunLifecycleScriptResult>;
+    runner?: PluginProcessRunner;
+}): Promise<void>;