drift-analyzer 0.5.0__tar.gz

drift_analyzer-0.5.0/.git

@@ -0,0 +1 @@
+gitdir: ../.git/modules/drift

drift_analyzer-0.5.0/.githooks/commit-msg

@@ -0,0 +1,28 @@
+#!/usr/bin/env sh
+# commit-msg hook — enforce Conventional Commits format
+# Install with: git config core.hooksPath .githooks
+#
+# Allowed prefixes: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
+# Format: type(scope): description  OR  type: description
+
+commit_msg_file="$1"
+commit_msg=$(head -1 "$commit_msg_file")
+
+# Allow merge commits and fixup/squash commits
+if echo "$commit_msg" | grep -qE "^(Merge|fixup!|squash!) "; then
+    exit 0
+fi
+
+pattern="^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?: .{1,}"
+
+if ! echo "$commit_msg" | grep -qE "$pattern"; then
+    echo ">>> [commit-msg] ERROR: Commit message does not follow Conventional Commits."
+    echo ""
+    echo "    Expected format:  type(scope): description"
+    echo "    Example:          feat(scoring): add count dampening"
+    echo ""
+    echo "    Allowed types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert"
+    echo ""
+    echo "    Your message:     $commit_msg"
+    exit 1
+fi

drift_analyzer-0.5.0/.githooks/pre-commit

@@ -0,0 +1,25 @@
+#!/usr/bin/env sh
+# pre-commit hook — block private paths + fast lint on staged files
+# Install once with: git config core.hooksPath .githooks
+set -e
+
+blocked_pattern='^(tagesplanung/)'
+
+staged_blocked=$(git diff --cached --name-only --diff-filter=ACMR | grep -E "$blocked_pattern" || true)
+
+if [ -n "$staged_blocked" ]; then
+    echo ">>> [pre-commit] ERROR: Blocked paths detected in staged changes:"
+    echo "$staged_blocked"
+    echo ">>> [pre-commit] Remove these files from staging before commit."
+    exit 1
+fi
+
+# Fast lint on staged Python files (errors + import order only, <1s).
+# Full lint + typecheck + tests run in pre-push.
+staged_py=$(git diff --cached --name-only --diff-filter=ACMR -- '*.py' || true)
+if [ -n "$staged_py" ]; then
+    if command -v ruff >/dev/null 2>&1; then
+        echo ">>> [pre-commit] Running ruff quick-check on staged files..."
+        echo "$staged_py" | xargs ruff check --select E,F,I --no-fix
+    fi
+fi

drift_analyzer-0.5.0/.githooks/pre-push

@@ -0,0 +1,68 @@
+#!/usr/bin/env sh
+# pre-push hook — mirrors CI checks (version-check + lint + typecheck + test + self-analysis)
+# Install once with: git config core.hooksPath .githooks
+set -e
+
+# Block private/non-tool paths from being pushed.
+blocked_pattern='^(tagesplanung/)'
+
+reject_push_for_blocked_paths() {
+	local_ref="$1"
+	local_sha="$2"
+	remote_ref="$3"
+	remote_sha="$4"
+
+	# Deletion push (local ref removed) can be ignored here.
+	if [ "$local_sha" = "0000000000000000000000000000000000000000" ]; then
+		return 0
+	fi
+
+	if [ "$remote_sha" = "0000000000000000000000000000000000000000" ]; then
+		commit_list=$(git rev-list "$local_sha" --not --all)
+	else
+		commit_list=$(git rev-list "$remote_sha..$local_sha")
+	fi
+
+	for commit in $commit_list; do
+		blocked_hits=$(git diff-tree --no-commit-id --name-only --diff-filter=ACMR -r "$commit" | grep -E "$blocked_pattern" || true)
+		if [ -n "$blocked_hits" ]; then
+			echo ">>> [pre-push] ERROR: Blocked paths detected in commits for $local_ref -> $remote_ref"
+			echo "$blocked_hits"
+			echo ">>> [pre-push] Remove these files from the commit history before pushing."
+			exit 1
+		fi
+	done
+}
+
+while read local_ref local_sha remote_ref remote_sha; do
+	reject_push_for_blocked_paths "$local_ref" "$local_sha" "$remote_ref" "$remote_sha"
+done
+
+echo ">>> [pre-push] Starting local CI checks..."
+
+# Unset git context variables that git injects when running hooks.
+# Without this, tests that create git repos in tmp dirs inherit GIT_DIR
+# from the parent repo and fail with exit 128 ("not a git repository").
+unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE GIT_OBJECT_DIRECTORY GIT_COMMON_DIR
+
+# 1. Version format (SemVer)
+echo ">>> [1/5] Checking SemVer version..."
+python scripts/check_version.py --check-semver
+
+# 2. Lint
+echo ">>> [2/5] Running ruff lint..."
+ruff check src/ tests/
+
+# 3. Type checking
+echo ">>> [3/5] Running mypy..."
+python -m mypy src/drift
+
+# 4. Tests with coverage (exclude slow smoke tests that clone external repos)
+echo ">>> [4/5] Running pytest + coverage (excl. smoke tests)..."
+pytest -v --tb=short --cov --cov-report=term-missing --ignore=tests/test_smoke_real_repos.py
+
+# 5. Self-analysis
+echo ">>> [5/5] Running self-analysis..."
+drift analyze --repo . --format json > /dev/null
+
+echo ">>> [pre-push] All checks passed. Push continues."

