diff --git a/knowledge-base/morpheus-identity.md b/knowledge-base/morpheus-identity.md new file mode 100644 index 0000000..1e0daf7 --- /dev/null +++ b/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). \ No newline at end of file