docs(manual): complete professional user guide (#25)

* docs(manual): complete, professional user guide

* ci: stabilize build (poetry, lint, tests, mypy, smoke)

* docs(manual): complete professional user guide

Author: CoderDeltaLAN

.github/workflows/build.yml

@@ -0,0 +1,66 @@
+name: CI / build
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: build (${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ "3.11", "3.12" ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Upgrade pip
+        run: python -m pip install --upgrade pip
+
+      - name: Install Poetry
+        run: pip install poetry
+
+      - name: Install dependencies
+        run: poetry install --no-interaction
+
+      - name: Ruff
+        run: poetry run ruff check .
+
+      - name: Black (check)
+        run: poetry run black --check .
+
+      - name: Pytest
+        env:
+          PYTHONPATH: src
+        run: poetry run pytest -q
+
+      - name: Mypy
+        run: poetry run mypy src
+
+      - name: Package & smoke-test CLI
+        run: |
+          poetry build
+          poetry run python -m pip install .
+          mkdir -p _intel
+          diff-risk examples/sample_apv.json -f md -o _intel/report.md
+
+      - name: Upload sample report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: sample-report
+          path: _intel/report.md

README.md

@@ -1,12 +1,14 @@
 # ⭐ diff-risk-dashboard — APV → Risk Summary (Python CLI)
 
-
-[![Manual](https://img.shields.io/badge/Manual-User%20Guide-blue?style=for-the-badge)](docs/MANUAL.md)
 A lean, production-grade **Python CLI** that ingests **ai-patch-verifier (APV)** JSON and outputs a clear **risk summary** (table / JSON / Markdown).  
 Designed for **always-green CI**, with strict checks and exit codes per risk level to gate merges professionally.
 
 <div align="center">
 
+[![Manual](https://img.shields.io/badge/Manual-User%20Guide-blue?style=for-the-badge)](docs/MANUAL.md)
+
+<br/>
+
 [![CI / build](https://github.com/CoderDeltaLAN/diff-risk-dashboard/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/CoderDeltaLAN/diff-risk-dashboard/actions/workflows/build.yml)
 [![CodeQL Analysis](https://github.com/CoderDeltaLAN/diff-risk-dashboard/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/CoderDeltaLAN/diff-risk-dashboard/actions/workflows/codeql.yml)
 [![Release](https://img.shields.io/github/v/release/CoderDeltaLAN/diff-risk-dashboard?display_name=tag)](https://github.com/CoderDeltaLAN/diff-risk-dashboard/releases)
@@ -17,7 +19,6 @@ Designed for **always-green CI**, with strict checks and exit codes per risk lev
 </div>
 
 ---
-
 ## Repo layout
 
 ```text