feat: add remote and multi-repo release flow with CI, validation, and docs

Signed-off-by: Damian Skrzyński <polprog.tech@gmail.com>

Author: polprog-dev

.github/workflows/ci.yml

@@ -6,33 +6,80 @@ on:
   pull_request:
     branches: [main]
 
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
-  quality:
-    name: Lint & Test
+  lint:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install ruff
+        run: python -m pip install --quiet "ruff>=0.4"
+
+      - name: Ruff check
+        run: ruff check src/ tests/
+
+      - name: Ruff format check
+        run: ruff format --check src/ tests/
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    needs: lint
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
         python-version: ["3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+          cache: pip
 
       - name: Install dependencies
-        run: python -m pip install -e ".[all]"
+        run: python -m pip install --quiet -e ".[all]"
+
+      - name: Run tests
+        run: python -m pytest --tb=short -q --junitxml=results.xml
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-py${{ matrix.python-version }}
+          path: results.xml
+          retention-days: 7
+
+  package:
+    name: Package
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
 
-      - name: Lint
-        run: python -m ruff check src/ tests/
+      - name: Install build tools
+        run: python -m pip install --quiet build
 
-      - name: Test
-        run: python -m pytest --tb=short -q
+      - name: Build sdist and wheel
+        run: python -m build --sdist --wheel
 
-      - name: Packaging sanity check
+      - name: Verify distributions
         run: |
-          python -m pip install build
-          python -m build --sdist --wheel
           ls -la dist/
+          python -m pip install --quiet twine
+          twine check dist/*

LICENSE

@@ -4,7 +4,7 @@
 
 <p align="center">
   <a href="https://github.com/polprog-tech/ReleasePilot/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/polprog-tech/ReleasePilot/ci.yml?branch=main&style=flat-square&label=CI&logo=github" alt="CI"></a>
-  <a href="https://github.com/polprog-tech/ReleasePilot/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License: MIT"></a>
+  <a href="https://github.com/polprog-tech/ReleasePilot/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue?style=flat-square" alt="License: AGPL-3.0"></a>
   <img src="https://img.shields.io/badge/python-3.12%2B-3776ab?style=flat-square&logo=python&logoColor=white" alt="Python 3.12+">
   <img src="https://img.shields.io/badge/languages-10-6366f1?style=flat-square" alt="10 Languages">
   <img src="https://img.shields.io/badge/formats-PDF%20·%20DOCX%20·%20MD%20·%20JSON-334155?style=flat-square" alt="Formats">
@@ -48,7 +48,7 @@ The Guide tab explains how ReleasePilot works — the pipeline stages, all 8 aud
 
 ### Source Configuration Wizard
 
-The wizard guides you through selecting the source range, audience, and output format step by step. Choose between date-based or git-reference-based ranges with quick presets.
+The wizard guides you through a multi-step flow: source selection (local or remote), repository configuration (single or multi-repo), release scope, audience, and format — with built-in validation at every step. Supports GitHub and GitLab repositories via URL. Access tokens are context-aware: optional for public GitHub repositories, required for private repos and GitLab. See [Web Wizard Documentation](docs/web-wizard.md) for full details.
 
 <p align="center">
   <img src="docs/assets/screenshots/wizard-source-config.png" alt="ReleasePilot — source configuration wizard with date range presets" width="800">
@@ -70,6 +70,7 @@ After the pipeline processes your commits, you see a summary of changes and outp
 - [Screenshots](#screenshots)
 - [Quick Start](#quick-start)
 - [Web Server Mode](#web-server-mode)
+- [Web Wizard](docs/web-wizard.md)
 - [CLI Mode](#cli-mode)
 - [Features](#features)
 - [Configuration](#configuration)
@@ -479,4 +480,4 @@ For detailed solutions to common issues, see [docs/troubleshooting.md](docs/trou
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+AGPL-3.0 — see [LICENSE](LICENSE).

README.md

@@ -106,9 +106,12 @@ Release notes are generated automatically.
 
 | File | Description |
 |------|-------------|
-| [`examples/github-workflow.yml`](../examples/github-workflow.yml) | Minimal 30-line GitHub workflow |
-| [`examples/gitlab-pipeline.yml`](../examples/gitlab-pipeline.yml) | Minimal 25-line GitLab job |
+| [`examples/github-release-notes.yml`](../examples/github-release-notes.yml) | GitHub Actions workflow for release notes |
+| [`examples/gitlab-release-notes.yml`](../examples/gitlab-release-notes.yml) | GitLab CI job for release notes |
 | [`examples/.releasepilot.json`](../examples/.releasepilot.json) | Example config with CI settings |
+| [`examples/multi-repo-config.json`](../examples/multi-repo-config.json) | Multi-repository config example |
+| [`examples/cli-usage.sh`](../examples/cli-usage.sh) | CLI usage examples |
+| [`examples/remote-repos.md`](../examples/remote-repos.md) | Remote/multi-repo dashboard guide |
 
 ## Configuration
 

docs/ci-cd.md

@@ -38,7 +38,7 @@ This guide explains how to use ReleasePilot in GitHub Actions to automatically g
 
 ### Option A: Copy a minimal workflow
 
-Copy [`examples/github-workflow.yml`](../examples/github-workflow.yml) to `.github/workflows/release-notes.yml` in your repository:
+Copy [`examples/github-release-notes.yml`](../examples/github-release-notes.yml) to `.github/workflows/release-notes.yml` in your repository:
 
 ```yaml
 name: Release Notes
@@ -261,7 +261,7 @@ No additional secrets are needed. ReleasePilot reads git history directly from t
 ### Install a specific ReleasePilot version
 
 ```yaml
-- run: pip install "releasepilot[export] @ git+https://github.com/polprog-tech/ReleasePilot.git@v1.0.0"
+- run: pip install "releasepilot[export] @ git+https://github.com/polprog-tech/ReleasePilot.git@v1.1.0"
 ```
 
 ### Add translation support

docs/github-integration.md

@@ -278,7 +278,7 @@ variables:
 
 ```yaml
 variables:
-  RP_INSTALL_SPEC: "releasepilot[export] @ git+https://github.com/polprog-tech/ReleasePilot.git@v1.0.0"
+  RP_INSTALL_SPEC: "releasepilot[export] @ git+https://github.com/polprog-tech/ReleasePilot.git@v1.1.0"
 ```
 
 ### Use structured input (no git)