Files
meshcore-analyzer/docs/release-notes/v3.4.0.md
T
n30nex 23f938d1d4 docs: consolidate historical release notes (#2313)
Fixes #2311. Partial follow-up to #1385 (PR-B).

Five historical release notes lived outside `docs/release-notes/`. Move
v2.6.0, v3.0.0, v3.1.0, v3.4.0 and v3.6.0 into that directory using its
existing version naming convention.

Release content is preserved except for concise historical notices and
four relative-link repairs. The v3.0.0 notice identifies its obsolete
Node rollback instructions; current setup links point to README and
DEPLOY. No new documentation hierarchy or index is introduced.

Validation: all five moves are one-to-one; every document matches its
original bytes after only the listed edits; all 14 local Markdown links
resolve; no old-path references remain. Existing external links are
unchanged. All 218 standalone frontend suites pass. The unchanged
backend tree passed full server/ingestor suites, and the unchanged app
passed 12 browser smoke cases.

All five published documents were rendered in Chromium; historical
notices and repaired link targets were verified. Three independent
reviews passed.

TDD exemption: pure documentation; no application, test, CI,
configuration or deployment behavior changed. No settings/customizer
implications. [CI
passed](https://github.com/Kpa-clawbot/CoreScope/actions/runs/40230718673);
its docs-only classification correctly skipped application jobs. The
full-suite results above are local validation.
2026-10-26 15:40:38 +01:00

50 lines
2.9 KiB
Markdown

# CoreScope v3.4 Release Notes
> Historical release notes. Features and instructions below describe this release. For current setup and deployment, see the [README](../../README.md) and [deployment guide](../../DEPLOY.md).
**The neighbor affinity release.** CoreScope now understands how nodes relate to each other — not just that they exist, but how strongly they're connected. This powers smarter hop resolution, richer node detail pages, and a new graph visualization in analytics.
---
## 🎯 Features
### Neighbor Affinity System (7 milestones)
A complete neighbor relationship engine, from backend graph building to frontend visualization:
- **Affinity graph builder** — computes neighbor relationships and connection strength from packet traffic (#507)
- **Affinity API endpoints** — REST endpoints to query neighbor data (#508)
- **Show Neighbors via affinity API** — the existing Show Neighbors feature now uses real affinity data instead of raw packet heuristics (#512, fixes #484)
- **Affinity-aware hop resolution** — hop resolver uses neighbor affinity to pick better paths (#511)
- **Node detail neighbors section** — dedicated neighbors panel on the node detail page (#510)
- **Affinity debugging tools** — inspect and troubleshoot affinity calculations (#521)
- **Neighbor graph visualization** — interactive neighbor graph in the analytics tab (#513)
### Customizer v2
- Event-driven state management replaces the old imperative approach — cleaner, more predictable theme/config updates (#503)
---
## 🐛 Bug Fixes
- **Stale parsed cache on observation packets** — observation packets now correctly invalidate the JSON parse cache (#505)
- **Null-guard rAF callbacks** — live page no longer crashes when `requestAnimationFrame` callbacks fire after cleanup (#506)
- **Customizer v2 phantom overrides** — fixed phantom config entries, missing defaults, and stale dark mode state (#520)
- **Neighbor affinity empty results** — fixed pubKey field name mismatch causing empty affinity graphs (#524)
- **Home defaults in server theme** — server-side theme config now includes home page defaults (#526)
- **Neighbor UI crash + dark mode** — fixed Show Neighbors crash and improved dark mode contrast (#527)
- **Home page steps + FAQ** — both steps AND FAQ now render correctly on the home page (#529)
---
## ⚡ Performance
- **Cached JSON.parse for packet data** — packet payloads are parsed once and cached, avoiding redundant `JSON.parse` calls on repeated access (#400)
---
## Known Limitations
- **Affinity graph scales with traffic volume** — networks with very low packet rates may show weak or missing neighbor relationships until enough data accumulates
- **Debugging tools are developer-facing** — the affinity debug panel (#521) is functional but not polished for end-user consumption
- **Customizer v2 migration** — custom themes saved under v1 may need to be re-applied after upgrade