feat: OpenTelemetry LGTM observability, dev tooling, and memoir UX fixes (#31) (#32)

* add staging ios app build script

* feat(api): add OpenTelemetry LGTM stack for local observability

Wire OTel traces, metrics, and logs through a collector to Tempo,
Prometheus, and Loki, with custom LLM instrumentation, dev compose overlay,
Grafana provisioning, env templates, and development.sh auto-start.



* feat: expand observability, harden dev tooling, and fix expo staging UX

Add business and LLM Prometheus metrics with Grafana dashboards, alerting,
and a metrics verification script. Wire telemetry through adapters and core
LLM paths, and document the local LGTM workflow.

Fix development.sh for macOS bash 3.2, open Grafana and eval-web in Chrome,
and repair eval-web auto-open (unbound EVAL_WEB_BROWSER_SCHEDULED). Merge
internal-eval into the main dev script with improved compose handling.

Require EXPO_PUBLIC_* at build time, improve iOS HTTP ATS for staging IPs,
show memoir empty state instead of load errors when no chapters exist, and
add jest env setup plus chapter list response normalization.



* chore: enable Grafana Assistant Cursor plugin



* fix: memoir empty state and repair withdrawn 0020_chapters_book_id stamp

Show empty memoir UI when the chapter list succeeds with no items; treat auth/404 as non-fatal. Extend alembic revision repair so local dev DBs stamped with the removed 0020_chapters_book_id migration can roll back and upgrade to 0019.



---------

Co-authored-by: Kevin <kevin@brighteng.org>
Co-authored-by: Cursor <cursoragent@cursor.com>

api/internal-eval.sh

@@ -1,22 +1,18 @@
 #!/usr/bin/env bash
-# 在 development.sh 全栈之上附加 internal_main（默认 :8001）与 app-eval-web。
-# 只需一条命令，无需再并行跑两份脚本；共用同一份 Postgres/Redis/Celery（本脚本只起一个 Worker）。
+# 已合并入 development.sh（默认启动评测台 + 自动打开 Grafana / 评测 UI）。
+# 本脚本保留为兼容入口，行为与 ./development.sh 相同。
 #
-# 用法：cd api && ./internal-eval.sh
+# 若主站已在其他终端占用 :8000，仅附加评测 HTTP + 前端（不再起 Celery）：
+#   SKIP_INFRA=1 SKIP_INSTALL=1 EVAL_ATTACH_ONLY=1 ./development.sh
 #
-# 若主站已在其他终端由 ./development.sh 占用 :8000，仅多开评测 HTTP + 前端（不再起第二份 Celery）：
-#   SKIP_INFRA=1 SKIP_INSTALL=1 EVAL_ATTACH_ONLY=1 ./internal-eval.sh
-#
-# 兼容旧环境变量：SKIP_CELERY=1 等价于 EVAL_ATTACH_ONLY=1（仍要求 :8000 已有监听）。
-#
-# 其他可选变量与 development.sh 一致，例如：
-#   SKIP_INFRA=1  SKIP_INSTALL=1  START_EVAL_WEB=0  OPEN_EVAL_WEB=0
-#   INTERNAL_EVAL_PORT  EVAL_WEB_PORT  INTERNAL_EVAL_API_KEY
+# 兼容旧变量：SKIP_CELERY=1 等价于 EVAL_ATTACH_ONLY=1
 
 set -euo pipefail
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
+echo -e "\033[1;33m⚠ internal-eval.sh 已并入 development.sh，正在转发…\033[0m" >&2
+
 export LIFE_ECHO_WITH_INTERNAL_EVAL=1
 
 if [[ "${SKIP_CELERY:-}" == "1" ]]; then