Function _classifyChannel1Error

src/forceUpdate.js:157–202

(e, phase)

//   'parse' -> degit exited 0 but the downloaded package.json is missing/invalid
//   'copy'  -> the staged tree downloaded fine but cpSync into INSTALL_ROOT failed
function _classifyChannel1Error(e, phase) {
  if (phase === 'delete') {
    var deleteEntry = e && e._evolverEntry ? String(e._evolverEntry) + ': ' : '';
    return _fail(FORCE_UPDATE_FAIL_CODES.DELETE_FAILED, deleteEntry + _errStr(e));
  }
  if (phase === 'copy') {
    var entry = e && e._evolverEntry ? String(e._evolverEntry) + ': ' : '';
    return _fail(FORCE_UPDATE_FAIL_CODES.COPY_FAILED, entry + _errStr(e));
  }
  if (phase === 'parse') {
    return _fail(FORCE_UPDATE_FAIL_CODES.DOWNLOAD_INCOMPLETE,
      'missing/invalid package.json in downloaded tree: ' + _errStr(e));
  }
  // phase === 'degit' (the spawn). ENOENT here is the npx binary itself, not a
  // file inside the download — that distinction is exactly why `phase` exists.
  if (e && e.code === 'ENOENT') {
    return _fail(FORCE_UPDATE_FAIL_CODES.NPX_NOT_FOUND, _errStr(e));
  }
  // execFileSync timeout kills the child with SIGTERM (and sets .killed); some
  // platforms surface ETIMEDOUT instead. Either way it is a 60s timeout.
  if (e && (e.killed || e.signal === 'SIGTERM' || e.code === 'ETIMEDOUT')) {
    return _fail(FORCE_UPDATE_FAIL_CODES.DEGIT_TIMEOUT,
      'degit timed out after 60s' + (e.signal ? ' (signal=' + e.signal + ')' : ''));
  }
  // Generic degit/network/tag-not-found failure. degit prints the real reason
  // ("could not find commit hash for v…", "could not resolve host") to stderr,
  // so keep a tail of it. Redact + strip control chars HERE, before the tail
  // slice: the downstream reporter redact (a2aProtocol.reportForceUpdateOutcome)
  // runs after this, so slicing first could chop a token's prefix anchor and
  // let the bare value slip past the prefix-anchored redact patterns. Stripping
  // ANSI/NUL/newlines also keeps the persisted error free of terminal-injection
  // sequences and log-line noise.
  var detail = _errStr(e);
  var stderr = '';
  if (e && e.stderr != null) {
    try {
      var redactString = require('./gep/sanitize').redactString;
      stderr = redactString(String(e.stderr)).replace(/[\x00-\x1f\x7f]/g, ' ').trim();
    } catch (_) {
      // sanitize unavailable — still strip control chars so logs stay clean.
      stderr = String(e.stderr).replace(/[\x00-\x1f\x7f]/g, ' ').trim();
    }
  }
  if (stderr) detail += ' | stderr=' + stderr.slice(-300);
  return _fail(FORCE_UPDATE_FAIL_CODES.DEGIT_FAILED, detail);
}

function _withFallbackFailure(primaryFailure, fallbackFailure) {
  if (!primaryFailure) return fallbackFailure;