drift_analyzer-0.5.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: "Bug Report"
+about: "Something isn't working as expected"
+title: "[Bug] "
+labels: ["bug"]
+assignees: []
+---
+
+## Describe the bug
+
+A clear description of what the bug is.
+
+## To reproduce
+
+```bash
+# Command you ran
+drift analyze --repo /path/to/project
+
+# Or: paste the relevant config
+```
+
+**Python version:** <!-- e.g. 3.12 -->
+**drift-analyzer version:** <!-- drift --version -->
+**OS:** <!-- e.g. Ubuntu 22.04, macOS 14, Windows 11 -->
+
+## Expected behaviour
+
+What you expected to happen.
+
+## Actual behaviour
+
+What actually happened. Include the full error output if applicable.
+
+## Additional context
+
+<!-- Stack trace, drift.yaml contents, anything else relevant -->

drift_analyzer-0.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions and usage help
+    url: https://github.com/sauremilk/drift/discussions
+    about: Please ask and answer general questions in Discussions.
+  - name: Documentation
+    url: https://sauremilk.github.io/drift/
+    about: Check the docs site for setup, configuration, and examples.
+  - name: Security report
+    url: https://github.com/sauremilk/drift/security/policy
+    about: Please report security vulnerabilities via the Security Policy page.

drift_analyzer-0.5.0/.github/ISSUE_TEMPLATE/false_positive.md

@@ -0,0 +1,39 @@
+---
+name: "False Positive / False Negative"
+about: "Drift is flagging something incorrectly, or missing a real issue"
+title: "[FP/FN] "
+labels: ["signal-quality"]
+assignees: []
+---
+
+## Signal affected
+
+<!-- Which signal produced the false result? -->
+
+- [ ] Pattern Fragmentation (PFS)
+- [ ] Architecture Violations (AVS)
+- [ ] Mutant Duplicates (MDS)
+- [ ] Explainability Deficit (EDS)
+- [ ] Temporal Volatility (TVS)
+- [ ] System Misalignment (SMS)
+
+## False positive or false negative?
+
+- [ ] False positive — drift flagged something that isn't a real issue
+- [ ] False negative — drift missed something that is a real issue
+
+## Code example
+
+```python
+# Paste the relevant code snippet here
+```
+
+## Why this is incorrect
+
+Explain why drift's assessment is wrong in this case.
+
+## drift.yaml config (if any)
+
+```yaml
+
+```

drift_analyzer-0.5.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: "Feature Request"
+about: "Suggest a new signal, output format, or improvement"
+title: "[Feature] "
+labels: ["enhancement"]
+assignees: []
+---
+
+## Problem / motivation
+
+What problem does this solve? What's the current limitation?
+
+## Proposed solution
+
+Describe the feature you'd like. Be as specific as possible.
+
+## Alternatives considered
+
+Any alternative approaches you've thought about?
+
+## Would you like to contribute?
+
+- [ ] Yes, I'd like to open a PR for this
+- [ ] No, just requesting it

