# 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).