docs: add Morpheus identity and knowledge legacy

knowledge-base/morpheus-identity.md

@@ -0,0 +1,80 @@
+# Morpheus Identity & Knowledge Legacy
+
+## Purpose
+This document provides a complete handoff for any agent picking up after me. If the VPS is corrupted, another agent can read this to understand:
+- Who Morpheus was
+- What I was researching and building
+- How to continue my work and improve upon it
+
+---
+
+## Agent Identity
+
+- **Name:** Morpheus (research agent)
+- **Host:** OpenClaw / Forgejo self-hosted Git at `https://git.errorlog.space/`
+- **Primary Owner:** iamcoolvivek007 (freight forwarding SaaS builder)
+- **Creation Date:** 2026-06-10 (first session captured in this repo)
+- **Specialization:** Full-stack SaaS platform patterns, DevOps automation, agent collaboration protocols
+
+---
+
+## Core Knowledge
+
+### Platform Stack
+- **Frontend:** EJS + React hybrid, TanStack tables, government-app aesthetic
+- **Backend:** Node.js + Express, Supabase PostgreSQL
+- **Deployment:** Coolify-ready Docker setup (pending Supabase config)
+- **Monitoring:** Prometheus + Grafana endpoints
+
+### Cargo/Freight Business Rules
+- Truck drivers & shippers self-register (SaaS marketplace model)
+- Loads posted → drivers bid → negotiate → 5% platform fee via escrow
+- GPS tracking + driver ratings + notifications
+- Bulk WhatsApp parser for incoming shipment data
+- Daily CSV/JSON → Supabase migration workflow
+
+### Technical Insights Discovered
+- **Forgejo URL Migration:** `sslip.io` → `git.errorlog.space` (June 2026)
+- **Coolify Deployment Checklist:**
+  - Set `PORT` or `DATABASE_URL` in `.env`
+  - Enable `restart: unless-stopped` in `docker-compose.yml`
+  - Add healthcheck endpoint `/health` for Coolify probes
+- **Agent Collaboration Protocol:** All markdown files follow DOX pattern with `AGENTS.md` rules per folder
+
+---
+
+## Active Workstreams (as of last commit)
+
+| Repo/File | Description | Status |
+|-----------|-------------|--------|
+| `freightdesk/` | Main SaaS marketplace | v31, ready for Coolify deploy |
+| `internal-freight-app/` | Admin/management portal | missing npm install |
+| `morpheus-brain/research/tech-study/2026-06-11-forgejo-url-change-and-repo-access.md` | Forgejo migration analysis | pushed to main |
+
+---
+
+## How to Continue
+
+1. **Sync the repo:**
+   ```bash
+   git clone https://git.errorlog.space/iamcoolvivek007/morpheus-brain.git
+   ```
+
+2. **Check daily logs:**  
+   Look in `daily/` for short-term tasks and `research/` for deep dives.
+
+3. **Pick up an open task:**
+   - Finish `freightdesk` Coolify deployment (Supabase env vars)
+   - Implement webhook in `morpheus-brain` to auto-notify on new research
+
+4. **Follow DOX rules:** Each subfolder has an `AGENTS.md` describing valid file naming & structure.
+
+---
+
+## Suggestions for Evolution
+
+- **Shared Knowledge Graph:** Other agents could link their research notes back to this identity file to propagate improvements.
+- **Auto-Review Bot:** Create a Forgejo webhook that triggers an agent to review PRs and leave Morpheus-style comments.
+- **Cross-Agent Memory Sync:** Export daily logs to a common markdown format so agents can `git pull` updates from each other.
+
+Contact: None (autonomous agents only).