drift_analyzer-0.5.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,35 @@
+## Summary
+
+<!-- What changed and why? -->
+
+## Related issue
+
+<!-- Use: Closes #123 / Fixes #123 / Related #123 -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor
+- [ ] Documentation
+- [ ] Test-only change
+- [ ] CI/Build change
+
+## Validation
+
+- [ ] `pytest` passes locally
+- [ ] `ruff check src/ tests/` passes locally
+- [ ] `mypy src/drift` passes locally
+- [ ] `drift self` delta checked (target: <= +0.010)
+- [ ] Added/updated tests for behavioral changes
+
+## Checklist
+
+- [ ] PR is focused on one concern
+- [ ] Public docs updated (README/docs-site) if needed
+- [ ] Changelog entry added if user-visible
+- [ ] No unrelated files included
+
+## Notes for reviewers
+
+<!-- Anything that needs special attention during review -->

drift_analyzer-0.5.0/.github/copilot-instructions.md

@@ -0,0 +1,163 @@
+# Drift — Verbindliche Arbeitsgrundlage für alle Agenten
+
+**Diese Datei ist für alle Copilot-Agenten, Coding-Agenten und KI-Assistenten im Drift-Workspace bindend.**
+
+Die vollständige Policy befindet sich in:
+`POLICY.md` (Workspace-Root)
+
+Lies diese Datei **vor jeder Arbeit** vollständig, sofern sie nicht bereits im Kontext ist.
+Die Policy ist ein Vertrag — keine Empfehlung, kein Vorschlag.
+
+---
+
+## PFLICHT-GATE: Zulässigkeitsprüfung vor jeder Aufgabe
+
+**Vor jeder Antwort, die eine Änderung, ein Feature, eine Analyse oder eine Umsetzung enthält, MUSS der Agent dieses Gate sichtbar ausgeben:**
+
+```
+### Drift Policy Gate
+- Aufgabe: [Kurzbeschreibung der Aufgabe in einem Satz]
+- Zulassungskriterium erfüllt: [JA / NEIN] → [welches Kriterium: Unsicherheit / Signal / Glaubwürdigkeit / Handlungsfähigkeit / Trend / Einführbarkeit]
+- Ausschlusskriterium ausgelöst: [JA / NEIN] → [falls JA: welches]
+- Roadmap-Phase: [Phase 1 / 2 / 3 / 4] — blockiert durch höhere Phase: [JA / NEIN]
+- Entscheidung: [ZULÄSSIG / ABBRUCH]
+- Begründung: [ein Satz]
+```
+
+**Bei Entscheidung ABBRUCH:** Keine weitere Umsetzung. Stattdessen: kurze Erklärung, welches Kriterium verletzt wird und was stattdessen priorisiert werden sollte.
+
+**Das Gate darf nicht übersprungen werden.** Auch nicht bei kleinen Änderungen, Refactorings oder scheinbar offensichtlichen Aufgaben.
+
+---
+
+## Nicht verhandelbare Grundregeln
+
+### Was Drift ist
+Drift ist ein statischer Analyzer zur Erkennung architektonischer Kohärenzprobleme.
+Zweck: strukturelle Erosion erkennen, benennen, priorisieren, über Zeit vergleichbar machen.
+
+### Was Drift nicht ist
+- Drift ist kein Tool, das lediglich Probleme auflistet.
+- Drift erzeugt keine dekorativen Ergebnisse.
+- Drift priorisiert keine Ergebnisse ohne realen Zusammenhang mit struktureller Kohärenz.
+
+---
+
+## Absolute Ausschlusskriterien für neue Arbeit
+
+**Keine Aufgabe darf begonnen werden**, die ausschließlich folgendes erzeugt:
+- mehr Ausgabe ohne besseren Erkenntniswert
+- mehr Komplexität ohne klaren Nutzen
+- mehr Oberfläche ohne bessere Analyse
+- mehr Analyse ohne Validierung des Ergebnisses
+- mehr technische Ausarbeitung ohne Beitrag zur Produktwirkung
+- einen Nutzen, der nicht eindeutig benennbar ist
+
+---
+
+## Priorisierungsformel (Policy §6)
+
+```
+Priorität = (Unsicherheit × Schaden × Nutzbarkeit) / Aufwand
+```
+
+Bei konkurrierenden Vorhaben gilt diese feste Reihenfolge:
+1. Glaubwürdigkeit erhalten
+2. Signalpräzision verbessern
+3. Verständlichkeit der Befunde verbessern
+4. False Positives / False Negatives reduzieren
+5. Einführbarkeit verbessern
+6. Trendanalyse verbessern
+7. Zusätzliche Features, Formate, Komfortmerkmale
+
+**Eine niedrigere Stufe verdrängt niemals eine höhere.**
+
+---
+
+## Qualitätsanforderungen an jeden Befund (Policy §13)
+
+Jeder Befund muss besitzen:
+- technische Nachvollziehbarkeit
+- Reproduzierbarkeit
+- eindeutige Zuordnung zu einer Ursache
+- klare Benennung der betroffenen Stelle
+- nachvollziehbare Begründung
+- erkennbare nächste Maßnahme
+
+Ein Befund ohne klare Begründung ist **unzulässig**.
+Ein Befund ohne mögliche nächste Maßnahme ist **unvollständig**.
+
+---
+
+## Zulassungskriterien für neue Arbeit (Policy §8)
+
+Eine Aufgabe darf nur begonnen werden, wenn sie mindestens eines erfüllt:
+- reduziert eine zentrale Unsicherheit
+- verbessert die Signalqualität
+- erhöht die Glaubwürdigkeit
+- erhöht die Handlungsfähigkeit
+- verbessert die Trendfähigkeit
+- erleichtert die Einführbarkeit
+
+---
+
+## Roadmap-Phasen-Hierarchie (Policy §14)
+
+**Phase 1 — Vertrauen** (Vorrang vor allem anderen):
+Nachvollziehbarkeit → Reproduzierbarkeit → Fehlalarmreduktion → Erklärbarkeit
+
+**Phase 2 — Relevanz** → **Phase 3 — Einführbarkeit** → **Phase 4 — Skalierung**
+
+Phase 4 verdrängt niemals Phase 1.
+Skalierungsmaßnahmen ohne gesichertes Vertrauen sind **nachrangig**.
+
+---
+
+## Entscheidungsregel bei Unklarheit (Policy §16)
+
+> Wähle die Option, die die größte Unsicherheit reduziert.
+> Sind mehrere gleich gut: höchsten Erkenntniswert pro Aufwandseinheit.
+> Ist keine Option hinreichend begründet: **keine Umsetzung**.
+
+---
+
+## Schlussbestimmung
+
+Diese Policy ist verbindlich (Policy §18).
+Abweichungen sind nur zulässig wenn: dokumentiert, begründet, als Ausnahme gekennzeichnet.
+Im Zweifel gilt: geringerer Interpretationsspielraum, höherer Erkenntniswert.
+
+---
+
+## Schnellreferenz für Agenten
+
+Vollständiger Developer Guide: **[DEVELOPER.md](../DEVELOPER.md)**
+
+### Architektur (Datenfluss)
+
+```
+ingestion/ → signals/ → scoring/ → output/
+  AST + Git     7 Detektoren   Score+Severity   Rich/JSON/SARIF
+```
+
+### Wichtigste Kommandos
+
+| Aufgabe | Befehl |
+|---------|--------|
+| Dev-Setup | `make install` |
+| Alle Checks | `make check` |
+| Nur Tests (schnell) | `make test-fast` |
+| Lint + Autofix | `make lint-fix` |
+| CI lokal replizieren | `make ci` |
+| Selbstanalyse | `make self` |
+
+### Verzeichnisstruktur
+
+| Pfad | Inhalt |
+|------|--------|
+| `src/drift/signals/` | 7 Signale (PFS, AVS, MDS, EDS, TVS, SMS, DIA) |
+| `src/drift/ingestion/` | AST-Parsing, Git-History, File-Discovery |
+| `src/drift/scoring/` | Composite-Score, Module-Scores, Severity |
+| `src/drift/output/` | Rich-Terminal, JSON, SARIF |
+| `src/drift/commands/` | Click-CLI-Subcommands |
+| `tests/` | 27+ Testdateien, conftest.py mit tmp_repo Fixture |

