SniperGold_ML/docs/CURRENT_PROJECT_STATE.md

11 KiB

CURRENT PROJECT STATE

Document type : GOVERNANCE / OPERATIONAL STATE
DOCUMENT ROLE : FACTUAL_STATE
Created       : 2026-08-28 (P3-GOV-1 - Research Governance & Authoritative State Audit)
Revision      : v8 (2026-08-31 - P3-S25.1O workload close-out: factual state
                synchronized to the canonical post-chunk-165 checkpoint;
                authorization unchanged)
AUTHORITY     : HUMAN-READABLE FACTUAL SNAPSHOT ONLY.
                This document MUST agree with canonical machine evidence.
                This document MUST NOT authorize execution.
                This document MUST NOT override canonical checkpoint state.
                The AUTHORIZATION STATE block below is informational only;
                it records the current owner decision status. It grants
                nothing. Actual authorization lives in CURRENT_DECISION_GATE.md.
MACHINE-READABLE CHECKPOINT IS AUTHORITATIVE OVER PROSE.

Read this FIRST in every new session, then the newest session handover, then the current decision gate, then the session-start protocol v2.


A. Repository identity

Authoritative workspace:
D:\TradingTerminal\HFM Metatrader 5\MQL5\Shared Projects\SniperGold_ML_authoritative

Remote:
https://forge.mql5.io/chiki2bum2/SniperGold_ML.git

Branch:
main

Working tree:
CLEAN    (local HEAD == origin/main)

Stash:
NONE

Untracked:
NONE

B. FACTUAL EXECUTION STATE

Source: canonical machine checkpoint ml/p3/p3_s251_external_ingest/output/s251_real_checkpoint.json — this document reports those values; the checkpoint is authoritative over this prose.

Current phase           : P3-S25.1 Stage-B (PERIODIC INTEGRITY AUDIT + REAL-TICK INGESTION)
last_completed_chunk    = 165
current_chunk           = 165
next_chunk              = 166        (derived: last_completed_chunk + 1)
next_byte_offset        = 3946840483  (= next_byte_start)
SAFE_MAX_CHUNK_SIZE     = 24 MiB     (P3-S25.1C; per-chunk truth = chunk manifests)
full ingestion          = NOT COMPLETE (34.5 GB / 722,941,870-row dataset NOT complete)

Checkpoint values (from the canonical checkpoint, machine-verified):

Checkpoint            : ml/p3/p3_s251_external_ingest/output/s251_real_checkpoint.json
run_id                : P3_S251_REAL_TICK_RUN_001
source_path           : D:\TradingTerminal\HFM Metatrader 5\MQL5\Files\XAUUSD_mt5_ticks.csv
source_sha256         : 5252ce8f5b0e7d286b71a3172c7ef9c1009c8e4b1254ac67400a803fcd85cba1
source_size           : 34,473,661,010 bytes
checkpoint chunk_size field : 12582912 (12 MiB) = INITIAL-run chunk-size
                              budget, set once at run creation; NOT the
                              per-chunk size of later chunks (D3 semantics;
                              field unchanged)
effective chunk size  : chunks 0-8 = 12 MiB (12582912 B); chunks 9-121 = 24 MiB
                        (25165824 B) - per-chunk truth is each chunk manifest
                        (output/s251_real_chunkNN_manifest.json chunk_size_bytes)
SAFE_MAX_CHUNK_SIZE   : 24 MiB (P3-S25.1C); SAFE_CHUNKS_PER_TURN = NOT ESTABLISHED
status                : CHUNK_COMMITTED
last_completed_chunk  : 165
current_chunk         : 165
next chunk            : 166
next byte offset      : 3,946,840,483 (=3946840483)
cumulative rows       : 85,675,511
cumulative M15        : 222,650
cumulative M30        : 112,361
last_timestamp        : 1,337,160,441 (=1337160441)
checkpoint sha256     : 63d5f51abd711d1138f91c1a0f3a328a74c44e358e1a09a50eece7fd1d2c7ca1
                        (recomputed from the committed P3-S25.1O workload checkpoint file)
