Refactor codebase for improved readability and maintainability (#203)

Author: Cyber-Syntax

AGENTS.md

@@ -2,15 +2,30 @@
 
 This file provides guidance to agents when working with code in this repository.
 
-- API usage is currently GitHub-only; see [`docs/developers.md`](docs/developers.md:5) for future extensibility.
-- Catalog entries are JSON files in [`my_unicorn/catalog/`](my_unicorn/catalog/) with metadata for each app (see [`docs/wiki.md`](docs/wiki.md:276)).
-- App-specific configs are stored in `~/.config/my-unicorn/apps/` as JSON (see [`docs/wiki.md`](docs/wiki.md:335)).
-- Backup metadata for each app is in `~/Applications/backups/<app>/metadata.json` (see [`docs/wiki.md`](docs/wiki.md:491,505)).
-- Batch mode and concurrency are controlled via `~/.config/my-unicorn/settings.conf` (see [`docs/wiki.md`](docs/wiki.md:218,227)).
-- Verification requires digest/checksum fields in config/catalog; always use the public parse method for YAML/traditional formats ([`my_unicorn/services/verification_service.py`](my_unicorn/services/verification_service.py:233,263)).
-- For verification, if no strong methods and size check fails, raise error ([`my_unicorn/services/verification_service.py`](my_unicorn/services/verification_service.py:569,643)).
-- Always log full traceback on verification failures ([`my_unicorn/update.py`](my_unicorn/update.py:1100)).
-- CLI commands support install via URL, catalog, update, backup, cache, config, and auth (see [`docs/wiki.md`](docs/wiki.md:41)).
-- Manual CLI tests are run via [`scripts/test.bash`](scripts/test.bash:1); some require config files in `$HOME/.config/my-unicorn/apps/`.
-- Code style: line length 95, indent 4 spaces, double quotes for strings ([`pyproject.toml`](pyproject.toml:111,141)).
-- Pytest uses custom addopts and import mode: `-ra -q --strict-markers --import-mode=importlib--import-mode=importlib` ([`pyproject.toml`](pyproject.toml:67)).
+## General Guidelines
+
+1. Modern Python First: Use Python 3.12+ features extensively - built-in generics, pattern matching, and dataclasses.
+2. KISS Principle: Aim for simplicity and clarity. Avoid unnecessary abstractions or metaprogramming.
+3. DRY with Care: Reuse code appropriately but avoid over-engineering. Each command handler has single responsibility.
+
+## Test after any change
+
+1. Activate venv before any test execution:
+
+```bash
+source .venv/bin/activate
+```
+
+2. Run pytest with following command to ensure all tests pass:
+
+```bash
+pytest -v -q --strict-markers
+```
+
+## Run the application
+
+```bash
+python run.py --help
+python run.py install appflowy
+python run.py update appflowy
+```

CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## v1.7.0-alpha
+# CHANGES
+This release refactors the codebase for improved code readability, maintainability and performance.
+
+- Removed size verification logic which it was not best practice to verify app integrity.
+
 ## v1.6.0-alpha
 # BREAKING CHANGES
 This release introduces a comprehensive caching mechanism for GitHub release data, enhancing performance and reducing redundant API calls. The caching system is designed to store release information persistently, with a configurable time-to-live (TTL) to ensure data freshness. Additionally, the release includes significant improvements to the logging capabilities of the verification service, providing detailed insights into the verification process and asset handling.