impel-cli 0.15.3 → 0.16.1

package/src/installRecovery/loop.js

@@ -1,258 +0,0 @@
-import fs from "node:fs";
-import { fileURLToPath } from "node:url";
-
-import { promptText } from "../prompt.js";
-import {
-  deterministicInstallRecoveryAction,
-  executeInstallRecoveryAction,
-  installRecoveryActionMutates,
-  validateInstallRecoveryAction,
-} from "./actions.js";
-import {
-  clearInstallRecoveryCheckpoint,
-  loadInstallRecoveryCheckpoint,
-  saveInstallRecoveryCheckpoint,
-} from "./checkpoint.js";
-import { createInstallRecoveryClient } from "./client.js";
-import {
-  installRecoveryFingerprint,
-  installRecoveryStateFingerprint,
-  sanitizeInstallFailureEnvelope,
-} from "./redact.js";
-
-const CLI_VERSION = JSON.parse(
-  fs.readFileSync(
-    fileURLToPath(new URL("../../package.json", import.meta.url)),
-    "utf8"
-  )
-).version;
-const TERMINAL_STATUSES = new Set(["fixed", "blocked", "aborted"]);
-const POLL_INTERVAL_MS = 1_000;
-
-function recoveryDisabled(environment) {
-  return ["1", "true", "yes"].includes(
-    String(environment.IMPEL_DISABLE_INSTALL_RECOVERY || "").toLowerCase()
-  );
-}
-
-function yes(answer) {
-  return /^(?:y|yes)$/iu.test(String(answer || "").trim());
-}
-
-async function confirmMutation(action, io) {
-  if (!installRecoveryActionMutates(action.id)) return true;
-  if (!io.isTTY) return false;
-  const answer = await io.promptText(
-    `Install recovery proposes ${action.id}: ${action.reason}\nRun this allowlisted local action? [y/N] `
-  );
-  return yes(answer);
-}
-
-function checkpointFrom(state, fingerprint) {
-  return {
-    protocolVersion: 1,
-    sessionId: state.sessionId,
-    recoveryToken: state.recoveryToken,
-    fingerprint,
-    status: state.status,
-    turn: state.turn,
-    expiresAt: state.expiresAt,
-    updatedAt: Date.now(),
-  };
-}
-
-function terminalOutcome(status) {
-  if (status === "fixed") return "fixed";
-  if (status === "aborted") return "aborted";
-  return "blocked";
-}
-
-async function uploadConsent(io, explicit, failure) {
-  io.log(
-    "Install recovery can send a sanitized failure envelope to Impel. Credentials, home paths, email addresses, ANSI controls, and raw tokens are removed."
-  );
-  io.log(
-    "The hosted agent selects typed action IDs; the Impel CLI runs the corresponding reviewed commands on this machine after local policy and confirmation checks."
-  );
-  io.log("Sanitized payload preview:");
-  io.log(JSON.stringify(failure, null, 2));
-  if (explicit) return true;
-  if (!io.isTTY) return false;
-  return yes(await io.promptText("Send the sanitized failure and start assisted recovery? [y/N] "));
-}
-
-export async function runInstallRecovery(options, overrides = {}) {
-  const environment = options.environment || process.env;
-  const io = {
-    promptText,
-    isTTY: process.stdin.isTTY,
-    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
-    loadCheckpoint: loadInstallRecoveryCheckpoint,
-    saveCheckpoint: saveInstallRecoveryCheckpoint,
-    clearCheckpoint: clearInstallRecoveryCheckpoint,
-    client:
-      options.client ||
-      createInstallRecoveryClient({
-        appUrl: options.config.appUrl,
-        fetchImpl: options.fetchImpl || fetch,
-      }),
-    executeAction: executeInstallRecoveryAction,
-    now: () => Date.now(),
-    log: console.log,
-    warn: console.warn,
-    ...overrides,
-  };
-
-  if (options.noRecovery || recoveryDisabled(environment)) {
-    return { status: "disabled", fixed: false, uploaded: false };
-  }
-
-  const failure = sanitizeInstallFailureEnvelope(options.failure);
-  const fingerprint = installRecoveryFingerprint(failure);
-  const encounteredErrors = [failure.message];
-  const actionContext = {
-    ...(options.actionContext || {}),
-    platform: failure.platform,
-    environment,
-    isTTY: io.isTTY,
-  };
-
-  // Always attempt one deterministic, allowlisted local diagnostic first. A
-  // mutation still needs the same explicit confirmation as a hosted proposal.
-  const deterministicAction = deterministicInstallRecoveryAction(failure);
-  const deterministicConfirmed = await confirmMutation(deterministicAction, io);
-  const deterministicResult = await io.executeAction(deterministicAction, {
-    ...actionContext,
-    confirmed: deterministicConfirmed,
-  });
-  io.log(`Install recovery local check: ${deterministicResult.summary}`);
-  if (deterministicResult.outcome === "failed") {
-    encounteredErrors.push(deterministicResult.summary);
-  }
-
-  const consented = await uploadConsent(io, options.explicit === true, failure);
-  if (!consented) {
-    io.log("Install recovery stayed local; no diagnostic data was uploaded.");
-    return {
-      status: "local_only",
-      fixed: false,
-      uploaded: false,
-      localResult: deterministicResult,
-    };
-  }
-
-  let state;
-  const existing = io.loadCheckpoint();
-  if (existing?.fingerprint === fingerprint) {
-    state = existing;
-    io.log(`Resuming install recovery session ${existing.sessionId}.`);
-  } else {
-    state = await io.client.create(options.config.pat, {
-      protocolVersion: 1,
-      orgId: options.config.tenantId,
-      cliVersion: CLI_VERSION,
-      consent: true,
-      fingerprint,
-      stateFingerprint: installRecoveryStateFingerprint({
-        failure,
-        deterministicResult,
-      }),
-      failure: {
-        ...failure,
-        diagnostics: {
-          ...(failure.diagnostics || {}),
-          localCheck: deterministicResult.summary,
-          localCheckOutcome: deterministicResult.outcome,
-        },
-      },
-    });
-    io.saveCheckpoint(checkpointFrom(state, fingerprint));
-  }
-
-  const deadline = Math.min(
-    state.expiresAt || io.now() + 15 * 60 * 1_000,
-    io.now() + 15 * 60 * 1_000
-  );
-  let terminal = false;
-  try {
-    while (io.now() < deadline) {
-      if (!TERMINAL_STATUSES.has(state.status)) {
-        state = await io.client.read(state.sessionId, state.recoveryToken);
-        io.saveCheckpoint(checkpointFrom(state, fingerprint));
-      }
-
-      if (state.status === "awaiting_action") {
-        const action = validateInstallRecoveryAction(state.proposal?.action);
-        if (!action || !state.actionNonce) {
-          encounteredErrors.push("Hosted recovery returned an invalid typed action.");
-          state.status = "blocked";
-          state.terminalSummary = "Hosted recovery returned an invalid typed action.";
-          continue;
-        }
-        io.log(`Install recovery: ${state.proposal.userMessage || state.proposal.summary}`);
-        const confirmed = await confirmMutation(action, io);
-        const result = await io.executeAction(action, {
-          ...actionContext,
-          confirmed,
-        });
-        if (result.outcome === "failed") encounteredErrors.push(result.summary);
-        state = await io.client.submitResult(
-          state.sessionId,
-          state.recoveryToken,
-          {
-            actionNonce: state.actionNonce,
-            actionId: action.id,
-            outcome: result.outcome,
-            stateFingerprint: installRecoveryStateFingerprint({
-              failure,
-              actionId: action.id,
-              result,
-            }),
-            summary: result.summary,
-            exitCode: result.exitCode,
-            ...(result.stdout ? { stdout: result.stdout } : {}),
-            ...(result.stderr ? { stderr: result.stderr } : {}),
-          }
-        );
-        io.saveCheckpoint(checkpointFrom(state, fingerprint));
-        continue;
-      }
-
-      if (TERMINAL_STATUSES.has(state.status)) {
-        terminal = true;
-        const summary =
-          state.terminalSummary || state.proposal?.summary || "Install recovery finished.";
-        await io.client.complete(state.sessionId, state.recoveryToken, {
-          outcome: terminalOutcome(state.status),
-          summary,
-          encounteredErrors: [...new Set(encounteredErrors)].slice(0, 20),
-        });
-        io.log(`Install recovery ${state.status}: ${summary}`);
-        return {
-          status: state.status,
-          fixed: state.status === "fixed",
-          uploaded: true,
-          summary,
-        };
-      }
-
-      await io.sleep(POLL_INTERVAL_MS);
-    }
-    const summary = terminal
-      ? state.terminalSummary
-      : "Install recovery reached its 15-minute local safety limit.";
-    io.warn(summary);
-    return { status: "blocked", fixed: false, uploaded: true, summary };
-  } catch (error) {
-    io.warn(`Install recovery paused: ${error?.message || error}`);
-    io.warn("Re-run `impel setup --repair` to resume the short-lived session.");
-    return {
-      status: "paused",
-      fixed: false,
-      uploaded: true,
-      summary: String(error?.message || error),
-    };
-  } finally {
-    if (terminal) io.clearCheckpoint();
-  }
-}