checkpoint updated_utc: 2026-08-31T12:51:44.023145+00:00
full ingestion        : NOT COMPLETE

SOURCE SETUP: VERIFIED WITH LIMITATION - size and SHA were reconciled with the run records on chunk 0; the full 34.5 GB SHA was NOT recomputed (no integrity contradiction observed, so no full re-hash was forced).


C. RESEARCH STATE

P3-S25.1D broader multi-chunk benchmark             = OPEN
SAFE_CHUNKS_PER_TURN (multi-chunk turn benchmark)   = NOT ESTABLISHED
P3-S25.1D-R (interruption verifier recovery)        = COMPLETE (isolated path only)
External Tickstory basis validation                 = IN PROGRESS
                                                     (run P3_S251_REAL_TICK_RUN_001,
                                                      chunks 0-165 committed incl.
                                                      P3-S25.1H + P3-S25.1J + P3-S25.1K + P3-S25.1L + P3-S25.1M + P3-S25.1N + P3-S25.1O 512 MiB / 8-worker
                                                      workloads; full 34.5 GB dataset
                                                      NOT complete)
P3-S24 conclusion                                   = D - CURRENT EDGE NOT DEMONSTRATED
P3-GOV-5 preventive-control design                  = COMPLETE - DESIGN ONLY, COMMITTED
                                                     (classification B; controls DESIGNED;
                                                      no control implemented; design artifacts
                                                      durably committed 2026-08-30; see
                                                      docs/P3_GOV_5_PREVENTIVE_CONTROL_DESIGN/
                                                      and SESSION_HANDOVER_2026-08-30_...)

D. AUTHORIZATION STATE

CHUNK 11                 = COMPLETED (2026-08-30; authorized by the session
                             prompt, protocol v2 section 7)
P3-S25.1H (chunks 12-33) = COMPLETED (2026-08-31; ONE 512 MiB / 8-worker real
                             workload authorized by the session prompt,
                             protocol v2 section 7)
SAFE_CHUNKS_PER_TURN     = NOT ESTABLISHED
SAFE_MAX_CHUNK_SIZE      = 24 MiB (no dynamic-chunk change)
P3-S25.1J (chunks 34-55) = COMPLETED (2026-08-31; ONE 512 MiB / 8-worker real
                             workload authorized by the session prompt,
                             protocol v2 section 7)
P3-S25.1K (chunks 56-77) = COMPLETED (2026-08-31; ONE 512 MiB / 8-worker real
                             workload authorized by the session prompt,
                             protocol v2 section 7)
P3-S25.1L (chunks 78-99) = COMPLETED (2026-08-31; ONE 512 MiB / 8-worker real
                             workload authorized by the session prompt,
                             protocol v2 section 7)
P3-S25.1M (chunks 100-121) = COMPLETED (2026-08-31; ONE 512 MiB / 8-worker real
                             workload authorized by the session prompt,
                             protocol v2 section 7)
P3-S25.1N (chunks 122-143) = COMPLETED (2026-08-31; ONE 512 MiB / 8-worker real
                             workload authorized by the session prompt,
                             protocol v2 section 7)
P3-S25.1O (chunks 144-165) = COMPLETED (2026-08-31; ONE 512 MiB / 8-worker real
                             workload authorized by the session prompt,
                             protocol v2 section 7)
CHUNK 166 execution      = NOT AUTHORIZED
Authorizing document     = docs/CURRENT_DECISION_GATE.md (owner decision)

Interpretation rule (see protocol v2 section 6-7): next_chunk = 166 in section B is a FACT. It is NOT an authorization. No execution may begin until factual state (section B) and authorization state (section D) reconcile via an explicit owner decision recorded in CURRENT_DECISION_GATE.md.


E. Frozen foundations

The following are FROZEN and MUST NOT change without separate, explicit owner authorization:

