From 086eecd1908a48ac0ad2b7271d5eac1d40f9ac67bb9891eee524b974b7d7c76b Mon Sep 17 00:00:00 2001 From: gc-dev-afjd Date: Sun, 12 Jul 2026 19:41:59 +0200 Subject: [PATCH] feat: Add diary entry for 2026-07-12 covering GCC migration, license change to Apache-2.0, and housekeeping updates --- diary/2026-07-11.md | 54 ------------------------------------- diary/2026-07-12.md | 66 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 66 insertions(+), 54 deletions(-) create mode 100644 diary/2026-07-12.md diff --git a/diary/2026-07-11.md b/diary/2026-07-11.md index cb95c1b..1eaf6be 100644 --- a/diary/2026-07-11.md +++ b/diary/2026-07-11.md @@ -13,57 +13,3 @@ - `init`/`serve` (HttpListener) Subcommands; `webstatic.example/` KMU-Vorlage. - `install.sh` (→ `/opt/GitCover/webstatic`), `LICENSE.md` (MIT), AGENTS/MEMORY/SKILLS/.hermes, plans/00. - Verifiziert: `dotnet build -c Release` ✓; Beispiel baut de/en/vi mit i18n, Pagefind, Mermaid ✓. - -## 2026-07-12 — Praxiseinsatz GCC + Tool-Erkenntnisse - -### Realer Einsatz: 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 - `
` (`.eyebrow--green` + `

`) auf - **allen** Content-Seiten vorangestellt. -- `pagefind: false` in `webstatic.json` → Such-Toggle im Chrome ist dann - nicht funktional (bewusst, da GCC keinen Volltextindex braucht). - -### Wichtige Tool-Erkenntnis (für docs/plans) -- webstatic stellt KEIN `{{ title }}`/`{{ eyebrow }}`-**Seitentoken** bereit. - Frontmatter-`title`/`eyebrow` speisen nur ``/Meta (SEO) und die - Navigations-Labels. Jede Seite muss Eyebrow + Titel **selbst im Body** tragen - (wie gcbok es in der Hero-/`01-`-Datei tut) — sonst fehlen die Überschriften - auf der generierten Seite. Das ist Design-Intent, kein Bug. - -### Installation: per-user ist die aktive -- Aktive Installation ist die **per-user Betatester-Install** unter - `~/.local/share/GitCover/webstatic` (Launcher `~/.local/bin/webstatic`), - **nicht** `/opt/GitCover/webstatic` (existiert nicht). -- Stand lokal `7065c07`, Remote `89f720a` → Update via `webstatic update` verfügbar. -- `plan 01` Fix 1 („veraltete `/opt`-Binary") ist damit gegenstandslos; die - übrigen Fixes 2–7 sind bereits im Code umgesetzt (Help/Version vor Build, - Content-Check, Artefakte aus Git, Default-Envs = `development`/`staging`/`deploy`, - `tests/README.md` vorhanden). - -### Status -- Version `1.0.0.0`. Subcommands vorhanden: `build`, `serve`, `init`, `translate`, `status`. -- Environments im Code: `development` (foldet `--work`/`--preview`/`--review`), - `staging`, `deploy`. `plan 00` §6/§7 noch mit `work`/`review` veraltet — korrigiert. - -### 2026-07-12 (später) — 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`** (kanonischer Dateiname im Repo/Remote; MIT-Text durch - vollständigen Apache-2.0-Text ersetzt). -- Neue **`NOTICE`** (Repo-Root): Attribution Dritt-Komponenten `Markdig` (BSD-2), - `YamlDotNet` (MIT). -- `csproj`: `PackageLicenseExpression` = `Apache-2.0`; Description „(OSS, Apache-2.0)". -- Kompakter **SPDX-Header** (`// Copyright … // SPDX-License-Identifier: Apache-2.0`) - in alle 12 `.cs`-Dateien eingefügt (Build verifiziert, 0 Warnungen/Fehler). -- Wiederverwendbarer Baustein + Rationale in `docs/license-header.md`. -- Docs angepasst: `README.md`, `AGENTS.md`, `plans/00` §12 + Repo-Struktur, - `.hermes/skills.md`, `webstatic.example`-Inhalte, Tagebuch. -- **Hinweis Dev-Repo:** `/mnt/brx5/work/OSS/build_webstatic` ist ein eigenständiger - Checkout (Remote `git.gitcover.org:OSS/build_webstatic.git`). Dort ist `LICENSE.md` - noch MIT — bei Gelegenheit dort ebenfalls auf Apache-2.0 + `NOTICE` syncen, sonst - würde ein Pull den Wechsel im per-user-Clone überschreiben. diff --git a/diary/2026-07-12.md b/diary/2026-07-12.md new file mode 100644 index 0000000..82a7847 --- /dev/null +++ b/diary/2026-07-12.md @@ -0,0 +1,66 @@ +# 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.