docs(history): session 2026-06-10 portability + update PROJECT_CONTEXT
Vollstaendiges Session-Log (WP1-7,11,12) und aktualisierter PROJECT_CONTEXT: neue erledigte Aufgaben, offene Punkte (WP8/9/10 zurueckgestellt, totes Repo-Remote), Designentscheidungen und Pfade.
This commit is contained in:
Conrad Schulz
parent
afd5b38ca9
commit
be5ff0fda3
2 changed files with 152 additions and 2 deletions
|
|
@ -0,0 +1,138 @@
|
|||
# Portabilität & Universalität des Setups – 2026-06-10
|
||||
|
||||
## Aufgabe / Ziel
|
||||
|
||||
Das `rd13_copilot_setup` portabler und universeller machen. Aus der Analyse in
|
||||
`memory.md` wurden 12 Arbeitspakete (WP1–WP12) abgeleitet und einzeln zur
|
||||
Umsetzung freigegeben. **Umgesetzt: WP1–WP7, WP11, WP12.** Ausgeschlossen
|
||||
(auf Wunsch, separat zu besprechen): **WP8, WP9** (settings.json) und **WP10**
|
||||
(Vendor-Naming).
|
||||
|
||||
## Verlauf
|
||||
|
||||
### Prompt 1
|
||||
Nutzer die Memory datei um dieses Repo portabler und universeller zu machen. Identifiziere alle möglichen arbeitsschritte und lass uns einzeln durchgehen was wir implementieren und was nicht.
|
||||
|
||||
### Antwort 1
|
||||
`memory.md` und das gesamte Repo analysiert (Skripte, settings.json, Prompts,
|
||||
git-templates/hooks). Daraus 12 Arbeitspakete abgeleitet und gruppiert:
|
||||
- Sichere Fixes: WP1 (bootstrap.fish `$HOME` + Parität), WP2 (Zone.Identifier + .gitignore)
|
||||
- Parametrisierung: WP3 (Remote konfigurierbar), WP4 (VS-Code-Pfad-Erkennung), WP5 (Offline-Modus)
|
||||
- Invasivität: WP6 (Opt-in `git init-copilot`), WP7 (post-merge opt-in)
|
||||
- settings.json: WP8/WP9
|
||||
- Universalität: WP10 (Vendor-Namen), WP11 (CI), WP12 (Doku)
|
||||
|
||||
Triage-Fragen gestellt (`vscode_askQuestions`), vom Nutzer abgebrochen.
|
||||
|
||||
### Prompt 2
|
||||
bevor ich die fragen beantworte, was sind diese Zone Identifier?
|
||||
|
||||
### Antwort 2
|
||||
Erklärt: `*:Zone.Identifier` sind Windows-Mark-of-the-Web-Metadaten (NTFS
|
||||
Alternate Data Streams, `ZoneId=3` = aus dem Internet). Beim Lesen über den
|
||||
WSL/Linux-Layer werden sie als separate Dateien sichtbar. Reiner Download-Müll,
|
||||
gehören weder committet noch deployt → WP2: löschen + Ignore-Pattern.
|
||||
|
||||
### Prompt 3
|
||||
ok alles implementieren aber nicht WP8,WP8 und WP10. Diese WPs will ich nicht implementiert haben und danach nochmal mit dir sprechen.
|
||||
|
||||
### Antwort 3
|
||||
Scope bestätigt: WP1,2,3,4,5,6,7,11,12 umsetzen; WP8+WP9 (settings.json) und
|
||||
WP10 (Vendor-Naming) ausgeschlossen. Finalen Phasenplan erstellt (Phase 1
|
||||
Hygiene/Bug → Phase 2 Skript-Portabilität → Phase 3 CI → Phase 4 Doku) und in
|
||||
Session-Memory gesichert.
|
||||
|
||||
### Prompt 4
|
||||
Start implementation
|
||||
|
||||
### Antwort 4
|
||||
Repo-Zustand geprüft – zu diesem Zeitpunkt **kein `.git`** (entpackte
|
||||
ZIP-Kopie). Implementierung gestoppt, da kein Versionierungsziel.
|
||||
|
||||
### Prompt 5
|
||||
ok lets then stop right hiere.
|
||||
|
||||
### Antwort 5
|
||||
Gestoppt, nichts geändert. Befund (kein git-Repo) in Session-Memory festgehalten.
|
||||
|
||||
### Prompt 6
|
||||
ok jetzt nochmal implementieren im richtigen repo!
|
||||
|
||||
### Antwort 6
|
||||
Echtes Repo gefunden und verifiziert (`~/workspace/ai-tooling/rd13_copilot_setup`
|
||||
ist jetzt git-Repo, `master`→`origin/master`, volle History, HEAD `114bb5b`).
|
||||
Anschließend alle freigegebenen WPs in 4 Phasen umgesetzt und je Phase committet.
|
||||
|
||||
**Phase 1 – Hygiene & Bug (Commit `80b6248`)**
|
||||
- WP2: `.gitignore` um `*:Zone.Identifier` ergänzt (Dateien existieren im echten Checkout nicht mehr).
|
||||
- WP1: `copilot-bootstrap.fish` neu geschrieben – `/home/rd13server/` → `$HOME`, volle Parität zur `.sh` (`--with-update-hook`, `data/`, `history/`, `docs/`, Hooks, `.gitignore`-Append inkl. Zone.Identifier).
|
||||
- Verifikation:
|
||||
```sh
|
||||
fish -n scripts/copilot-bootstrap.fish # OK
|
||||
# Smoke-Test gegen /tmp-Repo + Fake-Template: alle Dateien erzeugt, idempotent
|
||||
```
|
||||
|
||||
**Phase 2a – copilot-update.{sh,fish} (Commit `5890bff`)**
|
||||
- WP3: Remote-URLs aus `COPILOT_SETUP_REMOTE_SSH/_HTTP` (env) oder Config-Datei
|
||||
`~/.config/copilot-setup/config` (sh sourcet, fish parst `KEY="value"`). Env hat Vorrang.
|
||||
- WP5: Offline-Betrieb (lokaler Klon ohne `.git` nutzbar; Pull-Fehler nutzt Cache);
|
||||
fehlende/unerreichbare Quelle → graceful `exit 0` statt `exit 1`.
|
||||
- WP4: `detect_vscode_user_dir` (Server/Insiders/VSCodium/Cursor/Flatpak/macOS/Windows-WSL).
|
||||
- Verifikation (sh + fish, je 3 Szenarien):
|
||||
```
|
||||
TEST A: no remote, no cache -> graceful exit 0
|
||||
TEST B: offline local source -> templates kopiert, exit 0
|
||||
TEST C: config-file unreachable-> graceful exit 0
|
||||
```
|
||||
|
||||
**Phase 2b – deploy.{sh,fish} (Commit `9e14a5f`)**
|
||||
- WP6: kein globales `init.templateDir`/`git init`-Override mehr; Opt-in-Alias
|
||||
`git init-copilot`; frühere invasive Werte werden gezielt entfernt (guarded unset).
|
||||
- WP7: post-merge Auto-Deploy im Setup-Repo nur mit `--with-self-update-hook`.
|
||||
- WP4: gleiche `detect_vscode_user_dir`; `${USER:-}` gegen `set -u` abgesichert.
|
||||
- Verifikation (isoliertes HOME, kein Eingriff ins echte Repo):
|
||||
```
|
||||
deploy.sh/.fish ohne Flag -> kein alias.init, init-copilot gesetzt, kein init.templateDir, Hook gated
|
||||
--with-self-update-hook (Temp-Repo) -> post-merge hook geschrieben
|
||||
--bogus -> exit 2
|
||||
```
|
||||
|
||||
**Phase 3 – CI (Commit `deca872`)**
|
||||
- WP11: `.github/workflows/ci.yml` (shellcheck + `fish -n` + `scripts/selftest.sh`).
|
||||
- `scripts/selftest.sh`: Bootstrap-Dry-Run sh+fish gegen isoliertes Fake-HOME mit Assertions.
|
||||
- `copilot-bootstrap.sh` propagiert nun ebenfalls `*:Zone.Identifier` (Parität).
|
||||
- shellcheck-Direktiven für bewusste Muster (SC2016, SC1090, SC2043).
|
||||
- Verifikation:
|
||||
```sh
|
||||
/tmp/shellcheck scripts/*.sh git-templates/hooks/* # exit 0
|
||||
sh scripts/selftest.sh # PASS sh + PASS fish
|
||||
python3 -c "import yaml; yaml.safe_load(open('.github/workflows/ci.yml'))" # YAML OK
|
||||
```
|
||||
|
||||
**Phase 4 – Doku (Commit `afd5b38`)**
|
||||
- WP12: README + USER + ADMIN + MAINTAINER aktualisiert (Env/Config, Offline,
|
||||
`init-copilot`, `--with-self-update-hook`, neue Editionen). Tote IP
|
||||
`192.168.178.6` aus der Doku entfernt. MAINTAINER: CI/selftest + neue Fallstricke.
|
||||
|
||||
## Ergebnis
|
||||
|
||||
- 5 Commits (`80b6248`, `5890bff`, `9e14a5f`, `deca872`, `afd5b38`) + dieser History-Commit.
|
||||
- Alle Skripte shellcheck-sauber und `fish -n`-sauber; selftest grün (sh+fish).
|
||||
- Keine hartkodierte Infrastruktur mehr in Skripten; Standard-`git init`/`clone` unberührt.
|
||||
|
||||
## Entscheidungen
|
||||
|
||||
- `detect_vscode_user_dir` bewusst in jedem Skript dupliziert (standalone aus
|
||||
`~/.local/bin` → keine sourcebare Lib).
|
||||
- Remote-Präzedenz: env > Config-Datei; keine Quelle = graceful skip (exit 0).
|
||||
- `init.templateDir`/`alias.init` werden nur entfernt, wenn sie auf unsere
|
||||
Templates/Bootstrap zeigen (kein Eingriff in fremde Konfiguration).
|
||||
- fish liest dieselbe sh-Config-Datei per Parser (sourcet sie nicht).
|
||||
|
||||
## Offene Punkte
|
||||
|
||||
- **WP8/WP9** (settings.json: Absolute-Mode-Widerspruch entschärfen, non-destruktiver
|
||||
Merge) – auf Wunsch zurückgestellt, separat besprechen.
|
||||
- **WP10** (Vendor-neutrale Namen `rd13`/`cschulz`/`rd13server`) – zurückgestellt.
|
||||
- Das **Remote dieses Repos** zeigt weiterhin auf die tote IP
|
||||
`ssh://git@192.168.178.6:2222/...` (bewusst nicht angefasst – separate Entscheidung).
|
||||
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
## Aktueller Projektstatus
|
||||
|
||||
**Letzte Aktualisierung:** 2026-06-04 – Bekannte Fallstricke in copilot-instructions.md + Leerzeilen-Fix copilot-update
|
||||
**Letzte Aktualisierung:** 2026-06-10 – Portabilität & Universalität (WP1–7, 11, 12): konfigurierbares/offline Remote, Opt-in `git init-copilot`, CI + selftest, Doku
|
||||
**Phase:** Produktion / stabil – wird bei Bedarf erweitert
|
||||
|
||||
---
|
||||
|
|
@ -29,6 +29,11 @@ Quality Gate aus.
|
|||
|
||||
| Datum | Aufgabe | Ergebnis | Entscheidungen |
|
||||
|---|---|---|---|
|
||||
| 2026-06-10 | WP12 Doku-Portabilität | README/USER/ADMIN/MAINTAINER: env/config, init-copilot, offline; tote IP raus | `afd5b38` |
|
||||
| 2026-06-10 | WP11 CI + selftest | `.github/workflows/ci.yml` (shellcheck+fish -n+selftest), `scripts/selftest.sh` | `deca872` |
|
||||
| 2026-06-10 | WP6/7/4 deploy nicht-invasiv | kein globales init.templateDir/init-Alias; Opt-in init-copilot; post-merge nur mit Flag | `9e14a5f` |
|
||||
| 2026-06-10 | WP3/5/4 update konfigurierbar/offline | Remote via env/config, graceful skip, portable Editor-Erkennung | `5890bff` |
|
||||
| 2026-06-10 | WP1/2 bootstrap.fish Parität + ADS-Ignore | `$HOME` statt `/home/rd13server`; `*:Zone.Identifier` ignoriert | `80b6248` |
|
||||
| 2026-06-02 | Konsistenzprüfung: alle --no-verify Referenzen entfernt | `docs/USER.md`, `docs/ADMIN.md`, `docs/MAINTAINER.md`, beide `copilot-instructions.md`, `pre-commit` Check-Nummerierung `[1/3]→[1/4]` | Opt-outs (.copilot-no-tests/.copilot-no-docs) als Ersatz für --no-verify in Doku |
|
||||
| 2026-06-03 | Check 6 von Block → Warnung umgestellt | `git-templates/hooks/pre-commit` | Zu grob: heute-Prüfung blockiert Folgecommits; besser: Warnung wenn keine `*_session.md` im aktuellen Commit gestaged |
|
||||
| 2026-06-02 | pre-commit Check 6 – Session-Datei erforderlich | `git-templates/hooks/pre-commit` | Wurde als Block implementiert, am Folgetag als zu grob erkannt |
|
||||
|
|
@ -46,6 +51,9 @@ Quality Gate aus.
|
|||
- [ ] `docs/requirements/REQUIREMENTS.md` für dieses Setup-Repo selbst anlegen (aktuell nur Template in git-templates)
|
||||
- [ ] `.github/copilot-instructions.md` TODO-Felder ausfüllen (Stack, Architecture, NFRs dieses Repos)
|
||||
- [ ] Bei Änderungen an `git-templates/` immer `deploy.sh` neu ausführen (oder `git copilot-update` testen)
|
||||
- [ ] **WP8/WP9** (settings.json: Absolute-Mode-Widerspruch entschärfen + non-destruktiver Merge) – zurückgestellt, mit Nutzer besprechen
|
||||
- [ ] **WP10** (Vendor-neutrale Namen rd13/cschulz/rd13server) – zurückgestellt
|
||||
- [ ] Remote **dieses** Repos zeigt auf tote IP `192.168.178.6` – bewusst offen (separate Entscheidung)
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -63,6 +71,10 @@ Quality Gate aus.
|
|||
| Git-Alias statt Fish-Wrapper | Portabel: bash, sh, CI, GUI-Clients | `docs/MAINTAINER.md` |
|
||||
| `.copilot-no-tests` + `.copilot-no-docs` Opt-outs | Pre-commit Check 1 (Tests) und Check 2 (Doku) deaktivierbar für Repos ohne Framework/Doku-Pflicht | `git-templates/hooks/pre-commit` |
|
||||
| Kein `--no-verify` nirgendwo | Quality Gate darf nie umgangen werden; in `copilot-instructions.md` verboten, pre-commit enthält keinen Bypass-Hinweis | `git-templates/hooks/pre-commit`, `.github/copilot-instructions.md` |
|
||||
| Kein globales `init.templateDir`, Opt-in `git init-copilot` | Standard-`git init`/`clone` unberührt; Quality Gate nur in gewählten Repos | `scripts/deploy.{sh,fish}` |
|
||||
| Remote konfigurierbar (env/Config) + Offline-Modus | Keine hartkodierte Infrastruktur; läuft ohne Netz, graceful skip (exit 0) | `scripts/copilot-update.{sh,fish}` |
|
||||
| `detect_vscode_user_dir` dupliziert statt geteilt | Skripte laufen standalone aus `~/.local/bin` → keine sourcebare Lib | alle 4 Skripte |
|
||||
| CI: shellcheck + fish -n + selftest | Verhindert Regressionen in den Shell-Skripten | `.github/workflows/ci.yml`, `scripts/selftest.sh` |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -76,7 +88,7 @@ Quality Gate aus.
|
|||
- **Bootstrap einzelnes Repo:** `sh ~/.local/bin/copilot-bootstrap.sh [/pfad/zum/repo]`
|
||||
- **Bootstrap mit Auto-Update-Hook:** `sh ~/.local/bin/copilot-bootstrap.sh --with-update-hook [/pfad]`
|
||||
- **Templates updaten (global + repo-lokal):** `git copilot-update` (in jedem Repo)
|
||||
- **Setup-Repo Cache:** `~/.copilot-setup/` (überschreibbar mit `COPILOT_SETUP_DIR=...`)
|
||||
- **Setup-Quelle:** `COPILOT_SETUP_REMOTE_SSH/_HTTP` oder `COPILOT_SETUP_DIR` (Config: `~/.config/copilot-setup/config`); Cache `~/.copilot-setup/`
|
||||
- **Git-Templates:** `~/.git-templates/` (nach Deploy)
|
||||
- **Prompts:** `~/.vscode-server/data/User/prompts/` (nach Deploy)
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue