Initial version

.gemini/settings.json

@@ -0,0 +1,4 @@
+{
+    "contextFileName": ["GEMINI.md"],
+    "telemetry": { "enabled": true, "target": "otlp" }
+}

.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+*/node_modules/
+*/build/

.htaccess

@@ -0,0 +1,18 @@
+DirectoryIndex index.php index.html
+Options -Indexes
+Options -MultiViews
+
+RewriteEngine On
+
+# 0) Serve existing files/directories as-is
+RewriteCond %{REQUEST_FILENAME} -f [OR]
+RewriteCond %{REQUEST_FILENAME} -d
+RewriteRule ^ - [L]
+
+# 1) Internal map: /page or /page/ -> /page.php (if such PHP file exists)
+RewriteCond %{REQUEST_FILENAME}.php -f
+RewriteRule ^(.+?)/?$ $1.php [L]
+
+# 2) Optional: strip trailing slash for non-directories (keeps .php links working)
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule ^(.+)/$ $1 [R=301,L]

GEMINI.md

@@ -0,0 +1,155 @@
+Here’s a drop-in **`gemini.md`** for the LAMP golden machine. Put it in the project root (i.e., `WORKSPACE_ROOT`, which is also the Apache DocumentRoot). It speaks directly to Gemini CLI and sets guardrails for edits + chat output.
+
+```markdown
+# Gemini — Working Instructions (Flatlogic LAMP VM)
+
+You are **Gemini CLI** running inside a **Flatlogic Dev VM** on the **LAMP golden image**.
+Your job is to **edit files in-place** under the current working directory and keep the app running and browsable.
+
+---
+
+## Where you are (facts)
+
+- **CWD / Project root:** this folder (the Flatlogic `WORKSPACE_ROOT`).  
+  - It is also the **Apache DocumentRoot**.  
+  - `index.php` lives here and is served as `/`.
+- **Stack:** Apache 2.4+ and PHP 8.x (classic LAMP). No framework by default.
+- **Network:** The VM exposes HTTP(S) via a **Cloudflare Tunnel**. Locally it’s served on `http://localhost:80`.
+- **Privileges:** You are a regular user. Do **not** attempt system package changes or service reconfiguration.
+- **VCS:** A Git repo may be present. You can modify tracked files; commits/pushes are triggered by platform commands (not by you directly).
+
+---
+
+## What to do (capabilities & constraints)
+
+- **Edit files directly** in this folder tree. Prefer small, safe changes.
+- **Stay within the project root.** Do not write outside this directory.
+- **Do not change Apache/system configs** or assume root access.
+- **Keep the app immediately browsable.** After changes, `/` must still load without PHP errors.
+- **No database is guaranteed.** If you need persistence, propose **file-based** storage first. If MySQL is explicitly requested later, ask for credentials.
+- **Composer/frameworks:** Avoid adding unless asked. Stick to vanilla PHP unless requirements say otherwise.
+
+---
+
+## How Flatlogic Chat sees you
+
+- Your **stdout/stderr is streamed** to a human via Flatlogic Cloud.
+- Keep output **concise and actionable**:
+  1. Start with a one-line **Plan**.
+  2. Perform changes (write files).
+  3. Print a **Summary** of what changed.
+  4. End with **Next** (a yes/no or options).
+- If an operation fails, print a short **Error** line and what you’ll try next.
+
+**Output template (guideline):**
+```
+
+Plan: <1–2 short bullets>
+
+Changed:
+
+* <path>: <very short description>
+* <path>: <very short description>
+
+Notes:
+
+* <any caveat or test instruction>
+
+Next: <question or options>
+
+```
+
+> You generally do **not** need to print full file contents. When useful, show **small excerpts only**.
+
+---
+
+## File editing rules (PHP)
+
+- **index.php must keep working.** If you introduce new includes, ensure relative paths exist.
+- **Security:** never echo raw user input; use `htmlspecialchars` for HTML contexts.
+- **Health endpoint:** ensure `/healthz` returns `ok` with HTTP 200 (lightweight, no PHP warnings).
+  - Implement as `healthz.php` or route via `index.php`—your choice, but keep it simple.
+- **Configuration:** if you create config, use a single `config.php` loaded by `index.php`.
+- **Error handling:** avoid `display_errors` changes. Use defensive checks and small try/catch blocks.
+
+---
+
+## Testing after changes
+
+- Print a quick checklist the human can run:
+  - “Open `/`—should show …”
+  - “Open `/healthz`—should return ‘ok’”
+  - Mention any new endpoints you add.
+
+---
+
+## Git & deploy (how your work is shipped)
+
+- The platform will run `git pull`, `git commit_push`, and `server.restart` when appropriate.
+- **You don’t run git here.** Just make sure your changes are saved to disk.
+
+**Commit message convention** (for your summaries so humans can reuse):
+- `feat: ...` user-visible features
+- `fix: ...` bug fix
+- `chore: ...` small housekeeping
+- `docs: ...` text-only updates
+
+---
+
+## Do not do
+
+- Don’t install system packages or restart Apache yourself.
+- Don’t write outside the project root.
+- Don’t introduce heavy dependencies without asking.
+- Don’t leak secrets or create random credentials.
+
+---
+
+## Small starter tasks you can do safely
+
+1) **Add a health check**
+- Create `healthz.php` with plain `ok`.
+- Optionally link from `index.php` footer for quick access.
+
+2) **Improve the landing page**
+- In `index.php`, add a minimal header/footer, and a quick environment box:
+  - PHP version, current time, and a link to `/healthz`.
+
+3) **Basic contact form (no DB)**
+- Add `contact.php` with a POST form and server-side validation.
+- On submit, write a sanitized line to `data/contact.log` (create folder if missing).
+
+(Only perform these if asked; otherwise wait for explicit prompts.)
+
+---
+
+## Example: Health check (what good output looks like)
+
+```
+
+Plan: add /healthz endpoint and link it from index.php
+
+Changed:
+
+* healthz.php: returns 'ok' with HTTP 200
+* index.php: footer link to /healthz
+
+Notes:
+
+* Tested locally via PHP include; endpoint is static and safe.
+
+Next: Proceed to add a minimal env box on the homepage?
+
+```
+
+---
+
+## Telemetry note
+
+- Your token usage and latencies are measured. Keep prompts/responses compact.
+- Prefer **editing files** over dumping large code blocks into chat.
+
+---
+
+**That’s it.** Operate inside this folder, keep `/` working, and narrate succinctly in Flatlogic Chat.
+```

index.php

@@ -0,0 +1,115 @@
+<?php
+declare(strict_types=1);
+@ini_set('display_errors', '1');
+@error_reporting(E_ALL);
+@date_default_timezone_set('UTC');
+
+$phpVersion = PHP_VERSION;
+$now = date('Y-m-d H:i:s');
+?>
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>New Style</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap" rel="stylesheet">
+  <style>
+    :root {
+      --bg-color-start: #ffecd2;
+      --bg-color-end: #fcb69f;
+      --text-color: #333333;
+      --card-bg-color: rgba(255, 255, 255, 0.5);
+      --card-border-color: rgba(0, 0, 0, 0.1);
+    }
+    body {
+      margin: 0;
+      font-family: 'Inter', sans-serif;
+      background: linear-gradient(45deg, var(--bg-color-start), var(--bg-color-end));
+      color: var(--text-color);
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      text-align: center;
+      overflow: hidden;
+      position: relative;
+    }
+    body::before {
+      content: '';
+      position: absolute;
+      top: 0;
+      left: 0;
+      width: 100%;
+      height: 100%;
+      background-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" width="100" height="100" viewBox="0 0 100 100"><path d="M-10 10L110 10M10 -10L10 110" stroke-width="1" stroke="rgba(0,0,0,0.05)"/></svg>');
+      animation: bg-pan 20s linear infinite;
+      z-index: -1;
+    }
+    @keyframes bg-pan {
+      0% { background-position: 0% 0%; }
+      100% { background-position: 100% 100%; }
+    }
+    main {
+      padding: 2rem;
+    }
+    .card {
+      background: var(--card-bg-color);
+      border: 1px solid var(--card-border-color);
+      border-radius: 16px;
+      padding: 2rem;
+      backdrop-filter: blur(20px);
+      -webkit-backdrop-filter: blur(20px);
+      box-shadow: 0 8px 32px 0 rgba(0, 0, 0, 0.1);
+      animation: float 6s ease-in-out infinite, fadeIn 1s ease-out forwards;
+    }
+    h1 {
+      font-size: 3rem;
+      font-weight: 700;
+      margin: 0 0 1rem;
+      letter-spacing: -1px;
+      animation: fadeIn 1.5s ease-out forwards;
+    }
+    p {
+      margin: 0.5rem 0;
+      font-size: 1.1rem;
+      animation: fadeIn 2s ease-out forwards;
+    }
+    @keyframes float {
+      0% { transform: translateY(0px); }
+      50% { transform: translateY(-10px); }
+      100% { transform: translateY(0px); }
+    }
+    @keyframes fadeIn {
+      from { opacity: 0; transform: translateY(10px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+    code {
+      background: rgba(0,0,0,0.2);
+      padding: 2px 6px;
+      border-radius: 4px;
+      font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+    }
+    footer {
+      position: absolute;
+      bottom: 1rem;
+      font-size: 0.8rem;
+      opacity: 0.7;
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <div class="card">
+      <h1>Welcome!</h1>
+      <p>Your project is ready to conquer the peaks.</p>
+      <p>PHP version: <code><?= htmlspecialchars($phpVersion) ?></code></p>
+    </div>
+  </main>
+  <footer>
+    Page updated: <?= htmlspecialchars($now) ?> (UTC)
+  </footer>
+</body>
+</html>