math-modeling-competition-kit 0.1.0a1__tar.gz

math_modeling_competition_kit-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jzhao0
+
+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.

math_modeling_competition_kit-0.1.0a1/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: math-modeling-competition-kit
+Version: 0.1.0a1
+Summary: Reusable engineering infrastructure for mathematical modeling competitions
+Author: jzhao0
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jzhao0/math-modeling-competition-kit
+Project-URL: Repository, https://github.com/jzhao0/math-modeling-competition-kit
+Project-URL: Issues, https://github.com/jzhao0/math-modeling-competition-kit/issues
+Project-URL: Documentation, https://github.com/jzhao0/math-modeling-competition-kit/tree/main/docs
+Keywords: mathematical-modeling,reproducibility,competition,research-engineering
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Math Modeling Competition Kit
+
+A reusable engineering toolkit for mathematical modeling competitions.
+
+## Release status
+
+The current public line is preparing **`v0.1.0a1`**. This release is intentionally an **engineering core**, not an algorithm encyclopedia.
+
+The `v0.1.x` public scope is distilled from the completed CUMCM 2026 development cycle and subsequent generic hardening of those engineering capabilities. It does **not** publish private contest artifacts, active future-competition training, or competition-specific tactics.
+
+> Core principle: **Choose and validate the model early. Once the model is correct, optimize the algorithm and engineering implementation instead of endlessly replacing the model.**
+
+## What v0.1 provides
+
+- deterministic workspace manifests;
+- bounded clean-room execution;
+- generic final-submission engineering audit;
+- claim/evidence provenance locks and stale detection;
+- cross-platform competition project scaffold;
+- deterministic LaTeX source/dependency/citation audit;
+- bounded shell-free paper build with PDF hash evidence;
+- revision-guarded multi-agent task state and role leases;
+- compact handoff, stale-lease reporting, writer/reviewer separation, and two-failure circuit breaking;
+- post-model-freeze warmup/repeated-run runtime benchmarking;
+- explicit runtime regression thresholds, environment-drift reporting, and output-identity locks;
+- Windows + Ubuntu CI on Python 3.11 and 3.13.
+
+Reusable modeling modules such as rolling-horizon engines, scenario reduction, or solver abstractions are **not part of v0.1 unless repeated real-project need has been established and the module has separately passed public-release review**.
+
+## Installation
+
+From a source checkout:
+
+```text
+python -m pip install .
+```
+
+After the first PyPI release is explicitly approved and published:
+
+```text
+python -m pip install math-modeling-competition-kit
+```
+
+The command-line entry point is:
+
+```text
+mmkit --help
+```
+
+## Workflow
+
+```text
+Problem understanding
+-> Model design
+-> Model validation
+-> MODEL_FROZEN
+-> Correct implementation
+-> Clean-room reproduction
+-> Algorithm/runtime optimization
+-> Production core
+-> Paper/figures/tables
+-> Final submission gate
+-> Hash/freeze/submit
+```
+
+## Quick start
+
+Create a generic workspace without assuming a specific future contest:
+
+```text
+mmkit init demo-project --competition CUSTOM --year 2027
+cd demo-project
+mmkit coord status .
+mmkit reproduce . config/run_manifest.json --json coordination/reproduction.json
+mmkit benchmark run . config/benchmark.json --json coordination/benchmark.json
+mmkit paper init .
+mmkit paper audit . paper/main.tex --json coordination/paper_audit.json
+```
+
+After a correct implementation is selected, lock an explicit runtime/output baseline before optimizing it:
+
+```text
+mmkit benchmark lock coordination/benchmark.json \
+  --output coordination/benchmark.baseline.json \
+  --max-regression-percent 15
+
+mmkit benchmark compare \
+  coordination/benchmark.json \
+  coordination/benchmark.baseline.json \
+  --json coordination/benchmark.compare.json
+```
+
+When a TeX runtime is installed and the build contract is configured:
+
+```text
+mmkit paper build . config/paper_build.json --json coordination/paper_build.json
+```
+
+## Documentation
+
+See:
+
+- `docs/PROJECT_SCAFFOLD.md` — workspace contract;
+- `docs/MVP_REPRODUCIBILITY_FINAL_GATE.md` — clean-room and final-gate semantics;
+- `docs/PROVENANCE_MVP.md` — claim/evidence locking;
+- `docs/PAPER_PIPELINE_MVP.md` — paper auditing/build semantics;
+- `docs/AGENT_COORDINATION.md` — multi-agent checkpoint/handoff semantics;
+- `docs/ALGORITHM_RUNTIME_BENCHMARKING.md` — post-model-freeze performance measurement;
+- `docs/RELEASE_SCOPE_V0.1.md` — exact first-release publication boundary;
+- `docs/RELEASE_CHECKLIST_V0.1.md` — release gate and remaining external actions.
+
+## Repository structure
+
+- `src/mmkit/` — reusable Python package;
+- `tools/` — release/final-gate and audit utilities;
+- `coordination/` — public coordination contracts;
+- `tests/` — automated tests;
+- `docs/` — architecture, contracts, roadmap and release documents;
+- `migration_sources/` — frozen historical migration evidence; not product code and not part of public distribution archives.
+
+## Design principles
+
+1. Model selection happens early.
+2. Correctness comes before performance.
+3. After correctness, optimize algorithms and implementation before changing models.
+4. Research pipelines and production pipelines must be separated.
+5. Every important paper claim should have a traceable producer.
+6. Final results must be reproducible from a clean environment.
+7. Only one final integrator may write to the final submission directory.
+8. New research routes stop before the submission deadline.
+9. Submission artifacts are validated, hashed and frozen.
+10. Postmortems are converted into reusable tooling only after privacy/provenance/reuse review.
+
+## Publication boundary
+
+Future competition training and new competition-specific work are private by default. They are not copied into this public repository during active preparation or competition. Any later publication requires a separate post-competition distillation, provenance/license review, tests, PR, and explicit human publication decision.
+
+## License
+
+MIT

