fba-bench-core 1.0.0__py3-none-any.whl

fba_bench_core-1.0.0.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: fba-bench-core
+Version: 1.0.0
+Summary: Core interfaces, data models, and events for the FBA-Bench simulation platform.
+License: Apache-2.0
+License-File: LICENSE
+Keywords: benchmarking,simulation,fba,pydantic,typing
+Author: FBA Team
+Author-email: devnull@example.com
+Requires-Python: >=3.11,<4.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Dist: pydantic (>=2.0,<3.0)
+Project-URL: Documentation, https://your-org.github.io/fba-bench-core
+Project-URL: Homepage, https://github.com/your-org/fba-bench-core
+Project-URL: Issues, https://github.com/your-org/fba-bench-core/issues
+Project-URL: Repository, https://github.com/your-org/fba-bench-core
+Description-Content-Type: text/markdown
+
+# FBA-Bench Core — Contract-first Core Library
+
+Overview
+
+FBA-Bench Core is a compact, contract-first library for building and
+simulating Fulfillment-By-Amazon-style (FBA) business automation scenarios.
+The rebuilt core emphasizes explicit, versioned contracts (Pydantic v2 models)
+for domain models, events, commands, and typed configuration objects so
+downstream projects can reliably validate and integrate simulation logic.
+
+Key principles
+
+- Contract-first: canonical Pydantic v2 models are the single source of truth.
+- Typed, immutable configs: configuration objects are frozen models; use
+  model_copy(update={...}) to derive modified instances.
+- Explicit events/commands: typed discriminated unions with strict validation
+  (extra="forbid") to make integration predictable.
+
+Core modules
+
+- Domain models: [`src/fba_bench_core/domain/models.py`](src/fba_bench_core/domain/models.py:1)
+  - Product, InventorySnapshot, CompetitorListing, Competitor, DemandProfile
+- Events & Commands: [`src/fba_bench_core/domain/events.py`](src/fba_bench_core/domain/events.py:1)
+  - Typed BaseEvent/BaseCommand hierarchy and concrete events like SaleOccurred,
+    StockReplenished, PromotionLaunched; commands like AdjustPriceCommand,
+    PlaceReplenishmentOrderCommand.
+- Agent/service base classes: [`src/fba_bench_core/agents/base.py`](src/fba_bench_core/agents/base.py:1)
+  and [`src/fba_bench_core/services/base.py`](src/fba_bench_core/services/base.py:1)
+- Typed configs: [`src/fba_bench_core/config.py`](src/fba_bench_core/config.py:1)
+  - BaseAgentConfig, BaseServiceConfig (immutable, extra="forbid")
+
+Quick start (Poetry)
+
+Clone and install with Poetry:
+
+```bash
+git clone <repo-url>
+cd FBA-Bench-core
+poetry install
+```
+
+Run the test suite:
+
+```bash
+poetry run pytest -q
+```
+
+Using Core from another project
+
+1. Add FBA-Bench Core as a dependency (editable/local for development):
+
+```bash
+pip install -e /path/to/FBA-Bench-core
+```
+
+2. Import domain models and instantiate typed configs:
+
+```python
+from fba_bench_core.domain.models import Product
+from fba_bench_core.config import BaseAgentConfig
+
+p = Product(product_id="sku-1", cost="1.00", price="2.00", stock=10)
+cfg = BaseAgentConfig(agent_id="pricing-agent", poll_interval_seconds=30)
+```
+
+Migration guidance
+
+If you are upgrading from a legacy core:
+- See the migration guide: [`docs/migration-guide.md`](docs/migration-guide.md:1)
+- Key actions: import canonical models, convert numeric values to Decimal,
+  and replace mutable dict-based configs with typed Base*Config models.
+
+Tests, linting and quality commands
+
+The CI pipeline runs formatting, linting, type-checking and tests. Locally you
+can run the same commands via Poetry:
+
+```bash
+poetry run black src tests
+poetry run isort src tests
+poetry run flake8 src tests
+poetry run mypy
+poetry run pytest
+```
+
+Packaging & versioning workflow
+
+- CHANGELOG.md is generated from small towncrier fragments placed under
+  [`newsfragments/`](newsfragments/:1) and built with `towncrier`.
+- To add a changelog fragment: create a brief file `newsfragments/NN.description`
+  then run `poetry run towncrier build --yes`.
+- Version tooling: this repository includes [.bumpver.toml](.bumpver.toml:1)
+  and uses dynamic versioning in the packaging pipeline. Follow project policy
+  for release tagging and bumping; maintainers should prefer automated tools
+  (bumpver) that integrate with CI.
+
+Architecture and contracts
+
+See the in-repo architecture notes for the rebuilt core:
+- Core contracts: [`docs/architecture/core-contracts.md`](docs/architecture/core-contracts.md:1)
+- Architecture overview: [`docs/architecture.md`](docs/architecture.md:1)
+
+Documentation & rescue log
+
+The rescue log contains per-phase notes about the rebuild:
+- [`docs/rescue_log.md`](docs/rescue_log.md:1)
+- Phase G′ (Phase G-prime) documents updated documentation artifacts and
+  provides migration guidance for consumers; see [`docs/migration-guide.md`](docs/migration-guide.md:1).
+
+Contributing
+
+Please follow Conventional Commits for PRs, include tests for contract changes,
+and place towncrier fragments under `newsfragments/` for changelog entries.
+See [`docs/README.md`](docs/README.md:1) for broader documentation contribution
+guidelines.
+
+Tooling
+
+- Pre-commit hooks are configured in [`.pre-commit-config.yaml`](.pre-commit-config.yaml:1).
+- Towncrier configuration is in [`.towncrier.toml`](.towncrier.toml:1).
+
+License & contact
+
+- License: MIT — see [`LICENSE`](LICENSE:1)
+- Contact: project maintainers via repository issues or `press@fba-bench.ai`.
+

