affaan-m/ECC · error · Error

blockingIssues.map(issue => issue.message).join('; ')

Error message

blockingIssues.map(issue => issue.message).join('; ')

What it means

planInstallTargetScaffold aborts when the adapter's validate() returned blocking-severity issues (exempt codes filtered out); the joined issue messages describe why the target environment fails scaffold preconditions.

Source

Thrown at scripts/lib/install-targets/registry.js:61

  return adapter;
}

function planInstallTargetScaffold(options = {}) {
  const adapter = getInstallTargetAdapter(options.target);
  const modules = Array.isArray(options.modules) ? options.modules : [];
  const exemptValidationCodes = new Set(Array.isArray(options.exemptValidationCodes) ? options.exemptValidationCodes : []);
  const planningInput = {
    repoRoot: options.repoRoot,
    projectRoot: options.projectRoot || options.repoRoot,
    homeDir: options.homeDir,
  };
  const validationIssues = adapter.validate(planningInput);
  const blockingIssues = validationIssues.filter(issue => (
    issue.severity === 'error' && !exemptValidationCodes.has(issue.code)
  ));
  if (blockingIssues.length > 0) {
    throw new Error(blockingIssues.map(issue => issue.message).join('; '));
  }
  const targetRoot = adapter.resolveRoot(planningInput);
  const installStatePath = adapter.getInstallStatePath(planningInput);
  const operations = adapter.planOperations({
    ...planningInput,
    modules,
  });

  return {
    adapter: {
      id: adapter.id,
      target: adapter.target,
      kind: adapter.kind,
    },
    targetRoot,
    installStatePath,
    validationIssues,
    operations,

View on GitHub (pinned to 06c5e118c4)

Solutions

1. Resolve each blocking issue listed in the message, then re-run the install.
2. Run the installer/doctor to get the detailed blocking issue list.

When it happens

Trigger: Thrown at scripts/lib/install-targets/registry.js:61 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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