REUSE-WP-0019-T03: add Forgejo Actions workflows (part 2 of prior commit)

The .forgejo/workflows/ files and doc updates described in 4862ed6 didn't
actually get staged there (git add silently skipped them after an earlier
pathspec miss on the already-deleted .gitea file) -- committing them now.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

.forgejo/workflows/ci-smoke.yaml

@@ -0,0 +1,29 @@
+# Canonical CI smoke template (tier 1 routing drill).
+# Copy to: .forgejo/workflows/ci-smoke.yaml in consumer repos.
+name: CI Smoke
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  host-smoke:
+    runs-on: self-hosted
+    steps:
+      - name: Routing probe (host runner)
+        run: |
+          set -eu
+          echo "repository=${GITHUB_REPOSITORY:-unknown}"
+          echo "sha=${GITHUB_SHA:-unknown}"
+          echo "runner=${RUNNER_NAME:-unknown}"
+          uname -a
+
+  container-smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Routing probe (container label)
+        run: |
+          set -eu
+          echo "container-smoke ok for ${GITHUB_REPOSITORY:-unknown}"

.forgejo/workflows/ci.yml

@@ -0,0 +1,77 @@
+# Ported from .gitea/workflows/ci.yml (REUSE-WP-0019-T03). No actions/checkout
+# on this runner substrate (railiance-enablement/docs/forgejo-actions-workflow-templates.md)
+# -- ubuntu-latest maps to docker://node:20-bookworm, no Python preinstalled,
+# so use archive checkout + apt.
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  validate-registry:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Archive checkout
+        run: |
+          set -eu
+          REF="${GITHUB_SHA:-main}"
+          SHORT="${REF:0:7}"
+          mkdir -p /tmp/repo
+          wget -qO /tmp/repo.tar.gz "https://forgejo.coulomb.social/${GITHUB_REPOSITORY}/archive/${SHORT}.tar.gz"
+          tar xzf /tmp/repo.tar.gz -C /tmp/repo --strip-components=1
+
+      - name: Install Python + package
+        working-directory: /tmp/repo
+        run: |
+          set -eu
+          apt-get update -qq
+          apt-get install -y -qq python3 python3-pip python3-venv >/dev/null
+          python3 -m pip install --break-system-packages -e ".[dev]"
+
+      - name: Validate capability registry
+        working-directory: /tmp/repo
+        run: reuse-surface validate --relations --fail-on-warnings
+
+      - name: Compose federated index
+        working-directory: /tmp/repo
+        run: reuse-surface federation compose
+
+      - name: Generate catalog and graph
+        working-directory: /tmp/repo
+        run: |
+          reuse-surface catalog
+          reuse-surface graph --check --fail-on-warnings
+
+      - name: Registry maintain dry-run (informational)
+        working-directory: /tmp/repo
+        run: reuse-surface maintain --all --auto --no-llm || true
+
+      - name: Registry stats (informational)
+        working-directory: /tmp/repo
+        run: reuse-surface stats || true
+
+      - name: Workstation roster federation stats (informational)
+        working-directory: /tmp/repo
+        run: |
+          reuse-surface stats --roster registry/federation/local-repo-roster.yaml \
+            --federation-ready --format json || true
+
+      - name: Planning cohort report (informational)
+        working-directory: /tmp/repo
+        run: reuse-surface report cohorts --planning-min D4 || true
+
+      - name: Registry gap report (informational)
+        working-directory: /tmp/repo
+        run: reuse-surface report gaps || true
+
+      - name: Plan-check smoke test (informational)
+        working-directory: /tmp/repo
+        run: reuse-surface plan-check --intent "smoke test" --format json || true
+
+      - name: Run tests
+        working-directory: /tmp/repo
+        run: pytest -q

.forgejo/workflows/image.yaml

@@ -0,0 +1,46 @@
+# Canonical single-repo image build template (railiance-enablement/workflows/container-build-push.yaml).
+# Requires org secrets: REGISTRY_USER, REGISTRY_TOKEN
+name: Build and Publish Container Image
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - ".forgejo/workflows/image.yaml"
+      - "Dockerfile"
+      - "reuse_surface/**"
+      - "schemas/**"
+      - "pyproject.toml"
+  workflow_dispatch:
+
+env:
+  REGISTRY: forgejo.coulomb.social
+  IMAGE_NAME: coulomb/reuse-surface
+  DOCKER_HOST: tcp://127.0.0.1:2375
+
+jobs:
+  build-and-push:
+    runs-on: container-build
+    steps:
+      - name: Build and push image
+        env:
+          REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
+          REGISTRY_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
+        run: |
+          set -eu
+          REF="${GITHUB_SHA:-main}"
+          SHORT="${REF:0:7}"
+          mkdir -p buildctx "${HOME}/bin"
+          wget -qO /tmp/repo.tar.gz \
+            "https://forgejo.coulomb.social/${GITHUB_REPOSITORY}/archive/${SHORT}.tar.gz"
+          tar xzf /tmp/repo.tar.gz -C buildctx --strip-components=1
+          wget -qO- https://download.docker.com/linux/static/stable/x86_64/docker-27.3.1.tgz \
+            | tar xz --strip-components=1 -C "${HOME}/bin" docker/docker
+          export PATH="${HOME}/bin:${PATH}"
+          echo "${REGISTRY_TOKEN}" | docker login "${REGISTRY}" -u "${REGISTRY_USER}" --password-stdin
+          IMAGE="${REGISTRY}/${IMAGE_NAME}"
+          docker build -t "${IMAGE}:latest" -t "${IMAGE}:main-${SHORT}" buildctx
+          docker push "${IMAGE}:latest"
+          docker push "${IMAGE}:main-${SHORT}"
+          echo "pushed ${IMAGE}:latest and ${IMAGE}:main-${SHORT}"

.forgejo/workflows/recompose-fallback.yaml

@@ -0,0 +1,29 @@
+# Scheduled fallback recompose trigger (REUSE-WP-0019-T03 design principle 3:
+# "degrade to schedule" if the org-level webhook is unavailable or misses an
+# event). The webhook (POST /v1/webhooks/forgejo) is the primary path; this
+# just guarantees the hub's composed index doesn't go stale indefinitely if a
+# webhook delivery is ever missed.
+name: Recompose Fallback
+
+on:
+  schedule:
+    - cron: "17 */6 * * *"
+  workflow_dispatch:
+
+jobs:
+  recompose:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger hub recompose
+        env:
+          REUSE_SURFACE_TOKEN: ${{ secrets.REUSE_SURFACE_TOKEN }}
+        run: |
+          set -eu
+          apt-get update -qq
+          apt-get install -y -qq curl >/dev/null
+          status=$(curl -sS -o /tmp/compose.json -w '%{http_code}' \
+            -X POST "https://reuse.coulomb.social/v1/federated/compose" \
+            -H "Authorization: Bearer ${REUSE_SURFACE_TOKEN}")
+          echo "status=${status}"
+          cat /tmp/compose.json
+          [ "${status}" = "200" ]