klustra 0.2.0__tar.gz

klustra-0.2.0/.claude/hooks/format.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# PostToolUse hook: runs after every Edit/Write. No-op until pyproject.toml exists
+# (i.e. before Fase 1 scaffold), so it's safe to install on day one.
+set -e
+if [ -f pyproject.toml ]; then
+  uv run ruff check --fix . --quiet
+  uv run ruff format --quiet .
+fi
+exit 0

klustra-0.2.0/.claude/hooks/verify.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# Stop hook: enforces CLAUDE.md's "definition of done" mechanically.
+# No-op until pyproject.toml exists. Once the project is scaffolded,
+# a session cannot end silently on red tests/lint/types.
+if [ ! -f pyproject.toml ]; then
+  exit 0
+fi
+
+echo "--- ruff ---"
+uv run ruff check . && uv run ruff format --check .
+RUFF=$?
+
+echo "--- mypy ---"
+uv run mypy klustra/ 2>/dev/null
+MYPY=$?
+
+echo "--- pytest ---"
+uv run pytest -q
+PYTEST=$?
+
+if [ $RUFF -ne 0 ] || [ $MYPY -ne 0 ] || [ $PYTEST -ne 0 ]; then
+  echo "Verification failed (ruff=$RUFF mypy=$MYPY pytest=$PYTEST). Fix before stopping."
+  exit 1
+fi
+exit 0

klustra-0.2.0/.claude/settings.json

@@ -0,0 +1,25 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          { "type": "command", "command": "bash .claude/hooks/format.sh" }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "bash .claude/hooks/verify.sh" }
+        ]
+      }
+    ]
+  },
+  "permissions": {
+    "deny": [
+      "Bash(rm -rf *)",
+      "Edit(uv.lock)"
+    ]
+  }
+}

klustra-0.2.0/.github/workflows/python-publish.yml

@@ -0,0 +1,51 @@
+# Publishes klustra to PyPI when a GitHub Release is published.
+# Uses uv for building (matches local dev workflow) and PyPI Trusted
+# Publishing (OIDC) — no API token stored in GitHub secrets.
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Build release distributions
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # mandatory for trusted publishing (OIDC token exchange)
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/project/klustra/${{ github.event.release.name }}
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

klustra-0.2.0/.gitignore

@@ -0,0 +1,5 @@
+.env
+.env.*
+!.env.example
+__pycache__/
+*.py[cod]

klustra-0.2.0/.python-version

@@ -0,0 +1 @@
+3.13