AkurAI-Platform / AGENTS.md

Latest change 6154a1a6ea26523c439023a24298c4c854a5ee0a - chore: add live platform check by Olafur Bui

# AGENTS.md - AkurAI-Platform

## Purpose

This repo is the AkurAI Platform gateway page for the EC2 VM
`mail.olibuijr.com`. It is a no-build AkurAI-Framework app that lists only
items hosted or configured on that VM.

## Scope Rules

- Keep the catalog EC2-local. Do not add external SaaS, registrar, DNS-provider,
  cloud-account, or non-VM services to the page.
- A public URL belongs here only when the nginx vhost or listener terminates on
  the EC2 VM.
- Runtime inventory belongs in `backend/page.json`; changing listed services
  must not require rebuilding the binary.
- Keep frontend code to native HTML, CSS, and JS. No bundler, npm app runtime,
  or framework outside AkurAI-Framework.
- Use systemd for long-running deployment on the VM.

## Files

- `frontend/index.html` - gateway dashboard template.
- `frontend/styles.css` - hand-written dashboard styling.
- `frontend/app.js` - health check and small client behavior.
- `backend/page.json` - service, port, and vhost inventory data.
- `scripts/deploy-ec2.sh` - deploy helper using `akurai-ec2`.
- `scripts/check-live.sh` - DNS, public HTTP, nginx Host-header, and VM upstream check.
- `ISA.md` - PAI planning and verification record.