Skip to content

feat: finalize Core semantic processing milestone#8

Merged
bxvtr merged 61 commits intomainfrom
refactor
May 5, 2026
Merged

feat: finalize Core semantic processing milestone#8
bxvtr merged 61 commits intomainfrom
refactor

Conversation

@bxvtr
Copy link
Copy Markdown
Contributor

@bxvtr bxvtr commented May 5, 2026

Summary

Finalize the current Core semantic processing milestone by aligning and validating the canonical processing API, event stream boundary, and public Core package surface.

Motivation

This change makes Core usable as the semantic foundation for Core Runtime. It confirms that canonical event processing is exposed through the public tradingchassis_core API and that Core remains venue-agnostic while preserving the current transitional boundaries.

Type of Change

  • Bug fix
  • New feature
  • Performance improvement
  • Refactor
  • Documentation
  • Breaking change
  • Test / validation hardening

Technical Details

  • Verified the public Core API surface for:
    • CoreConfiguration
    • ProcessingPosition
    • EventStreamEntry
    • process_event_entry
    • fold_event_stream_entries
  • Added/standardized public API surface tests.
  • Confirmed canonical processing uses EventStreamEntry(position, event) with call-level CoreConfiguration.
  • Confirmed compatibility artifacts remain non-canonical and rejected at the canonical boundary.
  • Confirmed Core does not import core_runtime, trading_runtime, or hftbacktest in production code.

Determinism & Reproducibility

  • Change preserves deterministic behavior
  • Tests confirm reproducibility
  • No hidden state introduced

Performance Impact

  • No measurable impact
  • Benchmarks included
  • Performance improvement

Tests

  • Unit tests added/updated
  • Integration tests added/updated
  • Existing tests pass

Validation performed:

  • python -m pytest -q tests/semantics/models/test_public_canonical_api_surface.py
    • 3 passed
  • python -m pytest -q tests/semantics
    • 198 passed
  • ./scripts/check.sh
    • passed

Breaking Changes

None.

The public canonical processing API is validated, but no behavior or import path was changed.

Checklist

  • Code follows project style guidelines
  • Self-review completed
  • Documentation updated (if needed)

bxvtr added 30 commits April 29, 2026 14:23
…ocessingPosition the causal ordering authority
…d a process_event_entry(...) wrapper that delegates to the existing canonical boundary
…resses the core contract:

same ordered EventStreamEntry sequence + same explicit configuration => same derived StrategyState
…hat gives configuration a stable semantic identity/fingerprint for deterministic fold/replay contracts, without changing reducers
bxvtr added 27 commits May 2, 2026 15:30
…ers navigate current core implementation contracts
… the execution-feedback boundary for future FillEvent ingress
…es the Control-Time Event boundary before implementation
…future runtime/adapter execution-feedback source must guarantee before canonical FillEvent ingress can be implemented
…eptual ExecutionFeedbackRecord source shape and guarantees required before future FillEvent ingress work
…current post-submission lifecycle authority split
…eneric adapter source capabilities and their semantic authority classifications without adding adapter APIs or hftbacktest-specific Core semantics
…ponsibilities for ProcessingContext and EventStreamCursor
…ime cursor behavior and future EventStreamCursor extraction invariants
…cords the current semantic implementation status
…target names and package structure before any mechanical rename
…ngchassis_core while preserving old nested imports through a compatibility shim
… and semantically aligned with the architecture described in the `docs` repository
…le and stable for downstream users such as Core Runtime
@bxvtr bxvtr self-assigned this May 5, 2026
@bxvtr bxvtr merged commit 2c31754 into main May 5, 2026
1 check passed
@bxvtr bxvtr deleted the refactor branch May 5, 2026 14:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant