@loucompanion/forge-bridge 0.1.3-dev.ba7d36726eda → 0.1.3-dev.bca7d0ccee53

package/dist/session/provider-cli/provider-cli.process.js

@@ -163,19 +163,11 @@ export class StreamingProviderProcessRunner {
                 reject(new Error("Provider process stdout/stderr streams were not piped."));
                 return;
             }
-            try {
-                if (supervisedLaunch) {
-                    persistHostProcessSupervisorMetadata(supervisedLaunch, request, child.pid ?? 0, rootCreatedAt);
-                }
-            }
-            catch (error) {
-                void terminate();
-                reject(error);
-                return;
-            }
             let stdout = "";
             let stderr = "";
             let settled = false;
+            let closed = false;
+            let readiness = null;
             const cleanup = () => {
                 signal?.removeEventListener("abort", abort);
             };
@@ -185,11 +177,14 @@ export class StreamingProviderProcessRunner {
                 }
                 settled = true;
                 cleanup();
-                void terminate();
+                void terminate().catch(() => undefined);
                 reject(error);
             };
             const abort = () => {
-                void terminate();
+                // Cancellation is not a launch failure when the supervised tree can be
+                // proven stopped. Let the close handler settle the command after exact
+                // termination; only a failed termination proof rejects the run.
+                void terminate().catch(fail);
             };
             if (signal?.aborted) {
                 abort();
@@ -198,7 +193,27 @@ export class StreamingProviderProcessRunner {
                 signal?.addEventListener("abort", abort, { once: true });
             }
             child.on("error", fail);
-            if (request.stdin !== undefined) {
+            child.once("spawn", () => {
+                readiness = (async () => {
+                    const providerReady = supervisedLaunch?.strategy === "windows_job_object"
+                        ? await waitForWindowsProviderReady(supervisedLaunch, signal, () => closed)
+                        : undefined;
+                    if (supervisedLaunch) {
+                        persistHostProcessSupervisorMetadata(supervisedLaunch, request, child.pid ?? 0, rootCreatedAt, providerReady);
+                    }
+                    await handlers.onStarted?.();
+                    if (supervisedLaunch?.strategy === "windows_job_object") {
+                        grantWindowsProviderStart(supervisedLaunch);
+                    }
+                })();
+                void readiness.catch(error => {
+                    if (!closed && !signal?.aborted)
+                        fail(error);
+                });
+            });
+            const writeProviderInput = () => {
+                if (request.stdin === undefined)
+                    return;
                 if (!child.stdin) {
                     void terminate();
                     fail(new Error("Provider process stdin stream was not piped."));
@@ -209,6 +224,18 @@ export class StreamingProviderProcessRunner {
                     fail(error);
                 });
                 child.stdin.end(request.stdin, "utf8");
+            };
+            if (request.stdin !== undefined) {
+                if (supervisedLaunch?.strategy === "windows_job_object") {
+                    // The outer supervisor must receive stdin before it can launch the
+                    // inner provider. Its start-grant file prevents prompt delivery.
+                    writeProviderInput();
+                }
+                else {
+                    child.once("spawn", () => {
+                        void readiness?.then(writeProviderInput).catch(fail);
+                    });
+                }
             }
             const readers = [
                 readProcessLines(childStdout, (line) => {
@@ -223,7 +250,9 @@ export class StreamingProviderProcessRunner {
                 })
             ];
             child.on("close", (code) => {
+                closed = true;
                 Promise.allSettled(readers).then(async (readerResults) => {
+                    await readiness?.catch(() => undefined);
                     const rejected = readerResults.find((result) => result.status === "rejected");
                     if (rejected?.status === "rejected") {
                         fail(rejected.reason);
@@ -232,11 +261,17 @@ export class StreamingProviderProcessRunner {
                     if (settled) {
                         return;
                     }
-                    if (supervisedLaunch?.strategy === "unix_process_group") {
-                        await terminate();
+                    try {
+                        if (supervisedLaunch?.strategy === "unix_process_group") {
+                            await terminate();
+                        }
+                        else if (termination) {
+                            await termination;
+                        }
                     }
-                    else if (termination) {
-                        await termination;
+                    catch (error) {
+                        fail(error);
+                        return;
                     }
                     settled = true;
                     cleanup();
@@ -262,7 +297,58 @@ async function resolveProviderProcessLaunch(command, args) {
     if (!resolved) {
         return { command, args };
     }
-    return resolveCodexNpmDirectLaunch(resolved, args) ?? buildWindowsLaunchCommand(resolved, args);
+    return resolveCodexNpmDirectLaunch(resolved, args)
+        ?? resolvePackageManagerDirectLaunch(resolved, args)
+        ?? buildWindowsLaunchCommand(resolved, args);
+}
+function grantWindowsProviderStart(launch) {
+    if (!launch.startGrantPath) {
+        throw new Error("host_process_supervisor_invalid: Windows provider start-grant path was not assigned.");
+    }
+    fs.writeFileSync(launch.startGrantPath, "granted\n", {
+        encoding: "utf8",
+        flag: "wx",
+        mode: 0o600,
+    });
+}
+async function waitForWindowsProviderReady(launch, signal, isClosed) {
+    const readyPath = launch.readyPath;
+    if (!readyPath) {
+        throw new Error("host_process_supervisor_invalid: Windows provider-ready path was not assigned.");
+    }
+    while (true) {
+        try {
+            const parsed = JSON.parse(await fs.promises.readFile(readyPath, "utf8"));
+            if (parsed.schemaVersion !== 1
+                || parsed.supervisorId !== launch.supervisorId
+                || !Number.isSafeInteger(parsed.rootPid)
+                || (parsed.rootPid ?? 0) <= 0
+                || typeof parsed.rootIdentity !== "string"
+                || !/^win32:\d+$/u.test(parsed.rootIdentity)
+                || !Number.isSafeInteger(parsed.providerPid)
+                || (parsed.providerPid ?? 0) <= 0
+                || typeof parsed.providerCreatedAt !== "string"
+                || Number.isNaN(Date.parse(parsed.providerCreatedAt))
+                || (parsed.providerIdentity !== undefined
+                    && (typeof parsed.providerIdentity !== "string" || !/^win32:\d+$/u.test(parsed.providerIdentity)))
+                || !Number.isSafeInteger(parsed.startAttempt)
+                || (parsed.startAttempt ?? 0) < 1) {
+                throw new Error("host_process_supervisor_invalid: provider-ready receipt was invalid.");
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        if (isClosed()) {
+            throw new Error("host_process_supervisor_start_failed: supervisor exited before the provider became ready.");
+        }
+        if (signal?.aborted) {
+            throw signal.reason instanceof Error ? signal.reason : new Error("Provider process launch was aborted.");
+        }
+        await new Promise(resolve => setTimeout(resolve, 25));
+    }
 }
 export function resolveCodexNpmDirectLaunch(commandPath, args) {
     const extension = path.extname(commandPath).toLowerCase();
@@ -275,10 +361,48 @@ export function resolveCodexNpmDirectLaunch(commandPath, args) {
         ? { command: process.execPath, args: [entryPoint, ...args] }
         : null;
 }
+/**
+ * Avoids cmd.exe's nested-quote handling for package-manager shims. That
+ * quoting loses executable paths containing spaces after the command is
+ * wrapped by the Windows Job Object supervisor.
+ */
+export function resolvePackageManagerDirectLaunch(commandPath, args) {
+    const extension = path.extname(commandPath).toLowerCase();
+    if (extension !== ".cmd" && extension !== ".ps1")
+        return null;
+    const packageManager = path.basename(commandPath, extension).toLowerCase();
+    if (!["npm", "npx", "pnpm", "pnpx", "yarn", "yarnpkg"].includes(packageManager))
+        return null;
+    const root = path.dirname(commandPath);
+    const candidates = [
+        path.join(root, "node_modules", "corepack", "dist", `${packageManager}.js`),
+        ...(packageManager === "npm" || packageManager === "npx"
+            ? [path.join(root, "node_modules", "npm", "bin", `${packageManager}-cli.js`)]
+            : []),
+        ...(packageManager === "pnpm" || packageManager === "pnpx"
+            ? [path.join(root, "node_modules", "pnpm", "bin", `${packageManager}.cjs`)]
+            : []),
+        ...(packageManager === "yarn" || packageManager === "yarnpkg"
+            ? [path.join(root, "node_modules", "yarn", "bin", "yarn.js")]
+            : []),
+    ];
+    const entryPoint = candidates.find(candidate => fs.existsSync(candidate));
+    if (!entryPoint)
+        return null;
+    const adjacentNode = path.join(root, "node.exe");
+    return {
+        command: fs.existsSync(adjacentNode) ? adjacentNode : process.execPath,
+        args: [entryPoint, ...args],
+    };
+}
 async function resolveWindowsCommand(command) {
     if (path.isAbsolute(command)) {
         return command;
     }
+    const resolvedFromPath = resolveWindowsCommandFromPath(command);
+    if (resolvedFromPath) {
+        return resolvedFromPath;
+    }
     try {
         const result = await execFileAsync("where.exe", [command], { timeout: 2000 });
         return chooseWindowsCommandCandidate(result.stdout.split(/\r?\n/));
@@ -287,6 +411,40 @@ async function resolveWindowsCommand(command) {
         return null;
     }
 }
+/**
+ * Resolves Windows commands without spawning where.exe. Runtime launches can
+ * happen while the machine is under enough process pressure for where.exe to
+ * miss its timeout; returning the unresolved package-manager name in that case
+ * makes Node fall back to a shell shim that cannot survive Job Object wrapping.
+ */
+export function resolveWindowsCommandFromPath(command, pathValue = process.env.PATH ?? "", pathExtValue = process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD") {
+    if (!command || path.isAbsolute(command) || command.includes("/") || command.includes("\\")) {
+        return null;
+    }
+    const hasExtension = path.extname(command).length > 0;
+    const extensions = hasExtension
+        ? [""]
+        : [...new Set([
+                "",
+                ".exe",
+                ".ps1",
+                ".cmd",
+                ".bat",
+                ...pathExtValue.split(";").map(value => value.trim().toLowerCase()).filter(Boolean),
+            ])];
+    const candidates = [];
+    for (const rawDirectory of pathValue.split(path.delimiter)) {
+        const directory = rawDirectory.trim().replace(/^"|"$/gu, "");
+        if (!directory)
+            continue;
+        for (const extension of extensions) {
+            const candidate = path.join(directory, `${command}${extension}`);
+            if (fs.existsSync(candidate))
+                candidates.push(candidate);
+        }
+    }
+    return chooseWindowsCommandCandidate(candidates);
+}
 export function chooseWindowsCommandCandidate(candidates) {
     const normalized = candidates
         .map((candidate) => candidate.trim())

package/dist/session/provider-cli/provider-cli.prompts.js

@@ -212,6 +212,8 @@ export function buildProviderCliPrompt(dispatch, prompt, runtimeEnvironment) {
 - \`FORGE_RUNTIME_MODE=host\`, \`FORGE_RESOURCE_LEASE_ID\`, and \`FORGE_DISPATCH_ATTEMPT_ID\` identify the fenced runtime lease. \`FORGE_WORKTREE_PATH\` identifies the prepared repository root.
 ${concurrency}
 - Forge owns this attempt's process tree through \`FORGE_PROCESS_SUPERVISOR_ID\`. Do not detach, adopt pre-existing servers, or kill processes by name or port; cancellation and teardown are supervisor-owned.
+- Prefer \`forge.start_managed_verification\` for Forge .NET tiers or the solution suite so the runner owns cwd, arguments, isolated output, timeout, and supervision. Use \`forge.start_managed_command\` only for other commands expected to run longer than two minutes. Continue independent work, then call \`forge.wait_managed_command\` once for its terminal receipt; do not poll \`forge.get_managed_command\`. Forge keeps live progress in its durable UI receipt and returns one terminal result; its timeout terminates and verifies the exact attempt-owned process tree. Do not run those commands through the generic shell tool.
+- If a tool creates \`TestResults\`, \`test-results\`, or \`playwright-report\` beneath source, use \`forge.reset_generated_outputs\` to quarantine only those untracked generated directories. Do not issue a recursive delete.
 - Use the attempt-scoped \`FORGE_TMPDIR\`, \`FORGE_LOG_DIR\`, \`FORGE_CACHE_DIR\`, \`FORGE_BROWSER_PROFILE_DIR\`, and \`FORGE_TEST_OUTPUT_DIR\` paths instead of shared host paths.
 - Use supplied \`FORGE_*\` URLs, ports, and paths. Do not search for a free port, kill a process occupying one, or reuse an existing dev server, browser profile, database, container, network, or volume.
 - Never run broad process or Docker cleanup. Stop only resources you created for this resource lease.${playwright}`;
@@ -421,13 +423,13 @@ export function qaBrowserInstruction(dispatch) {
         : "";
     const launchTarget = qaBrowser.launchTarget;
     if (qaBrowser.required && !hasLaunchTarget(launchTarget ?? null)) {
-        return `Browser/app launch context:\n- UI/browser QA is required for this item by ${scopeAuthority}.\n- No configured app launch target was provided.${scopeEvidence}${playwrightPolicy}\n- If a managed or repository-owned Playwright workflow successfully exercises the affected UI, record both its passing command and browser_checks evidence. Otherwise return blocked with blocker_reason: missing_app_launch_target instead of pretending browser testing occurred.\n- Artifact sidecars path when available: ${qaBrowser.artifactsPath || `.forge/work-items/${dispatch.workItem.id}/artifacts/qa`}`;
+        return `Browser/app launch context:\n- UI/browser QA is required for this item by ${scopeAuthority}.\n- No configured app launch target was provided.${scopeEvidence}${playwrightPolicy}\n- If a managed or repository-owned Playwright workflow successfully exercises the affected UI, record both its passing command and browser_checks evidence. Otherwise return blocked with blocker_reason: missing_app_launch_target instead of pretending browser testing occurred.\n- Artifact sidecars path when available: ${qaSidecarRoot(dispatch)}`;
     }
     if (!launchTarget) {
-        return `Browser/app launch context:\n- UI/browser QA is not required by ${scopeAuthority} for this item.\n- If the diff or acceptance criteria require browser testing, use a managed or repository-owned Playwright workflow when available; otherwise return blocked with blocker_reason: missing_app_launch_target.${scopeEvidence}${playwrightPolicy}\n- Browser sidecars path: ${qaBrowser.artifactsPath || `.forge/work-items/${dispatch.workItem.id}/artifacts/qa`}`;
+        return `Browser/app launch context:\n- UI/browser QA is not required by ${scopeAuthority} for this item.\n- If the diff or acceptance criteria require browser testing, use a managed or repository-owned Playwright workflow when available; otherwise return blocked with blocker_reason: missing_app_launch_target.${scopeEvidence}${playwrightPolicy}\n- Browser sidecars path: ${qaSidecarRoot(dispatch)}`;
     }
     const routes = launchTarget.routes.length > 0 ? launchTarget.routes.join(", ") : "not specified";
-    return `Browser/app launch context:\n- Browser QA required: ${qaBrowser.required ? `yes, by ${scopeAuthority}` : `no by ${scopeAuthority}, unless the diff/AC requires it`}\n- URL: ${launchTarget.url || "not specified"}\n- Ready URL: ${launchTarget.ready_url || "not specified"}\n- Launch command: ${launchTarget.command || "not specified"}\n- Working directory: ${launchTarget.working_directory || "repo root"}\n- Routes to cover: ${routes}\n- Notes: ${launchTarget.notes || "none"}${scopeEvidence}${playwrightPolicy}\n- Browser sidecars path: ${qaBrowser.artifactsPath || `.forge/work-items/${dispatch.workItem.id}/artifacts/qa`}`;
+    return `Browser/app launch context:\n- Browser QA required: ${qaBrowser.required ? `yes, by ${scopeAuthority}` : `no by ${scopeAuthority}, unless the diff/AC requires it`}\n- URL: ${launchTarget.url || "not specified"}\n- Ready URL: ${launchTarget.ready_url || "not specified"}\n- Launch command: ${launchTarget.command || "not specified"}\n- Working directory: ${launchTarget.working_directory || "repo root"}\n- Routes to cover: ${routes}\n- Notes: ${launchTarget.notes || "none"}${scopeEvidence}${playwrightPolicy}\n- Browser sidecars path: ${qaSidecarRoot(dispatch)}`;
 }
 export function storyQaInstruction(dispatch) {
     const storyQa = dispatch.storyQa;
@@ -463,6 +465,8 @@ ${finalQa}
 This is parent Story QA: inspect the integrated Story result, all current-plan child specs/evidence, and the final worktree state. Do not treat the final child task as separately signed off.`;
 }
 export function buildQaPrompt(dispatch, laneSpec) {
+    const sidecarRoot = qaSidecarRoot(dispatch);
+    const artifactRoot = sidecarRoot.replace(/\/qa\/?$/i, "");
     return `You are Forge's QA lane running locally in a prepared git worktree.
 
 First read and follow the injected QA lane command at .forge/work-items/${dispatch.workItem.id}/spec.md. It defines the required gated QA skill workflow for this run.
@@ -487,18 +491,28 @@ System info / environment notes:
 ${dispatch.workItem.systemInfo || "Not provided."}
 
 ${storyQaInstruction(dispatch)}
-Inspect the validated implementation and Forge artifacts under .forge/work-items/${dispatch.workItem.id}/artifacts/ when present, especially implementation, self-review, and validation evidence.
+Inspect the validated implementation evidence referenced by the dispatch and the owner-scoped QA artifacts under ${artifactRoot}/ when present.
 ${qaBrowserInstruction(dispatch)}
 ${qaReworkRetestInstruction(dispatch)}
 QA is read-mostly: inspect code, run commands, and exercise browser/app flows when available, but do not edit product source or tests.
-Record concrete evidence. For UI/browser work, include browser_checks with URLs/routes, actions, observed results, screenshots/traces when available, console errors, failed network requests, and responsive checks. Store browser sidecars under .forge/work-items/${dispatch.workItem.id}/artifacts/qa/.
+Record concrete evidence. For UI/browser work, include browser_checks with URLs/routes, actions, observed results, screenshots/traces when available, console errors, failed network requests, and responsive checks. Store browser sidecars under ${sidecarRoot}/.
 Report in-scope defects as actionable findings with repro steps, expected/actual behavior, evidence, likely area, required fix, and required regression.
-Out-of-scope or follow-up issues belong in candidate_bugs instead of blocking the current item.
+Out-of-scope or follow-up issues belong in candidate_bugs instead of blocking the current item. If a broad regression command fails only on a surface outside both the current diff and acceptance criteria, reproduce that failure with a focused command. The regression gate may pass only when the current item has independent passing evidence and the failed command is preserved with classification out_of_scope_failure, candidate_bug_id, scope_evidence, acceptance_criteria_independent: true, repro_command, and a non-zero repro_exit_code. Never use this classification for an unexplained failure, a runner/environment failure, or a failure that can affect the current item.
 
-${completionPromptForQaCycle()}
+${completionPromptForQaCycle("qa_plan", artifactRoot)}
 
 Finish with a concise summary only after forge.complete_qa_verdict accepts the QA bundle.`;
 }
+function qaSidecarRoot(dispatch) {
+    const configured = dispatch.qaBrowser?.artifactsPath?.trim().replace(/\\/g, "/").replace(/\/+$/, "");
+    if (configured) {
+        return configured;
+    }
+    const ownerType = dispatch.cycleRun.ownerType?.trim().toLowerCase();
+    const ownerId = dispatch.cycleRun.ownerId?.trim() || dispatch.workItem.id;
+    const ownerDirectory = ownerType === "story" ? "stories" : "work-items";
+    return `.forge/${ownerDirectory}/${ownerId}/artifacts/qa`;
+}
 export function buildConflictResolvePrompt(dispatch, branchName) {
     const targetBranch = dispatch.cycleRun.requestedBase || dispatch.repo.defaultBranch || "main";
     return `You are Forge's Conflict Resolve lane running locally in a prepared git worktree.
@@ -532,12 +546,20 @@ This is not a merge-conflict resolution task. Only fetch/merge/rebase ${targetBr
 
 Load and follow .forge/commands/operational/ci-repair-prompt.md, including its CI repair phase gate and validation skill. Inspect the failed provider check logs, identify the exact failed workflow job/step, make the smallest scoped repair, and before pushing run the failed job's local workflow-equivalent gate, including pre-test guard/drift steps when available.
 
+Forge prepared two required inputs before this agent started:
+- Approved spec: .forge/work-items/${dispatch.workItem.id}/spec.md
+- Readiness contract: .forge/work-items/${dispatch.workItem.id}/ci-repair.readiness.json
+
+Read both first. The readiness contract supplies attempt-scoped E2E URLs, Playwright/browser readiness, and any provider-only local-equivalence classifications. A provider-only step is not permission to weaken CI; record why it cannot run inside the managed attempt and leave provider CI authoritative.
+
+After repair and validation, call forge.complete_ci_repair with the complete structured handoff. Forge Bridge will validate it and will not commit, push, or report success until that gate passes. If the tool rejects the payload, correct the exact missing evidence it reports and call it again.
+
 Keep the original work item intent intact:
 - Work item: ${dispatch.workItem.id}
 - Title: ${dispatch.workItem.title}
 - Acceptance criteria: ${dispatch.workItem.acceptanceCriteria || "Not specified"}
 
-Finish with a concise summary of failing checks, changed files, validation commands, pushed commit status, and any remaining provider checks still pending.`;
+Forge Bridge owns the final commit and push after the completion gate succeeds. Finish with a concise summary of failing checks, changed files, validation commands, and remaining provider checks.`;
 }
 export function buildPullRequestCommentsPrompt(dispatch, branchName) {
     const pr = dispatch.pullRequest;

package/dist/session/provider-cli/provider-cli.qa-sidecars.js

@@ -4,6 +4,7 @@ import path from "node:path";
 export function hasLaunchTarget(target) {
     return Boolean(target?.url?.trim()
         || target?.ready_url?.trim()
+        || target?.managed_runtime_port?.trim()
         || target?.command?.trim()
         || (target?.routes ?? []).some((route) => route.trim().length > 0));
 }

package/dist/session/provider-cli/provider-cli.service.d.ts

@@ -1,12 +1,27 @@
 import { GitClient } from "../../shared/git/git.js";
+import type { WorktreeLifecycleCoordinator } from "../../worktree/worktree.base.js";
+import type { RunnerDispatchEvent } from "../session.types.js";
 import type { ProviderCliService } from "./provider-cli.base.js";
 import type { ProviderCliDraftContext, ProviderCliRunContext, ProviderCliRunResult } from "./provider-cli.types.js";
 import { type ProviderProcessRunner } from "./provider-cli.process.js";
 export { DeterministicProviderCliService } from "./provider-cli.deterministic.js";
 export { buildProviderCliCommand, codexSandboxModeForPlatform, formatProviderCliCommand, formatProviderCliCommandForCheckpoint } from "./provider-cli.prompts.js";
-export { buildProviderChildEnvironment, chooseWindowsCommandCandidate, resolveCodexNpmDirectLaunch, StreamingProviderProcessRunner } from "./provider-cli.process.js";
+export { buildProviderChildEnvironment, chooseWindowsCommandCandidate, resolveCodexNpmDirectLaunch, resolvePackageManagerDirectLaunch, resolveWindowsCommandFromPath, StreamingProviderProcessRunner } from "./provider-cli.process.js";
 export { buildWindowsLaunchCommand } from "../../shared/process/windows-launch.js";
 export type { ProviderCliCommand, ProviderProcessRunner, ProviderProcessRunRequest, ProviderProcessRunResult } from "./provider-cli.process.js";
+export declare class ManagedVerificationProgressEmitter {
+    private readonly logDirectory;
+    private readonly emit;
+    private readonly intervalMs;
+    private timer;
+    private readonly observedStatuses;
+    private readonly completedCommands;
+    constructor(logDirectory: string | undefined, emit: (event: RunnerDispatchEvent) => Promise<void>, intervalMs?: number);
+    start(): void;
+    stop(): Promise<void>;
+    private scan;
+    private emitTransition;
+}
 export declare class RoutingProviderCliService implements ProviderCliService {
     private readonly realProvider;
     private readonly deterministicProvider;
@@ -21,7 +36,9 @@ export declare class RoutingProviderCliService implements ProviderCliService {
 export declare class ProcessBackedProviderCliService implements ProviderCliService {
     private readonly processRunner;
     private readonly git;
-    constructor(processRunner?: ProviderProcessRunner, git?: GitClient);
+    private readonly providerToolHeartbeatIntervalMs;
+    private readonly publicationCoordinator;
+    constructor(processRunner?: ProviderProcessRunner, git?: GitClient, providerToolHeartbeatIntervalMs?: number, publicationCoordinator?: WorktreeLifecycleCoordinator);
     runDraft(context: ProviderCliDraftContext): Promise<ProviderCliRunResult>;
     runImplementation(context: ProviderCliRunContext): Promise<ProviderCliRunResult>;
     runArchitect(context: ProviderCliRunContext): Promise<ProviderCliRunResult>;