fix: decompose path payments into per-hop edges and guard against sel… #18

	name: Build & Publish Docs

	on:
	push:
	branches: [main]
	paths:
	- "astroml/**"
	- "docs/**"
	pull_request:
	branches: [main]
	paths:
	- "astroml/**"
	- "docs/**"
	workflow_dispatch:

	permissions:
	contents: read
	pages: write
	id-token: write

	concurrency:
	group: "pages"
	cancel-in-progress: false

	jobs:
	build:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4

	- name: Set up Python
	uses: actions/setup-python@v5
	with:
	python-version: "3.11"
	cache: pip

	- name: Install doc dependencies
	run: \|
	pip install -r docs/requirements.txt
	working-directory: astroml

	- name: Install package dependencies (mock heavy ones)
	run: \|
	pip install numpy pandas
	pip install --no-deps torch-geometric \|\| true
	pip install torch --index-url https://download.pytorch.org/whl/cpu
	working-directory: astroml

	- name: Install package (editable)
	run: pip install -e . --no-deps
	working-directory: astroml

	- name: Build HTML docs
	run: make html
	working-directory: astroml/docs

	- name: Upload Pages artifact
	if: github.ref == 'refs/heads/main'
	uses: actions/upload-pages-artifact@v3
	with:
	path: astroml/docs/_build/html

	deploy:
	needs: build
	if: github.ref == 'refs/heads/main'
	runs-on: ubuntu-latest
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	steps:
	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v4

Provide feedback