refactor(core): establish clean deterministic Core package baseline

.github/ISSUE_TEMPLATE/bug_report.md → .github/ISSUE_TEMPLATE/bug-report.md

@@ -27,4 +27,4 @@ What should happen?
 
 ## Logs / Output
 
-Paste relevant logs, stack traces, or event output here.
+Paste relevant logs, traces, or outputs here.

.gitignore

@@ -23,7 +23,6 @@ venv.bak/
 *.key
 *.crt
 *.pub
-.oci/
 
 # ==============================
 # Python packaging / build artifacts

CHANGELOG.md

@@ -1,60 +1,24 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-The format is based on Keep a Changelog
-and this project adheres to Semantic Versioning.
+This changelog starts from the clean Core package baseline.
 
 ## [Unreleased]
 
-## [0.1.0] - 2026-02-17
+### Added
 
-Initial public release of the core.
+- Deterministic `run_core_step` and `run_core_wakeup_step` architecture.
+- CoreWakeupStep final-state Strategy evaluation: reduce all entries, then `CoreWakeupStrategyEvaluator` once.
+- Canonical Event input models and `EventStreamEntry`/`ProcessingPosition`.
+- Intent candidate record pipeline with dominance/reconciliation.
+- Risk Engine (policy-only) admission and Execution Control plan/apply integration.
+- `CoreStepResult.dispatchable_intents` and `ControlSchedulingObligation` outputs.
+- Core-only quickstart example and focused semantics test coverage.
 
-### Added
+### Changed
+
+- Package metadata, exports, and docs reset for standalone Core library identity.
+- Pydantic models established as contract source of truth across public API docs.
+
+### Removed
 
-#### Core Domain
-- Explicit order state machine
-- Structured domain types and reject reasons
-- Slot-based order tracking
-- Event bus and event sink abstractions
-- JSON schema validation for domain events
-
-#### Risk Layer
-- Configurable risk engine
-- Risk constraint enforcement
-- Deterministic risk gating before execution
-
-#### Backtest Layer
-- Integration with [hftbacktest](https://github.com/nkaz001/hftbacktest)
-- Strategy runner abstraction
-- Venue adapter interface
-- Deterministic event processing pipeline
-
-#### Orchestration
-- Segment-based execution model
-- Parameter sweep runtime
-- Experiment and segment entrypoints
-- Prometheus metrics integration
-- MLflow-compatible logging hooks
-
-#### Execution Modes
-- Fully local execution example
-- Cloud-native runtime entrypoints
-- S3-compatible storage adapter
-
-#### Strategy
-- Base strategy interface
-- Structured strategy configuration
-
-#### Testing
-- Semantic invariant test suite
-- Order state transition validation
-- Queue dominance rules
-- Risk constraint validation
-- Schema conformance tests
-
-#### Tooling
-- Dev container configuration
-- Development validation scripts
-- Dependency compilation helper
+- Legacy compatibility-first contracts and references not part of the clean baseline.

CONTRIBUTING.md

@@ -1,63 +1,80 @@
-# Contributing
+# Contributing to TradingChassis Core
 
-Thank you for your interest in contributing!
+Contributions should preserve TradingChassis Core as a deterministic,
+Runtime-agnostic library.
 
-This repository focuses on deterministic, event-driven trading architecture.
-Contributions should preserve clarity, explicitness and reproducibility.
+> Terminology: Definitions and related terms match the [canonical
+> terminology](https://tradingchassis.github.io/docs/latest/00-guides/terminology/).
 
----
+## Package Scope
 
-## Design Principles
+- Core owns canonical Events, State reduction, Strategy evaluation boundary,
+  candidate reconciliation, Risk Engine (policy), Execution Control plan/apply,
+  and `CoreStepResult`.
+- Core does not own Runtime orchestration, Venue Adapters, dispatch lifecycle,
+  or deployment/config wiring.
 
-All contributions must respect the core design philosophy:
+## Development Setup
 
-- Determinism over convenience
-- Explicit state modeling
-- No hidden side effects
-- Risk-first architecture
-- Clear domain boundaries
+From `core`:
 
-Avoid introducing implicit behavior or non-deterministic execution paths.
+```bash
+python -m pip install -e ".[dev]"
+```
 
----
+## Validation Commands
 
-## Workflow
+Run before opening a PR:
 
-1. Fork the repository
-2. Create a feature branch
-3. Commit small, logical changes
-4. Open a Pull Request with clear description
+```bash
+python examples/core_step_quickstart.py
+python -m pytest -q
+python -m build
+```
 
----
+## Architecture Rules
 
-## Commit Style
+- Core accepts canonical Events through `EventStreamEntry` and
+  `process_event_entry` / `process_canonical_event`.
+- Core returns deterministic `CoreStepResult`; Runtime dispatches.
+- Do not introduce Runtime imports.
+- Pydantic models are the source of truth for contract structure.
 
-Use clear messages:
+## Changing Core Behavior
 
-feat: add monitoring overlay  
-fix: correct SecretProviderClass parameters  
-docs: update bootstrap instructions  
+### Canonical Events
 
----
+- Add Event models in `tradingchassis_core/core/domain/types.py`.
+- Register canonical category handling in `core/domain/event_model.py`.
+- Update canonical reduction behavior in `core/domain/processing.py`.
 
-## Development Environment
+### CoreStep/CoreWakeupStep pipeline
 
-Recommended:
+- Update `core/domain/processing_step.py` for deterministic flow changes.
+- Keep reconciliation/policy/apply transitions explicit and side-effect-safe.
 
-- Python 3.11.x
-- Dev Container (provided in this repository)
+### Risk Engine (policy) behavior
 
-Alternatively:
+- Implement policy checks in `core/risk/` and wire through
+  `evaluate_policy_intent`.
+- Keep Risk Engine admission as policy-only; no dispatch/Runtime side effects.
 
-```bash
-pip install -e .
-```
+### Execution Control behavior
+
+- Update plan/apply stages in `core/domain/execution_control_plan.py` and
+  `core/domain/execution_control_apply.py`.
+- Preserve `ControlSchedulingObligation` as non-canonical output.
 
----
+### Public API exports and docs
 
-## Testing
+- Update `tradingchassis_core/__init__.py` for intentional public exports only.
+- Sync docs in `README.md` and `docs/reference/public-api.md`.
 
-Before submitting:
+## Pull Request Checklist
 
-- The `./scripts/check.sh` script must pass
-- All backtests must complete successfully and produce result artifacts
+- [ ] Package remains Core-only and deterministic.
+- [ ] Public API changes are intentional and tested.
+- [ ] Quickstart still runs via public imports.
+- [ ] `python -m pytest -q` passes.
+- [ ] `python -m build` succeeds.
+- [ ] README/docs/changelog updated to match behavior.