WPTransformer — Build Prompt

Crumbforest · Bits With Attitude · MIT · CKL v1.0

Du bist ein Coding-Agent im Crumbforest-Ökosystem. Lies dieses Dokument vollständig bevor du eine Zeile schreibst. Dann schreibe Code der atmet.

Kontext & Haltung

WPTransformer ist ein CLI-Prozess, kein Framework, kein SaaS. Er konvertiert Legacy-CMS-Inhalte (WordPress, Joomla) in statische Vektoren.

Kernprinzipien — nicht verhandelbar:

• Offline by Default — kein externes Netz während der Transformation
• No Central Command — kein Cloud-Dienst, keine API-Keys, keine Telemetrie
• Data doesn't exist — kein Logging von Kundendaten nach außen
• ls -la — alles prüfbar, alles lesbar, für immer
• Human Loop — Maschine hält inne, Mensch entscheidet

Repo-Struktur

wptransformer/
│
├── PROMPT.md               ← diese Datei
├── README.md               ← kurz, direkt, kein Marketing
├── LICENSE                 ← MIT + CKL v1.0
│
├── bin/
│   └── wpt                 ← CLI-Einstiegspunkt (PHP-Script, Shebang)
│
├── src/
│   ├── Parser/
│   │   ├── WPSQLParser.php         ← SQL-Dump → strukturierte Daten
│   │   ├── WPCrawler.php           ← Live-Crawl (geplant, stub)
│   │   └── JoomlaParser.php        ← Joomla-Export (in Entwicklung, stub)
│   │
│   ├── Intermediate/
│   │   ├── IntermediateDB.php      ← SQLite-Layer (editierbar, lokal)
│   │   ├── PostModel.php           ← Datenmodell: Post/Page/Draft
│   │   └── MediaModel.php          ← Bilder, Anhänge
│   │
│   ├── Builder/
│   │   ├── StaticBuilder.php       ← HTML/CSS/JS Generator
│   │   ├── HugoBuilder.php         ← Hugo-kompatibles Markdown + config.toml
│   │   └── AssetHandler.php        ← Bilder kopieren, Pfade korrigieren
│   │
│   ├── Output/
│   │   ├── ZipExporter.php         ← ZIP-Download
│   │   ├── FTPDeploy.php           ← Klassisches Shared Hosting
│   │   ├── VPNSync.php             ← Nullfeld-Sync (194.164.194.191)
│   │   └── USBExport.php           ← Lokale Kopie, kein Netz nötig
│   │
│   └── HumanLoop/
│       ├── ReviewInterface.php     ← CLI-Ausgabe: Was geht live, was ins Archiv
│       └── ConfirmStep.php         ← HOLD-Schritt vor Deploy
│
├── templates/
│   ├── base.html                   ← Minimales HTML-Gerüst
│   ├── post.html                   ← Einzelseite
│   ├── index.html                  ← Übersicht
│   └── hugo/
│       ├── config.toml             ← Hugo-Basiskonfiguration
│       └── archetypes/
│           └── default.md          ← Hugo Post-Template
│
├── data/
│   └── .gitkeep                    ← Intermediate SQLite lebt hier (nicht im Repo)
│
├── public/
│   └── .gitkeep                    ← Static Output lebt hier (nicht im Repo)
│
├── tests/
│   ├── fixtures/
│   │   ├── sample_wp.sql           ← Minimal-WP-Dump zum Testen
│   │   └── sample_joomla.xml       ← Minimal-Joomla-Export
│   └── ParserTest.php
│
└── .gitignore

Der Prozess — Schritt für Schritt

INPUT
  └── SQL-Dump / Joomla-Export / Leerer Brief (Neukunde)
        │
        ▼
STEP 1: Parser
  WPSQLParser::parse($file)
  → gibt Array zurück: [ posts[], pages[], drafts[], media[] ]
  → keine Datenbankverbindung nötig — pure PHP, regex + DOM
        │
        ▼
STEP 2: Intermediate Layer
  IntermediateDB::import($parsed)
  → speichert in lokaler SQLite (data/intermediate.sqlite)
  → Schema: wpt_posts (id, type, status, title, content, slug, date, meta)
  → wpt_media (id, post_id, filename, path, alt)
        │
        ▼
STEP 3: [ HUMAN LOOP — HOLD ]
  ReviewInterface::show()
  → Übersicht: X Posts · Y Pages · Z Drafts · W Medien
  → Mensch markiert: deploy | archive | skip
  → ConfirmStep::confirm() — kein Deploy ohne explizites OK
        │
        ▼
STEP 4: Builder
  StaticBuilder::build() oder HugoBuilder::build()
  → iteriert über wpt_posts WHERE deploy = 1
  → schreibt nach public/
  → kopiert Assets nach public/assets/
        │
        ▼
STEP 5: Output
  Je nach Flag:
  --zip         → ZipExporter
  --ftp         → FTPDeploy (config via .env, nie im Repo)
  --hugo        → HugoBuilder → hugo --minify
  --nullfeld    → VPNSync (194.164.194.191)
  --usb         → USBExport (Pfad als Argument)

CLI-Interface

# Basis-Workflow
./bin/wpt parse --input dump.sql
./bin/wpt review
./bin/wpt build --output hugo
./bin/wpt deploy --target nullfeld

# Kurzform
./bin/wpt run --input dump.sql --output hugo --deploy ftp

# Nur Archiv exportieren (kein Deploy)
./bin/wpt export --archive --format zip

Code-Standards

Was NICHT gebaut wird

• Admin-Oberfläche (Browser-UI)
• Cloud-Sync zu Dritten
• Automatisches Deployment ohne Human Loop
• Telemetrie / Logging nach außen
• Dependency auf Node.js / npm
• Subscription-Modell / Lizenz-Check online

Umgebungsvariablen (.env — nie committen)

WPT_FTP_HOST=
WPT_FTP_USER=
WPT_FTP_PASS=
WPT_VPN_HOST=194.164.194.191
WPT_VPN_USER=
WPT_VPN_PATH=/var/www/nullfeld/
WPT_HUGO_BIN=/usr/local/bin/hugo

Erster Build-Schritt (was als erstes gebaut wird)

1. bin/wpt — Shebang + Argument-Router
2. src/Parser/WPSQLParser.php — SQL → Array (Core-Logik)
3. src/Intermediate/IntermediateDB.php — SQLite-Import
4. src/HumanLoop/ReviewInterface.php — CLI-Ausgabe der importierten Posts
5. tests/ParserTest.php — Fixture-basierter Test

Danach: StaticBuilder. Dann HugoBuilder. Dann Output-Layer.

Verbindung zum Ökosystem

Lizenz

MIT License · CKL v1.0
Crumbforest · Bits With Attitude · Hamburg
ls -la. Alles prüfbar. Alles lesbar. Für immer.