ECC/scripts/install-plan.js

#!/usr/bin/env node
/**
 * Inspect selective-install profiles and module plans without mutating targets.
 */

const {
  listInstallComponents,
  listInstallModules,
  listInstallProfiles,
  resolveInstallPlan,
} = require('./lib/install-manifests');
const {
  findDefaultInstallConfigPath,
  loadInstallConfig,
} = require('./lib/install/config');
const { normalizeInstallRequest } = require('./lib/install/request');
const { describeMissingDependencyError } = require('./lib/missing-dependency');

function showHelp() {
  console.log(`
Inspect ECC selective-install manifests

Usage:
  node scripts/install-plan.js --list-profiles
  node scripts/install-plan.js --list-modules
  node scripts/install-plan.js --list-components [--family <family>] [--target <target>] [--json]
  node scripts/install-plan.js --profile <name> [--with <component>]... [--without <component>]... [--target <target>] [--json]
  node scripts/install-plan.js --modules <id,id,...> [--with <component>]... [--without <component>]... [--target <target>] [--json]
  node scripts/install-plan.js --skills <skill-id[,skill-id...]> [--target <target>] [--json]
  node scripts/install-plan.js --config <path> [--json]

Options:
  --list-profiles     List available install profiles
  --list-modules      List install modules
  --list-components   List user-facing install components
  --family <family>   Filter listed components by family
  --profile <name>    Resolve an install profile
  --modules <ids>     Resolve explicit module IDs (comma-separated)
  --with <component>  Include a user-facing install component
  --skills <ids>      Include one or more skill components by directory ID
  --without <component>
                      Exclude a user-facing install component
  --config <path>     Load install intent from ecc-install.json
  --target <target>   Filter plan for a specific target
  --json              Emit machine-readable JSON
  --help              Show this help text
`);
}

function parseArgs(argv) {
  const args = argv.slice(2);
  const parsed = {
    json: false,
    help: false,
    profileId: null,
    moduleIds: [],
    includeComponentIds: [],
    excludeComponentIds: [],
    configPath: null,
    target: null,
    family: null,
    listProfiles: false,
    listModules: false,
    listComponents: false,
  };

  function normalizeSkillComponentIds(rawValue) {
    return [...new Set(String(rawValue || '').split(',').map(value => value.trim()).filter(Boolean))]
      .map(value => (value.startsWith('skill:') ? value : `skill:${value}`));
  }

  for (let index = 0; index < args.length; index += 1) {
    const arg = args[index];
    if (arg === '--help' || arg === '-h') {
      parsed.help = true;
    } else if (arg === '--json') {
      parsed.json = true;
    } else if (arg === '--list-profiles') {
      parsed.listProfiles = true;
    } else if (arg === '--list-modules') {
      parsed.listModules = true;
    } else if (arg === '--list-components') {
      parsed.listComponents = true;
    } else if (arg === '--family') {
      parsed.family = args[index + 1] || null;
      index += 1;
    } else if (arg === '--profile') {
      parsed.profileId = args[index + 1] || null;
      index += 1;
    } else if (arg === '--modules') {
      const raw = args[index + 1] || '';
      parsed.moduleIds = raw.split(',').map(value => value.trim()).filter(Boolean);
      index += 1;
    } else if (arg === '--with') {
      const componentId = args[index + 1] || '';
      if (componentId.trim()) {
        parsed.includeComponentIds.push(componentId.trim());
      }
      index += 1;
    } else if (arg === '--skill' || arg === '--skills') {
      parsed.includeComponentIds.push(...normalizeSkillComponentIds(args[index + 1] || ''));
      index += 1;
    } else if (arg === '--without') {
      const componentId = args[index + 1] || '';
      if (componentId.trim()) {
        parsed.excludeComponentIds.push(componentId.trim());
      }
      index += 1;
    } else if (arg === '--config') {
      parsed.configPath = args[index + 1] || null;
      index += 1;
    } else if (arg === '--target') {
      parsed.target = args[index + 1] || null;
      index += 1;
    } else {
      throw new Error(`Unknown argument: ${arg}`);
    }
  }

  return parsed;
}

function printProfiles(profiles) {
  console.log('Install profiles:\n');
  for (const profile of profiles) {
    console.log(`- ${profile.id} (${profile.moduleCount} modules)`);
    console.log(`  ${profile.description}`);
  }
}

