supplycm 1.2.1__tar.gz

supplycm-1.2.1/CHANGELOG.md

@@ -0,0 +1,135 @@
+# Changelog
+
+All notable changes to supplycm will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Planned
+- Machine learning algorithms
+- Real-time dashboards
+
+## [1.2.1] - 2026-09-06
+
+### Changed
+- Moved education materials (learning paths, concept map, flashcards, notebooks) to a separate repository
+- Package now contains only the Python library, tests, and examples
+- Updated README to link to the companion learning repository
+
+### Notes
+- No algorithm changes in this release
+- No breaking changes
+
+
+
+### Planned
+- Machine learning algorithms
+- Real-time dashboards
+- API wrapper
+## [1.2.0] - 2026-09-06
+
+### Added
+- 13 new algorithms across 3 new categories:
+  - Network Design (5): center of gravity, facility location, single-source allocation, break-even, network reliability
+  - IoT / Real-time (4): anomaly detection, sensor smoothing, inventory monitoring, data aggregation
+  - Blockchain (4): hash chain, verify chain, provenance tracking, smart contracts
+- 5 interactive Jupyter notebooks for hands-on learning
+- Unit tests for all new algorithms
+
+### Changed
+- Total algorithm count increased from 384 to 397
+- README updated with notebook links
+
+
+
+### Planned
+- Interactive learning notebooks
+- Video tutorials
+- Certification program
+## [1.1.0] - 2026-09-06
+
+### Added
+- 24 new algorithms across 7 new categories:
+  - Quality / Six Sigma (7): X-bar chart, R chart, P-chart, Cp, Cpk, DPMO, sigma level
+  - Lean (4): takt time, OEE, cycle efficiency, WIP calculation
+  - S&OP (3): demand-supply match, chase and level production strategies
+  - Sustainability (3): carbon footprint, reverse logistics, energy consumption
+  - Contracts (3): revenue sharing, buyback, quantity flexibility
+  - Simulation (2): Monte Carlo inventory and risk
+  - Cost (2): landed cost, total procurement cost
+- Comprehensive education framework:
+  - Learning paths (beginner to advanced)
+  - Concept map showing algorithm relationships
+  - Data sources guide per algorithm
+  - Flashcards for exam preparation
+  - Plain English guides per category
+- Unit tests for all new algorithms
+
+### Changed
+- Total algorithm count increased from 360 to 384
+- README updated with education section
+
+
+
+### Planned
+- Additional algorithms for sustainability and green supply chain
+- Performance optimizations for large datasets
+- Integration with popular data formats
+
+## [1.0.0] - 2026-12-15
+
+### Added
+- Comprehensive test suite with 200+ unit tests using unittest framework
+- Property-based tests for mathematical invariants
+- Edge case tests for boundary conditions
+- Integration tests for end-to-end workflows
+- Doctest runner for docstring examples
+- Benchmark script for performance measurement
+- Type hints validation script
+- Contributing guide for new contributors
+- Code of Conduct based on Contributor Covenant
+- Security policy for vulnerability reporting
+- Frequently Asked Questions (FAQ) document
+- API reference documentation
+- Migration guide for version updates
+- Usage tutorials for inventory, forecasting, routing, optimization, and supplier selection
+- GitHub Actions Continuous Integration (CI) for Python 3.8-3.12
+- Issue templates for bug reports and feature requests
+- Pull Request (PR) template
+- Python version compatibility matrix in README
+- Badges for Python version, license, test status, and dependencies
+
+### Changed
+- README updated with quick start guide and badges
+- All algorithm modules follow consistent style guide
+- Documentation reorganized into docs/ directory
+
+### Fixed
+- Repository URL corrected to point to atqatq/supplycm
+
+## [0.1.0] - 2025-12-15
+
+### Added
+- 360 supply chain management algorithms across 12 categories:
+  - Forecasting (50 algorithms)
+  - Inventory (60 algorithms)
+  - Statistics (40 algorithms)
+  - Routing (30 algorithms)
+  - Network (30 algorithms)
+  - Scheduling (40 algorithms)
+  - Material Requirements Planning (MRP) (30 algorithms)
+  - Optimization (30 algorithms)
+  - Supplier Management (30 algorithms)
+  - Warehouse (10 algorithms)
+  - Demand Planning (9 algorithms)
+  - Risk Assessment (1 algorithm)
+- Pure Python implementation with zero external dependencies
+- MIT License
+- Setup scripts for pip installation
+
+### Notes
+- Algorithms span classic operations research methods and modern heuristics
+- Each algorithm is self-contained in its own module
+- All functions include docstrings with usage examples

