updates and proof of origin, additional workflow implementaion

Author: Magic-Man-us

.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-pre-commit"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/docs-pages.yml

@@ -0,0 +1,33 @@
+name: Deploy docs to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Sync dependencies with uv
+        run: uv sync --all-extras
+
+      - name: Build docs
+        run: uv run sphinx-build -b html docs docs/_build/html
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/_build/html
+          keep_files: false

.pre-commit-config.yaml

@@ -1,35 +1,29 @@
 # Pre-commit hooks for code quality
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
       - id: check-yaml
       - id: check-added-large-files
-      - id: check-merge-conflict
       - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.6
+    rev: v0.14.3
     hooks:
       - id: ruff
-        args: [--fix]
+        args: [--fix, --exit-non-zero-on-fix]
       - id: ruff-format
 
-  - repo: https://github.com/psf/black
-    rev: 23.11.0
-    hooks:
-      - id: black
-
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.7.0
+    rev: v1.18.2
     hooks:
       - id: mypy
         additional_dependencies:
           - pydantic>=2.5.0
-          - aiohttp>=3.9.0
-          - click>=8.1.0
-          - beautifulsoup4>=4.12.0
+          - types-click
         args: [--ignore-missing-imports]
-        exclude: ^tests/
+        files: ^src/

CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing
+
+Thank you for helping improve SecSuite! This short guide gets you up and running quickly.
+
+Developer quick-start
+---------------------
+
+1. Install `uv` (if you don't have it). Follow platform-specific instructions at https://docs.astral.sh/uv/.
+
+2. Sync the development environment and install dev dependencies:
+
+```bash
+make install
+```
+
+3. Common tasks
+
+- Run tests: `make test` or `./scripts/dev pytest`
+- Run lint: `make lint` or `./scripts/dev ruff check .`
+- Type check: `make type` or `./scripts/dev mypy src`
+- Build docs: `make docs` or `./scripts/dev sphinx-build -b html docs docs/_build`
+
+Pre-commit
+----------
+
+Install pre-commit hooks locally:
+
+```bash
+make precommit
+```
+
+Branching and PRs
+------------------
+
+- Create a branch for your feature/fix: `git checkout -b feature/thing`
+- Run tests and linters locally before opening a PR.
+- Open a PR against `main` and include a short description of the change and why.
+
+Thank you! Keep changes small and focused and include tests for new behavior.

Makefile

@@ -0,0 +1,44 @@
+SHELL := /bin/bash
+.PHONY: help install sync test lint type format docs precommit clean
+
+help:
+	@echo "Available targets:"
+	@echo "  make install    # install uv (if missing) and sync dependencies"
+	@echo "  make sync       # uv sync --all-extras"
+	@echo "  make test       # run tests with coverage"
+	@echo "  make lint       # run ruff"
+	@echo "  make type       # run mypy"
+	@echo "  make format     # format with ruff"
+	@echo "  make docs       # build Sphinx docs"
+	@echo "  make precommit  # install pre-commit hooks"
+	@echo "  make clean      # remove build artifacts"
+
+install:
+	@command -v uv >/dev/null 2>&1 || \
+	  { echo "uv not found. Please install uv in your Python environment. Example:"; \
+	    echo "  python -m pip install --upgrade pip && python -m pip install uv"; exit 1; }
+	uv sync --all-extras
+
+sync:
+	uv sync --all-extras
+
+test:
+	uv run pytest --cov
+
+lint:
+	uv run ruff check .
+
+type:
+	uv run mypy src
+
+format:
+	uv run ruff format .
+
+docs:
+	uv run sphinx-build -b html docs docs/_build
+
+precommit:
+	uv run pre-commit install
+
+clean:
+	rm -rf .venv build dist htmlcov coverage.xml coverage.json docs/_build