Function resolveNext

scripts/next-action.js:243–320

(projectRoot, options = {})

}

function resolveNext(projectRoot, options = {}) {
  const root = path.resolve(projectRoot || process.cwd());
  const steps = [];
  const generatedAt = options.now || new Date().toISOString();
  let snapshot = collectDashboard({ projectRoot: root });

  if (!options.run) {
    const repairs = snapshot.repairs || [];
    const outcome = repairs.length === 0
      ? 'idle'
      : (localRepairFor(snapshot.nextAction) ? 'repair-available' : 'needs-human');
    return {
      projectRoot: root,
      generatedAt,
      mode: 'inspect',
      outcome,
      initial: summarizeSnapshot(snapshot),
      final: summarizeSnapshot(snapshot),
      steps,
      approvalCapsule: buildApprovalCapsule(root, snapshot, generatedAt),
    };
  }

  const maxSteps = options.maxSteps || 3;
  for (let index = 0; index < maxSteps; index++) {
    const action = snapshot.nextAction || {};
    const repair = localRepairFor(action);
    if (!repair) {
      return {
        projectRoot: root,
        generatedAt,
        mode: 'run',
        outcome: (snapshot.repairs || []).length === 0 ? 'idle' : 'needs-human',
        initial: steps[0]?.before || summarizeSnapshot(snapshot),
        final: summarizeSnapshot(snapshot),
        steps,
        approvalCapsule: buildApprovalCapsule(root, snapshot, generatedAt),
      };
    }

    const before = summarizeSnapshot(snapshot);
    const result = runNode(root, repair);
    const after = collectDashboard({ projectRoot: root });
    const step = {
      action,
      repair,
      before,
      result,
      after: summarizeSnapshot(after),
    };
    steps.push(step);
    snapshot = after;

    if (result.status !== 0) {
      return {
        projectRoot: root,
        generatedAt,
        mode: 'run',