TruthInTheFlip v1.1.0: Unleashing Extensibility and Data Precision 🚀

We are thrilled to announce the release of TruthInTheFlip v1.1.0! The meta-guessing simulation harness has just received a major architectural overhaul. This update is all about opening the doors for advanced data science, improving code modularity, and giving you the power to easily plug in your own logic and anticipation strategies.

Here’s a deep dive into the latest features and architectural improvements we’ve introduced in this release.

🏗️ Architectural Overhaul: Core Engine Isolation

We’ve taken a significant step forward by decoupling our core domain logic from the file I/O operations.

• Library Isolation: and have been extracted from the main executable into their own clean TruthInTheFlip.Format namespace. TrackerBitFactory
• The Pattern:ITrackerStore All binary serialization, file locks, and version checking are now managed by a dedicated class. This means the core logic is purely focused on the simulation, making the entire system much cleaner and easier to maintain. TrackerStore
• Safe Enumeration: We’ve introduced a lazy file-reading capability via store.Enumerate(). Downstream clients can now stream massive historical datasets without suffering from memory bloat!

⏱️ High-Precision Data & Analytical Upgrades

To support rigorous data science and charting (hello Python and Pandas!), we’ve added highly requested precision metrics:

• Nanosecond Resolution: We introduced -backed timing to achieve nanosecond resolution for thread execution and batch durations (wallclockTimeNs, batchWallclockTimeNs). Stopwatch
• Absolute Timestamps: Simulations are now cleanly anchored in real-world time with Unix Epoch timestamps (utcBeginTimeMs, utcEndTimeMs).
• Advanced Betting Metrics: We added tracking for specific bet distributions and win recalls (such as betHeads, betSame, and anticipatedSame) to mathematically prove the 50/50 baseline of our guessing mechanism.
• Dynamic Formatting: Instant visualization of micro-deviations from the baseline in console logs using scientific notation offsets (e.g., 50+1.9e-05%).

🔌 Plug-and-Play Extensibility

One of the most exciting additions is the new TrackerRunner. We’ve made the core anticipation engine deeply customizable:

• Delegate Support: You can now pass delegates for custom Anticipate logic directly into . TrackerRunner
• Virtual Methods: Key methods in the class are now virtual, allowing for easy specialization and overrides of the anticipation logic. Tracker
• Future-Proofing: We’ve unlocked early reflection potential, setting the stage for even more dynamic behavior in upcoming releases.

📊 New Client Utility: CSV Generation

To demonstrate the power of the new architecture, we’ve included a new sample client project (TruthInTheFlip_sample_csv). It showcases how to safely extract historical data and generate backwards-compatible CSV files from our .tkr records. And don’t worry—legacy v1.0 and v1.0.1 state files are seamlessly supported and migrated!

TruthInTheFlip v1.1.0 is a massive leap forward in turning our hypothesis tester into a robust, data-science-ready tool. Whether you’re exploring the properties of randomness, testing custom anticipation logic, or streaming billions of flips into Python, this update provides the foundation you need.

TruthInTheFlip on GitHub

Happy flipping! 🪙