Add include_stats parameter to status endpoint and reduce log verbosity

[devin-ai-integration]

Summary

This PR addresses log flooding from STATUS and STATS commands by:

1. Adding include_stats parameter to /api/status endpoint - The endpoint now only fetches timing stats when include_stats=true is explicitly passed. Default is false, which completely skips the stats_plc() call and avoids acquiring the stats mutex that could introduce latency to the critical PLC scan cycle.

2. Reducing command logging verbosity - Removed all log_debug("Received X command") statements for recognized commands (PING, STATUS, STOP, START, STATS, DEBUG) and the generic "Received command" log. Only unrecognized commands are now logged (via existing log_error).

Note: This is a breaking change for clients that expect timing_stats in the status response by default. Per discussion, this is acceptable since the product hasn't been released yet.

Review & Testing Checklist for Human

• Verify the include_stats query parameter is correctly passed to the data dict by the REST API dispatch layer (check restapi.py if needed)
• Test /api/status returns only {"status": "..."} without timing_stats when called without parameters
• Test /api/status?include_stats=true returns both status and timing_stats
• Confirm runtime logs are significantly less verbose after this change (no more "Received STATUS command" / "Received STATS command" flooding)

Recommended test plan:

1. Start the runtime and connect openplc-web or openplc-editor
2. Observe that logs no longer show repeated STATUS/STATS command messages
3. Use curl or browser to verify: curl -k https://localhost:8443/api/status returns no timing_stats, while curl -k https://localhost:8443/api/status?include_stats=true includes timing_stats

Notes

This is Stage 1 of a 3-stage fix. Stage 2 (openplc-web) and Stage 3 (openplc-editor) will update the clients to use include_stats=true only when the orchestrators/device configuration screen is visible.

Link to Devin run: https://app.devin.ai/sessions/23f46f5fc2d44440a67eda96a6048254
Requested by: Thiago Alves (@thiagoralves)

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[Copilot]

Pull request overview

This PR reduces log flooding from frequent STATUS and STATS commands by making timing statistics optional and removing verbose debug logging. The changes prevent unnecessary mutex acquisition during status polls, which could impact PLC scan cycle performance.

Key changes:

• Added include_stats query parameter to /api/status endpoint (defaults to false)
• Removed debug log statements for all recognized commands (PING, STATUS, STOP, START, STATS, DEBUG)

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
webserver/app.py	Conditionally fetches timing stats only when include_stats=true parameter is provided
core/src/plc_app/unix_socket.c	Removes verbose debug logging for recognized commands and generic command receipt logs

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.