math_modeling_competition_kit-0.1.0a1/README.md

@@ -0,0 +1,140 @@
+# Math Modeling Competition Kit
+
+A reusable engineering toolkit for mathematical modeling competitions.
+
+## Release status
+
+The current public line is preparing **`v0.1.0a1`**. This release is intentionally an **engineering core**, not an algorithm encyclopedia.
+
+The `v0.1.x` public scope is distilled from the completed CUMCM 2026 development cycle and subsequent generic hardening of those engineering capabilities. It does **not** publish private contest artifacts, active future-competition training, or competition-specific tactics.
+
+> Core principle: **Choose and validate the model early. Once the model is correct, optimize the algorithm and engineering implementation instead of endlessly replacing the model.**
+
+## What v0.1 provides
+
+- deterministic workspace manifests;
+- bounded clean-room execution;
+- generic final-submission engineering audit;
+- claim/evidence provenance locks and stale detection;
+- cross-platform competition project scaffold;
+- deterministic LaTeX source/dependency/citation audit;
+- bounded shell-free paper build with PDF hash evidence;
+- revision-guarded multi-agent task state and role leases;
+- compact handoff, stale-lease reporting, writer/reviewer separation, and two-failure circuit breaking;
+- post-model-freeze warmup/repeated-run runtime benchmarking;
+- explicit runtime regression thresholds, environment-drift reporting, and output-identity locks;
+- Windows + Ubuntu CI on Python 3.11 and 3.13.
+
+Reusable modeling modules such as rolling-horizon engines, scenario reduction, or solver abstractions are **not part of v0.1 unless repeated real-project need has been established and the module has separately passed public-release review**.
+
+## Installation
+
+From a source checkout:
+
+```text
+python -m pip install .
+```
+
+After the first PyPI release is explicitly approved and published:
+
+```text
+python -m pip install math-modeling-competition-kit
+```
+
+The command-line entry point is:
+
+```text
+mmkit --help
+```
+
+## Workflow
+
+```text
+Problem understanding
+-> Model design
+-> Model validation
+-> MODEL_FROZEN
+-> Correct implementation
+-> Clean-room reproduction
+-> Algorithm/runtime optimization
+-> Production core
+-> Paper/figures/tables
+-> Final submission gate
+-> Hash/freeze/submit
+```
+
+## Quick start
+
+Create a generic workspace without assuming a specific future contest:
+
+```text
+mmkit init demo-project --competition CUSTOM --year 2027
+cd demo-project
+mmkit coord status .
+mmkit reproduce . config/run_manifest.json --json coordination/reproduction.json
+mmkit benchmark run . config/benchmark.json --json coordination/benchmark.json
+mmkit paper init .
+mmkit paper audit . paper/main.tex --json coordination/paper_audit.json
+```
+
+After a correct implementation is selected, lock an explicit runtime/output baseline before optimizing it:
+
+```text
+mmkit benchmark lock coordination/benchmark.json \
+  --output coordination/benchmark.baseline.json \
+  --max-regression-percent 15
+
+mmkit benchmark compare \
+  coordination/benchmark.json \
+  coordination/benchmark.baseline.json \
+  --json coordination/benchmark.compare.json
+```
+
+When a TeX runtime is installed and the build contract is configured:
+
+```text
+mmkit paper build . config/paper_build.json --json coordination/paper_build.json
+```
+
+## Documentation
+
+See:
+
+- `docs/PROJECT_SCAFFOLD.md` — workspace contract;
+- `docs/MVP_REPRODUCIBILITY_FINAL_GATE.md` — clean-room and final-gate semantics;
+- `docs/PROVENANCE_MVP.md` — claim/evidence locking;
+- `docs/PAPER_PIPELINE_MVP.md` — paper auditing/build semantics;
+- `docs/AGENT_COORDINATION.md` — multi-agent checkpoint/handoff semantics;
+- `docs/ALGORITHM_RUNTIME_BENCHMARKING.md` — post-model-freeze performance measurement;
+- `docs/RELEASE_SCOPE_V0.1.md` — exact first-release publication boundary;
+- `docs/RELEASE_CHECKLIST_V0.1.md` — release gate and remaining external actions.
+
+## Repository structure
+
+- `src/mmkit/` — reusable Python package;
+- `tools/` — release/final-gate and audit utilities;
+- `coordination/` — public coordination contracts;
+- `tests/` — automated tests;
+- `docs/` — architecture, contracts, roadmap and release documents;
+- `migration_sources/` — frozen historical migration evidence; not product code and not part of public distribution archives.
+
+## Design principles
+
+1. Model selection happens early.
+2. Correctness comes before performance.
+3. After correctness, optimize algorithms and implementation before changing models.
+4. Research pipelines and production pipelines must be separated.
+5. Every important paper claim should have a traceable producer.
+6. Final results must be reproducible from a clean environment.
+7. Only one final integrator may write to the final submission directory.
+8. New research routes stop before the submission deadline.
+9. Submission artifacts are validated, hashed and frozen.
+10. Postmortems are converted into reusable tooling only after privacy/provenance/reuse review.
+
+## Publication boundary
+
+Future competition training and new competition-specific work are private by default. They are not copied into this public repository during active preparation or competition. Any later publication requires a separate post-competition distillation, provenance/license review, tests, PR, and explicit human publication decision.
+
+## License
+
+MIT

