Skip to content

Zer0pa/ZPE-FT

Repository files navigation

ZPE-FT Masthead

Search financial patterns on compressed delayed-feed archives with deterministic replay and bounded price-field fidelity.

Repo install is real. Carried Wave-1 codec evidence is real. The open-access enterprise benchmark is still blocked on missing inputs and auditable query truth.

License: SAL v7.0 Python >=3.11 Controlled bundle: Wave-1 carried Current gate: BLOCKED_MISSING_INPUTS

Quick audit: playbook Architecture: runtime map Public audit: explicit limits Observability: Comet hooks

ZPE-FT

What This Is Key Metrics Competitive Benchmarks What We Prove What We Don't Claim
Jump Jump Jump Jump Jump
Commercial Readiness Tests and Verification Proof Anchors Repo Shape Quick Start
Jump Jump Jump Jump Jump

What This Is

ZPE-FT is a deterministic financial time-series codec and search surface for teams that need to archive delayed-feed market data, replay it exactly, and query patterns without first inflating the archive back into a warehouse table.

The honest commercial wedge is narrow and specific: compressed delayed-feed archives with deterministic replay, carried price-field fidelity on the controlled Wave-1 bundle, and a bounded repo-native acquisition path. The repo install surface is real. The public-data rehearsal lanes are useful but non-authority. The open-access enterprise benchmark is still blocked on missing inputs and auditable FT-C004 truth.

Key Metrics

Metric Value Baseline
Wave-1 OHLCV compression 19.19x zlib 8.35x
Wave-1 tick compression 20.57x zlib 6.56x
Public BTCUSDT archive compression 10.90x Parquet+ZSTD 3.87x
Price-field fidelity 0.0 max RMSE ticks

Competitive Benchmarks

Wave-1 controlled codec claims and public rehearsal benchmarks are different surfaces. The controlled bundle carries the promoted codec numbers. The public benchmark shows the commercial shape on an open archive, but it does not close the enterprise gate.

Lane ZPE-FT Comparator Boundary
Wave-1 OHLCV controlled bundle 19.19x zlib 8.35x, lzma 13.13x, bz2 16.12x Authority-bearing carried bundle
Wave-1 tick controlled bundle 20.57x zlib 6.56x, lzma 11.37x, bz2 11.76x Authority-bearing carried bundle
Public BTCUSDT aggTrades archive 10.90x Parquet+ZSTD 3.87x Public benchmark only
Real-market proxy lanes Useful rehearsal only 10x authority floor still missed on some series promotion_forbidden: true in BOUNDARY.json

What We Prove

  • The public repo builds, installs, imports, and retains current build/install/pytest logs under proofs/artifacts/operations/.
  • The carried Wave-1 bundle proves deterministic OHLCV and top-of-book tick compression on the controlled corpus.
  • Price fields plus top-of-book bid/ask carry 0.0 RMSE on the controlled bundle; volume is quantized separately and is not part of that claim.
  • The repo contains a real compressed search surface, but public proxy retrieval remains bounded until labeled FT-C004 truth exists.
  • The delayed-feed acquisition, freeze, and refresh path is real on the bounded SPY/AAPL smoke lane.

What We Don't Claim

  • No Phase 06 closure or public release readiness.
  • No broad warehouse or incumbent displacement claim.
  • No lossless volume reconstruction claim.
  • No promoted public-data search-quality claim while FT-C004 remains unlabeled.
  • No claim that the bounded proxy lanes satisfy the sovereign enterprise benchmark.

Commercial Readiness

Field Value
Verdict BLOCKED
Commit SHA 59a2ec90bf38
Confidence 98%
Source proofs/artifacts/2026-02-21_ft_wave1_final/claim_status_delta.md

Tests and Verification

Code Check Verdict
V_01 Package build, install, import PASS
V_02 Wave-1 OHLCV compression PASS
V_03 Wave-1 tick compression PASS
V_04 Controlled price-field fidelity PASS
V_05 Phase 06 contract freeze FAIL
V_06 Public proxy retrieval truth INC

Proof Anchors

Path Why it matters
proofs/artifacts/operations/20260321T202948Z_clean_install_verify.log Public clone install and import truth
proofs/artifacts/2026-02-21_ft_wave1_final/claim_status_delta.md Claim-by-claim carried Wave-1 bundle summary
proofs/artifacts/2026-02-21_ft_wave1_final/ft_reconstruction_fidelity.json Controlled price-field and top-of-book fidelity evidence
proofs/artifacts/real_market_benchmarks/BOUNDARY.json Public rehearsal boundary and promotion ban
proofs/reruns/2026-03-21_phase06_contract_freeze_attempt_v3/missing_inputs_packet.json Sovereign blocker packet for the open-access enterprise benchmark

Repo Shape

Area Purpose
python/, core/, scripts/ Installable package, optional helper, and repo-local runners
docs/ Audit, architecture, support, and contract surfaces
proofs/ Carried bundles, reruns, blocker packets, and operations logs
Root files Release metadata, legal terms, and the front door

Quick Start

Install from PyPI:

pip install zpe-ft

Verify from source:

git clone https://github.com/Zer0pa/ZPE-FT.git
cd ZPE-FT
python -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
python -m pip install -e .
python - <<'PY'
import zpe_finance
from zpe_finance.rust_bridge import rust_version
print("exports", sorted(zpe_finance.__all__))
print("rust_bridge", rust_version())
PY

Start with docs/AUDITOR_PLAYBOOK.md, then read docs/PUBLIC_AUDIT_LIMITS.md and proofs/reruns/2026-03-21_phase06_contract_freeze_attempt_v3/missing_inputs_packet.json. LICENSE is the legal source of truth; the repo uses SAL v7.0.