docs: refresh MetaWiki repo hygiene

Author: Lukas Geiger

.github/workflows/tests.yml

@@ -0,0 +1,44 @@
+name: MetaWiki smoke tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+jobs:
+  smoke:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Compile Python sources
+        run: |
+          python -m py_compile \
+            check_duplicates.py \
+            manage_translations.py \
+            md_to_json.py \
+            metawiki_cli.py \
+            metawiki_pipeline.py \
+            pipeline.py \
+            translate.py \
+            translator.py
+
+      - name: Check CLI and data pipeline
+        env:
+          PYTHONIOENCODING: utf-8
+        run: |
+          python metawiki_cli.py --help
+          python metawiki_cli.py stats
+          python metawiki_cli.py check
+          python metawiki_pipeline.py validate

.gitignore

@@ -11,14 +11,19 @@ __pycache__/
 .eggs/
 dist/
 build/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
 
 # ---- Virtuelle Umgebungen ----
 venv/
 .venv/
 env/
 .env/
 
-# ---- BACH Interne Steuerungsdateien (NIEMALS in Git!) ----
+# ---- Interne Steuerungsdateien (NIEMALS in Git!) ----
 AUFGABEN.txt
 TEST.txt
 TESTS.txt
@@ -33,6 +38,7 @@ _USER/
 credentials.json
 client_secret*.json
 token.json
+secrets.*
 *.pem
 *.key
 keyring/
@@ -44,6 +50,7 @@ releases/
 *.msix
 *.appx
 *.spec
+*.temp
 
 # ---- IDE & Editoren ----
 .claude/
@@ -73,3 +80,5 @@ _private/
 output/
 backups/
 *.bak
+*.tmp
+*-ASUS-GEI.md

CHANGELOG.md

@@ -6,13 +6,15 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 ## [Unreleased]
 
 ### Hinzugefuegt / Added
--
+- Lokales MetaWiki-Icon, README-Einstieg fuer CLI-Nutzung und Windows-Startskript.
+- GitHub-Actions-Smoke-Test fuer CLI, Pipeline-Validierung und Python-Compile-Checks.
 
 ### Geaendert / Changed
--
+- Repository-Metadaten auf `file-bricks/MetaWiki` aktualisiert.
+- Privacy-/Security-Hinweise ohne persoenliche Kontaktadresse geschaerft.
 
 ### Behoben / Fixed
--
+- Veraltete Clone- und Security-Links aus der frueheren persoenlichen Ablage ersetzt.
 
 ## [1.0.0] - YYYY-MM-DD
 

CODE_OF_CONDUCT.md

@@ -26,8 +26,10 @@ Inakzeptables Verhalten umfasst:
 
 ### Durchsetzung
 
-Faelle von missbräuchlichem Verhalten koennen dem Projektteam unter
-**lukas@geiger.sh** gemeldet werden. Alle Beschwerden werden geprueft und untersucht.
+Faelle von missbräuchlichem Verhalten koennen ueber die GitHub-Issues des Projekts
+gemeldet werden. Wenn die Meldung sensible Details enthaelt, nutzen Sie bitte die
+private Sicherheitsmeldung dieses Repositories. Alle Beschwerden werden geprueft und
+untersucht.
 
 ---
 
@@ -56,8 +58,9 @@ Unacceptable behavior includes:
 
 ### Enforcement
 
-Instances of abusive behavior may be reported to the project team at
-**lukas@geiger.sh**. All complaints will be reviewed and investigated.
+Instances of abusive behavior may be reported through this repository's GitHub issues.
+If the report contains sensitive details, use this repository's private vulnerability
+reporting flow instead. All complaints will be reviewed and investigated.
 
 ---
 

CONTRIBUTING.md