fba_bench_core-1.0.0.dist-info/RECORD

@@ -0,0 +1,52 @@
+fba_bench_core/__init__.py,sha256=kyC30sfGB24jCzZIDNZTHQKYzbcU2Z4J2TUS3-l6Ds8,340
+fba_bench_core/agents/__init__.py,sha256=YqxXvD5vygNb6riGUDkfLLAyHWvpCd6cq5f9hDRi6yI,496
+fba_bench_core/agents/base.py,sha256=NQbKqobRwJYV_KsKL7I3_lG2QKdxlKHPFJUAYjIfWNY,3131
+fba_bench_core/agents/registry.py,sha256=J9lU6-ZuB75C9Jd49GREKr6zElKr0mihTESSN3xMrvE,487
+fba_bench_core/benchmarking/__init__.py,sha256=Ss7kXFD5zW6otb_xFUEUTwljYtEcx00VnsIRcXZOcik,170
+fba_bench_core/benchmarking/core/__init__.py,sha256=f9brJoHmLuztcmGsA0CkSfETBxcQNUCQWjjbRCYm9w4,27
+fba_bench_core/benchmarking/engine/__init__.py,sha256=tzTLCBjPrsJOww6-ORuzpWA4LrBW1bPVXlcsR6BaTH4,262
+fba_bench_core/benchmarking/engine/core.py,sha256=oQwYOR8_QI8I13_5rYf1jRADuk5kNC-3Gg-m6eZcyUQ,5548
+fba_bench_core/benchmarking/engine/models.py,sha256=7d6doUC2ggJoiPdb7HGYFryHyjU-KyBg09TH-Uw8Y3g,1392
+fba_bench_core/benchmarking/metrics/__init__.py,sha256=G7lseePIxiCtrHEbgnI73mv1jLt0mHZzjyLNxlGJf-w,627
+fba_bench_core/benchmarking/metrics/accuracy_score.py,sha256=h6Jmmv178jXtmn7YjNGo8nLEu1ELN3sVNS0DD-_ChKI,769
+fba_bench_core/benchmarking/metrics/aggregate.py,sha256=J96Klsqiak-WFx4gffBErPibT0ZD3WmSEBvyLJCz4U0,1425
+fba_bench_core/benchmarking/metrics/completeness.py,sha256=B1ijofdC8e_NegFwv6cnhHJPAvybYn4ZMTcriyW7Cxw,1132
+fba_bench_core/benchmarking/metrics/cost_efficiency.py,sha256=A4QnIvum8SItcKwq_jyUGt4R0HspA_3XLHmgg92VTlg,1002
+fba_bench_core/benchmarking/metrics/custom_scriptable.py,sha256=VP1mxsWAYaYp11Lbgyje_xccR4sfiCF8n5tqKWJ-7a4,645
+fba_bench_core/benchmarking/metrics/keyword_coverage.py,sha256=KAabbaXChb7nh090hvvyYblQgCHpGJpN3jawFikL9u8,1116
+fba_bench_core/benchmarking/metrics/policy_compliance.py,sha256=spJ_t2crhdb4XAFswQsACnfCktFfXFaBZzxgpknow-Q,618
+fba_bench_core/benchmarking/metrics/registry.py,sha256=0xoD3S6SrAAXEQRfhc4-5knTbmmGifZx8913Oxs9bcY,1471
+fba_bench_core/benchmarking/metrics/robustness.py,sha256=7zOMjFoBK2DxdNSAeGScdh_OLscIn07HIFw3lYJ0KMo,778
+fba_bench_core/benchmarking/metrics/technical_performance.py,sha256=k7Q_gBDlAIxiTp6Z88IjOpZdPTuHkOevSVHWDWJ3SPA,523
+fba_bench_core/benchmarking/registry.py,sha256=odlep3bDNENBfPGK9YlBt1GDCyCvbaqQ9JBek92XHyQ,1383
+fba_bench_core/benchmarking/scenarios/__init__.py,sha256=6ao0MLSoUF4i_LxyJnIfFAAg7Nu9nSRa8emZDO2rBXY,32
+fba_bench_core/benchmarking/scenarios/base.py,sha256=wzOTLqwG6aiSv-Djk4TOjQihpE4yrr6BZSFQW8bfSA8,1061
+fba_bench_core/benchmarking/scenarios/complex_marketplace.py,sha256=YVXqkIAY_HwuR7_UM2UiTyHczRW0pFisU5jBOKZsCbI,6414
+fba_bench_core/benchmarking/scenarios/multiturn_tool_use.py,sha256=ZLiYIyL81uG2vtut0FXw83upcPoB3hz4agw3NqFZpys,6499
+fba_bench_core/benchmarking/scenarios/registry.py,sha256=tMPyO_WrG4QeQkF1NQG8BedjH0I-LwdxivQ7qrgJD28,407
+fba_bench_core/benchmarking/scenarios/research_summarization.py,sha256=GiLQOiCQWOKPxOhGuxpmF5VgnueVtodkaarp0hsmRdc,5077
+fba_bench_core/benchmarking/validators/__init__.py,sha256=V7fiZgpVaHymW9jloB4Bj80Ohb-yQD4Oqlvh_nPFTD0,571
+fba_bench_core/benchmarking/validators/determinism_check.py,sha256=QtVqbHOPat5CMhHwjr2iWk94x9r_TUeLETbxBhVrjPU,3244
+fba_bench_core/benchmarking/validators/fairness_balance.py,sha256=soC3mw_cHm9vWhC5HJnoHeP8dgL-Pk7qB7KHTXVV5Bk,2535
+fba_bench_core/benchmarking/validators/outlier_detection.py,sha256=3oFUQyzcPW6NCm33N83rzavundBj9PXkJuDVEBVRnlM,1576
+fba_bench_core/benchmarking/validators/registry.py,sha256=VXdLZxmVJGUBpvRomQNWJ4lJuucGFviyPJi5cfCQeJw,1586
+fba_bench_core/benchmarking/validators/reproducibility_metadata.py,sha256=rq4_Tup379VXXf6RftEo4thc8yiOEp3YPGlJDFbwriE,2529
+fba_bench_core/benchmarking/validators/schema_adherence.py,sha256=A1qM458czeMDQ-2mrJyJsJAnEgEA0H3rP9OpwySDWDU,2109
+fba_bench_core/benchmarking/validators/structural_consistency.py,sha256=gn_8dsC37lUMU3u_LV7cTvxFeYdBRslP8bAA6CahMe0,2404
+fba_bench_core/config.py,sha256=QI11MsNpvgpTIt-2sU7EU9YmcfaGejE2aja8Ma0bD1s,5772
+fba_bench_core/domain/__init__.py,sha256=Rz9K7s0bxLn6WFEYG0d9Brp80WoRczyqwWal5Nrv5aU,1875
+fba_bench_core/domain/events/__init__.py,sha256=BtwH0cM__GloFJqKhdks79JVh9lWmu9PxZKcq9Ce2oI,6314
+fba_bench_core/domain/events/analytics.py,sha256=QcDPcSJzmc6jbnjIDyeEu_sEtsriHFBrHHJdFw8kZwU,2035
+fba_bench_core/domain/events/base.py,sha256=uosAiiZY_CqksKJnvjMrIqsQhYsUUXHVy3QiE7UwQ9M,2200
+fba_bench_core/domain/events/inventory.py,sha256=h_e6RmvxydRPpKfnbL_OIrNrzypGlyITf0l07ptKYc4,3801
+fba_bench_core/domain/events/marketing.py,sha256=JOTnct1lDVOBM1C9pbVGH54CsrsuPLFlekzM8gRG-4w,3162
+fba_bench_core/domain/events/pricing.py,sha256=mPT34R7WRQNORTRuSDxs-2o0lnlW3SnOeCKbbKDwEwI,6065
+fba_bench_core/domain/models.py,sha256=t9ESz5oDtxVFov0flnBrbneCT2SMWnDwuQl3BN3Us7Y,11489
+fba_bench_core/exceptions/__init__.py,sha256=e2QQu0mJ1JptILUBfa5WEYNtBGNzOdUfYlkVtnKA2cw,303
+fba_bench_core/exceptions/base.py,sha256=D5R72qX1HAvIwzlvoJpl5jf2i-MgahOCIpGeJsdocic,1388
+fba_bench_core/services/__init__.py,sha256=M8mgldXEVKPS1JtK46dNv_WNBjLw7WmTN1BD-W3xsGg,297
+fba_bench_core/services/base.py,sha256=U5HI7Yk-c4RBNJTTg_E9gt_KUQfN0Om-BqVsy-nYFfk,1897
+fba_bench_core-1.0.0.dist-info/licenses/LICENSE,sha256=w-_y1eaTYrejdQvth48gtUvhxEgsEgFRe1JX-BGylSU,1097
+fba_bench_core-1.0.0.dist-info/METADATA,sha256=MD3BlyAZjRekc1Nj6nQZa4m8ihy0pZO27uUPFqHhV4w,5672
+fba_bench_core-1.0.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+fba_bench_core-1.0.0.dist-info/RECORD,,

fba_bench_core-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.1
+Root-Is-Purelib: true
+Tag: py3-none-any

fba_bench_core-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FBA-Bench Core Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.