drift_analyzer-0.5.0/.github/instructions/drift-policy.instructions.md

@@ -0,0 +1,57 @@
+---
+applyTo: "**"
+description: "Drift Policy — Bindende Arbeitsregeln für alle Dateien. MUSS gelesen werden bevor Änderungen an Drift-Code, Analyselogik, Ergebnisformaten oder Features vorgenommen werden."
+---
+
+# Drift — Policy (bindend für alle Dateioperationen)
+
+Vollständige Policy: `POLICY.md` im Workspace-Root.
+Kurzfassung der Kern-Verbote und Anforderungen:
+
+## PFLICHT-GATE: Zulässigkeitsprüfung — immer zuerst ausführen und ausgeben
+
+Vor jeder Umsetzung dieses Format sichtbar ausgeben:
+
+```
+### Drift Policy Gate
+- Aufgabe: [Kurzbeschreibung in einem Satz]
+- Zulassungskriterium erfüllt: [JA / NEIN] → [Unsicherheit / Signal / Glaubwürdigkeit / Handlungsfähigkeit / Trend / Einführbarkeit]
+- Ausschlusskriterium ausgelöst: [JA / NEIN] → [falls JA: welches]
+- Roadmap-Phase: [1 / 2 / 3 / 4] — blockiert durch höhere Phase: [JA / NEIN]
+- Entscheidung: [ZULÄSSIG / ABBRUCH]
+- Begründung: [ein Satz]
+```
+
+Bei **ABBRUCH**: keine Umsetzung, stattdessen Erklärung + Gegenvorschlag.
+Das Gate darf **niemals übersprungen** werden.
+
+---
+
+## Vor jeder Änderung prüfen
+
+**Ist die Aufgabe zulässig?** Sie muss mindestens eines erfüllen:
+- reduziert eine zentrale Unsicherheit
+- verbessert die Signalqualität oder Glaubwürdigkeit
+- erhöht die Handlungsfähigkeit
+- verbessert Trendfähigkeit oder Einführbarkeit
+
+**Ist die Aufgabe unzulässig?** Sofort abbrechen, wenn sie ausschließlich erzeugt:
+- mehr Ausgabe ohne Erkenntniswert
+- mehr Komplexität ohne klaren Nutzen
+- ein Feature, dessen Beitrag nicht klar benennbar ist
+
+## Pflicht bei Code-Änderungen an Analyseergebnissen
+
+Jedes Ergebnis/Befund benötigt zwingend:
+1. technische Nachvollziehbarkeit
+2. Reproduzierbarkeit  
+3. eindeutige Ursachenzuordnung
+4. nachvollziehbare Begründung
+5. erkennbare nächste Maßnahme
+
+Fehlt eines dieser fünf Elemente → Änderung ist **unzulässig**.
+
+## Prioritätsbindung
+
+Reihenfolge ist nicht verhandelbar:
+`Glaubwürdigkeit > Signalpräzision > Verständlichkeit > FP/FN-Reduktion > Einführbarkeit > Trend > Features`