@@ -28,10 +28,11 @@ Vielen Dank fuer Ihr Interesse, zu diesem Projekt beizutragen!
 ### Erste Schritte
 
 ```bash
-git clone https://github.com/lukisch/MetaWiki.git
+git clone https://github.com/file-bricks/MetaWiki.git
 cd MetaWiki
-pip install -r requirements.txt
-python main.py
+python -m pip install -r requirements.txt
+python metawiki_cli.py stats
+python metawiki_pipeline.py validate
 ```
 
 ---
@@ -64,8 +65,9 @@ Thank you for your interest in contributing to this project!
 ### Getting Started
 
 ```bash
-git clone https://github.com/lukisch/MetaWiki.git
+git clone https://github.com/file-bricks/MetaWiki.git
 cd MetaWiki
-pip install -r requirements.txt
-python main.py
+python -m pip install -r requirements.txt
+python metawiki_cli.py stats
+python metawiki_pipeline.py validate
 ```

MetaWiki.ico

@@ -9,7 +9,7 @@
 
 <h1 align="center">
   <br>
-  <img src="https://raw.githubusercontent.com/github/explore/main/topics/knowledge/knowledge.png" alt="MetaWiki" width="120">
+  <img src="assets/metawiki_icon.png" alt="MetaWiki" width="120">
   <br>
   MetaWiki Framework
   <br>
@@ -148,7 +148,7 @@ Alle 630 Stubs sind bereits vollstaendig **zweisprachig (DE + EN)**. Fuer neue S
 
 ```bash
 # API-Key setzen und optionales Paket installieren
-export ANTHROPIC_API_KEY="sk-ant-..."
+export ANTHROPIC_API_KEY="<your-anthropic-api-key>"
 pip install anthropic
 
 # Alle Stubs uebersetzen (fehlende definition_en)
@@ -173,6 +173,30 @@ print(english)
 
 Ohne gesetzten `ANTHROPIC_API_KEY` oder ohne `pip install anthropic` wird die Uebersetzung lautlos uebersprungen.
 
+## Nutzung / Usage
+
+```bash
+# CLI-Hilfe
+python metawiki_cli.py --help
+
+# Statistiken anzeigen
+python metawiki_cli.py stats
+
+# Konsistenz pruefen
+python metawiki_cli.py check
+
+# JSON nach Markdown exportieren
+python metawiki_pipeline.py export --output --english
+```
+
+Unter Windows steht zusaetzlich `start.bat` als einfacher Einstieg fuer die CLI bereit. Exportierte Dateien landen in `output/`; dieser Ordner bleibt lokal und wird nicht versioniert.
+
+## Datenschutz / Privacy
+
+MetaWiki arbeitet standardmaessig lokal mit `metawiki.json` und den Markdown-Exporten in diesem Repository. Es gibt keine Telemetrie und keine automatische Netzwerkkommunikation.
+
+Nur der optionale Befehl `python metawiki_pipeline.py translate` kann externe API-Aufrufe ausloesen, wenn `ANTHROPIC_API_KEY` gesetzt ist und das optionale Paket `anthropic` installiert wurde.
+
 ## Roadmap
 
 ### Phase 1 - Strukturaufbau `[ABGESCHLOSSEN]`
@@ -235,7 +259,7 @@ Ohne gesetzten `ANTHROPIC_API_KEY` oder ohne `pip install anthropic` wird die Ue
 | Projektagnostisch | Fuer jeden Anwendungsfall |
 
 <p align="center">
-  <sub>Built with brain and AI &nbsp;|&nbsp; Developed by <a href="https://github.com/lukisch">lukisch</a></sub>
+  <sub>Built with brain and AI &nbsp;|&nbsp; Maintained at <a href="https://github.com/file-bricks/MetaWiki">file-bricks/MetaWiki</a></sub>
 </p>
 
 ---
@@ -373,7 +397,7 @@ All 630 stubs are already fully **bilingual (DE + EN)**. For new stubs added lat
 
 ```bash
 # Set API key and install optional package
