From 19b09ebf0b0f00f241ad44172585095e2904eb26 Mon Sep 17 00:00:00 2001
From: Michael Mayer <michael@photoprism.app>
Date: Wed, 17 Sep 2025 12:01:52 +0200
Subject: [PATCH] Specs: Update AGENTS.md and CODEMAP.md

Signed-off-by: Michael Mayer <michael@photoprism.app>
---
 AGENTS.md  | 2 ++
 CODEMAP.md | 1 +
 2 files changed, 3 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index a18abddfb..3f5f55efb 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -13,6 +13,8 @@ Learn more: https://agents.md/
 - Contributing: https://github.com/photoprism/photoprism/blob/develop/CONTRIBUTING.md
 - Security: https://github.com/photoprism/photoprism/blob/develop/SECURITY.md
 - REST API: https://docs.photoprism.dev/ (Swagger), https://docs.photoprism.app/developer-guide/api/ (Docs)
+- Backend CODEMAP: CODEMAP.md
+- Frontend CODEMAP: frontend/CODEMAP.md
 - Developer Cheatsheet – Portal & Cluster: specs/portal/README.md
 - Backend (Go) Testing Guide: specs/dev/backend-testing.md
 
diff --git a/CODEMAP.md b/CODEMAP.md
index 5e9c754d2..a8a04b07b 100644
--- a/CODEMAP.md
+++ b/CODEMAP.md
@@ -61,6 +61,7 @@ Configuration & Flags
   - Updates: Back-end calls `UpdateClientConfig()` to publish "config.updated" over websockets after changes (see `internal/api/config_options.go` and `internal/api/config_settings.go`).
   - ACL/mode aware: Values are filtered by user/session and may differ for public vs. authenticated users.
   - Don’t expose secrets: Treat it as client-visible; avoid sensitive data. To add fields, extend client values via `config.Register` rather than exposing Options directly.
+  - Refresh cadence: The web UI (non‑mobile) also polls for updates every 10 minutes via `$config.update()` in `frontend/src/app.js`, complementing the websocket push.
 
 Database & Migrations
 - Driver: GORM v1 (`github.com/jinzhu/gorm`). No `WithContext`. Use `db.Raw(stmt).Scan(&nop)` for raw SQL.