feat: scaffold ANGEL toolkit baseline

[nipudarsh]

Motivation

• Provide a production-grade scaffold for the ANGEL CLI + FastAPI web console to accelerate development and enforce project conventions.
• Include packaging, CI/CD, migrations, and automation so the project can be bootstrapped reproducibly across platforms.
• Lay down core building blocks (models, services, CLI wiring, web factory, templates) so feature development can proceed incrementally.
• Provide setup automation for both PowerShell and Bash to simplify first-run installation and Git setup.

Description

• Added project metadata and packaging in pyproject.toml, pinned requirements.txt / requirements-dev.txt, and configured formatting/linting via .pre-commit-config.yaml and pyproject.toml tools.
• Implemented CLI entrypoint and command wiring with stubs in angel_cli/ including cli.py, command modules, core helpers (core/config.py, core/auth.py, core/storage.py, core/database.py), SQLAlchemy base and models under angel_cli/models/, and a small service layer under angel_cli/services/.
• Created the FastAPI application factory in angel_web/app.py, minimal API route stubs under angel_web/api/routes/, Pydantic schemas under angel_web/api/schemas/, and HTML templates + static placeholders under angel_web/templates/ and angel_web/static/.
• Added Alembic migration stubs in migrations/, test scaffolding in tests/ (unit + integration), documentation under docs/ with mkdocs.yml, CI/CD workflows in .github/workflows/ (ci.yml, cd.yml, docs.yml), and automation scripts setup-angel.ps1 and setup-angel.sh for fully automated project bootstrapping.

Testing

• Added unit tests (tests/unit/test_auth.py) and an integration test (tests/integration/test_health.py) that exercise password hashing and the /api/system/health endpoint respectively.
• Local dependency installation (pip install -r requirements.txt) was attempted but failed due to network/proxy restrictions in the execution environment, so pytest was not executed here.
• CI workflow ci.yml is included to run linting, formatting checks, and the test suite on push/pull_request so tests will run automatically in GitHub Actions once dependencies are available.
• All created tests are present in the repository and ready to run once the environment can install the required packages.

---

Codex Task

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c5b61f80f5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".