Background

We're looking for contributors to improve the local run scripts (run_local.sh, stop_local.sh) introduced in #35 to make local development more reliable.

Task

• Detect and clean up stale PID files.
• Detect port 8080 conflicts on start.
  • Fail with a clear error, or clean up when explicitly requested.
• Add a --force flag:
  • Force start: clean stale state/PID and start.
  • Force stop: clean PID files even if state is ambiguous.
  • Warn if port 8080 is used by an unrelated process.

Done When

• All required items are implemented and verified.
• Scripts remain minimal and easy to read.

Notes

Nice to have

• Startup timeout with clear errors.
• Configurable ports (not hardcoded 8080).
• Improved graceful shutdown.
• Better macOS/Linux portability.

Please comment below and request assignment if you'd like to work on this.