Skip to content

Commit 521841c

Browse files
JohnCCarterclaude
andcommitted
docs(research): sync wiki with absorption work; rotate stale log entries
- log.md: correct the 2026-06-17 entry — DELAR-1/2/3 implemented (was stale "planned, not authorised"); SENARE still gated. - Rotate the three 2026-06-15 Issue #32 tooling feats (gallery / ledger / overlap detector) to log-archive part 1 to stay under the 28KB log bound. - handoff.md: add a Recent Changes line for the NU+DELAR absorption; compress two already-archived 06-15 lines to hold the 300-line bound. Docs-only; no code/facit/signal/auto-fib touch. Repo-bounds green. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 8692cba commit 521841c

3 files changed

Lines changed: 61 additions & 55 deletions

File tree

docs/research_wiki/handoff.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,12 @@ append-only trail lives in [log.md](log.md).
2222

2323
## Recent Changes
2424

25+
- **2026-06-17 External-pattern-scan absorption — NU+DELAR done** (branch `feature/research-fib`;
26+
plan `clever-yawning-catmull.md`). NU (docs): standing
27+
[prereg addendum](reviews/horizontal-structure-prereg-addendum-20260617.md) (random-walk control /
28+
anytime-valid re-looks / embargo named as purged-CV). DELAR (code): synthetic RW baseline,
29+
uncertainty-ordered worklist (`--by-uncertainty`), fail-closed swing-label validation. SENARE gated.
30+
No facit/signal/auto-fib touch.
2531
- **2026-06-16 BTC/Fib studies — BOTH NULL, reviewed PASS / CLOSED** (commit `f4e96f1`, Lean Fib).
2632
**(1) Behaviour event study:** fib ≈ placebo ≈ swing (4h reject 0.78/0.80/0.84, p=0.63/0.19).
2733
**(2) Context-conditioned** (continuous MFE−MAE, rank-perm + Holm; contexts trend + deep
@@ -55,13 +61,10 @@ append-only trail lives in [log.md](log.md).
5561
2017-12-28T20:00 @ 13611 → 2017-12-28T08:00 @ 13145 (candidate_1). Only anchor_a + levels
5662
changed; anchor_b/fib_id unchanged; guard PASS; ledger candidate → corrected. Closes the
5763
declutter→correction→ledger track. [Report](reviews/btc-4h-fib-20171228-correction-20260615.md).
58-
- **2026-06-15 Issue #32 top-ROI tooling — DONE** (all stdlib, report-only): single-fib declutter
59-
edit-mode (`labeling/tool.py --edit-fib-id`), overlap/dedup detector (`research/overlap_detector.py`,
60-
22 candidates), source-quality review ledger (`research/review_ledger.py`), static HTML artifact
61-
gallery (`research/artifact_gallery.py`). Detail in [log.md](log.md) + reviews.
62-
- **2026-06-15 4H Tier 1 + Tier 2 visual reviews — complete** (entries archived to
63-
[log part 1](log-archive-btc-postreset-part1.md)): 11 groups mapped, Tier 2 sample-pass; one
64-
correction-candidate `20171228` (now corrected). Corpus declared clean below.
64+
- **2026-06-15 Issue #32 top-ROI tooling — DONE** (declutter edit-mode, overlap detector, review
65+
ledger, artifact gallery; all stdlib). Detail in [log part 1](log-archive-btc-postreset-part1.md).
66+
- **2026-06-15 4H Tier 1 + Tier 2 visual reviews — complete** (11 groups; `20171228` corrected;
67+
corpus clean). Archived to [log part 1](log-archive-btc-postreset-part1.md).
6568
- **2026-06-08→06-12 source-fib milestones (archived)** — 1M/1W/1D/4H source phases, reaction
6669
reviews (1816 interactions), 4H Tier 1 maps, Addendum 2 golden-zone retirement (#30), log-scale
6770
+ profile fix + monthly-first reset. Detail: [log post-reset part 1](log-archive-btc-postreset-part1.md)

docs/research_wiki/log-archive-btc-postreset-part1.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,3 +133,48 @@ fib count. A 55-fib group (2021) can be mostly map-OK; a 103-fib group (2017_h2)
133133
maps; Tier 2 per-fib zoom windows will be narrower and more readable.
134134

135135
**Next:** implement Tier 2 `fourh_source_fib_zoom.py`.
136+
137+
## [2026-06-15] feat | Overlap/dedup detector + anchor convention (Issue #32 top-ROI #3)
138+
139+
Added `research/overlap_detector.py` — stdlib-only, report-only detector. Each fib is a
140+
box in (time, log-price) space; per pair it computes time/price/box IoU + shared-anchor.
141+
Flags candidates (box_iou≥0.5 or shared anchor) for human review — never edits labels,
142+
never says "wrong". Fail-closed timeframe guard. Real run on 366 4H fibs: **22 candidate
143+
pairs, all sharing anchor_b** (no pure-geometric overlap ≥0.5) → dominant signal is
144+
sub-legs ending on the same swing, not duplicates. 20210110 pair confirmed (box_iou 0.51);
145+
2017_h2 cluster present; strongest near-dup 20250506 pair (box_iou 0.70); `20171228`
146+
correctly absent (anchor-quality issue, not duplication). Report:
147+
[`reviews/btc-4h-overlap-candidates-20260615.md`](reviews/btc-4h-overlap-candidates-20260615.md)
148+
+ CSV. Anchor convention (body/close vs wick, observed not absolute) documented in
149+
[`labeling/HUMAN_FIB_ANNOTATION.md`](../labeling/HUMAN_FIB_ANNOTATION.md). 9 tests; ruff +
150+
full suite green (361 passed, 75.07% cov). No source labels changed; no new deps.
151+
152+
## [2026-06-15] feat | Source-quality review ledger (Issue #32 top-ROI #2)
153+
154+
Added `research/review_ledger.py` — stdlib-only helper (csv/hashlib/json; no new deps)
155+
that makes source-fib review verdicts machine-trackable. Flat CSV, controlled vocab
156+
(verdict ∈ ok/ok-with-note/watchlist/suspicious; status ∈ accepted/noted/open/
157+
correction-candidate/deferred/corrected), with a deterministic `source_hash`
158+
(`sha256:<16 hex>` of the fib JSON bytes) tying each verdict to the exact facit version.
159+
Generated the first ledger for the 4H Tier 2 sample-pass (8 rows) at
160+
[`reviews/ledgers/btc-4h-source-quality-ledger.csv`](reviews/ledgers/btc-4h-source-quality-ledger.csv);
161+
`fib_BTC-USD_4h_20171228T200000` represented as suspicious / correction-candidate. Schema
162+
doc: [`reviews/ledgers/README.md`](reviews/ledgers/README.md). 12 tests
163+
(`tests/research/test_review_ledger.py`: hash determinism, vocab validation,
164+
correction-candidate representable, roundtrip, header check); ruff + full suite green
165+
(352 passed, 74.91% cov). No source labels changed; CSV is committed text under `docs/`.
166+
167+
## [2026-06-15] feat | Static HTML artifact gallery (Issue #32 top-ROI #1)
168+
169+
Added `research/artifact_gallery.py` — stdlib-only helper (no new deps) that scans a
170+
review PNG directory and writes a self-contained `index.html` beside it (relative links,
171+
inline CSS/JS-free, clean+levels paired per item). Auto-detects both layouts: flat **map**
172+
output (`..._<label>_4h_<kind>.png`) and nested **zoom** output (`<scope>/<fib_id>/
173+
4h_<kind>.png`). Standalone helper by design — does **not** touch the render modules or
174+
the existing markdown `_write_index`. Output lands under `experiments/review/**`
175+
(gitignored; HTML not committed). 9 tests in `tests/research/test_artifact_gallery.py`
176+
(both layouts, relative-links-only, empty/missing dir, no-external-deps, markdown index
177+
untouched); ruff + full suite green (340 passed, 74.77% cov). Real smoke run: zoom (140
178+
items) + map galleries written; `git status` confirms `index.html` is ignored.
179+
180+
Build: `python -m fibengine.research.artifact_gallery --root experiments/review/fourh_source_fib_zoom`.

docs/research_wiki/log.md

Lines changed: 6 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,10 @@ Types: `ingest`, `decision`, `review`, `question`, `maintenance`.
2121
NU block of the external pattern scan, docs-only:
2222
[horizontal-structure-prereg-addendum-20260617.md](reviews/horizontal-structure-prereg-addendum-20260617.md)
2323
(NU-1 random-walk control; NU-2 anytime-valid/e-Holm re-looks; NU-3 name embargo as purged-CV).
24-
DELAR/SENARE code planned, not authorised (`clever-yawning-catmull.md`).
24+
DELAR-1/2/3 since implemented (commits `ca5ae73`/`0b380e6`/`7b03837`): synthetic random-walk
25+
baseline (`research/synthetic_baseline.py`), uncertainty-ordered labeling worklist
26+
(`labeling/worklist.py --by-uncertainty`), fail-closed swing-label JSON validation
27+
(`validation/schemas.py`). SENARE still gated (`clever-yawning-catmull.md`).
2528

2629
## [2026-06-16] decision | BTC/Fib behaviour/backtest line — PAUSED / CLOSED (reviewed PASS)
2730

@@ -355,53 +358,8 @@ ledger; anchor_a only, body/close convention) → (3) update ledger row candidat
355358
**Also evaluate-later:** chart-regression strategy (structural/hash vs pytest-mpl,
356359
binary-baseline / anti-blob question). 1H source labeling remains deferred.
357360

