230 lines
9.5 KiB
Markdown
230 lines
9.5 KiB
Markdown
|
|
# SESSION HANDOVER — SNIPERGOLD_ML P3-S.10: OWNER ADJUDICATION & CANONICAL SETUP CONTRACT
|
||
|
|
|
||
|
|
```text
|
||
|
|
Date : 2026-08-22 (session close)
|
||
|
|
Status : P3-S.10 COMPLETE — OD-1..OD-5 adjudicated; canonical Candidate
|
||
|
|
Setup Contract v1 frozen; repair implementation spec written.
|
||
|
|
NOT yet committed (handover prepared before commit+push).
|
||
|
|
Forge : https://forge.mql8.io/chiki2bum2/SniperGold_ML
|
||
|
|
Checkpoint : 533c8c6647a552d01a1a290cb2d0505f94887666 (VERIFIED at start:
|
||
|
|
local HEAD == remote HEAD == branch main; working tree = only
|
||
|
|
untracked P3-S.7/P3-S.8/P3-S.9 artifacts)
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 1. SESSION OBJECTIVE
|
||
|
|
|
||
|
|
```text
|
||
|
|
Design-decision and contract-freeze session (NOT implementation).
|
||
|
|
|
||
|
|
Resolved:
|
||
|
|
OD-1 H4/M30 gate policy ............ YES (hard direction-compatible gates)
|
||
|
|
OD-2 Canonical MTF model ............ H4/M30/M15/M3 (runtime/setup);
|
||
|
|
D1/H4/H1/M15 = legacy training semantics
|
||
|
|
OD-3 Validity-window semantics ...... DECIDED AS SEMANTIC CONTRACT
|
||
|
|
(per-primitive windows; 40/40 justified;
|
||
|
|
W_setup/W_m3/W_zone_age = OPEN NUMERIC
|
||
|
|
PARAMETERS, barred from performance)
|
||
|
|
OD-4 MTF conflict policy ............ GATE-FAIL for the setup layer;
|
||
|
|
arithmetic only in the scoring layer
|
||
|
|
OD-5 Canonical OB semantics ......... A (intentional simpler proxy);
|
||
|
|
NO displacement requirement; NO BOS/CHoCH
|
||
|
|
requirement (redundant with the chain's
|
||
|
|
CHoCH stage); constants 1.5/1.6 kept and
|
||
|
|
documented; RESOLVED
|
||
|
|
|
||
|
|
Frozen:
|
||
|
|
docs/SNIPERGOLD_CANONICAL_SETUP_CONTRACT_v1.md
|
||
|
|
(objective, MTF model, primitive roles, chain, identity, lifecycle,
|
||
|
|
one-setup-one-identity, one-entry, score/signal separation,
|
||
|
|
event/zone/state/attribute/condition contracts, MTF as-of contract,
|
||
|
|
validity-window contract, conflict policy, canonical OB)
|
||
|
|
|
||
|
|
ARCHITECTURE STATUS: READY FOR REPAIR
|
||
|
|
(OD-1..OD-5 resolved; contract frozen; MTF model, primitive roles,
|
||
|
|
setup identity, lifecycle frozen; NO production code changed.)
|
||
|
|
|
||
|
|
No production code changed. No ML. No retraining. No optimization.
|
||
|
|
Human verification = CANCELLED (permanent research-path decision).
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. CHECKPOINT & PROVENANCE (session start)
|
||
|
|
|
||
|
|
```text
|
||
|
|
Forge HEAD : 533c8c6647a552d01a1a290cb2d0505f94887666 (P3-S.6) VERIFIED
|
||
|
|
Branch / remote : main == origin/main VERIFIED
|
||
|
|
Working tree : only untracked P3-S.7/P3-S.8/P3-S.9 artifacts;
|
||
|
|
zero tracked modifications VERIFIED
|
||
|
|
P3-S.9 artifacts : all 4 read VERIFIED
|
||
|
|
P3-S.2..S.8 specs : all 7 authoritative specs read (S.2..S.8) VERIFIED
|
||
|
|
Human verification : CANCELLED VERIFIED
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 3. DECISION RECORD (summary)
|
||
|
|
|
||
|
|
```text
|
||
|
|
OD-1 (H4/M30 gate policy) = YES
|
||
|
|
H4 AND M30 must be direction-compatible context gates for Candidate Setup
|
||
|
|
formation. Conflict or neutral -> NO CANDIDATE SETUP. SIGNAL != SETUP:
|
||
|
|
H4-only/M30-only/M15-only directional signals may exist but cannot create
|
||
|
|
a Candidate Setup. Overrides P3-S.7 S-N/S-C FOR THE SETUP LAYER ONLY.
|
||
|
|
|
||
|
|
OD-2 (Canonical MTF model) = H4/M30/M15/M3
|
||
|
|
H4 Narrative / M30 Context / M15 Entry / M3 Price Action (micro). Training
|
||
|
|
semantics D1/H4/H1/M15 remain UNCHANGED (legacy/current); future F4
|
||
|
|
alignment requirement recorded. ML pipeline NOT modified.
|
||
|
|
|
||
|
|
OD-3 (Validity windows) = SEMANTIC CONTRACT
|
||
|
|
W_sweep = 40 (justified), W_choch = 40 (justified), zone age = none by
|
||
|
|
semantics, W_m3 = OPEN, W_setup = OPEN. Chain ordering bound: sweep onset
|
||
|
|
<= CHoCH onset <= sweep onset + W_sweep; decision within CHoCH window.
|
||
|
|
Each primitive has its own window; no global SeqWindow reuse.
|
||
|
|
|
||
|
|
OD-4 (MTF conflict policy) = GATE-FAIL
|
||
|
|
H4<->M30 conflict -> BLOCKED; M15 vs H4/M30 -> BLOCKED; M3 contrary ->
|
||
|
|
M3_CONFIRMED=FALSE, setup remains CANDIDATE, micro-score reduced only.
|
||
|
|
No arithmetic voting for setup-layer conflicts; aggregator = scoring layer.
|
||
|
|
|
||
|
|
OD-5 (Canonical OB) = A (intentional simpler proxy)
|
||
|
|
OB strong move (1.5x avg) = intentional simpler proxy for Displacement
|
||
|
|
(1.6x); OB does NOT require displacement; OB does NOT require BOS/CHoCH
|
||
|
|
(redundant with the chain's CHoCH stage; legacy A-2 definition historical);
|
||
|
|
canonical OB = opposite candle + strong move + full-range zone + unmitigated
|
||
|
|
until close-through full fill. 1.5/1.6 kept separate and documented
|
||
|
|
(BUG-P3S6-001 -> DOCUMENT ONLY).
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 4. KEY DESIGN CONTRACTS (frozen, NOT implemented)
|
||
|
|
|
||
|
|
```text
|
||
|
|
Setup identity : {setup_id, direction, sweep{onset,dir,window},
|
||
|
|
choch{onset,dir}, zone{type,formation,bounds,mit},
|
||
|
|
entry TF=M15, creation ts, M3 ts, reason}
|
||
|
|
uniqueness = (direction, sweep onset, choch onset,
|
||
|
|
zone formation ts, creation ts); causal, no per-bar recreation.
|
||
|
|
Lifecycle : NONE -> CONTEXT_VALID -> LIQUIDITY_TRIGGERED ->
|
||
|
|
STRUCTURE_CONFIRMED -> ZONE_READY -> ENTRY_ARMED ->
|
||
|
|
CANDIDATE_SETUP -> [M3_CONFIRMED] -> EXPIRED/INVALIDATED/
|
||
|
|
CONSUMED. Strict order; one entry max; no reactivation.
|
||
|
|
Contracts : EVENT {ts, dir, valid_until, superseded, source};
|
||
|
|
ZONE {ts, dir, upper, lower, mit_state, invalidated};
|
||
|
|
STATE {value, as_of, tf}; ATTRIBUTE {value, bar_ts, tf};
|
||
|
|
CONDITION {bool, as_of, tf, reason}.
|
||
|
|
As-of : H4/M30/M15/M3_asof(t) = newest CLOSED bar with close_time
|
||
|
|
<= t; Engine-1 closed-bar lock; no partial HTF candle.
|
||
|
|
Validity : per-primitive windows (OD-3 table), not one SeqWindow.
|
||
|
|
MTF : H4/M30 gates; M15 chain; M3 optional; conflict = gate-fail.
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 5. REPAIR FAMILIES & IMPLEMENTATION ORDER (frozen, NOT executed)
|
||
|
|
|
||
|
|
```text
|
||
|
|
F1 EVENT CONTRACT (P1): BUG-P3S2-001, BUG-P3S3-001, D-12.
|
||
|
|
F2 ZONE CONTRACT (P1): BUG-P3S4-001/-002, BUG-P3S5-001 (+ zone scope).
|
||
|
|
F3 SETUP LAYER (P1/P2): D-8, D-9, D-10, D-11, D-1; OD-1/3/4 gates+windows.
|
||
|
|
F4 MTF/TRAINING (P2): D-2, D-3, D-5, D-6, BUG-P3S2-003, BUG-P3S3-002; OD-2/4.
|
||
|
|
F5 DISPLAY (P2): D-4.
|
||
|
|
F6 DOCUMENTATION (P3): BUG-P3S5-002, BUG-P3S6-001 (OD-5 decisions),
|
||
|
|
BUG-P3S2-004/-005, BUG-P3S3-003, BUG-P3S4-003/-004,
|
||
|
|
BUG-P3S5-003, D-7, D-14.
|
||
|
|
|
||
|
|
Phases: I F1 -> II F2 -> III F3 -> IV F4 -> V F5 -> VI regression+parity+
|
||
|
|
dataset rebuild. Test-first: SPEC -> TEST -> IMPLEMENTATION -> REGRESSION
|
||
|
|
-> PARITY. No direct hot-fix.
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 6. OPEN ITEMS (recorded, non-blocking)
|
||
|
|
|
||
|
|
```text
|
||
|
|
OPEN NUMERIC PARAMETERS (semantically contracted; constants to be set by
|
||
|
|
contract tests in implementation, NEVER from performance):
|
||
|
|
W_setup, W_m3, W_zone_age, FVG min-gap / OB min-size / zone scope.
|
||
|
|
Implementation-scope: FVG mitigation variant unification (F2), runtime
|
||
|
|
TF-identity enforcement (D-3, F4), display alignment (D-4, F5), training
|
||
|
|
alignment detail (F4).
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 7. NO PRODUCTION CHANGE
|
||
|
|
|
||
|
|
```text
|
||
|
|
Only P3-S.10 artifacts added:
|
||
|
|
docs/P3_S10_OWNER_ADJUDICATION.md
|
||
|
|
docs/SNIPERGOLD_CANONICAL_SETUP_CONTRACT_v1.md
|
||
|
|
docs/P3_S10_REPAIR_IMPLEMENTATION_SPEC.md
|
||
|
|
docs/SESSION_HANDOVER_2026-08-22_P3_S10_OWNER_ADJUDICATION.md (this file)
|
||
|
|
docs/P3_S9_CONSOLIDATED_REPAIR_PLAN.md (addendum only — historical body
|
||
|
|
untouched)
|
||
|
|
0 production files modified (verified: git status shows only untracked
|
||
|
|
P3-S.7..P3-S.10 artifacts; HEAD unchanged at 533c8c6).
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 8. NEXT GATE
|
||
|
|
|
||
|
|
```text
|
||
|
|
ARCHITECTURE STATUS = READY FOR REPAIR.
|
||
|
|
Next session: P3-S.11 — F1 EVENT CONTRACT REPAIR (separate implementation
|
||
|
|
session; tests first; one repair family at a time; regression + parity +
|
||
|
|
setup dataset rebuild at the end).
|
||
|
|
Do NOT start implementation before the architecture lock is committed.
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 9. ARTIFACTS
|
||
|
|
|
||
|
|
```text
|
||
|
|
docs/P3_S10_OWNER_ADJUDICATION.md (decision record, A-P)
|
||
|
|
docs/SNIPERGOLD_CANONICAL_SETUP_CONTRACT_v1.md (frozen contract)
|
||
|
|
docs/P3_S10_REPAIR_IMPLEMENTATION_SPEC.md (families + order + tests)
|
||
|
|
docs/SESSION_HANDOVER_2026-08-22_P3_S10_OWNER_ADJUDICATION.md (this document)
|
||
|
|
docs/P3_S9_CONSOLIDATED_REPAIR_PLAN.md (addendum §9 — see below)
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 10. COMMIT & PUSH STATUS
|
||
|
|
|
||
|
|
```text
|
||
|
|
NOT YET COMMITTED at handover write time.
|
||
|
|
Planned message:
|
||
|
|
research: P3-S.10 owner adjudication OD-1..OD-5 + canonical setup contract freeze (READY FOR REPAIR)
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 11. P3-S.9 REPAIR PLAN ADDENDUM (what changed and why)
|
||
|
|
|
||
|
|
```text
|
||
|
|
docs/P3_S9_CONSOLIDATED_REPAIR_PLAN.md was NOT rewritten. A clearly-marked
|
||
|
|
P3-S.10 addendum was appended because the final decisions complete the
|
||
|
|
plan's "Step 0: Owner adjudication of OD-1..OD-5 (architecture lock)":
|
||
|
|
- BUG-P3S5-002 (two OB definitions) -> RESOLVED by OD-5 (canonical current
|
||
|
|
confirmed; legacy structure-break = historical; DOCUMENT ONLY).
|
||
|
|
- BUG-P3S6-001 (1.5 vs 1.6) -> RESOLVED by OD-5 (kept separate,
|
||
|
|
documented; DOCUMENT ONLY, F6).
|
||
|
|
- D-2/D-13 (conflict policy) -> RESOLVED by OD-4 (gate-fail).
|
||
|
|
- D-5/D-6 (MTF models) -> RESOLVED by OD-2 (H4/M30/M15/M3 canonical;
|
||
|
|
D1/H4/H1 deprecated to reference for the agent path).
|
||
|
|
- D-8 (two setup definitions) -> RESOLVED by the frozen contract
|
||
|
|
(canonical chain; E-rule re-scoped to the M15 entry predicate).
|
||
|
|
- OD-3 windows -> per-primitive semantic contract with 40/40 justified
|
||
|
|
and OPEN NUMERIC PARAMETERS recorded.
|
||
|
|
Historical evidence (P3-S.2..S.9 documents) remains unchanged.
|
||
|
|
```
|
||
|
|
|
||
|
|
*End of P3-S.10 handover.*
|