affaan-m/ECC · error

GUIDED_INSTALL_FAILED

GUIDED_INSTALL_FAILED

Error message

${error.message}

What it means

install-guided's top-level catch reports a failure while applying a harness: error.message carries the underlying failure from the install step, and the surrounding code builds retry arguments for the failed harness.

Source

Thrown at scripts/install-guided.js:316

    } finally {
      spinner?.stop();
    }
    if (options.json) {
      output.write(`${JSON.stringify({ dryRun: false, result }, null, 2)}\n`);
    } else if (result.status === 'complete') {
      output.write(`\nECC configured for ${result.completed.map(item => getHarnessCapability(item.id).label).join(', ')}.\n`);
      renderWelcome({ action: 'installed', interactive, json: false, output });
    } else {
      const retry = buildRetryArguments(plan, result.retryHarnesses);
      errorOutput.write(
        `ECC stopped at ${sanitizeTerminalText(result.failure.id)}: `
        + `${sanitizeTerminalText(result.failure.message)}\n`
        + `Retry with: ecc-universal install --guided ${retry}\n`
      );
    }
    return result.status === 'complete' ? 0 : 1;
  } catch (error) {
    const payload = { error: { code: 'GUIDED_INSTALL_FAILED', message: error.message } };
    if (argv.includes('--json')) errorOutput.write(`${JSON.stringify(payload, null, 2)}\n`);
    else errorOutput.write(`Error: ${sanitizeTerminalText(error.message)}\n`);
    return 1;
  } finally {
    if (ownsTerminal) terminal?.close();
  }
}

if (require.main === module) {
  main().then(code => {
    process.exitCode = code;
  });
}

module.exports = {
  collectInteractiveOptions,
  main,
  parseArgs,

View on GitHub (pinned to 06c5e118c4)

Solutions

1. Inspect the underlying error detail in the message (stderr/log/HTTP status), fix the cause, and retry.

When it happens

Trigger: Triggered when install-guided.js rejects the current invocation: <value>

Common situations: Occurs while running scripts/install-guided.js with invalid arguments, missing flags, or a failing external dependency; the guard at scripts/install-guided.js:316 aborts the command with this message.

AI-assisted analysis of affaan-m/ECC@06c5e118c4 (2026-08-18). Data as JSON: /api/errors/2ca2f6428c4d0551. Report an issue: GitHub.