repeat

/repeat - Autonomous Recurring Execution

$ARGUMENTS

Argument Parsing

Parse the user input into three components:

1. Interval — duration between iterations (default: 10m)
   • Accepts: 1m, 5m, 10m, 30m, 1h
   • Minimum: 1m (enforced, reject anything lower)
2. Command or prompt — the slash command or freeform prompt to execute each iteration
3. Flags:
   • --iterations N — maximum number of iterations (default: 5)

Examples of parsed input:

• /repeat 5m /test -> interval=5m, command=/test, iterations=5
• /repeat 10m "check deploy status" -> interval=10m, command="check deploy status", iterations=5
• /repeat --iterations 3 /review -> interval=10m, command=/review, iterations=3
• /repeat 2m --iterations 10 /lint -> interval=2m, command=/lint, iterations=10

Safety Controls

These limits are constitutionally mandated (Article I, Section 4). Violating them is not permitted.

Max Iterations

• Default: 5 iterations
• Configurable via --iterations N
• Hard ceiling: the loop MUST terminate after N iterations regardless of outcome

Circuit Breaker

• Track consecutive failures (non-zero exit code, error output, exceptions)
• 3 consecutive failures -> immediate hard stop
• Reset the failure counter on any successful iteration

Minimum Interval

• Never execute faster than 1 minute between iterations
• If user requests <1m, override to 1m and warn

Exit Detection

After each iteration, inspect the output for completion signals:

• Exit code 0 combined with success markers
• Output contains: DONE, COMPLETE, ALL PASS, ALL TESTS PASSED, SUCCESS
• Case-insensitive matching
• If detected: stop the loop early and report success

Execution Protocol

For iteration = 1 to max_iterations:
    1. Log iteration start (timestamp, iteration number)
    2. Execute the command or prompt
    3. Capture output and exit status
    4. Check exit detection:
       - If completion marker found -> STOP, report success
    5. Check circuit breaker:
       - If failure: increment consecutive_failures
       - If success: reset consecutive_failures to 0
       - If consecutive_failures >= 3 -> HARD STOP, report failure
    6. Log iteration result to stats
    7. If not last iteration: wait for interval duration
    8. Repeat

After loop ends:
    - Print summary: total iterations, pass/fail counts, elapsed time
    - Final status: COMPLETED | EARLY_SUCCESS | CIRCUIT_BREAKER | MAX_ITERATIONS