gragra 0.2.0rc1__tar.gz

gragra-0.2.0rc1/.github/workflows/ci.yml

@@ -0,0 +1,226 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: public-ci-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  policy:
+    if: github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      - uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c
+        with:
+          python-version: '3.11'
+      - run: python -m pip install '.[dev]'
+      - run: python -m pytest -q tests/test_ci_policy.py
+
+  changes:
+    if: github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public' && needs.policy.result == 'success'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    needs: policy
+    outputs:
+      docs_only: ${{ steps.classify.outputs.docs_only }}
+      reason: ${{ steps.classify.outputs.reason }}
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+        with:
+          fetch-depth: 0
+      - id: classify
+        env:
+          BASE_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}
+          HEAD_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+        run: |
+          set -euo pipefail
+          if [[ "$BASE_SHA" == "0000000000000000000000000000000000000000" ]]; then
+            {
+              echo 'docs_only=false'
+              echo 'reason=full: initial push has no base commit'
+            } >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          git diff --name-status --find-renames "$BASE_SHA" "$HEAD_SHA" > changes.status
+          python scripts/ci/classify_changes.py < changes.status > classification.out
+          cat classification.out >> "$GITHUB_OUTPUT"
+
+  docs:
+    if: github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public' && needs.changes.result == 'success' && needs.changes.outputs.docs_only == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    needs: changes
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      - uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c
+        with:
+          python-version: '3.11'
+      - run: python -m pip install '.[dev,reference,field-io,docs,mesh]'
+      - run: ruff check src
+      - run: mkdocs build --strict
+      - run: python -m pytest -q tests/test_public_docs.py
+
+  reference:
+    if: github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public' && needs.changes.result == 'success' && needs.changes.outputs.docs_only != 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: changes
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12']
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      - uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install -e '.[dev,reference,field-io,docs,mesh]'
+      - run: ruff check src
+      - run: ruff format --check src
+      - run: python -m pytest -q
+      - run: mkdocs build --strict
+
+  numba-parity:
+    if: github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public' && needs.changes.result == 'success' && needs.changes.outputs.docs_only != 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: changes
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      - uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c
+        with:
+          python-version: '3.11'
+      - run: python -m pip install '.[dev,reference,field-io,numba]'
+      - run: GRAGRA_SPECFEM_BACKEND=numba python -m pytest -q tests/test_specfem_reader.py::test_displacement_acceleration_backend_matches_numpy_when_required
+
+  cpp-parity:
+    if: github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public' && needs.changes.result == 'success' && needs.changes.outputs.docs_only != 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    needs: changes
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      - uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c
+        with:
+          python-version: '3.11'
+      - name: Build and install the C++ backend from a copied tree
+        run: |
+          set -euo pipefail
+          source_copy=$(mktemp -d)
+          build_cwd=$(mktemp -d)
+          cp -a "$GITHUB_WORKSPACE"/. "$source_copy"/
+          cd "$build_cwd"
+          CMAKE_ARGS=-DGRAGRA_BUILD_CPP=ON python -m pip install "$source_copy[dev,reference,field-io,docs,mesh]"
+          python - <<'PY'
+          import os
+          import pathlib
+          import gragra
+          import gragra._cpp_backend as backend
+          from gragra.kernels._cpp_required import ALL_REQUIRED
+
+          missing = [name for name in ALL_REQUIRED if not hasattr(backend, name)]
+          if missing:
+              raise SystemExit(f"missing required C++ symbols: {missing}")
+          if pathlib.Path(gragra.__file__).resolve().is_relative_to(
+              pathlib.Path(os.environ["CHECKOUT_ROOT"]).resolve()
+          ):
+              raise SystemExit(f"source-tree import: {gragra.__file__}")
+          PY
+        env:
+          CHECKOUT_ROOT: ${{ github.workspace }}
+      - name: Run strict C++ parity outside the checkout
+        run: |
+          set -euo pipefail
+          test_cwd=$(mktemp -d)
+          cd "$test_cwd"
+          GRAGRA_SPECFEM_BACKEND=cpp python -m pytest -q "$GITHUB_WORKSPACE/tests/test_specfem_reader.py::test_displacement_acceleration_backend_matches_numpy_when_required"
+
+  package-smoke:
+    if: github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public' && needs.changes.result == 'success' && needs.changes.outputs.docs_only != 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    needs: changes
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      - uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c
+        with:
+          python-version: '3.11'
+      - name: Build artifacts and test them in fresh environments
+        run: |
+          set -euo pipefail
+          artifact_dir=$(mktemp -d)
+          python -m pip install build
+          python -m build --wheel --sdist --outdir "$artifact_dir"
+          for artifact in "$artifact_dir"/*.whl "$artifact_dir"/*.tar.gz; do
+            venv_dir=$(mktemp -d)
+            python -m venv "$venv_dir"
+            "$venv_dir/bin/python" -m pip install "$artifact"
+            "$venv_dir/bin/python" - <<PY
+          import pathlib
+          import gragra
+
+          checkout = pathlib.Path(r"$GITHUB_WORKSPACE").resolve()
+          imported = pathlib.Path(gragra.__file__).resolve()
+          if checkout == imported or checkout in imported.parents:
+              raise SystemExit(f"source-tree import: {imported}")
+          print(imported)
+          PY
+          done
+
+  required:
+    if: always() && github.repository == 'tatsuki-washimi/gragra' && github.event.repository.visibility == 'public'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    needs: [policy, changes, docs, reference, numba-parity, cpp-parity, package-smoke]
+    steps:
+      - name: Require the selected public checks
+        env:
+          POLICY: ${{ needs.policy.result }}
+          CHANGES: ${{ needs.changes.result }}
+          DOCS: ${{ needs.docs.result }}
+          REFERENCE: ${{ needs.reference.result }}
+          NUMBA: ${{ needs.numba-parity.result }}
+          CPP: ${{ needs.cpp-parity.result }}
+          PACKAGE: ${{ needs.package-smoke.result }}
+          DOCS_ONLY: ${{ needs.changes.outputs.docs_only }}
+        run: |
+          set -euo pipefail
+          for status in "$POLICY" "$CHANGES" "$DOCS" "$REFERENCE" "$NUMBA" "$CPP" "$PACKAGE"; do
+            case "$status" in
+              failure|cancelled)
+                echo "selected check ended with $status"
+                exit 1
+                ;;
+            esac
+          done
+          [[ "$POLICY" == success ]] || { echo "policy=$POLICY"; exit 1; }
+          [[ "$CHANGES" == success ]] || { echo "changes=$CHANGES"; exit 1; }
+          case "$DOCS_ONLY" in
+            true)
+              [[ "$DOCS" == success ]] || { echo "docs=$DOCS"; exit 1; }
+              [[ "$REFERENCE" == skipped ]] || { echo "reference=$REFERENCE"; exit 1; }
+              [[ "$NUMBA" == skipped ]] || { echo "numba-parity=$NUMBA"; exit 1; }
+              [[ "$CPP" == skipped ]] || { echo "cpp-parity=$CPP"; exit 1; }
+              [[ "$PACKAGE" == skipped ]] || { echo "package-smoke=$PACKAGE"; exit 1; }
+              ;;
+            false)
+              [[ "$DOCS" == skipped ]] || { echo "docs=$DOCS"; exit 1; }
+              [[ "$REFERENCE" == success ]] || { echo "reference=$REFERENCE"; exit 1; }
+              [[ "$NUMBA" == success ]] || { echo "numba-parity=$NUMBA"; exit 1; }
+              [[ "$CPP" == success ]] || { echo "cpp-parity=$CPP"; exit 1; }
+              [[ "$PACKAGE" == success ]] || { echo "package-smoke=$PACKAGE"; exit 1; }
+              ;;
+            *)
+              echo "invalid docs_only=$DOCS_ONLY"
+              exit 1
+              ;;
+          esac

gragra-0.2.0rc1/.github/workflows/deploy-pages.yml

@@ -0,0 +1,103 @@
+name: Deploy Pages
+
+'on':
+  # G3 production: deploy the pushed main commit. Manual SHA previews remain available.
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      source_sha:
+        description: 'Exact commit SHA in main or historical PR #6 for manual preview'
+        required: true
+        default: 'b9f54481ec748aa28925dc30b349c7144336acfa'
+
+concurrency:
+  group: pages-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build site (strict)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    steps:
+      - name: Validate source revision input
+        env:
+          SOURCE_SHA: ${{ github.event_name == 'push' && github.sha || inputs.source_sha }}
+        run: |
+          set -euo pipefail
+          if [[ ! "$SOURCE_SHA" =~ ^[0-9a-fA-F]{40}$ ]]; then
+            echo '::error::source_sha must be a complete 40-character commit SHA'
+            exit 1
+          fi
+      - name: Checkout source repository
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          ref: ${{ github.event_name == 'push' && github.sha || inputs.source_sha }}
+          fetch-depth: 0
+
+      - name: Record and verify target revision
+        env:
+          SOURCE_SHA: ${{ github.event_name == 'push' && github.sha || inputs.source_sha }}
+          RUN_EVENT: ${{ github.event_name }}
+        run: |
+          set -euo pipefail
+          RESOLVED_SHA="$(git rev-parse HEAD)"
+          if [[ "${SOURCE_SHA,,}" != "$RESOLVED_SHA" ]]; then
+            echo '::error::Checked-out revision does not match requested source_sha'
+            exit 1
+          fi
+          # Manual previews may use a reviewed main or historical PR #6 commit.
+          # The main push path always checks out the event's exact commit SHA.
+          if [[ "$RUN_EVENT" == "workflow_dispatch" ]]; then
+            git fetch --no-tags origin main 'refs/pull/6/head:refs/remotes/origin/pr-6-preview'
+            if ! git merge-base --is-ancestor "$RESOLVED_SHA" refs/remotes/origin/main &&
+               ! git merge-base --is-ancestor "$RESOLVED_SHA" refs/remotes/origin/pr-6-preview; then
+              echo '::error::source_sha must be in main or PR #6 history'
+              exit 1
+            fi
+          fi
+          echo "Requested source_sha: $SOURCE_SHA"
+          echo "Resolved commit SHA:  $RESOLVED_SHA"
+          echo "Commit Author:        $(git log -1 --format='%an <%ae>')"
+          echo "Commit Date:          $(git log -1 --format='%cd')"
+          echo "Commit Subject:       $(git log -1 --format='%s')"
+          echo "RESOLVED_SHA=$RESOLVED_SHA" >> "$GITHUB_ENV"
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.3.0
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+
+      - name: Install documentation dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install '.[dev,field-io,docs]'
+
+      - name: Build documentation (strict)
+        run: |
+          python -m mkdocs build --strict
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
+        with:
+          path: site/
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5

gragra-0.2.0rc1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,119 @@
+name: Publish gragra 0.2.0rc1 to PyPI (manual)
+
+# One-time, opt-in launch for the ENIGMA 2026 presentation.
+# Run from the main branch on 2026-11-11 UTC, after the Trusted Publisher
+# is registered at pypi.org (owner tatsuki-washimi, repo gragra,
+# workflow publish-pypi.yml, no GitHub environment).
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-check:
+    name: Build and smoke-test frozen release
+    # A release can only be initiated explicitly from main.
+    if: github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Require UTC release day
+        shell: bash
+        run: |
+          set -euo pipefail
+          today="$(date -u +%F)"
+          if [[ "$today" != "2026-11-11" ]]; then
+            echo "::error::Publish only on 2026-11-11 UTC (09:00 KST onwards). Current UTC date: $today"
+            exit 1
+          fi
+
+      # Pin the distribution to the already verified public main revision.
+      # The workflow addition itself does not modify the source of the release.
+      - name: Check out frozen release source
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          ref: f44716387d6c894efc0e20898ca7521ca4d97e53
+          persist-credentials: false
+
+      - name: Verify exact release commit and metadata
+        shell: bash
+        run: |
+          set -euo pipefail
+          test "$(git rev-parse HEAD)" = "f44716387d6c894efc0e20898ca7521ca4d97e53"
+          python - <<'PY'
+          import tomllib
+          from pathlib import Path
+
+          project = tomllib.loads(Path("pyproject.toml").read_text())["project"]
+          assert project["name"] == "gragra", project["name"]
+          assert project["version"] == "0.2.0rc1", project["version"]
+          assert 'version: 0.2.0rc1' in Path("CITATION.cff").read_text()
+          PY
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.3.0
+        with:
+          python-version: '3.11'
+
+      - name: Build wheel and sdist
+        shell: bash
+        run: |
+          set -euo pipefail
+          python -m pip install --upgrade build twine
+          python -m build --sdist --wheel --outdir dist
+          python -m twine check dist/*
+          test -f dist/gragra-0.2.0rc1-py3-none-any.whl
+          test -f dist/gragra-0.2.0rc1.tar.gz
+          sha256sum dist/*
+
+      - name: Install each artifact into a new environment and compute gravity
+        shell: bash
+        run: |
+          set -euo pipefail
+          for artifact in "$PWD"/dist/*.whl "$PWD"/dist/*.tar.gz; do
+            venv_dir="$(mktemp -d)"
+            test_dir="$(mktemp -d)"
+            python -m venv "$venv_dir"
+            "$venv_dir/bin/python" -m pip install "$artifact"
+            (
+              cd "$test_dir"
+              "$venv_dir/bin/python" - <<'PY'
+          from importlib.metadata import version
+          import numpy as np
+          from gragra import G_SI, PointMass, point_acceleration
+
+          assert version("gragra") == "0.2.0rc1"
+          a = point_acceleration(PointMass(1.0, [-1.0, 0.0, 0.0]), [[0.0, 0.0, 0.0]])
+          np.testing.assert_allclose(a, [[-G_SI, 0.0, 0.0]], rtol=0.0, atol=1e-25)
+          print("Fresh-install gravity smoke passed.")
+          PY
+            )
+          done
+
+      - name: Upload verified distributions for publish job
+        uses: actions/upload-artifact@v4
+        with:
+          name: gragra-0.2.0rc1-distributions
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 14
+
+  publish:
+    name: Publish to PyPI using Trusted Publishing
+    needs: build-and-check
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      id-token: write
+    steps:
+      - name: Download checked distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: gragra-0.2.0rc1-distributions
+          path: dist/
+
+      - name: Publish verified distributions
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

gragra-0.2.0rc1/.gitignore

@@ -0,0 +1,83 @@
+# === Local AI tooling ===
+# .harness/ holds the local AI agent harness (hooks, agents, rules, skills,
+# workflows). The tool directories below are symlinks into .harness/ plus
+# generated per-tool config and personal permission settings
+# (e.g. .claude/settings.local.json). None of this is part of the package
+# and it must not be published.
+.harness/
+.claude/
+.codex/
+.gemini/
+.agent/
+CLAUDE.md
+AGENTS.md
+paseo.json
+
+# === Python build, packaging, caches ===
+__pycache__/
+*.py[cod]
+*.egg
+*.egg-info/
+.eggs/
+build/
+dist/
+*.so
+*.o
+*.a
+CMakeCache.txt
+CMakeFiles/
+.ruff_cache/
+.pytest_cache/
+# MkDocs build output (mkdocs.yml has no explicit site_dir, so `mkdocs build`
+# writes to ./site/). The built site is a generated artifact; the sources live
+# in docs_site/.
+site/
+.mypy_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# === Virtual environments ===
+.venv/
+venv/
+env/
+
+# === Editor / OS noise ===
+.idea/
+.vscode/
+*.swp
+.DS_Store
+
+# === Generated artifacts (see .harness/rules/common/scope.md) ===
+# Computation/verification outputs (CSV / PNG / result JSON / large binaries)
+# are never committed. Intentional figures or reference data under docs/ and
+# tests/ are re-included by the negation patterns below.
+*.csv
+*.png
+result*.json
+*.npy
+*.npz
+*.h5
+*.hdf5
+!docs/**/*.png
+!docs/**/*.csv
+# Documentation-site assets. The blanket *.csv / *.png excludes above were
+# written when docs/ was the only documentation tree, so their re-inclusions
+# only cover docs/**. Without the line below, a diagram or reference dataset
+# placed under docs_site/docs/assets/ is silently never committed: the local
+# build stays green, the CI clean checkout has no such file, and MkDocs does
+# not treat a missing image as an error -- so CI stays green too and the
+# local documentation site simply loses the figure. Keep source assets visible
+# to a clean checkout.
+!docs_site/docs/assets/**
+!tests/**/*.csv
+!tests/**/*.npy
+!tests/**/*.npz
+!tests/**/*.h5
+!tests/**/*.hdf5
+
+# === References / Large Binaries ===
+*.pdf
+*.zip

