release: cut v3.8.3

Readable output (value / healthy direction / what it means + deficit bands), deterministic Next Steps, and VS Code webview surfaces; fixes for dead-code semantics, adaptive-init config preservation, and unused-deps stdlib/dev-tool false positives. Promote CHANGELOG [Unreleased] -> [3.8.3]; bump pyproject + __version__; update README release track.

Author: flamehaven01

CHANGELOG.md

@@ -9,6 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+---
+
+## [3.8.3] - 2026-06-06 — Readable Output, Next Steps, VS Code Surfaces
+
 ### Added
 
 **Human-friendly output (analysis -> action)**

README.md

@@ -23,10 +23,10 @@ File-level evidence. Machine-readable output. No LLM in the scoring path.
 </p>
 
 **Release track**
-- Stable tag: `v3.8.2`
-- Previous stable tag: `v3.8.1`
-- `v3.8.1` adds confidence-ranked cleanup plans, manifest hygiene, and opt-in layered architecture review.
+- Stable tag: `v3.8.3`
+- Previous stable tag: `v3.8.2`
 - `v3.8.2` adds adaptive `--init`, a Node/npm transport surface, repo-local impact tracking, and default-off telemetry controls.
+- `v3.8.3` adds human-friendly metric output (value / healthy direction / what it means + deficit bands), deterministic Next Steps, and the VS Code webview surfaces; fixes dead-code semantics, adaptive-init config preservation, and `unused-deps` stdlib / dev-tool false positives.
 
 ---
 
@@ -787,6 +787,7 @@ code --install-extension vscode-slop-detector-3.7.3.vsix
 
 | Version | Highlights |
 |---|---|
+| **v3.8.3** | human-friendly metric output (value / healthy direction / what it means + deficit bands) and deterministic Next Steps across rich/text/markdown; VS Code webview surfaces (4D breakdown, cleanup plan, pulse, diff-aware review); fixes for dead-code semantics, adaptive-init config preservation, and `unused-deps` stdlib / dev-tool false positives |
 | **v3.8.2** | adaptive `--init` adds bounded repo-signal suggestions and preview/merge flows; npm wrapper adds typed contracts, Node API, and agent workflow docs; local impact tracking and opt-in telemetry become first-class observability surfaces |
 | **v3.8.1** | cleanup-family outputs become confidence-ranked action plans; `unused-deps` grows manifest hygiene for `pyproject.toml` / `package.json`; `boundary-violations` gains opt-in layered architecture review with explicit rule evidence |
 | **v3.7.9** | **Governance gate**: `verify-governance` fail-closed CLI, deterministic governance-record verification, and a formal split between scoring math and enforcement |

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-slop-detector"
-version = "3.8.2"
+version = "3.8.3"
 description = "Evidence-based static analyzer for detecting AI-generated code quality issues with context-aware validation"
 authors = [
     {name = "Flamehaven Labs", email = "info@flamehaven.space"}

src/slop_detector/__init__.py

@@ -2,7 +2,7 @@
 
 from typing import Any
 
-__version__ = "3.8.2"
+__version__ = "3.8.3"
 __author__ = "Flamehaven Labs"
 __email__ = "info@flamehaven.space"