math_modeling_competition_kit-0.1.0a1/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "math-modeling-competition-kit"
+version = "0.1.0a1"
+description = "Reusable engineering infrastructure for mathematical modeling competitions"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "jzhao0"}]
+keywords = ["mathematical-modeling", "reproducibility", "competition", "research-engineering"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Science/Research",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering :: Mathematics",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/jzhao0/math-modeling-competition-kit"
+Repository = "https://github.com/jzhao0/math-modeling-competition-kit"
+Issues = "https://github.com/jzhao0/math-modeling-competition-kit/issues"
+Documentation = "https://github.com/jzhao0/math-modeling-competition-kit/tree/main/docs"
+
+[project.scripts]
+mmkit = "mmkit.cli:main"
+mmkit-final-gate = "mmkit.submission.gate:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+package-dir = {"" = "src"}

math_modeling_competition_kit-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

math_modeling_competition_kit-0.1.0a1/src/math_modeling_competition_kit.egg-info/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: math-modeling-competition-kit
+Version: 0.1.0a1
+Summary: Reusable engineering infrastructure for mathematical modeling competitions
+Author: jzhao0
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jzhao0/math-modeling-competition-kit
+Project-URL: Repository, https://github.com/jzhao0/math-modeling-competition-kit
+Project-URL: Issues, https://github.com/jzhao0/math-modeling-competition-kit/issues
+Project-URL: Documentation, https://github.com/jzhao0/math-modeling-competition-kit/tree/main/docs
+Keywords: mathematical-modeling,reproducibility,competition,research-engineering
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Math Modeling Competition Kit
+
+A reusable engineering toolkit for mathematical modeling competitions.
+
+## Release status
+
+The current public line is preparing **`v0.1.0a1`**. This release is intentionally an **engineering core**, not an algorithm encyclopedia.
+
+The `v0.1.x` public scope is distilled from the completed CUMCM 2026 development cycle and subsequent generic hardening of those engineering capabilities. It does **not** publish private contest artifacts, active future-competition training, or competition-specific tactics.
+
+> Core principle: **Choose and validate the model early. Once the model is correct, optimize the algorithm and engineering implementation instead of endlessly replacing the model.**
+
+## What v0.1 provides
+
+- deterministic workspace manifests;
+- bounded clean-room execution;
+- generic final-submission engineering audit;
+- claim/evidence provenance locks and stale detection;
+- cross-platform competition project scaffold;
+- deterministic LaTeX source/dependency/citation audit;
+- bounded shell-free paper build with PDF hash evidence;
+- revision-guarded multi-agent task state and role leases;
+- compact handoff, stale-lease reporting, writer/reviewer separation, and two-failure circuit breaking;
+- post-model-freeze warmup/repeated-run runtime benchmarking;
+- explicit runtime regression thresholds, environment-drift reporting, and output-identity locks;
+- Windows + Ubuntu CI on Python 3.11 and 3.13.
+
+Reusable modeling modules such as rolling-horizon engines, scenario reduction, or solver abstractions are **not part of v0.1 unless repeated real-project need has been established and the module has separately passed public-release review**.
+
+## Installation
+
+From a source checkout:
+
+```text
+python -m pip install .
+```
+
+After the first PyPI release is explicitly approved and published:
+
+```text
+python -m pip install math-modeling-competition-kit
+```
+
+The command-line entry point is:
+
+```text
+mmkit --help
+```
+
+## Workflow
+
+```text
+Problem understanding
+-> Model design
+-> Model validation
+-> MODEL_FROZEN
+-> Correct implementation
+-> Clean-room reproduction
+-> Algorithm/runtime optimization
+-> Production core
+-> Paper/figures/tables
+-> Final submission gate
+-> Hash/freeze/submit
+```
+
+## Quick start
+
+Create a generic workspace without assuming a specific future contest:
+
+```text
+mmkit init demo-project --competition CUSTOM --year 2027
+cd demo-project
+mmkit coord status .
+mmkit reproduce . config/run_manifest.json --json coordination/reproduction.json
+mmkit benchmark run . config/benchmark.json --json coordination/benchmark.json
+mmkit paper init .
+mmkit paper audit . paper/main.tex --json coordination/paper_audit.json
+```
+
+After a correct implementation is selected, lock an explicit runtime/output baseline before optimizing it:
+
+```text
+mmkit benchmark lock coordination/benchmark.json \
+  --output coordination/benchmark.baseline.json \
+  --max-regression-percent 15
+
+mmkit benchmark compare \
+  coordination/benchmark.json \
+  coordination/benchmark.baseline.json \
+  --json coordination/benchmark.compare.json
+```
+
+When a TeX runtime is installed and the build contract is configured:
+
+```text
+mmkit paper build . config/paper_build.json --json coordination/paper_build.json
+```
+
+## Documentation
+
+See:
+
+- `docs/PROJECT_SCAFFOLD.md` — workspace contract;
+- `docs/MVP_REPRODUCIBILITY_FINAL_GATE.md` — clean-room and final-gate semantics;
+- `docs/PROVENANCE_MVP.md` — claim/evidence locking;
+- `docs/PAPER_PIPELINE_MVP.md` — paper auditing/build semantics;
+- `docs/AGENT_COORDINATION.md` — multi-agent checkpoint/handoff semantics;
+- `docs/ALGORITHM_RUNTIME_BENCHMARKING.md` — post-model-freeze performance measurement;
+- `docs/RELEASE_SCOPE_V0.1.md` — exact first-release publication boundary;
+- `docs/RELEASE_CHECKLIST_V0.1.md` — release gate and remaining external actions.
+
+## Repository structure
+
+- `src/mmkit/` — reusable Python package;
+- `tools/` — release/final-gate and audit utilities;
+- `coordination/` — public coordination contracts;
+- `tests/` — automated tests;
+- `docs/` — architecture, contracts, roadmap and release documents;
+- `migration_sources/` — frozen historical migration evidence; not product code and not part of public distribution archives.
+
+## Design principles
+
+1. Model selection happens early.
+2. Correctness comes before performance.
+3. After correctness, optimize algorithms and implementation before changing models.
+4. Research pipelines and production pipelines must be separated.
+5. Every important paper claim should have a traceable producer.
+6. Final results must be reproducible from a clean environment.
+7. Only one final integrator may write to the final submission directory.
+8. New research routes stop before the submission deadline.
+9. Submission artifacts are validated, hashed and frozen.
+10. Postmortems are converted into reusable tooling only after privacy/provenance/reuse review.
+
+## Publication boundary
+
+Future competition training and new competition-specific work are private by default. They are not copied into this public repository during active preparation or competition. Any later publication requires a separate post-competition distillation, provenance/license review, tests, PR, and explicit human publication decision.
+
+## License
+
+MIT

math_modeling_competition_kit-0.1.0a1/src/math_modeling_competition_kit.egg-info/SOURCES.txt

@@ -0,0 +1,48 @@
+LICENSE
+README.md
+pyproject.toml
+src/math_modeling_competition_kit.egg-info/PKG-INFO
+src/math_modeling_competition_kit.egg-info/SOURCES.txt
+src/math_modeling_competition_kit.egg-info/dependency_links.txt
+src/math_modeling_competition_kit.egg-info/entry_points.txt
+src/math_modeling_competition_kit.egg-info/top_level.txt
+src/mmkit/__init__.py
+src/mmkit/cli.py
+src/mmkit/paper.py
+src/mmkit/benchmark/__init__.py
+src/mmkit/benchmark/core.py
+src/mmkit/coordination/__init__.py
+src/mmkit/coordination/core.py
+src/mmkit/optimization/__init__.py
+src/mmkit/provenance/__init__.py
+src/mmkit/provenance/registry.py
+src/mmkit/reporting/__init__.py
+src/mmkit/reproducibility/__init__.py
+src/mmkit/reproducibility/manifest.py
+src/mmkit/reproducibility/runner.py
+src/mmkit/rolling_horizon/__init__.py
+src/mmkit/scaffold/__init__.py
+src/mmkit/scaffold/project.py
+src/mmkit/scenarios/__init__.py
+src/mmkit/submission/__init__.py
+src/mmkit/submission/gate.py
+tests/test_benchmark.py
+tests/test_benchmark_cli.py
+tests/test_cli.py
+tests/test_coordination.py
+tests/test_coordination_cli.py
+tests/test_distribution_audit.py
+tests/test_paper.py
+tests/test_paper_cli.py
+tests/test_provenance.py
+tests/test_provenance_cli.py
+tests/test_publish_workflow_contract.py
+tests/test_release_metadata.py
+tests/test_release_tag.py
+tests/test_reproducibility_manifest.py
+tests/test_reproducibility_runner.py
+tests/test_scaffold.py
+tests/test_scaffold_benchmark.py
+tests/test_scaffold_cli.py
+tests/test_scaffold_coordination.py
+tests/test_submission_gate.py

math_modeling_competition_kit-0.1.0a1/src/math_modeling_competition_kit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

math_modeling_competition_kit-0.1.0a1/src/math_modeling_competition_kit.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+mmkit = mmkit.cli:main
+mmkit-final-gate = mmkit.submission.gate:main

math_modeling_competition_kit-0.1.0a1/src/math_modeling_competition_kit.egg-info/top_level.txt

@@ -0,0 +1 @@
+mmkit

math_modeling_competition_kit-0.1.0a1/src/mmkit/__init__.py

@@ -0,0 +1,5 @@
+"""Math Modeling Competition Kit public package."""
+
+__version__ = "0.1.0a1"
+
+__all__ = ["__version__"]

math_modeling_competition_kit-0.1.0a1/src/mmkit/benchmark/__init__.py

@@ -0,0 +1,23 @@
+"""Algorithm/runtime benchmarking primitives."""
+
+from .core import (
+    BenchmarkError,
+    build_baseline,
+    compare_to_baseline,
+    init_benchmark,
+    load_baseline,
+    run_benchmark,
+    validate_benchmark_manifest,
+    write_json,
+)
+
+__all__ = [
+    "BenchmarkError",
+    "build_baseline",
+    "compare_to_baseline",
+    "init_benchmark",
+    "load_baseline",
+    "run_benchmark",
+    "validate_benchmark_manifest",
+    "write_json",
+]