From c80016c8c27d6d390ad9757a8dfc4f2f13283d96 Mon Sep 17 00:00:00 2001 From: root Date: Sat, 14 Mar 2026 06:27:07 +0000 Subject: [PATCH] docs: sync agent guidance with prototype runtime --- AGENTS.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index e3fabb11..776cb16a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -82,6 +82,16 @@ learning_ai_common_plat/ - [`docker-compose.yml`](docker-compose.yml) - [`.env.example`](.env.example) when tracked defaults change +### Current local prototype endpoints + +- `platform-service`: `http://localhost:4003` +- `extraction-service`: `http://localhost:4005` +- `mcp-server`: `http://localhost:4007` +- Cosmos Data Explorer: `http://localhost:1234` +- Azurite blob endpoint: `http://localhost:10000` +- Mailpit SMTP: `localhost:1025` +- Mailpit inbox UI: `http://localhost:8025` + ## 3. Tech Stack Rules ### TypeScript (all packages + services) @@ -234,6 +244,8 @@ See full audit: [`docs/design-system/DESIGN_SYSTEM_AUDIT_2026-03-03.md`](docs/de | **Auth / JWT issue** | `services/platform-service/` | `src/modules/auth/` | | **Feature flags** | `services/platform-service/` | `src/modules/flags/` — FNV-1a hash for deterministic rollout | | **Blob storage** | `services/platform-service/` | `src/modules/blob/`, `src/lib/blob.ts` — SAS tokens, CRUD | +| **Prototype status** | `services/platform-service/` | `src/modules/status/` — dependency health JSON, self-test JSON, self-test HTML | +| **Delivery / SMTP** | `services/platform-service/` | `src/modules/delivery/` — SMTP delivery, Mailpit-backed prototype email flows | | **Audit log** | `services/platform-service/` | `src/modules/audit/` | | **Notifications** | `services/platform-service/` | `src/modules/notifications/` | | **Rate limiting** | `services/platform-service/` | `src/modules/rate-limit/` | @@ -316,6 +328,7 @@ cd __LOCAL_LLMs/dashboard && npm run build # prebuild builds @bytelyst/llm-ro # ── Docker Compose (all services + monitoring) ───── docker compose up -d docker compose down +pnpm prototype:self-test # ── Portable builds for consumer repos ──────────── # Pack @bytelyst/* tarballs so Docker/CI builds don't need this sibling repo @@ -381,6 +394,13 @@ COSMOS_DATABASE=lysnrai JWT_SECRET= ``` +Prototype Docker defaults differ from production: + +- `COSMOS_ENDPOINT=http://cosmos-emulator:8081` +- `STORAGE_PROVIDER=azure` with Azurite-backed blob config +- `EMAIL_PROVIDER=smtp` with `SMTP_HOST=mailpit` +- Use placeholders in tracked files; keep real local values in `.env` + Additional per-service: ```