supplycm-1.2.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,39 @@
+# Code of Conduct
+
+## Our Pledge
+
+We pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the repository maintainers. All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.0.

supplycm-1.2.1/COMMUNITY.md

@@ -0,0 +1,70 @@
+# supplycm Community
+
+Welcome to the supplycm community! This file outlines our community standards and resources.
+
+## Health Files
+
+| File | Purpose |
+|------|---------|
+| [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute |
+| [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) | Community behavior standards |
+| [SECURITY.md](SECURITY.md) | Security policy |
+| [CHANGELOG.md](CHANGELOG.md) | Version history |
+| [docs/COLLABORATION.md](docs/COLLABORATION.md) | Collaboration guide |
+| [docs/FAQ.md](docs/FAQ.md) | Frequently asked questions |
+
+## Issue Templates
+
+When you create a new issue, you can choose from:
+- **Bug report** - Report something that is broken
+- **Feature request** - Suggest a new algorithm or improvement
+
+## Pull Request Template
+
+All Pull Requests (PRs) should use the provided template, which includes a checklist
+for code quality, tests, and documentation.
+
+## Labels
+
+We use the following labels to organize work:
+
+### Type Labels
+- `bug` - Something is not working
+- `enhancement` - New feature or improvement
+- `documentation` - Documentation changes
+
+### Difficulty Labels
+- `good first issue` - Good for newcomers
+- `help wanted` - Extra attention needed
+
+### Priority Labels
+- `priority: high` - Should be addressed soon
+- `priority: medium` - Normal priority
+- `priority: low` - Can wait
+
+## How to Get Involved
+
+1. **Star the repository** if you find it useful
+2. **Report bugs** you encounter
+3. **Suggest features** you need
+4. **Contribute code** via Pull Requests
+5. **Help others** in issue discussions
+6. **Improve documentation** with clearer explanations
+
+## Communication
+
+- **GitHub Issues** - For bugs, features, and questions
+- **GitHub Discussions** - For general discussion and ideas
+- **Pull Request comments** - For code-specific discussions
+
+## Contributor Recognition
+
+All contributors are listed in the git history. We are working on:
+- A contributors section in the README
+- Automated contributor highlights in release notes
+- A "Contributor of the Month" program (coming soon)
+
+## Code of Conduct
+
+Everyone participating in the supplycm community is expected to follow
+our [Code of Conduct](CODE_OF_CONDUCT.md). Please be respectful and welcoming.

supplycm-1.2.1/CONTRIBUTING.md

@@ -0,0 +1,81 @@
+# Contributing to supplycm
+
+Thank you for your interest in contributing to supplycm. This document explains how to contribute.
+
+## Ways to Contribute
+
+1. **Report bugs** - Open an issue describing the problem with a minimal example.
+2. **Suggest features** - Open an issue describing the use case and proposed solution.
+3. **Improve documentation** - Fix typos, add examples, clarify explanations.
+4. **Add algorithms** - Implement new supply chain algorithms following the style guide below.
+5. **Write tests** - Add or improve test coverage for existing algorithms.
+
+## Style Guide
+
+### Algorithm Module Structure
+
+Each algorithm lives in its own file under the appropriate category directory:
+
+```
+supplycm/
+  inventory/
+    economic_order_quantity.py
+```
+
+### File Template
+
+```python
+"""Short one-line description."""
+from typing import List, Optional
+
+
+def algorithm_name(param1: float, param2: int = 3) -> float:
+    """One-line summary.
+
+    Longer description explaining the formula or logic.
+
+    Args:
+        param1: Description of param1.
+        param2: Description of param2.
+
+    Returns:
+        Description of return value.
+
+    Example:
+        >>> algorithm_name(100, 5)
+        42.0
+    """
+    if param1 <= 0:
+        raise ValueError("param1 must be positive")
+    return param1 * 0.42
+```
+
+### Rules
+
+1. **No external dependencies** - only the Python standard library.
+2. **Type hints** - all function parameters and return types must have type hints.
+3. **Docstrings** - every public function must have a docstring with at least one example.
+4. **Pure functions** - algorithms should not have side effects.
+5. **Error handling** - validate inputs and raise ValueError for invalid parameters.
+
+## Development Workflow
+
+1. Fork the repository.
+2. Create a feature branch: `git checkout -b add-new-algorithm`.
+3. Write your code following the style guide.
+4. Add tests in `tests/test_<category>.py`.
+5. Run tests: `python tests/run_tests.py`.
+6. Commit with a clear message: `Add <algorithm_name> to <category> module`.
+7. Open a Pull Request (PR).
+
+## Pull Request Checklist
+
+- [ ] Code follows the style guide
+- [ ] Tests pass locally
+- [ ] Docstring includes at least one example
+- [ ] No external dependencies added
+- [ ] Commit message is clear and descriptive
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

supplycm-1.2.1/LICENSE

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

supplycm-1.2.1/MANIFEST.in

@@ -0,0 +1,13 @@
+# MANIFEST.in for supplycm
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include CODE_OF_CONDUCT.md
+include SECURITY.md
+include COMMUNITY.md
+include pyproject.toml
+recursive-include examples *.py
+recursive-exclude tests *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[cod]

supplycm-1.2.1/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: supplycm
+Version: 1.2.1
+Summary: Supply Chain Management algorithms (397 pure-Python, no dependencies)
+Home-page: https://github.com/atqatq/supplycm
+Author: Atique
+Author-email: Atique <11529740+atqatq@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/atqatq/supplycm
+Project-URL: Documentation, https://github.com/atqatq/supplycm/tree/main/docs
+Project-URL: Issues, https://github.com/atqatq/supplycm/issues
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# supplycm
+
+[![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-passing-green.svg)](tests/)
+[![No Dependencies](https://img.shields.io/badge/dependencies-zero-lightgrey.svg)](setup.py)
+
+A pure-Python library of **397 supply chain management algorithms** with **zero external dependencies**. All algorithms are public-domain / patent-free implementations suitable for educational and commercial use.
+
+## Quick Start
+
+```bash
+pip install supplycm
+```
+
+```python
+from supplycm.inventory import economic_order_quantity
+
+# Compute optimal order quantity
+q = economic_order_quantity(demand=10000, ordering_cost=100, holding_cost=5)
+print(f'Order {q:.0f} units each cycle')
+```
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install supplycm
+```
+
+### From source
+
+```bash
+git clone https://github.com/atqatq/supplycm.git
+cd supplycm
+pip install .
+```
+
+**Note**: Python 3.6 or later is required. Check your version with `python --version`.
+
+## Categories
+
+| Module | Count | Description |
+|--------|-------|-------------|
+| `supplycm.forecasting` | 50 | Time series forecasting (moving averages, exponential smoothing, Croston, AR/MA) |
+| `supplycm.inventory` | 60 | EOQ/EPQ, newsvendor, lot-sizing, ABC/XYZ analysis |
+| `supplycm.statistics` | 40 | MAPE, RMSE, MASE, hypothesis tests, descriptive stats |
+| `supplycm.routing` | 30 | TSP, VRP, assignment problem, transportation simplex |
+| `supplycm.network` | 30 | Shortest paths, MST, max-flow, graph algorithms |
+| `supplycm.scheduling` | 40 | Johnson's rule, NEH, dispatching rules, CPM/PERT |
+| `supplycm.mrp` | 30 | BOM explosion, MRP, MPS, kanban, DBR |
+| `supplycm.optimization` | 30 | Simplex, GA, SA, PSO, ACO, knapsack, DP |
+| `supplycm.supplier` | 30 | AHP, TOPSIS, DEA, PROMETHEE, ELECTRE |
+| `supplycm.warehouse` | 10 | Slotting, picking, cross-dock, putaway |
+| `supplycm.demand` | 9 | Aggregation, seasonality, sensing, cannibalization |
+| `supplycm.risk` | 1 | Supply chain resilience index |
+| `supplycm.quality` | 7 | Control charts, Cp/Cpk, DPMO, sigma level |
+| `supplycm.lean` | 4 | Takt time, OEE, Little's Law, cycle efficiency |
+| `supplycm.sop` | 3 | Sales and Operations Planning, chase/level strategies |
+| `supplycm.sustainability` | 3 | Carbon footprint, reverse logistics, energy |
+| `supplycm.contracts` | 3 | Revenue sharing, buyback, quantity flexibility |
+| `supplycm.simulation` | 2 | Monte Carlo inventory and risk simulation |
+| `supplycm.cost` | 2 | Landed cost, total procurement cost |
+| `supplycm.network_design` | 5 | Center of gravity, facility location, break-even |
+| `supplycm.iot` | 4 | Anomaly detection, sensor smoothing, real-time monitoring |
+| `supplycm.blockchain` | 4 | Hash chain, provenance tracking, smart contracts |
+| **Total** | **397** | |
+
+## Python Version Compatibility
+
+| Python | Status |
+|--------|--------|
+| 3.6 | Supported |
+| 3.7 | Supported |
+| 3.8 | Tested |
+| 3.9 | Tested |
+| 3.10 | Tested |
+| 3.11 | Tested |
+| 3.12 | Tested |
+| 3.13 | Tested |
+
+## Running Tests
+
+```bash
+# Run all unit tests
+python tests/run_tests.py
+
+# Run doctests
+python tests/run_doctests.py
+```
+
+## Design Principles
+
+1. **Pure Python** - no NumPy, pandas, or any third-party dependency. Only the standard library.
+2. **Self-contained** - each algorithm lives in its own module and can be imported independently.
+3. **Documented** - every function has a docstring with usage examples.
+4. **Tested** - comprehensive test suite using Python's built-in unittest framework.
+5. **Consistent** - all modules follow the same style and structure.
+
+## Community
+
+- **[Discussions](https://github.com/atqatq/supplycm/discussions)** - Ask questions, share ideas, show your projects
+- **[Issues](https://github.com/atqatq/supplycm/issues)** - Report bugs or request features
+- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute code, documentation, or algorithms
+
+## Learning the Package
+
+Tutorials, learning paths, and interactive notebooks are available in the companion repository:
+**[atqatq/supplycm-learning](https://github.com/atqatq/supplycm-learning)**
+
+## License
+
+MIT - see [LICENSE](LICENSE).

supplycm-1.2.1/README.md

@@ -0,0 +1,114 @@
+# supplycm
+
+[![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-passing-green.svg)](tests/)
+[![No Dependencies](https://img.shields.io/badge/dependencies-zero-lightgrey.svg)](setup.py)
+
+A pure-Python library of **397 supply chain management algorithms** with **zero external dependencies**. All algorithms are public-domain / patent-free implementations suitable for educational and commercial use.
+
+## Quick Start
+
+```bash
+pip install supplycm
+```
+
+```python
+from supplycm.inventory import economic_order_quantity
+
+# Compute optimal order quantity
+q = economic_order_quantity(demand=10000, ordering_cost=100, holding_cost=5)
+print(f'Order {q:.0f} units each cycle')
+```
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install supplycm
+```
+
+### From source
+
+```bash
+git clone https://github.com/atqatq/supplycm.git
+cd supplycm
+pip install .
+```
+
+**Note**: Python 3.6 or later is required. Check your version with `python --version`.
+
+## Categories
+
+| Module | Count | Description |
+|--------|-------|-------------|
+| `supplycm.forecasting` | 50 | Time series forecasting (moving averages, exponential smoothing, Croston, AR/MA) |
+| `supplycm.inventory` | 60 | EOQ/EPQ, newsvendor, lot-sizing, ABC/XYZ analysis |
+| `supplycm.statistics` | 40 | MAPE, RMSE, MASE, hypothesis tests, descriptive stats |
+| `supplycm.routing` | 30 | TSP, VRP, assignment problem, transportation simplex |
+| `supplycm.network` | 30 | Shortest paths, MST, max-flow, graph algorithms |
+| `supplycm.scheduling` | 40 | Johnson's rule, NEH, dispatching rules, CPM/PERT |
+| `supplycm.mrp` | 30 | BOM explosion, MRP, MPS, kanban, DBR |
+| `supplycm.optimization` | 30 | Simplex, GA, SA, PSO, ACO, knapsack, DP |
+| `supplycm.supplier` | 30 | AHP, TOPSIS, DEA, PROMETHEE, ELECTRE |
+| `supplycm.warehouse` | 10 | Slotting, picking, cross-dock, putaway |
+| `supplycm.demand` | 9 | Aggregation, seasonality, sensing, cannibalization |
+| `supplycm.risk` | 1 | Supply chain resilience index |
+| `supplycm.quality` | 7 | Control charts, Cp/Cpk, DPMO, sigma level |
+| `supplycm.lean` | 4 | Takt time, OEE, Little's Law, cycle efficiency |
+| `supplycm.sop` | 3 | Sales and Operations Planning, chase/level strategies |
+| `supplycm.sustainability` | 3 | Carbon footprint, reverse logistics, energy |
+| `supplycm.contracts` | 3 | Revenue sharing, buyback, quantity flexibility |
+| `supplycm.simulation` | 2 | Monte Carlo inventory and risk simulation |
+| `supplycm.cost` | 2 | Landed cost, total procurement cost |
+| `supplycm.network_design` | 5 | Center of gravity, facility location, break-even |
+| `supplycm.iot` | 4 | Anomaly detection, sensor smoothing, real-time monitoring |
+| `supplycm.blockchain` | 4 | Hash chain, provenance tracking, smart contracts |
+| **Total** | **397** | |
+
+## Python Version Compatibility
+
+| Python | Status |
+|--------|--------|
+| 3.6 | Supported |
+| 3.7 | Supported |
+| 3.8 | Tested |
+| 3.9 | Tested |
+| 3.10 | Tested |
+| 3.11 | Tested |
+| 3.12 | Tested |
+| 3.13 | Tested |
+
+## Running Tests
+
+```bash
+# Run all unit tests
+python tests/run_tests.py
+
+# Run doctests
+python tests/run_doctests.py
+```
+
+## Design Principles
+
+1. **Pure Python** - no NumPy, pandas, or any third-party dependency. Only the standard library.
+2. **Self-contained** - each algorithm lives in its own module and can be imported independently.
+3. **Documented** - every function has a docstring with usage examples.
+4. **Tested** - comprehensive test suite using Python's built-in unittest framework.
+5. **Consistent** - all modules follow the same style and structure.
+
+## Community
+
+- **[Discussions](https://github.com/atqatq/supplycm/discussions)** - Ask questions, share ideas, show your projects
+- **[Issues](https://github.com/atqatq/supplycm/issues)** - Report bugs or request features
+- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute code, documentation, or algorithms
+
+## Learning the Package
+
+Tutorials, learning paths, and interactive notebooks are available in the companion repository:
+**[atqatq/supplycm-learning](https://github.com/atqatq/supplycm-learning)**
+
+## License
+
+MIT - see [LICENSE](LICENSE).

supplycm-1.2.1/SECURITY.md

@@ -0,0 +1,34 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in supplycm, please report it responsibly.
+
+### How to Report
+
+1. **Do not** open a public GitHub issue.
+2. Email the maintainer directly with details of the vulnerability.
+3. Include a description of the issue, steps to reproduce, and potential impact.
+
+### Response Timeline
+
+- **Acknowledgment**: Within 48 hours of receiving your report.
+- **Initial Assessment**: Within 7 days.
+- **Fix Release**: Within 30 days for critical issues, 90 days for others.
+
+## Security Considerations
+
+supplycm is a pure-Python library with no external dependencies. However:
+
+1. **Input validation**: Most algorithms validate inputs, but always sanitize data from untrusted sources before passing it to library functions.
+2. **Numerical stability**: Some algorithms may produce unexpected results with extreme or NaN inputs. Always validate output ranges.
+3. **No network access**: The library does not make any network calls, reducing attack surface.
+
+## Supported Versions
+
+Only the latest release receives security updates.
+
+| Version | Supported          |
+|---------|--------------------|
+| 0.1.x   | Yes                |
+| < 0.1   | No                 |

supplycm-1.2.1/examples/__init__.py

@@ -0,0 +1 @@
+"""supplycm usage examples."""