-export ANTHROPIC_API_KEY="sk-ant-..."
+export ANTHROPIC_API_KEY="<your-anthropic-api-key>"
 pip install anthropic
 
 # Translate all stubs (missing definition_en)
@@ -398,6 +422,30 @@ print(english)
 
 Without a set `ANTHROPIC_API_KEY` or without `pip install anthropic`, translation is silently skipped.
 
+### Usage
+
+```bash
+# CLI help
+python metawiki_cli.py --help
+
+# Show statistics
+python metawiki_cli.py stats
+
+# Check consistency
+python metawiki_cli.py check
+
+# Export JSON to Markdown
+python metawiki_pipeline.py export --output --english
+```
+
+On Windows, `start.bat` provides a simple CLI entry point. Exported files are written to `output/`; that folder stays local and is not versioned.
+
+### Privacy
+
+MetaWiki works locally by default with `metawiki.json` and the Markdown exports in this repository. It has no telemetry and no automatic network communication.
+
+Only the optional `python metawiki_pipeline.py translate` command can make external API calls when `ANTHROPIC_API_KEY` is set and the optional `anthropic` package is installed.
+
 ### Roadmap
 
 #### Phase 1 - Structure Setup `[COMPLETED]`
@@ -460,16 +508,16 @@ Without a set `ANTHROPIC_API_KEY` or without `pip install anthropic`, translatio
 | Project-agnostic | For any use case |
 
 <p align="center">
-  <sub>Built with brain and AI &nbsp;|&nbsp; Developed by <a href="https://github.com/lukisch">lukisch</a></sub>
+  <sub>Built with brain and AI &nbsp;|&nbsp; Maintained at <a href="https://github.com/file-bricks/MetaWiki">file-bricks/MetaWiki</a></sub>
 </p>
 
 ---
 
 ## Haftung / Liability
 
-Dieses Projekt ist eine **unentgeltliche Open-Source-Schenkung** im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß **§ 521 BGB** auf **Vorsatz und grobe Fahrlässigkeit** beschränkt. Ergänzend gelten die Haftungsausschlüsse aus GPL-3.0 / MIT / Apache-2.0 §§ 15–16 (je nach gewählter Lizenz).
+Dieses Projekt ist eine **unentgeltliche Open-Source-Schenkung** im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß **§ 521 BGB** auf **Vorsatz und grobe Fahrlässigkeit** beschränkt. Ergänzend gelten die Haftungsausschlüsse der MIT-Lizenz.
 
 Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.
 
-This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code). Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.
+This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code), with the MIT License disclaimers applying as well. Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.
 

README.md

@@ -5,12 +5,12 @@
 If you find a security vulnerability, please report it responsibly:
 
 1. **Do NOT open a public issue**
-2. **Use GitHub's [private vulnerability reporting](https://github.com/lukisch/MetaWiki/security/advisories/new)**
+2. **Use GitHub's [private vulnerability reporting](https://github.com/file-bricks/MetaWiki/security/advisories/new)**
 3. Include: description, steps to reproduce, potential impact
 
 ### How to Report
 
-1. Go to: https://github.com/lukisch/MetaWiki/security/advisories/new
+1. Go to: https://github.com/file-bricks/MetaWiki/security/advisories/new
 2. Fill out the form (title, description, severity, affected versions)
 3. Submit privately (not visible to public until disclosed)
 

SECURITY.md

@@ -0,0 +1,17 @@
+@echo off
+chcp 65001 >nul
+set PYTHONIOENCODING=utf-8
+cd /d "%~dp0"
+set PYTHON=python
+%PYTHON% --version >nul 2>&1
+if errorlevel 1 (
+    set PYTHON=py -3
+    %PYTHON% --version >nul 2>&1
+    if errorlevel 1 (
+        echo [FEHLER] Python nicht gefunden!
+        pause
+        exit /b 1
+    )
+)
+%PYTHON% metawiki_cli.py %*
+if errorlevel 1 pause