release: cut v3.8.2

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.2] - 2026-06-05 — Adaptive Init, Node Surface, Impact, Telemetry
+
 ### Added
 
 **Adaptive `--init` onboarding flow**

README.md

@@ -23,11 +23,10 @@ File-level evidence. Machine-readable output. No LLM in the scoring path.
 </p>
 
 **Release track**
-- Stable tag: `v3.8.1`
-- Previous stable tag: `v3.8.0`
-- `v3.8.0` establishes the canonical `scan / review / pulse / sweep` CLI surface and hardens dogfood operation paths used by `health` and `audit`.
+- 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.
-- Unreleased work adds repo-local impact tracking and default-off telemetry controls.
+- `v3.8.2` adds adaptive `--init`, a Node/npm transport surface, repo-local impact tracking, and default-off telemetry controls.
 
 ---
 
@@ -76,7 +75,7 @@ General linters flag style and convention. This tool flags structural risk.
 No project-side config needed. Run it against any folder of Python:
 
 ```bash
-pip install "ai-slop-detector>=3.8.1"
+pip install "ai-slop-detector>=3.8.2"
 slop-detector --project . --json --output slop.json
 python -c "import json; d=json.load(open('slop.json',encoding='utf-8')); print(d['overall_status'], d['weighted_deficit_score'])"
 ```
@@ -89,7 +88,7 @@ PowerShell — prefer it to `> slop.json` redirection.
 ## Quick Start
 
 ```bash
-pip install "ai-slop-detector>=3.8.1"
+pip install "ai-slop-detector>=3.8.2"
 
 slop-detector scan .                        # canonical analysis entry
 slop-detector review . --json              # canonical changed-code review
@@ -763,6 +762,7 @@ code --install-extension vscode-slop-detector-3.7.3.vsix
 
 | Version | Highlights |
 |---|---|
+| **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 |
 | **v3.7.3** | **Hotfix**: pydantic import wrapped in `try/except ImportError` — package imports cleanly in stripped environments; `test_api_models.py` guard corrected to `fastapi`; CI Docker login `continue-on-error`, quality gate pinned to `>=3.7.3` |

docs/ARCHITECTURE.md

@@ -1,7 +1,7 @@
 # AI-SLOP Detector - Architecture Documentation
 
-**Version:** 3.8.1
-**Last Updated:** 2026-06-04
+**Version:** 3.8.2
+**Last Updated:** 2026-06-05
 
 ---
 
@@ -871,5 +871,5 @@ slop-detector scan ./src --format json
 
 ---
 
-**Last Updated:** 2026-06-04
-**Version:** 3.8.1
+**Last Updated:** 2026-06-05
+**Version:** 3.8.2

docs/RELEASE_NOTES.md

@@ -5,6 +5,72 @@ For a condensed summary see the [Changelog](../CHANGELOG.md).
 
 ---
 
+## v3.8.2 — 2026-06-05
+
+### Summary
+
+This release extends AI-SLOP Detector from a stronger review surface into a
+safer onboarding and adoption surface. `--init` can now run a bounded second
+stage of repository signal collection, the npm wrapper graduates into a typed
+and programmatic Node transport surface, and local impact plus default-off
+telemetry make repeated use observable without entering the scoring path.
+
+### Added
+
+**Adaptive `--init`**
+- `--adaptive-init` adds a second-stage repository signal scan on top of the
+  baseline `.slopconfig.yaml` generator.
+- `--init-preview` prints suggestions without writing config.
+- `--apply-init-suggestions` opt-in merges bounded suggestions into a new or
+  existing `.slopconfig.yaml`.
+- adaptive signal collection now gathers:
+  - manifest presence
+  - language counts
+  - noise directories
+  - Python complexity candidates
+  - architecture layout markers
+  - cleanup markers
+
+**NPM thin wrapper**
+- dedicated `npm-wrapper/` package for Node-first distribution
+- `bin/ai-slop-detector.js` launcher
+- version-pinned TypeScript contract exports at `ai-slop-detector/types`
+- package-root Node API:
+  - `scanProject`
+  - `reviewChanges`
+  - `computeHealth`
+  - `runCleanupFamily`
+- agent workflow guide for JSON-first review and MCP-assisted usage
+
+**Local impact and opt-in telemetry**
+- local impact commands:
+  - `slop-detector impact enable`
+  - `slop-detector impact`
+  - `slop-detector impact disable`
+- telemetry commands:
+  - `slop-detector telemetry status`
+  - `slop-detector telemetry enable`
+  - `slop-detector telemetry disable`
+  - `slop-detector telemetry inspect --example`
+- `AI_SLOP_DETECTOR_TELEMETRY=inspect` prints a real payload without queueing
+  or sending it
+
+### Changed
+
+- adaptive suggestions stay conservative and evidence-backed
+- existing-config init stays idempotent by default
+- npm wrapper docs now state clearly that Node is a transport surface over the
+  Python core
+- impact and telemetry remain outside the deterministic scoring path
+
+### Validation
+
+- `python -m pytest tests/test_domain_init.py tests/test_cli.py tests/test_impact_telemetry.py -q -W error::ResourceWarning`
+- `node --test npm-wrapper/tests/runtime.test.js npm-wrapper/tests/api.test.js`
+- `npm pack --dry-run` in `npm-wrapper/`
+
+---
+
 ## v3.8.1 — 2026-06-04
 
 ### Summary
@@ -159,8 +225,8 @@ cross-language aggregation and ML reproducibility fixes.
 
 ### Tag
 
-- Latest stable tag: `v3.7.9`
-- Previous stable tag: `v3.7.8`
+- Latest stable tag: `v3.8.2`
+- Previous stable tag: `v3.8.1`
 
 ## v3.7.4 — 2026-05-19
 

npm-wrapper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-slop-detector",
-  "version": "3.8.1",
+  "version": "3.8.2",
   "description": "Thin npm wrapper for the AI-SLOP-DETECTOR Python CLI",
   "license": "MIT",
   "type": "commonjs",

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-slop-detector"
-version = "3.8.1"
+version = "3.8.2"
 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.1"
+__version__ = "3.8.2"
 __author__ = "Flamehaven Labs"
 __email__ = "info@flamehaven.space"