- Runtime F1 (event contract)         -> docs/P3_S11_EVENT_CONTRACT_REPAIR.md
- Runtime F2 (zone contract)          -> docs/P3_S12_ZONE_CONTRACT_REPAIR.md
- Runtime F3 (candidate setup)        -> docs/P3_S13_CANDIDATE_SETUP_REPAIR.md
- Runtime F4 (MTF training alignment) -> docs/P3_S14_MTF_TRAINING_ALIGNMENT.md
- Candidate Setup canonical           -> docs/SNIPERGOLD_CANONICAL_SETUP_CONTRACT_v1.md,
                                         docs/SMC_CANDIDATE_SETUP_SPEC_v1.md
- Feature contract                    -> docs/FEATURE_CONTRACT.md
- Label contract v1                   -> docs/P3_S16_LABEL_CONTRACT.md,
                                         docs/P3_S18A_LABEL_CONTRACT_REVIEW.md
- Corrected UTC-clock research M30 basis -> P3-S22.3 (docs/P3_S22_3_RESEARCH_M30_REPAIR.md)
- Corrected population basis (707 / 610 / 579) -> P3-S22.4 (docs/P3_S22_4_CORRECTED_POPULATION_VALIDATION.md)
- P3-S20 frozen baseline              -> docs/P3_S20_WALK_FORWARD_BASELINE.md (FROZEN)
- P3-S23 corrected baseline           -> docs/P3_S23_CORRECTED_POPULATION_ML_BASELINE.md
- P3-S24 conclusion                   -> D - CURRENT EDGE NOT DEMONSTRATED

Full list (paths / versions / authorization): docs/FROZEN_ASSET_REGISTER.md and docs/AUTHORIZED_CHANGE_MATRIX.md.


F. Historical results - status

Result Status
Legacy SniperGold_ML.mqh + old directional-drift MLP FROZEN LEGACY / REFERENCE
Legacy calibrated AUC 0.627 / 0.621 (old feed) LEGACY / HISTORICAL ONLY
P3-S20 frozen walk-forward pooled 0.5792 (old population) FROZEN HISTORICAL RESULT
P3-S22.3 corrected UTC M30 construction CORRECTED RESEARCH BASIS
P3-S23 corrected pooled ROC-AUC 0.5235 CORRECTED-POPULATION RESULT
P3-S24 conclusion D - CURRENT EDGE NOT DEMONSTRATED

G. Current chunk policy

SAFE_MAX_CHUNK_SIZE  = 24 MiB
SAFE_CHUNKS_PER_TURN = NOT ESTABLISHED (broader P3-S25.1D multi-chunk benchmark
                       OPEN; verifier recovery isolated in P3-S25.1D-R only)

periodic 0-9 audit      = PASS_WITH_LIMITATION (documentation-only no-chain-hash)
chunk-size invariance   = PASS (12/24/48/64 MiB byte-identical)
reproducibility         = PASS (chunks 0-9 sequential replay, chunk10 9/9 exact,
                                 chunk11 9/9 EXACT)
evidence                = ml/p3/p3_s251_external_ingest/real_run_chunk_00000*.json
                          ml/p3/p3_s251_external_ingest/output/s251_real_*_manifest.json
periodic audit evidence = ml/p3/p3_s251_external_ingest/output/p3_s251_periodic_audit_10.json
chunk-11 gov6a controls = ml/p3/p3_s251_external_ingest/output/s251_chunk11_controls_before.json
                          ml/p3/p3_s251_external_ingest/output/s251_chunk11_controls_after.json

H. Next session behaviour

Read this file, the newest session handover, the decision gate and the session-start protocol v2, then verify Git, then reconcile FACTUAL EXECUTION STATE with AUTHORIZATION STATE. No work is authorized by this file. Only an explicit owner decision recorded in docs/CURRENT_DECISION_GATE.md (or the current session prompt) authorizes execution.

End of P3-GOV-3 current project state (FACTUAL_STATE).