function printModules(modules) {
  console.log('Install modules:\n');
  for (const module of modules) {
    console.log(`- ${module.id} [${module.kind}]`);
    console.log(
      `  targets=${module.targets.join(', ')} default=${module.defaultInstall} cost=${module.cost} stability=${module.stability}`
    );
    console.log(`  ${module.description}`);
  }
}

function printComponents(components) {
  console.log('Install components:\n');
  for (const component of components) {
    console.log(`- ${component.id} [${component.family}]`);
    console.log(`  targets=${component.targets.join(', ')} modules=${component.moduleIds.join(', ')}`);
    console.log(`  ${component.description}`);
  }
}

function printPlan(plan) {
  console.log('Install plan:\n');
  console.log(
    'Note: target filtering and operation output currently reflect scaffold-level adapter planning, not a byte-for-byte mirror of legacy install.sh copy paths.\n'
  );
  console.log(`Profile: ${plan.profileId || '(custom modules)'}`);
  console.log(`Target: ${plan.target || '(all targets)'}`);
  console.log(`Included components: ${plan.includedComponentIds.join(', ') || '(none)'}`);
  console.log(`Excluded components: ${plan.excludedComponentIds.join(', ') || '(none)'}`);
  console.log(`Requested: ${plan.requestedModuleIds.join(', ')}`);
  if (plan.targetAdapterId) {
    console.log(`Adapter: ${plan.targetAdapterId}`);
    console.log(`Target root: ${plan.targetRoot}`);
    console.log(`Install-state: ${plan.installStatePath}`);
  }
  console.log('');
  console.log(`Selected modules (${plan.selectedModuleIds.length}):`);
  for (const module of plan.selectedModules) {
    console.log(`- ${module.id} [${module.kind}]`);
  }

  if (plan.skippedModuleIds.length > 0) {
    console.log('');
    console.log(`Skipped for target ${plan.target} (${plan.skippedModuleIds.length}):`);
    for (const module of plan.skippedModules) {
      console.log(`- ${module.id} [${module.kind}]`);
    }
  }

  if (plan.excludedModuleIds.length > 0) {
    console.log('');
    console.log(`Excluded by selection (${plan.excludedModuleIds.length}):`);
    for (const module of plan.excludedModules) {
      console.log(`- ${module.id} [${module.kind}]`);
    }
  }

  if (plan.operations.length > 0) {
    console.log('');
    console.log(`Operation plan (${plan.operations.length}):`);
    for (const operation of plan.operations) {
      console.log(
        `- ${operation.moduleId}: ${operation.sourceRelativePath} -> ${operation.destinationPath} [${operation.strategy}]`
      );
    }
  }
}

function main() {
  try {
    const options = parseArgs(process.argv);

    if (options.help) {
      showHelp();
      process.exit(0);
    }

    if (options.listProfiles) {
      const profiles = listInstallProfiles();
      if (options.json) {
        console.log(JSON.stringify({ profiles }, null, 2));
      } else {
        printProfiles(profiles);
      }
      return;
    }

    if (options.listModules) {
      const modules = listInstallModules();
      if (options.json) {
        console.log(JSON.stringify({ modules }, null, 2));
      } else {
        printModules(modules);
      }
      return;
    }

    if (options.listComponents) {
      const components = listInstallComponents({
        family: options.family,
        target: options.target,
      });
      if (options.json) {
        console.log(JSON.stringify({ components }, null, 2));
      } else {
        printComponents(components);
      }
      return;
    }

    const defaultConfigPath = options.configPath
      ? null
      : findDefaultInstallConfigPath({ cwd: process.cwd() });
    const config = options.configPath
      ? loadInstallConfig(options.configPath, { cwd: process.cwd() })
      : (defaultConfigPath ? loadInstallConfig(defaultConfigPath, { cwd: process.cwd() }) : null);

    if (process.argv.length <= 2 && !config) {
      showHelp();
      process.exit(0);
    }

    const request = normalizeInstallRequest({
      ...options,
      languages: [],
      config,
    });
    const plan = resolveInstallPlan({
      profileId: request.profileId,
      moduleIds: request.moduleIds,
      includeComponentIds: request.includeComponentIds,
      excludeComponentIds: request.excludeComponentIds,
      target: request.target,
    });

    if (options.json) {
      console.log(JSON.stringify(plan, null, 2));
    } else {
      printPlan(plan);
    }
  } catch (error) {
    console.error(`Error: ${describeMissingDependencyError(error) || error.message}`);
    process.exit(1);
  }
}

main();