feat: complete release v5.0.0 (Covenant) architectures, contract verification and lint/style fixes

Author: hillpatel-cr

.flake8

@@ -0,0 +1,4 @@
+[flake8]
+max-line-length = 100
+ignore = E203, W503
+exclude = .git, __pycache__, build, dist, temp_tests, temp_tests_augmented

.github/workflows/pypi-publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  pypi-publish:
+    name: Build and publish Python distribution to PyPI
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build binary wheel and source tarball
+        run: python -m build
+
+      - name: Check package metadata description
+        run: python -m twine check dist/*
+
+      - name: Publish package distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API }}

.github/workflows/python-app.yaml

@@ -117,53 +117,38 @@ jobs:
       - name: CLI Test - Help
         run: imgshape --help
 
-      - name: CLI Test - Version (non-blocking)
-        run: imgshape --version || true
-
-      - name: CLI Test - Shape detection
-        run: python -m imgshape.cli --path sample/test.png --shape
-
-      - name: CLI Test - Analysis
-        run: python -m imgshape.cli --path sample/test.png --analyze
-
-      - name: CLI Test - Recommendation
-        run: python -m imgshape.cli --path sample/test.png --recommend --augment
-
-      - name: CLI Test - Report (Markdown) (non-blocking)
-        run: python -m imgshape.cli --path sample --report --augment --out tmp/ci_report.md || true
-
-      - name: CLI Test - Report (HTML) (non-blocking)
-        run: python -m imgshape.cli --path sample --report --augment --out tmp/ci_report.html || true
-
-      - name: CLI Test - Visualization (non-blocking) — run script
+      - name: Create Test Contract
         shell: bash
         run: |
-          # run deterministic script that attempts to generate an interactive plot (if viz available)
-          mkdir -p .github/scripts
-          python .github/scripts/plot_test.py || true
+          cat << 'EOF' > tmp/test_contract.yaml
+          schema_version: "5.0"
+          dataset:
+            expected_channels: 3
+            allowed_formats: [png, jpg]
+            resolution_min: [100, 100]
+          quality:
+            blur_threshold: 1.0
+          EOF
 
-      - name: CLI Test - Model Compatibility (non-blocking)
-        run: python -m imgshape.cli --dir sample --check mobilenet_v2 || true
+      - name: CLI Test - Validate Contract
+        run: imgshape validate sample tmp/test_contract.yaml --lock
 
-      - name: CLI Test - TorchLoader (transform snippet) (non-blocking)
-        run: python -m imgshape.cli --path sample --torchloader --out tmp/transform_snippet.py || true
+      - name: CLI Test - Run Dataset Tests (Markdown)
+        run: imgshape test sample tmp/test_contract.yaml --output markdown --save tmp/test_report.md
 
-      # ---- v4 Atlas Tests ----
-      - name: CLI Test - v4 Fingerprint
-        run: imgshape --fingerprint --path sample --out tmp/v4_fingerprint.json
+      - name: CLI Test - Run Dataset Tests (JSON)
+        run: imgshape test sample tmp/test_contract.yaml --output json --save tmp/test_report.json
 
-      - name: CLI Test - v4 Atlas Analyze
-        run: imgshape --atlas --path sample --intent training --out tmp/v4_analysis.json
+      - name: CLI Test - Extract Fingerprint
+        run: imgshape fingerprint sample --save tmp/baseline_fingerprint.json
 
-      - name: CLI Test - v4 Decisions
-        run: imgshape --decisions --path sample --intent training --out tmp/v4_decisions.json
+      - name: CLI Test - Diff Datasets
+        run: imgshape diff tmp/baseline_fingerprint.json sample
 
+      # ---- Run Test Suite ----
       - name: Run pytest (all tests)
         run: pytest -q --disable-warnings --maxfail=1
 
-      - name: Run pytest (v4 tests only)
-        run: pytest tests/v4_test.py -v --disable-warnings
-
       - name: Build distributions
         run: python -m build
 

.gitignore

@@ -170,3 +170,9 @@ docs/_build/
 
 .vercel
 .env*.local
+
+temp_tests/
+docs/
+.antigravitycli/
+.todos/
+temp_tests_augmented/

CHANGELOG.md

@@ -5,6 +5,22 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [5.0.0] - 2026-05-30
+
+### v5.0.0 "Covenant"
+
+The **v5.0.0** release is a ground-up architectural pivot from a local web/dashboard service into a lean, developer-first **dataset governance and contract enforcement engine**. It provides CI/CD-native verification tools and Python APIs to guarantee dataset quality, integrity, and reproducibility.
+
+**Highlights:**
+- **Vision Dataset Governance**: Declarative YAML contracts validation with JSON schema support and clause-specific severity overrides (`error` or `warning`).
+- **Atlas Profiler Suite**: A unified engine divided into 5 distinct profilers (Spatial, Signal, Distribution, Quality, Semantic) computing deterministic, cross-platform metrics.
+- **Test Runner (`imgshape test`)**: Pytest-style vision dataset assertions with tabular CLI reporting and markdown/JSON output renderers.
+- **Dataset Diff Engine (`imgshape diff`)**: Git-like comparison of baseline and candidate datasets/fingerprints measuring class distribution, entropy shifts, and semantic drift (DINOv2). Exits with exit code `1` on significant drift.
+- **Deterministic Audit Trails**: Cryptographically robust SHA256 content-based `provenance_id` and cross-platform `.fingerprint_lock` lockfiles for dataset version verification.
+- **Lean Packaging**: Removed all web components (React UI, Streamlit, FastAPI, Uvicorn, Docker, Cloud Run configurations) reducing dependency footprint and package size.
+
+---
+
 ## [4.2.0] - 2026-04-16
 
 ### v4.2.0 "Bento Intelligence"