Port: throttle controls for the stop-time review gate #48

async function handleSetup(argv) {
  const { options } = parseArgs(argv, {
    valueOptions: ["review-gate-max", "review-gate-cooldown"],
    booleanOptions: ["json", "enable-review-gate", "disable-review-gate"],
  });

  // ... existing setup body ...

  if (options["review-gate-max"] != null) {
    const max = options["review-gate-max"] === "off" ? null : Number(options["review-gate-max"]);
    if (max !== null && (!Number.isInteger(max) || max < 1)) {
      throw new Error(`--review-gate-max must be a positive integer or "off".`);
    }
    updateState(workspace, (state) => {
      state.config = state.config || {};
      state.config.reviewGateMaxPerSession = max;
    });
  }

  if (options["review-gate-cooldown"] != null) {
    const cooldown = options["review-gate-cooldown"] === "off" ? null : Number(options["review-gate-cooldown"]);
    if (cooldown !== null && (!Number.isInteger(cooldown) || cooldown < 1)) {
      throw new Error(`--review-gate-cooldown must be a positive integer (minutes) or "off".`);
    }
    updateState(workspace, (state) => {
      state.config = state.config || {};
      state.config.reviewGateCooldownMinutes = cooldown;
    });
  }
}

const sessionId = getClaudeSessionId();
const now = new Date();

if (sessionId && state.config) {
  const usage = state.reviewGateUsage?.[sessionId] ?? { count: 0, lastRunAt: null };

  const max = state.config.reviewGateMaxPerSession;
  if (Number.isFinite(max) && usage.count >= max) {
    console.log(`ALLOW: Review gate session cap (${max}) reached.`);
    return;
  }

  const cooldownMin = state.config.reviewGateCooldownMinutes;
  if (Number.isFinite(cooldownMin) && usage.lastRunAt) {
    const elapsedMs = now - new Date(usage.lastRunAt);
    if (elapsedMs < cooldownMin * 60 * 1000) {
      const remaining = Math.ceil((cooldownMin * 60 * 1000 - elapsedMs) / 1000);
      console.log(`ALLOW: Review gate cooldown (${remaining}s remaining).`);
      return;
    }
  }
}

// ...proceed with stdin read + OpenCode call...

// After a successful review, bump usage:
updateState(workspace, (s) => {
  s.reviewGateUsage = s.reviewGateUsage || {};
  const entry = s.reviewGateUsage[sessionId] ?? { count: 0, lastRunAt: null };
  entry.count += 1;
  entry.lastRunAt = now.toISOString();
  s.reviewGateUsage[sessionId] = entry;
});