@ohos-ports/nx 23.2.1-beta.0 → 23.3.0-beta.0

package/dist/src/command-line/migrate/run/orchestrator.d.ts

@@ -0,0 +1,78 @@
+import { type MigrateRunPolicy, type MigrateRunState } from './run-state';
+import { type StepAction } from './state-machine';
+import { type PlannedMigration } from '../migration-shape';
+import { type ExistingRunFacts } from './existing-run-report';
+export interface RunOrchestratorInitInput {
+    root: string;
+    migrationsJson: {
+        migrations?: PlannedMigration[];
+        [k: string]: unknown;
+    };
+    migrationsPath?: string;
+    createCommits: boolean;
+    commitPrefix: string;
+    skipInstall: boolean;
+    installedNxVersion: string;
+    validate: boolean | undefined;
+    finalValidation: boolean | undefined;
+    emitAgentInstructions?: boolean;
+    onExistingRun?: 'report' | 'start-fresh';
+    replaceRunId?: string;
+    confirmStart?: () => Promise<boolean>;
+}
+export type OrchestratorInitResult = {
+    kind: 'ready';
+    runId: string;
+    runRoot: string;
+    runbookPath: string;
+    reconcileCommand: string;
+} | {
+    kind: 'refused';
+} | {
+    kind: 'existing-run';
+    runId: string;
+    facts: ExistingRunFacts;
+};
+export interface RunOrchestratorResumeInput {
+    root: string;
+    runId: string;
+    policy: MigrateRunPolicy;
+    emitAgentInstructions?: boolean;
+}
+export interface RunOrchestratorReconcileInput {
+    root: string;
+    runId: string;
+    stepAction?: StepAction;
+}
+export declare function runOrchestratorInit(input: RunOrchestratorInitInput): Promise<OrchestratorInitResult>;
+/**
+ * Continues the active run `runId` names: the `--run-migrations --run-id`
+ * shape on both paths. Refuses as holdRunToContinue does.
+ */
+export declare function runOrchestratorResume(input: RunOrchestratorResumeInput): OrchestratorInitResult;
+/**
+ * Holds the active run `runId` names and returns its state. A continue calls
+ * this before the install and the agent selection: a concurrent start-fresh
+ * must not delete the run meanwhile. Throws when the id names no run or a
+ * finished one, and while another process holds the run: continuing would
+ * open a second session over a live one. Under WASM nothing is held and no
+ * holder refuses.
+ */
+export declare function holdRunToContinue(root: string, runId: string): MigrateRunState;
+export declare function activeRunToReplace(root: string, runId: string | undefined): {
+    runId: string;
+    state: MigrateRunState;
+};
+/**
+ * Drops the hold holdRunToContinue took, for a wrapper that hands the
+ * continue to the workspace-local nx: the child takes its own hold, and an
+ * exclusive one refuses while this process still holds.
+ */
+export declare function releaseRunToHandOff(root: string, runId: string): void;
+export declare function runOrchestratorReconcile(input: RunOrchestratorReconcileInput): Promise<void>;
+/**
+ * What a completed run leaves behind for whoever reads its summary, one line
+ * group per warning: commit debt, uninstalled dependency changes, unresolved
+ * issues. Empty when nothing is left.
+ */
+export declare function completionWarnings(root: string, runId: string, state: MigrateRunState): string[][];