gragra-0.2.0rc1/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [0.2.0rc1] - 2026-11-11
+
+### Added
+
+- R2 analytic formulas, R6 trajectory and rigid motion, R3 plane-wave and field
+  evaluation paths, and R4 material-region / hex8 geometry support from the
+  development line (source revision `b19ccbb`).
+- Expanded documentation site, examples, and public regression tests aligned
+  with the above API surface.
+
+### Changed
+
+- Package version and dependencies aligned with the development line (Astropy,
+  pandas, GWexpy, SciPy, Matplotlib, optional backends unchanged in role).
+- Root public API follows `gragra.gravity_sources` and consolidated observables;
+  rc2 `gragra.sources` and root-level projection helpers are removed (breaking).
+
+### Removed
+
+- `water_channel_uncorrelated_chen_taup2019_displacement_asd` from the public
+  API (independent uncorrelated channel models remain).
+
+### Migration from 0.1.0rc2
+
+- Replace `gragra.sources` imports with `gragra.gravity_sources`.
+- Replace removed root projection helpers with `gragra.observables` entry points
+  documented in the API reference.

gragra-0.2.0rc1/CITATION.cff

@@ -0,0 +1,11 @@
+cff-version: 1.2.0
+message: If you use gragra, please cite this software.
+title: gragra
+authors:
+  - family-names: Washimi
+    given-names: Tatsuki
+version: 0.2.0rc1
+date-released: 2026-11-11
+license: MIT
+url: https://github.com/tatsuki-washimi/gragra
+repository-code: https://github.com/tatsuki-washimi/gragra

