Refactor project structure and improve Github Actions performance

[kox13]

Closes #28, Closes #27

Summary

This PR introduces a structural refactor of the repository to properly isolate the agent service and improves developer and CI tooling consistency.

It combines:

• repository restructuring for the agent service
• CI performance improvements (vcpkg caching)
• developer workflow enhancements (pre-commit hook + config template)

---

Repository restructuring

The project structure has been updated to isolate the agent service into a dedicated directory:

Changes

• Moved all agent-related build system files into: sources/agent/
• Migrated:
• CMakeLists.txt
• libs/
• build-related configuration
• Updated all affected paths in:
  • GitHub Actions workflows
  • CMake configuration
  • build scripts
  • vcpkg integration

---

CI improvements

Improved GitHub Actions performance by introducing proper caching for vcpkg dependencies using caching strategy in CI workflows. Additionally, replaced manual apt-get based tool installation with aminya/setup-cpp@v1.This provides a faster and more consistent setup for required C++ tooling (e.g. clang-format, cppcheck), reducing CI setup time and improving reproducibility.

Improvements:

• Added cache for vcpkg artifacts and installed packages
• Cache key based on OS and dependency manifest (vcpkg.json)
• Reduced redundant dependency rebuilds on CI runs

---

Developer tooling improvements

Pre-commit hook integration

During CMake configuration, a pre-commit hook is now copied into: .git/hooks/

Behavior:

• The hook triggers formatting checks before commit
• Executes CMake target: check-format
• Runs formatting validation on: sources/agent/src

Benefit:

• Ensures consistent code style before code reaches CI
• Reduces formatting-related CI failures

---

Configuration improvements

Added a sample configuration file for local development: sources/agent/agent.example.conf

Purpose:

• Provides a template for local agent configuration

[FW-Nagorko]

Build works correctly.