feature: add Stop() for graceful Start() loop shutdown

[toddr-bot]

Summary

• Adds Stop() public method to signal the Start() event loop to exit gracefully
• Start() now returns the loop iteration count instead of running forever
• Start() can be called again after Stop() — the flag resets on entry

Why

Start() ran while(1) with no exit mechanism. The only way to stop a bot was to kill the process. This made it impossible to write bots that shut down cleanly (e.g., on signal, after a condition, or from a background check).

How

Added a private _running Bool attribute. Start() sets it to 1 on entry and loops on it. Stop() sets it to 0. The loop exits after the current iteration completes (Process + background + sleep), so all in-flight work finishes cleanly.

Testing

• 14 new tests in t/08-test_start_stop.t covering:
  • Stop() from background_function after N iterations
  • Stop() from message_function callback
  • Re-calling Start() after Stop()
  • Prior Stop() doesn't prevent subsequent Start()
  • Return value (iteration count)
• Full suite passes: 341 tests, 15 files

🤖 Generated with Claude Code

---

Quality Report

Changes: 2 files changed, 236 insertions(+), 4 deletions(-)

Code scan: clean

Tests: passed (OK)

Branch hygiene: clean

Generated by Kōan post-mission quality pipeline

[toddr-bot]

Rebase: feature: add Stop() for graceful Start() loop shutdown

Branch koan.toddr.bot/add-graceful-shutdown rebased onto main and force-pushed.

Diff: 2 files changed, 235 insertions(+), 3 deletions(-)

Actions

• Resolved merge conflicts (1 round(s))
• Rebased koan.toddr.bot/add-graceful-shutdown onto upstream/main
• Force-pushed koan.toddr.bot/add-graceful-shutdown to origin
• CI polling timed out

CI

CI still running (timed out waiting).

---

Automated by Kōan