diff --git a/.gitea/workflows/nix.yml b/.gitea/workflows/nix.yml deleted file mode 100644 index 9d13ce7..0000000 --- a/.gitea/workflows/nix.yml +++ /dev/null @@ -1,23 +0,0 @@ -name: Nix package - -on: - push: - pull_request: - -jobs: - build: - runs-on: ubuntu-latest - container: node:22-bookworm - steps: - - name: Checkout - uses: https://github.com/actions/checkout@v4 - - name: Install runner prerequisites - run: | - apt-get update - apt-get install -y --no-install-recommends sudo - - name: Install Nix - uses: https://github.com/cachix/install-nix-action@v31 - with: - enable_kvm: false - - name: Build default.nix package - run: nix build .#default --no-update-lock-file --no-link --print-out-paths --print-build-logs diff --git a/.gitea/workflows/rust.yml b/.gitea/workflows/rust.yml deleted file mode 100644 index 842a055..0000000 --- a/.gitea/workflows/rust.yml +++ /dev/null @@ -1,58 +0,0 @@ -name: Rust checks - -on: - push: - pull_request: - -jobs: - check: - runs-on: ubuntu-latest - container: node:22-bookworm - env: - RUST_VERSION: 1.99.1 - CARGO_HOME: /root/.cargo - RUSTUP_HOME: /root/.rustup - steps: - - name: Checkout - uses: https://github.com/actions/checkout@v4 - - name: Install build dependencies - run: | - apt-get update - apt-get install -y --no-install-recommends ca-certificates curl build-essential pkg-config libasound2-dev zstd - - name: Rust toolchain cache - uses: https://github.com/actions/cache@v4 - with: - path: | - /root/.rustup - /root/.cargo/bin - key: rust-toolchain-v1-linux-x64-${{ env.RUST_VERSION }} - - name: Install Rust - run: | - if [ ! -x "$CARGO_HOME/bin/rustup" ]; then - curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o /tmp/rustup-init.sh - sh /tmp/rustup-init.sh -y --profile minimal --default-toolchain none --no-modify-path - fi - "$CARGO_HOME/bin/rustup" toolchain install "$RUST_VERSION" --profile minimal --component rustfmt --component clippy - "$CARGO_HOME/bin/rustup" default "$RUST_VERSION" - echo "$CARGO_HOME/bin" >> "$GITHUB_PATH" - - name: Cargo cache - uses: https://github.com/actions/cache@v4 - with: - path: | - /root/.cargo/registry - /root/.cargo/git - target - key: cargo-v1-linux-x64-${{ env.RUST_VERSION }}-${{ hashFiles('Cargo.lock') }}-${{ hashFiles('Cargo.toml', 'src/**', 'tests/**') }} - restore-keys: | - cargo-v1-linux-x64-${{ env.RUST_VERSION }}-${{ hashFiles('Cargo.lock') }}- - cargo-v1-linux-x64-${{ env.RUST_VERSION }}- - - name: Formatting - run: cargo fmt --all -- --check - - name: Compilation - run: cargo check --all-targets --locked - - name: Tests - run: cargo test --all-targets --locked - - name: Release tests - run: cargo test --all-targets --release --locked - - name: Clippy - run: cargo clippy --all-targets --locked diff --git a/.gitea/workflows/packages.yml b/.gitea/workflows/tests.yml similarity index 62% rename from .gitea/workflows/packages.yml rename to .gitea/workflows/tests.yml index 1522bb6..3f26299 100644 --- a/.gitea/workflows/packages.yml +++ b/.gitea/workflows/tests.yml @@ -1,11 +1,84 @@ -name: Linux package builds (test) +name: Project tests on: push: pull_request: jobs: + check: + runs-on: ubuntu-latest + container: node:22-bookworm + env: + RUST_VERSION: 1.99.1 + CARGO_HOME: /root/.cargo + RUSTUP_HOME: /root/.rustup + steps: + - name: Checkout + uses: https://github.com/actions/checkout@v4 + - name: Install build dependencies + run: | + apt-get update + apt-get install -y --no-install-recommends ca-certificates curl build-essential pkg-config libasound2-dev zstd + - name: Rust toolchain cache + uses: https://github.com/actions/cache@v4 + with: + path: | + /root/.rustup + /root/.cargo/bin + key: rust-toolchain-v1-linux-x64-${{ env.RUST_VERSION }} + - name: Install Rust + run: | + if [ ! -x "$CARGO_HOME/bin/rustup" ]; then + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o /tmp/rustup-init.sh + sh /tmp/rustup-init.sh -y --profile minimal --default-toolchain none --no-modify-path + fi + "$CARGO_HOME/bin/rustup" toolchain install "$RUST_VERSION" --profile minimal --component rustfmt --component clippy + "$CARGO_HOME/bin/rustup" default "$RUST_VERSION" + echo "$CARGO_HOME/bin" >> "$GITHUB_PATH" + - name: Cargo cache + uses: https://github.com/actions/cache@v4 + with: + path: | + /root/.cargo/registry + /root/.cargo/git + target + key: cargo-v1-linux-x64-${{ env.RUST_VERSION }}-${{ hashFiles('Cargo.lock') }}-${{ hashFiles('Cargo.toml', 'src/**', 'tests/**') }} + restore-keys: | + cargo-v1-linux-x64-${{ env.RUST_VERSION }}-${{ hashFiles('Cargo.lock') }}- + cargo-v1-linux-x64-${{ env.RUST_VERSION }}- + - name: Formatting + run: cargo fmt --all -- --check + - name: Compilation + run: cargo check --all-targets --locked + - name: Tests + run: cargo test --all-targets --locked + - name: Release tests + run: cargo test --all-targets --release --locked + - name: Clippy + run: cargo clippy --all-targets --locked + + + nix: + needs: check + runs-on: ubuntu-latest + container: node:22-bookworm + steps: + - name: Checkout + uses: https://github.com/actions/checkout@v4 + - name: Install runner prerequisites + run: | + apt-get update + apt-get install -y --no-install-recommends sudo + - name: Install Nix + uses: https://github.com/cachix/install-nix-action@v31 + with: + enable_kvm: false + - name: Build default.nix package + run: nix build .#default --no-update-lock-file --no-link --print-out-paths --print-build-logs + + linux: + needs: nix runs-on: ubuntu-latest container: node:22-bookworm env: @@ -69,7 +142,9 @@ jobs: if-no-files-found: error retention-days: 7 + aur: + needs: linux runs-on: ubuntu-latest container: archlinux:base-devel steps: diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 44512f5..a7baeb3 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -29,11 +29,11 @@ Ostatnie polecenie wymaga interaktywnego terminala. `shellHook` drukuje dostępn Aktualny zestaw obejmuje 106 testów. Clippy ma istniejące ostrzeżenia dla biblioteki. `clippy::unused_unit` jest dozwolony ze względu na wymagane jawne `-> ()`. Zakres i polecenia opisano w [TESTING.md](TESTING.md). Nie traktuj tego jako potwierdzenia działania pełnej rozgrywki. Nowa nietrywialna logika wymaga małego testu regresji. Nie dodawaj zależności ani warstw abstrakcji bez potrzeby. -`Cargo.toml` wymaga Rust 1.88 lub nowszego, zabrania `unsafe` we własnym kodzie i ignorowania wyników `must_use`, a w release włącza kontrolę przepełnień. CI Gitea w `.gitea/workflows/rust.yml` sprawdza formatowanie, kompilację, testy debug/release i Clippy bez Nix, przez Rust 1.99.1 instalowany rustup; lokalnie nadal używaj Nix. Oddzielny `.gitea/workflows/nix.yml` buduje `.#default` z `default.nix`, z testami pakietu i kontrolą instalacji. Nie dodawaj `-D warnings` przed uporządkowaniem istniejących ostrzeżeń. +`Cargo.toml` wymaga Rust 1.88 lub nowszego, zabrania `unsafe` we własnym kodzie i ignorowania wyników `must_use`, a w release włącza kontrolę przepełnień. CI Gitea to jeden workflow `Project tests` w `.gitea/workflows/tests.yml`, uruchamiany po pushu i dla pull requestów. Zależności `needs` ustalają kolejność `check → nix → linux → aur`; błąd joba pomija zależne joby. `check` sprawdza formatowanie, kompilację, testy debug/release i Clippy bez Nix, przez Rust 1.99.1 instalowany rustup; lokalnie nadal używaj Nix. Job `nix` buduje `.#default` z `default.nix`, z testami pakietu i kontrolą instalacji. Nie dodawaj `-D warnings` przed uporządkowaniem istniejących ostrzeżeń. Audio wymaga ALSA i urządzenia odtwarzania; do pracy nad TUI używaj `--disable-audio`. `--mute` nadal uruchamia wątek audio. Ścieżki zasobów i pakowanie sprawdzaj osobno przy zmianach audio/Nix. Rozróżniaj lokalny build Cargo, pakiet `.#develop` i domyślny pakiet Nix. -`.gitea/workflows/packages.yml` testuje paczki Linux x86_64 bez Nix: deb, rpm, AppImage, Flatpak oraz przepis AUR budowany przez makepkg. Nie publikuje wydań ani tagów. Przepisy, layout i ograniczenia opisano w [PACKAGING.md](PACKAGING.md); zmiany pakowania muszą zachować muzykę obok binarki i działanie poza katalogiem repozytorium. +Joby `linux` i `aur` w `.gitea/workflows/tests.yml` testują paczki Linux x86_64 bez Nix: deb, rpm, AppImage, Flatpak oraz przepis AUR budowany przez makepkg. Nie publikują wydań ani tagów. Przepisy, layout i ograniczenia opisano w [PACKAGING.md](PACKAGING.md); zmiany pakowania muszą zachować muzykę obok binarki i działanie poza katalogiem repozytorium. ## Konwencje kodu diff --git a/docs/CODE_MAP.md b/docs/CODE_MAP.md index b8c04eb..e9fabb9 100644 --- a/docs/CODE_MAP.md +++ b/docs/CODE_MAP.md @@ -24,9 +24,9 @@ Wszystkie ścieżki poniżej są względem katalogu głównego repozytorium. | Wątki | `src/app/threads/{events,tick,audio}.rs` | Crossterm, zegar 33 ms, Rodio i komendy audio | | Środowisko | `Cargo.toml`, `flake.nix`, `default.nix`, `flake.lock` | Zależności, toolchain Fenix, ALSA, pakowanie przez Naersk lub buildRustPackage | | Formatowanie | `rustfmt.toml` | Rustfmt, styl 2024, wcięcia po 2 spacje, docelowo 100 znaków i zakończenia LF | -| Kontrole CI | `.gitea/workflows/rust.yml` | Gitea Actions w `node:22-bookworm`: Rust 1.99.1 przez rustup, cache toolchaina i Cargo, formatowanie, kompilacja, testy debug/release i Clippy | -| Budowa paczki Nix | `.gitea/workflows/nix.yml` | Oddzielny workflow buduje `.#default`, czyli `default.nix` przez nixpkgs przypięte w `flake.lock`, z testami i kontrolą instalacji pakietu | -| Paczki Linux | `.gitea/workflows/packages.yml`, `packaging/` | Testowe deb, rpm, AppImage, Flatpak oraz makepkg dla AUR; bez wydań i tagów; szczegóły w `docs/PACKAGING.md` | +| Kontrole CI | `.gitea/workflows/tests.yml` | Workflow `Project tests` po pushu i dla pull requestów; kolejność przez `needs`: `check → nix → linux → aur`. Job `check` w `node:22-bookworm`: Rust 1.99.1 przez rustup, cache toolchaina i Cargo, formatowanie, kompilacja, testy debug/release i Clippy | +| Budowa paczki Nix | `.gitea/workflows/tests.yml` (job `nix`) | Po sukcesie `check` buduje `.#default`, czyli `default.nix` przez nixpkgs przypięte w `flake.lock`, z testami i kontrolą instalacji pakietu | +| Paczki Linux | `.gitea/workflows/tests.yml` (joby `linux`, `aur`), `packaging/` | Po sukcesie `nix`: testowe deb, rpm, AppImage i Flatpak w `linux`, następnie makepkg dla AUR w `aur`; bez wydań i tagów; szczegóły w `docs/PACKAGING.md` | | Licencja | `LICENSE`, `Cargo.toml`, `default.nix` | MIT, Copyright (c) 2026 GarandPLG | | Zasoby | `soundtracks/default/`, `ui_draft/` | Dwa pliki OGG i tekstowe szkice ekranów | diff --git a/docs/PACKAGING.md b/docs/PACKAGING.md index 229eab2..ee24368 100644 --- a/docs/PACKAGING.md +++ b/docs/PACKAGING.md @@ -1,6 +1,6 @@ # Testowe paczki Linux -Workflow `.gitea/workflows/packages.yml` uruchamia się po pushu i dla pull requestów. Nie tworzy tagów, wydań ani wpisów w AUR/Flathub. Paczki są niesygnowanymi artefaktami CI przechowywanymi przez 7 dni. Używa `upload-artifact@v3` dla zgodności z Gitea. +Workflow `Project tests` w `.gitea/workflows/tests.yml` uruchamia się po pushu i dla pull requestów. Zależności `needs` wymuszają kolejność `check → nix → linux → aur`: job `linux` buduje deb, rpm, AppImage i Flatpak, a po jego sukcesie job `aur` sprawdza przepis Arch. Błąd wcześniejszego joba pomija zależne joby. Workflow nie tworzy tagów, wydań ani wpisów w AUR/Flathub. Paczki są niesygnowanymi artefaktami CI przechowywanymi przez 7 dni. Używa `upload-artifact@v3` dla zgodności z Gitea. Obsługiwana architektura to x86_64. Są to formaty dystrybucji Linux, nie kompilacje Windows/macOS. @@ -32,6 +32,6 @@ Przepis AUR jest testowy: nie wskazuje publicznego tarballa wydania. Workflow do Flatpak jest testem pakowania istniejącej binarki, nie kompilacją wewnątrz SDK Flatpak. Bookworm dostarcza glibc 2.36, runtime 25.08 jest nowszy. Pakowana jest biblioteka ALSA; uprawnienia obejmują PulseAudio i urządzenia dla bezpośredniego ALSA. `build-export --disable-sandbox` wyłącza wyłącznie sandbox walidatora własnej ikony z repozytorium, nie walidację ani sandbox gotowej aplikacji. Tworzenie paczki nie potrzebuje privileged ani zmiany polityki Dockera. Instalacja w Dockerze może zgłaszać bwrap dla hooków integracji pulpitu mimo poprawnego zainstalowania paczki; sprawdzamy kod wyjścia, pliki i binarkę. Pełnego uruchomienia TUI i audio w sandboxie te kontrole nie zastępują. Runtime nie jest zawarty w pliku .flatpak; użytkownik musi go zainstalować z Flathub. CI używa --no-related, aby nie pobierać opcjonalnych dodatków GPU i tłumaczeń. -Paczki Debian, RPM i AppImage mają bazę ABI Bookworm (glibc >= 2.36); nie gwarantują działania na starszych dystrybucjach. AppImage zawiera ALSA, ale korzysta z konfiguracji audio hosta. Testy nie potwierdzają odsłuchu ani otwierania terminala z menu desktop. Appimagetool jest przypięty do wersji; jego domyślny runtime jest pobierany z upstream podczas pakowania. Rust i Cargo mają cache oddzielny od zwykłego workflow Rust; dla cache wymagany jest działający serwer runnera. Arch i Flatpak pobierają własne zależności bez trwałego cache. +Paczki Debian, RPM i AppImage mają bazę ABI Bookworm (glibc >= 2.36); nie gwarantują działania na starszych dystrybucjach. AppImage zawiera ALSA, ale korzysta z konfiguracji audio hosta. Testy nie potwierdzają odsłuchu ani otwierania terminala z menu desktop. Appimagetool jest przypięty do wersji; jego domyślny runtime jest pobierany z upstream podczas pakowania. Joby `check` i `linux` współdzielą klucz cache toolchaina Rust, ale mają osobne klucze cache Cargo (`cargo-v1` i `packages-v1`); dla cache wymagany jest działający serwer runnera. Arch i Flatpak pobierają własne zależności bez trwałego cache. Dokumentacja narzędzi: [AppImage](https://github.com/AppImage/appimagetool/tree/1.9.1), [Flatpak](https://docs.flatpak.org/en/latest/flatpak-command-reference.html), [makepkg](https://man.archlinux.org/man/makepkg.8). diff --git a/docs/PROGRESS.md b/docs/PROGRESS.md index e1dc875..b738e90 100644 --- a/docs/PROGRESS.md +++ b/docs/PROGRESS.md @@ -1,5 +1,11 @@ # Dziennik prac +## 2026-10-24 — wspólny workflow Gitea i kolejność jobów + +Odnotowano zmianę użytkownika: `.gitea/workflows/tests.yml` (`Project tests`) zastępuje osobne workflowy `rust.yml`, `nix.yml` i `packages.yml`. Po pushu i dla pull requestów wykonuje joby w kolejności `check → nix → linux → aur`, wymuszonej przez `needs`. Błąd wcześniejszego joba pomija zależne joby. `check` wykonuje kontrole Rust, `nix` buduje `.#default`, `linux` pakuje deb/rpm/AppImage/Flatpak, a `aur` buduje i instaluje paczkę Arch. Artefakty pozostają testowe, bez publikowania wydań i tagów, z retencją 7 dni. + +Zaktualizowano CODE_MAP, TESTING, PACKAGING i AGENTS, w tym opis współdzielonego cache toolchaina oraz osobnych cache Cargo. Nie zmieniano workflowu ani flake.nix. Dokumentację porównano z aktualnym yml; `git diff --check` i `nix develop -c cargo check --all-targets --locked` przeszły. Nie uruchamiano jobów Gitea. + ## 2026-10-24 — czas podpór, kamień bez stresu i wybór zadania po Space Budowa i usuwanie podpór trwają po 91 ticków pracy (3003 ms). Tunnel przechowuje SupportWork z właścicielem, rodzajem pracy i postępem; roof_support zmienia się dopiero przy ukończeniu. Budowa pobiera koszt raz przy rozpoczęciu, a podpora w trakcie rozbiórki nadal stabilizuje sieć. Kaskada następuje dopiero po zakończeniu usuwania. Postęp jest na kratce, w zakładce Support i pod Tab. Bez budowniczego timer pauzuje; jeden górnik nie wykonuje dwóch podpór naraz, a jego ruch i kopanie są wstrzymane na czas pracy. diff --git a/docs/TESTING.md b/docs/TESTING.md index 2595f02..3fba10d 100644 --- a/docs/TESTING.md +++ b/docs/TESTING.md @@ -53,13 +53,15 @@ Testy `tests/task_cancellation.rs` (4) sprawdzają usuwanie ostatniego zadania i ## CI i profile kompilacji -Testowe paczki deb, rpm, AppImage, AUR i Flatpak sprawdza niezależny `.gitea/workflows/packages.yml`, bez publikowania wydań. Zasady budowania, artefakty i ograniczenia opisano w [PACKAGING.md](PACKAGING.md). +Jeden workflow `Project tests` w `.gitea/workflows/tests.yml` uruchamia się po pushu i dla pull requestów. Zależności `needs` ustalają kolejność `check → nix → linux → aur`; kolejny job czeka na sukces poprzedniego, a błąd pomija zależne joby. Zastępuje wcześniejsze osobne pliki `rust.yml`, `nix.yml` i `packages.yml`. Kolejność dotyczy jobów jednego przebiegu, nie serializuje różnych pushów. -Osobny workflow `.gitea/workflows/nix.yml` (push i pull request) instaluje Nix w `node:22-bookworm` i wykonuje `nix build .#default --no-update-lock-file --no-link --print-out-paths --print-build-logs`. Atrybut `.#default` wywołuje `pkgs.callPackage ./default.nix {}` z nixpkgs przypiętym w `flake.lock`; nie buduje wariantu `.#develop` opartego na Fenix. Budowa obejmuje standardową fazę testów `buildRustPackage` i włączony w pakiecie `versionCheckHook`. Nie wymaga devShell ani uruchamiania gry. Instalator potrzebuje sudo; KVM jest wyłączone. Workflow nie konfiguruje trwałego cache magazynu Nix, więc nowy job może ponownie pobierać zależności. Kontrole Rust opisane poniżej pozostają niezależne. +Job `linux` sprawdza testowe paczki deb, rpm, AppImage i Flatpak, a następujący po nim `aur` sprawdza paczkę Arch, bez publikowania wydań. Zasady budowania, artefakty i ograniczenia opisano w [PACKAGING.md](PACKAGING.md). -Workflow `.gitea/workflows/rust.yml` uruchamia kontrole po pushu i dla pull requestów. Wymaga włączonych Actions w repozytorium Gitea i runnera Linux x86_64 o etykiecie `ubuntu-latest`, obsługującego akcje Node. Nazwy akcji zawierają pełne adresy GitHub. Konfiguracja nie rejestruje runnera ani nie włącza Actions na serwerze; zobacz [instrukcję Gitea](https://docs.gitea.com/usage/actions/quickstart/). +Job `nix` instaluje Nix w `node:22-bookworm` i wykonuje `nix build .#default --no-update-lock-file --no-link --print-out-paths --print-build-logs`. Atrybut `.#default` wywołuje `pkgs.callPackage ./default.nix {}` z nixpkgs przypiętym w `flake.lock`; nie buduje wariantu `.#develop` opartego na Fenix. Budowa obejmuje standardową fazę testów `buildRustPackage` i włączony w pakiecie `versionCheckHook`. Nie wymaga devShell ani uruchamiania gry. Instalator potrzebuje sudo; KVM jest wyłączone. Workflow nie konfiguruje trwałego cache magazynu Nix, więc nowy job może ponownie pobierać zależności. -Workflow określa obraz zadania jawnie jako `node:22-bookworm`. Kontener działa jako root i instaluje pakiety potrzebne do budowania: build-essential, pkg-config i libasound2-dev oraz curl, ca-certificates i zstd. Rust 1.99.1 z rustfmt i Clippy jest instalowany przez rustup. CI nie instaluje Nix i nie wykonuje jego shellHook. +Job `check` wykonuje kontrole Rust. Workflow wymaga włączonych Actions w repozytorium Gitea i runnera Linux x86_64 o etykiecie `ubuntu-latest`, obsługującego akcje Node. Nazwy akcji zawierają pełne adresy GitHub. Konfiguracja nie rejestruje runnera ani nie włącza Actions na serwerze; zobacz [instrukcję Gitea](https://docs.gitea.com/usage/actions/quickstart/). + +Job `check` określa obraz zadania jawnie jako `node:22-bookworm`. Kontener działa jako root i instaluje pakiety potrzebne do budowania: build-essential, pkg-config i libasound2-dev oraz curl, ca-certificates i zstd. Rust 1.99.1 z rustfmt i Clippy jest instalowany przez rustup. Ten job nie instaluje Nix i nie wykonuje jego shellHook. Wersję Rust w CI określa `RUST_VERSION` w workflow, niezależnie od lokalnego `flake.lock`. Formatowanie, kompilacja, testy i Clippy są oddzielnymi krokami Cargo. Polecenia kompilujące projekt mają `--locked`; Clippy nie używa `-D warnings` z powodu istniejących ostrzeżeń. `actions/cache@v4` zachowuje osobno toolchain oraz rejestr Cargo, repozytoria git i `target`. Klucze uwzględniają wersję Rust, a dla Cargo także manifest, lockfile i kod; klucze częściowe pozwalają ponownie wykorzystać wcześniejsze kompilacje. Działanie cache wymaga dostępnego serwera cache runnera. Pierwszy przebieg wypełnia cache; błędy pobierania cache mogą spowodować ponowną instalację i kompilację. diff --git a/flake.nix b/flake.nix index bf66b18..102f375 100644 --- a/flake.nix +++ b/flake.nix @@ -59,9 +59,7 @@ buildInputs = with pkgs; [ rustToolchain alsa-lib - bash gitea-actions-runner - docker ]; nativeBuildInputs = with pkgs; [pkg-config]; @@ -75,10 +73,7 @@ echo " nix run .#develop - Run development version" echo "" echo "Gitea workflows:" - echo " gitea-runner exec -W .gitea/workflows/rust.yml --event push -j check" - echo " gitea-runner exec -W .gitea/workflows/nix.yml --event push -j build" - echo " gitea-runner exec -W .gitea/workflows/packages.yml --event push -j linux" - echo " gitea-runner exec -W .gitea/workflows/packages.yml --event push -j aur" + echo " gitea-runner exec -W .gitea/workflows/tests.yml --event push --gitea-instance https://gitea.garandplg.com --network host" ''; }; };