SniperGold_ML/docs/CURRENT_PROJECT_STATE.md

# CURRENT PROJECT STATE

```text
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

```text
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.

```text
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):

```text
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

```text
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

```text
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:

```text
- 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

```text
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).*