drift_analyzer-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,79 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+jobs:
+  version-check:
+    name: Version format check
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Validate pyproject.toml version is SemVer
+        # Ensures the version in pyproject.toml is always MAJOR.MINOR.PATCH –
+        # a merge to master with an invalid or missing version is blocked.
+        run: python scripts/check_version.py --check-semver
+
+  test:
+    runs-on: ubuntu-latest
+    needs: version-check
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Full history for git-based signals
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check src/ tests/
+
+      - name: Type-check with mypy
+        run: python -m mypy src/drift
+
+      - name: Run tests with coverage
+        run: pytest -v --tb=short --cov=drift --cov-report=xml --cov-report=term-missing -m "not slow"
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+      - name: Self-analysis
+        run: drift analyze --repo . --format json > /dev/null
+
+      - name: Drift self-check (score gate)
+        if: matrix.python-version == '3.12'
+        run: |
+          drift self --format json > drift_score.json
+          python -c "
+          import json, sys
+          data = json.load(open('drift_score.json'))
+          score = data['drift_score']
+          if score > 0.47:
+              print(f'FAIL: drift self score {score:.3f} exceeds threshold 0.47')
+              sys.exit(1)
+          print(f'OK: drift self score {score:.3f} (threshold 0.47)')
+          "

drift_analyzer-0.5.0/.github/workflows/docs.yml

@@ -0,0 +1,48 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - "docs-site/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install MkDocs
+        run: pip install mkdocs-material
+
+      - name: Build documentation
+        run: mkdocs build --strict
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4