SniperGold_ML/docs/SESSION_HANDOVER_2026-08-22_P3_S10_OWNER_ADJUDICATION.md

9.5 KiB

SESSION HANDOVER — SNIPERGOLD_ML P3-S.10: OWNER ADJUDICATION & CANONICAL SETUP CONTRACT

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

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)

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)

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)

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)

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)

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

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

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

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

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)

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.