Feat/Fix and release

[k5602]

This pull request introduces major improvements to the build system, continuous integration, documentation, and benchmarking for the gthreads project. The changes add a CI workflow, expand the CMake build to include architecture-specific assembly and new source files, update the documentation for clarity and completeness, and introduce a suite of performance benchmarks for context switching, thread creation, mutex, and semaphore operations.

Build System and CI Improvements:

• Added a comprehensive GitHub Actions CI workflow (.github/workflows/ci.yml) that runs formatting checks, builds, tests, and sanitizer checks on multiple compilers and build types, ensuring code quality and correctness on every push and pull request.
• Updated CMakeLists.txt to:
  • Add support for x86_64 assembly context switching by conditionally including src/context/ctx_x86_64.S.
  • Include new trace, replay, and fuzzing source files in the build. [1] [2]
  • Add new tests, example programs, and benchmark executables for easier validation and demonstration.
  • Expand formatting targets to cover new source, example, and benchmark files.

Documentation Updates:

• Rewrote the README.md to provide a clear project overview, rationale, build instructions, performance metrics, API summary, and links to architectural and testing documentation. This makes the project much more accessible to new contributors and users.

Benchmark Suite:

• Added four new benchmark programs to the benchmarks/ directory:
  • bench_context_switch.c: Measures context switch latency.
  • bench_thread_create.c: Measures thread creation and join overhead.
  • bench_mutex.c: Measures mutex lock/unlock throughput under contention.
  • bench_semaphore.c: Measures semaphore throughput in a producer-consumer scenario.

These changes significantly improve the project's robustness, usability, and ability to measure and communicate performance.

---

Most important changes:

Build System and CI:

• Added a full CI workflow for formatting, building, testing, and sanitizer checks on push and PR events in .github/workflows/ci.yml.
• Updated CMakeLists.txt to support x86_64 assembly context switching, add new source files for tracing, replay, and fuzzing, and build new tests, examples, and benchmarks. [1] [2] [3] [4]

Documentation:

• Rewrote README.md for clarity, providing project overview, rationale, build instructions, performance data, API summary, and documentation links.

Benchmarking:

• Introduced new benchmarks for context switching (bench_context_switch.c), thread creation (bench_thread_create.c), mutex throughput (bench_mutex.c), and semaphore throughput (bench_semaphore.c). [1] [2] [3] [4]