solverforge 0.3.0__tar.gz → 0.4.0__tar.gz

solverforge-0.4.0/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.14"
+  RUST_VERSION: "1.95.0"
+
+jobs:
+  ci-local:
+    name: local CI gate
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout solverforge-py
+        uses: actions/checkout@v6
+        with:
+          path: solverforge-py
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.RUST_VERSION }}
+          components: rustfmt, clippy
+
+      - name: Validate SolverForge release base
+        working-directory: solverforge-py
+        run: make release-base-check
+
+      - name: Run local CI
+        working-directory: solverforge-py
+        run: make ci-local
+
+      - name: Build and verify local distributions
+        working-directory: solverforge-py
+        run: make build-dist dist-check smoke-wheel

solverforge-0.4.0/.github/workflows/release.yml

@@ -0,0 +1,205 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      repository:
+        description: Publish target
+        required: true
+        default: testpypi
+        type: choice
+        options:
+          - testpypi
+          - pypi
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.14"
+  RUST_VERSION: "1.95.0"
+
+jobs:
+  sdist:
+    name: source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout solverforge-py
+        uses: actions/checkout@v6
+        with:
+          path: solverforge-py
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.RUST_VERSION }}
+          components: rustfmt, clippy
+
+      - name: Build sdist
+        working-directory: solverforge-py
+        run: make build-sdist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v7
+        with:
+          name: sdist
+          path: solverforge-py/dist/*.tar.gz
+
+  wheels:
+    name: wheel ${{ matrix.os }} ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+            manylinux: "2014"
+            interpreter: python3.14
+          - os: macos-14
+            target: aarch64
+            manylinux: ""
+            interpreter: python3.14
+          - os: windows-latest
+            target: x64
+            manylinux: ""
+            interpreter: python
+    steps:
+      - name: Checkout solverforge-py
+        uses: actions/checkout@v6
+        with:
+          path: solverforge-py
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --locked --strip --compatibility pypi -i ${{ matrix.interpreter }} --out dist
+          manylinux: ${{ matrix.manylinux }}
+          target: ${{ matrix.target }}
+          rust-toolchain: ${{ env.RUST_VERSION }}
+          working-directory: solverforge-py
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
+          path: solverforge-py/dist/*.whl
+
+  verify:
+    name: verify artifacts
+    runs-on: ubuntu-latest
+    needs: [sdist, wheels]
+    steps:
+      - name: Checkout solverforge-py
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v8
+        with:
+          path: artifact-download
+
+      - name: Collect distributions
+        run: |
+          mkdir dist
+          find artifact-download -type f \( -name '*.whl' -o -name '*.tar.gz' \) -exec cp '{}' dist/ \;
+
+      - name: Install release tools
+        run: python -m pip install --disable-pip-version-check twine
+
+      - name: Check metadata
+        run: |
+          python -m twine check dist/*
+          python scripts/verify_release_artifacts.py --dist dist
+
+      - name: Upload verified distributions
+        uses: actions/upload-artifact@v7
+        with:
+          name: release-dist
+          path: dist/*
+
+  publish-testpypi:
+    name: publish to TestPyPI
+    runs-on: ubuntu-latest
+    needs: verify
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.repository == 'testpypi'
+    environment: testpypi
+    permissions:
+      contents: read
+    steps:
+      - name: Download verified distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: release-dist
+          path: dist
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+
+  publish-pypi:
+    name: publish to PyPI
+    runs-on: ubuntu-latest
+    needs: verify
+    if: >-
+      (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')) ||
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.repository == 'pypi')
+    environment: pypi
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout solverforge-py
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Validate tag version
+        run: |
+          python - <<'PY'
+          import os
+          import tomllib
+
+          with open("pyproject.toml", "rb") as handle:
+              version = tomllib.load(handle)["project"]["version"]
+
+          expected = f"v{version}"
+          actual = os.environ["GITHUB_REF_NAME"]
+          if os.environ["GITHUB_EVENT_NAME"] == "workflow_dispatch":
+              raise SystemExit(0)
+          if actual != expected:
+              raise SystemExit(f"tag {actual} does not match package version {expected}")
+          PY
+
+      - name: Download verified distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: release-dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

solverforge-0.4.0/.gitignore

@@ -0,0 +1,11 @@
+/target/
+/.venv/
+/.mypy_cache/
+/.pytest_cache/
+/.ruff_cache/
+/dist/
+/wheelhouse/
+*.egg-info/
+__pycache__/
+*.py[cod]
+python/solverforge/_native*.so

solverforge-0.4.0/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+    -   id: check-yaml
+    -   id: end-of-file-fixer
+    -   id: trailing-whitespace
+    -   id: check-merge-conflict
+    -   id: check-added-large-files
+
+-   repo: https://github.com/gitleaks/gitleaks
+    rev: v8.18.0
+    hooks:
+    -   id: gitleaks
+-   repo: https://github.com/psf/black
+    rev: 26.5.1
+    hooks:
+    -   id: black
+
+-   repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.14
+    hooks:
+    -   id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+-   repo: https://github.com/doublify/pre-commit-rust
+    rev: v1.0
+    hooks:
+    -   id: fmt
+        args: ["--", "--check"]
+    -   id: clippy
+        args: ["--", "-D", "warnings"]

solverforge-0.4.0/.python-version

@@ -0,0 +1 @@
+3.14t

solverforge-0.4.0/AGENTS.md

@@ -0,0 +1,62 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+`solverforge-py` is a mixed Python/Rust binding package built with PyO3 and
+maturin. Python package code lives under `python/solverforge/`; the native
+extension, dynamic runtime bridge, callbacks, manager, and schema code live under
+`src/`. Python tests are in `tests/python/`, Rust tests are in `tests/rust/`, and
+examples are in `examples/`. The hospital demo owns its FastAPI app, static UI,
+generated UI model, and seed data under `examples/solverforge_hospital/`.
+`WIREFRAME.md` is the as-built API/UI map; `docs/` contains bridge and callback
+contracts.
+
+## Build, Test, and Development Commands
+
+- `make develop`: create `.venv`, install tools, and install the release native extension.
+- `make test`: run `cargo test --locked` plus pytest.
+- `make test-quick`: run fast Python regressions without the hospital app tests.
+- `make test-hospital`: run the hospital model and FastAPI/frontend lifecycle tests.
+- `make lint`: run rustfmt check, ruff, strict mypy, and clippy with warnings denied.
+- `make docs-check`: verify the README, AGENTS, and WIREFRAME surface exists and avoids known stale claims.
+- `make ci-local` or `make audit`: run the local CI simulation.
+- `make pre-release`: run `ci-local` and build the release wheel.
+- `make hospital-run`: serve the hospital app on `APP_HOST=127.0.0.1 PORT=7860`.
+
+Use Rust `1.95.0` from `rust-toolchain.toml`. Python code targets Python `3.14`.
+
+## Coding Style & Naming Conventions
+
+Python uses Ruff linting, strict mypy, and the 100-character line limit from
+`pyproject.toml`; `make py-format` is available for an intentional Black pass.
+Prefer typed public APIs and keep exports in `python/solverforge/__init__.py`
+intentional. Use snake_case for Python modules, functions, and variables; use
+PascalCase for classes. Rust follows rustfmt and clippy with `-D warnings`; keep
+module names snake_case and public types descriptive.
+
+## Testing Guidelines
+
+Add Python regression tests as `tests/python/test_*.py`. Add Rust integration or
+unit coverage under `tests/rust/` or the relevant `src/` module. For binding
+changes, prefer tests that prove Python behavior through the public `solverforge`
+API, then add Rust tests only where native runtime behavior is directly changed.
+Run the narrow suite first, then `make ci-local` for cross-language or
+integration changes. Binding changes should normally prove behavior through the
+public Python API and add Rust coverage only when native runtime behavior changes
+directly.
+
+## Commit & Pull Request Guidelines
+
+This checkout has no committed history yet, so no project-specific convention can
+be inferred from Git. Use concise Conventional Commit-style subjects such as
+`fix(runtime): preserve scalar snapshots` or `test(manager): cover retained jobs`.
+Pull requests should include the motivation, user-visible behavior, tests run,
+and any linked issue. Include screenshots or short recordings for changes under
+`examples/solverforge_hospital/static/`.
+
+## Agent-Specific Instructions
+
+Keep changes scoped to the requested surface. Do not rewrite runtime, callback,
+manager, or API payload paths for a simple documentation, UI, naming, or wiring
+task unless live evidence proves that path is the failing layer. Verify assumptions
+from the repo before changing critical integration code.