Update and stabilize codebase to match current development state

**Description**

The repository currently reflects last year’s implementation. Since then, I’ve made several updates and improvements locally, including changes to core functionality and structure. This update brings the codebase in sync with those modifications to ensure everything runs correctly and aligns with the current version of the project.

This change is focused on establishing a stable and up-to-date baseline. Additional enhancements, optimizations, and feature improvements will be addressed in subsequent issues to keep changes modular and easier to review.

No files, tests, or entry points are identified in the issue. Start by reviewing the repository and comparing its current state with the claimed local updates; done means the codebase matches that version, runs correctly, and establishes the stated stable baseline.

Written by the indexing model from the issue text.