bytelyst/learning_ai_common_plat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: sync agent guidance with prototype runtime

Browse Source
This commit is contained in:
root 2026-03-14 06:27:07 +00:00
parent bfecc9f95d
commit c80016c8c2
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
AGENTS.md
View File

@ -82,6 +82,16 @@ learning_ai_common_plat/
- [`docker-compose.yml`](docker-compose.yml) - [`docker-compose.yml`](docker-compose.yml)
- [`.env.example`](.env.example) when tracked defaults change - [`.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 ## 3. Tech Stack Rules
### TypeScript (all packages + services) ### 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/` | | **Auth / JWT issue** | `services/platform-service/` | `src/modules/auth/` |
| **Feature flags** | `services/platform-service/` | `src/modules/flags/` — FNV-1a hash for deterministic rollout | | **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 | | **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/` | | **Audit log** | `services/platform-service/` | `src/modules/audit/` |
| **Notifications** | `services/platform-service/` | `src/modules/notifications/` | | **Notifications** | `services/platform-service/` | `src/modules/notifications/` |
| **Rate limiting** | `services/platform-service/` | `src/modules/rate-limit/` | | **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 (all services + monitoring) ─────
docker compose up -d docker compose up -d
docker compose down docker compose down
pnpm prototype:self-test
# ── Portable builds for consumer repos ──────────── # ── Portable builds for consumer repos ────────────
# Pack @bytelyst/* tarballs so Docker/CI builds don't need this sibling repo # Pack @bytelyst/* tarballs so Docker/CI builds don't need this sibling repo
@ -381,6 +394,13 @@ COSMOS_DATABASE=lysnrai
JWT_SECRET=<shared-secret> JWT_SECRET=<shared-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: Additional per-service:
``` ```