build_webstatic/diary/2026-07-12.md

# Tagebuch 2026-07-12 — GitCover.WebStaticBuilder

## 2026-07-12 — Praxiseinsatz GCC, Lizenzwechsel & Housekeeping

### 1. Praxiseinsatz: gcc.gitcover.org auf webstatic migriert
- Zweite GitCover-Site (nach GCBoK) erfolgreich mit der `webstatic`-CLI gebaut —
  validiert den Tool-Workflow (Phase 3/4) unter realen Bedingungen.
- Migration: Python-Build (`build/`, `build-env/`, `*.py`) vollständig entfernt;
  Multi-Page-Modell, `*.de.md` autoritativ (DE-Quelle explizit suffixiert), Banner
  (`00-banner.*.md`) 1:1 aus gcbok übernommen, Eyebrow + Titel als
  `<div class="page-header">` (`.eyebrow--green` + `<h1 class="page-title">`) auf
  **allen** Content-Seiten vorangestellt.
- `pagefind: false` in `webstatic.json` → Such-Toggle im Chrome dann nicht funktional
  (bewusst, da GCC keinen Volltextindex braucht).

### 2. Wichtige Tool-Erkenntnis (für docs/plans)
- webstatic stellt KEIN `{{ title }}`/`{{ eyebrow }}`-**Seitentoken** bereit.
  Frontmatter-`title`/`eyebrow` speisen nur `<title>`/Meta (SEO) und die
  Navigations-Labels. Jede Seite muss Eyebrow + Titel **selbst im Body** tragen
  (wie gcbok es in der Hero-/`01-`-Datei tut) — Design-Intent, kein Bug.
- Aktive Installation ist die **per-user Betatester-Install** unter
  `~/.local/share/GitCover/webstatic` (Launcher `~/.local/bin/webstatic`),
  **nicht** `/opt/GitCover/webstatic` (existiert nicht). `plan 01` Fix 1 damit
  gegenstandslos; Fixes 2–7 bereits im Code umgesetzt.

### 3. Lizenzwechsel MIT → Apache-2.0
- **Grund:** Builder implementiert an vielen Stellen patentrelevante Logik; Apache-2.0
  bietet explizite **Patentlizenz (§3)** + **Retorsionsklausel** (Patentlizenz erlischt
  bei Patentklage) — Schutz gegen Patent-Trolle, den MIT nicht leistet.
- `LICENSE` → **`LICENSE.md`** (Apache-2.0-Volltext; kanonischer Dateiname im Repo/Remote).
- Neue **`NOTICE`** (Repo-Root): Attribution `Markdig` (BSD-2), `YamlDotNet` (MIT).
- `csproj`: `PackageLicenseExpression = Apache-2.0`; Description „(OSS, Apache-2.0)".
- Kompakter **SPDX-Header** in alle 12 `.cs`-Dateien
  (`// Copyright … // Author … // SPDX-License-Identifier: Apache-2.0`).
- Wiederverwendbarer Baustein + Rationale in `docs/license-header.md`.
- Docs aktualisiert: `README.md`, `AGENTS.md`, `plans/00` §12 + Repo-Struktur,
  `.hermes/skills.md`, `webstatic.example/*`.

### 4. Author & Urheberschaft (Korrektur im Tagesverlauf)
- Erst `AFJD` als Author gesetzt, dann korrigiert:
  - Quelldatei-Header `Author:` nennt den **Klarnamen Axel Druschel** (Urheber).
  - **Git-Identität (commit author)** = Handle **`gc-dev-afjd`** /
    **`axel.druschel@gitcover.de`** (nicht der Klarname). Im Repo via
    `git config user.name/user.email` vorkonfiguriert, damit künftige Commits stimmen.
- `AGENTS.md` dokumentiert die Trennung (Klarname im Header vs. Git-Handle).

### 5. Copyright-Inhaber formalisiert
- Rechteinhaber heißt zwingend **GitCover Commons gUG (haftungsbeschränkt)**.
  Überall angepasst: `LICENSE.md` (Appendix-Platzhalter mit `2026` + vollem Namen
  befüllt), `NOTICE`, alle 12 `.cs`-Header, `AGENTS.md`, `docs/license-header.md`.

### 6. Push-Konflikt `LICENSE.md` aufgelöst
- **add/add-Konflikt:** lokal (Commit `eb098f9` „Change license from MIT to Apache-2.0")
  und remote (`89f720a`) hatten beide `LICENSE.md` neu hinzugefügt → keine
  automatische Merge-Möglichkeit. Übrige Dateien waren sauber gemergt.
- Auflösung: `git checkout --ours LICENSE.md` (Apache-Version behalten,
  Konfliktmarker entfernt) → `git add` → Merge abgeschlossen
  (`0d121b4`, Author `gc-dev-afjd`) → `git push origin main` erfolgreich
  (`89f720a..0d121b4`). Danach lokal = remote, keine Divergenz.

### Status
- Version `1.0.0.0`. Lizenz (Apache-2.0 + NOTICE), Author/Urheberschaft,
  Copyright-Inhaber und Dokumentation (diary/plans/docs) konsistent.
- **Offen:** Dev-Repo `/mnt/brx5/work/OSS/build_webstatic` (eigener Checkout,
  gleicher Remote) hat lokal noch MIT-`LICENSE.md`; bei Gelegenheit via Pull des
  per-user-Clones auf Apache-2.0 + `NOTICE` syncen.