Function main

scripts/loop-runner.js:53–137

()

}

function main() {
  if (hasFlag('--help') || hasFlag('-h')) {
    process.stdout.write(`${usage()}\n`);
    return;
  }

  const projectRoot = path.resolve(arg('--project-root', process.cwd()));
  const action = arg('--action');
  const verify = arg('--verify');
  const maxAttempts = Number(arg('--max-attempts', 3));
  const write = hasFlag('--write') || hasFlag('--run');

  if (!verify) {
    process.stderr.write('Missing --verify. A bounded loop needs a verifier.\n');
    process.exit(1);
  }
  if (!Number.isFinite(maxAttempts) || maxAttempts < 1) {
    process.stderr.write('--max-attempts must be >= 1.\n');
    process.exit(1);
  }

  const contractPlan = createLoopContract({
    type: 'foreground-loop',
    title: arg('--title') || action || verify,
    goal: arg('--goal') || action || verify,
    command: action || null,
    verifierCommand: verify,
    maxAttempts,
    triggerKind: 'manual',
    status: write ? 'running' : 'planned',
  });

  if (!write) {
    process.stdout.write(`Loop planned: ${contractPlan.id}\n`);
    process.stdout.write(`State: ${contractPlan.statePath}\n`);
    process.stdout.write('Pass --write or --run to execute.\n');
    return;
  }

  const contract = registerLoop(projectRoot, contractPlan);

  let finalStatus = 'attempt-limit';
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    if (action) {
      const actionResult = runShell(action, projectRoot);
      appendLoopRun(projectRoot, contract.id, {
        attempt,
        status: actionResult.exitCode === 0 ? 'running' : 'blocked',
        summary: actionResult.exitCode === 0 ? 'action completed' : 'action failed',
        command: action,
        exitCode: actionResult.exitCode,
        startedAt: actionResult.startedAt,
        completedAt: actionResult.completedAt,
      });
      if (actionResult.exitCode !== 0) {
        finalStatus = 'blocked';
        break;
      }