358-
## [2026-06-15] feat | Overlap/dedup detector + anchor convention (Issue #32 top-ROI #3)
359-
360-
Added `research/overlap_detector.py` — stdlib-only, report-only detector. Each fib is a
361-
box in (time, log-price) space; per pair it computes time/price/box IoU + shared-anchor.
362-
Flags candidates (box_iou≥0.5 or shared anchor) for human review — never edits labels,
363-
never says "wrong". Fail-closed timeframe guard. Real run on 366 4H fibs: **22 candidate
364-
pairs, all sharing anchor_b** (no pure-geometric overlap ≥0.5) → dominant signal is
365-
sub-legs ending on the same swing, not duplicates. 20210110 pair confirmed (box_iou 0.51);
366-
2017_h2 cluster present; strongest near-dup 20250506 pair (box_iou 0.70); `20171228`
367-
correctly absent (anchor-quality issue, not duplication). Report:
368-
[`reviews/btc-4h-overlap-candidates-20260615.md`](reviews/btc-4h-overlap-candidates-20260615.md)
369-
+ CSV. Anchor convention (body/close vs wick, observed not absolute) documented in
370-
[`labeling/HUMAN_FIB_ANNOTATION.md`](../labeling/HUMAN_FIB_ANNOTATION.md). 9 tests; ruff +
371-
full suite green (361 passed, 75.07% cov). No source labels changed; no new deps.
372-
373-
## [2026-06-15] feat | Source-quality review ledger (Issue #32 top-ROI #2)
374-
375-
Added `research/review_ledger.py` — stdlib-only helper (csv/hashlib/json; no new deps)
376-
that makes source-fib review verdicts machine-trackable. Flat CSV, controlled vocab
377-
(verdict ∈ ok/ok-with-note/watchlist/suspicious; status ∈ accepted/noted/open/
378-
correction-candidate/deferred/corrected), with a deterministic `source_hash`
379-
(`sha256:<16 hex>` of the fib JSON bytes) tying each verdict to the exact facit version.
380-
Generated the first ledger for the 4H Tier 2 sample-pass (8 rows) at
381-
[`reviews/ledgers/btc-4h-source-quality-ledger.csv`](reviews/ledgers/btc-4h-source-quality-ledger.csv);
382-
`fib_BTC-USD_4h_20171228T200000` represented as suspicious / correction-candidate. Schema
383-
doc: [`reviews/ledgers/README.md`](reviews/ledgers/README.md). 12 tests
384-
(`tests/research/test_review_ledger.py`: hash determinism, vocab validation,
385-
correction-candidate representable, roundtrip, header check); ruff + full suite green
386-
(352 passed, 74.91% cov). No source labels changed; CSV is committed text under `docs/`.
387-
388-
## [2026-06-15] feat | Static HTML artifact gallery (Issue #32 top-ROI #1)
389-
390-
Added `research/artifact_gallery.py` — stdlib-only helper (no new deps) that scans a
391-
review PNG directory and writes a self-contained `index.html` beside it (relative links,
392-
inline CSS/JS-free, clean+levels paired per item). Auto-detects both layouts: flat **map**
393-
output (`..._<label>_4h_<kind>.png`) and nested **zoom** output (`<scope>/<fib_id>/
394-
4h_<kind>.png`). Standalone helper by design — does **not** touch the render modules or
395-
the existing markdown `_write_index`. Output lands under `experiments/review/**`
396-
(gitignored; HTML not committed). 9 tests in `tests/research/test_artifact_gallery.py`
397-
(both layouts, relative-links-only, empty/missing dir, no-external-deps, markdown index
398-
untouched); ruff + full suite green (340 passed, 74.77% cov). Real smoke run: zoom (140
399-
items) + map galleries written; `git status` confirms `index.html` is ignored.
400-
401-
Build: `python -m fibengine.research.artifact_gallery --root experiments/review/fourh_source_fib_zoom`.
402-
403-
404361
> **2026-06-11→06-12 entries** (1M reaction-review, 1W/1D/4H source phases, 4H Tier 1
405-
> design/maps) **and the 2026-06-15 4H Tier 1/Tier 2 visual-review entries** archived to
362+
> design/maps), **the 2026-06-15 4H Tier 1/Tier 2 visual-review entries**, **and the
363+
> 2026-06-15 Issue #32 tooling feats** (gallery / ledger / overlap detector) archived to
406364
> [post-reset part 1](log-archive-btc-postreset-part1.md).
407365

0 commit comments

Comments
 (0)