nx 23.2.0-beta.7 → 23.2.0-beta.9

package/dist/src/command-line/migrate/run/agent-output.js

@@ -0,0 +1,65 @@
+"use strict";
+// Internal to run/: deliberately not re-exported from ./index.
+//
+// The single writer for everything an orchestrated run puts on stdout. Human
+// lines and the `<nx_migrate_*>` blocks the driving agent parses share that one
+// stream, so a value carrying its own line break could open a forged block.
+//
+// Two boundaries: a thrown error leaves through handleErrors, which prints it
+// outside this guarantee; and migration code is not contained at all (nx
+// `require`s and runs it in process), so the guarantee is that data cannot
+// corrupt the framing, nothing more.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeLines = safeLines;
+exports.logToAgent = logToAgent;
+exports.warnToAgent = warnToAgent;
+exports.emitStepBlock = emitStepBlock;
+exports.emitPromptBlock = emitPromptBlock;
+const output_1 = require("../../../utils/output");
+const print_dropped_agent_context_1 = require("../agentic/print-dropped-agent-context");
+const text_1 = require("../text");
+/**
+ * The safe form of a set of lines. Exported so a caller that needs the same
+ * text twice, once for a human and once inside a block payload, derives both
+ * from one array instead of sanitizing one copy and not the other.
+ */
+function safeLines(lines) {
+    return lines.map(text_1.singleLine);
+}
+function safe(message) {
+    return {
+        title: (0, text_1.singleLine)(message.title),
+        bodyLines: safeLines(message.bodyLines ?? []),
+    };
+}
+function logToAgent(message) {
+    output_1.output.log(safe(message));
+}
+function warnToAgent(message) {
+    output_1.output.warn(safe(message));
+}
+/**
+ * Serializes a block payload. `<` becomes its JSON unicode escape so a raw one
+ * in a value cannot forge the closing tag, and the result stays valid JSON for
+ * the agent to parse.
+ */
+function blockPayload(payload) {
+    return JSON.stringify(payload, null, 2).replace(/</g, '\\u003c');
+}
+// A bare newline pair frames the block so adjacent stdout cannot run into it.
+function writeBlock(tag, attrs, json) {
+    const attrText = attrs
+        .map(([name, value]) => ` ${name}="${(0, print_dropped_agent_context_1.escapeXmlAttr)((0, text_1.singleLine)(value))}"`)
+        .join('');
+    process.stdout.write(`\n<${tag}${attrText}>\n${json}\n</${tag}>\n\n`);
+}
+function emitStepBlock(runId, stepId, action, payload) {
+    writeBlock('nx_migrate_step', [
+        ['run-id', runId],
+        ['step', stepId],
+        ['action', action],
+    ], blockPayload(payload));
+}
+function emitPromptBlock(migrationId, payload) {
+    writeBlock('nx_migrate_prompt', [['migration', migrationId]], blockPayload(payload));
+}

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

@@ -1,2 +1,9 @@
+export { CURRENT_RUN_STATE_FORMAT_VERSION, NewerRunStateFormatError, migrateRunsDir, runDir, readRunState, writeRunState, findActiveRun, createRun, } from './run-state';
+export type { MigrateRunStatus, MigrateRunRound, MigrateStepStatus, PromptOutcomeStatus, MigrateStepOutcome, MigrateStepPromptOutcome, MigrateStep, MigrateCommitKind, MigrateCommitLedgerEntry, MigrateRunAnalytics, MigrateRunState, } from './run-state';
+export { applyStepEvent, hasPendingCommitDebt } from './state-machine';
+export type { StepAction, StepEvent, ApplyStepEventResult, } from './state-machine';
+export { createRunId, computePlanHash } from './run-id';
 export { runSingleMigrationWorker } from './worker';
 export type { RunSingleMigrationWorkerInput } from './worker';
+export { runOrchestratorInit, runOrchestratorReconcile } from './orchestrator';
+export type { RunOrchestratorInitInput, RunOrchestratorReconcileInput, } from './orchestrator';

package/dist/src/command-line/migrate/run/index.js

@@ -1,5 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runSingleMigrationWorker = void 0;
+exports.runOrchestratorReconcile = exports.runOrchestratorInit = exports.runSingleMigrationWorker = exports.computePlanHash = exports.createRunId = exports.hasPendingCommitDebt = exports.applyStepEvent = exports.createRun = exports.findActiveRun = exports.writeRunState = exports.readRunState = exports.runDir = exports.migrateRunsDir = exports.NewerRunStateFormatError = exports.CURRENT_RUN_STATE_FORMAT_VERSION = void 0;
+var run_state_1 = require("./run-state");
+Object.defineProperty(exports, "CURRENT_RUN_STATE_FORMAT_VERSION", { enumerable: true, get: function () { return run_state_1.CURRENT_RUN_STATE_FORMAT_VERSION; } });
+Object.defineProperty(exports, "NewerRunStateFormatError", { enumerable: true, get: function () { return run_state_1.NewerRunStateFormatError; } });
+Object.defineProperty(exports, "migrateRunsDir", { enumerable: true, get: function () { return run_state_1.migrateRunsDir; } });
+Object.defineProperty(exports, "runDir", { enumerable: true, get: function () { return run_state_1.runDir; } });
+Object.defineProperty(exports, "readRunState", { enumerable: true, get: function () { return run_state_1.readRunState; } });
+Object.defineProperty(exports, "writeRunState", { enumerable: true, get: function () { return run_state_1.writeRunState; } });
+Object.defineProperty(exports, "findActiveRun", { enumerable: true, get: function () { return run_state_1.findActiveRun; } });
+Object.defineProperty(exports, "createRun", { enumerable: true, get: function () { return run_state_1.createRun; } });
+var state_machine_1 = require("./state-machine");
+Object.defineProperty(exports, "applyStepEvent", { enumerable: true, get: function () { return state_machine_1.applyStepEvent; } });
+Object.defineProperty(exports, "hasPendingCommitDebt", { enumerable: true, get: function () { return state_machine_1.hasPendingCommitDebt; } });
+var run_id_1 = require("./run-id");
+Object.defineProperty(exports, "createRunId", { enumerable: true, get: function () { return run_id_1.createRunId; } });
+Object.defineProperty(exports, "computePlanHash", { enumerable: true, get: function () { return run_id_1.computePlanHash; } });
 var worker_1 = require("./worker");
 Object.defineProperty(exports, "runSingleMigrationWorker", { enumerable: true, get: function () { return worker_1.runSingleMigrationWorker; } });
+var orchestrator_1 = require("./orchestrator");
+Object.defineProperty(exports, "runOrchestratorInit", { enumerable: true, get: function () { return orchestrator_1.runOrchestratorInit; } });
+Object.defineProperty(exports, "runOrchestratorReconcile", { enumerable: true, get: function () { return orchestrator_1.runOrchestratorReconcile; } });

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

@@ -0,0 +1,20 @@
+import { type StepAction } from './state-machine';
+import { type PlannedMigration } from '../migration-shape';
+export interface RunOrchestratorInitInput {
+    root: string;
+    migrationsJson: {
+        migrations?: PlannedMigration[];
+        [k: string]: unknown;
+    };
+    createCommits: boolean;
+    commitPrefix: string;
+    skipInstall: boolean;
+    installedNxVersion: string;
+}
+export interface RunOrchestratorReconcileInput {
+    root: string;
+    runId: string;
+    stepAction?: StepAction;
+}
+export declare function runOrchestratorInit(input: RunOrchestratorInitInput): Promise<void>;
+export declare function runOrchestratorReconcile(input: RunOrchestratorReconcileInput): Promise<void>;