wrd 0.1.41__tar.gz → 1.0.1__tar.gz

wrd-1.0.1/PKG-INFO

@@ -0,0 +1,420 @@
+Metadata-Version: 2.4
+Name: wrd
+Version: 1.0.1
+Summary: WRD (Word) - Narzędzie workflow dla Claude Code na Fedorze
+Home-page: https://github.com/username/wrd
+Author: Claude Code User
+Author-email: Tom Sapletta <info@softreck.dev>
+License: MIT
+Project-URL: homepage, https://github.com/username/wrd
+Project-URL: repository, https://github.com/username/wrd
+Project-URL: documentation, https://github.com/username/wrd#readme
+Project-URL: Bug Tracker, https://github.com/username/wrd/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=12.0.0
+Requires-Dist: pydantic>=1.9.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Requires-Dist: mypy>=0.950; extra == "dev"
+Provides-Extra: data
+Requires-Dist: pandas>=1.5.0; extra == "data"
+Requires-Dist: numpy>=1.24.0; extra == "data"
+Requires-Dist: matplotlib>=3.6.0; extra == "data"
+Provides-Extra: web
+Requires-Dist: fastapi>=0.95.0; extra == "web"
+Requires-Dist: uvicorn>=0.20.0; extra == "web"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# wrd
+WRD -> WRonai Develoment - (word)
+
+# 🚀 Kompletna instrukcja instalacji WRD na Fedorze
+
+## Krok 1: Przygotowanie środowiska Fedora
+
+```bash
+# Uruchom skrypt konfiguracji środowiska
+curl -fsSL https://raw.githubusercontent.com/username/wrd/main/setup-fedora.sh | bash
+
+# LUB pobierz i uruchom manualnie:
+wget https://raw.githubusercontent.com/username/wrd/main/setup-fedora.sh
+chmod +x setup-fedora.sh
+./setup-fedora.sh
+```
+
+Po zakończeniu skryptu:
+```bash
+# Zaloguj się ponownie lub odśwież bashrc
+source ~/.bashrc
+
+# Sprawdź czy aliasy działają
+cc-workspace
+```
+
+## Krok 2: Instalacja paczki WRD
+
+### Metoda A: Instalacja z kodu źródłowego (zalecana)
+
+```bash
+# Przejdź do workspace
+cc-workspace
+
+# Sklonuj repozytorium WRD
+git clone https://github.com/username/wrd.git
+cd wrd
+
+# Utwórz dedykowane środowisko wirtualne dla WRD
+python3 -m venv ~/.wrd-env
+source ~/.wrd-env/bin/activate
+
+# Instalacja w trybie deweloperskim
+pip install -e .
+
+# Dodaj ścieżkę do PATH (w ~/.bashrc)
+echo 'export PATH="$HOME/.wrd-env/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Metoda B: Instalacja przez pip (gdy będzie dostępne)
+
+```bash
+pip install wrd
+```
+
+### Metoda C: Budowanie z źródła
+
+```bash
+# Pobierz wszystkie pliki WRD
+mkdir -p ~/wrd-build
+cd ~/wrd-build
+
+# Skopiuj kod główny (plik wrd.py)
+# Skopiuj pliki setup (setup.py, pyproject.toml, etc.)
+# [Pliki są dostępne w artefaktach Claude]
+
+# Instalacja
+python3 -m venv venv
+source venv/bin/activate
+pip install --upgrade pip setuptools wheel
+pip install -e .
+```
+
+## Krok 3: Konfiguracja WRD
+
+```bash
+# Pierwszy start - automatyczna konfiguracja
+wrd status
+
+# Sprawdź czy wszystko działa
+wrd list
+
+# Utwórz pierwszy projekt testowy
+wrd create test-project --description "Testowy projekt WRD"
+
+# Sprawdź strukturę
+ls -la ~/claude-projects/test-project/
+```
+
+## Krok 4: Integracja z Claude Code
+
+### Instalacja Claude Code
+
+1. **Zaloguj się na https://claude.ai**
+2. **Przejdź do ustawień → API**
+3. **Wygeneruj klucz API** (wymaga Claude Pro)
+4. **Pobierz Claude Code CLI** według oficjalnej dokumentacji Anthropic
+
+### Konfiguracja
+
+```bash
+# Ustaw klucz API (przykład)
+export ANTHROPIC_API_KEY="your-api-key-here"
+
+# Dodaj do ~/.bashrc dla trwałości
+echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bashrc
+
+# Sprawdź instalację Claude Code
+claude-code --version
+```
+
+## Krok 5: Workflow setup
+
+### Tworzenie pierwszego prawdziwego projektu
+
+```bash
+# Utwórz projekt
+wrd create moj-pierwszy-ai-projekt --type python --description "Pierwszy projekt z Claude Code"
+
+# Przejdź do projektu
+cd ~/claude-projects/moj-pierwszy-ai-projekt
+
+# Aktywuj środowisko Python
+source venv/bin/activate
+
+# Zainicjalizuj git
+git init
+git add .
+git commit -m "Initial commit via WRD"
+
+# Edytuj CLAUDE.md - dodaj specyfikację projektu
+nano CLAUDE.md
+
+# Zacznij pracę z Claude Code
+claude-code init  # lub odpowiednia komenda
+```
+
+### Testowanie workflow
+
+```bash
+# Test 1: Tworzenie kodu
+echo "print('Hello from WRD!')" > src/main.py
+
+# Test 2: Aktualizacja postępu
+wrd progress moj-pierwszy-ai-projekt "Dodano główny plik aplikacji"
+
+# Test 3: Automatyczny commit
+wrd commit moj-pierwszy-ai-projekt --message "Dodanie main.py"
+
+# Test 4: Backup
+wrd backup
+
+# Test 5: Status
+wrd status
+```
+
+## Krok 6: Integracja z innymi narzędziami
+
+### Cursor IDE
+
+```bash
+# Jeśli masz Cursor zainstalowany
+cursor ~/claude-projects/moj-pierwszy-ai-projekt
+```
+
+### Gemini CLI (opcjonalnie)
+
+```bash
+# Instalacja Gemini CLI według dokumentacji Google
+# Konfiguracja w WRD
+nano ~/.wrd/config.json
+# Ustaw "gemini_cli": {"enabled": true, "priority": 2}
+```
+
+### SSH dla zdalnej pracy
+
+```bash
+# Sprawdź czy SSH działa
+sudo systemctl status sshd
+
+# Test połączenia z telefonu/innego urządzenia
+ssh username@your-fedora-ip
+
+# Na zdalnym urządzeniu:
+cc-workspace
+wrd status
+```
+
+## Krok 7: Zaawansowana konfiguracja
+
+### Aliasy i funkcje pomocnicze
+
+Dodaj do `~/.bashrc`:
+
+```bash
+# WRD shortcuts
+alias w='wrd'
+alias ws='wrd status'
+alias wl='wrd list'
+alias wp='wrd progress'
+alias wb='wrd backup'
+
+# Claude Code shortcuts
+alias cc='claude-code'
+alias ccd='claude-code dev'
+alias ccb='claude-code build'
+
+# Combined workflow functions
+wcc-start() {
+    wrd create "$1" --type "${2:-python}" --description "${3:-AI project}"
+    cd ~/claude-projects/"$1"
+    source venv/bin/activate
+    echo "Projekt $1 gotowy. Uruchom: claude-code dev"
+}
+
+wcc-session() {
+    cd ~/claude-projects/"$1" || { echo "Projekt nie istnieje"; return 1; }
+    source venv/bin/activate
+    echo "Sesja $1 uruchomiona. Czas: $(date)"
+    wrd progress "$1" "Rozpoczęcie sesji $(date '+%H:%M')"
+}
+```
+
+### Automatyczne backup
+
+```bash
+# Dodaj cron job dla automatycznych backup (opcjonalnie)
+(crontab -l 2>/dev/null; echo "0 */6 * * * /home/$USER/.wrd-env/bin/wrd backup > /dev/null 2>&1") | crontab -
+```
+
+### Monitoring sesji
+
+```bash
+# Skrypt do monitorowania czasu sesji (5h limit Claude Code)
+cat > ~/claude-projects/scripts/session-monitor.sh << 'EOF'
+#!/bin/bash
+echo "⏰ Monitor sesji Claude Code (limit 5h)"
+start_time=$(date +%s)
+while true; do
+    current_time=$(date +%s)
+    elapsed=$((current_time - start_time))
+    hours=$((elapsed / 3600))
+    minutes=$(((elapsed % 3600) / 60))
+    
+    if [ $hours -ge 4 ]; then
+        echo "⚠️  UWAGA: Zbliżasz się do limitu! Czas: ${hours}h ${minutes}m"
+    fi
+    
+    if [ $hours -ge 5 ]; then
+        echo "🛑 LIApache OSIĄGNIĘTY! Reset za $(date -d '+5 hours' '+%H:%M')"
+        break
+    fi
+    
+    sleep 300  # Check every 5 minutes
+done
+EOF
+
+chmod +x ~/claude-projects/scripts/session-monitor.sh
+```
+
+## Krok 8: Rozwiązywanie problemów
+
+### Problem: Brak uprawnień Docker
+
+```bash
+sudo usermod -aG docker $USER
+newgrp docker
+# lub zaloguj się ponownie
+```
+
+### Problem: Python venv nie działa
+
+```bash
+# Reinstalacja python3-venv
+sudo dnf reinstall python3-venv
+# Usuń stare środowisko
+rm -rf ~/.wrd-env
+# Stwórz nowe
+python3 -m venv ~/.wrd-env
+source ~/.wrd-env/bin/activate
+pip install -e ~/wrd-build/
+```
+
+### Problem: Claude Code nie działa
+
+```bash
+# Sprawdź klucz API
+echo $ANTHROPIC_API_KEY
+
+# Sprawdź połączenie internetowe
+curl -s https://api.anthropic.com/v1/messages
+
+# Sprawdź wersję
+claude-code --version
+```
+
+### Problem: Brak miejsca na dysku
+
+```bash
+# Wyczyść stare backup
+wrd backup  # Nowy backup
+rm ~/claude-projects/archive/backup-*.tar.gz.old
+
+# Wyczyść cache pip
+pip cache purge
+
+# Wyczyść Docker (jeśli używasz)
+docker system prune -a
+```
+
+## Krok 9: Pierwsze prawdziwe użycie
+
+### Scenariusz: Projekt w 48h (konkurs)
+
+```bash
+# Dzień 1 - Setup (wieczór)
+wcc-start konkurs-super-app fastapi "Aplikacja konkursowa - API + Frontend"
+
+# Otwórz Claude.ai w przeglądarce
+# Stwórz szczegółową specyfikację
+# Skopiuj do CLAUDE.md
+
+# Dzień 2 - Sesja #1 (rano, 5h)
+wcc-session konkurs-super-app
+# Uruchom session-monitor w drugim terminalu
+~/claude-projects/scripts/session-monitor.sh &
+# Rozpocznij pracę z Claude Code
+claude-code dev
+
+# Po sesji
+wrd progress konkurs-super-app "Sesja 1 zakończona - podstawowa struktura API"
+wrd commit konkurs-super-app "Implementacja podstawowego API"
+
+# Dzień 2 - Sesja #2 (po przerwie, 3h)
+# Podobnie jak wyżej...
+
+# Finalizacja
+wrd progress konkurs-super-app "Aplikacja gotowa do zgłoszenia!"
+wrd backup
+```
+
+### Scenariusz: Długoterminowe narzędzie
+
+```bash
+# Tydzień 1
+wcc-start moje-cli-tool python "Autorskie narzędzie CLI"
+# Rozwój iteracyjny...
+
+# Tydzień 2  
+wrd progress moje-cli-tool "Tydzień 2 - dodano funkcje X, Y, Z"
+
+# Tydzień 3
+wrd progress moje-cli-tool "Tydzień 3 - optymalizacja i testy"
+```
+
+## 🎉 Gratulacje!
+
+Masz teraz w pełni skonfigurowane środowisko WRD na Fedorze z integracją Claude Code. 
+
+**Następne kroki:**
+1. Stwórz pierwszy prawdziwy projekt
+2. Przetestuj workflow 5-godzinnych sesji
+3. Rozwijaj własne techniki i flow
+4. Dokumentuj wszystko w CLAUDE.md
+5. Dziel się doświadczeniami z community!
+
+**Przydatne komendy do zapamiętania:**
+- `wrd status` - sprawdź status
+- `wcc-start nazwa typ` - nowy projekt + sesja
+- `wrd progress projekt "opis"` - zaktualizuj postęp  
+- `wrd backup` - zabezpiecz pracę
+