hvbattle 0.1.0__tar.gz

hvbattle-0.1.0/.Codex/hooks/finalize-markdown.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -eu
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+exec "$repo_root/scripts/hooks/finalize-markdown.sh"

hvbattle-0.1.0/.Codex/hooks/finalize-python.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -eu
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+exec "$repo_root/scripts/hooks/finalize-python.sh"

hvbattle-0.1.0/.claude/settings.local.json

@@ -0,0 +1,46 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(**/*)",
+      "Write(**/*)",
+      "Edit(**/*)",
+      "Bash(docker:*)",
+      "Bash(ls:*)",
+      "Bash(mkdir:*)",
+      "Bash(tree:*)",
+      "Bash(find:*)",
+      "Bash(uv:*)",
+      "Bash(grep:*)",
+      "Bash(xargs cat)",
+      "Bash(git diff:*)",
+      "Bash(git -C * diff:*)",
+      "Bash(cat > *)",
+      "Bash(git add *)",
+      "Bash(git commit -m ' *)",
+      "Bash(uv run *)",
+      "Bash(uv run python -c ' *)",
+      "Bash(python3 -)",
+      "Bash(python3 -c ' *)",
+      "Bash(echo \"exit: $?\")"
+    ],
+    "additionalDirectories": [
+      "/tmp"
+    ]
+  },
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "scripts/hooks/finalize-python.sh"
+          },
+          {
+            "type": "command",
+            "command": "scripts/hooks/finalize-markdown.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

hvbattle-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,63 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [main]
+    paths: [pyproject.toml]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install version checker
+        run: python -m pip install packaging
+
+      - name: Check version bump
+        id: version
+        run: |
+          CURRENT=$(python -c "
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              print(tomllib.load(f)['project']['version'])
+          ")
+          if git cat-file -e HEAD~1:pyproject.toml 2>/dev/null; then
+            PREVIOUS=$(git show HEAD~1:pyproject.toml | python -c "
+          import tomllib, sys
+          print(tomllib.load(sys.stdin.buffer)['project']['version'])
+            ")
+          else
+            PREVIOUS=""
+          fi
+          echo "current=$CURRENT" >> "$GITHUB_OUTPUT"
+          echo "previous=$PREVIOUS" >> "$GITHUB_OUTPUT"
+          if [ -z "$PREVIOUS" ]; then
+            echo "bumped=true" >> "$GITHUB_OUTPUT"
+          elif [ "$CURRENT" != "$PREVIOUS" ]; then
+            python -c "
+          from packaging.version import Version
+          current, previous = Version('$CURRENT'), Version('$PREVIOUS')
+          exit(0 if current > previous else 1)
+          "
+            echo "bumped=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "bumped=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Build
+        if: steps.version.outputs.bumped == 'true'
+        run: pip install build && python -m build
+
+      - name: Publish
+        if: steps.version.outputs.bumped == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1

hvbattle-0.1.0/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "ms-python.python",
+    "charliermarsh.ruff",
+    "ms-python.black-formatter",
+    "ms-python.mypy-type-checker",
+    "DavidAnson.vscode-markdownlint"
+  ]
+}

hvbattle-0.1.0/.vscode/settings.json

@@ -0,0 +1,28 @@
+{
+  "python.analysis.typeCheckingMode": "off",
+  "python.analysis.diagnosticSeverityOverrides": {
+    "reportMissingModuleSource": "none",
+    "reportMissingImports": "none"
+  },
+  "editor.formatOnSave": true,
+  "[python]": {
+    "editor.defaultFormatter": "ms-python.black-formatter",
+    "editor.codeActionsOnSave": {
+      "source.fixAll.ruff": "always"
+    }
+  },
+  "black-formatter.importStrategy": "fromEnvironment",
+  "ruff.importStrategy": "fromEnvironment",
+  "[markdown]": {
+    "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
+  },
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+  "editor.rulers": [
+    88
+  ],
+  "mypy-type-checker.importStrategy": "fromEnvironment",
+  "mypy-type-checker.args": [
+    "--config-file=mypy.ini"
+  ]
+}

hvbattle-0.1.0/AGENTS.md

@@ -0,0 +1,14 @@
+# Agent Instructions
+
+The repository keeps provider-neutral finalization scripts in `scripts/hooks/`.
+Do not create separate copies under an individual agent's configuration
+directory.
+
+- Before development, create a clean environment with
+  `bash scripts/rebuild-env.sh`.
+- After changing Python, run `bash scripts/hooks/finalize-python.sh`.
+- After changing Markdown, run `bash scripts/hooks/finalize-markdown.sh`.
+- Keep the committed dependency source for `hvbrowser` on PyPI. Install local
+  editable checkouts manually, in dependency order, only after rebuilding the
+  environment.
+- Automated tests must remain offline and must never start or flee a battle.

hvbattle-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: hvbattle
+Version: 0.1.0
+Summary: Reusable battle-domain APIs for HentaiVerse.
+Project-URL: Homepage, https://github.com/Kuan-Lun/hvbattle
+Project-URL: Tracker, https://github.com/Kuan-Lun/hvbattle/issues
+Author: Kuan-Lun Wang
+License: GNU Affero General Public License v3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <3.15,>=3.14
+Requires-Dist: hv-bie>=0.7.0
+Requires-Dist: hvbrowser<0.2,>=0.1.0
+Requires-Dist: ponychart-classifier>=0.7.0
+Requires-Dist: zendriver<0.16,>=0.15.5
+Provides-Extra: dev
+Requires-Dist: black>=26.5.1; extra == 'dev'
+Requires-Dist: mypy>=2.1.0; extra == 'dev'
+Requires-Dist: pymarkdownlnt>=0.9.38; extra == 'dev'
+Requires-Dist: pytest>=9.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.15.20; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# HVBattle
+
+HVBattle provides reusable HentaiVerse battle-domain APIs. It builds on
+`hvbrowser` for the authenticated Hentaiverse browser session and keeps the
+private command-line runner in a separate application workspace.
+
+The first release preserves the historical `BattleDriver` API while adding a
+safe `run_current()` boundary. That method only runs an already active battle;
+it never repairs equipment, recovers stamina, or starts Arena/GrindFest.
+Automatic next-battle toggles default to off and require explicit opt-in.
+`BattleDriver` preloads the PonyChart classifier and ONNX model before opening
+the browser, so a timed challenge never pays the first-load cost.
+
+```python
+import asyncio
+
+from hvbattle import BattleDriver
+
+
+async def main() -> None:
+    async with BattleDriver(headless=True) as driver:
+        await driver.run_current()
+
+
+asyncio.run(main())
+```
+
+The legacy `battle()` loop remains available for the private runner. It can
+repair equipment and recover stamina; starting another Arena or GrindFest also
+requires explicitly enabling the corresponding auto-next option.
+
+## Development
+
+Build a clean environment backed by PyPI releases:
+
+```bash
+bash scripts/rebuild-env.sh
+```
+
+For coordinated local development before all dependent releases are on PyPI,
+overlay editable checkouts in dependency order:
+
+```bash
+uv pip install --python .venv/bin/python --reinstall --no-deps --editable \
+  /Users/kuanlun_wang/Desktop/git-repo/hbrowser.clone
+uv pip install --python .venv/bin/python --reinstall --no-deps --editable \
+  /Users/kuanlun_wang/Desktop/git-repo/hvbrowser.clone
+```
+
+Commands that must preserve these editable overlays use `uv run --no-sync`.

hvbattle-0.1.0/README.md

@@ -0,0 +1,50 @@
+# HVBattle
+
+HVBattle provides reusable HentaiVerse battle-domain APIs. It builds on
+`hvbrowser` for the authenticated Hentaiverse browser session and keeps the
+private command-line runner in a separate application workspace.
+
+The first release preserves the historical `BattleDriver` API while adding a
+safe `run_current()` boundary. That method only runs an already active battle;
+it never repairs equipment, recovers stamina, or starts Arena/GrindFest.
+Automatic next-battle toggles default to off and require explicit opt-in.
+`BattleDriver` preloads the PonyChart classifier and ONNX model before opening
+the browser, so a timed challenge never pays the first-load cost.
+
+```python
+import asyncio
+
+from hvbattle import BattleDriver
+
+
+async def main() -> None:
+    async with BattleDriver(headless=True) as driver:
+        await driver.run_current()
+
+
+asyncio.run(main())
+```
+
+The legacy `battle()` loop remains available for the private runner. It can
+repair equipment and recover stamina; starting another Arena or GrindFest also
+requires explicitly enabling the corresponding auto-next option.
+
+## Development
+
+Build a clean environment backed by PyPI releases:
+
+```bash
+bash scripts/rebuild-env.sh
+```
+
+For coordinated local development before all dependent releases are on PyPI,
+overlay editable checkouts in dependency order:
+
+```bash
+uv pip install --python .venv/bin/python --reinstall --no-deps --editable \
+  /Users/kuanlun_wang/Desktop/git-repo/hbrowser.clone
+uv pip install --python .venv/bin/python --reinstall --no-deps --editable \
+  /Users/kuanlun_wang/Desktop/git-repo/hvbrowser.clone
+```
+
+Commands that must preserve these editable overlays use `uv run --no-sync`.

hvbattle-0.1.0/mypy.ini

@@ -0,0 +1,28 @@
+[mypy]
+python_version = 3.14
+warn_unused_configs = True
+disallow_untyped_defs = True
+check_untyped_defs = True
+warn_redundant_casts = True
+warn_unused_ignores = True
+no_implicit_optional = True
+strict_equality = True
+warn_return_any = True
+disallow_any_generics = True
+disallow_subclassing_any = True
+disallow_untyped_calls = True
+disallow_incomplete_defs = True
+disallow_untyped_decorators = True
+no_implicit_reexport = True
+
+[mypy-zendriver.*]
+ignore_missing_imports = True
+
+[mypy-hv_bie.*]
+ignore_missing_imports = True
+
+[mypy-ponychart_classifier.*]
+ignore_missing_imports = True
+
+[mypy-hvbattle.hv_battle_observer_pattern]
+disable_error_code = override

hvbattle-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hvbattle"
+version = "0.1.0"
+description = "Reusable battle-domain APIs for HentaiVerse."
+readme = "README.md"
+authors = [{ name = "Kuan-Lun Wang" }]
+license = { text = "GNU Affero General Public License v3" }
+requires-python = ">=3.14,<3.15"
+dependencies = [
+    "hvbrowser>=0.1.0,<0.2",
+    "hv-bie>=0.7.0",
+    "ponychart-classifier>=0.7.0",
+    "zendriver>=0.15.5,<0.16",
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
+    "Programming Language :: Python :: 3.14",
+]
+
+[project.optional-dependencies]
+dev = [
+    "black>=26.5.1",
+    "ruff>=0.15.20",
+    "mypy>=2.1.0",
+    "pymarkdownlnt>=0.9.38",
+    "pytest>=9.1.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/Kuan-Lun/hvbattle"
+Tracker = "https://github.com/Kuan-Lun/hvbattle/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hvbattle"]
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+extend-ignore = ["E203", "E226", "E501"]

hvbattle-0.1.0/scripts/hooks/finalize-markdown.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Shared finalizer for Markdown changes.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+cd "$REPO_ROOT"
+
+MD_FILES=()
+while IFS= read -r file; do
+    MD_FILES+=("$file")
+done < <(
+    find . -maxdepth 2 -type f -name "*.md" \
+        -not -path "./.venv/*" \
+        -not -path "./node_modules/*" \
+        -not -path "./.pytest_cache/*" \
+        -not -path "./.*" \
+        | sort
+)
+
+if [ ${#MD_FILES[@]} -eq 0 ]; then
+    exit 0
+fi
+
+uv run --no-sync pymarkdown fix "${MD_FILES[@]}" >/dev/null 2>&1 || true
+
+if ! uv run --no-sync ruff format --preview "${MD_FILES[@]}" >&2; then
+    exit 2
+fi

hvbattle-0.1.0/scripts/hooks/finalize-python.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Shared finalizer for Python changes. `--no-sync` preserves manually
+# installed editable dependency checkouts in the project environment.
+
+set -eu
+trap 'exit 2' ERR
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+cd "$REPO_ROOT"
+
+FORMAT_PATHS=(src/hvbattle tests)
+TYPE_PATHS=(src/hvbattle)
+
+uv run --no-sync black "${FORMAT_PATHS[@]}" >&2
+uv run --no-sync ruff check --fix "${FORMAT_PATHS[@]}" >&2
+uv run --no-sync black "${FORMAT_PATHS[@]}" >&2
+uv run --no-sync mypy "${TYPE_PATHS[@]}" >&2

hvbattle-0.1.0/scripts/rebuild-env.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Rebuild a clean development environment whose hvbrowser dependency comes
+# from PyPI. Install local editable dependencies manually afterwards when
+# cross-repository development is required.
+
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+rm -rf .venv .mypy_cache .ruff_cache .pytest_cache
+find . -type d -name __pycache__ -exec rm -rf {} +
+uv cache clean --force
+uv venv --python 3.14
+uv pip install -e ".[dev]"

hvbattle-0.1.0/src/hvbattle/__init__.py

@@ -0,0 +1,20 @@
+"""Public battle-domain API."""
+
+from hvbrowser.runtime import notify
+
+from .hv_battle import BattleDriver
+from .hv_battle_defaults import (
+    DEFAULT_FORBIDDEN_SKILLS,
+    DEFAULT_STATTHRESHOLD,
+    StatThreshold,
+)
+from .hv_battle_ponychart import preload_ponychart_classifier
+
+__all__ = [
+    "BattleDriver",
+    "DEFAULT_FORBIDDEN_SKILLS",
+    "DEFAULT_STATTHRESHOLD",
+    "StatThreshold",
+    "notify",
+    "preload_ponychart_classifier",
+]