[RTOP-69] implement base code to commands

[lucasbutzke]

1. run_compile() Function - Program Compilation

Compiles a program and manages the entire build process.

What it does:

Starts compilation: Executes a bash script (compile.sh)
Monitors progress: Shows real-time output and error messages
Manages build state: Tracks compiling/success/failed status
Handles system restart: Stops and starts the PLC controller after compilation
Performs cleanup: Runs a cleanup script (compile-clean.sh)
Step-by-step flow:

Sets status to "COMPILING"
Starts the compilation script
Creates threads to monitor process output
Waits for compilation to complete
If successful: stops PLC, runs cleanup, restarts PLC
If failed: shows error message

2. handle_upload_file() Function - File Upload Handling

Receives a ZIP file, validates it, and extracts contents.

What it does:

Validations: Checks file safety (prevents zip bombs)
Preparation: Cleans old directory and extracts new ZIP
Initiates compilation: Calls compilation function in separate thread
Validation checks:

✅ Verifies no active compilation is running
✅ Confirms file exists in request
✅ Checks file size limits
✅ Analyzes ZIP safety
✅ Extracts only valid files

Complete Flow:
Upload ZIP → Validate → Clean folder → Extract → Compile → Stop PLC → Move file → Start PLC

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

---

Note

🎁 Summarized by CodeRabbit Free

Your organization has reached its limit of developer seats under the Pro Plan. For new users, CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please add seats to your subscription by visiting https://app.coderabbit.ai/login.If you believe this is a mistake and have available seats, please assign one to the pull request author through the subscription management page using the link above.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Copilot]

Pull Request Overview

Implements base code for PLC program management commands including compilation, file upload handling, and runtime process management. This replaces the legacy openplc.py system with a more robust architecture.

• Introduces RuntimeManager class for managing PLC runtime processes with auto-restart capability
• Implements secure ZIP file upload with safety validation and compilation pipeline
• Refactors command handling to use modern patterns with proper error handling

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
webserver/unixclient.py	Adds STATUS command support to the Unix socket client
webserver/runtimemanager.py	New runtime manager class for PLC process lifecycle management
webserver/plcapp_management.py	New module for secure ZIP file handling and compilation management
webserver/app.py	Refactors main application to use new runtime and compilation systems
webserver/openplc.py	Removes legacy OpenPLC runtime implementation
webserver/credentials.py	Removes default parameters from certificate generation method
test_api.py	Removes existing API tests
conftest.py	Removes test configuration file
scripts/compile.sh	Moves cleanup operations to separate script
scripts/compile-clean.sh	New cleanup script for post-compilation operations
install.sh	Adds PLC application build step to installation
core/src/plc_app/utils/log.c	Fixes socket logging implementation
core/src/plc_app/unix_socket.c	Improves command handling and adds proper STATUS implementation
.pre-commit-config.yaml	Adds comment explaining clang-format configuration

Comments suppressed due to low confidence (2)

webserver/plcapp_management.py:1

• Variable client is not defined in this function scope. The run_compile function expects a SyncUnixClient parameter but no client is available here.

from dataclasses import dataclass, field

webserver/plcapp_management.py:1

• The analyze_zip function expects a file path string but zip_file is a FileStorage object from Flask. Should save the file first and pass the path to analyze_zip.

from dataclasses import dataclass, field

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}