dualfroz/vulp
1
0 Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Phases 0-1 + Sprint A: module split, CLI layer, org-refresh fix, hygiene

Browse Source 
- LICENSE (MIT) + README truth-pass; docs/cli.md CLI contract
- CLI subcommands (src/cli_cmds/) per "TUI for users, CLI for users+AI"
- Hub/detail refactor: keymap dispatch, modal split, action enum, BgMsg bus
- Fix: org repos were never refreshed (owner==username match); refresh now
  parallel — 49 repos in ~11s, surfaced 70 previously invisible PRs
- Fix: 3 date bugs in detail/git.rs (format-local, Local::now, 1y month math)
- Stash indicator + [m] actions, session persistence, gh CLI token fallback
- Legacy UI modules removed; plan/ docs (roadmap, audit, debate, handoff)
This commit is contained in:
dualfroz committed 2026-07-06 14:42:52 +02:00
1 parent 5787b14880
commit 0468c032c6
100 files changed
+11614 -9840
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

README.md
+90 -285
View File
@@ -1,322 +1,127 @@
# fxg
# Vulp
Multi-repository git workflow manager. Zarządzaj repozytoriami na GitHub, GitLab i Gitea z jednego miejsca.
Multi-repository git workflow manager. Jeden terminal, cały workspace:
stan wszystkich repozytoriów, batch sync, projekty, todos, PR-y/issues,
statystyki — plus pełne, bezpromptowe CLI, którego mogą używać skrypty
i asystenci AI.
## Install
- **TUI** (`vulp` bez argumentów) — interfejs dla ludzi
- **CLI** (`vulp <komenda>`) — dla ludzi, skryptów i AI; `--json`, kody
wyjścia, zero interaktywnych pytań → pełna referencja: [docs/cli.md](docs/cli.md)
## Instalacja
Gotowa binarka (Linux/Windows), bez Rusta:
```bash
# Linux — opcjonalna zależność systemowa
sudo apt install libgit2-dev # Ubuntu/Debian
sudo pacman -S libgit2 # Arch
cargo install --path .
fxg --version
# Linux
curl -fsSL https://raw.githubusercontent.com/dualfroz/fxg/main/install/vulp-installer.sh | bash
```
Binarny plik ląduje w `~/.cargo/bin/fxg` — już jest w PATH po standardowej instalacji Rust. Działa na Windows i Linux.
```powershell
# Windows
irm https://raw.githubusercontent.com/dualfroz/fxg/main/install/vulp-installer.ps1 | iex
```
---
Albo ze źródeł: `cargo install --path .`
## Pierwsze uruchomienie
```bash
fxg config # ustaw workspace_root, username, email
fxg auth add --provider github --token ghp_xxxxx
vulp config # ustaw workspace_root, username, email
vulp auth import # zaimportuj konto z gh CLI (najprościej)
# albo: vulp auth add --provider github --token ghp_xxx
vulp # odpal TUI
```
Bez tych dwóch kroków większość komend nie zadziała.
## TUI
---
`vulp` otwiera hub z zakładkami (przełączanie: `Tab`/`←→` albo `1-9`):
## `fxg status`
| # | Zakładka | Co robi |
|---|----------|---------|
| 1 | **Overview** | bento-dashboard: statystyki workspace, projekty, top repo po commitach, scalony feed aktywności (commity + akcje vulpa), todos/PRs/issues |
| 2 | **Repos** | tabela wszystkich rep: branch, dirty/ahead/behind, język, gwiazdki; multi-select do operacji hurtowych |
| 3 | **Projects** | grupy repozytoriów (kolor + przypisania) |
| 4 | **Todos** | zadania ręczne + zaimportowane skanem TODO/FIXME z kodu |
| 5/6 | **PRs / Issues** | otwarte PR-y i issues ze wszystkich rep (cache, odświeżane `[R]`) |
| 7 | **Stats** | statystyki commitów per okres (1d–all) |
| 8 | **Activity** | feed: commity + akcje wykonane vulpem |
| 9 | **Settings** | edytor, schowek, workspace, konta, szablony repo, bulk import |
Otwiera TUI — tabelę wszystkich repozytoriów z `workspace_root`:
Najważniejsze klawisze (pełna lista: `?` w aplikacji):
```
┌ fxg — Workspace Status · 4 repos ──────────────────────────────────────────────┐
│ # NAME BRANCH AHEAD BEHIND DIRTY LAST COMMIT │
│ 1 my-api main 2 0 ✗ 2h ago │
│ 2 my-frontend develop 0 3 ✓ yesterday ← żółty │
│ 3 shared-lib main 0 0 ✗ 5d ago │
│ 4 infra feat/k8s 1 0 ✓ 30m ago ← żółty │
│ │
│ [↑/↓] navigate [Enter] drill-in [f] filter [q] quit │
└─────────────────────────────────────────────────────────────────────────────────┘
```
- **`m` — kontekstowe menu akcji.** Na każdej zakładce pokazuje wszystkie
dostępne akcje z ich skrótami — nie musisz nic pamiętać.
- `Enter` — szczegóły repo/projektu (historia, branch'e, pliki, diff,
ustawienia zdalne, akcje: sync/release/collaboratorzy…)
- `Space` zaznacz do batcha · `s` sync (pull/commit+push) · `r` release
- `/` filtr · `S` sort i filtry · `d/b/f` tylko dirty/behind/ahead
- `N` nowe repo (clone/create/link) · `R` odśwież metadane z API
- `o` otwórz w edytorze · `W` w przeglądarce · `y`/`u` kopiuj ścieżkę/URL
Kolory: żółty = dirty (niezcommitowane zmiany), czerwony = behind (trzeba pullować).
## CLI (skrypty + AI)
**Enter na repozytorium** → widok szczegółowy:
```
┌ my-frontend · develop ─────────────────────────────────────────────────────────┐
│ Branch: develop │
│ Status: +0 ahead -3 behind dirty: yes │
│ │
│ ┌ Modified files ──────────────────────────┐ ┌ Recent commits ───────────────┐ │
│ │ M src/components/Nav.tsx │ │ a3f1c2 fix: nav style 2h │ │
│ │ M src/styles/theme.css │ │ b89d01 feat: dark mode 1d │ │
│ │ ? src/utils/new-helper.ts │ │ c12345 chore: deps 3d │ │
│ └──────────────────────────────────────────┘ └───────────────────────────────┘ │
│ [p] pull [P] push [c] commit [b] branches [q] back │
└─────────────────────────────────────────────────────────────────────────────────┘
```
**Filtry (z CLI):**
```bash
fxg status --filter dirty # tylko repo z niezcommitowanymi zmianami
fxg status --filter behind # tylko repo, które trzeba pullować
fxg status --filter ahead # tylko repo gotowe do pusha
fxg status --filter clean # tylko czyste i zsynchronizowane
fxg status --workspace work # tylko repo w danym workspace
fxg status my-api # bezpośrednio widok szczegółowy konkretnego repo
```
---
## `fxg sync`
Bez argumentów otwiera TUI — **3-etapowy flow**:
### Etap 1 — wybór repozytoriów
```
┌ Select repositories (Space = toggle, Enter = confirm) ──────────────────────┐
│ [ ] my-api main │
│ [x] my-frontend develop ✓ ← dirty │
│ [ ] shared-lib main │
│ [x] infra feat/k8s ✓ ← dirty │
│ │
│ [Space] toggle [a] select all [Enter] confirm [q] quit │
└──────────────────────────────────────────────────────────────────────────────┘
```
`Space` = toggle zaznaczenia, `a` = zaznacz wszystkie, `Enter` = przejdź dalej.
### Etap 2 — wybór akcji
```
┌ Action for: my-frontend, infra ────────────────────────────────────────────┐
│ Pull │
│ Commit │
│ ▶ Push │
│ New branch │
│ Create PR │
│ │
│ [↑/↓] navigate [Enter] execute [Esc] back │
└─────────────────────────────────────────────────────────────────────────────┘
```
### Etap 3 — wyniki
```
┌ Progress ──────────────────────────────────────────────────────────────────┐
│ ✓ my-frontend — push — Pushed develop │
│ ✓ infra — push — Pushed feat/k8s │
│ │
│ [q] quit │
└─────────────────────────────────────────────────────────────────────────────┘
```
### Sync bez TUI (skrypty / CI)
Każda operacja TUI ma odpowiednik w CLI. Przykłady:
```bash
fxg sync pull --workspace work # pull wszystkich repo w workspace
fxg sync pull --all # pull wszystkich repo w workspace_root
fxg sync commit -m "chore: sync" # commit wszystkich dirty repo (CWD)
fxg sync commit -m "chore: sync" --all # commit wszystkich dirty w workspace_root
fxg sync push --all # push wszystkich
fxg sync push --all -m "chore: sync" # najpierw commit dirty, potem push
fxg sync push --all --force-with-lease # force push (bezpieczny)
vulp list --dirty --json # co wymaga uwagi (JSON dla AI)
vulp status <repo> # szczegóły jednego repo
vulp sync --project X --action commit-push -m "chore: update"
vulp release <repo> --tag v1.2.0
vulp todo add "tytuł" && vulp todo done 3
vulp pr create --repo R --title T --head branch
vulp repo collab <repo> <user> --role push
vulp init nazwa --private # git init + repo na providerze + push
vulp stats --period 7d --json
vulp refresh # dociągnij meta/PR/issues z API
```
> **Uwaga:** `commit` używa tej samej wiadomości dla wszystkich repo. Indywidualne wiadomości per-repo możliwe przez TUI (opcja Commit) — TUI pyta o wiadomość przed wykonaniem commita.
Kontrakt: `--json` na komendach odczytu, stdout = wynik / stderr = postęp,
kody wyjścia `0` ok · `1` błąd · `2` złe użycie · `3` auth · `4` nie znaleziono.
**Szczegóły i przepisy: [docs/cli.md](docs/cli.md).**
---
## Konfiguracja
## `fxg init`
Bez flagi `--provider` uruchamia **wizard 7-krokowy**:
```
══════════════════════════════════════════
fxg — New Repository
══════════════════════════════════════════
Step 1/7 · Repository name: my-new-project
> walidacja: brak spacji, niepuste
Step 2/7 · Provider & Account:
> github/personal ← domyślny (zaznaczony)
gitlab/work
Step 3/7 · Visibility:
> private
public
internal
Step 4/7 · Tags (comma-separated):
> rust, cli, tools
Step 5/7 · Initial files: ← MultiSelect, domyślnie 4 pierwsze zaznaczone
[x] README.md
[x] .gitignore
[x] CHANGELOG.md
[x] .env.example
[ ] LICENSE ← opcja dostępna ale plik NIE jest generowany (TODO)
[ ] CONTRIBUTING.md ← j.w.
Template:
> node
rust ← dla Rusta generuje /target\nCargo.lock\n
python
blank
Step 6/7 · Extra branches (comma-separated):
> dev ← domyślnie
Step 7/7 · Add collaborators? (y/N)
> username: alice
role: write
> Add another? N
──────────────────────────────────────────
Proceed with creation? (Y/n)
```
**Co się dzieje po potwierdzeniu:**
```
✓ Created remote repo my-new-project (github/personal)
✓ Applied tags: rust, cli, tools
✓ mkdir ~/projects/my-new-project
✓ git init
✓ Created initial files
✓ Initial commit: "chore: init"
✓ git remote add origin git@github.com:user/my-new-project.git
✓ git push -u origin main
✓ Created branch: dev
✓ Added collaborator: alice (write)
Done in 2.3s · https://github.com/user/my-new-project
```
**Tryb bez wizarda** (name + provider podane → pomija wizard):
```bash
fxg init my-project --provider github
fxg init my-project --provider github --status public --tags rust,cli --branch develop
```
**Batch** — wiele repo naraz:
```bash
fxg init --batch "api,frontend,shared-lib" # lista inline
fxg init --batch repos.txt # plik, jedno repo per linia
```
W trybie batch: tworzy README, .gitignore, bez CHANGELOG i .env.example.
---
## `fxg workspace`
Grupy repozytoriów do zbiorczych operacji.
```bash
fxg workspace create backend
fxg workspace add backend api shared-lib
fxg workspace list
fxg workspace remove backend
```
```
Workspaces:
backend (2 repos) api, shared-lib
frontend (1 repo) my-frontend
```
Workspace używasz potem w innych komendach: `--workspace backend`.
---
## `fxg auth`
```bash
fxg auth # TUI z listą kont
fxg auth add --provider github --token ghp_xxx # dodaj konto
fxg auth add --provider gitlab --token glpat_xxx
fxg auth add --provider gitea --token xxx --url https://git.example.com
fxg auth add --provider github --token ghp_xxx --alias work # nazwany alias
fxg auth remove github/personal
fxg auth switch github/work # ustaw jako domyślne
fxg auth test # sprawdź domyślne konto
fxg auth test github/work
```
ID konta: `<provider>/<alias>`, np. `github/personal`, `gitea/selfhosted`.
Tokeny przechowywane w systemowym keychaine (Windows Credential Manager / macOS Keychain / Linux Secret Service) — nigdy w plikach plaintext.
---
## `fxg config`
Interaktywne TUI do edycji ustawień globalnych. Zapisywane do `~/.fxg/config.toml`.
```bash
fxg config
```
Plik konfiguracyjny (`~/.fxg/config.toml`):
```toml
workspace_root = "/home/user/projects"
data_dir = "/home/user/.fxg"
default_provider = "github"
default_branch = "main"
default_visibility = "private"
editor = "vim"
username = "your-name"
email = "you@example.com"
gitignore_template = "node"
readme_template = "heartbyte-default"
share_stats = false
timezone = "Europe/Warsaw"
vsc_data_dir = "/home/user/.fxg/vsc-data"
```
`vulp config` (interaktywnie) albo edycja `~/.vulp/config.toml`:
| Pole | Domyślnie | Opis |
|---|---|---|
| `workspace_root` | `~/projects` | Gdzie fxg szuka lokalnych repozytoriów |
| `data_dir` | `~/.fxg` | Dane fxg (konta, workspace'y) |
| `default_provider` | `github` | Provider gdy nie podasz `--provider` |
| `default_branch` | `main` | Domyślna gałąź nowych repo |
| `default_visibility` | `private` | Widoczność nowych repo |
| `editor` | `$EDITOR` lub `vim` | Edytor w interaktywnych flowach |
| `username` | _(puste)_ | Git username — używany w commitach |
| `email` | _(puste)_ | Git email — używany w commitach |
| `gitignore_template` | `node` | Template `.gitignore` (`node`, `rust`, `python`) |
| `timezone` | `Europe/Warsaw` | Strefa czasowa w statystykach |
| `vsc_data_dir` | `~/.fxg/vsc-data` | Dane VSCode time tracking |
---
| `workspace_root` | `~/projects` | katalog skanowany w poszukiwaniu rep |
| `workspace_groups` | `[]` | foldery-grupy, których dzieci są repami (np. `["clients", "opensource"]`) |
| `data_dir` | `~/.vulp` | dane vulpa |
| `default_provider` | `github` | provider bez `--provider` |
| `default_branch` / `default_visibility` | `main` / `private` | dla nowych rep |
| `editor` | `$EDITOR`/`vim` | do `o` / otwierania plików |
| `clipboard_cmd` | auto | komenda kopiowania (`wl-copy`, `xclip …`) |
| `username` / `email` | — | tożsamość gita |
## Pliki danych
```
~/.fxg/
├── config.toml # ustawienia globalne
├── accounts.toml # konta (bez tokenów — te są w keychaine)
├── workspaces.toml # definicje workspace'ów
└── vsc-data/ # dane śledzenia czasu z VSCode (dla fxg stats time)
~/.vulp/
├── config.toml # ustawienia
├── accounts.toml # konta (tokeny w keyringu / .tokens 0600)
├── projects.toml # projekty (grupy rep)
├── todos.toml # zadania
├── labels.toml # etykiety wyświetlania rep
├── bookmarks.toml / pins.toml
├── templates.toml # szablony nowych rep
├── meta_cache.toml # cache metadanych/PR/issues z API
└── activity.log # log akcji vulpa (JSONL)
```
---
## Providery
| Provider | wartość `--provider` | Uwagi |
| Provider | `--provider` | Zakres wsparcia |
|---|---|---|
| GitHub | `github` | github.com |
| GitLab | `gitlab` | gitlab.com |
| Gitea | `gitea` | self-hosted, wymaga `--url` |
| Forgejo | `forgejo` | fork Gitea, wymaga `--url` |
| GitHub | `github` | pełny (repo, PR, issues, release, collaboratorzy, search) |
| GitLab | `gitlab` | podstawowy (tworzenie rep, collaboratorzy) |
| Gitea/Forgejo | `gitea` | podstawowy (tworzenie rep, collaboratorzy; wymaga `--url`) |
Listy PR/issues są dziś GitHub-only — na innych providerach zakładki 5/6
będą puste (known limitation).
## Licencja
MIT — patrz [LICENSE](LICENSE).