Files

T

acobham 5eb4426d30 Update SOPs: consolidate index, clean client data, set Imagen as default

- README: rewrite index to reflect actual files (STACK/CONTENT/OPTIMIZATION);
  remove 15 dead links to old numbered SOPs; add subdirectory table; update
  image gen to Google Imagen as default
- STACK: fix wp-divi-pipeline script paths; genericize vibrantyou/domain
  examples; strip pre-existing em dashes throughout
- CONTENT: update image generation default to Google Imagen API with allotted quota
- image-gen-workflow: remove client-specific cobhamtech data; generalize
  brand palette step; update date
- wp-divi-pipeline-to-am-stack: remove vibrantyou.yoga client data block;
  fix Related SOPs links to current files

2026-06-09 18:54:57 +02:00

2.7 KiB

Raw Blame History

WP + Divi to AM Stack A Pipeline: SOP Index

End-to-end playbook for converting any WordPress / Divi site backup (.wpress) into an Arising Media Stack A deployment: PHP router + SQLite + vanilla JS/CSS.

Quick start (CLI launcher)

python3 scripts/migrate.py --wpress /path/to/backup.wpress --domain example.com

Runs phases 0-6 automatically (extract, analyze, nav, content, media, stage seed). Prints agent breadcrumbs for phases 7-11. See 10-agent-breadcrumbs.md for the complete ordered execution checklist.

SOPs in this folder

File	Phase	Description
`00-overview.md`	n/a	Pipeline overview, philosophy, what to extract vs not replicate
`01-wpress-extraction.md`	1	.wpress binary format, extraction script, verification
`02-database-analysis.md`	2	MySQL dump parsing, page inventory, Divi version detection
`03-divi-content-extraction.md`	3	Divi 4 shortcodes vs Divi 5 blocks, extraction scripts
`04-design-system-extraction.md`	4	Colors, fonts, spacing to tokens.css
`05-content-migration.md`	5-6	Section remapping, content staging, seed_databases.py
`06-media-assets.md`	5	Upload migration, WebP conversion, media manifest
`07-seo-preservation.md`	7	Redirect map, Rank Math extraction, schema.org
`08-run-order.md`	n/a	DEPRECATED. Superseded by `10-agent-breadcrumbs.md`
`09-stack-a-output.md`	n/a	SQLite schemas, sections_json spec, Divi to AM module mapping
`10-agent-breadcrumbs.md`	0-11	Ordered agent execution checklist (.wpress to live Docker)

Scripts in scripts/

Script	Purpose
`migrate.py`	CLI launcher: runs phases 0-6, prints breadcrumbs for 7-11
`run_pipeline.sh`	Legacy shell wrapper (pre-migrate.py)
`extract_wpress.py`	Unpack .wpress binary archive
`analyze_db.py`	Parse SQL dump → pages.json + design-system.json
`extract_divi5.py`	Parse Divi 5 blocks → per-page content JSON
`extract_nav.py`	Extract WordPress nav menus → nav.json
`stage_seed.py`	Map extracted JSON → seed_databases.py skeleton (Phase 6)

Key facts about .wpress archives

Format: Custom sequential binary (NOT zip/tar): 4377-byte headers
Table prefix in SQL dump: SERVMASK_PREFIX_ (placeholder, NOT wp_)
Directory layout: flat: uploads/, themes/, plugins/ at archive root (no wp-content/ wrapper)
Divi 5 stores theme settings in et_divi option as PHP-serialized array

../STACK.md: AM deployment directory layout, build pipeline, WP migration playbook
../OPTIMIZATION.md: Full <head> requirements, schema.org per page type
../tools/verify-protection.sh: Post-deploy security audit

2.7 KiB Raw Blame History