commit fa2db707a74b9fe9d5c7db96a7e634efeea9290a
Author: xxlio <clioxliu@gmail.com>
Date:   Wed Sep 2 15:07:31 2026 +1000

    chore: initialise wrps-demo-kit
    
    Blank starting point for the CI Server + OpenPLC demo kit. Content is
    brought across from the earlier WRPS working repo folder by folder, as
    each part is audited.

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..b3dbfc6
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,32 @@
+# --- Secrets: never commit ---------------------------------------------------
+*.local.md
+.env
+.env.*
+*.pem
+*.key
+*.ppk
+id_rsa*
+id_ed25519*
+*_token
+*.jwt
+
+# --- OS / editor junk --------------------------------------------------------
+Thumbs.db
+ehthumbs.db
+desktop.ini
+.DS_Store
+*~
+*.swp
+.vscode/
+.idea/
+
+# --- Python ------------------------------------------------------------------
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.pytest_cache/
+
+# --- Build output ------------------------------------------------------------
+# Rules are added as each generator is brought across during the audit.
+*.log
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..75eb618
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# wrps-demo-kit
+
+A kit for building **demo automation use cases** on **Yokogawa CI Server** (SCADA)
+and **OpenPLC Runtime** (soft PLC, in Docker) — with the **Waterloo Road Pump
+Station (WRPS)** demo as its first worked example.
+
+> [!NOTE]
+> **This repository is being assembled.** It is the successor to an earlier
+> working repo, and material is being reviewed and moved across one folder at a
+> time. Sections not yet present have not yet been audited.
+
+## The two systems
+
+| Role | Host | Address |
+|---|---|---|
+| SCADA — Yokogawa CI Server | `yau-poc-cicore1` | `10.0.0.21` |
+| PLC — OpenPLC Runtime container | `yau-sls-poc-lin001` | `10.0.0.17` |
+
+**Architecture invariant:** OpenPLC Runtime is the Modbus TCP **server** (slave)
+on port 502. CI Server is the Modbus **client** (master) and polls it. The
+register map is the contract between the two sides.
+
+## Layout
+
+To be filled in as each part is brought across.
+
+---
+
+*Assembled from the WRPS working repo, 2026-09.*