Skip to content

docs(delphi): note subgroup-k-smoother clamp for D3 port (#2575)#2610

Merged
jucor merged 1 commit into
edgefrom
jc/note-subgroup-k-smoother-d3
Jul 17, 2026
Merged

docs(delphi): note subgroup-k-smoother clamp for D3 port (#2575)#2610
jucor merged 1 commit into
edgefrom
jc/note-subgroup-k-smoother-d3

Conversation

@jucor

@jucor jucor commented Jul 17, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a porting note to the D3 (k-smoother buffer) section of PLAN_DISCREPANCY_FIXES.md, following the Clojure fix in #2609 (issue #2575).

When D3 is eventually ported to the Python/delphi pipeline, both k-smoother levels must carry the stale-smoothed-k clamp — the group-level group-k-smoother (Clojure fix #2536) and the per-group :subgroup-k-smoother (Clojure fix #2609 / #2575). Without the clamp at both levels, a group whose base-cluster count drops below a /12 boundary can carry a smoothed-k that no longer exists in the current clusterings, producing an empty clustering that crashes conv-repness. The note points at the reference implementation and tests so this isn't re-discovered as a crash during the port.

Docs-only; no code changes.

Related

🤖 Generated with Claude Code

When D3 (k-smoother buffer) is ported to Python, both the group AND subgroup
smoothers must carry the stale-smoothed-k clamp (contains?-check), not the
pre-#2536 unclamped logic. Clojure fixed the group level in #2536 and the
subgroup level in #2575 (jc/subgroup-k-smoother-clamp). Added a warning to the
D3 section of PLAN_DISCREPANCY_FIXES.md so this isn't re-discovered as a crash.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@jucor
jucor merged commit 77842d8 into edge Jul 17, 2026
3 checks passed
@jucor
jucor deleted the jc/note-subgroup-k-smoother-d3 branch July 17, 2026 01:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant