|
| 1 | +# WorkshopForge - Kontext-Speicherpunkt |
| 2 | + |
| 3 | +**Datum**: 2025-10-16 |
| 4 | +**Status**: Installation erfolgreich, Package-Data-Fix committed |
| 5 | +**Repository**: https://github.com/cdds-ab/workshopforge (PUBLIC) |
| 6 | + |
| 7 | +## Aktueller Stand |
| 8 | + |
| 9 | +### ✅ Vollständig implementiert |
| 10 | + |
| 11 | +1. **Core Features** |
| 12 | + - Spec-Management (loader, validator mit JSON-Schema) |
| 13 | + - Deterministische Generierung (Jinja2 Templates) |
| 14 | + - Policy Engine (6 Default-Regeln) |
| 15 | + - AI Orchestrierung (plan/apply/check/explain) |
| 16 | + - Provider-System (Echo funktional, OpenAI/Anthropic Stubs) |
| 17 | + - CLI mit 8 Commands (Typer-based) |
| 18 | + |
| 19 | +2. **Toolchain** |
| 20 | + - uv-basierte Entwicklungsumgebung |
| 21 | + - Makefile für install/test/lint/format |
| 22 | + - GitHub Actions CI (alle Tests ✅) |
| 23 | + - curl-basiertes Install-Script |
| 24 | + |
| 25 | +3. **Dokumentation** |
| 26 | + - README.md (Deutsch, vollständig) |
| 27 | + - QUICKSTART.md (5-Minuten Start) |
| 28 | + - TESTING.md (Manuelle Tests) |
| 29 | + - PROJECT_SUMMARY.md (Übersicht) |
| 30 | + - FEATURES.md (Feature-Liste mit Roadmap) |
| 31 | + |
| 32 | +### 🔧 Letzter Fix |
| 33 | + |
| 34 | +**Problem**: Schemas und Templates wurden nicht mit installiert |
| 35 | +**Lösung**: |
| 36 | +- `MANIFEST.in` erstellt (schemas/*.json, templates/*.j2) |
| 37 | +- `pyproject.toml` um package-data ergänzt |
| 38 | +- Committed in: `655c8cc` |
| 39 | + |
| 40 | +### 📦 Installation |
| 41 | + |
| 42 | +```bash |
| 43 | +# One-liner Installation |
| 44 | +curl -sSL https://raw.githubusercontent.com/cdds-ab/workshopforge/main/install.sh | bash |
| 45 | + |
| 46 | +# Oder mit uv |
| 47 | +uv tool install git+https://github.com/cdds-ab/workshopforge.git |
| 48 | +``` |
| 49 | + |
| 50 | +### 🧪 Letzter Test-Status |
| 51 | + |
| 52 | +- ✅ CI Pipeline erfolgreich (3.10, 3.11, 3.12) |
| 53 | +- ✅ Linting mit ruff |
| 54 | +- ✅ Formatting mit black |
| 55 | +- ✅ Installation via install.sh |
| 56 | +- ⏳ Validate-Command nach Reinstall (noch zu testen) |
| 57 | + |
| 58 | +## Offene TODOs |
| 59 | + |
| 60 | +### Kritisch |
| 61 | +- [ ] **Verify Package Installation**: Testen ob schemas/templates nach Install verfügbar sind |
| 62 | +- [ ] **Full Workflow Test**: init → validate → generate → check durchlaufen |
| 63 | + |
| 64 | +### Nice-to-Have |
| 65 | +- [ ] OpenAI Provider implementieren |
| 66 | +- [ ] Anthropic Provider implementieren |
| 67 | +- [ ] Unit Tests (pytest) |
| 68 | +- [ ] PyPI Publish |
| 69 | + |
| 70 | +## Projekt-Struktur |
| 71 | + |
| 72 | +``` |
| 73 | +workshopforge/ |
| 74 | +├── forge/ # Python Package |
| 75 | +│ ├── cli.py # 8 CLI Commands |
| 76 | +│ ├── loader.py # Spec Loading |
| 77 | +│ ├── validator.py # JSON-Schema Validation |
| 78 | +│ ├── generator.py # Template Rendering |
| 79 | +│ ├── orchestrator.py # AI Pipeline |
| 80 | +│ ├── policies.py # 6 Policy Rules |
| 81 | +│ ├── prelude.py # Stable Context Gen |
| 82 | +│ ├── reporters.py # JSON/MD Reports |
| 83 | +│ ├── utils.py |
| 84 | +│ └── providers/ |
| 85 | +│ ├── base.py |
| 86 | +│ ├── echo.py # ✅ Functional |
| 87 | +│ ├── openai.py # Stub |
| 88 | +│ └── anthropic.py # Stub |
| 89 | +├── schemas/ # JSON Schemas |
| 90 | +│ ├── workshop.schema.json |
| 91 | +│ ├── modules.schema.json |
| 92 | +│ └── profile.schema.json |
| 93 | +├── templates/ # Jinja2 Templates |
| 94 | +│ ├── repo/ |
| 95 | +│ └── docs/ |
| 96 | +├── examples/minimal/ # Beispiel-Workshop |
| 97 | +├── .github/workflows/ci.yml # CI Pipeline |
| 98 | +├── install.sh # curl Installation |
| 99 | +├── MANIFEST.in # Package Data |
| 100 | +└── pyproject.toml # Package Config |
| 101 | +``` |
| 102 | + |
| 103 | +## Git Commits (letzte 5) |
| 104 | + |
| 105 | +1. `655c8cc` - Fix package data inclusion (schemas/templates) |
| 106 | +2. `9c27e3c` - Add curl-based installation script |
| 107 | +3. `78e05f8` - Fix CI: Use venv in integration job |
| 108 | +4. `cf96774` - Fix linting errors and update ruff config |
| 109 | +5. `f8e4535` - Add GitHub Actions CI workflow |
| 110 | + |
| 111 | +## Wichtige Befehle |
| 112 | + |
| 113 | +```bash |
| 114 | +# Entwicklung |
| 115 | +cd /home/fthiele/git/cdds/workshopforge |
| 116 | +make install # Install editable |
| 117 | +uv run workshopforge ... # Run from project |
| 118 | + |
| 119 | +# Global nutzen |
| 120 | +workshopforge init my-workshop |
| 121 | +workshopforge validate |
| 122 | +workshopforge generate --target out/instructor |
| 123 | +workshopforge ai check |
| 124 | +workshopforge promote out/instructor out/student |
| 125 | + |
| 126 | +# Tests |
| 127 | +make test |
| 128 | +make lint |
| 129 | +make format |
| 130 | +``` |
| 131 | + |
| 132 | +## Nächster Schritt |
| 133 | + |
| 134 | +Nach Reinstallation testen: |
| 135 | +```bash |
| 136 | +cd /tmp/demo-workshop |
| 137 | +workshopforge validate |
| 138 | +workshopforge generate --target out/instructor |
| 139 | +workshopforge ai check --target-dir out/instructor |
| 140 | +``` |
| 141 | + |
| 142 | +Erwartetes Ergebnis: Schemas sollten jetzt gefunden werden ✅ |
| 143 | + |
| 144 | +## Kontakt & Links |
| 145 | + |
| 146 | +- **Repository**: https://github.com/cdds-ab/workshopforge |
| 147 | +- **CI Status**: https://github.com/cdds-ab/workshopforge/actions |
| 148 | +- **Installation**: `curl -sSL https://raw.githubusercontent.com/cdds-ab/workshopforge/main/install.sh | bash` |
| 149 | + |
| 150 | +--- |
| 151 | + |
| 152 | +**Kontext gespeichert**: 2025-10-16 15:45 UTC |
| 153 | +**Letzter Commit**: 655c8cc |
| 154 | +**Branch**: main |
| 155 | +**Python**: 3.10+ |
| 156 | +**Status**: Production-ready (PoC) |
0 commit comments