gragra-0.2.0rc1/CMakeLists.txt

@@ -0,0 +1,23 @@
+cmake_minimum_required(VERSION 3.18)
+project(gragra LANGUAGES NONE)
+
+option(GRAGRA_BUILD_CPP "Build gragra C++ backend" OFF)
+
+if(GRAGRA_BUILD_CPP)
+  enable_language(CXX)
+
+  # Modern C++ standard
+  set(CMAKE_CXX_STANDARD 17)
+  set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+  find_package(pybind11 CONFIG REQUIRED)
+  find_package(OpenMP)
+
+  pybind11_add_module(_cpp_backend MODULE cpp/inverse_square_backend.cpp)
+
+  if(OpenMP_CXX_FOUND)
+    target_link_libraries(_cpp_backend PRIVATE OpenMP::OpenMP_CXX)
+  endif()
+
+  install(TARGETS _cpp_backend DESTINATION gragra)
+endif()

gragra-0.2.0rc1/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+Please open an issue before proposing a substantial change. Contributions must
+include focused tests and must not add private research material, solver output
+or third-party source text without a documented redistribution permission.
+
+## Verification responsibility
+
+The public repository covers public candidate code and user-facing package
+quality. It does not cover private research branches or private data. The CI
+workflow selects documentation-only checks for documentation changes and full
+public-scope checks for source, tests, builds, dependencies, workflows,
+scripts, and unknown paths. Full checks include the declared Python 3.11 and
+3.12 environments, NumPy/Numba and C++ parity, package wheel/sdist smoke
+tests, and a strict docs build.
+
+Supported environments are not the same as environments actually tested by CI.
+CI success does not certify arbitrary scientific conditions. Run research-
+required scientific verification locally with the exact code, environment,
+inputs, and conditions relevant to the claim, and record those conditions in
+the change description or accompanying research log. GitHub Actions success is
+not a universal adoption condition for research PRs. Automatic Actions or
+environment matrices are not reintroduced without an explicit policy change;
+moving execution location or frequency does not weaken scientific acceptance
+conditions.
+
+The workflow performs no publication, deployment, or upload operation.

gragra-0.2.0rc1/LICENSE

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