{"record":{"id":"2ca2f6428c4d0551","repo":"affaan-m/ECC","slug":"guided-install-failed","errorCode":"GUIDED_INSTALL_FAILED","errorMessage":"${error.message}","messagePattern":"\\$\\{error\\.message\\}","errorType":"error_code","errorClass":null,"httpStatus":null,"severity":"error","filePath":"scripts/install-guided.js","lineNumber":316,"sourceCode":"    } finally {\n      spinner?.stop();\n    }\n    if (options.json) {\n      output.write(`${JSON.stringify({ dryRun: false, result }, null, 2)}\\n`);\n    } else if (result.status === 'complete') {\n      output.write(`\\nECC configured for ${result.completed.map(item => getHarnessCapability(item.id).label).join(', ')}.\\n`);\n      renderWelcome({ action: 'installed', interactive, json: false, output });\n    } else {\n      const retry = buildRetryArguments(plan, result.retryHarnesses);\n      errorOutput.write(\n        `ECC stopped at ${sanitizeTerminalText(result.failure.id)}: `\n        + `${sanitizeTerminalText(result.failure.message)}\\n`\n        + `Retry with: ecc-universal install --guided ${retry}\\n`\n      );\n    }\n    return result.status === 'complete' ? 0 : 1;\n  } catch (error) {\n    const payload = { error: { code: 'GUIDED_INSTALL_FAILED', message: error.message } };\n    if (argv.includes('--json')) errorOutput.write(`${JSON.stringify(payload, null, 2)}\\n`);\n    else errorOutput.write(`Error: ${sanitizeTerminalText(error.message)}\\n`);\n    return 1;\n  } finally {\n    if (ownsTerminal) terminal?.close();\n  }\n}\n\nif (require.main === module) {\n  main().then(code => {\n    process.exitCode = code;\n  });\n}\n\nmodule.exports = {\n  collectInteractiveOptions,\n  main,\n  parseArgs,","sourceCodeStart":298,"sourceCodeEnd":334,"githubUrl":"https://github.com/affaan-m/ECC/blob/06c5e118c4d3e6c3b7f9445f973a2194c82de193/scripts/install-guided.js#L298-L334","documentation":"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.","triggerScenarios":"Triggered when install-guided.js rejects the current invocation: <value>","commonSituations":"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.","solutions":["Inspect the underlying error detail in the message (stderr/log/HTTP status), fix the cause, and retry."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"06c5e118c4d3e6c3b7f9445f973a2194c82de193","analyzedAt":"2026-08-18T11:27:13.915Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}